PathForge

Pathforge 是一个受《流放之路》启发的 Hytale RPG 进度插件。升级、花费属性点和被动点、分配完整的技能树、通过稀有度和词缀强化装备、分解装备，并通过 /pathforge 在一个中心界面管理所有内容。

=== 必需依赖 ===

服务器必须安装以下模组，Pathforge 才能正常工作：

• HyUI https://www.curseforge.com/hytale/mods/hyui
• MultipleHUD https://www.curseforge.com/hytale/mods/multiplehud

=== 可选整合 ===

• PartyPro（队伍经验分享 + 队伍 HUD 等级）https://www.curseforge.com/hytale/mods/partypro 软依赖：没有它 Pathforge 也能运行。当存在 PartyPro 时，击杀经验会分享给附近的队伍成员。队长可以在 /pathforge → 设置中选择分享模式（击杀者保留全部经验 vs 平均分配）。启用后，击杀获得的烬印（Embermarks）也可以与队伍分享。

=== 推荐 / 兼容的终局模组 ===

Pathforge 旨在与这些专注于终局的模组无缝兼容（可选，但建议安装以获得完整的后期游戏体验）：

• Endgame & QoL https://www.curseforge.com/hytale/mods/endgame-qol

=== 工作原理 ===

使用 /pathforge 打开中心界面。在这里，你可以查看等级和经验、花费属性点、在技能树上分配被动点、解锁和绑定主动技能、从背包中选择和制作装备、分解强化物品、浏览玩家拍卖市场、管理你的烬印银行、追踪赏金和主世界裂缝、领取里程碑奖励，以及调整设置（包括技能施放键和队伍经验分享）。

进度来自战斗和世界活动：击败敌人和破坏方块可获得经验（并且通常击杀会掉落烬印）。升级会奖励属性点和被动点。武器熟练度可获得特定家族（family-specific）的主动技能树点数。符合条件的武器和护甲可以随机获得稀有度和词缀（存储在 Pathforge 自己的 pf.* 物品元数据下）。制作宝石可以让你在选定的背包物品上添加、移除、升级或打磨词缀。强化过的装备可以被分解成材料。玩家经济（市场 + 银行）将在以下部分详细说明。

=== 市场（拍卖行） ===

打开 /pathforge → 市场。你的烬印钱包显示在顶部（总额 / 可用 / 锁定，以及销售税 %）。

• 浏览 — 活跃的玩家上架物品。按类别（武器、护甲、工具、材料、消耗品、其他或 Pathforge 装备）筛选，并按即将结束 / 价格排序。对其他玩家的物品出价或直接购买。
• 创建 — 从你的背包中选择一组物品（快捷栏、袋子、背包、护甲、工具、实用物品 — 烬印代币不能上架）。设置起拍价、可选的一口价（0 = 仅拍卖；一口价必须 ≥ 起拍价）和持续时间（1–24 小时选项）。如已配置，会从可用烬印中收取上架费。上架时，该组物品会从你的背包中托管（防复制）。
• 列表（转移列表） — 你的活跃和已过期/未售出的上架物品。只有在没有出价的情况下才能取消活跃上架（物品退回；上架费不予退还）。领取已过期未售出的物品。如果销售结算时你的背包已满，请领取待处理的交付物品。
• 目标 — 当前你是最高出价者的上架物品（在此处提高你的出价）。
• 历史 — 你最近的买卖账本（价格和税后卖方净收入）。

出价会锁定你钱包中的烬印，直到你被超价、获胜或拍卖结束。一口价会立即花费可用烬印，在纳税后支付给卖家，并交付物品（或排队等待领取）。当限时拍卖在出价状态下结束时，最高出价将被扣除，应用税费，物品将归赢家所有。没有出价的过期拍卖则等待卖家领取。

Pathforge 装备在上架和交付过程中会保留其 pf.* 稀有度和词缀。

=== 银行与烬印 ===

烬印是 Pathforge 的服务器货币。你的大部分余额存放在一个安全的钱包中（死亡不会丢失）。战斗可以将烬印掉入钱包（按怪物等级可配置掉落几率和数量；可选的 PartyPro 队伍分享）。同时也存在实体物品 Pathforge_Embermark，用于在游戏世界中携带/交易（死亡时掉落）。

打开 /pathforge → 银行：

• 余额 — 总额、可用和锁定额度（被活跃市场出价保留的烬印在解锁前不能转移或提取）。
• IBAN — 每个玩家都有一个唯一的 IBAN（显示为 XXX-XXX-XXX）。分享它，以便其他人可以向你发送烬印。
• 转账 — 输入另一个玩家的 IBAN 和金额，验证，然后确认。发送方支付金额 + 转账费；接收方收到全额。
• 存入 — 将持有的 Pathforge_Embermark 物品堆（或全部存入）转换为钱包烬印。
• 提取 — 将可用的钱包烬印转换为实体物品堆（每次操作有上限；需要背包空间）。
• 最近转账 — 你最近的银行发送/接收的简短账本。

管理员可以使用 /pathforgeadmin coins、coins set <玩家> <数量> 和 coins add <玩家> <数量> 检查或更改余额。经济旋钮（税、上架费、持续时间、击杀掉落、转账费、提取上限）位于 market.json 中。

主动技能从主动技能树解锁，绑定到 3 个技能槽，并通过 Hytale 技能 1/2/3（或闪避）施放。可在 Hytale 选项 → 控制中重新映射物理按键；Pathforge 设置可以标记和切换这些动作。

屏幕上的 HUD 显示你的经验条、技能快捷栏和带有稀有度颜色的物品提示框（由 HyUI + MultipleHUD 提供支持）。

=== 功能 ===

• 单一中心命令：/pathforge
• 中心选项卡：概览、属性、被动技能树、主动技能树、装备、分解、赏金、市场、银行、奖励、设置
• 通过击杀 / 方块经验升级，获得属性点和被动点
• 数据驱动的被动技能树（核心 / 进攻 / 防御 / 实用），支持分配和退还
• 基于武器熟练度家族的主动技能树（约 60 个技能，3 个绑定槽，技能 HUD）
• 可重新映射的施放动作（技能 1/2/3 / 闪避）+ 设置中的按键标签捕获
• 武器熟练度式的进度和武器感知被动技能
• 符合条件的武器和护甲随机获得稀有度 + 词缀（提示框和中心使用相同的稀有度颜色）
• 用于装备制作和分解的背包选择器（选择袋子/槽位 — 无需手持物品）
• 用于塑造装备的制作宝珠/宝石（添加、移除、升级、品质）
• 将强化装备分解为材料
• 玩家市场 / 拍卖行（从背包上架、出价、一口价、转移列表、领取、历史）
• 烬印货币 + 银行（余额、IBAN 转账、存入/提取实体物品）
• 击杀烬印掉落（可配置；可选的 PartyPro 队伍分享）
• 每日赏金 + 定时主世界裂缝
• 里程碑等级奖励
• 快捷栏物品提示框 HUD + 经验 HUD + 技能 HUD
• 可选的 PartyPro 击杀经验分享（队长可在设置中调整模式）
• 软性的 Endgame & QoL 实例缩放 / 兼容性
• 完美格挡战斗模块（耐力/时机）
• 通过 /pathforgeadmin 提供管理员辅助功能
• 完全可配置的 JSON（升级、属性、技能树、稀有度、材料、分解、奖励、赏金、裂缝、市场、partypro、格挡、消息）

=== 命令 ===

• /pathforge — 打开 Pathforge 中心
• /pathforgeadmin reload — 配置重载通知
• /pathforgeadmin setlevel <等级> — 设置你的 Pathforge 等级
• /pathforgeadmin attr <数量> — 设置未使用的属性点
• /pathforgeadmin passive <数量> — 设置未使用的被动点
• /pathforgeadmin giveorbs <数量> — 给予制作宝珠
• /pathforgeadmin coins set <玩家> <数量> — 设置烬印余额
• /pathforgeadmin coins add <玩家> <数量> — 增加（或移除）烬印
• /pathforgeadmin bounty refresh — 刷新每日赏金
• /pathforgeadmin rift <force|close|status> — 管理主世界裂缝

=== 注意事项 ===

• 服务器模组 — 在你的 Hytale 服务器上安装 Pathforge 及必需依赖。
• PartyPro 和 Endgame & QoL 是可选的；仅在你需要这些整合时安装它们。
• 物品元数据使用 pf.* 命名空间以避免与其他装备模组冲突。
• 主动技能施放键是 Hytale 技能/闪避动作 — 可在客户端选项 → 控制中重新映射物理按键。
• 市场上架会托管选定的背包物品堆（防复制）；必要时，领取/索回会将物品返回到待处理领取中。
• 默认提供英文消息；首次启动后，所有游戏配置都可以在插件数据文件夹中自定义。