MagicGem-Reforged/README.md

MagicGem Reforged

MagicGem Reforged 是 MagicGem 的高版本重制版，面向 Minecraft/Paper 1.21.x（包括 1.21.11），使用 Java 21 和 Paper API。它保留原插件的非授权功能，不实现网络授权或机器绑定。

安装与升级

当前插件身份是 MagicGem-Reforged，数据目录是 plugins/MagicGem-Reforged。升级只支持这一条路径：

原版 MagicGem → MagicGem Reforged
plugins/MagicGem → plugins/MagicGem-Reforged

升级前停止服务器并备份整个服务器，尤其是 plugins/MagicGem、世界目录和玩家数据。移除旧 MagicGem JAR，放入新 JAR，保留 plugins/MagicGem，然后启动服务器。

首次启动时，插件会把原版目录中的 config.yml、gems/、skills/、gui/ 和 languages/ 复制到 plugins/MagicGem-Reforged。原版目录不会删除。如果目标文件已经存在，目标文件优先，发生冲突时旧文件会保存到 plugins/MagicGem-Reforged/migration-backup/MagicGem/。

完整的升级顺序、文件处理、物品数据兼容和回滚流程见 MIGRATION.md。

主命令是 /mgem。原版物品中的 MAGICGEM_NAME、MAGICGEM_EMBED 和 MAGICGEM_SKILL 会继续兼容。

命令

• /mgem reload [gem|skill]
• /mgem give <玩家> <宝石> [数量]
• /mgem apply <玩家> <宝石> [槽位]
• /mgem remove <玩家> <宝石> [槽位]
• /mgem get、/mgem view、/mgem embed [界面]
• /mgem signal <玩家|@all> <信号>
• /mgem material|lore|enchant|nbt

可选兼容

按需安装 PlaceholderAPI、Vault、PlayerPoints、MythicMobs 4/5、MMOItems、MythicArtifacts/MythicCrucible、Residence、PvPManager、EcoEnchants 或 GoldenEnchants。所有集成都采用软依赖；缺少对应插件时，只有相关条件或奖励不可用。

构建

mvn clean package

产物位于 target/MagicGem-Reforged-1.0.0.jar。