Starter Kit

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

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

Что меняет Starter Kit

В обычном Minecraft новые игроки начинают с пустым инвентарём. На сервере это не всегда подходит: например, администратору может понадобиться выдать новичкам карту, базовые инструменты или предметы, нужные для правил конкретного мира. Starter Kit автоматизирует эту выдачу и позволяет сохранить одинаковые стартовые условия для всех.

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

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

Сервер, одиночная игра и совместимость

Starter Kit может работать только на сервере: игрокам не обязательно устанавливать мод на клиент, если они выбирают набор командами. Для графического меню выбора мод должен быть установлен и у игрока. Мод поддерживает Fabric, Forge, NeoForge и Quilt; среди совместимых версий Minecraft указаны 1.16.5, 1.18.2, 1.19.2-1.19.4, 1.20.x, 1.21.x, а также 26.1.x и 26.2.

Для работы требуется библиотека Collective. Starter Kit совместим с FTB Team Islands и используется в сборках The Vanilla Experience и Serilum's Customization Bundle.

Наборы и выбор игроков

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

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

Настройки

Основной файл конфигурации находится по пути ./config/starterkit.json5. В нём доступны следующие параметры:

• randomizeMultipleKitsToggle - включён по умолчанию. Если активно несколько наборов, мод случайно выдаёт один. При отключении игрок выбирает набор сам.
• addExistingItemsAfterKitSet - включён по умолчанию. Возвращает в инвентарь предметы, которые там находились до выдачи набора, например книги других модов. Если выключить, такие предметы удаляются, но их можно вручную добавить в комплект.
• usePotionEffectsInStarterKit - включён по умолчанию. Разрешает сохранять активные эффекты при создании набора и выдавать их новым игрокам.
• formatKitNames - включён по умолчанию. Делает первую букву каждого слова в названии набора заглавной.
• chooseKitScreenHeader - заголовок меню выбора. По умолчанию используется текст %s, you can choose a starter kit!; %s заменяется именем игрока. Если клиентского мода нет, сообщение выводится в чат.
• announcePlayerKitChoiceInDedicatedServer - включён по умолчанию. Объявляет на выделенном сервере, какой набор выбрал новый игрок. Работает, когда случайная выдача отключена и доступно не менее двух наборов.
• enableFTBIslandCreateCompatibility - включён по умолчанию. Повторно задаёт стартовый набор после команды создания острова FTB Team Islands. Без установленного FTB Team Islands настройка ничего не меняет.

Команды Starter Kit

Для команд подходят оба варианта: /starterkit и сокращённый /sk. Большинство действий по настройке наборов доступно администраторам.

Команды администратора

• /sk add (kit_name) - добавляет текущий инвентарь в активные наборы.
• /sk set (kit_name) - делает текущий инвентарь единственным активным набором. Имя можно не указывать; остальные активные наборы перемещаются в неактивные.
• /sk give <player> (kit_name) - выдаёт игроку случайный или указанный набор.
• /sk activate <kit_name>/_all - включает указанный набор или все неактивные наборы.
• /sk deactivate <kit_name>/_all - отключает указанный набор или все активные наборы.
• /sk list (inactive) - показывает активные наборы; с аргументом inactive выводит неактивные.
• /sk reset - сбрасывает отслеживание игроков. При следующем входе они снова получат набор.
• /sk reload - перечитывает изменения файлов конфигурации и наборов.

Команды игрока

• /sk choose <kit_name> - выбирает набор командой. Нужна, когда сервер разрешил выбор, но у игрока не установлен клиентский мод.
• /sk info <kit_name> - показывает описание и содержимое набора.
• /sk help - выводит список команд в игре.

Создание и настройка набора

Чтобы задать стартовый инвентарь, соберите нужные предметы и выполните /starterkit set (kit_name). Название необязательно. Файл набора появится в ./config/starterkit/kits/, а прежние активные наборы будут перемещены в неактивную папку. После этого новые игроки будут получать заданный комплект.

Чтобы добавить дополнительный вариант, используйте /starterkit add (kit_name). Активные наборы можно посмотреть через /starterkit list, а отключённые - через /starterkit list inactive. Отключённый комплект хранится в ./config/starterkit/kits/inactive/ и при необходимости его можно вернуть командой активации.

Для набора с эффектом сначала включите usePotionEffectsInStarterKit, затем получите нужный эффект и выполните /starterkit set или /starterkit add. Мод сохранит текущий уровень и оставшееся время действия эффекта. В файле комплекта длительность задаётся в тиках: 20 тиков равны одной секунде, поэтому 6000 тиков - это 5 минут. Файлы наборов находятся в ./config/starterkit/kits/.

Описания хранятся отдельно в ./config/descriptions/. Они показываются в меню выбора и команде /starterkit info <kit_name>. После редактирования файлов выполните /starterkit reload, чтобы применить изменения без повторной настройки комплекта.

Если набор не указан в команде /starterkit give <player>, результат зависит от настроек: мод может выбрать комплект случайно или предложить экран выбора. В одиночном мире принцип тот же - можно настроить собственный инвентарь и проверить выдачу на новом персонаже.

Что учесть перед настройкой

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

Для меню выбора необходим клиентский мод. Если устанавливать его игрокам не планируется, оставьте выбор наборов доступным через команды и объясните им, как пользоваться /sk info и /sk choose. А перед использованием /sk reset помните: команда сбрасывает учёт входов, поэтому игроки снова получат стартовую выдачу.