Player Stats

🛡️ Player Stats

一款轻量且高度可配置的 Minecraft 进阶与 RPG 系统

注意：适用于 Minecraft 1.20.1（Forge/NeoForge）以及 Minecraft 1.21 / 1.21.1（NeoForge）。对于 1.21.x，同一个统一版本可在 1.21 和 1.21.1 上无缝运行。

击败生物即可获得升级点数，自定义玩家与伙伴的属性，解锁独特能力，使用魔法物品，甚至复活倒下的伙伴或玩家。

通过灵活的配置系统，全面支持模组生物和属性。

📦 概览

Player Stats引入了可自定义的 RPG 进阶系统，玩家可通过击杀生物获得升级点数。
与传统模组不同，属性会动态加载——这意味着 Iron’s Spells ‘n Spellbooks、Epic Fight 等模组添加的自定义属性也都能得到完整支持并可进行升级。

此外，Player Stats 还提供伙伴/实体进阶系统、独特能力和特殊物品，进一步丰富你的游戏体验。

🎯 功能特色

• ⚔️ 基于生物的进阶：击败 Boss、高生命值生物或配置指定的生物，即可获得属性点数。在击杀 100 次及之后每增加 1,000 次时，还能获得里程碑奖励。
• 🛠️ 动态属性升级：可直接将点数分配到玩家或实体属性中，并在界面中使用实时搜索和筛选功能。
• 📊 丰富详尽的提示信息：将鼠标悬停在任意属性上，即可查看每点带来的精确增益、下一级预览、自然基础值、升级加成、生效中的增益卷轴以及来源模组名称（Minecraft、Iron’s Spells等）。
• 🐾 伙伴与坐骑进阶：查看并提升驯服动物、坐骑或友方傀儡的属性和特殊技能。
• 🌟 独特能力与等级技能：解锁并升级被动和主动能力（例如吸血生命偷取、嚎叫增益、侦察视觉、乳白光环、重生、冰霜召唤）。
• 🎛️ 能力开关与提示信息：在界面中右键点击已解锁的能力，即可随时开启或关闭，而不会损失已投入的等级。详尽的提示信息会显示动态数值和各等级属性。
• 📜 物品与符文：升级符文、提供临时增益的属性强化卷轴、能力水晶、灵魂石以及临时无限冰。
• 🕯️ 重生仪式：在充能后的重生锚上使用灵魂碎片和灵魂石，复活倒下的宠物、生物或极限模式玩家。
• 🔄 可配置的重置：随时重置已分配的属性点数，费用为可配置数量的经验等级。
• ⚙️ 游戏内与文件配置：全面兼容 Configured模组，可直观地在游戏内调整设置；同时提供详细的 TOML 配置文件，用于设置掉落几率、经验花费、增益持续时间/倍率、忽略的属性以及自定义增量。
• 🧪 调试模式与斜杠命令：轻松查看生物和属性 ID、无需重启即可重载配置，或通过命令管理玩家点数。

🎮 工作原理

1. 获取点数与升级

• 击杀 Boss（凋灵、末影龙、监守者、远古守卫者）或超过配置生命值阈值的生物，有几率获得属性点数。
• 击杀计数达到里程碑（100 次、1,000 次、2,000 次等）时可获得额外点数。
• 消耗品，例如升级符文和能力水晶，可直接提供点数。

2. 默认按键绑定

| 按键 | 操作 | 描述 |
| :—: | :— | :— |
| R | 打开玩家属性界面 | 打开角色的升级与能力 GUI。 |
| H | 打开实体属性界面 | 打开你正瞄准的实体（或你当前坐骑）的属性 GUI。 |
| V | 激活冰霜能力 | 激活临时的无限冰块召唤能力（解锁后可用）。 |

（所有按键均可在 Minecraft 的“控制”菜单中重新绑定）。

🎬 玩法与属性展示：

（点击上方在 YouTube 观看演示）

✨ 独特能力

玩家或实体可使用能力点解锁能力：

| 能力 | 适用实体 | 等级 | 描述 |
| :— | :— | :—: | :— |
| 吸血 | 玩家 | 1 – 5 | 命中时有几率（30% 至 50%）将造成伤害的 10% 至 18% 转化为生命值。 |
| 生命恢复 | 非玩家实体 | 1 | 赋予永久的被动生命恢复。 |
| 跟随主人 | 马、驴、骡、骆驼、铁傀儡 | 1 | 使生物跟随其主人。 |
| 传送至主人 | 坐骑、铁傀儡 | 1 | 若生物落后太远，则将其传送至主人身边（需要“跟随主人”）。 |
| 保卫主人 | 铁傀儡 | 1 | 使傀儡优先攻击以主人为目标的实体。 |
| 冰霜行者 | 马、驴、骡、骆驼 | 1 | 坐骑行走时将其蹄下的水冻结成冰。 |
| 巡逻 | 铁傀儡、狼 | 1 | 使实体守卫并围绕当前位置巡逻。 |
| 嘲讽 | 铁傀儡、狼 | 1 | 进入战斗时强制附近的敌对怪物暂时将其作为目标。 |
| 嚎叫增益 | 狼 | 1 – 3 | 进入战斗时嚎叫（5 分钟冷却），为 8 至 16 格半径内的盟友提供 30 秒至 60 秒的力量、速度和抗性提升（3 级时效果增强）。 |
| 侦察视觉 | 鹦鹉 | 1 – 3 | 探测并以发光轮廓高亮 16、24 或 32 格半径内的附近怪物（栖息或站在玩家肩上时生效）。 |
| 牛奶光环 | 牛、哞菇 | 1 – 3 | 清除牛周围 3、5 或 7 格半径内盟友的负面状态效果。 |
| 冰霜召唤师 | 玩家 | 1 | 允许按下 V 键激活临时的无限冰块放置。 |
| 重生 | 所有生物与玩家 | 1 | 死亡时掉落一个灵魂碎片，其中包含该实体的数据，可用于复活。 |

提示：你可以在 UI 中右键点击任何已解锁的能力，随意切换其激活 / 未激活状态，而不会丢失升级等级。已解锁但未激活的能力与未购买的能力通过颜色清晰区分，悬停提示中会显示完整详情。

🐺 狼嚎叫增益预览：

（点击上方观看战斗中的嚎叫增益）

🔮 物品与重生仪式

• 升级符文（playerstats:upgrade_rune）： 使用后获得 +1 属性点的古老符文。
• 能力水晶（playerstats:ability_crystal）： 使用后获得 +1 能力点的灌注水晶。
• 属性提升卷轴（playerstats:attribute_boost_scroll）： 在限定时间内为随机属性提供临时倍率加成。
• 无限冰块（playerstats:infinite_ice）： 召唤临时冰块，数秒后蒸发且不会产生水。
• 灵魂碎片（playerstats:soul_fragment）： 由拥有重生能力的实体或玩家死亡时掉落。储存其物品栏和属性。
• 灵魂石（playerstats:soul_stone）： 用于重生仪式。

🕯️ 重生仪式

要复活倒下的伙伴或玩家：

1. 用荧石给重生锚充能。
2. 将灵魂碎片和灵魂石一起丢在重生锚上方。
3. 将一只献祭生物带到1.5格范围内：

• 对于玩家（极限模式旁观者恢复）：需要献祭一只村民。
• 对于生物/宠物：需要一只相同实体类型的生物。

1. ⚠️ 该仪式会消耗施法者的生命能量，使其濒临死亡。

🕯️ 观看重生仪式演示：

（点击上方在YouTube上观看复活仪式）

💻 命令

所有命令都需要OP/权限等级2：

• /playerstats addattributepoints <amount> [target] — 为自己或目标玩家添加属性点。
• /playerstats removeattributepoints <amount> [target] — 移除属性点。
• /playerstats addabilitypoints <amount> [target] — 添加能力点。
• /playerstats removeabilitypoints <amount> [target] — 移除能力点。
• /playerstats set <attribute_id> <value> [target] — 直接设置属性修正值。
• /playerstats reloadconfig — 重新加载自定义生物掉落概率、忽略的属性和自定义增量，无需重启游戏。

🔧 配置

💡 游戏内配置： Player Stats 已完全集成Configured！你可以直接在游戏内通过整洁、已翻译的菜单轻松调整所有设置、掉落概率和自定义属性增量，菜单中还带有实用的提示和添加按钮。

配置分为：

• playerstats-common.toml（客户端/通用设置）：
• debugMode：启用日志记录和游戏内调试消息，用于显示生物ID和属性注册键。
• playerstats-server.toml（世界/服务端设置）：
• resetOnDeath：玩家死亡时属性是否重置。
• highHealthAmount：被判定为高生命值目标所需的最低生物生命值（默认：50）。
• witherChance、enderDragonChance、wardenChance、elderGuardianChance、highHealthChance：点数掉落概率。
• customMobChances：生物ID列表及其点数掉落概率（["minecraft:creeper=0.05", "mymod:boss=0.80"]）。
• customAttributeIncrement：每点数的自定义升级步长值（["minecraft:generic.max_health=2.0"]）。
• ignoredAttributes：在升级界面中隐藏的属性。
• consumeExperience、experienceCostIncrement、requiredXpForReset、requiredXpForAbility：经验经济设置。
• boostAmountMinMultiplier、boostAmountMaxMultiplier、boostDurationMinMinutes、boostDurationMaxMinutes：增益卷轴设置。

服务端配置示例（playerstats-server.toml）：

[geral]
resetOnDeath = false
highHealthAmount = 50

[mob_chances]
witherChance = 0.5
enderDragonChance = 0.5
wardenChance = 0.3
elderGuardianChance = 0.5
highHealthChance = 0.05
customMobChances = [
    "minecraft:chicken=0.01",
    "mymod:dungeon_boss=0.75"
]

[attribute_settings]
customAttributeIncrement = [
    "attribute.name.generic.max_health=2.0",
    "attribute.name.generic.attack_damage=0.5"
]
ignoredAttributes = [
    "attribute.name.generic.armor",
    "forge.name_tag_distance",
    "forge.entity_gravity",
    "forge.step_height",
    "attribute.name.generic.armor_toughness"
]

[experience]
consumeExperience = true
experienceCostIncrement = 5
requiredXpForReset = 50
requiredXpForAbility = 30

[attribute_boost]
boostAmountMinMultiplier = 1
boostAmountMaxMultiplier = 3
boostDurationMinMinutes = 10
boostDurationMaxMinutes = 30

🧩 兼容性

• Minecraft 版本：适用于 1.20.1、1.21 和 1.21.1。
• 模组加载器：兼容 Forge（1.20.1）和 NeoForge（1.20.1 / 21.0.x / 21.1.x+）。
• 游戏内配置：全面支持 Configured，并内置 Forge/NeoForge 配置菜单。
• 渐进式 Boss：集成支持模组添加的凋灵变种。
• 自定义属性与模组生物：自动识别来自 Iron’s Spells ‘n Spellbooks、Epic Fight 等模组的属性，以及任何标准 Forge/NeoForge 模组中的属性。
• 专用服务器：客户端与服务器之间完全同步，网络开销低。

📜 许可证

本模组采用 MIT License 许可。
你可以在整合包、分支版本和再发行作品中自由使用本模组——如能注明原项目出处，我们将不胜感激！