Starter Kit

Требуется модификация библиотеки Collective.

   Этот мод является частью Ванильный опыт модпак и Набор для персонализации от Serilum мод.
Starter Kit — это модификация, которая позволяет игрокам, впервые присоединяющимся к миру, получать предметы, заданные в конфигурационном файле. Можно назначить предметы для любого конкретного слота в инвентаре, для дополнительного оружия и для слотов брони. Модификация может определять, какие игроки никогда раньше не присоединялись к миру. Если другой мод добавляет предметы, например, путеводители, их можно либо полностью удалить, либо добавить после настройки комплекта. Это настраивается через файл конфигурации. addExistingItemsAfterKitSet вариант конфигурации.

Можно использовать на сервере для всех новых игроков или в одиночной игре, чтобы начать с выбранного вами инвентаря по умолчанию. Также есть дополнительная поддержка мода Team Island от FTB после команды создания острова.

Мод можно использовать только на стороне сервераЕсли вы хотите, чтобы игроки могли использовать графический интерфейс «Выбор комплекта», его также необходимо установить на клиенте. В качестве альтернативы, они могут выбирать комплекты с помощью серверных команд.

Требования:
 • Руководство по сложности приведено в описании. Уровень сложности варьируется от... Простой, Intermediate и Фильтр.
 • Предоставьте игрокам, впервые присоединяющимся к игре, пользовательские стартовые предметы и/или эффекты зелий.
 • Поддержка нескольких комплектов. Могут быть выданы случайным образом или выбраны игроком.
 • Предусмотрена настраиваемая система отслеживания для определения новых игроков, совместимая с существующими мирами.
 • Множество команд! Для создания, добавления, управления и выбора стартовых наборов.
 • Если комплекты установлены на клиентском компьютере, их можно выбрать через пользовательский графический интерфейс. В противном случае можно использовать команды.
 • Добавьте описания к своим наборам. Модпак для RPG, кто желает?
 • Удалите другие модифицированные стартовые предметы, такие как путеводители. Или добавьте их после стартового набора.

Настраиваемый: (Как мне это настроить?)
randomizeMultipleKitsToggle (по умолчанию = true): При добавлении нескольких стартовых наборов с помощью команды /starterkit add существует два способа их распределения. При включении этой опции один из них выбирается случайным образом. При отключении игроки могут выбрать один из них при первом подключении.
addExistingItemsAfterKitSet (по умолчанию = true): Следует ли добавлять обратно в инвентарь предметы, которые уже находились в инвентаре, например, книги, добавленные другими модами, после настройки набора. Если отключено, они будут удалены. Вы по-прежнему можете установить их вручную через набор.
usePotionEffectsInStarterKit (по умолчанию = true): Если необходимо включить функциональность зелий/эффектов мобов. Это означает, что при создании набора через /sk (add/set) сохраняются активные эффекты игрока. А при выдаче стартовых наборов эффекты добавляются новым игрокам.
formatKitNames (по умолчанию = true): Если названия комплектов должны быть отформатированы. Каждое слово будет написано с заглавной буквы.

chooseKitScreenHeader (по умолчанию = "%s, вы можете выбрать стартовый набор!"): Текст, отображаемый над экраном выбора набора, или, если мод не установлен, в чате. %s будет заменен именем игрока.

announcePlayerKitChoiceInDedicatedServer (по умолчанию = true): Следует ли отправлять на сервер уведомление всякий раз, когда новый игрок выбирает комплект снаряжения. Параметр 'randomizeMultipleKitsToggle' должен быть отключен, и должно быть доступно как минимум 2 стартовых комплекта.
enableFTBIslandCreateCompatibility (по умолчанию = true): Следует ли повторно устанавливать стартовый комплект после команды '/ftbteamislands create' из FTB Team Islands. Ничего не делает, если он не установлен.

Команды:
Можно использовать как '/starterkit', так и '/sk'.

Команды администратора:
/sk add (kit_name) - Добавляет ваш текущий инвентарь в список активных наборов.
/sk set (kit_name) - Устанавливает ваш текущий инвентарь в качестве единственного активного набора.

/sk give (kit_name) - Выдайте игроку случайный (или конкретный) стартовый набор.

/sk активировать /_все - Перемещает kit_name или все наборы из неактивного состояния в активное.
/sk деактивировать /_все - Перемещает kit_name или все наборы из активного состояния в неактивное.

/sk list (inactive) - Список всех активных (или неактивных) комплектов.
/sk сброс - Сбрасывает все данные отслеживания. Игроки получают новый комплект при регистрации.
/sk перезагрузка - Перезагружает изменения стартового комплекта из папки конфигурации.

Команды пользователя:
/sk выбрать - Позволяет игрокам выбирать стартовый набор с помощью команд. Это необходимо только в том случае, если на клиенте не установлен Starter Kit, а на сервере включена возможность выбора набора.
/sk info - Отображает описание и содержимое набора kit_name.
/sk help - Отображает команды стартового набора в игре.

Руководство по использованию:
Мод можно настроить множеством разных способов. Для лучшего понимания я разделил сложность на три разных уровня. Простой, Intermediate и Фильтр.

Простой:
Создайте собственный стартовый набор. Добавляйте/удаляйте стартовые предметы из других модов. И предоставляйте игрокам стартовый набор с помощью команд.

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

Дополнительно:
Предоставьте игрокам возможность выбирать комплект формы при первом подключении. Переведите неактивные комплекты формы по умолчанию в активные. Отобразите экран выбора комплекта формы. Создайте стартовый комплект с пользовательским описанием.

Раздел 1: Простой
Это стандартный стартовый набор, который будет предоставлен при установке мода без какой-либо настройки:


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


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


Вот и всё! Все новые игроки теперь получат "Модернизированный"набор, когда они впервые появляются на свет:


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


Чтобы вручную выдать стартовый набор другим игрокам (или себе), вы можете использовать команду '/стартовый набор дать (kit_name)команда.
Аргумент kit_name является необязательным; если он опущен, то:
Если модификация настроена через промежуточный интерфейс, комплект может быть выдан случайным образом.
Если модификация настраивается через расширенные параметры, может отобразиться экран выбора комплекта.


Раздел 2: Intermediate
Вы можете добавить еще один активный комплект, используя '/starterkit add (kit_name)команда.
При настройках по умолчанию это означает, что новые игроки теперь будут получать "По умолчанию"Или"Нет хлеба"стартовый набор."


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


Чтобы отключить активный набор, используйте '/starterkit deactivateЭто перемещает его в '../config/starterkit/kits/inactive/' папка.


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


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


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


Это файл данных для "Скоростной комплект«Набор. Он содержит предметы, которые получит игрок, а внизу указано, какие эффекты он получит.»
Если набор создан без активных эффектов, эта строка будет пустой. В противном случае она копирует точный уровень и длительность.
В данном примере содержится отсылка к эффекту скорости. lvl 1 с продолжительностью 3341 тиков, что равно 167 секундам. 20 тактов = 1 секунда.


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


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


Вот и всё! Теперь при первом присоединении к миру игрок будет получать "Скоростной комплект«Набор. Включает в себя несколько стандартных предметов и Скорость V эффект, длительностью 100 минут 5 минут:

 

Раздел 3: Фильтр
Стартовый комплект также включает в себя экран выбора комплекта! Вот пример того, как он выглядит с "По умолчанию" набор.
В этом разделе мы включим эту функцию, создадим набор и добавим к нему описание.


Отключить "Переключить рандомизацию нескольких наборов"внутри файла конфигурации. Помните, он находится внутри './config/starterkit.json5Для этого также можно использовать внутриигровой редактор настроек:


Внутри находятся некоторые стандартные комплекты../config/starterkit/kits/inactive/'папка. Давайте включим их для этого примера.
Используйте '/starterkit activate _allКоманда для активации всех неактивных комплектов.


Вы можете использовать '/список стартовых наборов'команда для просмотра списка активных в данный момент комплектов:


Поскольку все параметры заданы по умолчанию, вы сразу увидите, как это работает! Загрузите новый мир, и вам будет показан экран выбора набора:

 
Давайте добавим свой собственный набор и посмотрим, как работают описания.
Начните с составления списка необходимых вещей по вашему выбору и используйте '/starterkit addкоманда.
Я называю это "Тыква".


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


Это стандартное описание для любого вновь созданного комплекта.
Описание используется для экран выбора комплектаи '/информация о стартовом наборекоманда.


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


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


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


Нажать на "Выбрать стартовый комплектНажмите кнопку и получите выбранный комплект:


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


Игроки могут использовать '/информация о стартовом набореИспользуйте команду, чтобы посмотреть, какие предметы входят в стартовый комплект:


Комплект можно выбрать с помощью '/стартовый набор выбратькоманда:


------------------

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

На сайте Serilum.com представлен обзор и дополнительная информация обо всех доступных модификациях.

Комментарии отключены, так как я не могу отслеживать все отдельные страницы каждого мода.
Для обсуждения проблем, идей, предложений и всего остального есть репозиторий на GitHub. Спасибо!