hello大家好，很久没写过文章了，让ai优化了一下 本人文笔太差了
开mc服一整年，之前一直靠网上抄插件过日子。遇到想要的小功能没人做、现成插件臃肿冲突、版本不兼容，被插件坑疯了之后，从零明白了插件开发。
网上大部分教程要么太官方全是术语，要么AI写的照搬模板，跳过超多新手必踩的坑。今天我用普通人的思路，写一套零基础能看懂、跟着点点鼠标就能跑通的MC服务端插件开发教程。
不讲空话、不堆概念，只讲服主最需要的Java Spigot插件开发，仅服务端插件！客户端模组（Forge/Fabric）这套不通用，先分清别搞混。

前置说明（新手必看，别直接跳步骤）

• 开发类型：Spigot/Paper 服务端插件（市面上90%的生存、小游戏服务器用的都是这个，Paper兼容Spigot，优先Paper）
• 编程语言：必须Java，没有捷径！不用怕，零基础只需要会一点点基础语法就能写简单插件
• 适配版本：本文全程以主流 1.20.1 Paper服务端 举例，1.16~1.24全部通用，换对应依赖就行
• 电脑配置：普通办公本就能开发，不需要高配电脑
• 避坑前置：不要用Eclipse！直接用IDEA社区版，新手少80%配置报错，听我的没错

第一步：配齐全部开发环境（新手最容易翻车的一步）

很多新手卡死在环境配置，是版本没对应上。MC插件开发最核心的规则：JDK版本≈服务端版本，必须严格匹配

1.1 安装对应JDK

给大家整理好直接抄的版本对照表，不用自己查官网：

• 1.12及以下服务端 → JDK8（万年经典版本）
• 1.13~1.16 → JDK11
• 1.17~1.21 → JDK17（本文推荐安装）
• 1.22+ → JDK21

下载地址直接找OpenJDK17，免安装无广告，不要装Oracle收费JDK！安装全程默认下一步，安装完win+R输入cmd，输入 java -version 弹出版本号就是安装成功。

1.2 安装IDEA社区版（免费！免费！）

JetBrains官网下载IntelliJ IDEA Community，纯免费，不需要破解。
安装完成后第一件事：插件市场安装 Minecraft Development 插件
File->Settings->Plugins 搜索安装，重启IDEA。这个插件能自动补全MC代码、校验配置文件，新手刚需，不装写代码全是红报错。

1.3 准备一个可运行的Paper服务端

开发插件必须本地有服务器！不然没法测试。直接去PaperMC官网下载对应版本jar包，建一个空文件夹跑起来一次。
跑一次的目的：生成world地图、plugins文件夹。后续你写好的插件jar包，直接丢进plugins文件夹加载。
我踩过的大坑：不要用网上整合包当测试服务器！整合包插件太多，容易出现插件冲突，你根本分不清是自己代码写错还是插件冲突。纯净Paper服务端开发测试！

第二步：创建第一个插件项目（Maven方式，行业标准）

网上很多老教程教手动导入依赖，别用！后期插件做大了依赖爆炸、打包报错。现在所有专业MC开发者统一用Maven管理项目。

2.1 新建Maven空项目

1. IDEA左上角 File->New->Project
2. 选择Maven，下一步，不要勾选任何模板
3. 填写项目信息（随便写，自己能分清就行）

完成创建，等待右下角Maven索引加载完毕（第一次慢，耐心等）

• GroupId：一般写你的包名，比如 com.xiaozhou.mc
• ArtifactId：插件名字，比如 FirstMCPlugin（不能有中文空格）
• Version：1.0.0

懒得截图了，凑合着看吧