Skip to content
托管 · 插件

ProtocolLib:为什么需要它

用于处理网络数据包的库:哪些插件依赖它,为什么版本更新时它最先出问题,以及如何修复。

更新于 2026年8月13日

ProtocolLib 让插件能够访问客户端与服务器之间的网络数据包。它本身不提供任何功能,但许多热门插件没有它就无法运行。

谁需要它

老一代全息投影、部分反作弊、皮肤和 NPC 插件、自定义界面,以及覆盖方块显示的插件。

关键特性

ProtocolLib 与特定 Minecraft 版本的内部实现绑定得比普通插件更紧密。因此服务器更新后,它总是第一个出问题:

[ProtocolLib] Unsupported server version

唯一的解决办法是把 ProtocolLib 更新到适配您版本的构建。有时需要用开发版构建:正式版会晚一些发布。

出问题时会怎样

依赖它的插件将无法加载:日志中会出现 NoClassDefFoundError,或提示依赖加载失败——缺少依赖。

负载

数据包拦截并非没有代价。如果只有一个插件需要 ProtocolLib,而您并不使用那个插件,就把两者都删掉。在玩家较多的服务器上,这一点在性能分析中很明显——Spark。

检查

/protocol dump

会显示版本和状态。如果插件提示不兼容,但服务器看起来还能正常运行,说明部分功能其实已经被静默禁用了。

Minecraft 托管您离线时服务器仍在运行创建服务器