EnchantmentNumbers - High Level Enchantment Numbers Formatting - EnchantmentNumbers - 高等级附魔数字格式化

EnchantmentNumbers 是一款适用于 Minecraft 1.15 至 1.16 版本的插件，它能修复游戏中高等级附魔的显示格式，将原本冗长的“Efficiency enchantment.level.100”等文本，优化为简洁明了的“Efficiency 100”。

💡核心功能

• 将附魔名称后的冗长等级标识（如 enchantment.level.100）替换为简洁的数字。
• 可设置白名单，防止特定物品（如附魔金苹果）因自带附魔光效而显示附魔描述。
• 可选择使用数字（如“5”）或罗马数字（如“V”）来显示附魔等级。
• 可设置一个阈值，当附魔等级超过该值时，自动使用数字而非罗马数字显示。
• 完美保留物品原有的自定义描述（Lore），仅修改附魔相关的描述行。
• 在附魔台、铁砧或砂轮中操作物品时，附魔描述会自动实时更新。

🔧安装与配置

安装步骤

• 下载 EnchantmentNumbers.jar 文件。
• 将其上传至服务器的 plugins 文件夹。
• 重启服务器，或使用 PlugMan 等插件管理工具加载插件。
• 根据需要编辑 plugins/EnchantmentNumbers/config.yml 配置文件。
• 配置相关权限。
• 使用 /enureload 命令重载插件配置。

可选设置

为了在使用 /enchant 命令时自动更新物品描述，你可以在 commands.yml 文件中为其添加别名，格式如下：

enchant:
- enchant $1-
- enu

🎮命令与权限

• 命令： /enureload
• 描述： 重载 EnchantmentNumbers 的配置文件。
• 权限： enchantmentnumbers.reload

• 命令： /enu
• 描述： 更新手持物品的附魔描述。
• 权限： 无（所有玩家均可使用）。

✨配置文件详解

默认生成的 config.yml 文件内容如下，你可以根据注释进行调整：

# 是否使用罗马数字显示附魔等级
use-numerals: true

# 数字显示阈值。当 use-numerals 为 true 时，等级超过此值的附魔将用数字而非罗马数字显示。设置为 32768 或更高则禁用此功能。
numbers-above-threshold: 10

# 白名单列表。列在此处的物品将不会显示附魔描述（避免发光物品出现附魔文本）。
# 使用 Bukkit 的物品 ID，参考：https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Material.html
whitelist:
- ELYTRA
- SHEARS
- BOW
- CROSSBOW
- TURTLE_SHELL
- TRIDENT
- SHIELD
- FISHING_ROD
- DIAMOND_SWORD
- DIAMOND_PICKAXE
- DIAMOND_AXE
- DIAMOND_SHOVEL
- DIAMOND_HOE
- DIAMOND_HELMET
- DIAMOND_CHESTPLATE
- DIAMOND_LEGGINGS
- DIAMOND_BOOTS
- NETHERITE_SWORD
- NETHERITE_PICKAXE
- NETHERITE_AXE
- NETHERITE_SHOVEL
- NETHERITE_HOE
- NETHERITE_HELMET
- NETHERITE_CHESTPLATE
- NETHERITE_LEGGINGS
- NETHERITE_BOOTS
- GOLD_SWORD
- GOLD_PICKAXE
- GOLD_AXE
- GOLD_SHOVEL
- GOLD_HOE
- GOLD_HELMET
- GOLD_CHESTPLATE
- GOLD_LEGGINGS
- GOLD_BOOTS
- IRON_SWORD
- IRON_PICKAXE
- IRON_AXE
- IRON_SHOVEL
- IRON_HOE
- IRON_HELMET
- IRON_CHESTPLATE
- IRON_LEGGINGS
- IRON_BOOTS
- STONE_SWORD
- STONE_PICKAXE
- STONE_AXE
- STONE_SHOVEL
- STONE_HOE
- LEATHER_HELMET
- LEATHER_CHESTPLATE
- LEATHER_LEGGINGS
- LEATHER_BOOTS

❓开发者相关

如果你正在编写一个扩展 Minecraft 命名空间的自定义附魔插件，可以将 EnchantmentNumbers 添加为依赖。本插件能即时为你处理好附魔的格式化显示，无需自己编写代码将附魔名称添加到物品描述中。

技术细节与兼容性

• EnchantmentNumbers 不使用已弃用的 getName() 方法，而是使用命名空间键（NamespacedKey）的名称。
• 对于诅咒附魔的识别，同样不依赖已弃用的 isCursed() 方法，而是通过扫描名称中是否包含“Curse”一词来判断。
• 为了获得最佳的兼容性，建议你将自定义附魔的名称格式设置为与 Minecraft 原生风格类似。例如，将诅咒附魔命名为 name_curse，插件便能自动正确格式化。
• 如果遇到任何问题，欢迎加入 Discord 服务器获取帮助。

⭐支持与捐赠

• 支持与功能建议请前往作者的 Discord 服务器：https://discord.gg/AWCDVG2
• 如果你喜欢这个插件，欢迎通过 PayPal 支持作者：https://paypal.me/auxilorirl