【插件资源】[前置][协议]ProtocolLib—几乎每个plugins都需要的前置插件

使用 Minecraft 1.19 的最新开发版本

1.19最新开发版本在这里

你还可以在GitHub获取最新的ProtocolLib[随时],他在这里

如果您喜欢 ProtocolLib 或者它使您的生活变得更加轻松，请考虑一次性捐赠、赞助项目或在下面留下正面评价。这真的意味着很多！

某些任务无法使用标准 Bukkit API 执行，可能需要直接使用甚至修改 Minecraft。一种常见的技术是修改传入和传出数据包，或将自定义数据包注入流中。然而，这非常麻烦，大多数实现会在新版本的 Minecraft 发布后立即中断，主要是由于混淆。

ProtocolLib 是一个允许对 Minecraft 协议进行读写访问的库。它处理反射和通道注入所需的大部分开销，并提供包装器来简化数据包修改。它使用大多数 Minecraft 更新进行更新，因此理想情况下，单个插件不必更新。ProtocolLib 通常不需要为次要更新进行更新，尤其是在代码更改很少的情况下（即 1.8 安全更新）

有用的链接

报告错误前的支持
：

寻找ProtocolLib的更新，您的错误或错误很可能已经修复。
阅读堆栈跟踪并确保它是 ProtocolLib 的错误。ProtocolLib的软件包是com.comphenix.protocol。如果你在任何地方都看不到，那就不是ProtocolLib。
查看常见错误 wiki 页面。

报告错误时：

使用问题跟踪器！不要在评论中报告错误。请在报告新问题之前搜索重复项！
提供尽可能多的信息。提供您的 ProtocolLib 版本和 Spigot 版本。
使用 pastebin 提供任何堆栈跟踪或“错误”。

对于服务器运营商
只需从上面的链接下载ProtocolLib。它自己不做任何事情，它只是允许其他插件运行。

对于开发人员
可以在此处找到一个有点过时的教程。维基上正在开发一个新教程。

TinyProtocol Protocol有一个轻量级的ProtocolLib替代品，称为TinyProtocol
。它本质上是一种发送和接收原始数据包的机制，无需结构修饰符或包装器。可以在这里找到它。

Maven 存储库如果您使用的是 Maven，您将能够从以下存储库
自动下载 jar、JavaDoc 和相关源代码：

.HTML：

<存储库>
<存储库>
<id>dmulloy2-repo</id>
<url>https://repo.dmulloy2.net/repository/public/</url>
</repository>
<!– 等等 –>
</存储库>

格拉德尔：

代码（爪哇）：

Repository {
maven { URL “https://repo.dmulloy2.net/repository/public/” }
}

然后将其添加为依赖项，如下所示：

.HTML：

<dependencies>
<dependency>
<groupId>com.comphenix.protocol</groupId> <artifactId>ProtocolLib</artifactId> <version>4.8.0</version> </dependency> <!– 等等 –></依赖关系>

格拉德尔：

代码（爪哇）：

dependencies {
compileOnly group： “com.comphenix.protocol”， name： “ProtocolLib”， version： “4.8.0”;
}

命令协议主
管理命令
。支持以下子命令：

配置：重新加载配置文件。
检查：在 BukkitDev 上检查新版本。
版本：显示当前运行的 ProtocolLib 版本。
计时：切换测量每个插件花费的 CPU 时间。
侦听器：显示哪些插件正在使用 ProtocolLib，以及它们正在拦截的数据包类型。

PacketLog
将提供的数据包的十六进制表示形式记录到文件或控制台语法：/packetlog <protocol> <sender> <packet> [文件/控制台
]
可以在此处找到接受的数据包。

所有这些命令都需要权限协议.admin。

配置有一小部分配置
选项可用：
全局部分

代码（YAML）：

auto updater.notify：true #Inform任何具有权限的播放器 protocol.info 新版本的 ProtocolLib 发布时。
auto updater.download：false #Automatically下载并安装最新版本的 ProtocolLib。安装将在服务器重新启动时生效。
自动更新程序.延迟：43200 #The每次检查新更新之间的秒数。
自动更新程序.last： 0 #This仅记录上次执行更新检查的时间（以自 1970 年 1 月 1 日以来的秒为单位）。将其设置为 0 以强制进行新的更新检查。
指标：真 #If 真，ProtocolLib 将向 mcstats.org 发布匿名使用数据。将其设置为 FALSE 以选择退出。
后台编译器：真 #If TRUE，ProtocolLib 将尝试通过动态用编译代码替换反射来提高性能。
忽略版本检查：没有 #Force ProtocolLib 为指定的 Minecraft 版本启动，即使它不兼容。

兼容性
该项目的主要目标之一是实现与不同版本的 Minecraft 的最大兼容性。最终结果非常灵活。除了包更改之外，它还应该能够抵御未来的更改。除了错误修复和新功能之外，我可能不必更新 ProtocolLib。

这怎么可能？最终，这一切都归结为反思。本质上，没有名称是硬编码的 – 每个字段、方法和类都是通过查看字段类型、包名称或参数类型来推断的。它在不同版本中非常一致。

示例插件一些制作精良的插件
，使用 ProtocolLib 做有趣的事情。查看他们的来源（如果有的话）以获得一些灵感。