feat: initial CMagicGem reimplementation

README.md

@@ -0,0 +1,34 @@
+# CMagicGem
+
+CMagicGem 是 MagicGem 的 Paper 1.21.x 重实现，目标运行范围为 Minecraft/Paper 1.21–1.21.11。项目使用 Java 21 和 Paper API，不包含原插件的网络授权逻辑。
+
+## 安装
+
+1. 使用 Java 21 启动 Paper 1.21.x。
+2. 将 `CMagicGem-*.jar` 放入服务器的 `plugins` 目录。
+3. 保留旧插件数据时，不要删除 `plugins/MagicGem`。CMagicGem 首次启动会把尚不存在的配置安全复制到 `plugins/CMagicGem`，不会修改旧目录。
+4. 移除旧 MagicGem JAR 后启动服务器，并检查控制台中的配置加载结果。
+
+主命令是 `/cmgem`，别名是 `/cmg`。插件不会注册 `/mgem`，因此可与旧插件并存进行迁移核验。
+
+## 命令
+
+- `/cmgem reload [gem|skill]`
+- `/cmgem give <玩家> <宝石> [数量]`
+- `/cmgem apply <玩家> <宝石> [槽位]`
+- `/cmgem remove <玩家> <宝石> [槽位]`
+- `/cmgem get`、`/cmgem view`、`/cmgem embed [界面]`
+- `/cmgem signal <玩家|@all> <信号>`
+- `/cmgem material|lore|enchant|nbt`
+
+## 可选兼容
+
+按需安装 PlaceholderAPI、Vault、PlayerPoints、MythicMobs 4/5、MMOItems、MythicArtifacts/MythicCrucible、Residence、PvPManager、EcoEnchants 或 GoldenEnchants。所有集成都采用软依赖；缺少对应插件时，只有相关条件或奖励不可用。
+
+## 构建
+
+```powershell
+mvn clean package
+```
+
+产物位于 `target/cmagicgem-0.1.0-SNAPSHOT.jar`。