CobblemonQuests

CobblemonQuests

Цикл активности, который нужен вашему серверу Cobblemon. Ежедневные, еженедельные, элитные, скрытые и повторяемые задания, общие цели всего сервера, таблицы лидеров, настраиваемые звуковые эффекты и полный набор инструментов для создания и кастомизации прямо в игре — всё на чистом одноэкранном GUI, который админы могут переставлять слот за слотом из конфига, не трогая Java.

Основные возможности

Для игроков

• 6 типов заданий — ежедневные, еженедельные, элитные еженедельные, скрытые, повторяемые и обычные (шаги цепочек).

  • Повторяемые задания никогда не ротируются. Проходите их сколько угодно раз; общее число прохождений отслеживается для каждого задания и показывается на плитке.
  • Элитные еженедельные — одно особо сложное еженедельное задание со значительно лучшими наградами, отображается в отдельном слоте со свечением.
  • Скрытые задания незаметно открываются при совпадении триггеров (число поимок, вид, измерение и т. д.) и живут в отдельном GUI просмотра скрытых заданий вместе с плитками-трофеями за уже выполненные.
• 15 типов целей — поймать, победить NPC в бою, победить дикого (учитывается отдельно от побед в PvE), повысить уровень, получить уровни, эволюционировать, вывести яйца, бросить Poké Balls, использовать конфеты опыта, посетить биомы / измерения (с защитой от пинг-понга), поймать shiny, поймать легендарного, выполнить PokeHunts, пройти рейды.
• Единый GUI заданий на 6 рядов — всё видно сразу: плитка таблицы лидеров + таймеры сброса в ряду 0, ежедневные в рядах 1–2, еженедельные в рядах 3–4, серия / вехи / скрытые / повторяемые / закрыть в ряду 5. Больше не нужно копаться в подстраницах.
• Серверные задания — общие цели всего сервера с живой полосой босса. Каждый игрок вносит вклад. Длительность от 1 часа до 1 недели. Топ-3 участника получают бонусные награды; офлайн-участники получают выплату при следующем входе через систему отложенных наград. Таблица лидеров по вкладу с головами игроков + медалями.
• Таблицы лидеров — пирамида из топ-16 голов игроков со свечением собственного ранга. Ничьи теперь разрешаются по тому, кто достиг значения первым (по времени), так что обогнать друга — значит остаться на вершине.
• Звуковые + визуальные эффекты — настраиваемые звуки при завершении задания, получении награды, достижении вехи, продвижении серии, обнаружении скрытого, продвижении цепочки и завершении общей цели. Вспышки title / subtitle на крупных событиях.
• Система получения наград — выполненные задания светятся ★ READY ★; получайте награды по одному или жмите Claim All. Есть авто-режим.
• Ежедневная серия + пожизненные вехи — награда за постоянство. GUI вех разбит на страницы и полностью настраивается.
• Система рероллов с жёсткими лимитами на ротацию — daily-per-day и weekly-per-week (по умолчанию по 1). Платного запасного варианта нет. Счётчики списываются до ролла и возвращаются, если пул не может выдать замену, так что одновременные клики не потратят дважды.
• Баннеры наград в чате — каждая выплата награды показывает однострочное подтверждение: ★ +250 Stars / $ +5000 PokeDollars. Формат полностью настраивается для каждого сервера.

Для админов

• Настройка в игре буквально каждой строки, слота, предмета, цвета и кнопки, видимых игроку. Без правки jar, без Java. Каждый GUI — отдельный файл HOCON в config/cobblemonquests/gui/:

  • main_menu.conf, detail_menu.conf, stats_menu.conf, milestone_menu.conf, leaderboard_menu.conf, repeatable_menu.conf
  • Задайте slot (0–53) для каждой кнопки. Задайте rows (1–6) для каждого меню. Переключайте флаг visible у любой кнопки. Замените заполнитель из стеклянных панелей на любой id предмета. Настройте символы, цвета, длину и скобки полосы прогресса. Переупорядочьте части названия задания через name-format. Сортируйте задания по прогрессу / редкости / алфавиту / статусу / id.
• Кнопки пользовательских команд — добавьте неограниченное число дополнительных кнопок в любой GUI: ссылки на магазин, Discord, голосование, ярлыки ванильных команд. Каждая запись принимает slot, item, name, lore, glow и шаблон command с подстановкой {player}.
• Хуки команд на события — запускайте консольные команды при любом из этих событий: quest-complete, milestone-reached, streak-milestone, claim. Подключайте вебхуки Discord, сообщения-бродкасты, выдачу внешних предметов — всё без перекомпиляции.
• Быстрые действия админа по правому клику — кликните правой кнопкой по любой плитке задания с правами админа, чтобы открыть Complete / Reset Progress / View Details прямо на месте.
• Браузер заданий — с вкладками по типу (All / Daily / Weekly / Normal / Elite / Hidden / Repeat), фильтрами по редкости + категории, сортировкой, страницами. Масштабируется до сотен заданий.
• Редактор заданий + мастер создания заданий — полный CRUD прямо в игре. Переключайте тип / категорию / редкость, задавайте цели, собирайте награды через мастер из 4 шагов, сохраняйте на диск, дублируйте, удаляйте (подтверждение двумя кликами), живой предпросмотр.
• Мастер наград из 4 шагов — выберите категорию (Currency / Items / Crate Keys / Commands) → просмотрите + выберите (браузер предметов с вкладками All / Cobblemon / Balls / Candies / Vanilla и полной пагинацией реестра) → задайте количество → сводка + подтверждение.
• Переопределение display для каждой награды — замените текст лора любой награды своим MiniMessage. Идеально для брендированных наград или сокрытия сырых команд padmin givekey за чистой строкой `Special Reward`.
• Карта переименования отображения наград — rewards.display-names сопоставляет любой id предмета или id ключа с пользовательским именем глобально. Серверы могут поставлять полностью брендированный набор подсказок без правок каждой награды.
• Браузер цепочек + редактор + мастер (для админов) — полное создание цепочек в игре с выбором шагов, созданием заданий на месте, стрелками переупорядочивания, тегами сложности, переключателем зацикливания, наградами за завершение цепочки.
• Браузер серверных заданий + редактор + мастер — создавайте цели всего сервера с типом цели, целью, длительностью (от 1 ч до 1 недели), базовыми наградами и бонусными наградами для топ-3 участников. Панель управления активными целями: остановить, сбросить, ускорить прогресс, смотреть участников в реальном времени.

• GUI управления игроками — просматривайте любого игрока онлайн: активные задания, серия, баланс Stars, всего выполнено, число прохождений повторяемых заданий. Действия админа: выдать Stars, сбросить ежедневные / еженедельные,

• Сброс данных игрока — подтверждение двумя кликами. Права администратора перепроверяются при каждом клике — понижение в правах посреди сессии срабатывает сразу.
• Редактор конфига — многостраничный хаб: Reroll Caps / Pool Weights / Toggles / GUI Layout. Каждая — отдельная аккуратная подстраница с кнопкой Save.
• Редактор раскладки GUI — визуальная сетка на 54 слота. Клик по слоту переключает его роль. Save записывает в gui/player_main.conf и автоматически перезагружает.

• Диагностика и тестовые команды:

  • /quests admin debug events — счётчики срабатываний по каждому трекеру + время последнего срабатывания + последние детали. Разбирай жалобы «мои квесты не продвигаются» за секунды.
  • `/quests admin debug stars ` — выводит авторитетный баланс Stars + суммарный заработок за всё время.
  • `/quests admin testkey [amount]` — вызывает мост ключей от ящиков на месте, чтобы проверить свой шаблон, не дожидаясь квеста.
  • `/quests admin testcommand <command...>` — прогоняет любой шаблон награды-команды через тот же пайплайн SafeDispatch, который используют награды.

Награды

• PokéDollars (основная валюта Impactor)
• Stars — теперь выдаются через настраиваемую команду экономики (по умолчанию: eco deposit {amount} {currency} {player}), так что обновляется реальный счёт валюты Impactor. Локальный JSON-реестр зеркалится только как кэш для таблицы лидеров.
• Предметы — любой id предмета Minecraft / Cobblemon, с обработкой переполнения.
• Ключи от ящиков — глобальный шаблон команды плюс карта переопределений по ключам (integrations.crate-key-commands), чтобы lunar мог идти в Pebble's Crates, а vote — в ExcellentCrates на одном и том же сервере без ветвлений где-либо ещё. Шаблон по умолчанию из коробки нацелен на Pebble's Crates (padmin givekey {player} {amount} {key}).
• Кастомные команды — выполнение из консоли с плейсхолдером {player}, прогон через единый пайплайн SafeDispatch, который ловит опечатки, отсутствующие узлы и повторный вход вместо того, чтобы молча их проглатывать.
• Все выдачи атомарны, логируются в аудит с 8-символьными id транзакций и устойчивы к офлайн-игрокам — выплаты за общие цели и награды Stars попадают в очередь pendingRewards и выдаются при следующем входе с баннером в чате ★ You have rewards waiting! ★.

Интеграции

• Impactor — валюта PokéDollar + Stars, мягкая зависимость.
• PokeHunts — подключается автоматически, если загружен; тип квеста COMPLETE_POKEHUNT.
• Raids — подключается автоматически, если загружен; тип квеста COMPLETE_RAID.
• LuckPerms — опционально, используется для поиска узлов прав; аккуратно откатывается к op-уровню с однократным WARN, если провайдер не сработал.
• Pebble's Crates / ExcellentCrates / CMI — любой плагин ящиков работает через карту переопределений по ключам.
• Публичный API — любой мод может вызвать ExternalEventApi, чтобы передавать прогресс квестов без зависимости по classpath.

Безопасность и надёжность

• Права перепроверяются при каждом действии — понижения посреди сессии работают. У каждого админского GUI есть внутренний guard requiresAdmin() на каждом open() и клике.
• Bypass-права теперь только явные И управляются конфигом. cobblemonquests.bypass.reroll-cost и cobblemonquests.bypass.rate-limit срабатывают только когда соответствующий флаг permissions.bypass.* в config.conf установлен в true. Выдать один только узел LP больше недостаточно — так что забытое наследование по wildcard не сможет молча отключить новые лимиты рероллов.
• Лимиты частоты на игрока для рероллов и админских команд.
• Аудит-лог в logs/cobblemonquests-audit.log записывает каждое назначение квеста, завершение, выдачу награды, реролл, админское действие, обнаружение скрытого, пересечение вехи, изменение общей цели, перезагрузку конфига и админскую тестовую команду с 8-символьным base36 id транзакции.
• Снимок при назначении — определения квестов снимаются снимком в момент назначения, так что правки конфига никогда не меняют выплату задним числом.
• Анти-эксплойт дедупликация для целей «посети N биомов / измерений» — считаются только уникальные id биомов / измерений. Фарм туда-сюда мёртв.
• SafeDispatch — единственный канонический путь для каждой консольной команды, которую запускает мод (награды, stars, ключи от ящиков). Считает результат < 1 жёстким провалом с WARN, содержащим итоговую строку команды. Guard-ы повторного входа предотвращают бесконечные циклы, если шаблон награды случайно вызовет мод обратно.

Однострочное описание

Преврати свой сервер Cobblemon в место, куда игроки заходят ради завтрашнего дня, а не только сегодняшнего.

Установка

1. Закинь cobblemonquests-1.8.0.jar в mods/ рядом с Cobblemon и (по желанию) Impactor.
2. Запусти сервер. При первом запуске создаются конфиг по умолчанию, примеры квестов (9 ежедневных, 7 еженедельных, 1 элитный, 1 скрытый, 3 повторяемых), стартовая цепочка и 2 шаблона серверных квестов.
3. ОПы могут выполнить /quests, чтобы открыть хаб игрока, и /quests admin для админ-панели.
4. Используй внутриигровые мастера для создания квестов, цепочек и серверных квестов — или редактируй файлы в config/cobblemonquests/ вручную.
5. Используй внутриигровой редактор конфига для настройки лимитов рероллов, весов пулов и переключателей — или редактируй config.conf и выполни /quests admin reload.

Команды

/quests                     Открыть хаб квестов
/quests stats               Открыть страницу статистики
/quests leaderboard         Открыть таблицу лидеров
/quests reroll <slot>       Реролл квеста (действует лимит на ротацию)
/quests admin               Открыть админ-панель
/quests admin reload        Перезагрузить конфиг + квесты
/quests admin give <p> <q>  Выдать квест игроку
/quests admin complete <p> <q>  Принудительно завершить квест
/quests admin reset <p>     Сбросить ежедневные квесты игрока
/quests admin resetweek <p> Сбросить еженедельные квесты игрока
/quests admin goal set <id> Активировать серверный квест
/quests admin goal stop     Остановить активный серверный квест
/quests admin goal reset    Сбросить прогресс серверного квеста
/quests admin goal progress <n>  Задать прогресс вручную
/quests admin debug events  Панель активности трекера
/quests admin debug stars <p>    Показать баланс Stars + всего за всё время
/quests admin testkey <p> <key> [n]   Протестировать шаблон ключа от кейса вживую
/quests admin testcommand <p> <cmd...>  Протестировать любой шаблон команды

/cq — короткий алиас для /quests.

Совместимость

• Minecraft 1.21.1 / Fabric
• Жёсткие зависимости: Cobblemon 1.7.3+, Fabric API, Java 21
• Мягкие зависимости: Impactor (валюта PokéDollar + Stars), LuckPerms (перм-ноды + префикс), PokeHunts (авто-хук), Raids (авто-хук), любой плагин кейсов (Pebble's, ExcellentCrates, CMI и т.д. — настраивается для каждого ключа)
• Мирно сосуществует с PokeBuilder и StaffChat (оба тоже от souljagger).

Планы

• Групповые / многопользовательские квесты — выйдут вместе с обновлением системы групп
• Взаимодействие с NPC — ПКМ по Cobblemon NPC открывает /quests
• Магазин квестов — трать Stars на эксклюзивные предметы
• Сезонные / ивентовые квесты — пулы квестов с ограничением по времени
• UI цепочек для игроков — бэкенд цепочек + создание для админов уже вышли; просмотр для игроков вернётся вместе с обновлением групп

Лицензия

MIT — форкай, изменяй, распространяй.