插件开发总览

服务端能跑、配置会改、现成插件会用——下一步就是自己写插件。Bukkit 插件本质是一个基于 BukkitAPI 的 Java 应用，靠主类 + plugin.yml 让服务端识别，通过监听事件、注册命令、读写配置来实现玩法。

本系列完整覆盖官方 Bukkit 插件开发教程，按难度分四块：

完整大纲

基本概念

• 开始之前 —— 前置能力与心态
• AI 辅助插件开发 —— 不会 Java 也能入门
• MC 服务端介绍 —— 官服/Bukkit/Spigot/Paper 的来历
• 信息检索 —— 用 JavaDoc 自己找答案
• 服务端与客户端 —— 为什么不能信客户端

基础内容

• 最简单的插件 —— 主类、plugin.yml、Logger、ChatColor
• 事件监听 —— Listener、@EventHandler、优先级、ignoreCancelled
• 配置 API —— 读写 YAML 配置文件
• 命令执行器 —— 注册命令、解析参数、权限判断

进阶内容

• 箱子 GUI —— Inventory + InventoryClickEvent
• 自定义事件 —— 自己造事件给别的插件监听
• 深入 plugin.yml —— 依赖、softdepend、loadbefore
• 配置序列化与遍历 —— 存自定义对象、ConfigurationSection
• 多线程与多任务 —— BukkitScheduler、同步/异步、线程安全
• 自定义合成表 —— ShapedRecipe
• 粒子与音效 —— spawnParticle、playSound
• 世界生成器 —— BlockPopulator、ChunkGenerator
• Title 与 ActionBar —— 屏幕文字显示

底层内容

• 认识 NMS 与 OBC —— net.minecraft.server、反射、版本兼容
• 自定义发包 —— 直接发数据包给客户端

学习路径

按顺序读基本概念 → 基础内容，能写出绝大多数常用插件。进阶内容按需查阅。底层内容（NMS/发包）是最后手段——官方都不推荐滥用，能用 API 就别碰 NMS。

前置要求

• 已搭好本地服务端（见开发环境搭建）
• 装好 IntelliJ IDEA + Minecraft Development 插件
• 有 Java 面向对象基础——不会 Java 写不出插件，本教程不教 Java 语法
• 会用 IDE 和 JavaDoc 查资料

能力门槛降低了

Bukkit 插件对 Java 要求不高（面向对象基础就够）。以前不会 Java 基本写不出插件，现在借助 AI 辅助不会 Java 也能入门——但读懂代码、判断对错、调试排障仍躲不掉。能补 Java 还是建议补。

从开始之前起步。