原创 开源 娱乐 [1.21.X]EnchantGems —— 宝石附魔强化系统 1.21.x

[MD] # EnchantGems ## 插件介绍 `EnchantGems` 是一款基于 Paper `1.21.x` 的 Minecraft 宝石强化插件。它将传统的附魔流程改造成“附魔宝石 + 强化台 GUI”的玩法：管理员可以把指定附魔与等级封装成宝石，玩家则可以在强化界面中把宝石应用到武器、工具和护甲上，完成附魔追加或等级提升。 这个插件适合生存服、RPG 服、装备成长服等需要“可视化强化系统”的场景。相比直接依赖原版附魔台或铁砧，`EnchantGems` 更容易做成活动奖励、怪物掉落、商店兑换、任务奖励等服务器内容，同时也便于服主统一控制附魔来源、等级上限和界面表现。 插件内部会将宝石数据写入 `PersistentDataContainer`，避免和普通材料混淆；在强化时还会自动校验附魔是否适用于当前装备、是否存在冲突、是否超过可配置的最高等级。配合 `config.yml`、`gems.yml` 和 `menu.yml`，你可以继续自定义宝石内容、界面布局、提示文本和整体强化体验。 ## 功能概览 - 通过 `/gem forge` 或 `/gem upgrade` 打开强化台 GUI - 通过命令生成附魔宝石并发放给玩家 - 宝石信息写入 `PersistentDataContainer`，不会和普通紫水晶碎片混淆 - 强化时自动校验附魔适用装备、附魔冲突和最高等级 - 菜单关闭或玩家掉线时自动返还未使用的物品 - 支持通过 `config.yml`、`gems.yml`、`menu.yml` 自定义语言、宝石定义和菜单布局 ## 指令 - `/gem forge`：打开宝石强化台 - `/gem upgrade`：与 `/gem forge` 相同，用于打开强化台 - `/gem give <玩家> <附魔ID> <等级>`：为指定玩家发放一个附魔宝石 - `/gem reload`：重载插件配置文件 插件别名：`/gemenhancer` ## 权限 - `gemenhancer.use`：使用强化台，默认 `true` - `gemenhancer.give`：使用发放宝石命令，默认 `op` - `gemenhancer.reload`：重载配置，默认 `op` ## 配置文件 [`config.yml`](src/main/resources/config.yml) 基础配置，包含版本号、语言和成功/失败音效。 [`gems.yml`](src/main/resources/gems.yml) 定义宝石外观、附魔显示名、最大等级和是否启用。 [`menu.yml`](src/main/resources/menu.yml) 定义强化台标题、布局和图标显示。 ## 界面预览 ### 强化台界面 [ATTACH]132449[/ATTACH] ### 宝石展示 [ATTACH]132450[/ATTACH] ## 支持的附魔输入 `/gem give` 支持两种输入方式： - 旧版常量名，例如 `DAMAGE_ALL` - 命名空间 ID，例如 `minecraft:sharpness` 或 `sharpness` 默认已预设常见护甲、武器、工具、弓弩、三叉戟、狼牙棒与钓鱼竿附魔，具体列表见 [`gems.yml`](src/main/resources/gems.yml)。 ## 运行环境 - Paper `1.21.x` - Java `21` ## 构建 ```bash mvn clean package ``` 构建完成后，成品 jar 默认位于： ```text target/EnchantGems-1.0-shaded.jar ``` ## 安装 1. 将构建后的 jar 放入服务器的 `plugins/` 目录。 2. 启动服务器生成配置文件。 3. 按需修改配置后执行 `/gem reload` 或重启服务器。 [/MD]