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