# Minecraft 插件开发教程

## Minecraft 插件开发教程

从零开始，用 Java 开发 Minecraft 服务器插件。

本教程默认使用 **Paper API**。 它兼容 Bukkit / Spigot 生态，也最适合入门。

### 这套教程适合谁

* 想做服务器玩法插件
* 会一点 Java，或正在补 Java
* 第一次接触 Bukkit / Spigot / Paper 生态

### 你会学到什么

* 搭建本地开发环境
* 写出第一个可运行插件
* 理解生命周期、命令和事件
* 学会配置、调试、打包和发布

### 建议阅读顺序

{% stepper %}
{% step %}

### 先看学习路线

从整体上知道先学什么，后学什么。

[学习路线](/readme/kai-shi/xue-xi-lu-xian.md)
{% endstep %}

{% step %}

### 配好环境

准备 Java、IDE、Maven 和本地测试服。

[环境准备](/readme/kai-shi/huan-jing-zhun-bei.md)
{% endstep %}

{% step %}

### 写第一个插件

先跑通最小闭环。

[第一个插件](/readme/kai-shi/di-yi-ge-cha-jian.md)
{% endstep %}

{% step %}

### 补核心基础

接着学习生命周期、命令、事件和配置。

[插件生命周期](/readme/kai-fa-ji-chu/cha-jian-sheng-ming-zhou-qi.md)
{% endstep %}

{% step %}

### 学会交付

最后补上调试、打包和发布。

[打包与发布](/readme/tiao-shi-yu-fa-bu/da-bao-yu-fa-bu.md)
{% endstep %}
{% endstepper %}

### 教程目录

#### 开始

* [学习路线](/readme/kai-shi/xue-xi-lu-xian.md)
* [环境准备](/readme/kai-shi/huan-jing-zhun-bei.md)
* [第一个插件](/readme/kai-shi/di-yi-ge-cha-jian.md)

#### 开发基础

* [插件生命周期](/readme/kai-fa-ji-chu/cha-jian-sheng-ming-zhou-qi.md)
* [命令与权限](/readme/kai-fa-ji-chu/ming-ling-yu-quan-xian.md)
* [事件监听](/readme/kai-fa-ji-chu/shi-jian-jian-ting.md)
* [配置文件与数据](/readme/kai-fa-ji-chu/pei-zhi-wen-jian-yu-shu-ju.md)

#### 调试与发布

* [调试与排错](/readme/tiao-shi-yu-fa-bu/tiao-shi-yu-pai-cuo.md)
* [打包与发布](/readme/tiao-shi-yu-fa-bu/da-bao-yu-fa-bu.md)

{% hint style="info" %}
当前内容先完成了教程骨架和第一版入门内容。 如果你要继续，我可以下一步直接补：

* 完整的 Maven 项目模板
* 更系统的事件实战
* 配置热重载
* GUI、计分板、数据库等进阶主题
  {% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://doc.stellarvan.cn/readme.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.