第1课全能管理员 (Essentials Lite) —— 开启上帝模式

课程时长：120 分钟
技术栈：IntelliJ IDEA + Spigot API 1.21.1 + AI 助手 (Cursor/ChatGPT)
核心目标：理解“指令-执行”模型，掌握 AI 意图驱动编程（Vibe Coding），实现服务器基础管理功能。

一、任务背景 (Mission Background)

你是这个 Minecraft 世界的创世神。为了高效管理服务器，你需要一套“管理员工具包”。今天，我们将亲手打造属于你的 Essentials 插件，实现回血、飞行和填满肚子等“神迹”。

二、学习路线图 (Technical Map)

编程技能：Java 类结构、方法重写 (onCommand)、条件判断 (if-else)。
工程思维：输入校验（防止报错）、权限控制（防止普通玩家作乱）、反馈机制。
AI 素养：结构化提示词 (Prompt)、代码理解与逻辑微调。

三、核心项目：上帝指令集 (Sprint 1: 45 min)

安装开发工具

IntelliJ IDEA

安装插件

Minecraft Development

TRAE AI

新建 Mine craft项目

任务一：测试控制台消息

源码：Command_set.java

任务二：/heal 指令

源码：Command_set.java

源码：healcommand.java

源码：plugin.yml

1. AI 意图驱动开发 (Vibe Coding)

不要急着敲代码，先向你的 AI 助教发送你的“意图”。

推荐 Prompt（提示词）：

“我正在开发一个 Minecraft 1.21.11 的 Spigot 插件。请帮我生成一个 Java 类来实现指令 /heal。
1功能：当玩家输入该指令，生命值恢复到最大。
2权限：只有拥有 mcp.admin 权限的人才能使用。
3消息：完成后给玩家发送一条‘血量已恢复’的绿色文字消息。”

2. 代码集成与理解

在 IntelliJ 中通过 Minecraft Development 插件新建项目。
将 AI 生成的代码粘贴到你的 CommandExecutor 类中。
关键代码解析 (AI 助教解释点)：
- if (!(sender instanceof Player))：为什么必须检查发送者是不是玩家？（防止后台控制台自杀）。
- p.setHealth(20.0)：20 代表多少颗心？

3. 注册指令 (The “Hook”)

打开 plugin.yml。
任务：手动添加指令声明。AI 可能会漏掉这一步，这是最容易导致“Unknown Command”错误的地方。

四、多任务挑战 (Sprint 2: 45 min)

在核心功能跑通后，你需要并行处理以下任务，像真正的工程师一样迭代产品：

任务等级	任务名称	功能描述	AI 协助方向
基础版	/fly 指令	开启/关闭飞行模式。	“如何切换玩家的 allowFlight 状态？”
进阶版	颜色代码支持	让插件发出的消息带颜色（如绿色成功，红色错误）。	“Java 中如何处理 &a 这种颜色符号？”
专家版	远程操控	/heal [player] 给指定好友回血。	“如何通过名字获取在线玩家对象？”

五、工程思维：鲁棒性测试 (Testing & Debug: 20 min)

工程师准则：永远假设用户会乱来。
请尝试在游戏中进行以下测试，并利用 AI 修复 Bug：

控制台测试：在服务器黑窗口输入 heal，服务器会崩溃吗？还是会友好提示？
权限测试：让自己变成普通玩家（/deop），测试是否还能使用上帝指令。
参数测试：输入 /heal 12345（乱码参数），插件会报错还是忽略？

六、自学习与探究 (Self-Learning)

观察与思考：

代码复用：/heal 和 /feed 的代码非常相似，能不能让 AI 帮我写一个通用的方法来处理它们，减少重复代码？
API 文档：让 AI 解释一下 p.setFoodLevel(20) 和 p.setSaturation(5f) 的区别是什么？

七、成果交付 (Deliverables)

JAR 包导出：使用 Maven 的 package 功能导出你的插件。
演示：在联机环境下，当着老师和同学的面，展示你如何通过一条指令拯救濒死的队友。
Prompt 笔记：记录下今天你觉得最有效的一条 AI 提示

八、老师的 Vibe Tips (结语)

“在 Vibe Coding 的时代，代码是廉价的，意图是昂贵的。不要满足于 AI 给你的一串字母，要学会审视它：这段代码安全吗？它能让玩家觉得好玩吗？这就是你的工程思维初体验。”

下一个