CobbleHunts

CobbleHunts - серверный мод для Fabric, который добавляет в Cobblemon повторяемые задания по поимке покемонов. Он помогает превратить обычные поиски нужного Pokémon в понятную игровую цель: игроки берут задание, находят подходящего покемона и сдают его через интерфейс. На сервере это даёт повод исследовать мир и поддерживает активность между крупными событиями.

Есть два режима. Global Hunts объединяют игроков всего сервера вокруг общей цели, а Solo Hunts предлагают персональные задания четырёх уровней сложности: Easy, Normal, Medium и Hard. В настройках можно задавать виды покемонов и дополнительные требования - например, нужную форму, блестящий аспект, пол, характер или определённое количество идеальных IV.

CobbleHunts подойдёт владельцам Cobblemon-серверов, которым нужны квесты на поимку Pokémon и настраиваемая система наград. Выплаты могут быть предметами или командами сервера, поэтому их можно связать с экономикой. Игроки принимают задания, следят за активными охотами и сдают улов через GUI; администраторы управляют целями и наградами прямо в игре.

Зависимости

Для работы нужны следующие моды:

• Fabric API
• Fabric Language Kotlin
• Cobblemon
• E-Utils (EverlastingUtils)

Актуальная указанная версия проекта - 1.1.1 для Minecraft Java 1.21.1 на Fabric. Для неё требуется E-Utils 1.1.2. В этой версии также исправлена проверка наличия E-Utils, поэтому важно подобрать совместимые версии зависимостей.

Охоты и настройки

• Общие задания и личное развитие. Global Hunts доступны всему серверу, а Solo Hunts распределены по уровням сложности. Для каждого режима и уровня можно отдельно настроить таймеры и время ожидания между заданиями.
• Точные условия поимки. В пулах целей задаются вид покемона, форма и аспекты, например shiny. Для более сложных охот можно потребовать конкретный пол, характер или идеальные IV.
• Настраиваемые награды. За выполнение можно выдавать предметы, запускать серверные команды или сочетать эти варианты. Это позволяет, например, подключить награду к экономике сервера, если она поддерживает выдачу валюты командами.
• Интерфейс для игроков. В GUI отображаются активные задания; через него игроки принимают охоты и сдают пойманных покемонов.
• Инструменты администратора. Конфигурацию можно перезагрузить без перезапуска сервера, управлять задержками заданий и отменить ошибочную сдачу покемона.
• Редактор в игре. Команда /hunts editor открывает интерфейс для управления пулами покемонов и наград.

Команды

Основная команда - /hunts. Узлы разрешений настраиваются в конфигурации.

Команда	Разрешение	Назначение
/hunts	cobblehunts.hunts	Открывает главное меню активных охот.
/hunts editor	cobblehunts.editor	Открывает редактор целей и наград.
/hunts reload	cobblehunts.reload	Повторно загружает файлы конфигурации без перезапуска сервера.
/hunts revertturnin <player> <pokemon>	cobblehunts.revertturnin	Возвращает игроку покемона, сданного для выполнения охоты.
/hunts cooldowns <action> <type> ...	cobblehunts.cooldowns	Управляет задержками: reset, extend <seconds> или decrease <seconds>.

Конфигурация

Файлы CobbleHunts находятся в config/cobblehunts/. После изменения настроек выполните /hunts reload, чтобы применить их без перезапуска сервера.

config.jsonc - основные параметры

Параметр	Назначение
globalHuntsEnabled	Включает или отключает общие охоты на сервере.
soloHuntsEnabled	Включает или отключает персональные охоты.
globalTimeLimit и globalCooldown	Задают продолжительность общей охоты и задержку перед следующей. Время указывается в секундах.
solo[Difficulty]TimeLimit и solo[Difficulty]Cooldown	Настраивают лимит времени и задержку для каждого уровня Solo Hunts, например soloEasyTimeLimit.
autoTurnInOnCapture	Если включено, подходящий пойманный покемон сразу засчитывается в охоту.
takeMonOnTurnIn	Определяет, забирается ли покемон из команды игрока при сдаче. При значении false игрок оставляет его себе.
rewardMode	Режим наград: weight выбирает одну случайную награду по весу, а percentage отдельно проверяет шанс каждой награды.
autoAcceptSoloHunts	Автоматически назначает новое персональное задание, когда заканчивается задержка для соответствующего уровня.

Нюанс сдачи: проверьте сочетание autoTurnInOnCapture и takeMonOnTurnIn до запуска охот на сервере. Первый параметр отвечает за автоматический зачёт улова, второй - за то, останется ли покемон у игрока после сдачи.

pokemon_pools.jsonc - цели охоты

Здесь задаются отдельные пулы для Global Hunts и четырёх уровней Solo Hunts. Для записи покемона доступны следующие параметры:

• species - идентификатор вида, например pikachu.
• form - необязательная форма, например alolan.
• aspects - список обязательных аспектов, например shiny.
• chance - вес выбора покемона из пула.
• gender - необязательное требование к полу: male или female.
• nature - необязательный характер, например adamant.
• ivRange - для сложных заданий задаёт количество идеальных IV со значением 31, например 2.

Так можно сделать простые охоты на распространённые виды и более требовательные задания с дополнительными условиями. Конкретные цели зависят от настроенных пулов.

loot_pools.jsonc - награды

В этом файле настраиваются награды отдельно для типов охот и уровней сложности.

• command запускает команду сервера. В качестве имени игрока используется %player%; такой вариант подходит для интеграции с экономикой.
• item выдаёт предмет. Для описания предмета поддерживается serializableItemStack, включая данные NBT.
• Для командной награды можно указать предмет, который будет показан в GUI как её изображение.
• chance задаёт вес награды при выборе из пула.

Учтите разницу между режимами из config.jsonc: weight выбирает одну награду с учётом её веса, а percentage проверяет вероятность выдачи каждой награды отдельно. Это позволяет настроить как один случайный приз, так и несколько наград за одну охоту.