R’s Experience v0.5 — 协奏曲与圣器

📖 模组简介

R’s Experience 是一个受 Warframe 精通等级系统启发的 Minecraft Fabric 模组。它引入了一套完整的精通等级（Mastery Rank）成长体系，让玩家通过使用装备、击杀怪物来积累精通经验，逐步解锁更强大的武器和防具。

本模组不提供公开源码，保留所有权利（All Rights Reserved）。

🎯 核心特色

以下功能按版本标注，[v0.1] 表示从该版本起可用。后续版本可能对早期功能进行了优化或重写。

🔵 精通等级系统 [v0.1]

• 0~30 级精通等级，每级都需要积累足够的经验值
• 升级公式：100 + 当前等级 × 50
• 经验值可通过击杀怪物、使用同级装备等方式获取
• 数据持久化，退出世界不丢失

v0.3 重构：取消药水惩罚，改为直接修改实体属性

⚔️ 装备等级限制 [v0.1] → [v0.2][v0.3]

• 通过物品 Lore（提示文本） 标记装备所需等级
• 格式：需要精通等级: X
• 任何模组的物品都可以通过添加一行 Lore 文本来接入本模组的限制系统

v0.1 使用 NBT 词条 (custom_data)，v0.3 改为读取 Lore 文本，兼容性更强

🎭 智能惩罚分档 [v0.2]

v0.2 使用药水效果（虚弱、挖掘疲劳），v0.3 改为 EntityAttributeModifier 直接修改属性

💀 「厌弃」与「讨好」系统 [v0.3]

当玩家强行使用超出自身等级 7 级以上的装备时，装备会直接从玩家手中弹出并掉落在地。玩家可以通过蹲下并上下摇头（累计俯仰 60°）来「讨好」装备——成功后装备会飞回背包，但需消耗当前等级 10% 的精通经验。

如果玩家选择水平旋转视角 360° 来拒绝装备，将进入 30 秒倒计时。在此期间其他玩家可以靠近并尝试二次讨好。二次拒绝会导致装备被直接销毁。

成功讨好时伴随 3 秒白色 END_ROD 粒子特效，装备升至 5 格高度后传送回背包。

☠ 「器之绝望」 [v0.3.1]

当玩家经验不足（0 级 0 XP）却触发厌弃时，会触发特殊的「器之绝望」状态：

• 失明与迟缓效果
• 凋零尖啸音效
• 装备直接被销毁

📊 经验获取途径 [v0.2]

1. 击杀怪物 — 每种怪物对应不同经验值（5~50 XP）
2. 同级装备使用 — 使用与自身等级匹配的装备进行击杀/采集，每次获得少量经验
3. 越级惩罚 — 穿戴超等级装备时无法获得任何精通经验

🎨 HUD 系统 [v0.1] → [v0.3]

• 蓝色精通经验条替代原版绿色经验条 [v0.1]
• 讨好进度条（红色读条 + 剩余秒数 + 操作提示）[v0.3]
• 器之绝望警告提示 [v0.3.1]

⌨️ 命令系统

🆕 v0.5 新增内容

v0.5版本下的 R'S Experience 现在正式可以称为 “Model” 了

🪄 全新武器系统

R’s Experience 终于拥有了自己的专属武器。本次更新引入两种武器类型：

协调法杖 (staff_attunedwand) — 法杖类武器，攻击伤害 +3，攻击速度 1.6，需要精通等级 2。共鸣晶石与梧桐木芯熔铸而成，握持时能感受到温和的魔力共振。

圣地权杖 (sceptre_shrine) — 权杖类武器，攻击伤害 +7，攻击速度 1.0，需要精通等级 5。古老祭祀权杖，顶端灯笼常燃不熄。

两把武器均为单手装备，主手和副手均可发挥完整效果。

命名规则

• 法杖：staff_***（如 staff_attunedwand）
• 权杖：sceptre_***（如 sceptre_shrine）

尝试与开始

新增技能——🎵 协奏曲

协调法杖在副手装备时，会激活协奏曲技能——完全抵消主手武器因精通等级差带来的属性惩罚。

副手：协调法杖（激活协奏曲）
主手：精通等级需求 10 的武器
玩家实际等级：2
结果：无惩罚 ✅

该效果通过 MasteryRestrictions.hasConcerto() 检测，在惩罚判定流程中拦截所有调用点。

🧾 Tooltip

物品信息框全面重制，风格设计：

╔══════════════════════╗
    协调法杖
    法杖
╠══════════════════════╣
需求: 等级 2
物理伤害: +3        物理攻速: 1.6
 共鸣晶石与梧桐木芯熔铸而成的协调法杖
 握持时能感受到温和的魔力共振
╠══════════════════════╣
 ◆ 获得技能: 协奏曲
  取消主手武器因等级差带来的惩罚
ATTUNED WAND
╚══════════════════════╝

⚙️ 武器配置化

所有武器数据集中管理在 data/rs_experience/weapon_properties.json 中，无需修改 Java 代码即可调整：

{
  "attack_damage": 3,
  "attack_speed": -2.4,
  "mastery_rank": 2,
  "skill": "协奏曲",
  "description": ["神秘的加护"]
}

🔧 如何给物品添加等级限制

使用 /give 指令或数据包修改物品的 Lore 文本：

/give @p minecraft:diamond_sword[lore=['{"text":"✦ 需要精通等级: 10","color":"dark_aqua"}']]

也可使用模组内命令 /mastery alore <等级> 快速添加。

模组武器已自带等级限制，无需额外配置。

📋 兼容性

• 完全兼容其他 RPG 模组 ——只要对方的物品通过 Lore 添加了 需要精通等级: X 的文本即可接入
• 服务端和客户端均需要安装
• 依赖：Fabric API

📦 模组信息

版本历史

未来

- 自定义动作——让我们看起来真的在魔法世界
- 更多的武器魔法——不止协奏曲，而是琴瑟和鸣
- 更多的模组武器——魔法的世界里不应该只有魔法
- 更多的特性——“腐化”、“亵渎”、“悲恸”...
- 更精美的建模——2D-3D
And...
        ——你们的声音。

📝 写在最后

邪恶魔法师（合上乐谱）：

v0.5 的主角是武器与配置——我终于让这个模组看起来像一个真正的 RPG 模组了，而不是一个只会报错的实验品。

下次更新可能会做自定义攻击动画。也可能不会。因为我无法控制我的灵感什么时候来。

——就像我无法控制协奏曲什么时候哼完最后一个音符一样。

祝你好运，勇者。

🪄✨

反馈 & 建议： RicardoK@foxmail.com

快速导航

• Wiki — 模组介绍与使用方法
• 开发日志 — 更新历史

📥 下载 R’s Experience v0.5