Starter Kit

Мод Starter Kit автоматически выдаёт новым игрокам на сервере или в одиночной игре заранее настроенный набор предметов и/или эффекты зелий. Можно полностью заменить начальный инвентарь или добавить предметы поверх уже существующих. Поддерживается совместимость с модом FTB Team Islands, позволяющая повторно выдавать стартовый комплект после создания острова.

Особенности

• Выдача стартового набора при первом входе игрока в мир;
• Настройка предметов для конкретных слотов инвентаря, в руку и на броню;
• Поддержка нескольких наборов, выдаваемых случайно или выбранных игроком;
• Отслеживание новых игроков, совместимое с существующими мирами;
• Управление наборами через команды сервера;
• Выбор наборов через GUI при наличии мода на клиенте или через команды;
• Добавление описаний к наборам;
• Возможность удалять или добавлять предметы от других модов после выдачи набора.

Требования и совместимость

• Требуется мод Collective;
• Совместим с пакетом The Vanilla Experience и Serilum’s Customization Bundle;
• Работает на серверной стороне, клиентская часть нужна для GUI выбора наборов;
• Поддержка FTB Team Islands (при наличии данного мода).

Настройка

Основной файл конфигурации находится в ./config/starterkit.json5, где можно управлять поведением выдачи предметов от других модов, форматом имён наборов, текстом в GUI и совместимостью с FTB Team Islands.

• randomizeMultipleKitsToggle (по умолчанию true) — при наличии нескольких активных наборов выдавать их случайно или позволять выбор игроку;
• addExistingItemsAfterKitSet (true по умолчанию) — добавлять предметы других модов после выдачи набора или удалять;
• usePotionEffectsInStarterKit (true) — включить сохранение и выдачу эффектов зелий вместе с набором;
• formatKitNames (true) — автоматически форматировать имена наборов с заглавных букв;
• chooseKitScreenHeader — текст над экраном выбора набора, где %s заменяется на имя игрока;
• announcePlayerKitChoiceInDedicatedServer (true) — объявлять на сервере выбор набора новым игроком;
• enableFTBIslandCreateCompatibility (true) — выдавать набор после создания острова командой FTB Team Islands.

Для создания и управления наборами используются команды сервера:

1. /starterkit set (название) — установить текущий инвентарь как единственный активный набор;
2. /starterkit add (название) — добавить текущий инвентарь как ещё один активный набор;
3. /starterkit give <игрок> (название) — выдать выбранный или случайный набор игроку;
4. /starterkit activate <название>/_all — активировать наборы из неактивных;
5. /starterkit deactivate <название>/_all — деактивировать наборы;
6. /starterkit list (inactive) — вывести список активных или неактивных наборов;
7. /starterkit reset — сбросить отслеживание новых игроков, чтобы они получили набор заново;
8. /starterkit reload — загрузить изменения из конфигурационных файлов.

Игроки могут выбирать наборы через команду /starterkit choose <название> при отключённом случайном выборе и отсутствии клиента с модом.

Пример простого использования

После установки мода без настроек всем новым игрокам выдаётся набор по умолчанию. Чтобы создать свой набор:

1. Соберите желаемые предметы в инвентаре и экипируйтесь;
2. Выполните команду /starterkit set (имя_набора) (имя необязательно);
3. Все другие активные наборы будут деактивированы и перемещены в папку inactive;
4. Набор сохранится в ./config/starterkit/kits/ и будет выдаваться новым игрокам.

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

Промежуточные возможности

Можно добавить дополнительные наборы, которые будут выдаваться случайным образом:

1. Создайте второй набор с помощью /starterkit add (имя_набора);
2. Просмотрите все активные наборы через /starterkit list;
3. Чтобы отключить набор, используйте /starterkit deactivate (имя_набора);
4. Включите выдачу эффектов зелий, активировав их перед сохранением набора;
5. Отредактируйте длительность и уровень эффектов в файлах наборов в папке ./config/starterkit/kits/;
6. Перезагрузите конфигурацию командой /starterkit reload.

Расширенные возможности

Для создания пользовательского интерфейса выбора наборов и добавления описаний:

1. Отключите случайный выбор наборов, изменив в конфиге randomizeMultipleKitsToggle на false;
2. Активируйте нужные наборы командой /starterkit activate _all;
3. При первом входе игрокам будет показан экран выбора набора;
4. Добавьте новый набор с помощью /starterkit add (имя_набора);
5. В папке ./config/descriptions/ отредактируйте файл с описанием набора — он отображается в GUI и по команде /starterkit info (имя_набора);
6. Убедитесь, что описание не слишком длинное, чтобы не обрезалось в интерфейсе.