RPGCore

Что представляет собой RPGCore?

RPGCore — это специализированный API, предоставляющий разработчикам готовую систему реализации навыков для Minecraft. Основное предназначение мода — упростить создание новых умений, которые можно интегрировать в существующие модификации для добавления элементов прогрессии или разрабатывать совершенно новые проекты с RPG-механиками.

Принцип работы системы

Концепция RPGCore вдохновлена системой навыков из аниме Sword Art Online. Игроки получают доступ к интерфейсу умений через клавишу F4 (настраивается в управлении), где могут экипировать навыки, настраивать расположение элементов экрана и управлять группами (гильдии, фракции, отряды).

Максимальное количество одновременно активных навыков — 12, но при полной экипировке броней доступно только 8 слотов. Некоторые ячейки блокируются до достижения определенного Глобального Уровня. Опыт начисляется только за экипированные умения.

Экран экипировки навыков — открывается по F4

Система Глобального Уровня

Глобальный Уровень отражает общий прогресс игрока и виден другим участникам. За каждые 10 единиц опыта в любом навыке вы получаете 1 XP к Глобальному Уровню. Некоторые умения требуют достижения определенного GL для разблокировки. Глобальный Уровень не занимает слоты и всегда активен.

Прокачка навыков

Для получения опыта навык должен быть экипирован. Механики прокачки определяются разработчиками конкретных умений. В базовой версии мода присутствуют только примеры, но в дополнении Flenix's Skills уже реализован навык Акробатики, который прокачивается при падении с высоты более 3 блоков без получения урона.

Особые случаи: Сила и Ловкость — навыки без опыта. Их уровень повышается за счет очков навыков, которые выдаются по 3 штуки за каждый Глобальный Уровень. Распределение очков осуществляется через кнопку "Настройки игрока" в основном меню навыков.

Экран выбора навыков. Нажмите на слот, чтобы назначить умение Примечание: кнопка "Конфигурация игрока" здесь пока не работает — используйте соответствующую опцию в основном меню

Для разработчиков

API максимально упрощает создание новых навыков. Мод ExampleSkills демонстрирует процесс реализации двух умений с подробной документацией.

Для начала работы скачайте deobfuscated версию мода, поместите в папку /libs вашего проекта разработки и добавьте в build path как внешний .jar файл. Рекомендуется также использовать javadocs для удобства разработки.

Основные шаги: расширьте SkillLevelBase, реализуйте IExtendedEntityProperties и добавьте необходимые методы согласно примерам. API может изменяться для поддержания совместимости с MCSAO, поэтому рекомендуется указывать конкретные диапазоны версий.

Для интеграции с существующими модами используйте мягкую зависимость через Loader.isModLoaded, что сделает систему навыков опциональной для пользователей.

Важные особенности

• Данные опыта сохраняются в NBT игрока (файл player.dat). Удаление этого файла приведет к потере всего прогресса
• Команда /rpgcore addxp skillId amount позволяет добавлять/убирать XP
• Все XP-бары полностью настраиваются: положение, размер, текст, отображение иконок
• Для полного отображения интерфейса навыков требуется разрешение экрана не менее 256x450 пикселей
• Инвентарь игрока в текущей версии имеет ограниченную функциональность — исправления планируются в будущих обновлениях

Сообщайте о найденных ошибках для улучшения мода!