Radical Cobblemon Trainers API

Radical Cobblemon Trainers API (в проектах и конфигах встречается как rctapi) - это библиотека для Майнкрафт, которая решает одну конкретную, но очень важную проблему: в Cobblemon из коробки нет нормальной инфраструктуры для боёв с тренерами. Покемоны есть, мир есть, а вот чтобы другие моды могли создавать NPC-тренеров, назначать им команды и устраивать полноценные сражения по правилам - для этого нужен отдельный фундамент. Именно его и даёт этот API.

Если вы просто игрок и ставите, например, Radical Cobblemon Trainers - этот мод вам тоже нужен, потому что большая сборка без него попросту не запустится. А если вы разработчик, который делает свой контент для Cobblemon, то получаете готовую систему вместо того, чтобы писать логику боёв с нуля.

Зачем вообще нужен этот мод

Изначально библиотека писалась как основа для мода Radical Cobblemon Trainers и как замена зависимости CobblemonTrainers, поддержка которой прекратилась после выхода Minecraft 1.21 и Cobblemon 1.6. Старая зависимость умерла, а контент на ней жить перестал - вот автор и сделал собственное решение.

Правда, важный нюанс: это не приватный код под один проект. API спроектирован как независимая библиотека, и любой мододел может подключить её и использовать тот же набор функций. По сути, это общий стандарт для тренерских боёв в экосистеме Cobblemon. Популярность говорит сама за себя - у проекта уже около 7,7 миллиона загрузок, что для библиотеки очень серьёзный показатель.

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

• Управление тренерами и привязка к сущностям - встроенный реестр тренеров, который связывает данные тренера с конкретным мобом в мире.
• Разные форматы боёв - одиночные бои 1v1 (SINGLE), двойные 1v1 (DOUBLE), мульти-бои 2v2 (MULTI) и другие вариации.
• Собственные правила боя - например, можно ограничить количество использований предметов за один бой. Удобно, если вы делаете честные гим-битвы, а не "у тренера бесконечные фуллресторы".
• Расширенный боевой ИИ (пока поддерживается через RCTBattleAI):
  • стандартные боевые действия - выбор атаки, смена покемона и тому подобное;
  • боевые механики (gimmicks): Mega Evolution, Dynamax, Z-Moves, Terastallize и другие. Учтите, что большинство гиммиков, активируемых через носимые предметы, требуют отдельного мода, который эти предметы добавляет. Классический пример - Mega Showdown, который к тому же обязателен для динамакса и гигантамакса;
  • тренеры могут носить и использовать предметы в бою.
• Модели данных тренеров и покемонов (pojos) для удобного парсинга:
  • конвертеры в типы Cobblemon;
  • валидация моделей - все ошибки собираются сразу, прежде чем выбрасывается исключение. Для разработчика это куча сэкономленных нервов при отладке.

В репозитории проекта лежит рабочий пример использования - с него и стоит начинать, если собираетесь интегрировать API в свой мод.

Совместимость и требования

Актуальная версия библиотеки - 0.16.1-beta, рассчитана на Minecraft Java 1.21.1 и работает на загрузчиках Fabric и NeoForge. Для запуска потребуются:

• Cobblemon не ниже версии 1.8 (планку подняли в релизе 0.16.0-beta);
• Architectury API;
• сам Radical Cobblemon Trainers API.

В свежей версии 0.16.1-beta разработчики добавили статические помощники GsonUtil - теперь можно быстро создавать заранее настроенные экземпляры GSON, что упрощает работу с конфигами и данными тренеров.

Кому это нужно на практике

Сам по себе API ничего зрелищного в игру не добавляет - это библиотека, а не контентный мод. Зато на нём строится Radical Cobblemon Trainers, который приносит в игру более 1500 тренеров, сюжетную прогрессию и испытания в духе ROM-хака Radical Red и Pokémon Unbound. То есть если вы гоняете по миру с покемонами и встречаете тренеров, которые реально умеют мега-эволюционировать своих питомцев и тактически менять состав - за кулисами работает именно этот API.

Совет: если собираете сервер с Cobblemon для игры с друзьями, проверяйте версии Cobblemon и Architectury до запуска - большинство крашей в таких сборках связано именно с несовпадением версий библиотек, а не с самими модами. А чтобы не возиться с ручной настройкой, можно запустить сервер на BungeeHost (https://bungee.host) - модпак с Cobblemon ставится там в пару кликов, и арендовать сервер Майнкрафт выходит быстрее, чем разбираться с локальным хостингом.

Скачайте Radical Cobblemon Trainers API, если в вашей сборке есть моды на тренеров - без этой библиотеки они просто не заработают, а с ней получите полноценные бои по правилам настоящих покемонов.