35 lines
1.4 KiB
Markdown
35 lines
1.4 KiB
Markdown
# 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`。
|