Rename plugin to MagicGem Reforged

README.md

@@ -1,21 +1,23 @@
-# MagicGem
+# MagicGem Reforged
 
-MagicGem 是面向 Minecraft/Paper 1.21.x（包括 1.21.11）的插件重实现，使用 Java 21 和 Paper API。它保留原插件的非授权功能，不实现网络授权或机器绑定。
+MagicGem Reforged 是 MagicGem 的高版本重制版，面向 Minecraft/Paper 1.21.x（包括 1.21.11），使用 Java 21 和 Paper API。它保留原插件的非授权功能，不实现网络授权或机器绑定。
 
-## 安装与迁移
+## 安装与升级
 
-1. 停止服务器并备份整个服务器目录，尤其是 `plugins/MagicGem`、`plugins/CMagicGem` 和玩家数据。
-2. 使用 Java 21 启动 Paper 1.21.x，将新 JAR 放入 `plugins`，移除旧 MagicGem JAR。不要同时加载新旧 JAR。
-3. 如果有 `plugins/MagicGem`，新版本会沿用它作为主数据目录，宝石、技能、GUI、语言、配置和已有物品按原路径继续读取。
-4. 如果还保留先前重实现的 `plugins/CMagicGem`，新版本会将其中的 `gems`、`skills`、`gui`、`languages` 和 `config.yml` 导入 `plugins/MagicGem`。缺失文件和 YAML 配置项会自动补入。
-5. 两个目录有同名冲突时，`plugins/MagicGem` 的值优先；冲突的 `CMagicGem` 原文件副本会写入 `plugins/MagicGem/migration-backup/CMagicGem`。源 `plugins/CMagicGem` 保持不变，迁移完成后会写入 `.migration-cmagicgem-v1.complete` 标记，避免每次启动重复导入。
-6. 启动后检查控制台的导入数量、冲突提示和配置加载结果。确认一切正常前，请保留备份和旧数据目录。
+当前插件身份是 `MagicGem-Reforged`，数据目录是 `plugins/MagicGem-Reforged`。升级只支持这一条路径：
 
-原版 `MagicGem` 数据已经在 `plugins/MagicGem` 时无需复制或重命名目录。物品读取兼容原版 `MAGICGEM_*` NBT 和先前 `CMagicGem` 的 PDC 数据，并继续写入原版 NBT 字段以兼容升级过程。
+```text
+原版 MagicGem → MagicGem Reforged
+plugins/MagicGem → plugins/MagicGem-Reforged
+```
 
-完整迁移步骤、目录合并规则、冲突备份、物品兼容和回滚流程见 [MIGRATION.md](MIGRATION.md)。
+升级前停止服务器并备份整个服务器，尤其是 `plugins/MagicGem`、世界目录和玩家数据。移除旧 MagicGem JAR，放入新 JAR，保留 `plugins/MagicGem`，然后启动服务器。
 
-主命令是 `/mgem`，并提供 `/cmgem` 和 `/cmg` 别名。
+首次启动时，插件会把原版目录中的 `config.yml`、`gems/`、`skills/`、`gui/` 和 `languages/` 复制到 `plugins/MagicGem-Reforged`。原版目录不会删除。如果目标文件已经存在，目标文件优先，发生冲突时旧文件会保存到 `plugins/MagicGem-Reforged/migration-backup/MagicGem/`。
+
+完整的升级顺序、文件处理、物品数据兼容和回滚流程见 [MIGRATION.md](MIGRATION.md)。
+
+主命令是 `/mgem`，并提供 `/cmgem` 和 `/cmg` 别名。原版物品中的 `MAGICGEM_NAME`、`MAGICGEM_EMBED` 和 `MAGICGEM_SKILL` 会继续兼容。
 
 ## 命令
 
@@ -37,4 +39,4 @@ MagicGem 是面向 Minecraft/Paper 1.21.x（包括 1.21.11）的插件重实现
 mvn clean package
 ```
 
-产物位于 `target/cmagicgem-0.1.0-SNAPSHOT.jar`。
+产物位于 `target/MagicGem-Reforged-0.1.0-SNAPSHOT.jar`。