# MaxEnchant
一个轻量级的 Minecraft Bukkit/Spigot 插件,可以为物品应用最高的生存可获得(原版)附魔。
## 描述
MaxEnchant 会自动将所有适用的正面附魔添加到物品上,同时尊重原版兼容性和相互排斥的附魔。 它会排除诅咒附魔,并使用偏好顺序来解决冲突(例如,锋利 vs 穿刺,幸运 vs 丝绸之触)。
## 特点
- 为您主手中物品应用最大生存可获得的附魔。
- 使用单个命令为玩家的整个物品栏(包括盔甲和副手)应用最大附魔。
- 尊重原版附魔冲突,并排除诅咒(绑定 & 消失)。
- 相互排斥附魔的偏好顺序(在代码中配置)。
- 物品栏参数(`inv`)的 Tab 补全。
- 使用十六进制颜色支持的彩色消息,适用于现代服务器版本。
## 指令
- `/maxenchant` (别名: `/maxench`, `/enchantmax`)
- 无参数:为手中的物品附魔。
- `inv`: 为玩家物品栏、盔甲和副手中的所有可附魔物品附魔。
示例:
- `/maxenchant` — 最大化你所持物品的附魔。
- `/maxench inv` — 最大化整个物品栏的附魔。
## 权限
- `maxenchant.use` — 运行此命令所需的权限(默认:op)。
## 安装
1. 构建插件(Gradle/Maven 或使用 `build/libs` 文件夹中提供的 JAR 文件)。
2. 将生成的 `MaxEnchants-.jar` 放入服务器的 `plugins/` 文件夹中。
3. 启动或重启服务器。
插件主类和命令在 `plugin.yml` 中声明:
- main: `vadlox.dev.maxEnchants.MaxEnchants`
- api-version: `1.19`
## 配置
所有冲突解决偏好都在代码中定义(`getPreferenceOrder()` 方法)。 如果您想要不同的优先级规则,请编辑该方法并重新编译。
## 开发
- 建议使用 Java 17+,具体取决于您的服务器构建。
- 该项目使用 Bukkit/Spigot API。
使用 Gradle 构建(示例):
- `./gradlew build` (或在 Windows 上使用 `gradlew.bat build`)
## 故障排除
- 如果命令没有任何操作,请验证您是否具有 `maxenchant.use` 权限或是否为 OP。
- 如果某些物品上的附魔没有应用,它们可能不符合原版规则,无法附魔。
## 贡献
欢迎提出拉取请求和问题。 如有必要,调整偏好顺序或改进兼容性处理。
## 许可
在此文件中或单独的 `LICENSE` 文件中包含您喜欢的许可协议。 (默认情况下未指定许可协议。)