Перейти к основному содержимому

Создание генераторов

Генераторы​

Генераторы — это наиболее мощная часть системы конфигурации BetterStructures. По умолчанию существует 31 генератор, которые в совокупности управляют более чем 200 постройками, распределяемыми BetterStructures. Хотя вы можете создавать свои собственные генераторы, вы также можете использовать существующие в качестве ярлыка.

Генераторы указывают плагину, где именно должны появляться объекты, и определяют таблицы добычи. Стандартные генераторы также названы таким образом, что их назначение должно быть очень легко угадать.

Единственное обязательное поле для генераторов — это параметр structureType, который указывает плагину, предназначена ли постройка для появления в небе, неглубоко под землей, глубоко под землей, на поверхности или на поверхности жидкости.

isEnabled​

Определяет, включен ли генератор.

structureType​

Устанавливает тип структуры постройки. Обратите внимание, что вы можете составить список нескольких типов!

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

structureType:
- SURFACE
- UNDERGROUND_SHALLOW

Это позволяет одному генератору создавать структуры в нескольких местах, например, как на поверхности, так и в неглубоких подземных областях.

Ниже приведены допустимые значения типа структуры:

surface​

structureType:
- SURFACE

Структуры на поверхности появляются на поверхности мира. Единственное исключение — окружающая среда Nether, где они появляются в местах, которые плагин считает достаточно похожими на поверхность.

sky​

structureType:
- SKY

Структуры в небе появляются между 80 и 120 блоками над воздухом, что можно настроить в config.yml. Единственное исключение — окружающая среда Nether, где они появляются в местах, которые плагин считает достаточно похожими на воздух.

underground_shallow​

structureType:
- UNDERGROUND_SHALLOW

Структуры неглубокого подземелья появляются между y=0 и y=60 в верхнем мире, y=60 и y=120 в Nether и на любой действительной высоте подземелья в Конце.

Примечание: Вы заметите, что существуют два подземных параметра. Это потому, что наличие только одного приводит к очень разреженному подземелью, так как Minecraft имеет много подземного пространства, и игроки часто упускают подземные структуры просто потому, что не добывали их. Это также гарантирует равномерное распределение на разных глубинах.

underground_deep​

structureType:
- UNDERGROUND_DEEP

Структуры глубокого подземелья появляются между y=-64 и y=0 в верхнем мире, y=0 и y=60 в Nether и не появляются в Конце.

liquid_surface​

structureType:
- LIQUID_SURFACE

Структуры жидкой поверхности будут появляться на жидкостях. В случае верхнего мира они появляются на воде и почти всегда в океанах. В случае Nether они появляются в лавовых озерах. В Конце они не появляются.

lowestYLevel​

Устанавливает самый низкий уровень Y (высоту), в котором может появиться структура. По умолчанию: -59.

highestYLevel​

Устанавливает самый высокий уровень Y (высоту), в котором может появиться структура. По умолчанию: 320.

Диапазоны уровней Y по умолчанию по измерениям:

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

  • Верхний мир/пользовательские миры: Y=-60 до Y=320 (параметры: lowestYNormalCustom / highestYNormalCustom)
  • Nether: Y=4 до Y=120 (параметры: lowestYNether / highestYNether)
  • Конец: Y=0 до Y=320 (параметры: lowestYEnd / highestYEnd)
  • Небесные структуры (верхний мир): Y=80 до Y=120 (настраивается через normalCustomAirBuildingMinAltitude / normalCustomAirBuildingMaxAltitude)
  • Небесные структуры (Конец): Y=80 до Y=120 (настраивается через endAirBuildMinAltitude / endAirBuildMaxAltitude)

Эти глобальные значения по умолчанию могут быть переопределены для каждого генератора с помощью lowestYLevel и highestYLevel в конфигурациях генератора.

validWorlds​

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

validWorldEnvironments​

Устанавливает список окружений мира, в которых будет появляться структура. Если список отсутствует, будут использованы все окружения мира, разрешенные плагином. Допустимые значения: NORMAL, NETHER, THE_END и CUSTOM.

validBiomes​

Устанавливает список действительных биомов, в которых может появиться структура. Если список не определен, будет предполагаться, что каждый биом является действительным!.

Это требует использования биомов в формате namespace:key (например, minecraft:plains, minecraft:desert). Вы можете найти список действительных биомов, определенных в Spigot API. Плагин автоматически включает пользовательские биомы, которые сопоставлены с ванильными биомами через систему CustomBiomeCompatibility.

Поддержка пользовательских биомов:

BetterStructures автоматически поддерживает пользовательские биомы из генераторов мира, таких как Terralith, Iris, Terra и TerraformGenerator.

Когда вы указываете ванильный биом в validBiomes, плагин автоматически включает совместимые пользовательские биомы:

validBiomes:
  - minecraft:plains
  - minecraft:forest

Эта конфигурация будет создавать структуры в:

  • Ванильные биомы (minecraft:plains, minecraft:forest)
  • Все пользовательские биомы, сопоставленные с этими типами ванили (например, terralith:blooming_plains)

Дополнительная конфигурация не требуется - поддержка пользовательских биомов осуществляется автоматически.

treasureFilename​

Устанавливает файл сокровищ, который будет использовать генератор. Это устанавливает то, что появляется в сундуках для всех построек, использующих этот генератор, если не установлено другое значение в параметре treasureFile конфигурации схемы.