Starter Kit Мод для Minecraft 1.20.1, 1.21.1

Starter Kit — це мод, який дозволяє гравцям, що вперше приєднуються до світу, отримувати предмети, задані у файлі конфігурації. Можна встановлювати предмети в будь-який конкретний слот інвентаря, у ліву руку та в слоти броні. Мод може визначати, які гравці ніколи раніше не приєднувалися. Якщо інший мод додає предмети, наприклад посібники, їх можна або повністю видалити, або додати після встановлення набору. Це налаштовується за допомогою параметра конфігурації addExistingItemsAfterKitSet.

Можна використовувати на сервері для всіх нових гравців або в одиночній грі, щоб почати зі стандартного інвентаря на ваш вибір. Також є необов'язкова підтримка моду FTB Team Island після команди створення острова.

Мод можна використовувати лише на стороні сервера. Якщо ви хочете, щоб гравці могли користуватися "Choose Kit GUI", його потрібно також встановити на клієнті. Інакше вони можуть обирати набори через серверні команди.

Особливості: • Посібник тут, в описі. Складність від Simply, Intermediate та Advanced. • Давайте гравцям, які вперше приєднуються до світу, власні стартові предмети та/або ефекти зілля. • Підтримка кількох наборів. Можна видавати випадково або обирати гравцем. • Є власне відстеження, щоб визначити, хто є новими гравцями, сумісне з наявними світами. • Багато команд! Для створення, додавання, керування та вибору стартових наборів. • Якщо встановлено на клієнті, набори можна обирати через власний екран GUI. Якщо ні, можна використовувати команди. • Додавайте описи до своїх наборів. RPG-модпак, будь ласка? • Видаляйте інші модифіковані стартові предмети, як-от посібники. Або додавайте їх після стартового набору. • Підтримка Curios і Trinkets! Предмети в цих слотах зберігаються в наборі та повертаються, без потреби в жодному з цих модів. • Виконуйте команди, коли видається набір, наприклад надання навички. Кожен набір має власний файл у папці commands. • Назви наборів, описи та текст вибору набору можуть бути ключами перекладу. Чудово для багатомовних модпаків.

Усі доступні параметри конфігурації:

Показати спойлер

randomizeMultipleKitsToggle типово true Коли кілька стартових наборів додано через /starterkit add, є два способи їх розподілу. Якщо це увімкнено, один обирається випадково. Якщо вимкнено, гравці можуть обрати один при першому приєднанні.

randomKitWeights типово "" Наскільки ймовірно, що кожен набір буде обрано, коли набори видаються випадково, у вигляді пар kitname:weight, розділених комами. Набори, які не вказані, мають вагу 1. Наприклад, 'warrior:5,wizard:1' робить набір warrior у 5 разів імовірнішим за набір wizard.

giveStarterKitOnFirstJoin типово true Чи отримують нові гравці (або чи можуть обрати) стартовий набір, коли приєднуються вперше. Якщо вимкнено, набори видаються лише через '/sk give <player>', що відкриває екран вибору набору, коли гравці можуть обирати. Корисно для NPC або командного блоку, який видає набори.

giveStarterKitOnRespawn типово false Чи отримують гравці останній стартовий набір, який вони отримали, знову, коли відроджуються після смерті. Нічого не робить, коли увімкнено ігрове правило keepInventory.

addExistingItemsAfterKitSet типово true Чи потрібно предмети, які були в інвентарі, як-от книги, додані іншими модами, повертати до інвентаря після встановлення набору. Якщо вимкнено, їх буде видалено. Ви все ще можете вручну встановити їх через набір.

usePotionEffectsInStarterKit типово true Чи має бути увімкнена функціональність ефектів зілля/мобів. Це означає, що під час створення набору через /sk (add/set) також зберігаються активні ефекти, які має гравець. А під час видачі стартових наборів ефекти додаються новим гравцям.

formatKitNames типово true Чи потрібно форматувати назви наборів. Кожне слово буде з великої літери.

chooseKitText типово "%s, you can choose a starter kit!" Текст, який використовується над екраном вибору набору, або, якщо мод не встановлено, у чаті. %s буде замінено на ім'я гравця. Також може бути ключем перекладу з ресурспаку, як і назви наборів та описи наборів.

lockKitChoiceScreen типово false Чи залишається екран вибору набору відкритим, доки набір не обрано. Якщо увімкнено, клавіша інвентаря та Escape не закривають його. Це зчитується з власної конфігурації кожного гравця, тож модпак задає це в конфігурації, яку постачає.

announcePlayerKitChoiceInDedicatedServer типово true Чи потрібно транслювати оголошення на сервері щоразу, коли новий гравець робить вибір набору. 'randomizeMultipleKitsToggle' має бути вимкнено, і має бути принаймні 2 доступні стартові набори.

enableFTBIslandCreateCompatibility типово true Чи потрібно повторно встановлювати стартовий набір після команди '/ftbteamislands create' з FTB Team Islands. Нічого не робить, коли його не встановлено.

Можна використовувати як '/starterkit', так і '/sk'.

Команди адміністратора: /sk add (kitname) - Додає ваш поточний інвентар до активних наборів. /sk set (kitname) - Встановлює ваш поточний інвентар як єдиний активний набір.

/sk give <player> (kitname) - Видати гравцеві випадковий (або конкретний) стартовий набір.

/sk activate <kitname>/all - Переміщує kitname або всі набори з неактивних до активних. /sk deactivate <kitname>/all - Переміщує kitname або всі набори з активних до неактивних.

/sk list (inactive) - Показує всі активні (або неактивні) набори. /sk reset - Скидає все відстеження. Гравці отримують інший набір при приєднанні. /sk reload - Перезавантажує зміни стартових наборів з папки конфігурації.

Команди користувача: /sk choose <kitname> - Дозволяє гравцям обирати стартовий набір через команди. Це потрібно лише коли Starter Kit не встановлено на клієнті, а сервер увімкнув вибір наборів. /sk info <kitname> - Показує опис і предмети kitname. /sk help - Показує команди Starter Kit у грі.

Посібник з використання: Мод можна налаштувати багатьма різними способами. Щоб краще орієнтуватися, я поділив складність на три різні розділи. Simple, Intermediate та Advanced.

Simple: Встановіть власний стартовий набір. Додавайте/видаляйте стартові предмети з інших модів. І видавайте гравцям стартовий набір через команди.

Intermediate: Додайте додатковий стартовий набір. Деактивуйте набір через команди. Додайте стартовий набір з ефектами зілля та встановленням рівня й тривалості.

Advanced: Змусьте гравців обирати набір при першому приєднанні. Перемістіть неактивні стандартні набори до активних. Покажіть екран GUI вибору набору. Створіть стартовий набір з власним описом.

Розділ 1: Simple Це стандартний стартовий набір, який буде видано, коли мод встановлено без будь-якої конфігурації:

Ви можете встановити власний стартовий набір за допомогою команди '/starterkit set (kitname)' (або '/sk set (kitname)'). Назва набору необов'язкова. Після використання цієї команди всі інші активні стартові набори переміщуються до папки неактивних.

Тут ви можете побачити новий файл даних стартового набору, створений попередньою командою. Він розташований у './config/serilum/starterkit/kits/':

Ось і все! Усі нові гравці тепер отримають набір "Upgraded", коли вперше приєднаються до світу:

Усередині файлу конфігурації, розташованого за адресою './config/serilum/starterkit.json5', ви можете обрати, чи потрібно видаляти або видавати після набору інші модифіковані стартові предмети. Прикладами таких модифікованих стартових предметів є посібники.

Щоб видати іншим гравцям (або собі) стартовий набір вручну, ви можете використати команду '/starterkit give <player> (kitname)'. Аргумент kitname необов'язковий, якщо його пропустити: Якщо мод налаштовано через intermediate, набір може бути видано випадково. Якщо мод налаштовано через advanced, може бути показано екран вибору набору.

Розділ 2: Intermediate Ви можете додати інший активний набір за допомогою команди '/starterkit add (kitname)'. Зі стандартною конфігурацією це означає, що нові гравці тепер випадково отримають стартовий набір "Default" або "No Bread".

Щоб побачити всі активні стартові набори, використайте команду '/starterkit list'. Щоб побачити неактивні стартові набори, використайте '/starterkit list inactive':

Щоб вимкнути активний набір, використайте '/starterkit deactivate <kitname>'. Це переміщує його до папки './config/serilum/starterkit/kits/inactive/'.

Мод також може видавати ефекти зілля разом зі стартовим набором! Переконайтеся, що 'usePotionEffectsInStarterKit' увімкнено в конфігурації. Потім просто переконайтеся, що ефект зілля увімкнено, і використайте команду '/starterkit set' або '/starterkit add'. Тривалість ефекту буде встановлена на те, що гравець має точно зараз, але ми округлимо це вгору на наступному кроці.

Для цього прикладу я дав гравцеві ефект зілля швидкості. Він був активний під час використання попередньої команди:

Знайдіть і відкрийте набір, який ми щойно створили. Шлях — './config/serilum/starterkit/kits/SpeedKit.txt':

Це файл даних для набору "Speed Kit". Він містить предмети, які отримає гравець, і внизу — які ефекти буде надано гравцеві. Коли набір створено без активних ефектів, цей рядок буде порожнім. Інакше він копіює точний рівень і тривалість. У випадку цього прикладу він містить посилання на ефект Speed. Це lvl 1 з тривалістю 3341 тіків, що дорівнює 167 секундам. 20 тіків = 1 секунда.

Я зміню ефект, який отримає гравець, на Speed рівня 5, з тривалістю 5 хвилин. 6000 тіків = 300 секунд = 5 хвилин:

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

Ось і все! Щоразу, коли гравець вперше приєднується до світу, він тепер отримає набір "Speed Kit". Який містить кілька стандартних предметів і ефект Speed V з тривалістю 5 хвилин:

Показати спойлер

Розділ 3: Advanced Starter Kit також містить власний екран вибору набору! Ось приклад того, як він виглядає з набором "Default". У цьому розділі ми увімкнемо це, створимо набір і додамо для нього опис.

Вимкніть "Randomize Multiple Kits Toggle" у конфігурації. Пам'ятайте, він розташований у './config/serilum/starterkit.json5'. Ви також можете використати редактор конфігурації в грі для цього:

Є кілька стандартних наборів у папці './config/serilum/starterkit/kits/inactive/'. Давайте увімкнемо їх для цього прикладу. Використайте команду '/starterkit activate all', щоб активувати всі неактивні набори.

Ви можете використати команду '/starterkit list', щоб побачити, які набори наразі активні:

Оскільки все містить стандартні значення, ви одразу побачите, як це працює! Завантажте новий світ, і вам буде показано екран вибору набору:

Показати спойлер

Давайте додамо власний набір і подивимося, як працюють описи. Почніть з інвентаря на ваш вибір і використайте команду '/starterkit add'. Я називаю його "Pumpkin".

Усі описи наборів зберігаються в './config/serilum/starterkit/descriptions/'. Вони автоматично створюються щоразу, коли ви створюєте або додаєте набір. Відкрийте файл опису з назвою набору, який ви щойно встановили. У моєму випадку файл — './config/serilum/starterkit/descriptions/Pumpkin.txt'.

Це стандартний вміст опису для будь-якого щойно створеного набору. Опис використовується для екрана вибору набору та команди '/starterkit info <kitname>'.

Змініть опис на будь-який, який забажаєте! Обмеження розміру немає, але будь-який надлишок буде приховано. Тож переконайтеся, що він не надто довгий:

Щоб перезавантажити зміни, які ми зробили у файлі опису, використайте команду '/starterkit reload':

Ось і все! Опис тепер буде видно на екрані вибору набору:

Натисніть кнопку "Choose Starter Kit" і отримайте обраний набір:

Starter Kit може автоматично визначати, чи встановлено мод на клієнті. Є підтримка використання лише на стороні сервера. У такому разі гравці можуть обрати набір через команди. Щоразу, коли сервер не отримує відповіді від клієнта, тобто мод не встановлено, під час першого приєднання надсилається таке повідомлення:

Гравці можуть використати команду '/starterkit info <kitname>', щоб побачити, які предмети включено до стартового набору:

Набір можна обрати командою '/starterkit choose <kitname>':

Ви можете вільно використовувати цей мод у будь-якому модпаку, доки завантаження залишається розміщеним у межах екосистеми CurseForge або Modrinth.

Serilum.com містить огляд і більше інформації про всі доступні моди.

Для проблем, ідей, пропозицій чи будь-чого іншого є репозиторій Github. Дякую!