原创 - 付费 - 闭源 - EnchantManager - 分离、分解、强化附魔管理

版权类型: 原创

插件中文名称: EnchantManager

插件英文名称: EnchantManager

原帖地址: #

支持的核心（服务端）

Paper
Folia
Purpur
Leaves
其他核心

语言支持: 中文（简体）

前置组件: Aiyatsbus[可选]、EcoEnchants[可选]、MeowsEnchants[可选]、EnchantmentReform[可选]、ExcellentEnchants[可选]、CraftEngine[可选]、ItemsAdder[可选]、MMOItems[可选]、MythicMobs[可选]、NeigeItems[可选]、Nexo[可选]、Oraxen[可选]、PlaceholderAPI[可选]、PlayerPoints[可选]、Vault[可选]

适配版本（Java）

最新版本
26.x
1.21
1.20

EnchantManager —— 附魔分离 / 分解 / 强化一体化管理插件

为 Paper / Folia 1.21+ 设计的完整附魔经济循环：玩家可以分离附魔成书、分解附魔书换材料、消耗材料强化附魔等级。原版附魔与第三方附魔统一管理，支持多经济收费、品质分级与权限组折扣。

插件信息

插件名称：EnchantManager
当前版本：1.7.1
适用服务端：Paper / Folia 1.21 ~ 26.2
运行环境：Java 21+
插件类型：附魔管理 / 经济消耗类
语言支持：简体中文（默认）、English
命令别名：/enchantmanager、/emanager、/em
Q群：1102249149

软依赖

经济：Vault（金币）、PlayerPoints（点券）——不装也能用内置的经验 / 等级经济
第三方附魔：CraftEngine、ExcellentEnchants、Aiyatsbus、EcoEnchants、MeowsEnchants、EnchantmentReform
物品 / 占位符：ItemsAdder、Oraxen、Nexo、MMOItems、NeigeItems、MythicMobs、PlaceholderAPI

核心功能

1. 附魔分离（Disenchant）

将物品上的附魔分离为附魔书，保留物品本体；
每个附魔独立配置成功率与保护率（灵材护印：失败时保留材料与幸运石，经济照常扣除）；
支持祛魔石：本次判定完全不消耗经济、点券、经验与材料；
分离成功后按原版Prior Work Penalty 逆公式回调一级铁砧惩罚（典型过程 31 → 15 → 7 → 3 → 1 → 0），不破坏原版附魔平衡；
分离失败按配置消耗本次常规材料与经济费用（可配置，系统级事务故障除外）。

2. 附魔分解（Decompose）

将达到等级上限的附魔书分解为附魔精粹（dust）等材料；
奖励按附魔等级逐级配置，品质越高材料越稀有；
未达上限的附魔书会明确提示，防止误操作。

3. 附魔强化（Enhance）

消耗材料 + 经济，将物品附魔提升至更高等级；
超过附魔真实最大等级自动拦截（成功率达到上限）；
强化失败不扣材料、保留原等级；成功率为 0% 的附魔直接禁止操作；
每个附魔支持独立的强化材料（materials-mode: REPLACE），也可动态继承品质材料（INHERIT）。

4. 附魔品质系统（7 级）

普通 common → 稀有 uncommon → 罕见 rare → 史诗 epic → 传说 legendary → 特殊 special → 非常特殊 veryspecial

每个品质自带强化 / 分离 / 分解的等级锚点模板；
模板只是平衡锚点，自动生成时会按附魔真实起始 / 最大等级逐级展开，不会生成不存在的等级规则（如保护 IV 只生成到 4，经验修补 I 默认关闭强化）。

5. 自动生成配置（省心开箱）

启动时自动扫描 Bukkit/Paper 已注册的原版 + 第三方附魔，识别来源与品质后生成 enchantments/（附魔名）.yml；
生成文件使用 materials-mode: REPLACE，之后可独立修改，不会被品质模板覆盖；
旧版配置目录自动迁移，无需手动搬运。

6. 多经济收费（事务级安全）

内置经济：vault（金币）、points（点券）、exp（经验）、levels（等级）；
支持自定义命令经济（如星币），且必须同时配置 take-commands 与 refund-commands，保证事务回滚时能全额退款；
费用不足 / 服务不可用 / 退款失败均有明确提示，退款失败会告警管理员。

7. 权限组折扣（VIP 经营）

default / vip / svip / mvp 权限组，可按组配置：
- 货币倍率（如 VIP 95 折）
- 材料倍率
- 分离成功率 / 保护率加成
- 强化成功率加成
玩家同时拥有多组权限时自动采用最高优先级组。

8. 操作安全与恢复

每个附魔操作为串行事务：操作安全记录 → 提交 → 审计，防重复发放；
服务器中断时进入恢复队列，玩家重新进服自动补偿；结果不确定时进入手动审查，绝不重复发放物品。

9. 诊断与调试

/em debug status、providers、config、recovery、transaction、retry、performance、enchant、item、on、off、test、traces
在线查看第三方附魔 Provider 状态、活动事务 Trace、恢复队列，方便排查问题。

命令列表

/enchantmanager help —— 查看命令帮助（所有人）
/enchantmanager disenchant —— 打开附魔分离界面（enchantmanager.disenchant，默认 true）
/enchantmanager decompose —— 打开附魔分解界面（enchantmanager.decompose，默认 true）
/enchantmanager enhance —— 打开附魔强化界面（enchantmanager.enhance，默认 true）
/enchantmanager give（物品ID）（玩家）（数量） —— 发放插件物品（精粹 / 附魔石 / 幸运石等）（enchantmanager.admin）
/enchantmanager reload —— 重载全部配置与语言（enchantmanager.admin）
/enchantmanager debug（status / providers / config / recovery / transaction / retry / performance / enchant / item / on / off / test / traces） —— 运行状态与故障诊断（enchantmanager.debug）

别名：/emanager、/em

权限列表

enchantmanager.disenchant —— 使用分离功能（默认 true）
enchantmanager.decompose —— 使用分解功能（默认 true）
enchantmanager.enhance —— 使用强化功能（默认 true）
enchantmanager.group.vip —— VIP 组（折扣与成功率加成，默认 false）
enchantmanager.group.svip —— SVIP 组（默认 false）
enchantmanager.group.mvp —— MVP 组（默认 false）
enchantmanager.admin —— 管理命令（默认 op）
enchantmanager.debug —— 调试命令（默认 op）

配置结构（首次启动自动生成）

代码：

plugins/EnchantManager/
├─ config.yml                 # 主配置：语言 / 品质系统 / 自动生成 / 诊断
├─ groups.yml                 # 权限组倍率（货币、材料、成功率加成）
├─ currencies.yml             # 多经济定义（内置 vault/points/exp/levels + 自定义命令经济）
├─ rarities/                  # 7 个品质模板（强化 2/4/6、分离 1/3/5、分解 1/3/5 锚点）
├─ enchantments/              # 每个附魔独立配置（启动自动生成，可单独修改）
├─ items/                     # 插件物品：附魔精粹 dust1-7、附魔石、幸运石、祛魔石
├─ menus/                     # 强化 / 分离 / 分解 三个 GUI
└─ languages/                 # zh_CN.yml / en_US.yml

配置示例（真实模板）

品质模板 rarities/common.yml（普通品质锚点）

YAML：

id: common
display-name: "普通"
order: 10
keywords: ["common", "普通"]

operations:
  enhancement:
    # 强化成功率与材料按“强化后的目标等级”匹配（锚点 2/4/6）
    success-rate-by-level:
      "2": 0.95
      "4": 0.90
      "6": 0.82
    materials-by-level:
      "2":
        - "dust1 2"
        - "LAPIS_LAZULI 4"
      "4":
        - "dust1 5"
        - "LAPIS_LAZULI 8"
        - "IRON_INGOT 1"
      "6":
        - "dust1 10"
        - "LAPIS_LAZULI 16"
        - "IRON_INGOT 3"

  disenchant:
    # 分离成功率 / 保护率 / 经济消耗 / 材料按“当前附魔等级”匹配（锚点 1/3/5）
    success-rate-by-level:
      "1": 0.88
      "3": 0.82
      "5": 0.74
    protection-rate-by-level:
      "1": 0.78
      "3": 0.72
      "5": 0.64
    costs-by-level:
      "1":
        vault: 0
        points: 0
        exp: 40
        levels: 0
      "5":
        vault: 0
        points: 0
        exp: 90
        levels: 0
    materials-by-level:
      "1":
        - "BOOK 1"
        - "dust1 1"
      "5":
        - "BOOK 1"
        - "dust1 6"
        - "inscription_stone 1"
        - "LAPIS_LAZULI 4"

  decomposition:
    # 分解奖励按“当前附魔等级”匹配；格式：物品ID 最小数量-最大数量 概率
    rewards-by-level:
      "1":
        - "dust1 1-2 1"
      "5":
        - "dust1 4-7 1"

自动生成单附魔配置时，会读取该附魔的真实起始 / 最大等级，把上面的锚点逐级展开成实际等级规则；不会为锋利 V 生成不存在的 6 级规则，也不会突破附魔原生等级上限。

单附魔配置 enchantments/sharpness.yml（自动生成示例）

YAML：

enchant: minecraft:sharpness
rarity: common

metadata:
  native-max-level: 5
  generated: true

operations:
  enhancement:
    enabled: true
    success-rate: 0.90
    materials-mode: REPLACE        # 强化材料独立，不再跟随品质模板
    materials-by-level:
      "2":
        - "dust1 2"
        - "FLINT 6"
      "4":
        - "dust1 5"
        - "FLINT 11"
        - "IRON_INGOT 2"
      "5":
        - "dust1 8"
        - "FLINT 14"
        - "IRON_INGOT 4"
  disenchant:
    enabled: true
    success-rate: 0.82
    protection-rate: 0.72
    costs:
      vault: 0
      points: 0
      exp: 60
      levels: 0
    materials:
      - "BOOK 1"
      - "dust1 2"
      - "inscription_stone 1"
  decomposition:
    enabled: true
    rewards:
      - "dust1 2-3 1"

权限组 groups.yml（VIP 折扣示例）

YAML：

groups:
  default:
    priority: 0
    permission: null
    modifiers:
      currency-multiplier: 1.0
      material-multiplier: 1.0
      disenchant-success-chance-add: 0.0
      disenchant-protection-chance-add: 0.0
      enhance-success-chance-add: 0.0
  vip:
    priority: 100                 # 优先级更高，多个组时取最高
    permission: enchantmanager.group.vip
    modifiers:
      currency-multiplier: 0.95   # 经济 95 折
      material-multiplier: 1.0
      disenchant-success-chance-add: 0.03   # 分离成功率 +3%
      disenchant-protection-chance-add: 0.02 # 保护率 +2%
      enhance-success-chance-add: 0.03      # 强化成功率 +3%

插件物品 items/dust.yml（附魔精粹示例）

YAML：

# 普通附魔精粹
dust1:
  material: "GLOWSTONE_DUST"
  custom-model-data: 1001
  name: "&f普通附魔精粹"
  lore: "&7用于普通品质的强化与分离"

安装说明

将 EnchantManager-1.7.1.jar 放入 plugins/ 目录；
重启服务器（或使用 PlugMan 类插件热加载）；
插件自动扫描已注册附魔并生成配置，无需手动编写；
按需修改 rarities/、enchantments/、groups.yml、currencies.yml 后执行 /em reload。

截图

（发帖前请补充：分离界面 / 分解界面 / 强化界面 / 附魔书示例 / 配置目录示例）

更新日志（1.7.1 要点）

附魔真实等级自动生成：原版与第三方附魔按自身真实起始 / 最大等级展开规则，不再固定生成到 5/6 级；
品质锚点模板：强化 2/4/6、分离 1/3/5、分解 1/3/5，品质平衡一键把控；
铁砧惩罚回调固定启用：成功分离后按原版公式回调一级 Repair Cost；
分离失败消耗规则固定：普通失败固定消耗材料与经济，技术故障走事务回滚；
最低平台 Paper/Folia 1.21 + Java 21：移除 1.20.x 兼容代码，附魔 Registry 统一走 Paper 1.21 API；
第三方附魔来源识别：minecraft 前缀为原版，第三方 Provider 优先认领，其余走 RegistryBridge；
玩家 GUI 清理：界面不再显示内部诊断明细，展示更清爽。

常见问题（FAQ）

Q1：需要安装 Vault 或 PlayerPoints 吗？
A：可选。金币经济需要 Vault、点券需要 PlayerPoints；不安装也能使用内置的经验 / 等级经济，或配置自定义命令经济。

Q2：支持 Folia 吗？
A：支持。插件声明 folia-supported，支持范围 Paper / Folia 1.21 ~ 26.2，Java 21+。

Q3：自动生成会覆盖我自己改过的附魔配置吗？
A：不会。已存在的 enchantments/（附魔名）.yml 会被保留；materials-mode: REPLACE 只作用于新生成的文件，之后修改品质模板也不会覆盖单附魔配置。

Q4：第三方附魔（ExcellentEnchants / EcoEnchants / Aiyatsbus 等）能用吗？
A：能。启动时第三方 Provider 优先认领对应附魔，其余第三方 Registry 附魔走 RegistryBridge，原版与第三方统一自动生成规则。

Q5：经验修补（Mending）为什么不能强化？
A：经验修补真实最大等级为 I，强化到上限后无等级可升，因此默认关闭强化，只保留等级 1 的分离 / 分解规则——这是按真实等级自动生成的正常结果。

Q6：分离失败会损失什么？
A：普通失败按配置消耗本次常规材料与经济；灵材护印可保护材料与幸运石不消耗（经济照扣）；祛魔石可让本次判定完全不消耗任何费用。技术性故障则走事务回滚，不做“失败”处理。

Q7：铁砧惩罚回调是什么？
A：成功分离附魔后，物品的 Repair Cost 按原版 Prior Work Penalty 逆公式回调一级（典型 31 → 15 → 7 → 3 → 1 → 0），与服务器原版机制保持一致。

Q8：能自定义品质和权限组吗？
A：可以。rarities/ 支持自定义品质（含 order 排序与 keywords 匹配）；groups.yml 可自由添加权限组及倍率；items/ 可定义自己的材料物品。

注意事项

插件不会自动覆盖已存在的 enchantments/（附魔名）.yml，服主自定义内容安全；
第三方附魔需要其插件已注册附魔（Provider 识别），未接入 Hook 时回退 Paper API 判断；
启用自定义命令经济时，务必同时配置 take/refund 命令，否则无法保证事务回滚。

原创付费闭源 EnchantManager - 分离、分解、强化附魔管理 1.7.1

评分

浪子清风的其他资源

分享资源

我们重视您的隐私

原创 付费 闭源 EnchantManager - 分离、分解、强化附魔管理 1.7.1

评分

浪子清风 的其他资源

分享资源

我们重视您的隐私

原创付费闭源 EnchantManager - 分离、分解、强化附魔管理 1.7.1

浪子清风的其他资源