# 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`。