UberEnchant - 自定义附魔台与铁砧

简介

UberEnchant 是一款功能强大的插件，允许你为任何物品添加超高等级的附魔（理论上可达 15,000 级，但受游戏内部限制）。无论是工具、武器、盔甲，甚至是食物和方块，都能被赋予强大的效果。请谨慎使用，因为这些强力物品一旦落入他人之手，可能会破坏游戏平衡。

💡重要须知

• 自 Minecraft 1.17 起，附魔等级受游戏内部限制，最高为 255 级。
• 附魔物品被放置（如方块）后，附魔效果会消失。
• 如需帮助、了解 UberEnchantApi 或成为测试版体验者，请加入 Discord 服务器：

https://discord.gg/MrFWQsmdK5

🎮核心特性

兼容性与支持

• Minecraft 版本：支持 1.17.1+（Beta 8.11.2 - 8.11.4）及 1.20.4+（自 Beta 8.11.5 起）。
• 经济系统：需要 Vault 插件支持。
• WorldGuard 支持（自 8.11.8 起）：自定义附魔会遵循 pvp、damage_animals、potion_splash 等区域标记。
• Towny 支持（自 8.12.1 起）：自定义效果附魔会遵循 Towny 的保护规则。
• ProtocolLib 支持（自 8.12.1 起）：用于修复铁砧上的“过于昂贵”问题。
• ExcellentEnchants 兼容（自 8.12.1 起）：自定义效果附魔会与 ExcellentEnchants 的附魔一同显示在附魔台上。

附魔管理

• 添加/移除 任何原版附魔。
• 支持任何物品（食物、工具、方块等）。
• 支持几乎任何等级（受上述 255 级限制）。
• 隐藏/显示 附魔（自 8.9.7 起）。

自定义附魔 API

• 自 Beta 8.10.0 引入，开发者可利用此 API 轻松创建自定义附魔。
• JavaDocs：https://coltonj96.github.io/UberEnchant/
• 示例插件：https://github.com/coltonj96/UberEnchantApiExample/

元标签管理（自 8.11.8 起，仅限 UberEnchant 添加的自定义附魔/效果）

• 操作：添加、移除、设置。
• 当前可用标签：
• duration：效果持续时间（秒，如 1.5 代表 1.5 秒）。
• has_chance：效果是否随机触发。
• chance：触发几率（0.0 到 1.0，1.0 为 100%）。
• hidden：是否在物品上隐藏此附魔。
• level：设置效果等级。
• on_consume：为 true 时，玩家消耗物品（如吃牛排）时触发效果。
• on_held：为 true 时，玩家手持物品时持续应用效果。
• on_drop：为 true 时，玩家丢弃物品时触发效果。
• on_pickup：为 true 时，玩家拾取物品时触发效果。

药水效果（仅限原版效果）

• 添加/移除 效果。
• 自 8.10.0 起，物品效果已转为自定义附魔形式添加，使用时需手持物品。
• 效果逻辑：
• 添加到武器的效果，会在击中玩家或生物时施加给目标。
• 添加到盔甲的效果，会在穿戴者受到伤害时触发（正面/中性效果给穿戴者，负面效果给攻击者）。
• 自 8.11.6 起，效果附魔行为改变（例如，将速度效果附魔在靴子上，会给予穿戴者速度效果）。

自定义游戏机制

附魔台（自 Beta 8.11.0 起）

• 行为类似原版，消耗经验与青金石。
• 可出现的原版附魔等级可超过原版上限（最大等级可在配置中调整）。
• 可在 mechanics/enchantment_table.yml 中关闭或仅允许特定附魔出现。
• 地板加成（自 Beta 8.11.5 起）：类似书架，但使用地板方块，将最大加成效能从 15-22 提升至 40，允许在附魔台获得最高 10 级的附魔。
• 放置在附魔台下方。
• 可自定义地板方块类型和加成值（自 8.11.6 起）。
• 默认方块与加成（最多 9 个方块）：

- 铁块：每块 +0.25，最多 +2.25

- 金块：每块 +0.5，最多 +4.5

- 绿宝石块：每块 +0.75，最多 +6.75

- 钻石块：每块 +1.0，最多 +9.0

- 下界合金块：每块 +2.0，最多 +18.0

铁砧（自 Beta 8.11.0 起）

• 行为类似原版，消耗经验。
• 可使用自定义附魔进行合成。
• 原版附魔可合并至超过原版定义的等级。
• 可在 mechanics/anvil.yml 中关闭。
• 支持颜色代码和十六进制（HEX）颜色（自 Beta 8.11.2 起，在 mechanics/anvil.yml 中启用）。

物品文本与名称

• Lore（描述文本）：
• 支持颜色代码和 HEX 颜色（8.9.3+，1.16+，需 Spigot/Paper）。
• HEX 格式：#000000（例如红色：#ff0000）。
• 操作：添加、移除、设置。
• 使用 /uadd lore %null 或 /uset lore <行号> %null 添加/设置空行（8.9.2+）。
• 物品名称：
• 支持颜色代码和 HEX 颜色（8.9.3+，1.16+，需 Spigot/Paper）。
• 操作：设置、清除。

本地化支持（自 8.9.15 起）

• 当前支持：EN_US
• 欢迎提交翻译！

🔧命令列表

所有命令支持颜色代码和 HEX 颜色（8.9.3+，1.16+，需 Spigot/Paper）。HEX 格式：#000000（例如红色：#ff0000）。

添加类

• /uadd enchant <附魔名|别名> <等级>：为手持物品添加指定等级附魔。
• /uadd enchant all <等级>：为手持物品添加所有附魔（指定等级）。
• /uadd effect <效果名|ID> <持续时间> <等级>：给予自身药水效果（空手时），或为手持物品添加效果（手持时）。持续时间单位为秒。
• /uadd meta <附魔名> <标签> <值>（8.11.8+）：为指定附魔添加元标签。
• /uadd name <文本...>：在物品现有名称后追加文本。
• /uadd lore <文本...>：在物品 Lore 末尾追加一行。使用 %null 添加空行。

成本查询类

• /ucost add <附魔名|别名> <等级>：查询添加指定等级附魔的成本。
• /ucost del <附魔名|别名>：查询删除指定附魔的成本。
• /ucost extract <附魔名|别名>：查询提取指定附魔的成本。

设置类

• /uset hidden <true|false>：设置附魔的隐藏/显示状态（8.9.7+）。
• /uset meta <附魔名> <标签> <值>（8.11.8+）：设置指定附魔的元标签值。
• /uset name <文本...>：设置物品的显示名称。
• /uset lore <行号> <文本...>：设置指定行号的 Lore 文本。使用 %null 设为空行。

删除类

• /udel enchant <附魔名|别名>：从手持物品移除指定附魔。
• /udel effect <效果名|ID>：从自身移除药水效果（空手时），或从手持物品移除效果（手持时）。
• /udel meta <附魔名> <标签>（8.11.8+）：移除指定附魔的元标签。
• /udel name：移除手持物品的显示名称。

物品与附魔操作类

• /uextract <附魔名|别名>：从手持物品提取指定附魔。
• /uinsert lore <行号> <文本...>：在指定行号后插入一行 Lore。使用 %null 插入空行。
• /uitem save <标识名>：保存手持物品，使用指定标识名。（注意：同名物品会被覆盖）
• /uitem load <标识名> [玩家名]：加载保存的物品并给予自己（或指定玩家）。这使得 EssentialsX 等插件可以通过添加命令 /uitem load <物品名> {USERNAME} 到礼包中，来发放预定义的附魔物品。
• /uitem delete <标识名>：删除已保存的物品文件。
• /uclear enchant|lore|effect：重置手持物品的附魔、Lore 或效果。

信息与工具类

• /ulist：列出游戏中可用的附魔和效果。
• /ureload（8.10.1+）：重载自定义附魔配置，使更改生效。
• /uhelp：列出所有命令。

注意：最新的可用附魔和药水效果列表，请在游戏内使用 /ulist 命令查看。

✨权限节点

完整权限列表请访问：https://dev.bukkit.org/projects/uberenchant/pages/permissions

权限采用层级结构，例如要使用 /uadd enchant sharpness 1 命令，你需要：

• uber.add（允许使用 /uadd）
• uber.add.enchant（允许添加附魔）
• uber.add.enchant.sharpness（允许添加锋利附魔）

❓其他说明

数据收集

• 插件集成了 Plugin Metrics / BStats 以收集匿名数据，用于改进插件。
• 你可以通过在 /plugins/PluginMetrics/config.yml 中编辑配置来选择退出。
• 收集的数据包括：
• 唯一标识符
• Java 版本
• 服务器在线/离线模式
• 插件版本
• 服务器核心版本
• 操作系统信息与架构
• CPU 核心数
• 在线玩家数
• Metrics 版本

反馈与合作伙伴

• 反馈：欢迎提交问题、建议或评论。
• 合作伙伴：考虑使用专用服务器？试试 Kinetic Hosting！结账时使用优惠码 UberDiscount 可享首月 85 折。
• 链接：https://billing.kinetichosting.net/aff.php?aff=340
• 视频评测：由 https://serverminer.com/ 提供。