diff --git a/docs/扩展阅读/YAML语法/基础.md b/docs/扩展阅读/YAML语法/基础.md index d7c460410..70950d7e3 100644 --- a/docs/扩展阅读/YAML语法/基础.md +++ b/docs/扩展阅读/YAML语法/基础.md @@ -5,12 +5,13 @@ sidebar_position: 2 # 基础 ## 数据类型 + ### 对象 键值对的集合。 -形如 `key: value`，也可以形如 `key1: {key1: value1, key2: value2, ...}` +形如 `key: value` ，也可以形如 `key1: {key1: value1, key2: value2, ...}` -比如这里 `key` 是键，`value`是这个键的值 `: `(冒号后有个空格)被称为`映射标记` +比如这里 `key` 是键，`value` 是这个键的值 `: `(冒号后有个空格)被称为 `映射标记` ### 数组 以‘-’开头的行表示构成一个数组，数组是一组按次序排列的值。 diff --git a/docs/插件/概览.md b/docs/插件/概览.md index a6ecadb98..4cdc25716 100644 --- a/docs/插件/概览.md +++ b/docs/插件/概览.md @@ -4,34 +4,36 @@ sidebar_position: 1 # 概览 -在这里所讲到的插件多数是在mc开服圈内(请允许我这么说)比较知名的，已经有完善的文档 - -所以本篇主要是让你知道有这么个东西，以及给你指路，直接点进它文档猛猛学就好 +本文档中提到的插件都有较多用户基础和完善的 Wiki，具体插件请查看插件的 Wiki。 ![](_images/概览/餐叉.jpg) -建议阅读 +**建议阅读** -- [YAML语法](/docs/扩展阅读/YAML语法/概览.md) - 了解你书写配置的语法 +- [YAML 语法](/docs/扩展阅读/YAML语法/概览.md) - 了解你书写配置的语法 - [plugin.yml](/docs/扩展阅读/plugin.yml.md) - 了解插件的一些信息 :::danger -不要使用yum，plugman，ServerUtils等插件热重载插件!!! +服务器在**开发阶段**可以使用 PlugmanX，ServerUtils 等插件热重载插件， -多数插件并不支持热重载，即使热重载了也容易出问题 +过了开发阶段后切记，多数插件自带了重载（如 Placeholder 的重载指令为：papi reload） + +尽量少使用插件重载插件，因为如果插件本身并不支持热重载，即使热重载了也容易出问题。 ::: -## 如何安装插件? +## 如何安装插件？ -将插件的jar文件放入服务端的 `plugins` 文件夹 +将插件的 jar 文件放入服务端的 `plugins` 文件夹 -## 笨蛋脚本 +### 笨蛋脚本 下载此[脚本](https://github.com/lilingfengdev/NitWiki-Script/releases/download/latest/auto-install-depend.exe)，我们会为你安装常用插件(自动) -安装的插件列表 +
+ 安装的插件列表 + * ProtocolLib 必备前置 * Luckperms 权限管理插件 * PlaceholderAPI 必备前置 @@ -44,20 +46,23 @@ sidebar_position: 1 * spark 性能分析 * SkinRestorer 皮肤管理/皮肤修复 -## 如何进行插件选择? +
-很好，相信你已经在[可能用到的网站](/docs/准备工作/可能用到的网站.md)看到了很多链接， 面对成千上万的插件我们应该如何进行选择呢? +## 如何进行插件选择？ + +很好，相信你已经在[可能用到的网站](/docs/准备工作/可能用到的网站.md)看到了很多链接， 面对成千上万的插件我们应该如何进行选择呢？ 我们在此以spigot.org为例(假设您已经注册成功)， 讲解如何选择插件. 1. (*可选，推荐*)安装一个spigot专用的[搜索引擎](https://fof1092.de/Plugins/SSE/Redirect/)， 作为浏览器插件安装即可. 使用spigot search engine(spigot搜索引擎)后， 你能得到比spigot自带的搜索相关性强得多的搜索结果. - -2. (*可选*)如果你觉得大量的英语很头大， 请打开你的浏览器自带的翻译器， 如edge/chrome + +2. (*可选*)如果你觉得大量的英语很头大， 请打开你的浏览器自带的翻译器， 如edge/chrome ![](_images/概览/浏览器翻译.png) 3. 就像逛淘宝一样， 根据你的需求将你认为有用的插件收藏起来. 最好是分门别类放在一起， 我们以随机 TP 插件为例， 我们在此搜索 RTP +
- 安装搜索引擎后应该长啥样? + 安装搜索引擎后应该长啥样？ ![](_images/概览/Spigot搜索.png) @@ -78,7 +83,7 @@ sidebar_position: 1 6. 如果你不嫌麻烦， 可以在 Excel 中分析插件的优劣并打分， 如图比较了当前下载量前5的随机TP插件. 每个服务器可根据自己的需求自行评价， 下图只是一个抛砖引玉的作用， 如果你看重粒子效果/title/音效等依然可以加入到表格中， 然后根据自己的需求选择其中一个即可， ***不要装多个同类型插件如CMI/ESS一起装*** ![](_images/概览/同类插件评分选择.png) -## 如何下载插件历史版本? +## 如何下载插件历史版本？ **建议**您用**最新版本**的插件，但如果您因为一些原因必须要用旧版的话... @@ -127,9 +132,7 @@ sidebar_position: 1
- - -## 如何查看插件支持的语言? +## 如何查看插件支持的语言？
SpigotMC @@ -141,7 +144,7 @@ sidebar_position: 1
目录下有文件夹 -插件文件夹中有Language，lang，locale之类的文件夹(或其他东西?) +插件文件夹中有Language，lang，locale之类的文件夹(或其他东西？) ![](_images/概览/查看语言-1.png) @@ -181,7 +184,25 @@ https://crowdin.com/project/simpleclans 还有它可能写在插件文档里，在项目README里，在配置文件的注释里 -## 如何汉化插件? +## 如何配置插件？ + +插件的配置文件一般在 `/plugins/插件名字/` 文件夹中，常见的配置文件一般是 `config.yml` 。 + +:::warning + +请务必保证你已经完全了解 YAML 语法，否则你会遇到大量的报错！ + +::: + +我们在开始前所做的准备工作中，推荐你安装任意一款推荐的文档编辑软件。 + +（如果你还没有安装，请立刻查看[准备工作](/docs/%E5%87%86%E5%A4%87%E5%B7%A5%E4%BD%9C/%E6%96%87%E6%9C%AC%E7%BC%96%E8%BE%91%E5%99%A8.md)） + +如果你是 Windows ，现在让我们双击 .yml 文件就可以开始修改配置文件了！ + +如果你是 Linux ，如果你认为这很难操作，可以通过 SFTP 下载到自己的电脑上编辑。 + +## 如何汉化插件？ 以下是你可能遇到的情况 @@ -195,7 +216,7 @@ https://crowdin.com/project/simpleclans
配置文件改语言 -像HoloMobHealth，Gsit，你可以在插件配置文件中(一般在config.yml中)找到Language，lang等字眼 +像 HoloMobHealth ，Gsit ，你可以在插件配置文件中(一般在 config.yml 中)找到 Language ， lang 等字眼 然后把把后面改成 zhcn，zh-cn，zh-CN，chinese 啥的，具体应该写什么这地方的注释可能提到，没提到那得靠你自己寻找了 @@ -212,13 +233,12 @@ https://crowdin.com/project/simpleclans 就需要你自行汉化里面的内容了，去一些论坛翻翻也许能找到别人分享的汉化 -#### GPT汉化? +#### GPT汉化？ 口令参考 ``` -请将我给出的以yml格式存储的Minecraft插件的配置文件汉化，且不改变本身的可执行性，其中被两个%包裹的为变量请不要翻译，请翻译时不要带翻译腔，而是要翻译得自然、流畅和地道，使用优美和高雅的表达方式并代入Minecraft游戏内进行翻译，翻译后请以markdown代码块的格式发送 - +请将我给出的以 yml 格式存储的 Minecraft 插件的配置文件汉化，且不改变本身的可执行性，其中被两个 % 包裹的为变量请不要翻译，请翻译时不要带翻译腔，而是要翻译得自然、流畅和地道，使用优美和高雅的表达方式并代入 Minecraft 游戏内进行翻译，翻译后请以 markdown 代码块的格式发送 ``` 备注：本教程并非推荐服主通过 GPT 等 AI 进行机翻，我们不对服主利用 AI 产生文本的行为及其内容负责。 @@ -235,10 +255,22 @@ https://crowdin.com/project/simpleclans
+## 检查插件安装 + +使用 `/plugins`或者`/pl` 列出插件列表 + +![](_images/概览/插件列表.png) + +绿色为已加载（不是代表你日后使用不报错，只是这里加载上了） + +红色为加载失败（服务端检测到了这个插件，但是没加载上，去控制台看看报错） + +如果这里没有你的插件...服务端甚至没识别这是个插件，去看看你的文件有啥问题 + ## 插件缩写
- 点击查看 + 常见插件缩写，点击查看 AP 通常指楠木的 AttributePlus @@ -356,16 +388,4 @@ pmr 通常指 楠木的 PMRewards plt 通常指米饭的 PlayerTitle -
- -## 检查插件安装 - -使用 `/plugins`或者`/pl` 列出插件列表 - -![](_images/概览/插件列表.png) - -绿色为已加载（不是代表你日后使用不报错，只是这里加载上了） - -红色为加载失败（服务端检测到了这个插件，但是没加载上，去控制台看看报错） - -如果这里没有你的插件...服务端甚至没识别这是个插件，去看看你的文件有啥问题 +
\ No newline at end of file