Emerald Drop v1.2.0

一个为 Minecraft 1.21.11 设计的 Fabric 模组，添加了绿宝石相关的增强功能和丰富的成就系统。

📦 模组信息

版本: 1.2.0
Minecraft: 1.21.11
Fabric Loader: 0.18.4+
Fabric API: 0.141.3+
许可证: LGPL-3.0

✨ 核心功能

1. 绿宝石防火

绿宝石物品不会被火焰和岩浆烧毁
类似下界合金的防火特性
可通过游戏规则配置

2. 村民掉落绿宝石

村民死亡掉落 1-2 个绿宝石
流浪商人死亡掉落 3-6 个绿宝石
掉落数量可配置

3. 村民重生系统

村民死亡后在绑定的床位置重生
严格验证床的存在性
防止床被破坏后重生

4. 村民掉落经验

村民掉落 5-20 点经验
流浪商人掉落 50 点经验
使用加权随机算法

5. 调试指令系统

/emeralddrop debug <true|false> - 开启/关闭调试模式
调试消息显示在聊天栏（64格范围内）
实时查看模组事件

6. 成就系统（48个成就）

收集类：9个成就
交易类：5个成就
村民类：4个成就
防火类：2个成就
经验类：1个成就
探索类：8个成就
战斗类：4个成就
建筑类：5个成就
生存类：3个成就
职业类：7个成就

🏆 成就亮点

挑战成就（高经验奖励）

绿宝石传奇 - 1000 XP（拥有3456个绿宝石）
绿宝石王座 - 500 XP（拥有256个绿宝石方块）
绿宝石之雨 - 300 XP（拥有1728个绿宝石）
绿宝石信标 - 200 XP（拥有164个绿宝石方块）
全职业大师 - 150 XP（与所有职业村民交易）

总经验奖励

所有成就完成可获得 2,830 点经验值

🌍 多语言支持

✅ 简体中文 (zh_cn)
✅ 繁体中文 (zh_tw)
✅ English (en_us)
✅ 日本語 (ja_jp)

所有成就、游戏规则和命令消息均已完整翻译。

🎮 游戏规则

规则名称	默认值	说明
emeraldFireImmune	true	绿宝石防火
villagerDropEmerald	true	村民掉落绿宝石
villagerRespawn	true	村民重生
villagerDropExperience	true	村民掉落经验
villagerEmeraldMin	1	村民绿宝石最小值
villagerEmeraldMax	2	村民绿宝石最大值
traderEmeraldMin	3	流浪商人绿宝石最小值
traderEmeraldMax	6	流浪商人绿宝石最大值
villagerExperienceMin	5	村民经验最小值
villagerExperienceMax	20	村民经验最大值
traderExperience	50	流浪商人经验值

📊 性能数据

模组大小: 68.21 KB
初始化时间: ~22ms
内存占用: < 1MB
TPS 影响: 可忽略
事件处理: < 1ms

🚀 安装方法

确保已安装 Fabric Loader 0.18.4+
确保已安装 Fabric API 0.141.3+
将 emerald-drop-1.2.0.jar 放入 mods 文件夹
启动游戏

🎯 快速开始

开启调试模式

/emeralddrop debug true

测试绿宝石防火

/give @s minecraft:emerald 64
/setblock ~ ~ ~1 minecraft:fire

将绿宝石扔进火焰，观察不会被烧毁。

测试村民重生

/summon minecraft:villager ~ ~ ~
/setblock ~ ~ ~3 minecraft:white_bed[part=foot]

等待村民绑定床位，然后击杀村民，观察重生。

查看成就

按 L 键打开成就界面，查找 "Emerald Drop" 分类。

🏗️ 成就树结构

绿宝石之旅 (Root)
├─ 收集类成就
│  ├─ 绿宝石囤积者 → 绿宝石收藏家 → 绿宝石大亨
│  └─ 绿宝石方块 → 绿宝石装甲 → 绿宝石信标
│     └─ 绿宝石大师 → 绿宝石之雨
├─ 交易类成就
│  └─ 村民交易者 → 交易大师 → 交易帝国 → 全职业大师
├─ 探索类成就
│  ├─ 绿宝石探险家 → 绿宝石矿工 → 山脉之王
│  └─ 维度旅行者 → 下界绿宝石 / 末地绿宝石
├─ 战斗类成就
│  └─ 绿宝石战士 → 掠夺者猎人 → 袭击守卫者
├─ 建筑类成就
│  └─ 绿宝石建筑师 → 绿宝石宫殿 → 绿宝石王座 → 绿宝石传奇
└─ 职业类成就
   ├─ 绿宝石农夫 → 牧羊人 / 屠夫 / 渔夫
   ├─ 绿宝石附魔师 → 图书管理员
   └─ 绿宝石战士 → 制箭师 / 铁匠

⚡ 性能优化

针对 FCL（手机端）

减少内存分配
优化事件处理
快速类型检查

客户端优化

Mixin 注入点优化
减少方法调用
优化日志输出

服务端优化

查找表优化
缓存配置值
位运算替代除法

🐛 已修复的 BUG

✅ 床被破坏后村民仍能重生
✅ 整数溢出风险
✅ 空指针异常
✅ 成就背景材质问题
✅ 竞态条件问题

📝 配置文件

配置文件位置：config/emerald-drop.json

{
  "enableEmeraldFireImmune": true,
  "enableVillagerDropEmerald": true,
  "enableVillagerRespawn": true,
  "enableVillagerDropExperience": true,
  "villagerEmeraldRange": [1, 2],
  "traderEmeraldRange": [3, 6],
  "villagerExperienceRange": [5, 20],
  "traderExperience": 50
}

🔧 开发环境

构建项目

./gradlew build

运行客户端

./gradlew runClient

运行服务器

./gradlew runServer

📚 文档

🤝 贡献

欢迎提交 Issue 和 Pull Request！

📄 许可证

本项目采用 LGPL-3.0 许可证。

👤 作者

RedLotus

🙏 致谢

感谢所有测试者和贡献者的支持！

Emerald Drop v1.2.0 - 让绿宝石更有价值！ 💎✨

Emerald Drop（绿宝石滴落）

Emerald Drop（绿宝石滴落） 1.2.0

Список изменений