在阅读本教程前，需要你具备基本的Java知识和非常基本的Spigot插件开发知识

I18N，即internationalization（国际化）的简称。因其首末字母之间间隔了18个字母，为了交流的方便，故经常以I18N代称

什么是ProtocolLib？

（图中，左边为客户端，右边为服务端）
ProtocolLib作为一款插件，更作为插件开发过程中常用到的一个依赖项，其作用大致就是拦截所有客户端发送到服务端/服务端发送往客户端的数据包，从而获取该数据包的内容，或对其加以修改，以达到目的
拦截的原理我猜主要是类似hook技术，这里我不深究，只是我的一个猜想
ProtocolLib在通信中所处的位置我认为就如上图所表示的，相当于在客户端与服务端之间横插一脚，和中间人攻击（Man-in-the-Middle Attack，简称“MitM攻击”)类似，但是作为一款安装在服务端上的插件，其应当更偏向于服务端一侧，且从某种意义上说，服务端是知晓这个“拦截者”的存在的

为什么要用ProtocolLib，Spigot API不是也有相应的修改DisplayName, Lore等等与显示属性相关的方法吗？

当然，Spigot API确实自带一些修改属性的方法。最常用的莫过于ItemMeta的setDisplayName和setLore这两个方法了。表面上看，这样的方法也能够实现简单意义上的国际化
可是，如果你深究起来，这种方法有着种种的弊端
其中最明显的一点，也是我个人认为的最不方便的一点，就是无法使用ItemStack自带的isSimiliar和equals比较的方法
因为这两个方法在实现中，都会比较ItemStack的ItemMeta里的DisplayName和Lore。既然你为了实现国际化，为不同语言的玩家的物品分别设置了不同的DisplayName和Lore，那么这两个方法对你而言就注定无法使用了。除非你实现一套自己的判断方法，虽然说不难，但需要自己重新发明轮子，实在是不够优雅
更何况，对于某些情况，Spigot API并没有提供相应的方法。比如说Inventory的标题。在InventoryView中，只有getTitle方法，而没有setTitle的方法。如果只依靠Spigot API实现Inventory的国际化，目前的思路就是监听玩家打开Inventory的事件。每当玩家打开一个Inventory，就来一个Bukkit.createInventory，（只有这个方法可以创建自定义标题的物品栏），然后关闭原来的Inventory，显示我们自己创建的Inventory，还要在打开前/关闭后实现两个Inventory之间物品的同步，同时还要考虑漏斗的情况。虽然不是不可行，但实在是太蛋疼了，或者说，不够优雅

总之，单纯地凭借Spigot API实现国际化，是不优雅的，也是不可取的
我们是时候该给自己提升一个维度了！

正确的打开方式

我们看到原版的Minecraft中，就算两个客户端的语言不同，只要两个玩家都拿着同一个物品（不考虑附魔等特殊情况），服务端这边总是能判断isSimiliar为true
于是，我们不难推断：其实这些物品在服务端上本质都是一样的，只是客户端上显示的不同罢了
顺着这个思路，由于Minecraft是典型的C/S架构。客户端和服务端之所以能实现数据的同步，不就是依靠客户端和服务端之间的通信吗？如果我们能够截获两者的通信，并在中间加以修改，岂不就可以悄无声息地“骗”过服务端和客户端了吗？既让客户端相信这个物品的DisplayName和Lore是不同的，要在不同语言环境下分别显示，又让服务端相信，这些在客户端看来不同的物品，在实质上是相同的
幸运的是，就像前面我对ProtocolLib的介绍，这个插件完美地适应了我们的需求

能否不用ProtocolLib？

当然可以
毕竟ProtocolLib在实现上也是用NMS的。你当然可以绕过ProtocolLib，自己用NMS实现一遍
我不是鼓励大家一遇到问题就想着用别人造好的轮子，只是说NMS这个东西实在比较邪乎，Spigot官方也是推荐能不用就不用
ProtocolLib这个东西也不是什么新出来的，已经有很多年的发展了，技术积淀深厚。人家搞NMS有一套的，总比我们从零开始研究的靠谱
更何况ProtocolLib是很多插件的共同依赖。你不依赖，其他的插件也会依赖。就算是中小型服务器，ProtocolLib迟早也会被装上的
我认为，ProtocolLib算得上是现在Minecraft服务器的必装插件之一了。所以，用的时候不要有什么心理负担
下面，我们正式开始教程

引入依赖

本系列教程均使用IntelliJ IDEA作为IDE
本系列教程除特殊说明处外，皆围绕Minecraft 1.19.2版本开展

由于截至撰稿日期时，适配1.19.2版本的ProtocolLib并未推出正式版，只能从Jenkins上下载构建版本，因此暂时无法使用Maven进行项目依赖管理
按照官方的说法，对于1.19.2版本，应当使用构建版本#606
前往下载该构建工件，并在IDEA中添加该jar作为项目的库
至于如何在IDEA中导入外部jar包，我不在此赘述。不了解的可以自己去查一查

当然，如果你坚持要用Maven的话，可以使用5.0.0-SNAPSHOT版本，在pom.xml中的适当位置加入如下内容：

<repositories>
  <repository>
    <id>dmulloy2-repo</id>
    <url>https://repo.dmulloy2.net/repository/public/</url>
  </repository>
</repositories>

<dependencies>
  <dependency>
    <groupId>com.comphenix.protocol</groupId>
    <artifactId>ProtocolLib</artifactId>
    <version>5.0.0-SNAPSHOT</version>
  </dependency>
</dependencies>

修改完毕后，刷新一下，5.0.0-SNAPSHOT版本的ProtocolLib依赖就配置好了
但注意，官方标明latest dev build是适配Minecraft 1.19.3版本的。虽然不是说不能用，但总归和1.19.2版本有些不一样的地方
因此，我还是推荐使用构建版本#606
关于二者的区别，我们会在下一篇教程中涉及

代码时间

本系列教程的代码旨在实现特定的功能，相当于一个原型prototype或者说草稿。为了后续开发和维护的方便，强烈建议在实际开发过程中对教程中的代码重新进行合理的组织

在插件的onEnable方法处加入如下的代码：

注意：请不要调用super.onPacketSending(event)，否则将会抛出异常

ProtocolLibrary.getProtocolManager().addPacketListener(
        new PacketAdapter(this, PacketType.Play.Server.OPEN_WINDOW) {
            @Override
            public void onPacketSending(PacketEvent event) {
                event.getPlayer().sendMessage("OPEN_WINDOW");
            }
        }
);

同时，在开头处需要引入如下几个包。可以使用Alt+Enter快速导入

import com.comphenix.protocol.PacketType;
import com.comphenix.protocol.ProtocolLibrary;
import com.comphenix.protocol.events.PacketAdapter;
import com.comphenix.protocol.events.PacketEvent;

下面我们开始简要地分析一下这段代码：

ProtocolLibrary.getProtocolManager().addPacketListener

这应该没什么问题，就是增加一个数据包监听器，是固定的写法

同时，该方法接受一个PacketListener接口

方法定义：void addPacketListener(PacketListener var1);

new PacketAdapter(this, PacketType.Play.Server.OPEN_WINDOW)

我们创建了一个匿名类，并将其作为参数传入

该匿名类属于PacketAdapter，它是一个实现了PacketListener接口的抽象类

this就是我们的插件

PacketType.Play.Server.OPEN_WINDOW就是我们要监听的数据包的类型，它表示打开一个Inventory

作为最简单的入门，我们以该数据包为例

当然还有其他很多种类的数据包，我在之后的教程中会娓娓道来

public void onPacketSending(PacketEvent event)

从这里可以看出来，ProtocolLib采用的是事件模型

顾名思义，当一个数据包从服务端发出时，该方法会被调用

由于我们前面指定了我们只监听PacketType.Play.Server.OPEN_WINDOW，所以只有当该类型的数据包发出时，才会执行该方法的逻辑

event.getPlayer().sendMessage("OPEN_WINDOW");

向接收该数据包的玩家发送一条内容为OPEN_WINDOW的消息

结语

简而言之，这段代码的意思就是：当玩家打开一个Inventory的时候，就会收到一条内容为OPEN_WINDOW的消息

由于我们此时并没有任何读取/修改数据包的操作，因此该例子也相当简单

希望读者们在阅读完本篇教程并亲手实践后，能对ProtocolLib有一个大概的了解

下一篇教程，我们将对数据包展开分析

相关链接

ProtocolLib在SpigotMC上的主页: https://www.spigotmc.org/resources/protocollib.1997/

ProtocolLib的构建版本#606（适用于Minecraft 1.19 – 1.19.2）: https://ci.dmulloy2.net/job/ProtocolLib/606/

ProtocolLib的最新构建版本（适用于Minecraft 1.19.3）: https://ci.dmulloy2.net/job/ProtocolLib/lastSuccessfulBuild/