From e25b2af9c5d39259d9d2cb67dec8e0a3c15fa7dd Mon Sep 17 00:00:00 2001 From: igoby <49807567+igoby@users.noreply.github.com> Date: Sun, 23 Jun 2024 21:59:20 +0800 Subject: [PATCH] =?UTF-8?q?=E8=A1=A5=E5=85=85+=E4=BF=AE=E6=AD=A3=E6=A0=BC?= =?UTF-8?q?=E5=BC=8F?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/preparation/download-and-install-java.md | 28 ++++---- docs/preparation/dumb-script-using.md | 6 +- docs/preparation/text-editor.md | 26 ++++---- docs/preparation/websites.md | 64 ++++++++----------- docs/sundry/MiniMessage.md | 28 ++++---- docs/sundry/YAML/extention.md | 28 ++++---- docs/sundry/YAML/foundation.md | 48 +++++++------- docs/sundry/YAML/overview.md | 22 ++++--- .../sundry/advance/apply-for-a-domain-name.md | 49 ++++++++++---- docs/sundry/format-code.md | 11 ++-- docs/sundry/kether/math.md | 31 ++++----- docs/sundry/kether/overview.md | 4 +- docs/sundry/purchase-server.md | 16 +++-- 13 files changed, 187 insertions(+), 174 deletions(-) diff --git a/docs/preparation/download-and-install-java.md b/docs/preparation/download-and-install-java.md index a0dc0585c..d4de79363 100644 --- 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/ ### Zulu 版 -根据各路大佬的测试 Zulu 相较 Oracle (你可以看做"公版")更适合开 MC 服务器 +根据各路大佬的测试 Zulu 相较 Oracle (你可以看做"公版") 更适合开 MC 服务器。
怎么找到官网并从官网下载 ![](_images/Zulu-1.png) -> 往下翻，找到这个，选择你想要的版本 +往下翻，找到这个，选择你想要的版本： ![](_images/Zulu-2.png) -> 找到 64-bit (64位) （如果你的电脑是32位的，建议不开服）。 +找到 64-bit (64位) （如果你的电脑是32位的，建议不开服）： ![](_images/Zulu-3.png) -> 如果您不能安装此软件（如不兼容），请关闭此文档，且**不要向**文档编写者们提问，感谢。 +如果您不能安装此软件（如不兼容），请关闭此文档，且**不要向**文档编写者们提问，感谢。
## 验证 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) diff --git a/docs/preparation/dumb-script-using.md b/docs/preparation/dumb-script-using.md index 352824320..e5a1715a7 100644 --- 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 会受到限制，变得有点傻（当然不止这个，还有其他）。 -我们拒绝回答一切在启动笨蛋脚本之前不看文档的问题 +我们拒绝回答一切在启动笨蛋脚本之前不看文档的问题。 ## 宗旨 diff --git a/docs/preparation/text-editor.md b/docs/preparation/text-editor.md index e8ac72a57..dac1c7f1b 100644 --- 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+，)打开设置，找到“常用配置”手动选中【关联右键菜单】。 diff --git a/docs/preparation/websites.md b/docs/preparation/websites.md index 80942214a..f04046a45 100644 --- 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/)***
点击展开 @@ -26,18 +26,16 @@ Minecraft 最大的插件网站，***建议注册账号并安装[Spigot Search E -SpigotMC 应该是目前 Minecraft 开服圈最大的插件网站了，最大的问题是搜索引擎拉胯。 +SpigotMC 应该是目前 Minecraft 开服圈最大的插件网站了，最大的问题是插件搜索引擎十分狗屎。
注册问题 ![](_images/spigotmc.png) -使用魔法就可以看到验证了，而不是傻呵呵的跟人说 +使用魔法就可以看到验证了，而不是傻呵呵的跟人说。 -**SpigotMC不开放注册** - -**老外的网站真反人类** +*SpigotMC不开放注册* *老外的网站真反人类*
@@ -47,7 +45,7 @@ SpigotMC 应该是目前 Minecraft 开服圈最大的插件网站了，最大的 # GitHub -全球最大的代码托管平台 ***建议注册账号*** +全球最大的代码托管平台 ***建议注册账号***。
点击展开 @@ -64,13 +62,13 @@ SpigotMC 应该是目前 Minecraft 开服圈最大的插件网站了，最大的 -全球最大的社交编程及代码托管网站 +全球最大的社交编程及代码托管网站。 -许多开发者会把自己编写的插件发到 GitHub +许多开发者会把自己编写的插件发到 GitHub。 -虽然不登录账号不影响你浏览仓库和下载 Release 等 +虽然不登录账号不影响你浏览仓库和下载 Release 等。 -但是登录后可以给作者发 Issues 来报告问题，提交新需求/建议，还可以下载 Actions 中的文件 +但是登录后可以给作者发 Issues 来报告问题，提交新需求/建议，还可以下载 Actions 中的文件。
注册问题 @@ -82,16 +80,14 @@ SpigotMC 应该是目前 Minecraft 开服圈最大的插件网站了，最大的
连不上怎么办 -使用魔法或者 - -[点击此处](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)
下载太慢怎么办 -使用魔法或者用加速地址 +使用魔法或者用加速地址： https://gitmirror.com/files.html @@ -134,7 +130,9 @@ GitHub 汉化插件：https://github.com/maboloshi/github-chinese # Builtbybit -一个综合软件资源站，其中的 Minecraft 插件大多数都是付费的。 +一个综合交易平台，其中的 Minecraft 插件大多数都是付费的。 + +有一些圈钱的垃圾插件，请仔细辨别后购买。
点击展开 @@ -151,9 +149,9 @@ GitHub 汉化插件：https://github.com/maboloshi/github-chinese -如果你的钱包空空就别考虑了 +如果你的钱包空空就别考虑了。 -此外，此网站和 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 服务器付费插件资源平台。
点击展开 @@ -179,8 +177,6 @@ GitHub 汉化插件：https://github.com/maboloshi/github-chinese -和 CurseForge、Modrinth 一样并不只有插件资源，也还有付费资源 - 地址：https://polymart.org
@@ -204,19 +200,15 @@ GitHub 汉化插件：https://github.com/maboloshi/github-chinese -（对没错这是个资源站我没开玩笑😅） +开一些低版本服务器可能用得到。 -Bukkit 为 Minecraft 社区提供一个强大，精心设计和深思熟虑的解决方案，以扩展和控制其服务器，于是便有了这个站点 - -你可以在此查找到那些从远古时期就存在的插件 - -地址：https://dev.bukkit.org/ +地址：https://dev.bukkit.org/bukkit-plugins
# Modrinth -现代化的 Minecraft 新兴资源站，插件相对较新较少。 +现代化的 Minecraft 新兴资源站，插件相对较新较少，而且大部分都开源。
点击展开 @@ -233,9 +225,9 @@ Bukkit 为 Minecraft 社区提供一个强大，精心设计和深思熟虑的 -Modrinth 闪电般的搜索速度和强大的过滤器可让您在输入时找到所需的内容 +插件搜索引擎比 spigot 强了好几倍。 -因为是新兴资源站，某些资源并未在此发布，但是足够你用了 +因为是新兴资源站，某些资源并未在此发布，但是足够你用了。 地址：https://modrinth.com/ @@ -243,7 +235,7 @@ Modrinth 闪电般的搜索速度和强大的过滤器可让您在输入时找 # PaperMC -Paper 的现代化的插件平台，目前正在 Beta 阶段，插件相对较新较少。 +Paper 的现代化的插件平台，目前正在 Beta 阶段，插件相对较新较少，但是都经过 Paper 官方验证，并且可以找到支持 Folia 和 Velocity 的插件。
点击展开 @@ -260,7 +252,7 @@ Paper 的现代化的插件平台，目前正在 Beta 阶段，插件相对较 -对于 Folia 服务器找插件的一个好去处，PaperMC 提供的全新插件搜索平台，相较 Spigot 落后的搜索引擎有所提升。 +插件搜索引擎比 spigot 强了好几倍。 地址：https://hangar.papermc.io/ @@ -268,7 +260,7 @@ Paper 的现代化的插件平台，目前正在 Beta 阶段，插件相对较 # MOTD 生成网站 -MOTD 就是 Minecraft 客户端在尝试连接服务器之前，服务器对客户端发送的一条短消息，这通常包含1-3行文字和一张图片 +MOTD 就是 Minecraft 客户端在尝试连接服务器之前，服务器对客户端发送的一条短消息，这通常包含1-3行文字和一张图片。
听不懂描述就展开看图 @@ -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) \ No newline at end of file +能为你避开 90% 诈骗坑的[防骗小技巧](https://www.pixelbbs.cn/t-1377-1-1.html)。 \ No newline at end of file diff --git a/docs/sundry/MiniMessage.md b/docs/sundry/MiniMessage.md index ff004a8ff..48c5e72d1 100644 --- 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 ，你必须要有一个开始标签``，在非严格模式下，你可以省略结束标签``，如下 +对于 MiniMessage ，你必须要有一个开始标签 ``，在非严格模式下，你可以省略结束标签 `` ，如下： ``` Hello World! ``` -在非严格模式下，所有标记名称**都不区分大小写**，以减少冲突的可能性（懒癌晚期患者狂喜），但美观和符合规定起见，请使用小写字母编写以便减少被他人嘲讽的几率 +在非严格模式下，所有标记名称**都不区分大小写**，以减少冲突的可能性（懒癌晚期患者狂喜），但美观和符合规定起见，请使用小写字母编写以便减少被他人嘲讽的几率： ``` 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 diff --git a/docs/sundry/YAML/extention.md b/docs/sundry/YAML/extention.md index e9a3d1c90..4a3de0087 100644 --- 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: >- 我是第一行 diff --git a/docs/sundry/YAML/foundation.md b/docs/sundry/YAML/foundation.md index f6c0ad70c..e83c08b70 100644 --- 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: diff --git a/docs/sundry/YAML/overview.md b/docs/sundry/YAML/overview.md index 80479fad9..c02fd1b0b 100644 --- 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 -有可能你的文本编辑器用的缩进不是**空格**，导致插件报错 +有可能你的文本编辑器用的缩进不是**空格**，这会导致插件报错。 -自己在文本编辑器找找或者浏览器搜下怎么改 +自己在文本编辑器找找或者浏览器搜下怎么改。 ::: diff --git a/docs/sundry/advance/apply-for-a-domain-name.md b/docs/sundry/advance/apply-for-a-domain-name.md index 6c2d4ee85..d8b594c32 100644 --- 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 diff --git a/docs/sundry/format-code.md b/docs/sundry/format-code.md index c1ebc290f..20c385f39 100644 --- 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) 部分。 # 参考 diff --git a/docs/sundry/kether/math.md b/docs/sundry/kether/math.md index fc6adf810..02eba0910 100644 --- 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) \ No newline at end of file diff --git a/docs/sundry/kether/overview.md b/docs/sundry/kether/overview.md index 473b4bdda..1ba70c539 100644 --- 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 \ No newline at end of file diff --git a/docs/sundry/purchase-server.md b/docs/sundry/purchase-server.md index da2376f38..12bf5eb8f 100644 --- 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等）。