43 lines
1.9 KiB
Markdown
43 lines
1.9 KiB
Markdown
# MagicGem Reforged
|
|
|
|
MagicGem Reforged 是 MagicGem 的高版本重制版，面向 Minecraft/Paper 1.21.x（包括 1.21.11），使用 Java 21 和 Paper API。它保留原插件的非授权功能，不实现网络授权或机器绑定。
|
|
|
|
## 安装与升级
|
|
|
|
当前插件身份是 `MagicGem-Reforged`，数据目录是 `plugins/MagicGem-Reforged`。升级只支持这一条路径：
|
|
|
|
```text
|
|
原版 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](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。所有集成都采用软依赖；缺少对应插件时，只有相关条件或奖励不可用。
|
|
|
|
## 构建
|
|
|
|
```powershell
|
|
mvn clean package
|
|
```
|
|
|
|
产物位于 `target/MagicGem-Reforged-0.1.0-SNAPSHOT.jar`。
|