Update tips

docs/Postface/Postface.md

@@ -7,7 +7,7 @@
 为了承接小马之坠绪，让她的学说不至失传，我们数位有意愿维护该教程者讨论后，决定设立 InsidePlugins 小组。意在依据 CC BY 3.0 协议，将教程的仓库公开化，以便协同维护。新网站定名《补订<插件开发日记>》。图片丢失，我们就补图。代码缺损，我们就增续。希望能让小马的照临洒遍瀛寰，辉曜万年！
 
 :::details 跋辤
-ThatRarityEG 道席攸著[《PluginDiary 插件開發敎程》](https://www.mcbbs.net/thread-1163259-1-3.html)一十卷，珊瑚鐵網，鉅細包羅。開發之流程，自斯統貫；龍頭之體例，爰始全明。昔其津逮後生，提携晚輩；夙勤對問，常務答疑。留句句之金銘，存條條之玉策。然而童生懵懂，不稽早勒之言；用戶衆多，難覈類同之惑。是故缀聯實例，垂不朽之箴；編輯教程，收常存之問。互見之辤，提編程之要；別箋之語，揀設計之金。版塊之中，遍播雅教；泥潭以内，盡灑照臨。體作文衡，布告則家家良善；例充玉尺，傳移則戶戶純深。其書則刺鳳描鸞，其人則驚才絕艷；高山仰止，難與並能。秉河、洛之瓊田，華、嵩之玉鑒，浮游塵垢，涅而不緇。組姆綠晶，曾無販售；提昇藍卡，並未鬻沽。兩載從師，得聞雅訓；四時苦學，方窺廳堂。惜之微軟并購魔鑽社以來，網易代理中國區之後，春秋迭代，社稷陵夷。小馬去故，敎程失修。聞者無人，[元刊](https://plugin-diary.pages.dev)在故帖之末尾；域名易主，[副墨](https://plgdev.xuogroup.top)居舊編之開宗。它若代碼璣零，圖牀璧碎；內容失效，反饋無門。雖則恩師之宗旨未移，體裁垂範；祇今旁引之文辭多佚，圖片幾亡。所賴生鑽、箋舟，共勤勘校；南門、主界，同務編摩。訪讀者於群聊，重裒舊畫；輯前賢之逸論，復作徵引。然則廪主離塵，空有遺冊；它人懷意，無所削刪。常楊稱頌於有唐，子產見褒於孔聖；都言叶作，全憑遭逢。況今一十卷之汗青，五十篇之別藏；虽游夏不能䦞色，子羽不能校刊；固非小馬攸期，大悖自由之旨。以是今日開舘，芟衍文於舊帙；明朝編竣，成佳事於藝林。縱無房杜之才，續麟之筆；敢賀群朋之盛，合作之興。區區竊不自揆，秤心斗膽，正慾導涓宗海，撮壤崇山。《日記》十函，編周千帙；綺交繡錯，綠煥光浮。丕昌丕承，輝映萬代！
+ThatRarityEG 道席攸著[《PluginDiary 插件開發敎程》](https://www.mcbbs.net/thread-1163259-1-3.html)一十卷，珊瑚鐵網，鉅細包羅。開發之流程，自斯統貫；龍頭之體例，爰始全明。昔其津逮後生，提携晚輩；夙勤對問，常務答疑。留句句之金銘，存條條之玉策。然而童生懵懂，不稽早勒之言；用戶衆多，難覈類同之惑。是故缀聯實例，垂不朽之箴；編輯教程，收常存之問。互見之辤，提編程之要；別箋之語，揀設計之金。版塊之中，遍播雅教；泥潭以内，盡灑照臨。體作文衡，布告則家家良善；例充玉尺，傳移則戶戶純深。其書則刺鳳描鸞，其人則驚才絕艷；高山仰止，難與並能。秉河、洛之瓊田，華、嵩之玉鑒，浮游塵垢，涅而不緇。組姆綠晶，曾無販售；提昇藍卡，並未鬻沽。余兩載從師，得聞雅訓；四時苦學，方窺廳堂。惜之微軟并購魔鑽社以來，網易代理中國區之後，春秋迭代，社稷陵夷。西席去故，敎程失修。聞者無人，[元刊](https://plugin-diary.pages.dev)在故帖之末尾；域名易主，[副墨](https://plgdev.xuogroup.top)居舊編之開宗。它若代碼璣零，圖牀璧碎；內容失效，反饋無門。雖則恩師之宗旨未移，體裁垂範；祇今旁引之文辭多佚，圖片幾亡。所賴生鑽、夜鶯，共勤勘校；礦工、魂梦，同務編摩。訪讀者於群聊，重裒舊畫；輯前賢之逸論，復作徵引。然則廪主離塵，空有遺冊；它人懷意，無所削刪。常楊稱頌於有唐，子產見褒於孔聖；都言叶作，全憑遭逢。況今一十卷之汗青，五十篇之別藏；虽游夏不能䦞色，子羽不能校刊；固非小馬攸期，大悖自由之旨。以是今日開舘，芟衍文於舊帙；明朝編竣，成佳事於藝林。縱無房杜之才，續麟之筆；敢賀群朋之盛，合作之興。區區竊不自揆，秤心斗膽，正慾導涓宗海，撮壤崇山。《日記》十函，編周千帙；綺交繡錯，綠煥光浮。丕昌丕承，輝映萬代！
 :::
 
 ![](data:image/png;base64,R0lGODlhAQABAIAAAAAAAP///yH5BAkAAAEALAAAAAABAAEAAAICTAEAOw==)

docs/Volume0/HomePage_Original.md

@@ -3,15 +3,20 @@
 欢迎阅读本教程，本教程旨在介绍基于 Bukkit API 的 Minecraft 服务端插件开发方法。
 
 ::: tip <img src="data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 1028 1024' transform='scale(0.6)' fill='%23fff'%3E%3Cpath d='M1018.319924 112.117535q4.093748 9.210934 6.652341 21.492179t2.558593 25.585928-5.117186 26.609365-16.374994 25.585928q-12.281245 12.281245-22.003898 21.492179t-16.886712 16.374994q-8.187497 8.187497-15.351557 14.32812l-191.382739-191.382739q12.281245-11.257808 29.167958-27.121083t28.144521-25.074209q14.32812-11.257808 29.679676-15.863275t30.191395-4.093748 28.656239 4.605467 24.050772 9.210934q21.492179 11.257808 47.589826 39.402329t40.425766 58.847634zM221.062416 611.554845q6.140623-6.140623 28.656239-29.167958t56.289041-56.80076l74.710909-74.710909 82.898406-82.898406 220.038979-220.038979 191.382739 192.406177-220.038979 220.038979-81.874969 82.898406q-40.937484 39.914047-73.687472 73.175753t-54.242167 54.753885-25.585928 24.562491q-10.234371 9.210934-23.539054 19.445305t-27.632802 16.374994q-14.32812 7.16406-41.960921 17.398431t-57.824197 19.957024-57.312478 16.886712-40.425766 9.210934q-27.632802 3.070311-36.843736-8.187497t-5.117186-37.867173q2.046874-14.32812 9.722653-41.449203t16.374994-56.289041 16.886712-53.730448 13.304682-33.773425q6.140623-14.32812 13.816401-26.097646t22.003898-26.097646z'/%3E%3C/svg%3E" style="background-color:#057E3D; clip-path: circle();" width="24px" height="24px"> **编者注**
+《PluginDiary 插件开发教程》，又名《插件开发日记》，原有五十七篇，ThatRarityEG 撰。该教程将 Bukkit 插件开发的流程向新手娓娓道来，深入浅出，历来为人称颂。可惜作者不满于网易代理中国区《我的世界》后的所作所为，于二〇二三年初愤而离去，永久注销了自己在各个平台的社交媒体账号，彻底退出了 Minecraft 编程开发社区。
+
+自小马退出社区以后，教程内容失修。为了使其学说不至失传，我们数位有意愿维护《日记》的开发者讨论后，决定设立 InsidePlugins 小组。意在依据 CC BY 3.0 协议，架设新网站、共同维护该教程。定名《补订<插件开发日记>》。
+
+以下内容，如无特别标注，都为 ThatRarityEG 所写原文。一切「笔者」，都是小马自称，编者不敢僭越。后来添加的内容，都用「编者注」标出，以便区别。至于过时的链接、失效的图片，则直接在原处更新，以免内容支离破碎。
 :::
 
 ---
 
 ## 编写本教程的目的
 
-笔者一开始编写插件是看 `MCBBS` 中的早期教程，然而那时候的教程无一例外使用的都是 `Eclipse`。对于笔者而言，曾经用 `Eclipse` 写 `Mod` 的痛苦还记忆犹新，因此笔者采用了 IDEA 进行开发。后来笔者又阅读了几份较新的教程，但发现有些部分它们并没有涵盖到（大致从本教程的 `第 4 章` 开始）。
+笔者一开始编写插件是看 [MCBBS](https://www.mcbbs.net) 中的早期教程，然而那时候的教程无一例外使用的都是 Eclipse。对于笔者而言，曾经用 Eclipse 写 Mod 的痛苦还记忆犹新，因此笔者采用了 IDEA 进行开发。后来笔者又阅读了几份较新的教程，但发现有些部分它们并没有涵盖到（大致从本教程的第 4 章开始）。
 
-笔者一度在 `反射` 和 `MySQL` 那里遇到困难，因此想与其在问答版回答问题还不如写成教程，于是便编写了这样一份教程。
+笔者一度在反射和 MySQL 那里遇到困难，因此想与其在问答版回答问题还不如写成教程，于是便编写了这样一份教程。
 
 ## 关于本教程中部分内容的说明
 
@@ -23,11 +28,13 @@
 
 ## 技术信息
 
-本教程站点是基于 [Vitepress](https://vitepress.dev/) 构建的，笔者自行编写了数个 CSS 文件，使其外观接近 [docsify](https://docsify.js.org/#/) 所渲染的站点。
+::: tip <img src="data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 1028 1024' transform='scale(0.6)' fill='%23fff'%3E%3Cpath d='M1018.319924 112.117535q4.093748 9.210934 6.652341 21.492179t2.558593 25.585928-5.117186 26.609365-16.374994 25.585928q-12.281245 12.281245-22.003898 21.492179t-16.886712 16.374994q-8.187497 8.187497-15.351557 14.32812l-191.382739-191.382739q12.281245-11.257808 29.167958-27.121083t28.144521-25.074209q14.32812-11.257808 29.679676-15.863275t30.191395-4.093748 28.656239 4.605467 24.050772 9.210934q21.492179 11.257808 47.589826 39.402329t40.425766 58.847634zM221.062416 611.554845q6.140623-6.140623 28.656239-29.167958t56.289041-56.80076l74.710909-74.710909 82.898406-82.898406 220.038979-220.038979 191.382739 192.406177-220.038979 220.038979-81.874969 82.898406q-40.937484 39.914047-73.687472 73.175753t-54.242167 54.753885-25.585928 24.562491q-10.234371 9.210934-23.539054 19.445305t-27.632802 16.374994q-14.32812 7.16406-41.960921 17.398431t-57.824197 19.957024-57.312478 16.886712-40.425766 9.210934q-27.632802 3.070311-36.843736-8.187497t-5.117186-37.867173q2.046874-14.32812 9.722653-41.449203t16.374994-56.289041 16.886712-53.730448 13.304682-33.773425q6.140623-14.32812 13.816401-26.097646t22.003898-26.097646z'/%3E%3C/svg%3E" style="background-color:#057E3D; clip-path: circle();" width="24px" height="24px"> **编者注**
+本教程站点是基于 [Vitepress](https://vitepress.dev/) 构建的，编者自行编写了数个 CSS 文件，使其外观接近 [docsify](https://docsify.js.org/#/) 所渲染的站点。
 
-主要字体采用 [FiraCode](https://github.com/tonsky/FiraCode)，剧情模拟和行动确认是由笔者的 Vue SFC 完成的。
+主要字体采用 [FiraCode](https://github.com/tonsky/FiraCode)，剧情模拟和行动确认是由编者的 Vue SFC 完成的。
 
 本教程原是 ThatRarityEG 所著，自她去故离尘以后，InsidePlugins 小组维护本站点。技术信息详见[《跋辞》](https://plugindiary.pvpin.org/Postface/Postface.html)、[《重梓<日记>纪事》](https://plugindiary.pvpin.org/Postface/Log.html)。
+:::
 
 :::details 旧技术信息（现已失效）
 本教程站点是基于 [docsify](https://docsify.js.org/#/) 构建的，采用了 [docsify-themeable](https://jhildenbiddle.github.io/docsify-themeable/) 进行渲染。
@@ -45,7 +52,9 @@
 
 ## 法律信息
 
+::: tip <img src="data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 1028 1024' transform='scale(0.6)' fill='%23fff'%3E%3Cpath d='M1018.319924 112.117535q4.093748 9.210934 6.652341 21.492179t2.558593 25.585928-5.117186 26.609365-16.374994 25.585928q-12.281245 12.281245-22.003898 21.492179t-16.886712 16.374994q-8.187497 8.187497-15.351557 14.32812l-191.382739-191.382739q12.281245-11.257808 29.167958-27.121083t28.144521-25.074209q14.32812-11.257808 29.679676-15.863275t30.191395-4.093748 28.656239 4.605467 24.050772 9.210934q21.492179 11.257808 47.589826 39.402329t40.425766 58.847634zM221.062416 611.554845q6.140623-6.140623 28.656239-29.167958t56.289041-56.80076l74.710909-74.710909 82.898406-82.898406 220.038979-220.038979 191.382739 192.406177-220.038979 220.038979-81.874969 82.898406q-40.937484 39.914047-73.687472 73.175753t-54.242167 54.753885-25.585928 24.562491q-10.234371 9.210934-23.539054 19.445305t-27.632802 16.374994q-14.32812 7.16406-41.960921 17.398431t-57.824197 19.957024-57.312478 16.886712-40.425766 9.210934q-27.632802 3.070311-36.843736-8.187497t-5.117186-37.867173q2.046874-14.32812 9.722653-41.449203t16.374994-56.289041 16.886712-53.730448 13.304682-33.773425q6.140623-14.32812 13.816401-26.097646t22.003898-26.097646z'/%3E%3C/svg%3E" style="background-color:#057E3D; clip-path: circle();" width="24px" height="24px"> **编者注**
 本教程原是 ThatRarityEG 所著，自她去故离尘以后，InsidePlugins 小组维护本站点，此处所言的部分法律信息已经过时。出于尊重原作者之故，仍然保留旧有法律信息的原文，但全部按失效处理。本教程法律信息详见[《跋辞》](https://plugindiary.pvpin.org/Postface/Postface.html#版权信息)。
+:::
 
 :::details 旧法律信息（现已失效）
 「本教程」指 https://plgdev.xuogroup.top/ 网站下的全部 HTML 页面以及 https://github.com/Andy-K-Sparklight/PluginDiary/ 所表示的 Git 仓库下的所有 Markdown 文件。链接到上述 HTML 页面中的样式表、字体、JavaScript 脚本等内容和上述 Git 仓库中非 Markdown 文件不属于「本教程」，它们适用单独的许可条款。「本站点」指 https://plgdev.xuogroup.top/ 网站下的全部 HTML 页面。
@@ -86,4 +95,4 @@ Spigot 服务端分发/下载服务是由 [GetBukkit 组织](https://getbukkit.o
 - [Hanbing‘s Blog](https://hanbings.github.io/2020/08/17/%E7%A5%9E%E5%A5%87%E7%9A%84Bukkit%E7%AC%94%E8%AE%B0-%E6%8F%92%E4%BB%B6%E5%AF%B9%E5%85%B6%E4%BB%96%E6%8F%92%E4%BB%B6%E7%9A%84%E8%BD%AF%E4%BE%9D%E8%B5%96/)，由于没有任何版权声明，我们仅以学习目的引用少量内容，且均注明了出处。
 - [中文 Minecraft Wiki 镜像](https://wiki.biligame.com/mc/Minecraft_Wiki)，由于要求相同方式共享，与我们的许可不兼容，因此仅链接到本站而不进行任何引用。
 - [GNU 官方站点](https://www.gnu.org)，该站点使用 [CC-BY-ND 4.0 知识共享许可证](https://creativecommons.org/licenses/by-nd/4.0/) 授权。
-:::
+:::

docs/Volume0/Preface_Original.md

@@ -1,10 +1,10 @@
 # 0 写在前面的话
 
-现在，`Minecraft 多人游戏` 已经成为了许多玩家的乐趣，毕竟和其它玩家一起玩才算得上是个「世界」嘛。
+现在，Minecraft 多人游戏已经成为了许多玩家的乐趣，毕竟和其它玩家一起玩才算得上是个「世界」嘛。
 
 既然你来到了这里，你应该是准备开发一个插件了。
 
-一说到插件，很多人可能会觉得高深莫测（如果不是那更好啊），这种结果一定是部分插件开发人员的阴谋（笑），其人故意让我们觉得开发插件很困难，这样就可以宣传自己的插件……
+一说到插件，很多人可能会觉得高深莫测（如果不是那更好啊），这种结果一定是部分插件开发人员的阴谋（笑），那些人故意让我们觉得开发插件很困难，这样就可以宣传自己的插件……
 
 这当然只是玩笑，但插件开发确实没有想象中那么难。只要你有一些编程经验，自己写过几个程序（即使是「Hello World」这样的），学习插件开发就不在话下。
 

docs/Volume1/EX-0-1.md

@@ -43,7 +43,9 @@
 
 按下 <kbd>Ctrl</kbd> + <kbd>Alt</kbd> + <kbd>Shift</kbd> + <kbd>S</kbd> 打开「Project Structure」面板，转到左边的「Modules」，按「-」移除所有现有的 Module。
 
-注：ThatRarityEG 所写的快捷键适用于 IntelliJ IDEA for Windows。使用其它操作系统的用户，可以点击左上角 Files 唤出下拉列表，再单击 Project Structure 按钮打开面板。
+::: tip <img src="data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 1028 1024' transform='scale(0.6)' fill='%23fff'%3E%3Cpath d='M1018.319924 112.117535q4.093748 9.210934 6.652341 21.492179t2.558593 25.585928-5.117186 26.609365-16.374994 25.585928q-12.281245 12.281245-22.003898 21.492179t-16.886712 16.374994q-8.187497 8.187497-15.351557 14.32812l-191.382739-191.382739q12.281245-11.257808 29.167958-27.121083t28.144521-25.074209q14.32812-11.257808 29.679676-15.863275t30.191395-4.093748 28.656239 4.605467 24.050772 9.210934q21.492179 11.257808 47.589826 39.402329t40.425766 58.847634zM221.062416 611.554845q6.140623-6.140623 28.656239-29.167958t56.289041-56.80076l74.710909-74.710909 82.898406-82.898406 220.038979-220.038979 191.382739 192.406177-220.038979 220.038979-81.874969 82.898406q-40.937484 39.914047-73.687472 73.175753t-54.242167 54.753885-25.585928 24.562491q-10.234371 9.210934-23.539054 19.445305t-27.632802 16.374994q-14.32812 7.16406-41.960921 17.398431t-57.824197 19.957024-57.312478 16.886712-40.425766 9.210934q-27.632802 3.070311-36.843736-8.187497t-5.117186-37.867173q2.046874-14.32812 9.722653-41.449203t16.374994-56.289041 16.886712-53.730448 13.304682-33.773425q6.140623-14.32812 13.816401-26.097646t22.003898-26.097646z'/%3E%3C/svg%3E" style="background-color:#057E3D; clip-path: circle();" width="24px" height="24px"> **编者注**
+ThatRarityEG 所写的快捷键适用于 IntelliJ IDEA for Windows。使用其它操作系统的用户，可以点击左上角 Files 唤出下拉列表，再单击 Project Structure 按钮打开面板。
+:::
 
 现在，按「+」、「New Module」，弹出一个新的窗口，选择侧边的「Java」，单击「Next」。
 
@@ -60,7 +62,6 @@
 ![DONE.png](https://s2.loli.net/2022/04/15/jlKGACFo9zsMva4.png)
 
 ::: info <img src="data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 16 16' transform='scale(0.6)' fill='%23fff'%3E%3Cpath d='M9.1 0C10.2 0 10.7 0.7 10.7 1.6 10.7 2.6 9.8 3.6 8.6 3.6 7.6 3.6 7 3 7 2 7 1.1 7.7 0 9.1 0Z'/%3E%3Cpath d='M5.8 16C5 16 4.4 15.5 5 13.2L5.9 9.1C6.1 8.5 6.1 8.2 5.9 8.2 5.7 8.2 4.6 8.6 3.9 9.1L3.5 8.4C5.6 6.6 7.9 5.6 8.9 5.6 9.8 5.6 9.9 6.6 9.5 8.2L8.4 12.5C8.2 13.2 8.3 13.5 8.5 13.5 8.7 13.5 9.6 13.2 10.4 12.5L10.9 13.2C8.9 15.2 6.7 16 5.8 16Z'/%3E%3C/svg%3E" style="background-color:#0B87DA; clip-path: circle();" width="24px" height="24px"> **到底怎么回事**？
-
 一个 Java 项目当然不可能是由一个人完成的，你需要编写的代码往往已经有开发者编写过了，这就叫**轮子**（Wheel）。如果你的项目要使用它，就要把它**导入**。导入的**轮子**就叫**依赖**（Dependency）。
 
 这里添加了什么依赖呢？`spigot-1.16.5.jar` ……那不就是**服务器**（Server）嘛！