RPG 等级与属性/技能

RPG Leveling — Hytale 的等级、职业与成长系统

将 Hytale 变成真正的 RPG。 经验值与等级、怪物缩放、区域、难度预设、深度属性成长——外加 6 种职业、18 个自定义被动技能，以及 完全可自定义 的职业系统，可匹配任何主题：奇幻、星球大战，或是你自己的角色扮演服务器。

⚠️ Hytale 更新 5 将带来破坏性 API 变更。 低于 0.3.6 版本的 RPG Leveling 不兼容该版本——你的游戏可能崩溃。请升级至 0.3.6-pre.9.1（当前针对 Hytale 0.5.0-pre.9.1 的预发布版本），或等待稳定版 0.3.6 在更新 5 发布时推出。模组开发者注意：更新 5 带来了大量服务端 API 变更——在切换版本前务必备份你的 mods/ 文件夹和世界存档。

🆕 0.3.6 — 按等级区间的经验倍数获取，通过新的 XPCurveOverridesConfig.json 实现（例如在 50-79 级区间获得双倍经验）。基于 Hytale 0.5.0-pre.9.1（预发布版）构建，等级 HUD 迁移至 Hytale 原生 HudManager（随机踢出 / HUD 图层碰撞错误现已彻底修复；不再需要 MultipleHUD）。满级 HUD 和属性 GUI 现在显示 累计获得的经验值总量，使排行榜在满级后按玩家实际刷取量排序。针对 100+ 玩家 服务器优化了每 tick 检测开销。

📖 完整文档 — 职业与被动技能、配置、命令、副本/地牢设置、API、翻译。请优先查阅文档。

服务器已部署新版模组 (0.3.6)。

---

🤝 合作服务器

公开合作 Hytale 服务器运行 RPG Leveling — 在安装到自己的服务器之前，先在真实社区中体验该模组。

IP: play.hylterium.fr

---

⚔️ 职业与完全自定义

• 6 种职业（默认职业组） — 重装、钝器、利刃、尖牙、弓箭、秘法。每种职业拥有独特武器、每阶固有属性加成，以及在造成/受到伤害或击杀时触发的被动技能。
• 18 个自定义被动技能 — 高阶守护、厚皮、过量击杀、冲击、背水一战、决斗专注、反击、生命偷取、背刺等。可为每个职业添加、移除或替换被动技能；可在 JSON 中调整每个数值和百分比。
• 完全可自定义的职业 — 职业是 模板。覆盖任意职业文件：更改名称、图标、武器、被动技能和阶层加成。无需代码——编辑 JSON 即可。非常适合角色扮演服务器（中世纪、星球大战、赛博朋克等）。
• 模组武器支持 — 在 ClassesGlobalConfig.json 中注册来自其他模组的武器（例如光剑、等离子步枪）。为某个职业提供该类武器的伤害加成，并在 MessagesLanguageMapping 中重命名职业——瞬间创建绝地武士、赏金猎人或自定义职业。
• 阶层系统 (T0 → T4) — 通过游玩提升职业阶层；每阶解锁更强的固有加成和新的被动技能。加成效果随你的 玩家等级 缩放，因此切换职业不会浪费进度。
• 新增属性 — 移动速度 和 法力回复（可分配）。秘法职业使法力值在 Hytale 中对魔法武器发挥作用。

---

🎮 核心 RPG：怪物与玩家等级

• 怪物等级 — 每个生物都有等级。击杀获得的经验值基于 怪物等级；更高等级的怪物提供更多经验值。等级差惩罚保持进度平衡：挑战与你等级匹配的怪物以获得最佳收益。怪物的 伤害 和 生命值 随等级缩放；难度预设（简单/普通/困难/极限）决定其强度感受。
• 玩家等级 — 通过击杀、采矿和伐木获得经验值。升级获得 属性点；可分配到伤害、防御、生命、耐力、法力、采矿、伐木、移动速度、法力回复等属性。清晰的 HUD（等级、经验条、区域）、游戏内属性 GUI 和排行榜。
• 6 个区域 — 翠绿林地、呼啸沙丘、冰域、荒芜之地、天空群岛、剧毒之地，各具不同等级范围。HUD 显示区域名称和颜色（绿色 = 匹配良好，橙色/红色 = 难度过高）。为地牢设置副本等级配置（例如 Yung 的 HyDungeons）。
• 完全控制 — 区域/实体覆盖、BOSS 等级、单次击杀经验值、黑名单、PvP 经验开关。面向任务模组的公开 API；数据库同步（H2， MySQL, PostgreSQL）。可选 PartyPro 实现经验共享。

---

为什么使用它？

• 真正的成长系统 — 怪物等级经验和等级差惩罚让你始终挑战与等级匹配的内容。内置难度预设和缩放功能。
• 职业认同感 — 6 种职业、18 个被动技能、阶层成长。扮演一个角色，奖励专精。
• 你的服务器，你的主题 — 通过 JSON 覆盖职业和被动技能；支持模组武器；在 MessagesLanguageMapping 中重命名所有内容。奇幻、星球大战，或任何角色扮演主题——一个模组，完全灵活。
• 模组友好 — 提供用于经验值和等级检查的 API；与地牢模组、PartyPro、MultipleHUD 兼容。无冲突。

---

文档

📖 docs.rpg-leveling.zuxaw.com — 概述、职业与被动技能、被动技能配置、自定义职业指南、命令、配置、副本与地牢设置、模组覆盖、数据库同步、API、PartyPro 经验共享。

提问之前 — 请先查阅文档或 Discord。大多数答案都在那里。

---

截图

---

功能

职业与被动技能

• 6 种职业 — 重装、钝器、利刃、尖牙、弓箭、秘法。每种拥有专属武器、固有加成（生命、耐力、防御、移动速度、法力回复等）以及 3 个被动技能。通过游玩提升阶层 (T0→T4)；每阶获得更强的加成和新的被动技能。
• 18 个被动技能 — 高生命时增加伤害、低生命时受击回血、击杀后加速、眩晕几率、背水一战、决斗专注、反击、生命偷取、背刺等。每阶均可完全配置（百分比、阈值、持续时间、冷却时间）。
• 完全自定义 — 覆盖职业 JSON：Id、Icon、Weapons、Tiers（每武器固有 + 伤害加成）、Passives。为模组武器添加武器种类；在 MessagesLanguageMapping 中重命名职业和被动技能。无需新代码——仅需 JSON。适用于任何角色扮演主题（星球大战、中世纪、自定义）。

等级与经验值

• 怪物等级经验 — 击杀经验值基于 怪物等级。同级或 ±5 级内收益最高；远低于/高于玩家等级则有惩罚。6 个区域各有等级范围；HUD 显示区域名称及颜色。
• 采矿与伐木经验 — 破坏矿石/矿物块和原木块获得经验值。随等级和区域缩放。
• 等级差倍率 — 与玩家等级匹配的内容收益最高；碾压或过度升级的内容收益递减。

难度与战斗

• 难度缩放 — 怪物伤害和生命值随等级缩放。等级不足时存在等级差惩罚（怪物造成更高伤害，玩家输出降低）。配置中有 EASY/NORMAL/HARD/EXTREME 预设。
• 配置开关 — 启用/禁用等级差防御、等级差对玩家伤害、怪物缩放、低等级经验削减。

属性

• 战斗 — 伤害、防御（递减，最多 80% 减伤）。移动速度、法力回复。
• 采集 — 采矿（矿石/石头）、伐木（原木）。生存 — 生命、耐力、法力、弹药、氧气。耐力调整 — StaminaRegenSpeed、StaminaConsumption。
• 可配置 — 在 StatsLevelConfig.json 中配置每项属性的最大点数和每点效果。可隐藏黑名单属性。

内容与覆盖

• ZoneLevelConfig — 实体覆盖：固定等级、精确单次击杀经验值、禁用特定实体的缩放。副本等级配置 — 为每个副本/地牢设置等级范围和覆盖（地牢模组）。
• 实体黑名单 — 将 NPC/角色排除在等级系统之外（例如 Citizen 模组）。

HUD 与 GUI

• HUD — 等级、经验条、区域名称、区域颜色。GUI — /lvl gui：分配属性点、排行榜（前 100 名）。铭牌 — 注视时显示玩家等级、怪物等级。
• 可选 — 死亡惩罚（重置等级）、PvP 经验开关。使用 MultipleHUD 实现 HUD 兼容；设置 EnableHUD: false 可关闭。

管理员与多人模式

• 命令 — /lvl setlevel、/lvl setpoints、/lvl addxp、/lvl resetstats（支持在线 + 离线玩家）。/lvl resetrewards / /lvl resetrewardsall 仅清除已领取的等级奖励。/lvl resetall 完全重置所有玩家的数据。排行榜 — 前 100 名，包含离线玩家。权限 — /lvl gui 和 /lvl info 对所有人开放；/classes 和管理员命令使用 rpgleveling.command.* 权限节点（详见文档）；向工作人员授予 rpgleveling.command.*（或单个节点）。

数据库与模组制作者

• 数据库同步 — H2, MySQL, MariaDB, PostgreSQL。单向同步：游戏 → 数据库。公开 API — 增加经验值、监听升级事件、获取玩家等级。PartyPro — 队伍内经验共享。翻译 — MessagesLanguageMapping_<lang>.json 文件位于模组的 languages/ 子文件夹中。放入新文件（例如 MessagesLanguageMapping_french.json）即可启用该语言；玩家可在属性 GUI 的 设置 选项卡中选择。新键会自动合并英文版；现有翻译会被保留。旧版单文件映射 (MessagesLanguageMapping.json) 将在首次运行时通过文件迁移系统自动迁移至 languages/MessagesLanguageMapping_english.json。

---

依赖项

• 无强制依赖 — 可独立运行。
• MultipleHUD（可选） — 与其他 HUD 模组共存等级 HUD。
• PartyPro（可选） — 队伍内经验共享。

---

命令

命令	描述
/lvl gui	打开属性 & 职业 GUI
/lvl info	显示属性、命令、帮助信息
/lvl setlevel <player> <level>	(管理员) 设置玩家等级（在线 & 离线）
/lvl setpoints <player> <points>	(管理员) 设置可用属性点（在线 & 离线）
/lvl addxp <player> <xp>	(管理员) 为玩家增加经验值
/lvl resetstats <player>	(管理员) 重置已分配属性（在线 & 离线）
/lvl resetrewards <player>	(管理员) 清除已领取的等级奖励（在线 & 离线）
/lvl resetrewardsall	(管理员) 清除所有玩家已领取的等级奖励
/lvl resetall	(管理员) 重置所有玩家的等级和属性

/lvl gui / /lvl info：无需权限。/classes 和管理员命令：rpgleveling.command.*（详见完整参考）。📖 完整命令参考

---

RPG Leveling v0.3.6 · Zuxaw

如果你需要服务器，可以使用我的优惠码 ZUXAW 支持我——点击下方横幅：