DaBsu-Dialog Batch Spawner Utils

DaBsu — это инструмент для создателей карт, позволяющий удобно и визуально управлять большим количеством спавнеров через диалоговые окна.

DaBsu предоставляет визуальный и диалоговый интерфейс для управления спавнерами в Minecraft Java 1.21.6+. Инструмент предназначен для создателей карт, которым необходимо эффективно настраивать большое количество точек спавна, используя функции быстрого редактирования отдельных объектов или массовой обработки групп.

Большинство функций DaBsu активируются с помощью предмета DaBsu Wand. Чтобы получить его, выполните любую из следующих команд:

function #dabsu:a
function dabsu:a
function dabsu:wand

Если вы установили версию «...With Fast Dialog», вы можете нажать G, чтобы открыть быстрые действия DaBsu, и выбрать «Obtain DaBsu Debug Stick».

• Удерживание палочки и Shift + Правый клик открывает главное меню DaBsu.
• Наведение палочки на спавнер отображает информацию об этом объекте.
• Чтобы убрать палочку, нажмите Shift + Q.

DaBsu поддерживает несколько языков. При первом входе на сервер датапак предложит выбрать язык (на данный момент доступны en и zh_cn). Также язык можно изменить вручную командой function dabsu:lang.

Режим Quick Edit позволяет изменять параметры одного спавнера прямо в игровом мире. Для входа в этот режим выполните Shift + Правый клик по спавнеру с помощью палочки.

По умолчанию вы увидите рамку, представляющую SpawnRange (диапазон спавна), сферу — RequiredPlayerRange (требуемый радиус игрока) и полосу сверху, отображающую SpawnCount (количество спавнов).

Вы можете изменять соответствующие значения, удерживая правую кнопку мыши на палочке и перетаскивая курсор.

Во время быстрого редактирования нажмите Q, удерживая палочку, чтобы открыть диалоговое окно меню Quick Edit. Здесь можно изменить настройки спавнера, кроме параметров SpawnPotentials, включая:

• SpawnCount (количество спавнов)
• SpawnRange (диапазон спавна)
• RequiredPlayerRange (требуемый радиус игрока)
• Min/MaxSpawnDelay (минимальная/максимальная задержка спавна)
• MaxNearbyEntities (максимальное количество сущностей поблизости)

Клавиша F служит горячей клавишей для перехода к этой странице.

Нажатие кнопки Edit Itself изменит только этот спавнер. Кнопка Edit Same Potential применит изменения ко всем спавнерам с идентичными параметрами SpawnPotentials.

Нажмите Q в режиме быстрого редактирования, чтобы перейти к управлению записями SpawnPotentials.

Сначала откроется меню Select Potential, где перечислены все записи SpawnPotentials спавнера в порядке очереди:

• Кнопка [+] добавляет новую запись.
• Light Limit... меняет правила спавна для всех записей.
• Merge to all... позволяет объединить любой тег со всеми записями в списке.
• Edit Full NBT дает возможность напрямую редактировать весь тег SpawnPotentials.

Вы также можете выбрать конкретную запись для редактирования. Горячая клавиша — Shift + F. Если у спавнера только одна опция спавна, вы попадете сразу в неё. Если опций несколько, откроется страница Select Potential.

При редактировании конкретной записи можно изменять сущность спавна (data.entity), таблицу лута снаряжения (data.equipment) или вес записи (weight). Нажмите Edit Itself, чтобы применить изменения. Также можно удалить запись или изменить уровни освещенности (Edit Its Light Levels).

В опции Edit Common Tags можно изменить базовые атрибуты или снаряжение сущности. Для быстрого изменения атрибутов введите число; для управления снаряжением можно скопировать снаряжение моба в инвентарь или заменить слот предметом из инвентаря или эндер-сундука.

После внесения любых изменений в SpawnPotentials через интерфейс быстрого редактирования, нажмите Q, чтобы открыть меню Quick Edit. Там появится запрос на Sync Changes (Синхронизировать изменения) или Revert Edits (Откатить правки).

Sync Changes синхронизирует ваши правки с другими спавнерами, которые имеют те же SpawnPotentials. Revert Edits отменяет все внесенные вами изменения.

Чтобы завершить редактирование, используйте один из способов:

• Повторно выполните Shift + Правый клик по спавнеру палочкой.
• Нажмите Shift + Q, удерживая палочку.
• Отойдите достаточно далеко от спавнера или дойдитесь до момента, когда чанк спавнера перестанет быть загруженным.
• Нажмите кнопку Exit Quick Edit в меню.
• Покиньте сервер.

Система DaBsu отслеживает только зарегистрированные спавнеры. Все спавнеры, установленные игроками после установки датапака, регистрируются автоматически.

Чтобы зарегистрировать объекты, существовавшие до установки DaBsu, или те, что не были поставлены вручную, используйте функцию Start Scanning & Registering в главном меню. Она выполняет «плотный» рейкаст (проверка видимости) каждые два тика, чтобы найти незарегистрированные спавнеры вдоль линии вашего взгляда.

Пока эта функция активна, нажатие Q с палочкой в руках откроет настройки, где можно выбрать длину луча, его толщину и возможность проходить сквозь блоки. Также можно зарегистрировать незарегистрированный спавнер, просто нажав на него правой кнопкой мыши с палочкой.

Массовое редактирование — это продвинутый метод, позволяющий выбирать несколько спавнеров различными способами и редактировать их одновременно.

Для выбора объектов откройте главное меню (Shift + Правый клик палочкой), затем нажмите Batch Edit: Select Spawners. Если ни один спавнер не выбран, нажатие Q с палочкой (вне режима быстрого редактирования) приведет вас сюда напрямую.

Доступно 5 методов выбора:

• Cuboid Selection: определение двух углов образуют куб (как в команде /fill). Работает даже в незагруженных чанках.

• Range Selection: выбор всех спавнеров в заданном радиусе от вас. Не работает в незагруженных чанках.

• Select by nbt= check: логика селектора nbt=. Вы вводите тег (например, {id:"minecraft:zombie"}), и система выбирает объекты, содержащие этот тег. Работает во всех измерениях и незагруженных чанках.

• Select Same Potential: выбирает все спавнеры с такими же SpawnPotentials, как у того, на котором вы стоите. Работает во всех измерениях и незагруженных чанках.

• Select All: выбирает все зарегистрированные спавнеры. Работает во всех измерениях и незагруженных чанках.

На верхней части страницы есть галочка Add to selection instead of replace. Если она включена, новые выбранные объекты добавятся к уже существующей группе вместо замены текущей.

Вы можете изменять выбор, удаляя объекты или находя пересечение групп (аналогично Photoshop). Откройте главное меню, нажмите Batch Edit: Modify Selection и выберите режим Remove From Selection или Take Intersection.

Чтобы очистить выбор, нажмите кнопку Batch Edit: Cancel Selection в главном меню.

Нажмите кнопку Batch Edit Selected Spawners в главном меню. Если выбран хотя бы один спавнер, нажатие Q с палочкой также приведет вас сюда.

Доступно 4 способа изменения выбранных объектов (применяются ко всем объектам во всех измерениях и незагруженных чанках):

• Set Next Spawn Time: устанавливает тег Delay (подготовка к спавну).

• Edit Properties: изменение свойств (кроме SpawnPotentials). Пустое поле не меняет оригинал. В режиме Add or Subtract можно выполнять математические операции (например, уменьшить SpawnCount всех выбранных объектов на 1).

• Edit Potentials: управление SpawnPotentials. Если у всех выбранных объектов одинаковые параметры, можно редактировать каждую запись индивидуально. Если параметры разные, доступны только общие правки (замена правил света или объединение тегов).

• Run Any Command: выполнение любой команды в позиции выбранного спавнера (он используется как маркерная сущность).

Примечание: если команда меняет свойства или потенциалы спавнера, после редактирования нужно запустить функцию Self Check and Optimize из главного меню, чтобы данные в системе DaBsu обновились.

Настройки разделены на две категории: Global settings (влияют на совместимость и производительность) и Personal Settings (личные предпочтения пользователя). Оба раздела доступны через меню (Shift + Правый клик палочкой). В личных настройках можно изменить язык.

Перед публикацией работы в открытый доступ необходимо перевести DaBsu в режим гибернации. Это можно сделать через Global settings или командой function dabsu:hibernate.

Это удаляет все маркерные сущности, таблицы счета и прочие данные, которые использует DaBsu, кроме файлов хранения (storage). После гибернации удалите датапак из папки мира.

Возобновить работу можно, вернув датапак в папку, выполнив /reload и запустив function dabsu:resume. Все зарегистрированные спавнеры сохранятся, если файлы хранения не были удалены.

Несколько игроков могут одновременно использовать быстрое редактирование, не мешая друг другу (если они не редактируют один и тот же спавнер). При массовом редактировании выбор общий для всех игроков — в один момент времени может существовать только одна группа выделения.

Дополнительные функции проекта:

• Server Ender Chest: почти бесконечное хранилище, синхронизируемое в реальном времени для всех пользователей. Предназначено для разработчиков для быстрого обмена общими предметами.

• Self Check and Optimize: заставляет все зарегистрированные спавнеры проверить изменения и обновить информацию в системе DaBsu.

• Spawn Analyzer: в режиме быстрого редактирования можно запустить 5-секундный анализ спавна, который визуально показывает, где могут появиться мобы при текущих условиях пространства, света и особых условий. Работает путем принудительного спавна специальной версии моба с высокой частотой.\n
• Trial Spawner: DaBsu не полностью поддерживает испытательные спавнеры (Trial Spawner). Рекомендуется использовать конфигурационный файл Trial Spawner Config в датапаке. DaBsu включает конвертер, который превращает встроенную NBT-конфигурацию испытательного спавнера в структуру JSON, которую можно скопировать в конфиг-файл вашего датапака. Для конвертации зайдите в быстрый режим редактирования испытательного спавнера и нажмите Q с палочкой.

Производительность: в режиме ожидания затраты на работу датапака можно игнорировать.

Версии с поддержкой быстрых действий: в релизах предоставляется две версии DaBsu. Версия «With Quick Action» имеет диалоги, определенные через JSON, и может вызываться из меню паузы или нажатием G.

Команда function dabsu:version выводит текущую версию, а также числовые версии и устанавливает storage dabsu:sys pong__ в значение true.