?️ 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 次击杀、1000 次、2000 次等)会给予额外点数。
- 消耗品如 Upgrade Rune 和 Ability Crystal 直接给予点数。
2. 默认按键绑定
| 按键 |
操作 |
描述 |
R |
打开 Player Stats 屏幕 |
打开角色的升级和能力 GUI。 |
H |
打开 Entity Stats 屏幕 |
打开你瞄准的实体(或当前坐骑)的属性 GUI。 |
V |
激活冰霜能力 |
激活临时无限冰霜召唤能力(解锁后)。 |
(所有按键绑定均可在 Minecraft 的控制菜单中重新绑定)。
? 游戏画面与属性展示:
(点击上方观看 YouTube 演示)
✨ 独特能力
可以使用能力点为玩家或实体解锁能力:
| 能力 |
适用实体 |
等级 |
描述 |
| Vampirism |
玩家 |
1 – 5 |
攻击时有几率(30% 至 50%)将造成伤害的 10% 至 18% 转化为生命值恢复。 |
| Life Regen |
非玩家实体 |
1 |
提供永久的被动生命恢复。 |
| Follow Owner |
马、驴、骡、骆驼、铁傀儡 |
1 |
使生物跟随其主人。 |
| Teleport to Owner |
坐骑、铁傀儡 |
1 |
如果生物落后太多,将其传送到主人身边 (需要 Follow Owner)。 |
| Defend Owner |
铁傀儡 |
1 |
使铁傀儡优先攻击针对其主人的实体。 |
| Frost Walker |
马、驴、骡、骆驼 |
1 |
行走时将蹄下的水冻结成冰。 |
| Patrol |
铁傀儡、狼 |
1 |
设置实体在当前职位周围守卫和巡逻。 |
| Taunt |
铁傀儡、狼 |
1 |
在与敌人交战时,迫使附近的敌对怪物暂时攻击它们。 |
| Howl Buff |
狼 |
1 – 3 |
进入战斗时发出嚎叫(5 分钟冷却),在 8 到 16 格半径内为盟友提供力量、速度和抗性,持续 30 秒至 60 秒(效果在第 3 级增强)。 |
| Scout Vision |
鹦鹉 |
1 – 3 |
在 16、24 或 32 格半径内检测并以发光轮廓高亮显示附近的怪物(栖息或在玩家肩膀上时有效)。 |
| Milky Aura |
牛、哞菇 |
1 – 3 |
清除牛周围 3、5 或 7 格半径内盟友的负面状态效果。 |
| Ice Conjurer |
玩家 |
1 |
允许按 V 键激活临时无限冰放置。 |
| Rebirth |
所有生物及玩家 |
1 |
死亡时掉落一个包含实体数据的 Soul Fragment,允许复活。 |
提示: 您可以在 UI 中右键点击任何已解锁的技能,以任意切换其激活/非激活状态,且不会丢失升级等级。已解锁但未激活的技能与未购买的技能通过颜色进行区分,并将完整详情显示在悬停工具提示中。
? 狼嚎增益预览:
(点击上方观看战斗中的狼嚎增益效果)
? 物品与重生仪式
- 升级符文 (
playerstats:upgrade_rune): 古代符文,使用后奖励 +1 属性点。
- 能力水晶 (
playerstats:ability_crystal): 附魔水晶,使用后奖励 +1 能力点。
- 属性增幅卷轴 (
playerstats:attribute_boost_scroll): 在有限时间内为随机属性提供临时倍数加成。
- 无限冰 (
playerstats:infinite_ice): 召唤临时的冰块,几秒后蒸发而不会造成水淹。
- 灵魂碎片 (
playerstats:soul_fragment): 拥有“重生”能力的实体或玩家死亡时掉落。存储其背包和属性数据。
- 灵魂石 (
playerstats:soul_stone): 用于重生仪式。
?️ 重生仪式
复活倒下的同伴或玩家:
- 用 发光矿石 为 重生锚 充能。
- 将 灵魂碎片 和 灵魂石 一起放置在重生锚上方。
- 在距离 1.5 格内引入一只献祭生物:
- 对于 玩家(极限模式观战者恢复):需要献祭一名 村民。
- 对于 生物 / 宠物:需要献祭同一种类的 生物。
- ⚠️ 该仪式会消耗施法者的生命力,使其处于濒死状态。
?️ 观看重生仪式实录:
(点击上方观看 YouTube 上的复活仪式视频)
? 命令
所有命令都需要 OP/权限等级 2:
-
/playerstats addattributepoints <数量> [目标] — 为自己或指定玩家添加属性点。
-
/playerstats removeattributepoints <数量> [目标] — 移除属性点。
-
/playerstats addabilitypoints <数量> [目标] — 添加能力点。
-
/playerstats removeabilitypoints <数量> [目标] — 移除非能力点。
-
/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 配置菜单。
- Progressive Bosses: 集成支持来自其他模组的凋灵变种。
- 自定义属性与模组生物: 自动识别来自 Iron’s Spells ‘n Spellbooks、Epic Fight 等模组以及任何标准 Forge/NeoForge 模组的属性。
- 专用服务器: 客户端与服务器之间完全同步,网络开销极低。
? 许可证
本模组遵循 MIT 许可证。
您可以自由地在整合包、分支版本和重新分发中使用它——请注明原始项目的贡献!
?️ Player Stats
A lightweight and highly configurable progression and RPG system for Minecraft
Note: Available for Minecraft 1.20.1 (Forge/NeoForge) and Minecraft 1.21 / 1.21.1 (NeoForge). For 1.21.x, a single unified build works seamlessly on both 1.21 and 1.21.1.
Gain upgrade points by defeating mobs, customize player and companion stats, unlock unique abilities, use magical items, and even revive fallen companions or players.
Fully supports modded mobs and attributes through a flexible configuration system.
? Overview
Player Stats introduces a customizable RPG progression system where players earn upgrade points by killing mobs.
Unlike traditional mods, attributes are loaded dynamically — meaning that custom attributes from mods such as Iron’s Spells ‘n Spellbooks, Epic Fight, and others are fully supported and can be upgraded.
Additionally, Player Stats features a Companion/Entity progression system, Unique Abilities, and Special Items to expand your gameplay.
? Features
- ⚔️ Mob-Based Progression: Earn attribute points by defeating bosses, high-health mobs, or configured creatures. Milestone kill rewards at 100 kills and every 1,000 kills.
- ?️ Dynamic Attribute Upgrades: Allocate points directly into player or entity stats with live search and filter options in the UI.
- ? Rich Informative Tooltips: Hover over any attribute to see exact gain per point, next-level preview, natural base value, upgrade bonuses, active boost scrolls, and the origin mod name (Minecraft, Iron's Spells, etc.).
- ? Companion & Mount Progression: Inspect and improve the stats and special skills of tamed animals, mounts, or allied golems.
- ? Unique Abilities & Leveled Skills: Unlock and upgrade passive and active abilities (e.g., Vampirism life-steal, Howl buff, Scout Vision, Milky Aura, Rebirth, Ice Conjuring).
- ?️ Ability Toggling & Tooltips: Right-click unlocked abilities in the UI to toggle them On/Off anytime without losing invested levels. Informative tooltips display dynamic values and stats per level.
- ? Items & Runes: Upgrade runes, attribute boost scrolls with temporary buffs, ability crystals, soul stones, and temporary infinite ice.
- ?️ Rebirth Ritual: Revive fallen pets, mobs, or hardcore players using Soul Fragments and Soul Stones on top of a charged Respawn Anchor.
- ? Configurable Resets: Reset allocated attributes anytime by paying configurable XP levels.
- ⚙️ In-Game & File Configuration: Full compatibility with the Configured mod for intuitive in-game settings, alongside detailed TOML configs for drop chances, XP costs, boost durations/multipliers, ignored attributes, and custom increments.
- ? Debug Mode & Slash Commands: Easily inspect mob and attribute IDs, reload configs without restarting, or manage player points via commands.
? How It Works
1. Earning Points & Upgrades
- Killing bosses (Wither, Ender Dragon, Warden, Elder Guardian) or mobs above the configured health threshold grants a chance to receive attribute points.
- Kill counter milestones (100 kills, 1000, 2000, etc.) grant extra points.
- Consumable items like Upgrade Rune and Ability Crystal grant points directly.
2. Default Keybinds
| Key |
Action |
Description |
R |
Open Player Stats Screen |
Opens your character's upgrade and abilities GUI. |
H |
Open Entity Stats Screen |
Opens stats GUI for the entity you are aiming at (or your current mount). |
V |
Activate Ice Ability |
Activates the temporary Infinite Ice conjurer ability (once unlocked). |
(All keybinds can be rebound under Minecraft's Controls menu).
? Gameplay & Attribute Showcase:
(Click above to watch the demonstration on YouTube)
✨ Unique Abilities
Abilities can be unlocked for players or entities using Ability Points:
| Ability |
Applicable Entities |
Levels |
Description |
| Vampirism |
Players |
1 – 5 |
Has a chance (30% to 50%) on hit to restore 10% to 18% of dealt damage as health. |
| Life Regen |
Non-player entities |
1 |
Gives permanent passive health regeneration. |
| Follow Owner |
Horses, Donkeys, Mules, Camels, Iron Golems |
1 |
Makes the creature follow its owner. |
| Teleport to Owner |
Mounts, Iron Golems |
1 |
Teleports the creature to the owner if it falls too far behind (requires Follow Owner). |
| Defend Owner |
Iron Golems |
1 |
Causes the golem to prioritize and attack entities targeting its owner. |
| Frost Walker |
Horses, Donkeys, Mules, Camels |
1 |
Freezes water into ice under the mount's hooves when walking. |
| Patrol |
Iron Golems, Wolves |
1 |
Sets the entity to guard and patrol around its current position. |
| Taunt |
Iron Golems, Wolves |
1 |
Forces nearby hostile monsters to temporarily target them upon engaging in combat. |
| Howl Buff |
Wolves |
1 – 3 |
Howls when entering combat (5 min cooldown), granting Strength, Speed, and Resistance to allies in an 8 to 16-block radius for 30s to 60s (potency increases at Level 3). |
| Scout Vision |
Parrots |
1 – 3 |
Detects and highlights nearby monsters with a glowing outline in a 16, 24, or 32-block radius (works when perching or on player shoulders). |
| Milky Aura |
Cows, Mooshrooms |
1 – 3 |
Clears negative status effects from allies in a 3, 5, or 7-block radius around the cow. |
| Ice Conjurer |
Players |
1 |
Allows activating temporary infinite ice placement by pressing V. |
| Rebirth |
All creatures & Players |
1 |
Drops a Soul Fragment upon death containing the entity's data, allowing resurrection. |
Tip: You can Right-Click any unlocked ability in the UI to toggle it Active / Inactive at will without losing upgrade levels. Unlocked but deactivated abilities and unpurchased abilities are clearly distinguished by color, with full details shown on hover tooltips.
? Wolf Howl Buff Preview:
(Click above to watch the Howl Buff in combat)
? Items & Rebirth Ritual
- Upgrade Rune (
playerstats:upgrade_rune): Ancient rune that awards +1 attribute point on use.
- Ability Crystal (
playerstats:ability_crystal): Imbued crystal that awards +1 ability point on use.
- Attribute Boost Scroll (
playerstats:attribute_boost_scroll): Grants a temporary multiplier bonus to a random attribute for a limited duration.
- Infinite Ice (
playerstats:infinite_ice): Summons temporary blocks of ice that evaporate without flooding water after several seconds.
- Soul Fragment (
playerstats:soul_fragment): Dropped by an entity or player that has the Rebirth ability when they die. Stores their inventory and stats.
- Soul Stone (
playerstats:soul_stone): Used in the ritual of rebirth.
?️ The Rebirth Ritual
To revive a fallen companion or player:
- Charge a Respawn Anchor with glowstone.
- Drop the Soul Fragment and a Soul Stone together on top of the anchor.
- Bring a sacrifice mob within 1.5 blocks:
- For players (Hardcore spectator recovery): requires a Villager sacrifice.
- For mobs / pets: requires a mob of the same entity type.
- ⚠️ The ritual consumes vital energy from the caster, leaving them near death.
?️ Watch the Rebirth Ritual in Action:
(Click above to watch the resurrection ritual on YouTube)
? Commands
All commands require OP/permission level 2:
/playerstats addattributepoints <amount> [target] — Adds attribute points to yourself or a target player.
/playerstats removeattributepoints <amount> [target] — Removes attribute points.
/playerstats addabilitypoints <amount> [target] — Adds ability points.
/playerstats removeabilitypoints <amount> [target] — Removes ability points.
/playerstats set <attribute_id> <value> [target] — Directly sets an attribute modifier value.
/playerstats reloadconfig — Reloads custom mob drop chances, ignored attributes, and custom increments without restarting the game.
? Configuration
? In-Game Configuration: Player Stats is fully integrated with Configured! You can easily adjust all settings, drop rates, and custom attribute increments directly in-game through clean, translated menus with helpful tooltips and add buttons.
Configurations are split between:
playerstats-common.toml (Client/Common settings):
debugMode: Enables logging and in-game debug messages for mob IDs and attribute registry keys.
playerstats-server.toml (World/Server settings):
resetOnDeath: Whether attributes reset when a player dies.
highHealthAmount: Minimum mob health to qualify as a high-health target (default: 50).
witherChance, enderDragonChance, wardenChance, elderGuardianChance, highHealthChance: Drop chances for points.
customMobChances: List of mob IDs and their point drop chances (["minecraft:creeper=0.05", "mymod:boss=0.80"]).
customAttributeIncrement: Custom upgrade step values per point (["minecraft:generic.max_health=2.0"]).
ignoredAttributes: Attributes hidden from the upgrade interface.
consumeExperience, experienceCostIncrement, requiredXpForReset, requiredXpForAbility: XP economy settings.
boostAmountMinMultiplier, boostAmountMaxMultiplier, boostDurationMinMinutes, boostDurationMaxMinutes: Boost scroll settings.
Example Server Config (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
? Compatibility
- Minecraft Versions: Available for 1.20.1, 1.21, and 1.21.1.
- Mod Loaders: Compatible with Forge (1.20.1) and NeoForge (1.20.1 / 21.0.x / 21.1.x+).
- In-Game Configs: Full support for Configured and built-in Forge/NeoForge configuration menus.
- Progressive Bosses: Integrated support for modded Wither variants.
- Custom Attributes & Modded Mobs: Automatically recognizes attributes from mods like Iron’s Spells ‘n Spellbooks, Epic Fight, and any standard Forge/NeoForge mod.
- Dedicated Servers: Fully synchronized across client and server with low network footprint.
? License
This mod is licensed under the MIT License.
You are free to use it in modpacks, forks, and redistributions — credit to the original project is appreciated!
评论 0
登录后参与评分
还没有评论,来抢沙发吧