andy-k-sparklight/plugindiary

? ? ? 首页

欢迎阅读本教程，本教程旨在介绍基于 Bukkit API 的 Minecraft 服务端插件开发方法。

---

编写本教程的目的

笔者一开始编写插件是看 MCBBS 中的早期教程，然而那时候的教程无一例外使用的都是 Eclipse。对于笔者而言，曾经用 Eclipse 写 Mod 的痛苦还记忆犹新，因此笔者采用了 IDEA 进行开发。后来笔者又阅读了几份较新的教程，但发现有些部分它们并没有涵盖到（大致从本教程的第 4 章开始）。

笔者一度在反射和 MySQL 那里遇到困难，因此想与其在问答版回答问题还不如写成教程，于是便编写了这样一份教程。

关于本教程中部分内容的说明

1. 作者在编写时尽最大努力使内容真实有效，但无任何保证。
2. 对自然人的称呼中，使用某一特定的性别表述仅是为编写方便，并无任何象征或指代意义。
3. 如无特殊说明，本教程中的代码部分，作者授予您使用、复制、修改、再分发以及相关的权利，无需署名或申请额外的许可。仅仅代码部分才如此！部分代码不适用本条，它们拥有特别的许可协议。文本内容采用 CC-BY-3.0 协议许可，见下。
4. 教程中引用的所有文本内容均得到作者的或者该作品许可中的授权，效果截图来自作者计算机。
5. 音乐全部引用自 网易云音乐，本站点未存储任何文件。

技术信息

本教程站点是基于 docsify 构建的，采用了 docsify-themeable 进行渲染。

主要字体采用 FiraCode，按钮部分来自 Bootstrap，剧情模拟和行动确认是由笔者的 build.js 和 log.js 完成的。

保证页面正常运作的代码由 jsDelivr 为您加速。

Cloudflare Pages 托管了本站点。

---

侧边栏展现了整个教程的结构，单击即可跳转到对应章节。

法律信息

「本教程」指 https://plgdev.xuogroup.top/ 网站下的全部 HTML 页面以及 https://github.com/Andy-K-Sparklight/PluginDiary/ 所表示的 Git 仓库下的所有 Markdown 文件。链接到上述 HTML 页面中的样式表、字体、JavaScript 脚本等内容和上述 Git 仓库中非 Markdown 文件不属于「本教程」，它们适用单独的许可条款。「本站点」指 https://plgdev.xuogroup.top/ 网站下的全部 HTML 页面。

以下信息对「本教程」中所有内容适用。

本教程文字部分使用 知识共享署名 3.0 **大陆许可协议 进行许可。对于不适用该许可的部分，将适用其单独的许可条款。

本教程中少量游戏截图来自于游戏 《Minecraft: Java Edition》（《我的世界：Java 版》），根据其开发公司 Mojang Studios AB 在许可条款中的 相应说明，我们拥有将这些图片上传到第三方图片网站并链接到本站点的权利，截图由本教程作者制作。

Minecraft® 是瑞典 Mojang Studios AB 公司的商标。本教程不是 Minecraft 官方产品，不是来自 Minecraft 并且未经 Minecraft 认可。本教程与 Mojang Studios AB 没有关联，也不是来自 Mojang Studios AB。本教程与美国 Microsoft（微软）公司没有关联。

本教程与 GitHub 公司没有关联。

My Little Pony®、Friendship Is Magic™ 和 Equestria Girls™ 是美国 Hasbro（孩之宝）公司的商标或注册商标。本教程与 Hasbro 公司没有关联。

Java™ 是美国 Oracle（甲骨文）公司的商标。本教程与 Oracle 公司没有关联。

Eclipse® 是 Eclipse Foundation 的商标。本教程与 Eclipse Foundation 没有关联。

本教程与 JetBrains s.r.o. 没有关联。

本教程仅用于学习交流，其中任何内容均未被也不将被用于盈利。

「网易云音乐」服务是广州网易计算机系统有限公司提供的。该服务属于广州网易计算机系统有限公司。本教程的作者不能亦不会保证该服务的正常运行。

Spigot 服务端分发/下载服务是由 GetBukkit 组织 提供的。

本教程中提供的开发工具 AdoptOpenJDK、IntelliJ IDEA Community 以及使用到的软件 MySQL Community 等均是自由软件或在其许可条款中允许了我们将其链接到本站点。所有的链接都指向原始站点，本站点没有分发或存储任何相关文件。

部分内容出于教学目的选自网络，现在此注明出处：

• RUNOOB 菜鸟教程，已在 此处 得到了普适的授权。
• Bukkit Development Note，其许可协议已附在其首页。
• Paper-API JavaDocs，该网站的内容采用 MIT 许可证进行授权，见 此处。
• Hanbing‘s Blog，由于没有任何版权声明，我们仅以学习目的引用少量内容，且均注明了出处。
• 中文 Minecraft Wiki 镜像，由于要求相同方式共享，与我们的许可不兼容，因此仅链接到本站而不进行任何引用。
• GNU 官方站点，该站点使用 CC-BY-ND 4.0 知识共享许可证 授权。

plugindiary's Issues

5-7自定义进度 代码编译错误

载入进度 这部分中，第二块代码的第四行末尾f未定义
似乎是代码少截了一块？

图片挂了

感谢大佬无私教程 已经很有帮助了。我看好像是图床链接都挂了，大佬忙碌之余有空可以补补嘛

TR-1 JDK 镜像失效

教程TR-1部分中JDK 11的下载链接失效。

教程链接为https://plugin-diary.pages.dev/#/TR-1?id=jdk-11，
镜像链接为https://mirrors.tuna.tsinghua.edu.cn/Adoptium/11/jdk/x64/windows/OpenJDK11U-jdk_x64_windows_hotspot_11.0.15_10.msi

目前可用的下载链接为https://mirrors.tuna.tsinghua.edu.cn/Adoptium/11/jdk/x64/windows/OpenJDK11U-jdk_x64_windows_hotspot_11.0.19_7.msi

ThatRarityEG 所著《PluginDiary 插件开发教程》的维护问题

伏以：尊敬的 ThatRarityEG 函丈（即 Annie-K-Sparklight）已经退出 Minecraft 社区许久，其作品 PluginDiary 插件开发教程 https://www.mcbbs.net/thread-1163259-1-3.html 日渐失修。

首先，主要域名 plgdev.xuogroup.top 已亡。幸有 https://plugin-diary.pages.dev 尚存，然帖内仍以 plgdev.xuogroup.top 为“教程入口”，应当修改 MCBBS 主题帖。但 Annie 老师从未给予任何人协同编辑权限。好在尚有可能同论坛版主沟通。

其次，pages.dev 页面以本 Github 仓库 https://github.com/Andy-K-Sparklight/PluginDiary 为蓝本。该仓库系个人所有，若无 Annie 老师首肯，任何人不能修改。但老师已不再使用该账号了。因此，pages.dev 页面中的内容永远不可能改变。

再次，教程内容失于更新。如去年年初，图床停止运营。原有图片全无存档，并皆丢失。我非有续麟之笔，不能接西狩之坠绪。部分图片原貌，有文字记叙，可以推敲而后重绘，我窃不自揆，曾鍼小马之文（#3）。但对于用图片以展示原理、注释文字处，惟能阙如，以俟君子。又如，作为“实例型教程”，在源代码辗转抄写至教程内时也有漏处（#6）。另外，JDK 下载网址每每更新，近日又有人称网址过时（#7）。

最后，ThatRarityEG 老师曾建立过一个 Discord 聊天服务器用于讨论插件开发，定名云“PluginDiary 插件开发交流”。然而进入该服务器的邀请链接未公开发布，而是“私信获取”，自老师注销 MCBBS 账号以后，不能再私信联系。后她又将服务器移转给我，所愧管理不力，未作宣传，该聊天服务器已经名存实亡，沉寂许久，不能实现帮扶新人的原意。

故此，我拟建立一个 GitHub 组织，另建网站发布教程页面，以便更新。

@nanmenyangde @katorly @Deer403 @yinghaoting @RawDiamondMC

一切还需各位为教程作过贡献的道席们定夺。