OriginsX - 技能树

🌳 OriginsX - 技能树

逐节点解锁你种族的真正潜力。

⚠️ 需要 Race API、OriginsX 和 LDLib2 ⚠️

📖 概述

技能树 为你的种族增加了一个完全由数据包驱动的进度层。你的种族所赋予的每一个能力现在都可以被一个可解锁的节点所限制：未解锁的能力将完全无法发挥作用，直到你投入技能碎片进行解锁，并且每个升级阶段都会使其变得更强——在第三阶段达到其完整、预期的强度。

技能树按种族在纯 JSON 文件中定义，并支持节点之间的前置条件、自定义消耗、图标以及自由形式的画布定位。最重要的是，有一个内置的可视化编辑器，让你无需接触文本编辑器即可为自己种族设计技能树！

✨ 特性

• 每种族技能树： 每个种族都可以拥有自己独特的进度树。（未指定节点的能力将继续正常工作）。
• 三个升级阶段： 第一阶段 = 34% 强度，第二阶段 = 67%，第三阶段 = 100% 完整强度。
• 技能碎片货币： 一种全新的可合成物品，专门用于解锁和升级节点。
• 节点前置条件： 将节点串联起来！只有当父节点达到第三阶段时，子节点才会解锁。
• 智能能力缩放： 伤害、持续时间、半径、冷却时间等都会进行数值缩放。能力的结构部分永远不会被改动，这意味着第三方能力会优雅地降级而不是崩溃。
• 可视化技能树编辑器： 在自由形式的画布上拖放节点，右键点击以添加/关联/删除，直接从下拉列表中选择能力，并直接导出为数据包（在单人游戏中）。
• 实时详情面板： 显示当前与下一阶段的效果（例如，“当前：+2 最大生命值 → 下一级：+4 最大生命值”）、升级消耗和可负担状态。
• 服务端同步进度： 你的进度安全地存储在服务端，重新登录后依然保留，并完全支持多人游戏。
• 本地化准备就绪： 支持英语、俄语和乌克兰语。

⚙️ 工作原理

1. 按下 K 键（可配置）打开技能树界面。
2. 选择任意节点以查看其名称、描述、当前生效效果和升级消耗。
3. 点击 碎片按钮 购买下一阶段。碎片会自动从你的物品栏中扣除。
4. 更改会立即生效！该能力的游戏逻辑钩子将立即以新的强度级别运行。

阶段	能力强度
🔒 锁定	0% — 该能力被完全禁用。
🥉 第一阶段	34%
🥈 第二阶段	67%
🥇 第三阶段	100% — 解锁完整原始能力。

💎 技能碎片

所有升级的主要货币。你可以使用金粒围绕一个紫水晶碎片进行合成：

配方： 8× 金粒 + 1× 紫水晶碎片 → 1× 技能碎片

注意：你当前的碎片数量会始终显示在技能树界面的顶部。

🛠️ 整合包与数据包作者指南

你可以通过在 data/<命名空间>/skilltree/ 目录下放置一个简单的 JSON 文件，为任何种族添加技能树：

{
  "race": "yournamespace:yourrace",
  "title": "tree.yournamespace.yourrace",
  "nodes": [
    {
      "id": "example_node",
      "index": 0,
      "power": {
        "type": "attribute",
        "operation": "add_value",
        "attribute": "minecraft:generic.max_health",
        "amount": 4
      },
      "icon": "minecraft:apple",
      "x": 120,
      "y": 80,
      "requires": [],
      "cost": [2, 3, 5]
    }
  ]
}

JSON 属性：

• race — 此技能树属于哪个种族（为某个种族注册的第一个技能树具有优先权）。
• index — 被限制的能力在种族 powers 数组中的位置。
• power — 完整的内联能力定义（使用与 Race API 完全相同的模式）。这用于自动生成强度较弱的阶段副本。
• icon — 显示在可视化节点上的物品 ID。
• x / y — 在编辑器画布上的精确像素坐标。
• requires — 一个节点 ID 数组，这些节点必须达到第三阶段才能解锁此节点。
• cost — 分别对应第一、第二和第三阶段的碎片价格。

或者完全跳过 JSON！

只需在单人游戏世界中打开游戏内的技能树，使用拖放编辑器进行可视化构建，然后按下 保存。文件将自动直接写入你世界的数据包文件夹中。

📥 依赖要求

• Minecraft： 26.2 并搭配 NeoForge
• Race API： 必需（核心库）
• LDLib2： 必需（GUI 框架）
• OriginsX： 必需（该模组在技术上或许可以在没有它的情况下启动，但将完全无用。OriginsX 提供了实际的种族，并将技能树编辑器直接集成到种族创建器中）。

🪙 支持开发

我利用空闲时间构建这个模组，因为我喜欢给予玩家创造精彩事物的自由。如果你想帮助我保持持续更新，并在现实生活中给我扔几个“技能碎片”，我会非常高兴！

捐赠完全是可选的。最重要的是你享受这个模组。但如果你确实想打赏，那将是巨大的动力提升！🛠️

在 Ko-fi 上打个赏