Мод Starter Kit дает игрокам набор базовых предметов, которые помогают быстро начать игру. Как только вы появляетесь в мире, вы получаете всё необходимое для комфортного старта без необходимости собирать всё вручную. Предметы включают основные инструменты, ресурсы и оборудование, которые сразу дают вам возможность заняться постройкой, добычей и исследованием мира. Ничего лишнего, только полезное для первых минут выживания.
Мод можно использовать на сервере для всех новых игроков или в одиночной игре, чтобы начать с стартовым инвентарём по вашему выбору.
Мод может работать только на сервере. Если вы хотите, чтобы игроки могли использовать GUI выбора набора, его нужно установить и на клиенте. В противном случае наборы можно выбирать через серверные команды.
Мод можно настроить разными способами. Чтобы было проще ориентироваться, я разделил сложности на три уровня: Простой, Средний и Сложный.
Простой уровень
-
Задать свой стартовый набор.
-
Добавлять или удалять стартовые предметы других модов.
-
Выдавать игрокам стартовый набор через команды.
Средний уровень
-
Добавить дополнительный стартовый набор.
-
Деактивировать набор через команды.
-
Создать стартовый набор с эффектами зелий, задавая их уровень и длительность.
Сложный уровень
-
Сделать так, чтобы игроки выбирали набор при первом входе.
-
Перевести неактивные стандартные наборы в активные.
-
Показать экран GUI выбора набора.
-
Создать стартовый набор с пользовательским описанием.
Раздел 1: Простой уровень
Это стандартный стартовый набор, который выдаётся, если мод установлен без какой-либо настройки:

Вы можете задать свой стартовый набор с помощью команды /starterkit set (kit_name) или /sk set (kit_name). Имя набора указывать необязательно.
После выполнения этой команды все остальные активные стартовые наборы перемещаются в папку неактивных.

Здесь вы можете увидеть новый файл данных стартового набора, созданный предыдущей командой. Он находится по пути: ./config/starterkit/kits/

Вот и всё! Теперь все новые игроки будут получать набор "Upgraded" при первом входе в мир.

Внутри конфигурационного файла, расположенного по пути ./config/starterkit.json5, вы можете выбрать, должны ли предметы стартовых наборов других модов удаляться или выдаваться после набора.
Примеры таких модифицированных стартовых предметов — книги-гайды.

Чтобы вручную выдать стартовый набор другим игрокам (или себе), используйте команду:
/starterkit give <player> (kit_name)
Аргумент kit_name необязательный. Если его не указывать:
- При настройке мода на среднем уровне набор будет выдан случайным образом.
- При настройке мода на сложном уровне может отобразиться экран выбора набора.

Раздел 2: Средний уровень
Вы можете добавить ещё один активный набор с помощью команды: /starterkit add (kit_name)
При стандартной конфигурации это означает, что новые игроки теперь будут случайным образом получать набор "Default" или "No Bread".

Чтобы увидеть все активные стартовые наборы, используйте команду: /starterkit list
Чтобы увидеть неактивные стартовые наборы, используйте команду: /starterkit list inactive

Чтобы деактивировать активный набор, используйте команду: /starterkit deactivate <kit_name>
Этот набор будет перемещён в папку: ./config/starterkit/kits/inactive/

Мод также может выдавать эффекты зелий вместе со стартовым набором! Убедитесь, что в конфиге включена опция usePotionEffectsInStarterKit.
Затем просто активируйте нужный эффект и используйте команду /starterkit set или /starterkit add.
Длительность эффекта будет установлена ровно такой, какая есть у игрока в данный момент, но позже она будет округлена на следующем шаге.

В этом примере игроку был выдан эффект зелия скорости. Он был активен во время использования предыдущей команды:

Найдите и откройте только что созданный набор. Путь к нему: ./config/starterkit/kits/Speed_Kit.txt

Это файл данных набора "Speed Kit". В нём указаны предметы, которые получит игрок, а внизу — эффекты, которые будут применены к игроку.
Если набор создаётся без активных эффектов, эта строка остаётся пустой. В противном случае копируются точный уровень и длительность эффекта.
В данном примере файл содержит ссылку на эффект Speed. Его уровень — 1, длительность — 3341 тик, что равно 167 секундам (20 тиков = 1 секунда).

Я собираюсь изменить эффект, который получит игрок, на Speed уровня 5 с длительностью 5 минут. 6000 тиков = 300 секунд = 5 минут.

Вы можете перезагрузить любые изменения, внесённые в файлы внутри ./config/starterkit/, с помощью команды: /starterkit reload

Вот и всё! Теперь, когда игрок впервые входит в мир, он будет получать набор "Speed Kit", который содержит несколько стандартных предметов и эффект Скорость V с длительностью 5 минут.
Раздел 3: Сложный уровень
Мод Starter Kit также включает экран выбора наборов! Ниже приведён пример того, как он выглядит с набором "Default".
В этом разделе мы включим экран выбора, создадим набор и добавим для него описание.

Отключите опцию "Randomize Multiple Kits Toggle" в конфигурации. Файл находится по пути: ./config/starterkit.json5. Также это можно сделать через редактор конфигурации прямо в игре.

В папке ./config/starterkit/kits/inactive/ находятся несколько стандартных наборов. Для примера давайте активируем их все.
Используйте команду:
/starterkit activate _all — чтобы активировать все неактивные наборы.

Вы можете использовать команду:
/starterkit list — чтобы увидеть, какие наборы в данный момент активны.

Поскольку все наборы содержат значения по умолчанию, вы сразу можете увидеть работу мода!
Загрузите новый мир — и вам будет показан экран выбора набора:
Давайте создадим свой пользовательский набор и посмотрим, как работают описания.
Начните с любого выбранного инвентаря и используйте команду: /starterkit add
Я называю его "Pumpkin".

Все описания наборов сохраняются в папке ./config/descriptions/. Они создаются автоматически при создании или добавлении набора.
Откройте файл описания с именем набора, который вы только что создали. В моём случае это: ./config/descriptions/Pumpkin.txt

Это содержимое описания по умолчанию для любого вновь созданного набора.
Описание используется для экрана выбора набора и команды: /starterkit info <kit_name>

Измените описание на любой желаемый текст! Ограничений по размеру нет, но лишний текст будет скрыт, поэтому старайтесь не делать его слишком длинным.

Чтобы перезагрузить изменения, внесённые в файл описания, используйте команду: /starterkit reload

Вот и всё! Теперь описание будет отображаться на экране выбора набора:

Нажмите на кнопку "Choose Starter Kit" и получите выбранный набор.

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

Игроки могут использовать команду:
/starterkit info <kit_name> — чтобы увидеть, какие предметы включены в набор.

Набор можно выбрать с помощью команды: /starterkit choose <kit_name>

Комментарии (0)