[MD]
# Pokkit
Pokkit 是一个运行在 Nukkit-MOT(Minecraft 基岩版服务端)上的兼容层插件,通过实现 Spigot API(`1.21-R0.1-SNAPSHOT`)使得 Bukkit/Spigot 插件能够在 Nukkit-MOT 上运行。
**请注意:不要指望 Pokkit 能让你在 Nukkit 上运行所有Spigot 插件。** Pokkit 的实现仍然不完整,只有部分插件可以正常运行。由于 Spigot API 规模庞大,完整实现是不现实的——Spigot 是由数百名开发者历经数年才构建完成的。
## 工作原理
Pokkit 采用适配器模式,为每个 Bukkit 接口提供对应的 `Pokkit*` 包装类(如 `PokkitPlayer`、`PokkitWorld`、`PokkitItemStack`),内部持有 Nukkit 对象。转换器类提供静态的 `toBukkit()` 和 `toNukkit()` 方法用于两个 API 之间的类型转换。
事件系统通过事件翻译器实现:监听 Nukkit 事件,转换为对应的 Bukkit 事件后触发。
## 下载与使用
1. 下载最新版本
2. 将 JAR 文件放入 Nukkit 服务端的 `plugins` 目录
3. 启动服务端,然后关闭
4. `plugins` 目录下会生成 `Pokkit` 文件夹,打开后包含:
- **`bukkitPlugins`** 文件夹:将 Spigot 插件放入此目录
- **`permissions.yml`**:Bukkit 的权限配置文件
- **`scoreboard.yml`**:记分板数据
**重要:Bukkit 插件必须安装在 `plugins/Pokkit/bukkitPlugins/` 目录下,而不是 `plugins/` 目录。**
[/MD]