- 版权类型
- 原创
- 插件中文名称
- AL祛魔
- 插件英文名称
- ALDisenchant
- 原帖地址
- #
- 支持的核心（服务端）
- Paper
- Folia
- Purpur
- 语言支持
- 中文（简体）
- 前置组件
- 无
- 适配版本（Java）
- 最新版本
- 26.x
- 1.21
ALDisenchant
GUI祛魔 / 原生附魔书 / 品质概率 / 祛魔石与幸运石 / Aiyatsbus 与 EcoEnchants 兼容
不是简单改名和改 lore，而是一套围绕装备附魔祛除设计的可配置 GUI 系统。
适用于：生存服 / RPG服 / 养老服 / 经济服 / 附魔强化服 / Folia 或 Luminol 服务端
购买插件送UI配置与幸运石，拆卸石纹理
GUI祛魔 / 原生附魔书 / 品质概率 / 祛魔石与幸运石 / Aiyatsbus 与 EcoEnchants 兼容
不是简单改名和改 lore，而是一套围绕装备附魔祛除设计的可配置 GUI 系统。
适用于：生存服 / RPG服 / 养老服 / 经济服 / 附魔强化服 / Folia 或 Luminol 服务端
购买插件送UI配置与幸运石，拆卸石纹理
插件简介
ALDisenchant 是一款面向 Paper / Purpur / Folia / Luminol 等服务端的 GUI 祛魔插件。玩家可以在菜单中选择背包装备、祛魔石和幸运石，然后点击要祛除的附魔，按配置扣除金币或点券，并把成功祛除的附魔生成原生附魔书。
插件的交互不是把玩家物品真正塞进 GUI 容器，而是“点击背包物品进行选择”。装备、祛魔石和幸运石始终留在玩家背包中，GUI 只显示它们的克隆预览。祛魔成功时，玩家背包里原槽位的装备会同步变化；祛魔石和幸运石也会从玩家背包原槽位消耗。
这种方式可以避免普通 GUI 插件常见的停服、重载、断线时物品留在菜单里导致吞物品的问题。正常关闭服务器或重载插件时，GUI 中没有真实玩家物品需要返还。
- GUI 显示装备附魔，玩家点击附魔条目即可尝试祛除
- 玩家只需要点击背包里的装备、祛魔石、幸运石进行选择，不需要把物品放入 GUI
- 成功时生成原生附魔书，不额外改名，不额外写 lore
- 支持普通祛魔石、无损祛魔石、一级到三级幸运石
- 支持 Vault 金币、PlayerPoints 点券，也可以配置为不扣费
- 支持 1-7 级品质规则，每个品质直接配置价格、成功率和成书无损率
- 支持原版附魔、Aiyatsbus、EcoEnchants 的附魔读取与品质显示
- 支持附魔白名单 / 黑名单，无法祛除的附魔会在 GUI 中显示屏障
- 支持 CraftEngine、ItemsAdder、Oraxen、CustomModelData 自定义 GUI 图标和插件物品材质
- 插件生成的祛魔石 / 幸运石不能改名，不能用于合成、自动合成、锻造、附魔台等功能型容器
核心亮点
| 模块 | 说明 | 适合场景 |
|---|---|---|
| 背包点击选择 | 点击背包里的装备、祛魔石、幸运石后，GUI 只显示克隆预览，真实物品仍在背包 | 减少 GUI 吞物品风险 |
| 原生附魔书 | 祛魔成功后生成 Bukkit 原生存储附魔书，不使用改名书或 lore 伪装书 | 兼容铁砧、交易、其他原版逻辑 |
| 更多附魔兼容 | 支持 Aiyatsbus 与 EcoEnchants 读取附魔名称、等级和品质信息 | 更多附魔服务器 |
| 品质概率 | 内置 1-7 级品质，每个品质独立设置价格、祛除成功率、成书无损率 | 控制经济消耗和高品质附魔风险 |
| 祛魔石系统 | 可配置是否必须选择祛魔石，内置普通祛魔石和无损祛魔石 | 道具消耗、商城、活动奖励 |
| 幸运石系统 | 一级到三级幸运石，可增加祛除成功率和成书无损率 | 给玩家提供概率提升手段 |
| 经济扣费 | 支持 Vault、PlayerPoints、NONE 三种扣费模式 | 金币服、点券服、免费服 |
| 附魔过滤 | 支持白名单和黑名单，限制指定附魔是否允许祛除 | 保护核心附魔、活动附魔、特殊附魔 |
| 装备过滤 | 可按材质、物品名、lore 关键词限制哪些装备允许祛魔 | 绑定装备、礼包装备、活动装备保护 |
| 自定义材质 | GUI 图标和插件石头支持原版物品、CustomModelData、CraftEngine、ItemsAdder、Oraxen | 资源包服、RPG服、美化菜单 |
| 插件物品保护 | 祛魔石和幸运石带插件标记，禁止改名、合成、自动合成、锻造、附魔台等误用 | 防止玩家把功能道具当普通材料使用 |
| Folia 兼容 | 插件声明支持 Folia，调度逻辑按服务端环境处理 | Folia / Luminol 区域线程服务端 |
玩家如何使用
打开祛魔菜单：
代码：
/aldisenchant
/alqm基础流程：
- 打开 GUI 后，点击背包里要祛魔的装备
- 如果配置要求祛魔石，点击背包里的普通祛魔石或无损祛魔石
- 如果想提高概率，点击背包里的幸运石
- GUI 上方会显示当前选择的装备、祛魔石、幸运石
- 下方 D 位会显示装备上可祛除的附魔
- 点击某个附魔后，插件按品质配置计算费用、成功率和成书无损率
- 成功时，装备原背包槽位同步移除该附魔，并获得原生附魔书
- 失败时，装备附魔保留，但按配置仍可消耗费用、祛魔石和幸运石
小提示：
- 点击 GUI 上方的装备 / 祛魔石 / 幸运石展示格，可以取消对应选择
- 祛魔成功后，如果背包满了，附魔书会掉落在玩家脚下
- 如果附魔本身最高等级只有 1 级，例如无限，附魔书显示为“无限”，不会显示“无限 I”
祛魔石与幸运石
| 物品 | 默认材质 | 作用 | 命令参数 |
|---|---|---|---|
| 普通祛魔石 | AMETHYST_SHARD | 用于普通祛魔，成功后附魔书可能降低等级 | stone normal |
| 无损祛魔石 | ECHO_SHARD | 祛魔成功时，附魔书强制保持原等级 | stone lossless |
| 一级幸运石 | LAPIS_LAZULI | 默认成功率 +10%，成书无损率 +5% | lucky 1 |
| 二级幸运石 | EMERALD | 默认成功率 +20%，成书无损率 +10% | lucky 2 |
| 三级幸运石 | NETHER_STAR | 默认成功率 +30%，成书无损率 +15% | lucky 3 |
配置文件：
代码：
plugins/ALDisenchant/stones/disenchant.yml
plugins/ALDisenchant/stones/lucky.yml服主可以在这两个文件里修改材质、名称、lore、成功率加成、无损率加成，以及是否每次尝试都消耗。
品质与概率
插件不强制服主使用复杂公式。每个品质等级可以直接配置价格、祛除成功率、成书无损率。
| 等级 | 默认品质 | 默认价格 | 默认成功率 | 默认无损率 |
|---|---|---|---|---|
| 1 | 普通 | 500 | 80% | 70% |
| 2 | 优秀 / 罕见 | 900 | 73% | 65% |
| 3 | 精良 / 稀有 | 1300 | 66% | 60% |
| 4 | 史诗 / 皮肤 | 1700 | 59% | 55% |
| 5 | 传奇 / 传说 | 2100 | 52% | 50% |
| 6 | 特殊 / 稀世 | 2500 | 46% | 45% |
| 7 | 极特殊 / 非常特殊 / 神话 / 神器 / 诅咒 | 3000 | 40% | 40% |
配置示例：
代码：
disenchant:
default-quality: '1'
quality-levels:
1:
display-name: '普通'
price: 500
success-chance: 0.80
lossless-chance: 0.70
7:
display-name: '极特殊/神话/神器/诅咒'
price: 3000
success-chance: 0.40
lossless-chance: 0.40原版附魔品质：
原版 Minecraft 附魔本身没有品质字段。服主可以在 `vanilla-quality-overrides` 里把原版附魔分配到 1-7 级品质。没有写到的原版附魔会使用 `disenchant.default-quality`。
代码：
vanilla-quality-overrides:
'1':
- 'protection'
- 'efficiency'
- 'sharpness'
- 'power'
'4':
- 'mending'
- 'swift_sneak'更多附魔兼容
ALDisenchant 当前支持以下附魔来源：
| 来源 | 支持内容 | 说明 |
|---|---|---|
| 原版 Bukkit 附魔 | 读取附魔、等级、移除附魔、生成原生附魔书 | 原版附魔品质由配置映射 |
| Aiyatsbus | 读取更多附魔名称、等级、品质显示 | GUI 名称和品质颜色尽量跟随 Aiyatsbus 配置 |
| EcoEnchants | 读取 Eco 系列附魔名称、等级、品质显示 | GUI 名称和品质颜色尽量跟随 Eco 配置 |
注意：
- 插件不兼容纯 lore 附魔插件，不会用正则去猜普通 lore 里的附魔
- 真实 Bukkit 附魔会生成原生附魔书
- 如果某个更多附魔插件没有提供可读取的品质，插件会按配置关键词和默认品质兜底
- 附魔显示名称会尽量使用附魔插件自己的中文名，而不是技术 ID
附魔白名单与黑名单
服主可以控制哪些附魔允许祛除，哪些附魔禁止祛除。命中限制的附魔不会作为可点击附魔显示，而是在 D 位显示屏障，并提示“该附魔无法祛除”。
代码：
enchant-filter:
whitelist:
enabled: false
keywords: []
blacklist:
enabled: false
keywords:
- '无双'- 白名单开启后，只有关键词匹配到的附魔可以祛除
- 黑名单开启后，关键词匹配到的附魔不能祛除
- 关键词会匹配附魔名字、原始 ID、显示名
- 拥有 `aldisenchant.bypass` 权限的玩家可以绕过过滤限制
自定义材质与菜单图标
GUI、祛魔石、幸运石都支持自定义材质。`gui.yml` 顶部已经写好完整示例。
代码：
# 原版物品
type: 'BEACON'
# 资源包 CustomModelData
type: 'PAPER'
custom_model_data: 10001
# CraftEngine 自定义物品
craftengine: 'namespace:item_id'
ce: 'namespace:item_id'
# ItemsAdder 自定义物品
itemsadder: 'namespace:item_id'
ia: 'namespace:item_id'
# Oraxen 自定义物品
oraxen: 'item_id'
# 兼容旧写法
plugin_item: 'ce:namespace:item_id'
plugin_item: 'ia:namespace:item_id'
plugin_item: 'oraxen:item_id'
type: 'ce:namespace:item_id'
material: 'craft-engine-main:item_id'如果不安装 CraftEngine / ItemsAdder / Oraxen，插件仍然可以使用原版材质和 CustomModelData。
插件物品保护
插件生成的祛魔石和幸运石会带有专属标记。即使它们使用青金石、绿宝石、下界之星等原版材质，也不会被当成普通材料使用。
| 保护项 | 说明 |
|---|---|
| 禁止改名 | 不能通过铁砧把插件石头改成其他名字 |
| 禁止合成 | 不能放入工作台参与合成 |
| 禁止自动合成 | 不能被 Crafter 自动合成器当材料消耗 |
| 禁止村民交易 | 例如祛魔石使用绿宝石材质时，也不能被村民交易当普通绿宝石消耗 |
| 禁止附魔台材料 | 例如幸运石使用青金石材质时，也不能放进附魔台当青金石使用 |
| 禁止功能容器 | 拦截锻造台、砂轮、熔炉、酿造台、切石机等功能型容器 |
普通同材质物品不受影响，只有插件生成且带标记的祛魔石 / 幸运石会被保护。
安装说明
推荐环境：
| 项目 | 说明 |
|---|---|
| Java | Java 21 |
| 服务端 | Paper / Purpur / Folia / Luminol 等 1.21.x 服务端 |
| 经济 | Vault + 经济插件，或 PlayerPoints，也可以配置 NONE 不扣费 |
| 更多附魔 | 可选安装 Aiyatsbus / EcoEnchants |
安装步骤：
- 将 `ALDisenchant-1.0.0.jar` 放入服务器 `plugins` 文件夹
- 启动服务器，生成 `plugins/ALDisenchant/` 配置目录
- 按需求修改 `config.yml`、`gui.yml`、`messages.yml`
- 如需调整祛魔石和幸运石，修改 `stones/disenchant.yml` 与 `stones/lucky.yml`
- 如果使用经济扣费，请安装 Vault + 经济插件，或安装 PlayerPoints
- 使用 `/alqm reload` 重载配置，或重启服务器
生成的配置文件：
代码：
plugins/ALDisenchant/config.yml
plugins/ALDisenchant/gui.yml
plugins/ALDisenchant/messages.yml
plugins/ALDisenchant/stones/disenchant.yml
plugins/ALDisenchant/stones/lucky.yml依赖与兼容
| 依赖 | 是否必须 | 用途 |
|---|---|---|
| Vault + 经济插件 | 可选 | 使用金币扣费 |
| PlayerPoints | 可选 | 使用点券扣费 |
| Aiyatsbus | 可选 | 读取更多附魔名称、等级和品质 |
| EcoEnchants | 可选 | 读取 Eco 系列附魔名称、等级和品质 |
| CraftEngine | 可选 | 自定义 GUI 图标和插件物品 |
| ItemsAdder | 可选 | 自定义 GUI 图标和插件物品 |
| Oraxen | 可选 | 自定义 GUI 图标和插件物品 |
不安装可选依赖时，原版附魔、原版材质、基础 GUI 和不扣费模式仍可正常使用。
常用命令
代码：
/aldisenchant
/alqm
/aldisenchant reload
/aldisenchant give stone [normal|lossless] [玩家] [数量]
/aldisenchant give lucky [1|2|3] [玩家] [数量]| 命令 | 说明 | 权限 |
|---|---|---|
| /aldisenchant | 打开祛魔 GUI | aldisenchant.use |
| /alqm | 打开祛魔 GUI，主命令别名 | aldisenchant.use |
| /aldisenchant reload | 重载配置、语言、GUI、祛魔石和幸运石配置 | aldisenchant.admin |
| /aldisenchant give stone [normal|lossless] [玩家] [数量] | 给予普通祛魔石或无损祛魔石 | aldisenchant.admin |
| /aldisenchant give lucky [1|2|3] [玩家] [数量] | 给予一级到三级幸运石 | aldisenchant.admin |
`give` 命令支持在线玩家名 Tab 补全。
常用权限
| 权限 | 默认 | 说明 |
|---|---|---|
| aldisenchant.use | 所有玩家 | 允许打开祛魔 GUI |
| aldisenchant.admin | OP | 允许重载配置和给予插件物品 |
| aldisenchant.bypass | OP | 绕过装备过滤和附魔白名单 / 黑名单限制 |
适合购买的人群
- 你希望玩家可以通过 GUI 把装备附魔祛除成附魔书
- 你希望祛魔过程接入金币、点券或道具消耗
- 你希望高品质附魔更贵、更难祛除，形成服务器经济消耗
- 你正在使用 Aiyatsbus 或 EcoEnchants，需要显示更多附魔的中文名和品质
- 你希望用祛魔石、无损祛魔石、幸运石做商城、活动或副本奖励
- 你需要附魔白名单 / 黑名单，保护特殊附魔不能被取出
- 你需要 Folia / Luminol 兼容
- 你需要 CraftEngine / ItemsAdder / Oraxen 自定义材质支持
不太适合的人群
- 你只需要原版砂轮式去附魔，不需要附魔书产出
- 你使用的是纯 lore 附魔插件，并且没有 Bukkit 附魔数据
- 你不想配置经济、品质概率、祛魔石或幸运石
- 你希望所有附魔都 100% 免费、无损取出
购买前建议：
- 确认服务器使用 Java 21
- 确认服务端为 Paper / Purpur / Folia / Luminol 等 1.21.x 兼容服务端
- 如果要使用金币扣费，请安装 Vault 和经济插件
- 如果服务器的 Vault 版本无法在 Folia 加载，请改用 PlayerPoints 或 NONE，或更换 Folia 可用的经济桥
- 如果要读取更多附魔，请确认 Aiyatsbus / EcoEnchants 已正确安装并能正常显示附魔
- 更新前建议备份 `plugins/ALDisenchant/` 配置目录
更新与配置注意事项
- 插件默认不兼容纯 lore 附魔插件，只读取原版 Bukkit 附魔、Aiyatsbus、EcoEnchants
- 原版附魔没有品质字段，需要通过 `vanilla-quality-overrides` 配置兜底品质
- `disenchant.default-quality` 用于没有识别到品质时的默认品质等级，建议填写 1-7
- 祛魔石和幸运石配置已经拆分到 `stones/` 文件夹
- GUI 和石头材质支持 `type`、`custom_model_data`、`craftengine`、`ce`、`itemsadder`、`ia`、`oraxen`
- 插件石头的保护只作用于插件生成的物品，不影响普通同材质物品
- GUI 只显示玩家背包中选中物品的克隆预览，不会把真实物品放入菜单容器
ALDisenchant 1.0.0
让祛魔不再只是删除附魔，而是成为服务器经济、道具和附魔体系的一部分。
让祛魔不再只是删除附魔，而是成为服务器经济、道具和附魔体系的一部分。
