Fretux's Skill Engine

Skill Engine

Skill Engine — это не самостоятельный мод на прогрессию.
Он не добавляет геймплей, атрибуты или способности сам по себе.

Вместо этого Skill Engine — это фреймворк, созданный для того, чтобы другие моды могли создавать свои максимально настраиваемые деревья навыков, включая:

• Разблокировку узлов
• Требования к атрибутам
• Кастомные иконки
• Обработку очков навыков
• Синхронизацию с сервером
• Требования и подсказки
• Взаимодействие с другими системами прогрессии (например, Ascend)

Если вы ищете мод, который добавляет навыки, — это не он.

Возможности

Система деревьев навыков на основе JSON

Моды могут регистрировать свои узлы навыков, просто добавляя JSON-файлы в:

data/<yourmodid>/skillnodes/*.json

Автоматический рендеринг узлов

Узлы автоматически размещаются, отображаются, масштабируются, перемещаются и отрисовываются в интерфейсе дерева навыков.

Поддержка иконок

Используйте свои текстуры или текстуры предметов из ваниллы в качестве иконок узлов.

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

Узлы могут указывать:

• Связанные узлы
• Необходимые атрибуты
• Стоимость навыка
• Кастомные теги

Интерфейс автоматически отображает требования в подсказках и оверлеях.

Логика разблокировки и синхронизация

Разблокировка полностью обрабатывается на стороне сервера и синхронизируется с клиентом.

Полная поддержка API

Skill Engine включает публичный API-класс, который позволяет другим модам:

• Выдавать очки навыков
• Разблокировать узлы навыков
• Проверять состояние разблокировки
• Получать доступ к данным навыков игрока
• Регистрировать узлы или ссылаться на них

Как использовать Skill Engine в своём моде

Skill Engine создан для максимально простой интеграции.

1. Добавьте Skill Engine как зависимость

В вашем mods.toml:

[[dependencies.yourmodid]]
    modId="skillengine"
    type="required"
    versionRange="[1.0.0,)"

В вашей сборке Gradle:

implementation fg.deobf("net.fretux.skillengine:SkillEngine:<version>")

2. Создайте свои узлы навыков (JSON)

Пример:

{
  "title": "Basic Strength",
  "description": "You feel your muscles tighten.",
  "cost": 1,
  "position": { "x": -150.0, "y": -50.0 },
  "links": ["skillengine:welcome"],
  "tags": ["yourmodid:strength_1"],
  "icons": "minecraft:textures/item/iron_sword.png",
  "prerequisites": {
    "strength": 10,
    "agility": 5
  }
}

Поместите это в:

data/yourmodid/skillnodes/basic_strength.json

Skill Engine автоматически обнаружит его и добавит в дерево.

3. Используйте API в своём коде

Skill Engine предоставляет простой API:

SkillEngineAPI.unlockNode(player, SkillEngineAPI.rl("yourmodid", "basic_strength"));
SkillEngineAPI.addSkillPoints(player, 3);
boolean unlocked = SkillEngineAPI.isUnlocked(player, SkillEngineAPI.id("welcome"));

Вы можете взаимодействовать с системой, не трогая внутренние классы.

Skill Engine сам по себе ничего не делает.
Он не добавляет дерево навыков или способности самостоятельно.

Этот мод нужен вам только если:

• Мод, в который вы играете, зависит от Skill Engine
• Вы хотите установить аддоны, создающие деревья навыков