指南

如何制作 Minecraft 插件

更新于 2026年10月7日

Minecraft 插件是一个 Java 程序，由 Spigot 或 Paper 服务器加载，用来添加命令、规则或整个小游戏。你可以手写一个，也可以描述它，让 AI 来编写、编译和测试。下面是两种方式。

用你自己的话描述它，或者从这个例子开始。

用 Codexe 生成这个

分步说明

  1. 1.选择服务端软件和版本

    插件运行在基于 Bukkit 的服务器上：Spigot、Paper 或 Folia（代理端用 BungeeCord 和 Velocity）。选择你的服务器所运行的 Minecraft 版本，从 1.8 到 26.x。

  2. 2.描述插件的功能

    写下命令、权限、游戏里会发生什么，以及哪些应该可配置。示例：“/sethome、/home 和 /delhome，每个玩家最多 3 个家，3 秒预热，消息放在 config.yml 中”。

  3. 3.让 Codexe 编写并编译

    Codexe 编写 Java 类、plugin.yml、config.yml 和 pom.xml，运行真实的构建，并在把项目标记为就绪之前修复编译错误。

  4. 4.在真实服务器上测试

    点击“立即试用”，加入装有该插件的私人 Minecraft 服务器。Codexe 的测试玩家会运行每个命令，并检查你要求的内容。

  5. 5.下载并安装 .jar

    下载构建好的 .jar，放进你服务器的 plugins/ 文件夹，然后重启服务器。配置文件会出现在 plugins/<PluginName>/ 中。

什么是 Minecraft 插件

插件是一个 .jar 文件，由 Minecraft 服务器从它的 plugins/ 文件夹加载。它只在服务端添加命令、游戏规则、经济系统、小游戏或任何其他东西：玩家用正常的游戏加入，不需要模组。

插件是用 Java（或 Kotlin）针对服务端 API 编写的：游戏服务器用 Spigot 和 Paper，代理端用 BungeeCord 或 Velocity。插件还需要一个 plugin.yml，告诉服务器它的名称、主类、命令和权限。

手动方式：Java、Maven，以及 Spigot 或 Paper API

学起来更花时间，但能完全掌控。Codexe 产出的是同样类型的项目，所以你可以从生成的插件开始，再手动继续。

  1. 安装 JDK（1.20.5 到 1.21.x 用 Java 21，26.x 用 Java 25）和 IntelliJ IDEA 这样的 IDE。
  2. 创建 Maven 或 Gradle 项目，添加你所用版本的 paper-api 或 spigot-api 依赖，范围为 provided。
  3. 编写继承 JavaPlugin 的主类，包含 onEnable() 和 onDisable()。
  4. 在 src/main/resources 中添加 plugin.yml，包含 name、version、main、api-version 和你的命令。
  5. 用 getCommand("name").setExecutor(...) 注册命令，用 getServer().getPluginManager().registerEvents(...) 注册监听器。
  6. 用 mvn package 构建，把 target/ 中的 .jar 复制到测试服务器的 plugins/ 文件夹并重启。

常见问题

我需要懂 Java 吗？

用 AI 生成器就不需要：你描述插件并测试它。如果你想自己修改代码，懂 Java 会有帮助。

免费吗？

在免费套餐上，用 Codexe 创建、编译和测试都是免费的（每 24 小时补充 50,000 个 token）；下载 .jar 需要套餐或下载包。

制作你的第一个插件

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

“一个带 /sethome、/home 和 /delhome 的 Paper 1.21.4 插件：每个玩家最多 3 个家，3 秒的预热，移动则取消，所有消息放在 config.yml 中。”

用 Codexe 生成这个
如何制作 Minecraft 插件（会不会编程都行） | Codexe