Fretux的技能引擎

Fretux的技能引擎

用于制作技能树的框架

基础库

Skill Engine

Skill Engine 不是一个独立的进度模组。 它本身不添加玩法、属性或能力。

相反,Skill Engine 是一个框架,旨在让其他模组创建自己的高度可定制的技能树,并包含以下功能:

  • 节点解锁
  • 属性需求
  • 自定义图标
  • 技能点处理
  • 服务器同步
  • 需求与工具提示
  • 与其他进度系统(如 Ascend)交互

如果你在寻找一个添加技能的模组,那不是这个。


特性

JSON 驱动的技能树系统

模组只需在以下路径添加 JSON 文件即可注册自己的技能节点:

data/<yourmodid>/skillnodes/*.json

自动节点渲染

节点会在技能树 GUI 中自动定位、显示、缩放、平移和绘制。

图标支持

使用你自己的纹理或原版物品纹理作为节点图标。

需求系统

节点可以指定:

  • 关联节点
  • 前置属性
  • 技能消耗
  • 自定义标签

UI 会自动在工具提示和覆盖层中显示需求。

解锁逻辑与同步

解锁完全在服务器端处理,并同步到客户端。

完整 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
  • 你想安装创建技能树的附加模组