指南

如何制作 Spigot 插件

更新于 2026年10月7日

Spigot 插件使用 Bukkit/Spigot API，所以它能在 Spigot 和它的所有分支（包括 Paper）上运行。当你不知道插件会运行在哪里时，这是适用范围最广的选择。本指南涵盖项目、代码和构建。

把这个例子改成适合你服务器的样子。

用 Codexe 生成这个

分步说明

  1. 1.设置 Java 和构建工具

    安装与你的 Minecraft 版本匹配的 JDK（17、21 或 25），并使用 Maven 或 Gradle。

  2. 2.添加 Spigot API

    从 Spigot 仓库添加你所用版本的 spigot-api，范围为 provided。它只在编译时需要；运行时由服务器提供。

  3. 3.编写命令和监听器

    用 getCommand("name").setExecutor(...) 注册 CommandExecutor，用 registerEvents 注册事件监听器。

  4. 4.编写 plugin.yml

    名称、版本、主类、api-version（1.13 起）、命令和权限。

  5. 5.构建并安装

    mvn package，然后把 .jar 从 target/ 复制到服务器的 plugins/ 文件夹并重启。

旧版本（1.8 到 1.12）

许多小游戏服务器仍在运行 1.8。它的 API 更旧（没有 api-version，材质名称也不同），所以插件必须针对该版本来写，而不是照搬 1.21 的教程。Codexe 会询问版本，并针对那个 API 编写代码。

用 Codexe

描述插件，并写明“Spigot”和版本。Codexe 生成 Maven 项目，编译，修复错误，并让你在下载之前，在该版本的测试服务器上测试它。

常见问题

我需要 BuildTools 吗？

只有在运行 Spigot 服务器或使用 NMS（服务器内部代码）时才需要。要针对常规 API 编译，spigot-api 依赖就够了。

Spigot 插件还是 Paper 插件？

如果它必须到处都能运行就用 Spigot；如果你的服务器运行 Paper，并且想用它额外的 API，就用 Paper。见如何制作 Paper 插件。

制作 Spigot 插件

这条提示词打开后即可直接发送：

“一个名为 Kits 的 Spigot 1.8.8 插件：/kit <name> 发放一组可配置的物品，每个套装有冷却时间，套装在 config.yml 中定义，每个套装的权限为 kits.<name>，冷却时间在重启后保留。”

用 Codexe 生成这个
如何制作 Spigot 插件：设置、代码、构建 | Codexe