Nucleoid Creator Tools

Nucleoid Creator Tools

Этот мод добавляет различные инструменты для создания игрового контента для экосистемы Nucleoid. Основная текущая функциональность этого мода — работа с созданием игровых карт.

Создание карты

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

Первый шаг к созданию карты — открытие рабочего пространства карты. Рабочее пространство карты — это, по сути, просто измерение, в котором вы можете строить, и которое позже можно экспортировать в файл шаблона карты, читаемый Plasmid.

Пустое рабочее пространство карты в виде пустоты можно открыть командой: `/map open (например,/map open bedwars:cubes) Обязательный id— это уникальный идентификатор вашего рабочего пространства в форматеnamespace:identifier`. Он должен быть полностью в нижнем регистре и не может содержать пробелов.

Вы также можете создавать рабочие пространства с пользовательскими генераторами чанков: `/map open like (например,/map open bedwars:nether like minecraft:nether`)

Перемещение в рабочие пространства и из них

Создав рабочее пространство, вам нужно иметь возможность перемещаться между ними.

Это возможно с помощью команды: `/map join `, которая телепортирует вас в измерение этого рабочего пространства. Оказавшись в измерении рабочего пространства, вы можете свободно строить всё, что захотите!

Точно так же можно покинуть рабочее пространство карты и вернуться на прежнее место командой: /map leave.

Установка границ карты

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

При первом входе в рабочее пространство вы заметите контур рамки, образованный частицами — это границы вашей карты! Их можно изменить в рабочем пространстве командой: `/map bounds <corner_1> <corner_2>`.

• id — это id рабочего пространства, для которого устанавливаются границы
• corner_1 и corner_2 — два угла выровненной по осям ограничивающей рамки

Установка начала координат карты

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

Например, если ваша карта на 10 блоков выше, чем нужно, установка начала координат в (0; 10; 0) приведёт к тому, что экспортированная карта сместится на 10 блоков вниз.

Это можно задать командой `/map origin `

• id — это id рабочего пространства, для которого устанавливается начало координат
• origin — позиция блока, в которую нужно установить начало координат

Будьте осторожны при установке начала координат, чтобы не вывести карту за границы! Если вы установите начало координат карты где-то ниже нижнего y ваших границ карты, это будет означать, что в экспортированной карте ваши границы уйдут ниже y=0!

Работа с регионами

Иметь карту, которую можно загрузить для миниигры, полезно, но игровой логике не хватает какой-либо полезной информации о карте. Например, как ваша миниигра узнает, где спавнить игроков или где находится кровать для конкретной команды в bedwars?

Вот тут и приходят на помощь регионы: регион — это просто именованная область карты, которая может использоваться для сообщения игровому коду области, в которой что-то должно произойти. В карте может быть несколько регионов с одинаковым именем или несколько регионов с разными именами в одном и том же месте. Именование регионов полезно для того, чтобы идентифицировать для игрового кода, что представляет собой каждый регион.

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

Чтобы начать создавать регион, выполните: /give @s nucleoid_creator_tools:add_region. Это даёт вам предмет Add Region, который можно использовать для удобного определения регионов в вашем мире путём выбора двух углов.

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

Теперь можно выполнить `/map region commit . Это добавит выделенный регион на вашу карту с указанным marker`, и он подсветится частицами другого цвета.

При выборе региона предметом Add Region вы можете дополнительно изменить режим выделения, присев и кликнув правой кнопкой мыши. Это переключает 3 режима:

• режим смещения: выделенный блок — это блок, на который вы смотрите, смещённый в сторону, с которой вы на него смотрите (как при установке блока)
• точный режим: выделенный блок — это ровно тот блок, на который вы смотрите (как при разрушении блока)
• режим у ног: выделенный блок — это блок у ваших ног

Полезные команды для регионов

• `/map region rename all : переименовывает все регионы в текущем рабочем пространстве с oldнаnew`
• `/map region rename here : переименовывает все регионы в текущем рабочем пространстве, пересекающиеся с вашим игроком, с oldнаnew`
• /map region remove here: удаляет все регионы в текущем рабочем пространстве, пересекающиеся с вашим игроком
• `/map region remove at : удаляет все регионы в текущем рабочем пространстве, пересекающиеся с указанной pos`

Прикрепление данных

Может быть полезно передавать коду больше информации о карте, чем просто регионы. Это можно сделать, прикрепив произвольные NBT-данные, к которым позже сможет получить доступ код.

Данные можно прикрепить либо к региону, либо к карте в целом.

Чтобы работать с данными конкретного региона, ваш игрок должен пересекаться с границами этого региона!

• `/map region data get`: выводит данные для указанного региона
• `/map region data set `: задаёт данные для указанного региона (это перезапишет все ранее существовавшие данные!)
• `/map region data merge `: объединяет указанные данные с существующими данными указанного региона

Дополнительно можно передать данные в команду фиксации региона: `/map region commit `

Для работы с данными глобальной карты команды работают аналогично:

• /map data get: выводит данные, прикреплённые к карте
• `/map data set `: перезаписывает существующие данные на карте
• `/map data merge `: объединяет указанные данные с существующими данными на карте

Экспорт карт

Когда ваша карта будет готова, вы захотите экспортировать её в файл, который сможет загрузить мод для мини-игр. Это можно сделать просто, выполнив: `/map export `.

Экспортированная карта будет помещена в `/nucleoid_creator_tools/exports//map_templates/.nbt`