ProtocolSupportStuff - 版本控制与物品重制工具

ProtocolSupportStuff 是一款功能丰富的插件，它能够禁用特定的 Minecraft 版本（包括当前服务器版本），为旧版本客户端重映射方块/物品，允许 1.9 版本前的客户端在 1.9+ 服务器上体验旧版 PvP，并提供更多自定义选项。

💡主要功能

• 禁用特定版本：在网络层面禁用指定版本，拒绝连接或 ping 请求，类似于客户端连接过时服务器时的体验。禁用未使用的版本可以减少 ProtocolSupport 的内存占用。
• 自定义方块/物品重映射：覆盖 ProtocolSupport 的默认重映射规则，支持按版本范围进行精细控制。
• 实验性功能（Hacks）：提供一些不稳定的功能来改善旧版本客户端的体验或修复问题。
• 物品信息调整：可为被重映射的物品添加 Lore 说明或翻译其显示名称。

🎮配置详解

配置文件为 YAML 格式，所有插件设置均在其中进行。

启用与禁用版本

在 versions: 部分，将对应版本键值设为 false 即可禁用。

versions:
  MINECRAFT_1_13: true
  MINECRAFT_1_12_2: true
  # ... 更多版本
  MINECRAFT_1_4_7: true

自定义重映射

在 blocks: 和 items: 部分添加规则。

通用字段说明：

• from / to: 使用 Material 枚举名，适用于物品和方块。
• from-state / to-state: 使用方块状态（仅适用于方块），例如 minecraft:chest[facing=north,type=single,waterlogged=false]。
• 版本范围控制：使用以下字段之一来指定规则生效的客户端版本范围。
• before: 指定版本之前的所有版本（不包含该版本）。
• after: 指定版本之后的所有版本（不包含该版本）。
• before-including: 指定版本之前的所有版本（包含该版本）。
• after-including: 指定版本之后的所有版本（包含该版本）。
• range: 两个版本之间的所有版本，例如 "Minecraft 1.8, Minecraft 1.9"。

参考链接：

• Material 枚举列表：https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Material.html
• ProtocolVersion 枚举列表：https://github.com/ProtocolSupport/ProtocolSupport/blob/master/src/protocolsupport/api/ProtocolVersion.java

配置示例：

blocks:
  - from: Bone Block
    to: Quartz Block
    before: Minecraft 1.10
  - from-state: minecraft:chest[facing=north,type=single,waterlogged=false]
    to-state: minecraft:chest[facing=south,type=single,waterlogged=false]
    before: Minecraft 1.6.1
items:
  - from: Totem of Undying
    to: Armor Stand
    between: Minecraft 1.8, Minecraft 1.10

实验性功能 (Hacks)

在 hacks: 部分启用。这些功能可能不稳定。

• sword-blocking:
• 允许 1.9 版本前的客户端进行“剑格挡”。
• 当 1.9+ 客户端使用盾牌格挡时，为旧版客户端播放剑格挡动画。
• 需要 ProtocolLib 和一个自动盾牌格挡插件（如 OldCombatMechanics）。
• 使用 Paper 服务器可将盾牌格挡延迟降至 0 tick，获得更好的“旧版 PvP”体验。
• strip-colors-from-long-texts:
• 对于 1.8 版本前的客户端，如果告示牌文本超过 16 个字符（包含颜色代码），将剥离颜色代码。
• 这使得旧版客户端能看到完整的文本内容，而不是被截断的部分。
• 示例（旧版客户端视角）：

- `false`: 文本 `"&a&lThis is too big!"` 显示为 `"&a&lThis is too "`

- `true`: 文本 `"&a&lThis is too big!"` 显示为 `"This is too big!"`

配置示例：

hacks:
  strip-colors-from-long-texts: false
  sword-blocking: false

杂项设置

• add-to-lore: 设为 true 时，为被 ProtocolSupport 重映射的物品在 Lore 末尾追加文本。
• newer-item-text-lore: 当 add-to-lore 启用时，此处定义的文本将被追加。{name} 会被替换为物品的原名。
• translate-display-name: 将重映射后的物品名称更改为“正确”的物品名。

配置示例：

add-to-lore: true
translate-display-name: true
newer-item-text-lore: '&8This item is actually &7{name}&8 from newer versions of Minecraft'

🔧依赖

• ProtocolSupport (必需)
• ProtocolLib (可选，部分功能需要)
• OldCombatMechanics (可选，用于改善 sword-blocking 体验)
• Paper (可选，用于改善 sword-blocking 体验)

❓注意事项与提示

• 修改重映射规则时需注意，如果原方块与新方块的挖掘时间差异巨大，可能会导致破坏方块时出现问题。
• from-state/to-state 仅适用于方块，不适用于物品。
• 除非你明确知道后果，否则请不要修改 config-version 的值。
• 实验性功能 (Hacks) 被标记为“不稳定”，使用时请留意。

⭐鸣谢与链接

感谢 MrPowerGamerBR, Shevchik 和 7kasper。

• GitHub 项目：https://github.com/PerfectDreams/ProtocolSupportStuff (请在此反馈问题)
• PerfectDreams：https://perfectdreams.net/
• 作者网站：https://mrpowergamerbr.com/
• Loritta：https://loritta.website/