Описание
World Primer может автоматически выполнять набор команд при первом создании нового мира, каждый раз при загрузке мира или каждый раз при загрузке измерения.
Конфигурация
Команды для выполнения задаются в следующих параметрах конфигурации. Все они также могут быть настроены через внутриигровое меню конфигурации:
- dimensionLoadingCommands - команды для выполнения каждый раз при загрузке измерения
- earlyWorldCreationCommands - Команды для выполнения при первоначальном создании мира, до того, как спавн-чанки были сгенерированы или загружены. Если включено отслеживание загрузки измерений, то это происходит еще до того, как какие-либо измерения были загружены/инициализированы.
- earlyWorldLoadingCommands - Команды для выполнения каждый раз при загрузке мира (т.е. при запуске сервера). Они выполняются при запуске сервера, до загрузки каких-либо миров.
- postWorldCreationCommands - Команды для выполнения при первоначальном создании мира, после того, как спавн-чанки были сгенерированы и загружены.
- postWorldLoadingCommands - Команды для выполнения каждый раз при загрузке мира (т.е. при запуске сервера). Они выполняются, когда сервер запустился и спавн-чанки overworld'а были загружены.
Также существуют отдельные параметры конфигурации для включения или отключения всех этих функций без необходимости удалять все команды, если требуется временно их отключить:
- enableDimensionLoadingCommands
- enableDimensionLoadTracking - включает отслеживание количества загрузок измерений и количества запусков сервера (т.е. количества загрузок мира).
- enableEarlyWorldCreationCommands - Включает команды раннего создания мира, которые выполняются до загрузки каких-либо измерений и, следовательно, до генерации или загрузки каких-либо чанков
- enableEarlyWorldLoadingCommands - Включает команды ранней загрузки мира, которые выполняются один раз при каждом запуске сервера, до загрузки каких-либо измерений
- enablePostWorldCreationCommands - Включает команды позднего создания мира, которые выполняются после загрузки измерений и генерации спавн-чанков overworld'а
- enablePostWorldLoadingCommands - Включает команды поздней загрузки мира, которые выполняются один раз при каждом запуске сервера, после загрузки всех измерений, а также спавн-чанков overworld'а.
Помимо этого, также существует опция enableDebugLogging, которая выводит сообщения журнала из различных событий, что позволяет легко отслеживать, что происходит и когда.
Команды загрузки измерений
Команды загрузки измерений могут быть нацелены на выполнение только при загрузке конкретного измерения, путем указания команды следующим образом:
worldprimer-dim-command
Например:
worldprimer-dim-command 1 say Измерение Энда загрузилось!
Если указать команду без префикса, то она будет выполняться каждый раз при загрузке ЛЮБОГО измерения, например:
say Какое-то измерение загрузилось!
Начиная с версии 0.3.0, появился еще один вариант команды загрузки измерения, который может выполнять команду при определенном количестве загрузок измерения или при любом кратном заданному значению количестве.
Примечание: Для работы этого варианта необходимо, чтобы опция enableDimensionLoadTracking была включена!
Синтаксис для этих команд следующий:
worldprimer-dim-command-nth
Таким образом, чтобы выполнить команду только при самой первой загрузке Нижнего мира, можно использовать:
worldprimer-dim-command-nth -1 1 say Нижний мир загрузился в первый раз!
Или при шестой загрузке Энда:
worldprimer-dim-command-nth 1 6 say Энд загрузился в шестой раз!
Чтобы выполнить команду при любом кратном заданному значению количестве, поставьте перед значением символ '%':
worldprimer-dim-command-nth 1 %5 say Энд загрузился количество раз, кратное 5!
Начиная с версии 0.4.0, также появилась поддержка подстановки идентификатора измерения или текущих координат точки спавна мира в команды.
Строки подстановки: {DIMENSION}, {SPAWNX}, {SPAWNY} и {SPAWNZ}. Они также поддерживают простое сложение и вычитание постоянных числовых значений.
Например, теперь можно сделать следующее в postWorldCreationCommands, чтобы игрок появлялся в комнате 5x5x3 под землей:
gameRule spawnRadius 0 (это устанавливает "разброс" спавна в 0, чтобы игрок появлялся точно в центре этой маленькой комнаты, а не случайно где-то вокруг этого места на поверхности)
setworldspawn {SPAWNX} 7 {SPAWNZ} (перемещает точку спавна мира вниз на y = 7)
fill {SPAWNX}-2 7 {SPAWNZ}-2 {SPAWNX}+2 9 {SPAWNZ}+2 minecraft:air (создает комнату 5x5x3 из воздуха внутри земли, или чего бы то ни было в этом месте)
Встроенные команды
Начиная с версии 0.5.0 появилась новая встроенная команда:
worldprimer-load-chunks
Она может использоваться для загрузки диапазона чанков, чтобы некоторые другие команды могли фактически работать. Например, ванильная команда /fill работает только в загруженных чанках, поэтому эту команду можно использовать для загрузки чанков перед выполнением команды fill. Чанки также немедленно ставятся в очередь на выгрузку, поэтому они не должны оставаться загруженными до следующего сохранения мира (каждые 45 секунд), а вместо этого выгружаются на следующем игровом тике.
Координаты являются координатами чанков (т.е. координаты блоков, деленные на 16). Диапазон является включительным, то есть от минимума до максимума включительно.
Обратите внимание, что это не зарегистрированная команда, и поэтому она не может использоваться через чат/консоль сервера, а используется только внутренне, если найдена в одной из настроенных команд.
Вот пример того, как построить коробку из бедрока в точке 0,0 в измерении Энд при его первой загрузке. Эти команды следует добавить в dimensionLoadingCommands:
worldprimer-dim-command-nth 1 1 worldprimer-load-chunks -1 -1 0 0
worldprimer-dim-command-nth 1 1 fill 10 0 10 -10 7 -10 minecraft:bedrock
worldprimer-dim-command-nth 1 1 fill 9 1 9 -9 6 -9 minecraft:air
worldprimer-dim-command-nth 1 1 say Строительство вашей коробки завершено!
Команда: /worldprimer spread-player
Эта команда существует начиная с версии 0.6.0-dev.20190814.220944.
Вот описание доступных опций и принципа работы команды:
