Настройка MegaBlock Survivors

Процесс настройки MegaBlock Survivors построен на управляемых Nightbreak пакетах контента с опциональной поддержкой моделей через FreeMinecraftModels.

Требования

• Java 21
• Сервер на базе Paper/Spigot с API линии 1.21

Опциональные интеграции:

• FreeMinecraftModels для пользовательских моделей мобов и оружия (мягкая зависимость)

Что создаёт MegaBlock Survivors

При запуске MegaBlock Survivors инициализирует или использует следующие пути:

plugins/MegaBlockSurvivors/config.yml
plugins/MegaBlockSurvivors/content_packages/
plugins/MegaBlockSurvivors/imports/
plugins/MegaBlockSurvivors/worlds/
plugins/MegaBlockSurvivors/leaderboard.yml
plugins/MegaBlockSurvivors/version.txt

Конфигурация

config.yml содержит:

Ключ	Тип	По умолчанию	Описание
setupDone	boolean	false	Отслеживает, завершено ли руководство по первоначальной настройке

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

Когда setupDone имеет значение false, плагин показывает предупреждение о первой настройке игрокам с разрешением megablocksurvivors.* при их входе. Это помогает им пройти первоначальную загрузку контента.

Рекомендуемый порядок первой настройки

1. Установите MegaBlock Survivors и запустите сервер один раз.
2. Привяжите свой аккаунт Nightbreak с помощью /nightbreaklogin <token>.
3. Выполните /mbs downloadall, чтобы скачать все доступные пакеты контента MegaBlock Survivors в plugins/MegaBlockSurvivors/imports.
4. Выполните /mbs setup в любое время для просмотра, включения, отключения или обновления отдельных пакетов.
5. Выполните /mbs reload после загрузки контента для загрузки новых карт и ресурсов.

/nightbreaklogin <token> является частью общего потока аккаунтов Nightbreak/MagmaCore, а не командой, объявленной в plugin.yml MegaBlock Survivors.

Пакеты контента

Пакеты контента настраиваются через YAML-файлы в папке content_packages/. Каждый пакет может определять:

Поле	Тип	Описание
isEnabled	boolean	Активен ли пакет
name	string	Отображаемое имя пакета
description	string list	Строки описания
downloadLink	string	URL для ручного скачивания
version	integer	Номер версии пакета
nightbreakSlug	string	Слаг контента Nightbreak для автоматических загрузок
schematicFiles	string list	Файлы схем, включённые в пакет
worldFolders	string list	Включённые папки миров
worldContainerFolders	string list	Включённые папки контейнеров миров
modelFolders	string list	Папки моделей для FreeMinecraftModels
markerFileName	string	Маркерный файл для определения, установлен ли пакет
category	enum	FREE, PREMIUM или RESOURCES
toggleable	boolean	Можно ли включать/выключать пакет

Уведомления об обновлении версии

Когда плагин обнаруживает обновление версии (сравнивая с version.txt), он уведомляет консоль и всех онлайн-операторов об изменении версии.