Minecraft 1.8版本NMS实现玩家列表头尾部如何延长最大长度

问题根因 #

• 你遇到的异常和所谓的「头尾部最大长度限制」无关，1.8版本玩家列表头尾部本身没有15字符限制，15字符限制是计分板Team的prefix/suffix的固有约束。
• 抛出DecoderException的核心原因是你直接将头尾部内容拼接进JSON字符串，当内容包含JSON特殊字符（单引号、双引号、反斜杠、控制字符等）时，会破坏JSON结构，导致ChatSerializer.a()解析失败。你感知到的「长度超过15就报错」只是巧合，长内容更容易触发特殊字符场景。

解决方案 #

直接放弃使用JSON序列化构造IChatBaseComponent的方式，改用原生ChatComponentText构造，完全规避JSON解析异常；同时直接使用数据包自带的带参构造方法，省略冗余的反射字段赋值逻辑。

修改后的代码如下：

public void setPlayerListHeaderFooter(Player player, String headerName, String footerName) {
    CraftPlayer cp = (CraftPlayer) player;
    PlayerConnection connection = cp.getHandle().playerConnection;
    // 直接构造文本组件，无需走JSON解析
    IChatBaseComponent header = new ChatComponentText(headerName);
    IChatBaseComponent footer = new ChatComponentText(footerName);
    // 1.8版本原生支持双参数构造方法，无需反射赋值字段
    PacketPlayOutPlayerListHeaderFooter packet = new PacketPlayOutPlayerListHeaderFooter(header, footer);
    connection.sendPacket(packet);
}

额外注意事项 #

如果你的服务端是定制化1.8核心，数据包带参构造方法不可用，必须使用JSON序列化方式的话，需要先对传入的头尾部内容做JSON特殊字符转义：

• 将内容中的'替换为\\'
• 将内容中的\替换为\\\\
• 将内容中的换行符替换为\\n

如果后续遇到计分板内容长度超限的问题，可以将长文本拆分为「前缀+占位符+后缀」三段，通过Team的prefix、suffix分别承载，即可突破单段16字符的限制。

内容的提问来源于stack exchange，提问作者Libration