补充+修正格式

2024-06-23 21:59:20 +08:00 · 2024-06-23 21:59:20 +08:00 · e25b2af9c5
commit e25b2af9c5
parent ca062e04df
13 changed files with 187 additions and 174 deletions
--- a/docs/preparation/download-and-install-java.md
+++ b/docs/preparation/download-and-install-java.md
@ -22,7 +22,7 @@ sidebar_position: 2

 :::danger

-32位操作系统开服开个鬼服
+32位操作系统开服开个鬼服...

 [32位 64位是什么意思](https://cn.bing.com/search?q=32%E4%BD%8D%2064%E4%BD%8D%E6%98%AF%E4%BB%80%E4%B9%88%E6%84%8F%E6%80%9D)

@ -44,53 +44,53 @@ sidebar_position: 2
 ![](_images/Oracle-3.png)
 ![](_images/Oracle-4.png)

-> 如果再往下翻的话可以看到 Java 8 / 11。
+如果再往下翻的话可以看到 Java 8 / 11。

 ![](_images/Oracle-5.png)

-> 但是在这里 Java 8 需要登录才能下载。
->
-> 你可以在下方链接直接下载 Java 8。
->
-> > https://www.java.com/zh-CN/download/
+但是在这里 Java 8 需要登录才能下载。
+
+你可以在下方链接直接下载 Java 8：
+
+https://www.java.com/zh-CN/download/
 </details>

 ### Zulu 版

-根据各路大佬的测试 Zulu 相较 Oracle (你可以看做"公版")更适合开 MC 服务器
+根据各路大佬的测试 Zulu 相较 Oracle (你可以看做"公版") 更适合开 MC 服务器。

 <details>
  <summary>怎么找到官网并从官网下载</summary>

 ![](_images/Zulu-1.png)

-> 往下翻，找到这个，选择你想要的版本
+往下翻，找到这个，选择你想要的版本：

 ![](_images/Zulu-2.png)

-> 找到 64-bit (64位) （如果你的电脑是32位的，建议不开服）。
+找到 64-bit (64位) （如果你的电脑是32位的，建议不开服）：

 ![](_images/Zulu-3.png)

-> 如果您不能安装此软件（如不兼容），请关闭此文档，且**不要向**文档编写者们提问，感谢。
+如果您不能安装此软件（如不兼容），请关闭此文档，且**不要向**文档编写者们提问，感谢。
 </details>


 ## 验证 Java 安装

-打开 Windows 终端 / PowerShell / CMD。
+打开 Windows 终端 / PowerShell / CMD 。

 [怎么打开 Windows 终端](https://cn.bing.com/search?q=%E6%80%8E%E4%B9%88%E6%89%93%E5%BC%80windows%E6%8E%A7%E5%88%B6%E5%8F%B0)

 ![](_images/cmd-1.png)

-输入
+输入：

 ```
 java -version
 ```

-并回车
+并回车：

 ![](_images/cmd-2.png)

--- a/docs/preparation/dumb-script-using.md
+++ b/docs/preparation/dumb-script-using.md
@ -13,7 +13,7 @@ sidebar_position: 5

 ## 功能

-目前，我们已经编写了以下的笨蛋脚本
+目前，我们已经编写了以下的笨蛋脚本：

 * 自动优化服务端配置文件
 * 自动配置防矿透
@ -61,9 +61,9 @@ pip install pyyaml install-jdk tqdm psutil requests rtoml

 ## 了解

-在启动这个脚本之前，你应该**明白我正在干什么，会导致什么后果**，以优化脚本举例，你应该明白，执行这个脚本之后，村民的 AI 会受到限制，变得有点傻（当然不止这个，还有其他）
+在启动这个脚本之前，你应该**明白我正在干什么，会导致什么后果**，以优化脚本举例，你应该明白，执行这个脚本之后，村民的 AI 会受到限制，变得有点傻（当然不止这个，还有其他）。

-我们拒绝回答一切在启动笨蛋脚本之前不看文档的问题
+我们拒绝回答一切在启动笨蛋脚本之前不看文档的问题。

 ## 宗旨

--- a/docs/preparation/text-editor.md
+++ b/docs/preparation/text-editor.md
@ -9,19 +9,17 @@ sidebar_position: 1

 # 记得保存文件

-发现有人第一次用文本编辑器不知道编辑完后保存
+发现有人第一次用文本编辑器不知道编辑完后保存。

 ![](_images/白点.png)

-vscode会在未保存的文件后标记一个白点，提示你这个文件编辑了但是没有保存（其他文本编辑器类似）
+vscode会在未保存的文件后标记一个白点，提示你这个文件编辑了但是没有保存（其他文本编辑器类似）。

 ![](_images/vscode保存和自动保存.png)

-保存按钮（红色箭头）
+保存按钮（红色箭头），也可以用快捷键来保存 Ctrl + S 。

-> 不过我更喜欢用快捷键来保存 Ctrl + S
-
-开启自动保存（绿色箭头）
+开启自动保存（绿色箭头）。

 ~~当年TrMenu的自动重载治好了我的autosave~~

@ -34,7 +32,7 @@ vscode会在未保存的文件后标记一个白点，提示你这个文件编

 全能型文本编辑器，**非常非常推荐**，支持简体中文 / 繁体中文 / 英文，仅支持 `Windows 10 +`。

-缺点是启动速度可能不是很快，不过非常适合新手使用
+缺点是启动速度可能不是很快，不过非常适合新手使用。

 官网链接：https://code.visualstudio.com/

@ -77,7 +75,7 @@ vscode会在未保存的文件后标记一个白点，提示你这个文件编

 ![Notepad3](https://www.rizonesoft.com/wp-content/uploads/2023/09/notepad3-screenshot-1.jpg)

-也是一个比较不错的文本编辑器。要求：**Windows 8 +**
+也是一个比较不错的文本编辑器。要求：**Windows 8 +**。

 官网链接: https://rizonesoft.com/downloads/notepad3/

@ -92,17 +90,17 @@ GitHub: https://github.com/rizonesoft/Notepad3

 ![NPPesu](_images/Npp展示.png)

-可用, 相关功能也较为完善
+可用, 相关功能也较为完善。

 :::wanning

-作者政治立场可能引起众怒, 但请理性看待
+作者政治立场可能引起众怒, 但请理性看待：

-[notepad++](http://www.notepadplus.com.cn/)台独+多次辱 H [这里](https://cn.bing.com/search?q=notepad%252B%252B%E8%BE%B1%E5%8D%8E)
+[notepad++](http://www.notepadplus.com.cn/)台独 + 多次辱H [这里](https://cn.bing.com/search?q=notepad%252B%252B%E8%BE%B1%E5%8D%8E)。

-dizhi 08年奥运会 声称（仅声明，但还是挺过分的）不同意它的政治观点就在你的源码中添加随机字符 [这里](https://zhuanlan.zhihu.com/p/609192758)
+dizhi 08年奥运会 声称（仅声明，但还是挺过分的）不同意它的政治观点就在你的源码中添加随机字符 [这里](https://zhuanlan.zhihu.com/p/609192758)。

-可替代为 **Notepad--** 等
+可替代为 **Notepad--** 等。

 :::

@ -135,7 +133,7 @@ dizhi 08年奥运会 声称（仅声明，但还是挺过分的）不同意它

 #### 关联右键菜单?

-可以在工具→设置(Ctrl+Alt+，)打开设置，找到“常用配置”手动选中【关联右键菜单】
+可以在工具→设置(Ctrl+Alt+，)打开设置，找到“常用配置”手动选中【关联右键菜单】。

 </details>

--- a/docs/preparation/websites.md
+++ b/docs/preparation/websites.md
@ -9,7 +9,7 @@ sidebar_position: 4

 # SpigotMC

-Minecraft 最大的插件网站，***建议注册账号并安装[Spigot Search Engine](https://www.spigotmc.org/resources/spigotsearchengine.54108/)***
+Minecraft 最大的插件网站，***建议注册账号并安装 [Spigot Search Engine](https://www.spigotmc.org/resources/spigotsearchengine.54108/)***

 <details>
  <summary>点击展开</summary>
@ -26,18 +26,16 @@ Minecraft 最大的插件网站，***建议注册账号并安装[Spigot Search E
    </td>
  </tr>

-SpigotMC 应该是目前 Minecraft 开服圈最大的插件网站了，最大的问题是搜索引擎拉胯。
+SpigotMC 应该是目前 Minecraft 开服圈最大的插件网站了，最大的问题是插件搜索引擎十分狗屎。

 <details>
  <summary>注册问题</summary>

 ![](_images/spigotmc.png)

-使用魔法就可以看到验证了，而不是傻呵呵的跟人说
+使用魔法就可以看到验证了，而不是傻呵呵的跟人说。

-**SpigotMC不开放注册**
-
-**老外的网站真反人类**
+*SpigotMC不开放注册* *老外的网站真反人类*

 </details>

@ -47,7 +45,7 @@ SpigotMC 应该是目前 Minecraft 开服圈最大的插件网站了，最大的

 # GitHub

-全球最大的代码托管平台 ***建议注册账号***
+全球最大的代码托管平台 ***建议注册账号***。

 <details>
  <summary>点击展开</summary>
@ -64,13 +62,13 @@ SpigotMC 应该是目前 Minecraft 开服圈最大的插件网站了，最大的
    </td>
  </tr>

-全球最大的社交编程及代码托管网站
+全球最大的社交编程及代码托管网站。

-许多开发者会把自己编写的插件发到 GitHub
+许多开发者会把自己编写的插件发到 GitHub。

-虽然不登录账号不影响你浏览仓库和下载 Release 等
+虽然不登录账号不影响你浏览仓库和下载 Release 等。

-但是登录后可以给作者发 Issues 来报告问题，提交新需求/建议，还可以下载 Actions 中的文件
+但是登录后可以给作者发 Issues 来报告问题，提交新需求/建议，还可以下载 Actions 中的文件。

 <details>
  <summary>注册问题</summary>
@ -82,16 +80,14 @@ SpigotMC 应该是目前 Minecraft 开服圈最大的插件网站了，最大的
 <details>
  <summary>连不上怎么办</summary>

-使用魔法或者
-
-[点击此处](https://cn.bing.com/search?q=%E8%BF%9E%E4%B8%8D%E4%B8%8AGitHub%E6%80%8E%E4%B9%88%E5%8A%9E)
+使用魔法或者[点击此处](https://cn.bing.com/search?q=%E8%BF%9E%E4%B8%8D%E4%B8%8AGitHub%E6%80%8E%E4%B9%88%E5%8A%9E)

 </details>

 <details>
  <summary>下载太慢怎么办</summary>

-使用魔法或者用加速地址
+使用魔法或者用加速地址：

 https://gitmirror.com/files.html

@ -134,7 +130,9 @@ GitHub 汉化插件：https://github.com/maboloshi/github-chinese

 # Builtbybit

-一个综合软件资源站，其中的 Minecraft 插件大多数都是付费的。
+一个综合交易平台，其中的 Minecraft 插件大多数都是付费的。
+
+有一些圈钱的垃圾插件，请仔细辨别后购买。

 <details>
  <summary>点击展开</summary>
@ -151,9 +149,9 @@ GitHub 汉化插件：https://github.com/maboloshi/github-chinese
    </td>
  </tr>

-如果你的钱包空空就别考虑了
+如果你的钱包空空就别考虑了。

-此外，此网站和 CurseForge 一样并不只有 Minecraft 相关改装资源，请注意识别别看错了
+此外，此网站和 CurseForge 一样并不只有 Minecraft 相关资源，请注意识别别看错了。

 *链接已重定向到 Minecraft 相关资源区*
 地址：https://builtbybit.com/resources/categories/minecraft-plugins.1/
@ -162,7 +160,7 @@ GitHub 汉化插件：https://github.com/maboloshi/github-chinese

 # Polymart

-一个拥有部分 Minecraft 插件的综合软件下载平台。
+一个 Minecraft 服务器付费插件资源平台。

 <details>
  <summary>点击展开</summary>
@ -179,8 +177,6 @@ GitHub 汉化插件：https://github.com/maboloshi/github-chinese
    </td>
  </tr>

-和 CurseForge、Modrinth 一样并不只有插件资源，也还有付费资源
-
 地址：https://polymart.org

 </details>
@ -204,19 +200,15 @@ GitHub 汉化插件：https://github.com/maboloshi/github-chinese
    </td>
  </tr>

-（对没错这是个资源站我没开玩笑😅）
+开一些低版本服务器可能用得到。

-Bukkit 为 Minecraft 社区提供一个强大，精心设计和深思熟虑的解决方案，以扩展和控制其服务器，于是便有了这个站点
-
-你可以在此查找到那些从远古时期就存在的插件
-
-地址：https://dev.bukkit.org/
+地址：https://dev.bukkit.org/bukkit-plugins

 </details>

 # Modrinth

-现代化的 Minecraft 新兴资源站，插件相对较新较少。
+现代化的 Minecraft 新兴资源站，插件相对较新较少，而且大部分都开源。

 <details>
  <summary>点击展开</summary>
@ -233,9 +225,9 @@ Bukkit 为 Minecraft 社区提供一个强大，精心设计和深思熟虑的
    </td>
  </tr>

-Modrinth 闪电般的搜索速度和强大的过滤器可让您在输入时找到所需的内容
+插件搜索引擎比 spigot 强了好几倍。

-因为是新兴资源站，某些资源并未在此发布，但是足够你用了
+因为是新兴资源站，某些资源并未在此发布，但是足够你用了。

 地址：https://modrinth.com/

@ -243,7 +235,7 @@ Modrinth 闪电般的搜索速度和强大的过滤器可让您在输入时找

 # PaperMC

-Paper 的现代化的插件平台，目前正在 Beta 阶段，插件相对较新较少。
+Paper 的现代化的插件平台，目前正在 Beta 阶段，插件相对较新较少，但是都经过 Paper 官方验证，并且可以找到支持 Folia 和 Velocity 的插件。

 <details>
  <summary>点击展开</summary>
@ -260,7 +252,7 @@ Paper 的现代化的插件平台，目前正在 Beta 阶段，插件相对较
    </td>
  </tr>

-对于 Folia 服务器找插件的一个好去处，PaperMC 提供的全新插件搜索平台，相较 Spigot 落后的搜索引擎有所提升。
+插件搜索引擎比 spigot 强了好几倍。

 地址：https://hangar.papermc.io/

@ -268,7 +260,7 @@ Paper 的现代化的插件平台，目前正在 Beta 阶段，插件相对较

 # MOTD 生成网站

-MOTD 就是 Minecraft 客户端在尝试连接服务器之前，服务器对客户端发送的一条短消息，这通常包含1-3行文字和一张图片
+MOTD 就是 Minecraft 客户端在尝试连接服务器之前，服务器对客户端发送的一条短消息，这通常包含1-3行文字和一张图片。

 <details>
  <summary>听不懂描述就展开看图</summary>
@ -279,7 +271,7 @@ MOTD 就是 Minecraft 客户端在尝试连接服务器之前，服务器对客

 MOTD 是玩家进入服务器之前最先看到的东西，决定了玩家对一个服务器的第一印象，所以，请任选一个 MOTD 生成器生成个性化 MOTD：

-[MOTD.gg](https://motd.gg)(非常非常推荐)(还可以偷别的服务器的motd)
+[MOTD.gg](https://motd.gg)(非常非常推荐)(~~还可以偷别的服务器的motd~~)

 [MOTD creator](https://mctools.org/motd-creator)

@ -293,8 +285,8 @@ MOTD 是玩家进入服务器之前最先看到的东西，决定了玩家对一

 # 像素云黑

-指像素论坛的[失信人员名单页面](https://www.pixelbbs.cn/f-50-1.html)
+指像素论坛的[失信人员名单页面](https://www.pixelbbs.cn/f-50-1.html)。

 交易前查询下这人有没有被记录过，被记录过就别交易了。如果你被骗了，搜集证据去发个帖，给大家避个雷。

-能为你避开 90% 诈骗坑的[防骗小技巧](https://www.pixelbbs.cn/t-1377-1-1.html)
+能为你避开 90% 诈骗坑的[防骗小技巧](https://www.pixelbbs.cn/t-1377-1-1.html)。
--- a/docs/sundry/MiniMessage.md
+++ b/docs/sundry/MiniMessage.md
@ -6,7 +6,7 @@ sidebar_position: 9

 MiniMessage 旨在用简单字符串表示聊天组件，便于用户学习和开发人员扩展。

-MiniMessage 的实质是一个叫 Adventure 的库，这是它的[文档](https://docs.advntr.dev/getting-started.html)
+MiniMessage 的实质是一个叫 Adventure 的库，这是它的 [文档](https://docs.advntr.dev/getting-started.html)。

 ## 支持列表

@ -20,25 +20,27 @@ MiniMessage 的实质是一个叫 Adventure 的库，这是它的[文档](https:
 |Minestom|Build 7494725|内容有点杂，详见[minestom wiki](https://wiki.minestom.net/feature/adventure)|
 |Fabric|`adventure-platform-fabric` 5.3.0*|虽然不是一个东西(?)，但是体验是一样的|

-*详情可以参阅[Adventure 本机支持](https://docs.advntr.dev/platform/native.html)*
+*详情可以参阅 [Adventure 本机支持](https://docs.advntr.dev/platform/native.html)*

 :::note

-平台原生支持≠使用此平台开发的模组/插件支持！！！
+平台原生支持 ≠ 使用此平台开发的模组/插件支持！！！

-举个例子，仔细观察上述列表，你会发现bukkit并没有支持 MiniMessage ，所以你会发现大部分基于Bukkit开发的插件没有 MiniMessage 这一功能（如essentialsx），*除非他们自身引入了 Adventure （如PlaceholderAPI）*
+举个例子，仔细观察上述列表，你会发现bukkit并没有支持 MiniMessage ，所以你会发现大部分基于 Bukkit 开发的插件没有 MiniMessage 这一功能（如 EssentialsX），*除非他们自身引入了 Adventure 库（如PlaceholderAPI）。*

-而基于 Paper 开发的大部分插件都引入了这一功能，所以不要发现一个新奇玩意就到处瞎套
+而基于 Paper 开发的大部分插件都引入了这一功能，所以不要发现一个新奇玩意就到处瞎套。

 :::

 ## 如何使用

-*此处仅讲述管理员如何使用，开发者不做讲解*
+:::warning

-**本篇不讲述诸如 TAB 等插件或模组自行实现的类似 MiniMessage 效果的使用**
+本篇不讲述诸如 TAB 等插件或模组自行实现的类似 MiniMessage 效果的使用。

-和 [格式化代码](format-code) 篇一样，一个 TrMenu菜单 配置展示下
+:::
+
+和 [格式化代码](format-code) 篇一样，用一个 TrMenu 菜单配置展示下：

 ```
 Icons:
@ -51,23 +53,23 @@ Icons:

 ![](_images/MiniMessage/展示.png)

-记住 MiniMessage 语言使用标签，也就是说您所做的一切都将使用标签进行定义
+记住 MiniMessage 语言使用标签，也就是说您所做的一切都将使用标签进行定义。

-对于 MiniMessage ，你必须要有一个开始标签`<yellow>`，在非严格模式下，你可以省略结束标签`</yellow>`，如下
+对于 MiniMessage ，你必须要有一个开始标签 `<yellow>`，在非严格模式下，你可以省略结束标签 `</yellow>` ，如下：

 ```
 <yellow>Hello <blue>World</blue>!
 ```

-在非严格模式下，所有标记名称**都不区分大小写**，以减少冲突的可能性（懒癌晚期患者狂喜），但美观和符合规定起见，请使用小写字母编写以便减少被他人嘲讽的几率
+在非严格模式下，所有标记名称**都不区分大小写**，以减少冲突的可能性（懒癌晚期患者狂喜），但美观和符合规定起见，请使用小写字母编写以便减少被他人嘲讽的几率：

 ```
 <YelLOw>Hello World!
 ```

-此外，这里有一个[测试网站](https://webui.advntr.dev/)，他可以使得你无需启动 Minecraft 便可以预览实际效果
+此外，这里有一个[测试网站](https://webui.advntr.dev/)，他可以使得你无需启动 Minecraft 便可以预览实际效果。

-关于实际使用格式详见 [标准标签](https://docs.advntr.dev/minimessage/format.html#standard-tags)
+关于实际使用格式详见 [标准标签](https://docs.advntr.dev/minimessage/format.html#standard-tags)。

 ### 参考
 - https://docs.advntr.dev/minimessage/format.html
--- a/docs/sundry/YAML/extention.md
+++ b/docs/sundry/YAML/extention.md
@ -9,25 +9,25 @@ sidebar_position: 3

 :::warning

-锚点一定要先声明再使用
+锚点一定要先声明再使用。

-即 整个yml文件从上往下设置锚点**一定要**在引用锚点之前
+即整个 .yml 文件从上往下设置锚点**一定要**在引用锚点之前。

-否则语法报错
+否则会语法报错。

 :::

 ### 符号

-`& 设置锚点`
+`&` 设置锚点。

-`* 引用锚点`
+`*` 引用锚点。

-`<< 合并到当前数据`
+`<<` 合并到当前数据。

 ### 例子

-这样写
+这样写：

 ```
 defaults: &defaults
@ -43,7 +43,7 @@ test:
  common: *defaults
 ```

-相当于
+相当于：
 ```
 defaults:
  adapter: postgres
@ -64,7 +64,7 @@ test:

 ### 保留换行

-> 使用 **“ | ”** 来表示该语法，每行的缩进和行尾空白都会被去掉，而额外的缩进会被保留
+使用 `|` 来表示该语法，每行的缩进和行尾空白都会被去掉，而额外的缩进会被保留。
 ```YAML
 lines: |
  我是第一行
@ -73,14 +73,14 @@ lines: |
      我是第四行
  我是第五行
 ```
-> 使用 **“ |+ ”** 来表示该语法，保留行尾及字符末尾的换行符
+使用 `|+` 来表示该语法，保留行尾及字符末尾的换行符。
 ```YAML
 lines: |+
  我是第一行
  我是第二行
 ```

-> 使用 **“ |- ”** 来表示该语法，保留行尾换行符，但不保留字符末尾的换行符
+使用 `|-` 来表示该语法，保留行尾换行符，但不保留字符末尾的换行符。
 ```YAML
 lines: |-
  我是第一行
@ -89,7 +89,7 @@ lines: |-

 ### 折叠换行

-> 使用 **“ > ”** 来表示该语法，只有空白行才会被识别为换行，原来的换行符都会被转换成空格
+使用 `>` 来表示该语法，只有空白行才会被识别为换行，原来的换行符都会被转换成空格。
 ```YAML
 lines: >
  我是第一行
@ -100,14 +100,14 @@ lines: >
  这么巧我也是第二行
 ```

-> 使用 **“ >+ ”** 来表示该语法，将行尾换行符替换成空格，保留字符末尾的换行符
+使用 `>+` 来表示该语法，将行尾换行符替换成空格，保留字符末尾的换行符。
 ```YAML
 lines: >+
  我是第一行
  我也是第一行
 ```

-> 使用 **“ >- ”** 来表示该语法，将行尾换行符替换成空格，不保留字符末尾的换行符
+使用 `>-` 来表示该语法，将行尾换行符替换成空格，不保留字符末尾的换行符。
 ```YAML
 lines: >-
  我是第一行
--- a/docs/sundry/YAML/foundation.md
+++ b/docs/sundry/YAML/foundation.md
@ -5,19 +5,21 @@ sidebar_position: 2

 # 基础

+假如你想更进一步，请继续阅读。
+
 ## 数据类型

 ### 对象
 键值对的集合。

-形如 `key: value` ，也可以形如 `key1: {key1: value1, key2: value2, ...}`
+形如 `key: value` ，也可以形如 `key1: {key1: value1, key2: value2, ...}` 。

-比如这里 `key` 是键，`value` 是这个键的值 `: `(冒号后有个空格)被称为 `映射标记`
+比如这里 `key` 是键，`value` 是这个键的值 `: `(冒号后有个空格)被称为 `映射标记` 。

 ### 数组
-以‘-’开头的行表示构成一个数组，数组是一组按次序排列的值。
+以 `-` 开头的行表示构成一个数组，数组是一组按次序排列的值。

-yaml支持多为数组，可以使用行内表示：`key: [value1, value2, ...]`
+YAML 支持多维数组，可以使用行内表示：`key: [value1, value2, ...]` 。

 这个写法相当于：
 ```yaml
@ -37,7 +39,7 @@ companies:
      name: company2
      price: 500W
 ```
-意思是 companies 属性是一个数组，每一个数组元素又是由 id、name、price 三个属性构成
+意思是 companies 属性是一个数组，每一个数组元素又是由 id、name、price 三个属性构成。

 ### 复合结构
 数组和对象可以构成复合结构，例：
@ -77,35 +79,35 @@ websites:
 - 时间
 - 日期

-例子
+例子：
 ```
 boolean:
-    - TRUE  #true，True都可以
-    - FALSE  #false，False都可以
+    - TRUE  # true，True 都可以。
+    - FALSE  # false，False 都可以。
 float:
    - 3.14
-    - 6.8523015e+5  #可以使用科学计数法
+    - 6.8523015e+5  #可以使用科学计数法。
 int:
    - 123
-    - 0b1010_0111_0100_1010_1110    #二进制表示
+    - 0b1010_0111_0100_1010_1110  #二进制表示。
 null:
    nodeName: 'node'
-    parent: ~  #使用~表示null
+    parent: ~  #使用 ~ 表示 null 。
 string:
    - 哈哈
-    - 'Hello world'  #可以使用双引号或者单引号包裹特殊字符
+    - 'Hello world'  #可以使用双引号或者单引号包裹特殊字符。
    - newline
-      newline2    #字符串可以拆成多行，每一行会被转化成一个空格
+      newline2  #字符串可以拆成多行，每一行会被转化成一个空格。
 date:
-    - 2018-02-17    #日期必须使用ISO 8601格式，即yyyy-MM-dd
+    - 2018-02-17  #日期必须使用 ISO 8601 格式，即 yyyy-MM-dd 。
 datetime:
-    -  2018-02-17T15:02:31+08:00    #时间使用ISO 8601格式，时间和日期之间使用T连接，最后使用+代表时区
+    -  2018-02-17T15:02:31+08:00  #时间和日期之间使用 T 连接，最后使用 + 代表时区。
 ```

 ## 缩进
-书写的时候要尤其注意缩进
+书写的时候要尤其注意缩进。

-如
+如：
 ```
 options:
  enable: true
@ -119,13 +121,13 @@ guide:
  receive: "你好"
 ```

-我们称 `options` 和 `guide` 在同一缩进下
+我们称 `options` 和 `guide` 在同一缩进下。

-`enable` 和 `check` 在同一缩进下，同样的，`enable`和`drop-block`也在同一缩进下，以此类推
+`enable` 和 `check` 在同一缩进下，同样的，`enable` 和 `drop-block` 也在同一缩进下，以此类推。

-而 `options.enable` (指options缩进下的enable键)和 `options.other.money` 以及 `guide.show` 则不在同一缩进下
+而 `options.enable` (指 options 缩进下的 enable 键) 和 `options.other.money` 以及 `guide.show` 则不在同一缩进下。

-在同一缩进下不允许出现相同的键 如
+在同一缩进下不允许出现相同的键，如：

 ```
 options:
@ -134,9 +136,9 @@ options:
  check: false
 ```

-如果你的文本编辑器支持YAML语法，那么它应该会标红提示你语法错误，这样的配置插件读取也会报错
+如果你的文本编辑器支持 YAML 语法，那么它应该会标红提示你语法错误，这样的配置插件读取也会报错。

-不在同一缩进下则可以出现相同的键 如
+不在同一缩进下则可以出现相同的键，如：

 ```
 options:
--- a/docs/sundry/YAML/overview.md
+++ b/docs/sundry/YAML/overview.md
@ -5,28 +5,32 @@ sidebar_position: 1

 # 概览

-## 什么是YAML?
+## 什么是 YAML?

 > YAML 是 "YAML Ain't a Markup Language"（YAML 不是一种标记语言）的递归缩写。在开发的这种语言时，YAML 的意思其实是："Yet Another Markup Language"（仍是一种标记语言）。
 >
-> YAML 的语法和其他高级语言类似，并且可以简单表达清单、散列表，标量等数据形态。它使用空白符号缩进和大量依赖外观的特色，特别适合用来表达或编辑数据结构、各种配置文件、倾印调试内容、文件大纲（例如：许多电子邮件标题格式和YAML非常接近）。
+> YAML 的语法和其他高级语言类似，并且可以简单表达清单、散列表、标量等数据形态。它使用空白符号缩进和大量依赖外观的特色，特别适合用来表达或编辑数据结构、各种配置文件、调试内容、文件大纲（例如：许多电子邮件标题格式和 YAML 非常接近）。
 >
->> YAML 的配置文件后缀为 **.yml** 或者 *.yaml* ，如：`config.yml` `runoob.yaml` 。
+> YAML 的配置文件后缀为 *.yml* 或者 *.yaml* ，如：`config.yml` 。

-多数时候你的插件配置都是yml 花点时间学学是很有用处的
+Minecraft 服务器用到的 YAML 语法都是非常非常基础的，只要了解一下就可以。(甚至看看配置文件就明白了)

-## 概要
+
+
+## 概要 TL;DR
 - 大小写敏感
 - 使用缩进表示层级关系
- 缩进不允许使用**TAB**，只允许**空格**
+- 缩进不允许使用 **TAB** ，只允许**空格**
 - 缩进的空格数不重要，只要相同层级的元素左对齐即可
- ‘#’表示注释
+- `#` 表示注释
+- 冒号后面有空格
+- 字符串要加单引号

 :::info

-有可能你的文本编辑器用的缩进不是**空格**，导致插件报错
+有可能你的文本编辑器用的缩进不是**空格**，这会导致插件报错。

-自己在文本编辑器找找或者浏览器搜下怎么改
+自己在文本编辑器找找或者浏览器搜下怎么改。

 :::

--- a/docs/sundry/advance/apply-for-a-domain-name.md
+++ b/docs/sundry/advance/apply-for-a-domain-name.md
@ -5,13 +5,11 @@ sidebar_position: 6

 # 申请域名

-域名不但是服务器的招牌，也是老玩家重新找回的一个重要渠道，一个好的域名应该够短（太长了没人记得住），
-
-有记忆点（最好是和 Minecraft 或玩法相关），那么准备好一点小钱钱和待选的名字开始吧。
+域名不但是服务器的招牌，也是老玩家重新找回的一个重要渠道，一个好的域名应该够短（太长了没人记得住）、有记忆点（最好是和 Minecraft 或玩法相关），那么准备好一点小钱钱和待选的名字开始吧。

 ## 寻找合适的域名提供商查询域名

-以阿里云的[万网](https://domain.aliyun.com/)为例。打开网站，来到如下页面：
+以阿里云的[万网](https://domain.aliyun.com/)为例，打开网站，来到如下页面：

 ![](_images/申请域名/1.png)

@ -23,12 +21,12 @@ sidebar_position: 6

 此处域名价格为你输入域名的人气决定，名称越热门越贵，没有优惠最便宜首年也这个价。

-不要看有些域名首年很便宜，可能第二年续费要成百上千，不放心可以鼠标悬停在价格旁边的倒三角处查看续费价格，这里推荐.top，第二年价格最低，长期开服绝对推荐
+不要看有些域名首年很便宜，可能第二年续费要成百上千，不放心可以鼠标悬停在价格旁边的倒三角处查看续费价格，这里推荐.top，第二年价格最低，长期开服绝对推荐。

 :::

 ## 购买域名
-登录后点击域名旁边的加入清单，然后点批量注册旁边的域名清单，更改域名购买时间后，最好底下什么套餐都不要选，直接点立即购买
+登录后点击域名旁边的加入清单，然后点批量注册旁边的域名清单，更改域名购买时间后，最好底下什么套餐都不要选，直接点立即购买。

 ![](_images/申请域名/3.png)

@ -44,13 +42,13 @@ sidebar_position: 6

 :::tip

-购买的域名一般需要至多 24 小时才能正常解析，打开网址 https://whois.aliyun.com/domain/ +你的域名，如果域名状态那里是正常状态（ok）就代表可以使用了。
+购买的域名一般需要至多 24 小时才能正常解析，打开网址 https://whois.aliyun.com/domain/ + 你的域名，如果域名状态那里是正常状态（ok）就代表可以使用了。

 :::

 ## 域名解析

-A 记录是 DNS 中用于将域名映射到 IPv4 地址的记录（也就是我们常用的 IP 记录）
+A 记录是 DNS 中用于将域名映射到 IPv4 地址的记录（也就是我们常用的 IP 记录）。

 SRV 记录，使用二级域名记录了端口的信息，使用 SRV 可以隐藏域名端口。

@ -61,32 +59,55 @@ SRV 记录，使用二级域名记录了端口的信息，使用 SRV 可以隐
 :::

 ### A 记录
+将域名指向一个 IPV4 地址。

-打开网址[阿里云域名控制台](https://dc.console.aliyun.com/#/domain-list/all)，找到你的域名点右边蓝色字的解析。
+人话就是把数字 IP 地址解析成英文字符的域名。

-点击添加记录，记录类型选择 A 记录。主机记录改为 `@` （这意味着使用根域名） ，记录值改为服务器数字 IP 。
+打开网址 [阿里云域名控制台](https://dc.console.aliyun.com/#/domain-list/all)，找到你的域名点右边蓝色字的解析。
+
+点击添加记录，记录类型选择 A 记录。
+
+主机记录改为 `@` （这意味着使用根域名），记录值改为服务器数字 IP 。

 等待解析生效。此时，玩家可通过 `xxx.top:22222` 进入服务器了。

 :::tip

-1. 如果只知道域名不知道 IP 就 Win + R 输入 cmd，随后输入ping + 域名
-2. 主机记录可以改成如 `play` 等，玩家就可以通过 `play.xxx.top:22222`（但这是不是有点太长了，不推荐）
+1. 如果只知道域名不知道 IP 就 Win + R 输入 cmd，随后输入ping + 域名。
+
+2. 主机记录可以改成如 `play` 等，玩家就可以通过 `play.xxx.top:22222`（但这是不是有点太长了，不推荐）。

 :::

+
+### CNAME记录
+将域名指向另一个域名。
+
+假如服务商给的是解析好的域名不是 IP，那就需要用这个来指向你自己的域名。
+
+记录类型选 CNAME。
+
+然后主机记录填你需要的二级域名，填写 `@` 可以不用前缀。
+
+记录值填服务商给的域名就行了。
+
+
 ### SRV 记录

-SRV，
+点击添加记录，记录类型选择 SRV 。

 然后主机记录填你需要的二级域名，如你需要使用 `mc.xxx.top` 代替 `xxx.top:22222` （端口），就将主机记录改为：

 `_minecraft._tcp.mc`

-此处的 mc 可以改为其他，如 play 等。记录值填写为：
+此处的 mc 可以改为其他，如 `play` 、`*` 等，填写 `@` 可以不用前缀。
+
+记录值填写为：

 `5 0 22222 xxx.top`

+> 5 0 是固定的，22222 是你的端口
+
 点击确认，等一会，你就可以发现直接用域名可以连接上你的服务器了。

 :::tip
--- a/docs/sundry/format-code.md
+++ b/docs/sundry/format-code.md
@ -7,7 +7,8 @@ sidebar_position: 8

 **格式化代码（Formatting code）**，又称**颜色代码（Color code）**，能使在游戏中加入含颜色和格式信息。

-在Minecraft中，可以以分节符号（`§`）产生带色文字。 于Windows中，按`Alt` + `NUMPAD0` `NUMPAD1` `NUMPAD6` `NUMPAD7`或`Alt` + `NUMPAD4` `NUMPAD1` `NUMPAD4` `NUMPAD5` `NUMPAD2`。 于macOS中，按下`⌥ Option` + `6`。 于Linux中，按下 `Compose` + `S` + `O`。
+在 Minecraft 中，可以以分节符号（`§`）产生带色文字。 
+

 ![](_images/格式化代码/Minecraft_Formatting.gif)

@ -21,9 +22,9 @@ sidebar_position: 8

 :::tip

-为了方便，多数插件的配置中支持使用 `&` 来代表 `§`
+为了方便，多数插件的配置中支持使用 `&` 来代表 `§` 。

-比如下面这个 TrMenu菜单 例子
+比如下面这个 TrMenu 菜单例子：

 ```
 Icons:
@ -39,9 +40,9 @@ Icons:

 :::

-如果你想要更绚丽的颜色和更丰富的功能（比如点击文本执行命令）
+如果你想要更绚丽的颜色和更丰富的功能（比如点击文本执行命令）。

-可以去看 [MiniMessage](MiniMessage.md) 部分
+可以去看 [MiniMessage](MiniMessage.md) 部分。

 # 参考

--- a/docs/sundry/kether/math.md
+++ b/docs/sundry/kether/math.md
@ -7,7 +7,7 @@ sidebar_position: 2

 ## Math

-https://www.yuque.com/sacredcraft/kether/action-math
+详细请查看：https://www.yuque.com/sacredcraft/kether/action-math

 ```
 /* 加法运算：等价于 1+2+3 = 6 */
@ -29,7 +29,7 @@ math * [ 3 2 5 ]
 math div [ 6 2 ]
 math / [ 6 2 ]
 ```
-除了上面几种用法，Math 还有一种比较舒服的写法
+除了上面几种用法，Math 还有一种比较舒服的写法：

 ```
 /* 计算 1 + 3 x 6 ÷ 3 - 2 */
@ -38,7 +38,7 @@ math 1 + 3 * 5 / 6 - 2

 ## calc

-https://github.com/TabooLib/taboolib/blob/master/module/module-kether/src/main/kotlin/taboolib/module/kether/action/transform/ActionJexl3.kt
+详细请查看：https://github.com/TabooLib/taboolib/blob/master/module/module-kether/src/main/kotlin/taboolib/module/kether/action/transform/ActionJexl3.kt


 - 加法：a + b
@ -46,26 +46,17 @@ https://github.com/TabooLib/taboolib/blob/master/module/module-kether/src/main/k
 - 乘法：a * b
 - 除法：a / b

- 幂运算（我测试不能使用）：
+- 幂运算（我测试不能使用）：幂运算使用 `**` 符号，例如，计算 2 的 3 次方：2 ** 3 。

-> 幂运算使用 ** 符号。例如，计算 2 的 3 次方：2 ** 3。
-
- 开方（我测试不能使用）：
-
-> JEX 支持开方操作。例如，计算 9 的平方根：sqrt(9)。
+- 开方（我测试不能使用）：JEX 支持开方操作，例如，计算 9 的平方根：sqrt(9) 。

 - 取整（我测试不能使用）：
-```
-取整操作可以使用 floor()、ceil() 或 round() 函数。
-    floor(x)：向下取整，返回不大于 x 的最大整数。
-    ceil(x)：向上取整，返回不小于 x 的最小整数。
-    round(x)：四舍五入，返回最接近 x 的整数。
-```
+    - 取整操作可以使用 floor()、ceil() 或 round() 函数。
+    - floor(x)：向下取整，返回不大于 x 的最大整数。
+    - ceil(x)：向上取整，返回不小于 x 的最小整数。
+    - round(x)：四舍五入，返回最接近 x 的整数。
+- 取余：取余操作使用 % 符号。例如，计算 10 除以 3 的余数：10 % 3。

- 取余：
-
-> 取余操作使用 % 符号。例如，计算 10 除以 3 的余数：10 % 3。
-
-当然也可以使用括号
+当然也可以使用括号：

 ![](_images/括号.png)
--- a/docs/sundry/kether/overview.md
+++ b/docs/sundry/kether/overview.md
@ -5,8 +5,8 @@ sidebar_position: 1

 # 概览

-kether并不是一个插件，而是使用Taboolib框架开发的插件（如TrMenu，TrChat，Adyeshach）所使用的脚本语言.
+kether 并不是一个插件，而是使用 Taboolib 框架开发的插件（如TrMenu，TrChat，Adyeshach）所使用的脚本语言。

-https://www.yuque.com/sacredcraft/kether 这篇教程写的足够好了喵
+推荐教程：https://www.yuque.com/sacredcraft/kether

 kether语句表：https://kether.tabooproject.org/list.html
--- a/docs/sundry/purchase-server.md
+++ b/docs/sundry/purchase-server.md
@ -7,7 +7,7 @@ sidebar_position: 10

 :::danger

-低价云超开导致性能下降，不要贪图便宜!!!
+低价云超开导致性能下降，不要贪图便宜！

 :::

@ -27,7 +27,7 @@ sidebar_position: 10

 对于多端，核心数量主要取决于总人数，每 100 玩家多加 4 - 8 个核心是较为合理的。

-而Folia 官方推荐的配置在 16 核心以上，如果是新手或对现有插件有严重依赖的不推荐使用，生态较差。
+而 Folia 官方推荐的配置在 16 核心以上，如果是新手或对现有插件有严重依赖的不推荐使用，生态较差。

 ### CPU单核性能

@ -45,13 +45,15 @@ CPU 总占用不算高时，Minecraft 的服务器性能与 CPU 单核性能几

 :::info

-内存几乎不用考虑 DDR4 / DDR5，高频/低频内存的区别，最重要的是内存大小。使用高频 DDR5 内存和 DDR 4 内存开服基本没有差别，如果是自己买的服务器托管的就省点钱吧。
+内存几乎不用考虑 DDR4 / DDR5，高频/低频内存的区别，最重要的是内存大小。
+
+使用高频 DDR5 内存和 DDR 4 内存开服基本没有差别，如果是自己买的服务器托管的就省点钱吧。

 :::

-一般来说， mod 服比插件服占用高、高版本比低版本略高。尽量选择核心数与内存比例在 1:2 以上的套餐（推荐 1:2 - 1:4 ）
+一般来说， mod 服比插件服占用高，高版本比低版本略高。尽量选择核心数与内存比例在 1:2 以上的套餐（推荐 1:2 - 1:4 ）。

-一方面，多核少内存必然面临性能下降。另一方面，核心多内存少基本为超开，性能会比正常情况下差很多。
+一方面，核心多内存少必然面临性能下降。另一方面，核心多内存少基本为超开，性能会比正常情况下差很多。

 大厅服分配 1G - 2G 内存，普通生存服务器或空岛服务器建议分配 8G - 12G ，单端人数较多建议使用 12G - 24G 内存。

@ -63,7 +65,7 @@ CPU 总占用不算高时，Minecraft 的服务器性能与 CPU 单核性能几

 ## 带宽

-根据玩家数量及视野情况分配。一般情况低版本全默认情况下平均每个玩家会使用 0.25 - 0.4 Mbps 的上行带宽；
+根据玩家数量及视野情况分配。一般情况低版本全默认情况下平均每个玩家会使用 0.25 - 0.4 Mbps 的上行带宽。

 1.18以上服务器平均每人使用0.3-0.5Mbps上行带宽（一群跑图佬另说）也就是说一般提供的10M带宽够带15-20人。

@ -73,4 +75,4 @@ CPU 总占用不算高时，Minecraft 的服务器性能与 CPU 单核性能几

 ## 系统

-如果希望长期开服，强烈推荐使用linux系统（如Ubuntu/CentOS等）
+如果希望长期开服，强烈推荐使用linux系统（如Ubuntu/CentOS等）。