Disenchantment

插件

· 作者 H7KZ

附魔正确,物品错误?再也不会有这种情况了。

0 本站下载 0 关注 更新于 3 个月前

最新 6.5.12 · 26.2 · Folia / Paper

一键开服(送7天)

Disenchantment

event.png

一个轻量级的 Spigot/Paper/Folia 插件,通过向标准铁砧添加强大且直观的功能来增强原版附魔系统。为你的玩家提供高效管理附魔的工具,无需添加任何新方块或复杂系统。

功能

解除附魔:回收你的附魔

是否曾发现一件即将损坏的工具上带有你想保留的稀有附魔?解除附魔机制提供了一个简单的解决方案。

  • 简单的铁砧流程 - 将附魔物品放入第一个铁砧槽位,将书放入第二个槽位。
  • 可控转移 - 对于可配置的 XP 消耗,附魔会从物品上移除并转移到书上,使原物品恢复干净。玩家可以挽救磨损或过时装备上的珍贵附魔。

书本拆分:分割你的附魔书

需要从一本包含多个附魔的书里只提取一个吗?书本拆分允许你精确、策略性地使用附魔书。

  • 直观的拆分 - 在铁砧上将多附魔书与空白书结合,从原书中分离出一个单独的附魔。
  • 策略性应用 - 结果得到两本书:原书少一个附魔,新书则包含被分离出的单个附魔。这实现了精准应用,并促进更动态的服务器经济。

经济集成

服务器管理员可选择要求玩家在每次解除附魔或拆分操作时支付游戏内货币费用,除了(或替代)XP 消耗。

  • 需要 Vault 及任何兼容的经济插件(EssentialsX、CMI、PlayerPoints 等)。
  • 可配置每项操作的固定费用,解除附魔和书本拆分的费用独立设置。
  • 当玩家在铁砧中准备好结果时,费用会在动作栏中预览。
  • 默认禁用 — 如果未安装 Vault,则无任何影响。

为什么选择此插件?

  • 真正兼容原版 - 没有新机器或令人困惑的界面。所有功能均通过标准铁砧处理。
  • 轻量且高效 - 添加有价值功能的同时不会导致服务器卡顿或性能问题。
  • 完全可定制 - 可配置 XP 消耗、经济费用、按世界/按附魔/按材质限制、事件优先级等。
  • 支持经济 - 可选的 Vault 集成让服务器管理员可以为每项操作添加货币成本。
  • 支持 Folia - 兼容用于区域化多线程的 Folia 服务器软件。

安装

要求

  • Java 21 或更高版本
  • 运行 Minecraft 1.18 - 1.21.+ 的 Spigot、Paper 或 Folia 服务器

下载

从以下任一来源获取最新版本:

设置

  1. 下载 Disenchantment-<version>.jar 文件。
  2. 将 JAR 文件放入服务器的 plugins/ 目录。
  3. 重启服务器。
  4. 编辑 plugins/Disenchantment/config.yml 以自定义设置,或使用 /disenchantment gui 命令在游戏内使用管理员界面。

支持的自定义附魔插件

Plugin 1.21.8 - 1.21.11+ 1.21.7 - 1.21.5 1.21.4 - 1.21 1.20.6 - 1.20.5 1.20.4 - 1.18
AdvancedEnchantments ✓ ✓ ✓ ✓ ✓
EcoEnchants ✓ ✓ ✓ ✓ ✓
EnchantsSquared ✓ ✓ ✓ ✓ ✓
UberEnchant ✓ ✓ ✓ ✓ ✓
ExcellentEnchants ✓ ✓ ✓ - -
Vane ✓ ✓ ✓ - -
Zenchantments ✓ ✓ ✓ - -

注意: EcoEnchants V13.0.0 在 Disenchantment 6.4.0+ 中原生支持。无需修补构建。

文档

完整文档位于 docs/ 目录中。

目标用户 从这里开始
服务器管理员与玩家 docs/user/ — 安装、命令、配置、权限、常见问题解答
插件开发者(API) docs/api/ — 公开事件、PlaceholderAPI
贡献者与工程师 docs/engineering/ — 架构、环境搭建、贡献指南
深入内部机制 / LLM 智能体 docs/internals/ — NMS、事件、GUI、配置系统

快速链接:

文档 描述
Commands 完整的命令参考,包含用法与权限说明
Permissions 所有权限节点及其默认值
Configuration 完整的配置参考
FAQ 常见问题解答与故障排除

从源代码构建

mvn clean package

输出的 JAR 文件位于 target/Disenchantment-<version>.jar。有关前置条件和开发环境搭建,请参阅 CONTRIBUTING.md。

贡献

欢迎贡献!请在提交拉取请求之前阅读 Contributing Guidelines。

链接

许可证

本项目采用 MIT License 许可。

依赖与致谢

内置库

以下库包含在分发的插件 JAR 中:

Library License Author Purpose
bStats MIT Bastian Oppermann 匿名插件使用统计(可选,可在配置中禁用)

运行时依赖项(由服务器提供)

这些 API 由 Minecraft 服务器提供,不随插件捆绑:

API License Link
Spigot API GPL-3.0 github.com/SpigotMC/Spigot-API
Paper API GPL-3.0 github.com/PaperMC/Paper
Folia API GPL-3.0 github.com/PaperMC/Folia

可选运行时依赖项

这些插件不是必需的,但在存在时会解锁额外功能:

Plugin License Link Purpose
Vault LGPL-3.0 github.com/MilkBowl/Vault 经济集成 — 每次操作向玩家收取货币费用

自定义附魔插件适配器(仅编译时)

Disenchantment 包含以下插件的适配器。这些插件未随 Disenchantment 捆绑或分发。它们仅用作编译时依赖项以创建集成适配器。如果希望使用集成特性,服务器管理员必须单独获取并安装这些插件。

Plugin License Author Link
AdvancedEnchantments Proprietary GC-spigot github.com/GC-spigot/AdvancedEnchantments
EcoEnchants GPL-3.0 Auxilor github.com/Auxilor/EcoEnchants
EnchantsSquared No public license Athlaeos github.com/Athlaeos/EnchantsSquared
UberEnchant GPL-3.0 sciguymjm github.com/Sciguymjm/UberEnchant
ExcellentEnchants GPL-3.0 NightExpress github.com/nulli0n/ExcellentEnchants-spigot
Zenchantments GPL-3.0 Zedly github.com/Zedly/Zenchantments
Vane MIT oddlama github.com/oddlama/vane

注意: Disenchantment 创建的适配器仅与这些插件的公开 API 进行交互,不包含任何来自插件本身的代码。每个插件均保留其独立的许可证。

构建工具

以下工具在构建过程中使用,但不会包含在最终的插件中:

工具 许可证 链接
Maven Shade Plugin Apache-2.0 maven.apache.org/plugins/maven-shade-plugin
Maven Compiler Plugin Apache-2.0 maven.apache.org/plugins/maven-compiler-plugin

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源