Cobblemon Battle Pass - CobblePass [1.21.1]

CobblePass — Продвинутая система Battle Pass для Cobblemon

Представляем полностью обновлённый CobblePass! Этот мод предоставляет глубоко интегрированную и настраиваемую систему боевого пропуска для вашего сервера Cobblemon. Вовлекайте игроков с помощью прогрессивной системы наград, включающей бесплатные и премиум-уровни, сезонный контент и разнообразные настраиваемые вознаграждения.

Функции

• Сезоны: Создавайте уникальные сезоны боевого пропуска с настраиваемой длительностью и наградами.
• Двойные треки наград: Реализация уровней free (бесплатных) и premium (премиум).
• Динамический GUI: Удобный интерфейс с пагинацией (/bp) для просмотра прогресса и получения наград.
• Прогрессия XP:
  • Получение XP за действия: поимку, победы, эволюцию, вылупление и обмен покемонов.
  • Две модели прогрессии:
    • FORMULA: Необходимый XP увеличивается на основе настраиваемого множителя.
    • MANUAL: Ручное определение XP для каждого уровня.
• Разнообразные типы наград:
  • ITEM: Выдача предметов Minecraft/модов с поддержкой NBT.
  • POKEMON: Награждение покемонами с указанием уровня, блеска и атрибутов.
  • COMMAND: Выполнение серверных команд с плейсхолдерами %player% и %uuid%.
• Управление администратора:
  • Команды для управления сезонами, игроками и конфигурациями.
  • Создание, запуск, остановка и удаление сезонов.
  • Изменение XP, уровней и премиум-статуса игроков.
  • Перезагрузка конфигураций без перезапуска сервера.
• Интеграция с экономикой: Платная премиум-версия через Impactor-совместимые плагины.
• Гибкая настройка: Настройка XP, наград и параметров сезонов через JSON-файлы.
• Целостность данных: Надёжное сохранение прогресса игроков.

Зависимости

Требуемые моды для сервера:

• Fabric API
• Cobblemon (v1.6+)
• Impactor (для экономики)
• GooeyLibs

Установка

1. Требуется Fabric-сервер Minecraft 1.21.1+.
2. Скачайте последние версии CobblePass и зависимостей.
3. Поместите файлы .jar в папку mods сервера.
4. Запустите сервер. Конфигурационные файлы появятся в config/cobblepass/.

Создание первого сезона

Шаг 1: Создание боевого пропуска

• Выполните команду оператора: /battlepass create
• В GUI укажите:
  • Длительность: Продолжительность сезона в днях.
  • Макс. уровень: Предельный уровень для игроков.
  • Премиум-режим: Активация премиум-трека.
• Нажмите "Create Battle Pass" для генерации config.json и tiers.json.

Шаг 2: Настройка наград

• Откройте config/cobblepass/tiers.json.
• Замените примеры наград (яблоки) своими значениями для freeReward и premiumReward.

Шаг 3: Настройка параметров

• Откройте config/cobblepass/config.json.
• Настройте значения XP (catchXP, defeatXP), стоимость премиума (premiumCost) и модель прогрессии (xpProgression).

Шаг 4: Перезагрузка конфигурации

• Выполните: /battlepass reload после сохранения изменений.

Шаг 5: Запуск сезона

• Запустите сезон командой: /battlepass season start

Команды

Основная команда: /battlepass (алиасы /bp, /pass).

Команды игроков

Команды администраторов (Уровень доступа 4)

Конфигурационные файлы

Расположены в config/cobblepass/.

config.json

{
  "catchXP": 50,
  "defeatXP": 25,
  "evolveXP": 100,
  "hatchXP": 75,
  "tradeXP": 50,
  "premiumCost": 1000,
  "seasonDurationDays": 30,
  "currentSeason": 1,
  "seasonStartTime": 1729898400000,
  "seasonEndTime": 1732490400000,
  "enablePermissionNodes": true,
  "premiumMode": true,
  "xpProgression": {
    "mode": "FORMULA",
    "xpPerLevel": 1000,
    "xpMultiplier": 1.05,
    "manualXpValues": {}
  }
}

Параметры:

• XP-значения (catchXP, defeatXP и др.): Количество XP за действия.
• premiumCost: Стоимость премиум-пропуска.
• seasonDurationDays: Длительность сезона (в днях).
• enablePermissionNodes: Использование плагинов прав доступа.
• premiumMode: Активация премиум-трека.
• xpProgression:
  • mode: "FORMULA" (база XP + множитель) или "MANUAL" (ручные значения).
  • manualXpValues: Указание XP для уровней (например: "2": 500).

tiers.json

{
  "templates": {
    "rare_candy_stack": {
      "type": "ITEM",
      "data": { "id": "cobblemon:rare_candy", "Count": 5 }
    }
  },
  "tiers": [
    {
      "level": 1,
      "freeReward": {
        "type": "ITEM",
        "data": { "id": "cobblemon:poke_ball", "Count": 10 }
      }
    },
    {
      "level": 5,
      "freeReward": { "$template": "rare_candy_stack" },
      "premiumReward": {
        "type": "POKEMON",
        "data": { "species": "eevee", "level": 5, "shiny": true }
      }
    }
  ]
}

• templates: Шаблоны для повторяющихся наград (вызов через "$template").
• tiers: Список уровней с наградами freeReward/premiumReward.
• Типы наград:
  • ITEM: id предмета и Count (с поддержкой NBT).
  • POKEMON: species (обязательно), level, shiny и другие атрибуты.
  • COMMAND: Исполнение команды с плейсхолдерами %player%/%uuid%.

Данные игроков

Хранятся в config/cobblepass/players/<uuid>.json. Ручное редактирование не рекомендуется.

{
  "version": "1.0",
  "level": 5,
  "xp": 250,
  "isPremium": true,
  "claimedFreeRewards": [1,2,3,4,5],
  "claimedPremiumRewards": [5]
}