版本 1.0.8

• 修复了错误。
• 更正了错误的 GitHub 请求。

更新日志 1.0.7

• 修复了与金钱数量显示相关的错误。
• 平衡了宝箱中的战利品分配。
• 优化了战利品定义系统，以提升性能和一致性。

📦 更新 - 魔法金币

🛠️ 重构

• 完成代码重构，以提高可维护性，并让其他开发者更轻松地创建附加组件。

✨ 新特性

• 添加了死亡时丢失金币的百分比控制。
• 添加了启用/禁用原版箱子中金币战利品的开关。

🎯 战利品表

为以下结构创建了自定义战利品表：

结构	难度 (1–5)
abandoned_mineshaft	3
ancient_city	5
ancient_city_ice_box	5
bastion_bridge	4
bastion_hoglin_stable	4
bastion_other	4
bastion_treasure	5
buried_treasure	1
desert_pyramid	2
end_city_treasure	4
igloo_chest	1
jungle_temple	2
pillager_outpost	3
ruined_portal	2
shipwreck_supply	1
shipwreck_treasure	2
simple_dungeon	2
stronghold_corridor	3
stronghold_crossing	3
stronghold_library	3
underwater_ruin_big	2
underwater_ruin_small	1
woodland_mansion	5

❌ 注意： trial_chambers 结构不会生成金币，因为它预留给另一个项目使用。

🐞 错误修复

• 修复了 CuriosAPI 版本不匹配的问题。

⚙️ 优化

• 常规性能改进和代码组织优化。

MagicCoins 1.0.5 - 性能改进与新语言支持

🆕 新增内容：

• 代码优化以提升性能。
• 减少了不必要的文件，避免下载无用内容。
• 新增多种语言以提升可访问性。

💡 **发现问题或有建议？**加入我们的 Discord 并分享您的反馈！

MagicCoins 1.0.4 - 可配置的图形界面与新按钮

🆕 新增内容：

• 您现在可以通过 magic-coins-client.toml 文件调整界面（按钮和显示）的位置。
• 在物品栏中添加了 4 个新按钮，用于直接转换硬币。这些按钮必须在 magic-coins-client.toml 文件中启用。

⚠️ 注意：

• 如果物品栏已满，直接转换功能可能会导致冻结，因为多余的物品将被丢弃。
• 可能会出现未识别的错误，请自行承担使用风险。

💡 **发现问题或有建议？**加入我们的 Discord 并分享您的反馈！

MagicCoins 1.0.3 - 错误修复与音效

🆕 新增内容：

• 添加了按钮交互时的音效。
• 新增了通过物品栏收集金币时的音效，以提升沉浸感。

🛠️ 改进与修复：

• 修复了若干错误，以提升稳定性和玩家体验。

💡 发现问题或有建议？ 加入我们的 Discord 并分享您的反馈！

MagicCoins 1.0.2 - 可自定义数值与 API 改进

新增内容：

• 您现在可以通过 magic_coins-common.toml 文件自定义硬币价值，为模组包和个人偏好提供更大的灵活性。

改进：

• 调整了 API 包，使其他模组能够更轻松地集成并更高效地使用 MagicCoins 的方法。

欢迎在我们的 Discord 上报告任何问题或提出建议！

模组已更新至 NeoForge

本模组已更新以兼容 NeoForge 版本，确保在新平台上拥有更好的性能和兼容性。

本次更新内容：

• 新增命令：通过命令添加新功能，以提升用户体验。
• 错误修复：解决了若干小问题，提高了稳定性和可靠性。

欢迎通过 Discord 联系我们，报告任何问题或提出建议！

MagicCoins – 版本 1.1.1

概述

MagicCoins 1.1.1 版本侧重于结构重构、改进服务器与客户端配置同步，以及简化网络和 GUI 按钮处理。没有面向用户的游戏玩法变更，但代码库现在更加有序、可扩展且可靠。

---

主要变更

🌐 网络与同步

• 引入了 MagicNetwork，这是一个专用的辅助工具，用于集中和标准化网络注册。

• 迁移所有消息/数据包注册以使用 MagicNetwork。

• 添加了 SyncServerConfigS2C 负载，用于将服务器配置同步到客户端。

• 引入了：

  • ServerConfigSync
  • ServerConfigSyncEvents

• 服务器配置现在会在以下情况同步：

  • 客户端加载时
  • 玩家登录时

• 添加了 ClientSyncedConfig，用于在客户端存储同步的值。

• ServerConfig 现在会自动广播配置更改。

• MagicCoinsApi 现在在客户端读取客户端同步的值，避免无效访问服务器端配置。

---

🧩 GUI 与按钮重构

• 添加了 MagicCoinsButtonAction 枚举：

  • 集中数据包创建和发送逻辑
  • 明确定义可重用的按钮操作

• 更新了 CustomButton 以支持：

  • 左键点击操作
  • 右键点击操作

• 简化了 HandlerButton：

  • 现在仅将执行委托给 MagicCoinsButtonAction

• 移除了冗余的处理程序和重复的逻辑。

---

🔄 网络注册

• 用通过 MagicNetwork 的统一注册替换了单独的数据包注册调用。
• 提高了可读性和可维护性，并降低了不一致的风险。

---

📦 依赖项

• 更新了 sg_economy 依赖项：

  • 在 build.gradle 文件中提升版本
  • 相关的导入和格式更新

---

对开发者的影响

• 代码库更加模块化和可维护。
• 拥有单一、一致的网络通信模式。
• 为未来的客户端/服务器同步功能奠定了基础。
• 更灵活的按钮系统，用于扩展 GUI 操作。

---

兼容性

• 与现有存档兼容。
• 无需手动迁移步骤。

---

备注

此发布版本主要是技术性的，侧重于重构。建议计划扩展模组或维护自定义分支的开发者使用。

---

版本： 1.1.1

Magic Coins 1.1.0 — 基于 SG Economy 的新经济架构

提供已文档化的类和方法，用于：

• 查询和修改玩家余额
• 与其他模组原生集成
• 创建自定义经济系统

:tools: 管理命令（由 SG Economy 管理）

所有与经济相关的命令现在完全由 SG Economy 管理，包括：

• 查询余额
• 增加余额
• 设置余额
• 移除余额 （新命令）
• 在玩家之间转移余额 （新命令）

注意： 移除余额和玩家间转移命令在 Magic Coins 1.0.9 中不存在，它们是随着采用 SG Economy API 而引入的。

:skull_crossbones: 死亡惩罚

死亡惩罚现在是 SG Economy 的原生功能：

• 默认损失存储余额的 50%
• 可通过配置文件完全配置

:desktop: 显示界面

以可配置且可视化的方式在物品栏和/或 HUD 中显示玩家余额，始终反映持久化后的数值。

:gear: 配置

允许控制以下内容：

• 货币格式
• 可用命令
• 界面显示选项
• 余额保留规则

:rocket: 新架构的优势

将系统拆分为两个独立的模组提供了多种好处：

• 能够仅使用虚拟钱包，而无需 Magic Coins。
• 与遗留数据的自动兼容性：
• 在使用 Magic Coins 1.0.9 的整合包中拥有余额的玩家，在切换到 SG Economy 时将保留其余额。
• 不需要迁移脚本。
• SG Economy 经过专门适配，可识别并保留现有数据。
• 在不需要基于物品的货币的整合包中，无需额外脚本。
• 更易于维护、更新以及与其他经济相关模组集成。

:video_game: Magic Coins 的当前角色

在新架构下，Magic Coins 现在 exclusively 专注于基于实体硬币的类 RPG 游戏体验，同时依赖 SG Economy 作为其经济支柱。

Magic Coins 保留的功能

• 硬币生成 从原版结构战利品表中获得的硬币（可配置）。
• 硬币价值 每种硬币类型都有其可配置的价值。
• 物品栏界面 专用于存入和取出硬币的按钮，位置可调。 可通过配置启用可选的硬币转换按钮。
• 繁荣护符 一种可防止死亡时丢失硬币的物品。

Magic Coins 不再管理余额、命令或经济规则。它仅与 SG Economy 交互以在游戏中反映数值。

:question: 常见问题解答

如果我已经在使用 Magic Coins，是否需要安装两个模组？

是的。从 1.1.0 版本开始，Magic Coins 依赖 SG Economy API 才能运行。

如果我不想要基于物品的货币怎么办？

请仅使用 SG Economy API。 这提供了一个完全的虚拟经济，类似于 FTB StoneBlock 4 等整合包。

如果我想要所有功能怎么办？

请同时使用这两个模组：

• SG Economy 用于余额管理、命令和持久化
• Magic Coins 用于实体硬币、类 RPG 界面和特殊物品

:pushpin: 结论

Magic Coins 1.1.0 版本通过清晰地将经济逻辑与游戏机制分离，建立了一个更清晰、更模块化且可扩展的基础，为该模组在 Minecraft 模组生态系统中的未来发展做好了准备。