FTB Team Dimensions

Важное предупреждение!

Как и большинство модов от FTB, этот проект был разработан специально для конкретных модифицированных сборок Minecraft. Мы настоятельно не рекомендуем использовать его вне тех пакетов, для которых он создавался, поскольку это может вызвать конфликты с другими модами, с которыми он не тестировался.

Обзор возможностей

FTB Team Dimensions предоставляет инструменты для создания динамических измерений, предназначенных для команд игроков. Для работы требуется установленный мод FTB Teams.

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

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

Типы генерации мира

На данный момент доступны два варианта генерации чанков, оба работают в пустых измерениях:

• Многобиомная генерация - распределение биомов аналогично обычному миру (используется по умолчанию)
• Однобиомная генерация - активируется установкой параметра singleBiomeDimension в значение true в конфигурации мода
  • Конкретный биом можно задать через настройку singleBiomeName (по умолчанию: minecraft:the_void)

В будущих версиях планируется расширить возможности по настройке генерации мира.

Настройка через датапаки

Для работы с конфигурацией потребуется базовое понимание принципов data-driven генерации мира в версии 1.19.2.

Основная настройка осуществляется через датапаки, используя стандартные типы structure и structure_set для определения предварительно созданных "островов". Эти структуры генерируются в новых измерениях всегда в чанке с координатами (0,0).

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

Пример конфигурации структуры

Стандартная предустановленная структура (data/ftbteamdimensions/ftbdim_prebuilt_structures/island1.json) выглядит следующим образом (необязательные поля могут отсутствовать в реальном файле):

{
  "id": "ftbteamdimensions:island1",
  "structure": "ftbteamdimensions:spawn/island1",
  "name": "Simple Island",
  // необязательные поля
  "author": "FTB Team",
  "structure_set": "ftbteamdimensions:default",
  "height": 64,
  "dimension_type": "ftbteamdimensions:default",
  "preview_image": "ftbteamdimensions:textures/spawn/island1.png",
  "spawn_override": [ 0, 64, 0 ]
}

Описание полей конфигурации:

• id - обязательное уникальное поле, соответствующее имени JSON-файла
• structure - обязательное поле, определяющее NBT-файл структуры
  • Пример: data/ftbteamdimensions/structures/spawn/island1.nbt содержит небольшой остров из травы и земли
• name - обязательное поле, отображаемое в интерфейсе выбора структуры
  • Может быть строкой или ключом перевода
• author - необязательное поле автора (по умолчанию: "FTB Team")
  • Отображается как "от <автор>" в интерфейсе выбора
• structure_set - необязательное поле набора структур
  • По умолчанию: ftbteamdimensions:default, включающий только ftbteamdimensions:start
  • Определяет, какие наборы структур используются при генерации измерения
• height - необязательное поле высоты генерации островов
  • По умолчанию: 64
• dimension_type - необязательное поле типа измерения
  • По умолчанию: ftbteamdimensions:default (аналогично обычному миру)
• preview_image - необязательное поле изображения предпросмотра
  • Текстура размером 128x64 для отображения в интерфейсе выбора
  • Стандартный путь: <modname>:textures/spawn/<id>.png
• spawn_override - необязательное поле переопределения точки спавна
  • По умолчанию игрок появляется в позиции (0, ВЫСОТА, 0)

Структуры NBT

Файлы структур (как для лобби в обычном мире, так и для островов в измерениях) используют стандартный формат NBT структур Minecraft, создаваемых с помощью Структурных Блоков.

Важное требование: все структуры должны содержать один Структурный Блок в режиме данных с пользовательским тегом spawn_point. Этот блок определяет точку появления игроков как в лобби, так и в создаваемых командных измерениях.

Структуры всегда размещаются таким образом, чтобы блок spawn_point находился в позиции (0,H,0), где H - значение из поля "height" в JSON конфигурации. При размещении структуры в мире этот блок заменяется воздухом, и игрок по умолчанию появляется на его месте.

Стандартная структура лобби находится по пути data/ftbteamdimensions/structures/lobby.nbt, но её можно изменить двумя способами:

• через конфигурацию мода (параметр lobbyStructure в ftbteamdimensions-common.toml)
• или просто переопределив её через датапак!