diff --git a/astro.config.ts b/astro.config.ts index c0410097e..b8b0dd24d 100644 --- a/astro.config.ts +++ b/astro.config.ts @@ -61,6 +61,23 @@ export default defineConfig({ label: "通用知识库", collapsed: true, items: [ + { + label: "常见术语解析", + collapsed: true, + items: [ + "general/basics/what-is-world", + "general/basics/what-is-datapack", + "general/basics/what-is-mod", + "general/basics/what-is-plugin", + "general/basics/what-is-lag", + "general/basics/what-is-log", + "general/basics/what-is-messy-code", + "general/basics/what-is-permission", + "general/basics/what-is-startup-script", + "general/basics/what-is-nbt", + "general/basics/what-is-namespace", + ] + }, { label: "安装 Java", collapsed: true, @@ -82,7 +99,7 @@ export default defineConfig({ collapsed: true, items: [ "general/advance/management/intro", - { + { label: "玩家管理", autogenerate: { directory: "general/advance/management/player-management" @@ -1107,4 +1124,4 @@ export default defineConfig({ noExternal: ["naive-ui", "vueuc", "date-fns", "workbox-window"] } } -}); +}); \ No newline at end of file diff --git a/src/content/docs/about/ad.md b/src/content/docs/about/ad.md index 3128dcd9b..f55e54607 100644 --- a/src/content/docs/about/ad.md +++ b/src/content/docs/about/ad.md @@ -2,4 +2,4 @@ title: 广告 --- -广告暂不开启 +广告暂不开启。 diff --git a/src/content/docs/about/intro.md b/src/content/docs/about/intro.md index cf5cc2170..ea151ae36 100644 --- a/src/content/docs/about/intro.md +++ b/src/content/docs/about/intro.md @@ -26,20 +26,20 @@ Cubic 在群友的建议中被选中，成为了新组织的名字 打从一开始我就打算起一个让人耳目一新，一下就能记住的我的世界开服教程文档名字 -但是“教程指北”之类的创意早被人使用过了，那段时间“笨蛋”一词有点成为口头禅， +但是「教程指北」之类的创意早被人使用过了，那段时间「笨蛋」一词有点成为口头禅， 再加上这个教程本来就是写给新手的，我就叫它笨蛋文档了，雪萌起了英文版名字 NitWikit -MC 里傻子村民的英文就是 nitwit，后缀又和 Wiki 相近，所以组合成了 Nitwikit +MC 里傻子村民的英文就是 nitwit，后缀又和 Wiki 相近，所以组合成了 NitWikit #### 发展历程？ -在笨蛋文档诞生很早之前我就有已经有过编写开服教程的想法，那时尝试过石墨文档，语雀，自建 GitBook。不过他们都夭折了。。。 +在笨蛋文档诞生很早之前我就有已经有过编写开服教程的想法，那时尝试过石墨文档，语雀，自建 GitBook。不过他们都夭折了…… 在笨蛋文档即将诞生的那段时间，我想编写一个文档来收录一些总有人问的问题，以及收录一些零碎的资源，下次回答别人问题的时候直接甩文档链接就好了， 又想到从前想写的开服教程，最终我决定编写一个从未有人做过的，详细无比的开服教程。 -一开始我只是拉着人才（他写反作弊部分）编写笨蛋文档，部署在 GitHub pages，然后 lilingfeng 和小杰自己跑来问我能不能参与维护， +一开始我只是拉着人才（他写反作弊部分）编写笨蛋文档，部署在 GitHub Pages，然后 lilingfeng 和小杰自己跑来问我能不能参与维护， 以及一些路人像是 gyc123456-1 来给我 PR，后面还有 lim114514 在我不知情的情况下帮我买好 yizhan.wiki 这个域名，雪萌帮我想英文名字， 画群头像，banner 图，MineBBS 宣传图，小涵想写 Bedrock 内容给文档拆成三块，突然冒出个糯米团子搞出个 VitePress 版文档， 有那么几个我不认识的人和我认识的三七为笨蛋文档录制视频，千屈帮助编写了好多好多内容，修了好多 bug，甚至重写文档整个界面等等。 -不知不觉就有了六十多个贡献者，如果算上 GitHub 之外提供建议和帮助的人，远比这个数字要多。 +不知不觉就有了六十多个贡献者，如果算上 GitHub 之外提供建议和帮助的人，远比这个数字要多。 \ No newline at end of file diff --git a/src/content/docs/general/advance/bot/framework.mdx b/src/content/docs/general/advance/bot/framework.mdx index 0a23ad3fc..4352e669c 100644 --- a/src/content/docs/general/advance/bot/framework.mdx +++ b/src/content/docs/general/advance/bot/framework.mdx @@ -17,8 +17,8 @@ import { TabItem, Tabs } from "@astrojs/starlight/components"; | -------- | -------------------------------------------------------------------------------------------------------------------------------------------- | | 相关链接 | [GitHub 仓库](https://github.com/LLOneBot/LLOneBot) \| [文档站](https://llonebot.github.io/zh-CN/) | | 作者 | [LLOneBot](https://github.com/LLOneBot) | -| 介绍 | LiteLoaderQQNT 插件，实现 OneBot 11 和 Satori 协议，用于 QQ 机器人开发 | -| 下载 | [GitHub](https://github.com/LLOneBot/LLOneBot/releases) 或者 [LiteLoaderQQNT](https://github.com/LiteLoaderQQNT/LiteLoaderQQNT) 插件市场下载 | +| 介绍 | LiteLoaderQQNT 插件，实现 OneBot 11 和 Satori 协议，用于 QQ 机器人开发。 | +| 下载 | [GitHub](https://github.com/LLOneBot/LLOneBot/releases) 或者 [LiteLoaderQQNT](https://github.com/LiteLoaderQQNT/LiteLoaderQQNT) 插件市场下载。 | @@ -27,8 +27,8 @@ import { TabItem, Tabs } from "@astrojs/starlight/components"; | -------- | ------------------------------------------------------------------------------------------------------------------------------------------- | | 相关链接 | [GitHub 仓库](https://github.com/NapNeko/NapCatQQ) \| [文档站](https://napneko.github.io/) | | 作者 | [NapNeko](https://github.com/NapNeko) | -| 介绍 | NapCatQQ 是现代化的基于 NTQQ 的 Bot 协议端实现 | -| 下载 | [GitHub](https://github.com/NapNeko/NapCatQQ/releases) 或者 [LiteLoaderQQNT](https://github.com/LiteLoaderQQNT/LiteLoaderQQNT) 插件市场下载 | +| 介绍 | NapCatQQ 是现代化的基于 NTQQ 的 Bot 协议端实现。 | +| 下载 | [GitHub](https://github.com/NapNeko/NapCatQQ/releases) 或者 [LiteLoaderQQNT](https://github.com/LiteLoaderQQNT/LiteLoaderQQNT) 插件市场下载。 | @@ -38,7 +38,7 @@ import { TabItem, Tabs } from "@astrojs/starlight/components"; | -------- | --------------------------------------------------------------------------------------------------------- | | 相关链接 | [GitHub 仓库](https://github.com/MrXiaoM/overflow) \| [文档站](https://mirai.mrxiaom.top/docs/UserManual) | | 作者 | [MrXiaoM](https://github.com/MrXiaoM) | -| 介绍 | Overflow 是 mirai-core-api 的实现，对接 OneBot 11 标准，实现 mirai 的无缝迁移 | +| 介绍 | Overflow 是 mirai-core-api 的实现，对接 OneBot 11 标准，实现 mirai 的无缝迁移。 | | 下载 | [官网下载](https://mirai.mrxiaom.top/) | @@ -56,7 +56,7 @@ import { TabItem, Tabs } from "@astrojs/starlight/components"; | -------- | ------------------------------------------------------------------------- | | 相关链接 | [GitHub 仓库](https://github.com/Hoshinonyaruko/Gensokyo) | | 作者 | [Hoshinonyaruko](https://github.com/Hoshinonyaruko) | -| 介绍 | 基于 OneBot QQ 官方机器人 Api Golang 原生实现 | +| 介绍 | 基于 OneBot QQ 官方机器人 API 的 Golang 原生实现。 | | 下载 | [GitHub](https://github.com/Hoshinonyaruko/Gensokyo/releases) | @@ -74,7 +74,7 @@ import { TabItem, Tabs } from "@astrojs/starlight/components"; | -------- | ----------------------------------------------------------------------------------------------------------------- | | 相关链接 | [GitHub 仓库](https://github.com/whitechi73/OpenShamrock) \| [文档站](https://whitechi73.github.io/OpenShamrock/) | | 作者 | [whitechi73](https://github.com/whitechi73) | -| 介绍 | 基于 Lsposed（Non-Riru）实现 Kritor 标准的 QQ 机器人框架 | +| 介绍 | 基于 Lsposed（Non-Riru）实现 Kritor 标准的 QQ 机器人框架。 | | 下载 | [GitHub](https://github.com/whitechi73/OpenShamrock/releases) | @@ -84,7 +84,7 @@ import { TabItem, Tabs } from "@astrojs/starlight/components"; | --------- | ------------------------------------------------------------------------------ | | 相关链接 | [GitHub 仓库](https://github.com/chrononeko/chronocat) | | 作者 | [chrononeko](https://github.com/chrononeko) | -| 介绍 | 模块化的 Satori 框架 | +| 介绍 | 模块化的 Satori 框架。 | | 下载 | [GitHub](https://github.com/chrononeko/chronocat/releases) | @@ -94,7 +94,7 @@ import { TabItem, Tabs } from "@astrojs/starlight/components"; | --------- | ----------------------------------------------------------------------------------------------------------------------------------------- | | 相关链接 | [GitHub 仓库](https://github.com/Mrs4s/go-cqhttp) \| [文档站](https://docs.go-cqhttp.org/) | | 作者 | [Mrs4s](https://github.com/Mrs4s) | -| 介绍 | 基于 Mirai 以及 MiraiGo 的 OneBot Golang 原生实现 | +| 介绍 | 基于 Mirai 以及 MiraiGo 的 OneBot Golang 原生实现。 | | 下载 | [GitHub](https://github.com/Mrs4s/go-cqhttp/releases) | @@ -104,7 +104,7 @@ import { TabItem, Tabs } from "@astrojs/starlight/components"; | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- | | 相关链接 | [GitHub 仓库](https://github.com/mamoe/mirai) \| [官方论坛](https://mirai.mamoe.net/) \| [用户手册](https://github.com/mamoe/mirai/blob/dev/docs/UserManual.md) | | 作者 | [mamoe](https://github.com/mamoe) | -| 介绍 | mirai 是一个在全平台下运行，提供 QQ Android 协议支持的高效率机器人库 | +| 介绍 | Mirai 是一个在全平台下运行，提供 QQ Android 协议支持的高效率机器人库。 | | 下载 | [GitHub](https://github.com/iTXTech/mirai-console-loader/releases) | @@ -114,9 +114,9 @@ import { TabItem, Tabs } from "@astrojs/starlight/components"; | --------------- | ------------------------------------------------------------------------------------------------------------------------------------ | | 相关链接 | [GitHub 仓库](https://github.com/LagrangeDev/Lagrange.Core) \| [文档站](https://lagrangedev.github.io/Lagrange.Doc/Lagrange.OneBot/) | | 作者 | [LagrangeDev](https://github.com/LagrangeDev) | -| 介绍 | Lagrange.Core 是一个开源的 NTQQ 协议实现，实现了 OneBot V11 的通信协议，可以和主流 Bot 框架进行通信 | +| 介绍 | Lagrange.Core 是一个开源的 NTQQ 协议实现，实现了 OneBot V11 的通信协议，可以和主流 Bot 框架进行通信。 | | 下载 | [GitHub](https://github.com/LagrangeDev/Lagrange.Core/releases) | -{/* autocorrect-enable */} +{/* autocorrect-enable */} \ No newline at end of file diff --git a/src/content/docs/general/advance/bot/general.mdx b/src/content/docs/general/advance/bot/general.mdx index 959c237ac..9b597b94b 100644 --- a/src/content/docs/general/advance/bot/general.mdx +++ b/src/content/docs/general/advance/bot/general.mdx @@ -6,11 +6,11 @@ sidebar: import { TabItem, Tabs } from "@astrojs/starlight/components"; -指一个独立程序运行的 QQ 机器人程序，这些机器人程序仅只有 QQ 消息处理功能，QQ 连接需要依赖 QQ 机器人框架 +指一个独立程序运行的 QQ 机器人程序，这些机器人程序仅只有 QQ 消息处理功能，QQ 连接需要依赖 QQ 机器人框架。 部分 QQ 机器人程序会依赖 Minecraft 插件来实现部分无法完成的功能。 -关于机器人框架详情请见 [通用 | 机器人框架](/general/advance/bot/framework) +关于机器人框架详情请见 [通用 | 机器人框架](/general/advance/bot/framework)。 {/* autocorrect-disable space-punctuation */} @@ -21,7 +21,7 @@ import { TabItem, Tabs } from "@astrojs/starlight/components"; | 相关链接 | [Gitee 仓库](https://gitee.com/dlcn/dlscq) \| [文档站](https://gitee.com/dlcn/dlscq/wikis) | | 作者 | [21Hertz](https://gitee.com/dlcn) | | 支持平台 | Java 版和基岩版 | -| 介绍 | 一个无图形服务端管理程序，支持大多数主流服务端，主打长期稳定，使用 OneBot11 标准接入 QQ，理论上可支持任何命令行 | +| 介绍 | 一个无图形服务端管理程序，支持大多数主流服务端，主打长期稳定，使用 OneBot 11 标准接入 QQ，理论上可支持任何命令行。 | | 下载 | [Gitee](https://gitee.com/dlcn/dlscq/releases) | @@ -32,7 +32,7 @@ import { TabItem, Tabs } from "@astrojs/starlight/components"; | 相关链接 | [Gitee 仓库](https://gitee.com/dlcn/dlsna) \| [文档站](https://gitee.com/dlcn/dlscq/wikis/%E5%85%B6%E4%BB%96%E6%A1%86%E6%9E%B6/%E5%AE%98%E6%96%B9%E9%A2%91%E9%81%93%E6%9C%BA%E5%99%A8%E4%BA%BA) | | 作者 | [21Hertz](https://gitee.com/dlcn) | | 支持平台 | Java 版和基岩版 | -| 介绍 | DLS-CQhttp 的一个分支，使用 QQ 开放平台 API 标准接入 QQ，继承了 DLS-CQhttp 一样的易用性 | +| 介绍 | DLS-CQhttp 的一个分支，使用 QQ 开放平台 API 标准接入 QQ，继承了 DLS-CQhttp 一样的易用性。 | | 下载 | [Gitee](https://gitee.com/dlcn/dlsna/releases) | @@ -43,7 +43,7 @@ import { TabItem, Tabs } from "@astrojs/starlight/components"; | 相关链接 | [文档站](https://docs.inectar.cn/docs/easybot/intor) | | 作者 | [easybot-team](https://github.com/easybot-team/) | | 支持平台 | Java 版 MCDR Fabric/Quilt NeoForge Forge | -| 介绍 | 基于 .NET8.0+React 开发的跨平台群服互通框架，使用 OneBot11 标准接入 QQ，支持自定义脚本，高级图片渲染等功能 | +| 介绍 | 基于 .NET8.0+React 开发的跨平台群服互通框架，使用 OneBot 11 标准接入 QQ，支持自定义脚本，高级图片渲染等功能。 | | 下载 | [官网下载](https://docs.inectar.cn/download/easybot) | @@ -54,7 +54,7 @@ import { TabItem, Tabs } from "@astrojs/starlight/components"; | 相关链接 | [GitHub 仓库](https://github.com/SereinDev/Serein) \| [文档站](https://sereindev.github.io/) | | 作者 | [SereinDev](https://github.com/SereinDev) | | 支持平台 | Java 版和基岩版 | -| 介绍 | 本身是一个服务器管理软件，但支持使用 QQ 机器人，使用 OneBot11 标准接入 QQ，有机器人相关配置并且有平台支持插件进行功能拓展 | +| 介绍 | 本身是一个服务器管理软件，但支持使用 QQ 机器人，使用 OneBot 11 标准接入 QQ，有机器人相关配置并且有平台支持插件进行功能拓展。 | | 下载 | [GitHub](https://github.com/SereinDev/Serein/releases) | @@ -65,7 +65,7 @@ import { TabItem, Tabs } from "@astrojs/starlight/components"; | 相关链接 | [GitHub 仓库](https://github.com/summerkirakira/CirnoBot) \| [文档站](https://biaoju.site/cirnobot/) | | 作者 | [summerkirakira](https://github.com/summerkirakira) | | 支持 **Java 版** | Bukkit 及其分支 | -| 介绍 | 基于 NoneBot2 开发的机器人平台，可使用 OneBot11 标准接入 QQ，有机器人相关配置并且有平台支持插件进行功能拓展 | +| 介绍 | 基于 NoneBot2 开发的机器人平台，可使用 OneBot 11 标准接入 QQ，有机器人相关配置并且有平台支持插件进行功能拓展。 | | 下载 | [文档教程](https://biaoju.site/cirnobot/docs/%E7%AE%80%E5%8D%95%E4%B8%8A%E6%89%8B) | @@ -76,9 +76,9 @@ import { TabItem, Tabs } from "@astrojs/starlight/components"; | 相关链接 | [GitHub 仓库](https://github.com/Minecraft-QQBot/BotServer) \| [文档站](https://qqbot.bugjump.xyz/) | | 作者 | [sparkbridge](https://github.com/sparkbridge) | | 支持 **Java 版** | Bukkit 及其分支 | -| 介绍 | 一款基于 NoneBot2 用多种方式与 Minecraft 交互的 Python QQ 机器人，可使用 OneBot11 标准接入 QQ，有机器人相关配置并且有平台支持插件进行功能拓展 | +| 介绍 | 一款基于 NoneBot2 用多种方式与 Minecraft 交互的 Python QQ 机器人，可使用 OneBot 11 标准接入 QQ，有机器人相关配置并且有平台支持插件进行功能拓展。 | | 下载 | [文档教程](https://qqbot.bugjump.xyz/%E6%96%87%E6%A1%A3/%E5%BF%AB%E9%80%9F%E5%BC%80%E5%A7%8B.html) | -{/* autocorrect-enable */} +{/* autocorrect-enable */} \ No newline at end of file diff --git a/src/content/docs/general/advance/bot/intro.md b/src/content/docs/general/advance/bot/intro.md index 33025ee9b..d76e98d21 100644 --- a/src/content/docs/general/advance/bot/intro.md +++ b/src/content/docs/general/advance/bot/intro.md @@ -6,7 +6,7 @@ sidebar: 搭建机器人能够让你实现群服消息互通、查询服务器状态、通过聊天即可管理服务器等功能，让你的玩家交流群与服务器连接起来。 -机器人通常分为两个部分，这两个部分分别负责控制 QQ 和对社交帐号执行程序。 +机器人通常分为两个部分，这两个部分分别负责控制 QQ 和对社交账号执行程序。 其中与 QQ 通信的部分叫 [框架](/general/advance/bot/framework)。机器人程序必须要通过网络或插件等方式与机器人框架连接，然后才能开始控制 QQ 实现对应功能。 diff --git a/src/content/docs/general/advance/bot/plugin.mdx b/src/content/docs/general/advance/bot/plugin.mdx index 49611b515..8317eee6d 100644 --- a/src/content/docs/general/advance/bot/plugin.mdx +++ b/src/content/docs/general/advance/bot/plugin.mdx @@ -6,13 +6,14 @@ sidebar: import { TabItem, Tabs } from "@astrojs/starlight/components"; -指一个运行的 QQ 机器人的插件或者模组，这些插件或者模组负责进行 QQ 消息的处理，并且有一定的拓展性 +指一个运行的 QQ 机器人的插件或者模组，这些插件或者模组负责进行 QQ 消息的处理，并且有一定的拓展性。 -有的 QQ 机器人插件需要外部独立程序的辅助进行处理，但 QQ 连接仍然需要依赖 QQ 机器人框架 +有的 QQ 机器人插件需要外部独立程序的辅助进行处理，但 QQ 连接仍然需要依赖 QQ 机器人框架。 -部分插件模组或者外部独立程序会内置 QQ 机器人框架 +部分插件模组或者外部独立程序会内置 QQ 机器人框架。 + +关于机器人框架详情请见 [通用 | 机器人框架](/general/advance/bot/framework)。 -关于机器人框架详情请见 [通用 | 机器人框架](/general/advance/bot/framework) {/* autocorrect-disable space-punctuation */} @@ -24,9 +25,9 @@ import { TabItem, Tabs } from "@astrojs/starlight/components"; | 作者 | [DreamVoid](https://github.com/DreamVoid) | | 支持 **Java 版** | Bukkit 及其分支 \| BungeeCord \| Waterfall \| Sponge \| Velocity | | 支持 **基岩版** | NukkitX | -| 介绍 | 一个基于 Mirai 的 Minecraft 服务端插件，能够让你在 Minecraft 服务器上使用 Mirai QQ 机器人程序，同时提供一些 API 帮助开发者简单的调用机器人接口为自己的插件实现多样的功能 | +| 介绍 | 一个基于 Mirai 的 Minecraft 服务端插件，能够让你在 Minecraft 服务器上使用 Mirai QQ 机器人程序，同时提供一些 API 帮助开发者简单的调用机器人接口为自己的插件实现多样的功能。 | | 下载 | [GitHub](https://github.com/DreamVoid/MiraiMC/releases) \| [Modrinth](https://modrinth.com/plugin/miraimc) | -| **注意事项** | 由于 Mirai 原生登陆平台已停止更新，并且 MiraiMC 插件自身不支持 Onebot 协议，您需要使用 [这个拓展](https://github.com/DreamVoid/MiraiMCAddon-Overflow) 来给 MiraiMC 添加 Onebot 协议支持 | +| **注意事项** | 由于 Mirai 原生登陆平台已停止更新，并且 MiraiMC 插件自身不支持 OneBot 协议，您需要使用 [这个拓展](https://github.com/DreamVoid/MiraiMCAddon-Overflow) 来给 MiraiMC 添加 OneBot 协议支持。 | @@ -36,7 +37,7 @@ import { TabItem, Tabs } from "@astrojs/starlight/components"; | 相关链接 | [GitHub 仓库](https://github.com/sparkbridge/sparkbridge2) \| [文档站](https://sparkbridge.cn/) | | 作者 | [sparkbridge](https://github.com/sparkbridge) | | 支持 **基岩版** | LeviLaminaBDS | -| 介绍 | 轻量级、模块化和多功能的 Minecraft Bedrock Server BDS 服务器 QQ 机器人适配器，内置群服互通功能，支持插件接入，支持内核分离级别的二次开发 | +| 介绍 | 轻量级、模块化和多功能的 Minecraft Bedrock Server BDS 服务器 QQ 机器人适配器，内置群服互通功能，支持插件接入，支持内核分离级别的二次开发。 | | 下载 | [GitHub](https://github.com/sparkbridge/sparkbridge2/releases) | @@ -47,18 +48,18 @@ import { TabItem, Tabs } from "@astrojs/starlight/components"; | 相关链接 | [GitHub 仓库](https://github.com/Nova-Committee/McBot) \| [Mcmod 文档](https://www.mcmod.cn/class/4903.html) | | 作者 | [Nova-Committee](https://github.com/Nova-Committee) | | 支持 **Java 版** | Forge \| Fabric \| Quite \| Rift | -| 介绍 | 基于 Forge、Fabric 等模组平台开发的 QQ 机器人模组，能让你在 Minecraft 模组服务器上使用 QQ 机器人程序，同时提供一些 API 帮助开发者拓展功能 | -| 下载 | [Modrinth](https://modrinth.com/mod/mcbot) \| [Mcmod](https://www.mcmod.cn/download/4903.html) \| [CruseForge](https://www.curseforge.com/minecraft/mc-mods/mcbot) | +| 介绍 | 基于 Forge、Fabric 等模组平台开发的 QQ 机器人模组，能让你在 Minecraft 模组服务器上使用 QQ 机器人程序，同时提供一些 API 帮助开发者拓展功能。 | +| 下载 | [Modrinth](https://modrinth.com/mod/mcbot) \| [Mcmod](https://www.mcmod.cn/download/4903.html) \| [CurseForge](https://www.curseforge.com/minecraft/mc-mods/mcbot) | -| McBot | ![](https://img.shields.io/badge/状态-积极维护-green?style=for-the-badge) | +| PlumBot | ![](https://img.shields.io/badge/状态-积极维护-green?style=for-the-badge) | | ---------------- | ---------------------------------------------------------------------------------------------------------------------------- | | 相关链接 | [GitHub 仓库](https://github.com/RegadPoleCN/PlumBot) \| [Modrinth 页面](https://modrinth.com/plugin/plumbot) | | 作者 | [RegadPoleCN](https://github.com/RegadPoleCN) | | 支持 **Java 版** | Bukkit 及其分支 | -| 介绍 | 一个可以安装在 Bukkit 等服务端上的 QQ 机器人插件，它能将你的 MC 服务器与 QQ 群或 KOOK 频道联通，支持消息转发，死亡转发等功能 | +| 介绍 | 一个可以安装在 Bukkit 等服务端上的 QQ 机器人插件，它能将你的 MC 服务器与 QQ 群或 KOOK 频道联通，支持消息转发，死亡转发等功能。 | | 下载 | [GitHub](https://github.com/RegadPoleCN/PlumBot/releases) \| [Modrinth](https://modrinth.com/plugin/plumbot) | @@ -69,7 +70,7 @@ import { TabItem, Tabs } from "@astrojs/starlight/components"; | 相关链接 | [GitHub 仓库](https://github.com/alazeprt/AQQBot) | | 作者 | [alazeprt](https://github.com/alazeprt) | | 支持 **Java 版** | Bukkit 及其分支 | -| 介绍 | 一个轻量级、模块化和多功能的 Bukkit 服务器 QQ 机器人插件，内置群服互通功能，允许用户通过 QQ 群实行更多操作 | +| 介绍 | 一个轻量级、模块化和多功能的 Bukkit 服务器 QQ 机器人插件，内置群服互通功能，允许用户通过 QQ 群实行更多操作。 | | 下载 | [GitHub](https://github.com/alazeprt/AQQBot/releases) | @@ -80,7 +81,7 @@ import { TabItem, Tabs } from "@astrojs/starlight/components"; | 相关链接 | [GitHub 仓库](https://github.com/Xinxin-ent/XinxinBotApi) \| [文档站](https://wiki.mcxin.cn/zh/%E6%96%B0%E9%91%AB%E6%8F%92%E4%BB%B6%E6%95%99%E7%A8%8B/XinxinBotApi) [官网](https://bbs.mcxin.cn/archives/216) | | 作者 | [Xinxin-ent](https://github.com/Xinxin-ent) | | 支持 **Java 版** | Bukkit 及其分支 | -| 介绍 | 一个可以安装在 Bukkit 等服务端上的 QQ 机器人插件，并且提供一些 API 帮助开发者拓展功能，配置复杂但效果较好 | +| 介绍 | 一个可以安装在 Bukkit 等服务端上的 QQ 机器人插件，并且提供一些 API 帮助开发者拓展功能，配置复杂但效果较好。 | | 下载 | [官网下载](https://bbs.mcxin.cn/archives/216) | @@ -91,9 +92,9 @@ import { TabItem, Tabs } from "@astrojs/starlight/components"; | 相关链接 | [GitHub 仓库](https://github.com/NeoVoxelDev/NeoBot) \| [文档站](https://neobot-docs.netlify.app/) | | 作者 | [NeoVoxelDev](https://github.com/NeoVoxelDev) | | 支持 **Java 版** | Bukkit 及其分支 \| Folia \| Velocity | -| 介绍 | 一个轻量级、模块化且支持脚本化的 QQ 机器人插件，作为 AQQBot 的继任者，提供全功能脚本化能力，赋予用户高度自定义的灵活性 | +| 介绍 | 一个轻量级、模块化且支持脚本化的 QQ 机器人插件，作为 AQQBot 的继任者，提供全功能脚本化能力，赋予用户高度自定义的灵活性。 | | 下载 | [GitHub](https://github.com/NeoVoxelDev/NeoBot/releases) | -{/* autocorrect-enable */} +{/* autocorrect-enable */} \ No newline at end of file diff --git a/src/content/docs/general/advance/linux/connect-to-server.mdx b/src/content/docs/general/advance/linux/connect-to-server.mdx index 88fbe6e8e..7e1718cc6 100644 --- a/src/content/docs/general/advance/linux/connect-to-server.mdx +++ b/src/content/docs/general/advance/linux/connect-to-server.mdx @@ -9,7 +9,7 @@ Linux 系统上有一个工具被业界广泛使用，它就是 **SSH**。它虽 ## 开启 SSH 服务 -为了让客户能顺利连接服务器，云服务器的 sshd 服务一般默认开启。如果你使用的是家里云，或者云服务器的 sshd 服务确实没有开启 (比如你是只能通过服务商提供的 VNC 或者第三方远控软件连接的服务器，无法使用 SSH)，那么你可能需要先开启 sshd 服务才能连接到服务器。 +为了让客户能顺利连接服务器，云服务器的 sshd 服务一般默认开启。如果你使用的是家里云，或者云服务器的 sshd 服务确实没有开启 （比如你是只能通过服务商提供的 VNC 或者第三方远控软件连接的服务器，无法使用 SSH），那么你可能需要先开启 sshd 服务才能连接到服务器。 在主流的使用 systemd 的 Linux 发行版中，执行 `systemctl enable --now sshd` 命令即可开启 sshd 服务，如果这些命令都报错，证明 sshd 服务存在问题，你可以把报错复制粘贴到搜索引擎上查询怎么修复这个问题。 开启 sshd 服务后，你就可以连接到这台服务器了。 @@ -19,9 +19,9 @@ Linux 系统上有一个工具被业界广泛使用，它就是 **SSH**。它虽 为了安全请不要在服务器上允许 root 用户登录 SSH！如果 SSH 被暴力破解的话会产生非常严重的后果！ -最好可以禁用密码登录，仅允许密钥登录 +最好可以禁用密码登录，仅允许密钥登录。 -关于配置你服务器的 SSH 使其更安全，可以查看 [Arch Linux Wiki 的这篇文章](https://wiki.archlinuxcn.org/wiki/OpenSSH#%E4%BF%9D%E6%8A%A4) +关于配置你服务器的 SSH 使其更安全，可以查看 [Arch Linux Wiki 的这篇文章](https://wiki.archlinuxcn.org/wiki/OpenSSH#%E4%BF%9D%E6%8A%A4)。 ::: @@ -43,9 +43,9 @@ Linux 系统上有一个工具被业界广泛使用，它就是 **SSH**。它虽 ssh @
[-p port] ``` -如何要指定端口，你需要指定端口参数。在一些操作系统上这个参数是 `-p`，例如`ssh root@8aka.org -p 48291`，有一些工具上则是直接在后面输入端口。 +如何要指定端口，你需要指定端口参数。在一些操作系统上这个参数是 `-p`，例如 `ssh root@8aka.org -p 48291`，有一些工具上则是直接在后面输入端口。 例如 Xshell 是 `ssh root@8aka.org 48291`。 -你需要根据不同的工具的使用方式来确定 ssh 的命令格式。比如，你可以仅执行 `ssh` 命令 (等价于 `ssh --help`)，然后让 SSH 工具提示你如何使用当前工具的这个命令，如果需要更详细的说明可以输入命令 `man ssh` +你需要根据不同的工具的使用方式来确定 ssh 的命令格式。比如，你可以仅执行 `ssh` 命令 （等价于 `ssh --help`），然后让 SSH 工具提示你如何使用当前工具的这个命令，如果需要更详细的说明可以输入命令 `man ssh`， 在输入完这行命令后，服务器通常会要求你输入该用户的密码。 @@ -53,11 +53,11 @@ ssh @
[-p port] 1. 使用 `ssh-keygen` 命令生成你的 SSH 密钥。 -2. 使用如 `cat .ssh/id_xxxx.pub` 命令来获取你生成的 SSH 公钥 (此命令中 `xxxx` 的值通常取决于你生成密钥对时选择的算法) +2. 使用如 `cat .ssh/id_xxxx.pub` 命令来获取你生成的 SSH 公钥 （此命令中 `xxxx` 的值通常取决于你生成密钥对时选择的算法）。 -3. 在服务器对应用户的家目录下创建 `./ssh/authorized_keys`，编辑它，将你的公钥粘贴进去，每个公钥独占一行 +3. 在服务器对应用户的家目录下创建 `./ssh/authorized_keys`，编辑它，将你的公钥粘贴进去，每个公钥独占一行。 -4. 执行上面的命令，你会发现连接时不再需要密码而是直接弹出 shell +4. 执行上面的命令，你会发现连接时不再需要密码而是直接弹出 shell。 ### 使用工具连接 @@ -72,7 +72,7 @@ import { TabItem, Tabs } from "@astrojs/starlight/components"; Windows 系统自带的 PowerShell -按下 `Win + R` 输入 `powershell` 即可 (如果安装了新版的 PowerShell 那么你应该输入 `pwsh`) +按下 `Win + R` 输入 `powershell` 即可 （如果安装了新版的 PowerShell 那么你应该输入 `pwsh`） 随后在其中输入 `ssh -p @` 即可连接 Linux 服务器。 @@ -80,11 +80,11 @@ Windows 系统自带的 PowerShell :::tip -port 输入服务器的 SSH 端口 +port 输入服务器的 SSH 端口， -username 为登录服务器的用户名 +username 为登录服务器的用户名， -hostname 为服务器的域名或者 IP +hostname 为服务器的域名或者 IP。 ::: @@ -93,7 +93,7 @@ hostname 为服务器的域名或者 IP ![WindTerm](_assets/Linux开服/连接服务器/WindTerm.png) -一个开源的 SSH/Telnet/Serial/Shell/SFTP 客户端工具 +一个开源的 SSH/Telnet/Serial/Shell/SFTP 客户端工具。 https://github.com/kingToolbox/WindTerm @@ -109,7 +109,7 @@ FinalShell 是一体化的的服务器，网络管理软件，不仅是 SSH 客 ![Xshell 终端](https://www.xshell.com/wp-content/uploads/2020/10/p-xshell7-top-zh.png) -他称自己是 业界最强大的 SSH 客户机 +他称自己是 业界最强大的 SSH 客户机。 @@ -126,7 +126,7 @@ FinalShell 是一体化的的服务器，网络管理软件，不仅是 SSH 客 macOS 内置 ssh 命令，我们可以用终端来执行它。要打开 macOS 上的终端，可以使用以下方式： -- (如果终端 app 没有被移动过) 打开启动台，打开第一页的其他文件夹，点击终端。或者你也可以在应用文件夹 (入口默认固定在访达侧边栏上) 里找到它。 +- (如果终端 app 没有被移动过) 打开启动台，打开第一页的其他文件夹，点击终端。或者你也可以在应用文件夹 （入口默认固定在访达侧边栏上）里找到它。 - 按下 command+ 空格或键盘上的搜索键唤起 spotlight，输入“终端”，然后它就会显示在下面。 diff --git a/src/content/docs/general/advance/linux/keep-running.mdx b/src/content/docs/general/advance/linux/keep-running.mdx index 4e31911a2..d6e15fa4f 100644 --- a/src/content/docs/general/advance/linux/keep-running.mdx +++ b/src/content/docs/general/advance/linux/keep-running.mdx @@ -17,9 +17,21 @@ import { TabItem, Tabs } from "@astrojs/starlight/components"; 确保你的系统上有 `screen` 包，没有的话安装它们： - ```bash apt-get install screen ``` - ```bash yum install screen ``` - ```bash pacman -Sy screen ``` + + ```bash + apt-get install screen + ``` + + + ```bash + yum install screen + ``` + + + ```bash + pacman -Sy screen + ``` + screen 的基础指令： @@ -34,7 +46,7 @@ screen -S xxx -X quit # 删除 xxx 窗口 (在 screen 中输入 exit 也可以 :::note -重新连接到 screen 时可以使用 `screen -Dr xxx` 指令，意为踢出正在使用 xxx 窗口的用户并回到 xxx 窗口 +重新连接到 screen 时可以使用 `screen -Dr xxx` 指令，意为踢出正在使用 xxx 窗口的用户并回到 xxx 窗口。 ::: @@ -49,21 +61,21 @@ screen -S xxx -X quit # 删除 xxx 窗口 (在 screen 中输入 exit 也可以 ::: -推荐原因：后台运行的同时还可以在服务端控制台中查看日志，打指令 +推荐原因：后台运行的同时还可以在服务端控制台中查看日志，输入指令。 ## 方法二 面板 (推荐) -例如 MCSManager 等面板，简单无脑可视化 +例如 [MCSManager](/general/process/panel/#mcsmanager) 等面板，简单无脑可视化。 ## 方法三 systemd -使用 `vim` 命令创建 `mc.service` 单元文件 +使用 `vim` 命令创建 `mc.service` 单元文件： ```bash vim ~/.config/systemd/user/mc.service ``` -文件中的内容按以下配置 +文件中的内容按以下配置： ```ini [Unit] @@ -99,9 +111,9 @@ _可以通过 `systemctl --user status mc.service` 查看服务运行状态。_ [Arch Wiki 上的教程](https://wiki.archlinuxcn.org/wiki/Systemd#%E7%BC%96%E5%86%99%E5%8D%95%E5%85%83%E6%96%87%E4%BB%B6) -优点：可以实现自动重启，开机自启等操作 +优点：可以实现自动重启，开机自启等操作； -缺点：无法进入控制台打指令 +缺点：无法进入控制台打指令。 ## 方法四 nohup 和 & @@ -117,18 +129,18 @@ nohup：在启动时前面加上这个 :::tip -Start.sh: 你需要后台运行的程序 +Start.sh: 你需要后台运行的程序， -> : 日志文件追加到文件中 +> : 日志文件追加到文件中。 -run.log: 运行的日志，或你的文件的输出内容 +run.log: 运行的日志，或你的文件的输出内容。 & 是一个描述符，如果 1 或 2 前不加 &，会被当成一个普通文件。 -`1>&2` 意思是把标准输出重定向到标准错误。 +`1>&2` 意思是把标准输出重定向到标准错误； -`2>&1` 意思是把标准错误输出重定向到标准输出。 +`2>&1` 意思是把标准错误输出重定向到标准输出； -`&>filename` 意思是把标准输出和标准错误输出都重定向到文件 `filename` 中 +`&>filename` 意思是把标准输出和标准错误输出都重定向到文件 `filename` 中。 ::: diff --git a/src/content/docs/general/advance/linux/linux.md b/src/content/docs/general/advance/linux/linux.md index fb2876c50..ce8c4fb3b 100644 --- a/src/content/docs/general/advance/linux/linux.md +++ b/src/content/docs/general/advance/linux/linux.md @@ -6,18 +6,18 @@ sidebar: ## 为什么选择 Linux 开服 -1. 更快的发包速度和接收速度，接入服务器速度将提升数十毫秒起，当面对假人攻击/ DDoS 攻击时会更加稳定； -2. 更好的性能，根据测试 TPS 能提升 8-15%； -3. 更低的内存占用，对于 Windows 服务器一般开机会占用 1-2 GB 内存，而一般的 Linux 系统开机后占用往往不到 0.5 GB； -4. Linux 的稳定性是 Windows 无论如何也无法比拟的； -5. Linux 安全性更高，开源系统，有社区的支持； -6. Linux 支持文件占用直接删除 (也就是说可以自动更新插件，不像 Windows 那样提示文件被占用) +1. 更快的发包速度和接收速度，接入服务器速度将提升数十毫秒起，当面对假人攻击 / DDoS 攻击时会更加稳定。 +2. 更好的性能，根据测试 TPS 能提升 8-15%。 +3. 更低的内存占用，对于 Windows 服务器一般开机会占用 1-2 GB 内存，而一般的 Linux 系统开机后占用往往不到 0.5 GB。 +4. Linux 的稳定性是 Windows 无论如何也无法比拟的。 +5. Linux 安全性更高，开源系统，有社区的支持。 +6. Linux 支持文件占用直接删除（也就是说可以自动更新插件，不像 Windows 那样提示文件被占用）。 :::note -可能会有小伙伴说："Linux 太难操作了，根本不会用。" 其实大多数开 Linux 服务器的服主也不是纯纯使用 Linux 编辑插件配置，那么好，我们为小白推荐三个面板辅助我们开服。 +可能会有小伙伴说：“Linux 太难操作了，根本不会用。” 其实大多数开 Linux 服务器的服主也不是纯纯使用 Linux 编辑插件配置，那么好，我们为小白推荐三个面板辅助我们开服。 -1. [MCSM](https://docs.mcsmanager.com/zh_cn/) 全名 MCSManager 是一款开源，分布式，一键部署，支持 Minecraft 和 Steam 游戏服务器 的控制面板。 +1. [MCSM](https://docs.mcsmanager.com/zh_cn/) 全名 MCSManager，是一款开源、分布式、一键部署，支持 Minecraft 和 Steam 游戏服务器的控制面板。 2. [1Panel](https://1panel.cn/) 是新一代的 Linux 服务器运维管理面板，支持 web 图形界面管理、快速建站、应用商店、安全可靠、一键备份等功能。 3. [宝塔面板](https://www.bt.cn/) 是一款支持 Linux 和 Windows 系统的服务器运维管理工具，提供资源监控、文件管理、软件安装等功能。 @@ -25,14 +25,14 @@ sidebar: ## 基础指令 -在开始开服之前，你需要掌握的 Linux 常用指令 +在开始开服之前，你需要掌握的 Linux 常用指令： [菜鸟教程 | Linux 需要掌握的一些命令](https://www.runoob.com/w3cnote/linux-useful-command.html) ## 鸣谢 -特别感谢 [冰奇](https://github.com/IceBingQI) 提供的本板块的文案及图片 +特别感谢 [冰奇](https://github.com/IceBingQI) 提供的本板块的文案及图片。 ## 另外 -“笨蛋脚本”仅支持 Windows 系统，我们暂时没有移植到 Linux 的计划。 +“笨蛋脚本”仅支持 Windows 系统，我们暂时没有移植到 Linux 的计划。 \ No newline at end of file diff --git a/src/content/docs/general/advance/linux/start.mdx b/src/content/docs/general/advance/linux/start.mdx index cd00badc8..685cab8cb 100644 --- a/src/content/docs/general/advance/linux/start.mdx +++ b/src/content/docs/general/advance/linux/start.mdx @@ -6,11 +6,11 @@ sidebar: import { TabItem, Tabs } from "@astrojs/starlight/components"; -开服之前，请检查服务器是否安装了 Java，在终端输入 +开服之前，请检查服务器是否安装了 Java，在终端输入： `java -version` -如果你看到类似以下的输出，那么服务器中已经安装了 Java +如果你看到类似以下的输出，那么服务器中已经安装了 Java。 ```txt openjdk version "21.0.2" 2024-01-16 LTS @@ -24,7 +24,7 @@ OpenJDK 64-Bit Server VM Zulu21.32+17-CA (build 21.0.2+13-LTS, mixed mode, shari ### 软件包管理器安装 -下方以安装 `openjdk-17` 为例 +下方以安装 `openjdk-17` 为例： sudo apt install openjdk-17-jdk @@ -32,18 +32,18 @@ OpenJDK 64-Bit Server VM Zulu21.32+17-CA (build 21.0.2+13-LTS, mixed mode, shari sudo pacman -S jdk11-openjdk -其他发行版安装方式自行百度 +其他发行版安装方式自行百度。 ### 手动 ♂ -推荐使用软件包管理器安装而不是自己手动装 +推荐使用软件包管理器安装而不是自己手动装。
点击查看 -一般来说，在 Linux 中进行软件安装部署会放在 `/opt` 目录下，我们也遵循这个规则，当然你也可以不遵循 +一般来说，在 Linux 中进行软件安装部署会放在 `/opt` 目录下，我们也遵循这个规则，当然你也可以不遵循。 -使用 cd 切换到/opt 目录 +使用 cd 切换到/opt 目录： `cd /opt` @@ -55,7 +55,7 @@ OpenJDK 64-Bit Server VM Zulu21.32+17-CA (build 21.0.2+13-LTS, mixed mode, shari ![](\_assets/Linux开服/开服/1.png) -#### wegt 下载 +#### wget 下载 使用 wget 指令下载 @@ -73,31 +73,43 @@ OpenJDK 64-Bit Server VM Zulu21.32+17-CA (build 21.0.2+13-LTS, mixed mode, shari ![](\_assets/Linux开服/开服/4.png) -这样就算是安装好了 (PS：这里的操作仅适用于开服使用，若需要其他需要 jdk 的操作请使用包管理器安装 openjdk) +这样就算是安装好了（PS：这里的操作仅适用于开服使用，若需要其他需要 jdk 的操作请使用包管理器安装 openjdk）
## 多版本 Java 共存 -方法很多，这里举出两种 +方法很多，这里举出两种： ### 方法一 - update-alternatives --config java - update-alternatives --config java - archlinux-java set jdk-vesion + + ```bash + update-alternatives --config java + ``` + + + ```bash + update-alternatives --config java + ``` + + + ```bash + archlinux-java set jdk-vesion + ``` + -然后选择你想使用的 Java，接着 `java -version` 验证版本 +然后选择你想使用的 Java，接着 `java -version` 验证版本。 ### 方法二 设置别名 -确定你所使用的终端，此处以 `bash` 和 `Azul Zulu` 为例 +确定你所使用的终端，此处以 `bash` 和 `Azul Zulu` 为例。 -`vim ~/.bashrc` 在这个文件末尾追加 +`vim ~/.bashrc` 在这个文件末尾追加： ```bash # java @@ -105,7 +117,7 @@ alias java8='/usr/lib/jvm/zulu-8/bin/java' alias java17='/usr/lib/jvm/zulu-17/bin/java' ``` -然后刷新：`source ~/.bashrc` +然后刷新：`source ~/.bashrc`。 - 使用 Java8 开服： @@ -127,13 +139,13 @@ TODO - 完善和排版 ::: -在 `/opt` 目录中使用 `mkdir` 命令创建一个目录用于开服 +在 `/opt` 目录中使用 `mkdir` 命令创建一个目录用于开服： ![](_assets/Linux开服/开服/5.png) -将核心放入服务器内，并编写简单的开服脚本 +将核心放入服务器内，并编写简单的开服脚本， -使用 `chmod` 命令给脚本增加运行权限 +使用 `chmod` 命令给脚本增加运行权限： ```bash chmod +x example.sh @@ -141,10 +153,10 @@ chmod +x example.sh ![](_assets/Linux开服/开服/6.png) -输入 `./start.sh` 或者输入 `bash start.sh` 即可启动 +输入 `./start.sh` 或者输入 `bash start.sh` 即可启动。 ![](_assets/Linux开服/开服/7.png) -使用 `vim` 命令修改 eula 为 `true` 就可以开服了 +使用 `vim` 命令修改 eula 为 `true` 就可以开服了。 ![](_assets/Linux开服/开服/8.png) diff --git a/src/content/docs/general/basics/what-is-datapack.mdx b/src/content/docs/general/basics/what-is-datapack.mdx index fd58a4935..6d53eae57 100644 --- a/src/content/docs/general/basics/what-is-datapack.mdx +++ b/src/content/docs/general/basics/what-is-datapack.mdx @@ -1,14 +1,13 @@ --- title: 什么是数据包？ topic: basics -template: splash --- import { FileTree } from "@astrojs/starlight/components"; 数据包是从 Minecraft 逻辑结构层面修改我的世界，他可以添加或覆盖游戏中几乎一切的元素。一定程度下可以代替 mod，但它并不会改变原版的内容。 -其功能可用于覆盖或添加新的函数、进度、战利品表、物品修饰器、配方、结构、标签、维度、世界生成等 +其功能可用于覆盖或添加新的函数、进度、战利品表、物品修饰器、配方、结构、标签、维度、世界生成等。 # 数据包的存放位置 @@ -18,9 +17,9 @@ import { FileTree } from "@astrojs/starlight/components"; 数据包是存在加载顺序的，在数据包各个功能同一个分类下不同的加载顺序会导致不同的结果也就是不同的覆盖产生。 -这个顺序存储在 `world/level.dat` 。您可以通过单人创建存档时调整数据包的位置决定数据包的加载顺序 +这个顺序存储在 `world/level.dat` 。您可以通过单人创建存档时调整数据包的位置决定数据包的加载顺序。 -您可以通过 `/datapack` 查看已经加载或未加载的数据包 +您可以通过 `/datapack` 查看已经加载或未加载的数据包。 # 相关资源下载 @@ -206,4 +205,4 @@ import { FileTree } from "@astrojs/starlight/components"; # 数据包的编写 -太多了，详情请参阅 [Minecraft Wiki](https://zh.minecraft.wiki/w/%E6%95%B0%E6%8D%AE%E5%8C%85) +太多了，详情请参阅 [Minecraft Wiki](https://zh.minecraft.wiki/w/%E6%95%B0%E6%8D%AE%E5%8C%85)。 diff --git a/src/content/docs/general/basics/what-is-lag.md b/src/content/docs/general/basics/what-is-lag.md index 2dc343cb9..f12506481 100644 --- a/src/content/docs/general/basics/what-is-lag.md +++ b/src/content/docs/general/basics/what-is-lag.md @@ -1,18 +1,15 @@ --- title: 什么是卡顿？ topic: basics -template: splash --- -服务器中玩家可感知到的卡顿是多种多样的，其中主要包括服务器处理速度不足导致的 **MSPT** 偏高， **TPS** 偏低， +服务器中玩家可感知到的卡顿是多种多样的，其中主要包括服务器处理速度不足导致的 **MSPT** 偏高、**TPS** 偏低，以及服务器网络波动导致的 **Ping**（即服务器和玩家之间的网络延迟）。 -服务器网络波动导致的 **Ping** (即为服务器和玩家之间的网络延迟) - -总的说来 **MSPT** 和 **TPS** 是用于评价服务器流畅程度的，而 **Ping** 是用于评价服务器和玩家之间的网络稳定性。 +总的说来，**MSPT** 和 **TPS** 是用于评价服务器流畅程度的指标，而 **Ping** 是用于评价服务器和玩家之间的网络稳定性的指标。 :::tip -玩家往往分不清到底是服务器卡顿还是网络延迟，请服主自行区分。不用因为玩家在社区说一句 `"服务器卡了"` 然后就默认是服务器问题。 +玩家往往分不清到底是服务器卡顿还是网络延迟，请服主自行区分。不用因为玩家在社区说一句 `"服务器卡了"` 就默认是服务器问题。 ::: @@ -20,85 +17,79 @@ template: splash Minecraft 服务器卡顿的底层逻辑是什么？ -**理想情况下**，Minecraft 无论什么版本都是每秒钟刷新 20 次，也就是说每次刷新之间间隔 50 ms (1000 ms / 20) 刷新一次，即为一个 **Tick**； +**理想情况下**，Minecraft 无论什么版本都是每秒钟刷新 20 次，也就是说每次刷新之间间隔 50 ms（1000 ms / 20）刷新一次，即为一个 **Tick**。 ![](https://spark.lucko.me/docs/assets/images/ticks-lagging-0bec1e4f565281af7a643f94222df521.png) -**正常情况下**，每个 Tick 都小于 50 ms，为了保证 Minecraft 以 20 Tick 每秒的速度运行，服务器将选择等待下一个 Tick； +**正常情况下**，每个 Tick 都小于 50 ms，为了保证 Minecraft 以 20 Tick/秒 的速度运行，服务器将选择等待下一个 Tick。 ![](https://spark.lucko.me/docs/assets/images/ticks-with-sleeping-3b944bf10f5a21b16d1454f2d7fee434.png) -**服务器滞后时**，当服务器某个 Tick 无法在 50 ms 内完成时，服务器将产生滞后，一旦滞后，每个 Tick 将会顺延，每秒钟发生的 Tick 将会减少。 +**服务器滞后时**，当服务器某个 Tick 无法在 50 ms 内完成时，服务器将产生滞后。一旦滞后，每个 Tick 将会顺延，每秒钟发生的 Tick 将会减少。 ![](https://spark.lucko.me/docs/assets/images/ticks-lagging-0bec1e4f565281af7a643f94222df521.png) :::caution -此处只是最简单的理解，要对卡顿有更深层的理解请查看 TODO:多线程 +此处只是最简单的理解，要对卡顿有更深层的理解请查看 TODO：多线程。 ::: ### TPS -TPS (Ticks Per Second)(每秒 Tick 数) 正常应为 20，即服务器每秒钟进行 20 次更新，确保红石、生物 AI 等按照正常工作。 +TPS（Ticks Per Second，每秒 Tick 数）正常应为 20，即服务器每秒钟进行 20 次更新，确保红石、生物 AI 等按照正常工作。 :::caution TPS 只是最基础的量化卡顿程度。并不是 TPS 高，玩家就感受不到卡顿，也不是 TPS 低就一定会感受到非常卡顿。 -这是因为，TPS 只是计算一个平均值，如果某一个 Tick 花费了 800 ms，而剩下的 18 Tick 只花费了 200 ms，即使计算出的 TPS 为 19 但玩家会感受到的 800 ms 的滞后。下文提到的 MSPT 能够更加精准量化卡顿程度。 +这是因为，TPS 只是计算一个平均值。如果某一个 Tick 花费了 800 ms，而剩下的 19 个 Tick 只花费了 200 ms，即使计算出的 TPS 为 19.9，玩家也会感受到那 800 ms 的滞后。下文提到的 MSPT 能够更加精准地量化卡顿程度。 ::: ### MSPT -MSPT (Milliseconds Per Tick)(就是每进行一次 Tick 所花费的毫秒数) - -如果 MSPT 数值较低，说明服务器可以迅速快速进行每次 Tick，游戏运行更为流畅。 +MSPT（Milliseconds Per Tick，每进行一次 Tick 所花费的毫秒数）。 +如果 MSPT 数值较低，说明服务器可以迅速完成每次 Tick，游戏运行更为流畅。 反之，如果 MSPT 过高，意味着每次 Tick 所需的时间变长，游戏的运行速度就会变慢，进而影响到整体的 TPS。 -影响 MSPT 的东西很多，如区块生成，AI 计算，插件计划任务等都会影响 MSPT。 +影响 MSPT 的因素很多，如区块生成、AI 计算、插件计划任务等都会影响 MSPT。 ### 查看 TPS 和 MSPT -1. 如果为 Purpur fork 服务器可以输入 `/tpsbar` 查看 MSPT 和 TPS； - -2. 如果为 Paper 服务器可输入 `/mspt` 查看 MSPT，输入 `/tps` 查看 TPS； - -3. 安装 [TabTPS](https://hangar.papermc.io/jmp/TabTPS) 插件，显示更好看。 +1. 如果为 Purpur fork 服务器，可以输入 `/tpsbar` 查看 MSPT 和 TPS。 +2. 如果为 Paper 服务器，可输入 `/mspt` 查看 MSPT，输入 `/tps` 查看 TPS。 +3. 安装 [TabTPS](https://hangar.papermc.io/jmp/TabTPS) 插件，显示效果更好。 ## 网络延迟 -在 Minecraft 中，网络延迟 (通常表示为 Ping) 是玩家连接到服务器时数据传输所花费的时间。 +在 Minecraft 中，网络延迟（通常表示为 Ping）是玩家连接到服务器时数据传输所花费的时间。 Ping 值的高低直接影响了玩家在游戏中的体验，特别是在需要快速反应和精确操作的场合。 ### 如何计算 Ping 当玩家在 Minecraft 中尝试与服务器通信时，玩家的计算机会向服务器发送一个数据包，然后等待服务器的响应。 - 从数据包发送出去到收到服务器的响应，所花费的时间就是 Ping 值。Ping 通常以 ms 为单位来表示。 Ping 值的高低对游戏体验有着显著的影响。 :::tip -Ping 的具体要求大概和服务器本身的性质有关系 +Ping 的具体要求大概和服务器本身的性质有关系。 -一般说来服务器 Ping 要求为： +一般来说，服务器 Ping 要求为： 1. PVP 服务器：< 50 ms 2. 生存服务器：< 200 ms 3. 建筑服务器：< 500 ms -此处的延迟为玩家在该类型服务器游戏体验明显变差的阈值，并非高于本数值就完全不可玩。总而言之，为玩家提供可靠的链接是每个服务器应尽的义务。 +此处的延迟为玩家在该类型服务器游戏体验明显变差的阈值，并非高于本数值就完全不可玩。总而言之，为玩家提供可靠的连接是每个服务器应尽的义务。 ::: ### 显示 Ping -1. 在多人游戏列表中，当玩家在多人游戏列表中浏览服务器时，每个服务器旁边通常会显示一个 Ping 值。 - -2. 进入服务器后，按下 TAB 即可查看每个人的 Ping 大概状态 (根据信号格数)。 - -3. 安装了 PlaceholderAPI 和 任意 TAB 类插件，将 `%player_ping%` 作为变量可在目标位置显示具体延迟。 +1. 在多人游戏列表中，当玩家浏览服务器时，每个服务器旁边通常会显示一个 Ping 值。 +2. 进入服务器后，按下 TAB 键即可查看每个人的 Ping 大概状态（根据信号格数）。 +3. 安装了 PlaceholderAPI 和任意 TAB 类插件，将 `%player_ping%` 作为变量可在目标位置显示具体延迟。 \ No newline at end of file diff --git a/src/content/docs/general/basics/what-is-log.md b/src/content/docs/general/basics/what-is-log.md index 96128edf2..99dcd3a0c 100644 --- a/src/content/docs/general/basics/what-is-log.md +++ b/src/content/docs/general/basics/what-is-log.md @@ -1,7 +1,6 @@ --- title: 什么是日志？ topic: basics -template: splash --- **日志** 记录了服务器的运行信息，运行时产生的错误和警告，同时也是大佬们用来分析为什么功能不正常或不能用的必要途径。 @@ -10,7 +9,7 @@ template: splash 每天凌晨 00:00 时服务器将会将最新的日志 **latest.log** 压缩为以时间命名的 gz 压缩文件。用压缩软件解压对应时间的压缩文件即可进行阅读。 -想要了解日志里写了什么，只需要使用任意文本编辑软件打开即可 (不建议使用系统自带的记事本，因为大多数文本编辑软件都会高亮关键词) +想要了解日志里写了什么，只需要使用任意文本编辑软件打开即可 （不建议使用系统自带的记事本，因为大多数文本编辑软件都会高亮关键词） ## 日志组成 @@ -30,11 +29,11 @@ template: splash ### 时间 -即服务器输出该条日志的事件 (有时候输出量特别大的时候时间可能不完全准确)。 +即服务器输出该条日志的事件（有时候输出量特别大的时候时间可能不完全准确）。 ### 线程 -一般为 **Server thread** 即主线程，很多插件会调用 Craft Scheduler Thread 线程，或者为了优化主线程开销开启单独线程 (如 LuckPerms)。 +一般为 **Server thread** 即主线程，很多插件会调用 Craft Scheduler Thread 线程，或者为了优化主线程开销开启单独线程（如 LuckPerms）。 **Craft Scheduler Thread** 一般为插件使用 Bukkit 计划任务时自动开启的线程。 @@ -42,7 +41,7 @@ template: splash 1. 某些时候如果后台被大量刷屏，可以先检查线程信息，或许对定位日志来源有帮助； -2. 除了主线程之外，一个线程卡顿一般不影响其他线程的运行 (如聊天线程阻塞，服务器可以继续运行，但无法聊天)。 +2. 除了主线程之外，一个线程卡顿一般不影响其他线程的运行（如聊天线程阻塞，服务器可以继续运行，但无法聊天）。 ::: @@ -54,7 +53,8 @@ template: splash | WARN | 警告 | 对于一些潜在的风险进行警告，有可能发展为报错 | | ERROR | 错误 | 服务器出现错误后输出的信息 | -总的来说，当服务器出现异常时请立刻检查日志中是否出现了 `WARN` 或 `ERROR` 级别的报错，建议先搜索查看是否有人遇到类似情况，再结合翻译结果尝试修复。如果搞不定可以请教其他人，但是切记一定要先读一读 [如何提问](/general/more/ask-for-help) +总的来说，当服务器出现异常时请立刻检查日志中是否出现了 `WARN` 或 `ERROR` 级别的报错，建议先搜索查看是否有人遇到类似情况，再结合翻译结果尝试修复。 +如果搞不定可以请教其他人，但是切记一定要先读一读 [如何提问](/general/more/ask-for-help)。 #### INFO @@ -81,7 +81,7 @@ template: splash [00:01:32] [Server thread/WARN]: [PvPManager] Error loading Vault! No Economy plugin found ``` -这段日志说明了插件 **PvPManager** 警告我们未找到经济插件 (No Economy plugin found)。 +这段日志说明了插件 **PvPManager** 警告我们未找到经济插件（No Economy plugin found）。 #### ERROR diff --git a/src/content/docs/general/basics/what-is-messy-code.md b/src/content/docs/general/basics/what-is-messy-code.md index 03d58ac0f..404160f7a 100644 --- a/src/content/docs/general/basics/what-is-messy-code.md +++ b/src/content/docs/general/basics/what-is-messy-code.md @@ -1,7 +1,6 @@ --- title: 什么是乱码？ topic: basics -template: splash --- 有时候，你会发现你的文本文件中的中文都莫名其妙变成了一些奇奇怪怪的符号，看起来乱糟糟的，毫无逻辑可言。 @@ -9,17 +8,17 @@ template: splash ## 为什么会出现乱码？ -乱码出现的原因，就是不使用原来编写文本的时候的编码来打开这个文本。 +乱码出现的原因，就是不使用原来编写文本时所使用的编码来打开这个文本。 而不同编码确定一个字符的规则不同。 ## 什么是编码？ -编码，也叫 **字符编码**。通俗的讲，就是计算机的"字典"。你的文本文件在计算机中并不是以明文存在的，而是以一串二进制数表示的。比如： +编码，也叫 **字符编码**。通俗地讲，就是计算机的“字典”。你的文本文件在计算机中并不是以明文存在的，而是以一串二进制数表示的。比如： -如果你让计算机使用 A 编码，然后你输入了一个"人"字。那么在你输入后，计算机就会将"人"字转换为 A 编码中"人"字对应的二进制数。比如这个二进制数是 0010011。 +如果你让计算机使用 A 编码，然后你输入了一个“人”字。那么在你输入后，计算机就会将“人”字转换为 A 编码中“人”字对应的二进制数，比如这个二进制数是 0010011。 -倘若我再次打开的时候使用了 B 编码，而计算机中存储的二进制数仍然是 0010011。那么计算机就会在 B 编码的字符库中查找这个二进制数对应的字，比如在 B 编码中，0010011 指的是"你"这个字，那么你再次打开这个文本的时候你就会发现"人"字变成了"你"字。 +倘若我再次打开的时候使用了 B 编码，而计算机中存储的二进制数仍然是 0010011。那么计算机就会在 B 编码的字符库中查找这个二进制数对应的字，比如在 B 编码中，0010011 指的是“你”这个字，那么你再次打开这个文本的时候就会发现“人”字变成了“你”字。 当然，实际的编码规则远没有这么简单，大家只需要理解为什么会乱码就可以了。 @@ -33,10 +32,10 @@ template: splash | 口字码 | ![](_assets/口字符.png) | 大部分字符为小方块 | 以 UTF-8 方式读取 GBK 编码的中文 | | 符号码 | å²çæ³å½äºå¾ä¹ | 大部分字符为各种符号 | 以 ISO8859-1 方式读取 UTF-8 编码的中文 | | 拼音码 | ËêµÄ·¨¹úÁ˺ܾà | 大部分字符以头顶带有各种类型声调符号的字母 | 以 ISO8859-1 方式读取 GBK 编码的中文 | -| 问句码 | 好好学习天天？? | 字符串长度为偶数时正确，长度为奇数时最后的字符变为问号 | 以 GBK 方式读取 UTF-8 编码的中文，然后又用 UTF-8 的格式再次读取 | -| 锟拷码 | 锟斤拷锟斤拷锟斤拷锟斤拷锟斤拷 | 全中文字符，且大部分字符为"锟斤拷"这几个字符 | 以 UTF-8 方式读取 GBK 编码的中文，然后又用 GBK 的格式再次读取 | +| 问句码 | 好好学习天天？? | 字符串长度为偶数时正常，长度为奇数时最后的字符变为问号 | 以 GBK 方式读取 UTF-8 编码的中文，然后又用 UTF-8 的格式再次读取 | +| 锟拷码 | 锟斤拷锟斤拷锟斤拷锟斤拷锟斤拷 | 全中文字符，且大部分字符为“锟斤拷”这几个字符 | 以 UTF-8 方式读取 GBK 编码的中文，然后又用 GBK 的格式再次读取 | -解决乱码的方式也很简单，只需要根据乱码的特征，进行转码或重新用原来的编码打开就可以了。 +解决乱码的方式也很简单：只需要根据乱码的特征进行转码，或重新用原来的编码打开即可。 ## 如何设置编码、转码 @@ -44,14 +43,14 @@ template: splash ![](https://img.fastmirror.net/s/2024/07/19/6699cc78da4ab.png) -发现这是典型的口字码 +发现这是典型的口字码。 -我们看到 VS Code 右下角 +我们看到 VS Code 右下角： ![](https://img.fastmirror.net/s/2024/07/19/6699cd59a7b0a.png) -点击 **UTF-8** +点击 **UTF-8**。 -然后重新用 **GBK** 方式打开就可以了 +然后重新用 **GBK** 方式打开即可。 -![](https://img.fastmirror.net/s/2024/07/19/6699cd9d5521f.png) +![](https://img.fastmirror.net/s/2024/07/19/6699cd9d5521f.png) \ No newline at end of file diff --git a/src/content/docs/general/basics/what-is-mod.md b/src/content/docs/general/basics/what-is-mod.md index e234f4186..16fed7d12 100644 --- a/src/content/docs/general/basics/what-is-mod.md +++ b/src/content/docs/general/basics/what-is-mod.md @@ -1,14 +1,13 @@ --- title: 什么是模组？ topic: basics -template: splash --- -模组 (Mod) 是遵循 Forge、Fabric 或 LiteLoader 等 API 规范编写的 Java 程序。 +模组（Mod）是遵循 Forge、Fabric 或 LiteLoader 等 API 规范编写的 Java 程序。 ## 工作形式 -Minecraft 模组 (Mod) 一般来说模组会利用 Forge 或 Fabric 作为前置开发，通过反编译 Minecraft Java 源代码了解 Minecraft 干了什么， +Minecraft 模组（Mod）一般来说模组会利用 Forge 或 Fabric 作为前置开发，通过反编译 Minecraft Java 源代码了解 Minecraft 干了什么， 进而删减或修改内容以实现新的功能。删减或修改内容既可以是服务端，也可以是客户端。因而相较插件只能修改部分服务端的内容要有更大的功能性。 diff --git a/src/content/docs/general/basics/what-is-namespace.md b/src/content/docs/general/basics/what-is-namespace.md index 9f637417c..ce982f13a 100644 --- a/src/content/docs/general/basics/what-is-namespace.md +++ b/src/content/docs/general/basics/what-is-namespace.md @@ -1,22 +1,21 @@ --- title: 什么是命名空间？ topic: basics -template: splash --- ## 概念 > 命名空间 ID（Namespaced identifier，或译为命名空间标识符）、资源路径（Resource location）、资源标识符（Resource identifier）或命名空间字符串（Namespaced string）是用来指明和识别游戏中特定对象而又能避免潜在的歧义和冲突的一种方式。 -如果比喻一下的话，就像是 +如果比喻一下的话，就像是： ![](_assets/妙妙比喻.png) -你的 "桌面" 上有几个命名空间（文件夹），这几个命名空间不能重名，命名空间里的东西可以重名 +你的“桌面”上有几个命名空间（文件夹），这几个命名空间不能重名，命名空间里的东西可以重名。 -对于重名的 ID，可以用命名空间加以区分 +对于重名的 ID，可以用命名空间加以区分。 -格式通常是 `命名空间:ID` ，例如： `minecraft:tp` +格式通常是 `命名空间:ID`，例如：`minecraft:tp`。 例如，在上面的比喻中： @@ -25,40 +24,40 @@ template: splash ## 物品 -原版物品的命名空间 `minecraft` 可不写，会自动补全，例如 `minecraft:stone` == `stone` +原版物品的命名空间 `minecraft` 可不写，会自动补全，例如 `minecraft:stone` == `stone`。 -但是 mod 物品你不写也会补 `minecraft`，导致找不到物品 +但是 Mod 物品你不写也会补 `minecraft`，导致找不到物品。 -所以，如果你想在菜单等地方使用来自 mod 的物品，应该写 `mod命名空间:物品ID` +所以，如果你想在菜单等地方使用来自 Mod 的物品，应该写 `Mod命名空间:物品ID`。 ## 命令 -命令存在 **优先级** 的概念 +命令存在 **优先级** 的概念。 -例如，当你安装 EssentialsX 之后，原版 tp 命令会被覆盖 +例如，当你安装 EssentialsX 之后，原版 tp 命令会被覆盖： ![](_assets/command-1.png) -而同时安装 EssentialsX 和 HuskHomes 之后，使用 tp 是 HuskHomes 提供的 +而同时安装 EssentialsX 和 HuskHomes 之后，使用 tp 是 HuskHomes 提供的： ![](_assets/command-2.png) -如果此时你想使用 EssentialsX 的而不是 HuskHomes 的，可以使用命名空间 +如果此时你想使用 EssentialsX 的而不是 HuskHomes 的，可以使用命名空间： ![](_assets/command-3.png) -当然，你也可以使用原版命令，原版命名空间是 `minecraft` +当然，你也可以使用原版命令，原版命名空间是 `minecraft`： ![](_assets/command-4.png) -通常，你作为用户不能调整优先级，这是插件开发者才能做的事 +通常，你作为用户不能调整优先级，这是插件开发者才能做的事。 -通常，插件作者会使用插件名字作为命名空间的名字 +通常，插件作者会使用插件名字作为命名空间的名字。 ## 资源包 -去学资源包基础而不是让我教你这个 +去学 [资源包基础](/java/advance/resourcepack/intro/) 而不是让我教你这个。 ## 参考 -https://zh.minecraft.wiki/w/%E5%91%BD%E5%90%8D%E7%A9%BA%E9%97%B4ID +https://zh.minecraft.wiki/w/%E5%91%BD%E5%90%8D%E7%A9%BA%E9%97%B4ID \ No newline at end of file diff --git a/src/content/docs/general/basics/what-is-nbt.md b/src/content/docs/general/basics/what-is-nbt.md index 51e191161..9539395b8 100644 --- a/src/content/docs/general/basics/what-is-nbt.md +++ b/src/content/docs/general/basics/what-is-nbt.md @@ -1,7 +1,6 @@ --- title: 什么是 NBT？ topic: basics -template: splash --- ## 概念 diff --git a/src/content/docs/general/basics/what-is-permission.md b/src/content/docs/general/basics/what-is-permission.md index b6f90a540..11ea990ff 100644 --- a/src/content/docs/general/basics/what-is-permission.md +++ b/src/content/docs/general/basics/what-is-permission.md @@ -1,22 +1,21 @@ --- title: 什么是权限？ topic: basics -template: splash --- -权限 - 在插件服务端中，确认玩家做某行为的能力是否被允许。 +权限：在插件服务端中，确认玩家做某行为的能力是否被允许。 -节点 - 权限的单元，一个节点就是一条权限，可以使用权限系统插件给予各个用户，如 `cmi.tp` 就是一条权限节点，而权限节点前的 `cmi` 就是父节点。 +节点：权限的单元，一个节点就是一条权限，可以使用权限系统插件给予各个用户。如 `cmi.tp` 就是一条权限节点，而权限节点前的 `cmi` 就是父节点。 -通配符 - 即为 `*` ，当给予玩家权限 `父节点.*` 即可获取父节点对应的所有权限节点，如 `cmi.*` 即代表 所有的 `cmi.kit` `cmi.heal`...等节点。 +通配符：即为 `*`，当给予玩家权限 `父节点.*` 即可获取父节点对应的所有权限节点，如 `cmi.*` 即代表所有的 `cmi.kit`、`cmi.heal` 等节点。 -继承 - 继承就是子用户组可以使用从父用户组继承的各种属性。 +继承：继承就是子用户组可以使用从父用户组继承的各种属性。 ## 关于权限 **_合法而稳定的权力在使用得当时很少遇到抵抗。 ——塞·约翰逊_** -**_最大限度地行使权力总是令人反感；权力不易确定之处始终存在着危险。--塞·约翰逊_** +**_最大限度地行使权力总是令人反感；权力不易确定之处始终存在着危险。——塞·约翰逊_** ## 权限的作用 @@ -24,15 +23,15 @@ template: splash ## 权限的设置 -我们有且只推荐 LuckPerms 作为权限插件，具体的使用方法请参考 [LuckPerms 使用方法](/java/process/plugin/management-tool/permission/intro) +我们推荐且只推荐 LuckPerms 作为权限插件，具体的使用方法请参考 [LuckPerms 使用方法](/java/process/plugin/management-tool/permission/intro)。 以下举例了一些常见的权限组分类： | 组名 | 说明 | | :-------------- | :-------------------------------------------------------------------------------------------- | -| Newbie (新人) | Newbie 用户组包括最基础的权限节点，应该给予所有新加入玩家在注册时保证安全的权限 | -| Player (玩家) | Player 用户组包括了所有玩家可以使用的权限。一般包含经济、基础传送，和其他的基础指令 | -| Helper (协管员) | 一般允许拥有踢出玩家、监禁玩家、封禁玩家 IP 等权限。 | -| Admin (管理员) | 一般允许使用所有权限，且通常是唯一一个拥有控制插件、规定用户组、关闭/重启服务器命令的用户组。 | +| Newbie (新人) | Newbie 用户组包括最基础的权限节点，应该给予所有新加入玩家在注册时保证安全的权限。 | +| Player (玩家) | Player 用户组包括了所有玩家可以使用的权限，一般包含经济、基础传送和其他基础指令。 | +| Helper (协管员) | 一般允许拥有踢出玩家、监禁玩家、封禁玩家 IP 等权限。 | +| Admin (管理员) | 一般允许使用所有权限，且通常是唯一一个拥有控制插件、规定用户组、关闭/重启服务器命令的用户组。 | -当然你也可以自定义一个例如 VIP1、VIP2 的权限组，拥有比普通用户更多的权限。 +当然你也可以自定义一个例如 VIP1、VIP2 的权限组，拥有比普通用户更多的权限。 \ No newline at end of file diff --git a/src/content/docs/general/basics/what-is-plugin.md b/src/content/docs/general/basics/what-is-plugin.md index fa743e149..66ee16e5a 100644 --- a/src/content/docs/general/basics/what-is-plugin.md +++ b/src/content/docs/general/basics/what-is-plugin.md @@ -1,70 +1,67 @@ --- title: 什么是插件？ topic: basics -template: splash --- -如果你玩过整合包你一定对 `Mod` (即模组) 这个概念相当了解，但如果你是第一次开服，你可能不知道什么是 `Plugin` (插件)，本文章会详细为你介绍。 +如果你玩过整合包，你一定对 `Mod`（即模组）这个概念相当了解，但如果你是第一次开服，你可能不知道什么是 `Plugin`（插件）。本文章会为你详细介绍。 ## 工作形式 -不同于大部分模组需要同时安装在客户端和服务端，插件安装在 **服务端**， +不同于大部分模组需要同时安装在客户端和服务端，插件安装在 **服务端**。 -玩家只需使用原版客户端即可进入服务器，大多数情况下不需要专门安装 mod。 +玩家只需使用原版客户端即可进入服务器，大多数情况下不需要专门安装 Mod。 -插件为什么叫插件 (Plugins)，是因为它相对于模组 (Mods) 有更高的即时性， - -能够更为方便地添加或修改游戏内容，对 Minecraft 本身的侵入性修改也更小。 +插件之所以叫插件（Plugins），是因为它相对于模组（Mods）有更高的即时性，能够更为方便地添加或修改游戏内容，对 Minecraft 本身的侵入性修改也更小。 ## 安装位置 -插件安装在服务器根目录的 `/plugins` 文件夹，然后需要 **重启** 服务器 +插件安装在服务器根目录的 `/plugins` 文件夹，然后需要 **重启** 服务器。 :::danger -永远不要在不知道会发生什么的情况下热加载/热重载/热卸载任何插件。 +永远不要在不知道会发生什么的情况下热加载 / 热重载 / 热卸载任何插件。 ::: -> 插件热加载/热重载/热卸载指的是在服务器已经在运行时加载/重启/卸载插件 +> 插件热加载 / 热重载 / 热卸载指的是在服务器已经在运行时加载 / 重启 / 卸载插件。 > > 服务器运行时不要轻易这么做，绝大多数插件本身不支持热加载，这么做会导致不可预料的后果。 > -> 如果你一定要逆天而行，查看 [插件管理](/java/process/plugin/management-tool/plugin-management/intro) 页面。 +> 如果你一定要逆天而行，请查看 [插件管理](/java/process/plugin/management-tool/plugin-management/intro) 页面。 :::caution 如果你正在使用一个没有明确提醒支持哪个子版本的插件，那么要小心： -SpigotMC 的插件版本支持除了 1.20.6 只会显示大版本号 (如 1.20) 而不会显示小版本号 (如 1.20.4) +SpigotMC 的插件版本支持除了 1.20.6 只会显示大版本号（如 1.20）而不会显示小版本号（如 1.20.4）。 -因此如果你不确定这个插件是否支持该小版本，就算加载成功 (绿名) 也一定要完整测试了这个插件能够正常使用。 +因此如果你不确定这个插件是否支持该小版本，就算加载成功（绿名）也一定要完整测试这个插件是否能够正常使用。 ::: ## 插件的优点 -- 插件服的开发大多数时候都更加简单，而不需要接触 Minecraft 的源代码。像 Skript 那样的脚本语言将插件的开发难度降到了有点脑子就会 +- 插件服的开发大多数时候都更加简单，而不需要接触 Minecraft 的源代码。像 Skript 那样的脚本语言将插件的开发难度降到了“有点脑子就会”的程度。 - 插件的接口大多数时候都使用了事件来抽象化监听服务器的各种行为的复杂性，同时也提供了更好的兼容性。 -- 由于插件接口都不会因为 Minecraft 源代码更新而被破坏，所以即使版本更新很多东西也不需要跟着修改。比如 Vault 三年前更新的插件到最新版本还可以用。 +- 由于插件接口都不会因为 Minecraft 源代码更新而被破坏，所以即使版本更新，很多东西也不需要跟着修改。比如 Vault 三年前更新的插件到最新版本还可以用。 ## 插件的缺点 - 由于版本 API 的变动，如果插件实现的功能较多，更换一个小版本都很可能导致某些功能失去作用甚至无法正常加载。 - 接触 Minecraft 本身的代码变得困难，而且通常需要考虑多个版本之间的代码变动。 -- 很难直接像模组那样通过 Mixin 直接更改游戏代码，某些必须需要修改源代码才能实现的功能在插件上很难实现。 +- 很难直接像模组那样通过 Mixin 直接更改游戏代码，某些必须修改源代码才能实现的功能在插件上很难实现。 ## 插件可以做的事情 -虽然插件不能像模组那样直接更改游戏源代码，但是依然可以利用游戏本身的内容做出一些超乎寻常的事情 +虽然插件不能像模组那样直接更改游戏源代码，但是依然可以利用游戏本身的内容做出一些超乎寻常的事情。 -这里是一些 `超乎寻常` 的插件 (对新手来说) +这里是一些“超乎寻常”的插件（对新手来说）： -- Slimefun 在插件中实现模组的功能 -- ItemsAdder/Oraxen 自定义方块物品 HUD 家具 (还有更多) -- ModelEngine 自定义生物实体，就像模组 -- MythicMob 创造出像模组一样的技能和生物 +- Slimefun —— 在插件中实现模组的功能。 +- ItemsAdder / Oraxen —— 自定义方块、物品、HUD、家具等（还有更多）。 +- ModelEngine —— 自定义生物实体，就像模组一样。 +- MythicMob —— 创造出像模组一样的技能和生物。 -插件服目前已经可以使用自定义，物品，方块，HUD，家具，Emoij，生物实体，农作物，树叶，Tooltip，附魔... +插件服目前已经可以使用自定义物品、方块、HUD、家具、Emoji、生物实体、农作物、树叶、Tooltip、附魔…… -所以说不要轻易地认为插件在最终效果上不如 mod，很多时候实际上不需要像模组那样修改源代码即可达到相同的效果，不是么？ +所以说，不要轻易地认为插件在最终效果上不如 Mod。很多时候实际上不需要像模组那样修改源代码即可达到相同的效果，不是么？ \ No newline at end of file diff --git a/src/content/docs/general/basics/what-is-startup-script.md b/src/content/docs/general/basics/what-is-startup-script.md index 4361fce1d..12e6a3e74 100644 --- a/src/content/docs/general/basics/what-is-startup-script.md +++ b/src/content/docs/general/basics/what-is-startup-script.md @@ -1,7 +1,6 @@ --- title: 什么是启动脚本？ topic: basics -template: splash --- 启动脚本主要部分就是设置 Java 参数设置。 @@ -13,18 +12,18 @@ _对于 Windows 服务器来说，启动脚本是 `.bat` 后缀的文件，对 L ### sh (Shell Script)(Linux) - 语法：sh 脚本使用 Shell 命令和控制结构，支持条件判断、循环、函数定义等高级编程特性。 -- 执行方式：在终端通过 `./script.sh` 或 `sh script.sh` 来执行 (确保脚本具有执行权限)。 +- 执行方式：在终端通过 `./script.sh` 或 `sh script.sh` 来执行（确保脚本具有执行权限）。 ### bat (Batch File)(Windows) - 语法：bat 脚本包含一系列 DOS 命令和批处理命令，支持简单的条件判断和循环，但相比 sh 脚本，其功能和灵活性较低。 - 执行方式：双击文件或者在命令提示符下输入 `script.bat` 来执行。 -注意：Windows 和 Linux 的启动脚本不能通用，不是改一下后缀名就可以 +注意：Windows 和 Linux 的启动脚本不能通用，不是改一下后缀名就可以。 ## 什么是启动参数 -启动参数 (也称 Flag) 主要分为 3 类： +启动参数（也称 Flag）主要分为 3 类： - 标准参数 (-)：所有的 JVM 实现都必须实现这些参数的功能，而且向后兼容； - 非标准参数 (-X)：默认 JVM 实现这些参数的功能，但是并不保证所有 JVM 实现都满足，且不保证向后兼容； @@ -40,7 +39,7 @@ java -Xms12G -Xmx12G -jar 核心名.jar nogui 作为新手，不用在意大多数参数的作用，你需要做的就是开启服务器。 -**不要忘记改最后的“核心名.jar!** +**不要忘记改最后的“核心名.jar”!** ::: @@ -54,11 +53,11 @@ java -Xms12G -Xmx12G -jar 核心名.jar nogui
--nogui 干了什么 -不显示类似下面的 GUI +不显示类似下面的 GUI： ![](_assets/nogui.jpg) -真的，这个 GUI 一点用没有，别开它了 +真的，这个 GUI 一点用没有，别开它了。
@@ -66,7 +65,7 @@ java -Xms12G -Xmx12G -jar 核心名.jar nogui 1. 无论什么时候，分配内存时一定要多预留 15% 左右内存，如服务器还剩余 10 G 内存，不要将 -Xms 设置到大于 9 G 的内存，否则会很危险。 2. 在 G1GC 模式下，尽量保证 Xmx = Xms 因为如果二者不同 JVM 需要更多的内存时候，JVM 需要申请更多内存，这个过程的耗时会导致顿卡。 -3. 更多的参数讲解，请前往 [JVM 参数优化](/java/advance/optimize/jvm/intro) +3. 更多的参数讲解，请前往 [JVM 参数优化](/java/advance/optimize/jvm/intro)。 ::: diff --git a/src/content/docs/general/basics/what-is-world.md b/src/content/docs/general/basics/what-is-world.md index 88ced073d..a20f21bd1 100644 --- a/src/content/docs/general/basics/what-is-world.md +++ b/src/content/docs/general/basics/what-is-world.md @@ -1,49 +1,48 @@ --- title: 什么是世界？ topic: basics -template: splash --- -Minecraft 的几乎一切行为都是建立在 "世界" 上，而世界中的方块、实体等文件都存储在了根目录的对应文件夹下。 +Minecraft 的几乎一切行为都是建立在“世界”上，而世界中的方块、实体等文件都存储在了根目录的对应文件夹下。 -Minecraft 原版目前有三个世界，分别是主世界 **world** (world)，地狱 **DIM-1** (world_nether)，末地 **DIM1** (world_the_end)。 +Minecraft 原版目前有三个世界，分别是主世界 **world**（world），地狱 **DIM-1**（world_nether），末地 **DIM1**（world_the_end）。 -每个世界的方块都按照 **X** 和 **Z** 每 _16 _ 16* 为区块 (**Chunk**)。其中每 *32 _ 32_ 个区块就会成为一组存储进一个独立的区域文件 (**Region**)。 +每个世界的方块都按照 **X** 和 **Z** 每 16×16 为区块（**Chunk**）。其中每 32×32 个区块就会成为一组存储进一个独立的区域文件（**Region**）。 在这里以主世界为例，说明世界是怎样保存的。 文件夹： -1. **advancements/** ：储存玩家的成就，每个玩家对应一个 **UUID** ； +1. **advancements/**：储存玩家的成就，每个玩家对应一个 **UUID**。 -2. **data/** ：**idcounts.dat** 和 **map_xxx.dat** 储存的是玩家合成的地图有关的数据。 +2. **data/**：**idcounts.dat** 和 **map_xxx.dat** 储存的是玩家合成的地图有关的数据。 -3. **datapacks/** ：储存世界所使用的数据包 (一般 Bukkit 系服务器有一个 Bukkit 文件夹)； +3. **datapacks/**：储存世界所使用的数据包（一般 Bukkit 系服务器有一个 Bukkit 文件夹）。 -4. **entities/** ：储存对应 **region** 中的实体； +4. **entities/**：储存对应 **region** 中的实体。 -5. **playerdata/** ：储存着玩家的数据信息 (如血量、经验值等)； +5. **playerdata/**：储存着玩家的数据信息（如血量、经验值等）。 -6. **poi/** ：存储世界中村民的兴趣点 (如床、工作方块)。(只在 1.14 + 版本中使用) +6. **poi/**：存储世界中村民的兴趣点（如床、工作方块）（只在 1.14+ 版本中使用）。 -7. **region/** ：储存方块信息。 +7. **region/**：储存方块信息。 -8. **stats/** ：储存玩家在此世界游玩时的统计信息 (如击杀了 xx 只鸡、使用了 xx 次工作台)。 +8. **stats/**：储存玩家在此世界游玩时的统计信息（如击杀了 xx 只鸡、使用了 xx 次工作台）。 -9. **如果还有其他文件夹一般为插件储存用的文件夹，如 `itemsadder` 文件夹是插件 `ItemsAdders` 创建的用于保存世界中自定义物品的文件夹** +9. 如果还有其他文件夹，一般为插件储存用的文件夹，如 `itemsadder` 文件夹是插件 `ItemsAdder` 创建的用于保存世界中自定义物品的文件夹。 文件： -1. **level.dat** ：储存该世界的全局信息 (如种子、是否生成结构、世界类型、世界重生点等)。 +1. **level.dat**：储存该世界的全局信息（如种子、是否生成结构、世界类型、世界重生点等）。 -2. **level.dat_old** ：可以视为 level.dat 的备份文件 +2. **level.dat_old**：可以视为 level.dat 的备份文件。 -3. **session.lock** ：用于储存最后执行的程序修改这一文件以及访问的权限。 +3. **session.lock**：用于储存最后执行的程序修改这一文件以及访问的权限。 -4. **/data/raids_end.dat** ：储存世界内正在进行的袭击的信息。 +4. **/data/raids_end.dat**：储存世界内正在进行的袭击的信息。 -5. **/data/random_sequences.dat** ：存储战利品表使用的随机序列数据。 +5. **/data/random_sequences.dat**：存储战利品表使用的随机序列数据。 -6. **paper-world.yml**(只存在于 **Paper** 服务器中)：记录世界特有的 **Paper** 设置 +6. **paper-world.yml**（只存在于 **Paper** 服务器中）：记录世界特有的 **Paper** 设置。 -其他世界的文件夹大同小异。 +其他世界的文件夹大同小异。 \ No newline at end of file diff --git a/src/content/docs/general/java/choose-and-download-and-install-java.md b/src/content/docs/general/java/choose-and-download-and-install-java.md index 9bb77da77..ebdb8393b 100644 --- a/src/content/docs/general/java/choose-and-download-and-install-java.md +++ b/src/content/docs/general/java/choose-and-download-and-install-java.md @@ -4,7 +4,7 @@ title: 选择、下载和安装 Java :::caution -部分服务端有在项目的 README 中标注最低版本和推荐版本，例如 [Beast](https://github.com/HomoMC/Beast)，最低版本为 Java 8，推荐版本为 Java 21 mod 服务端 +部分服务端有在项目的 README 中标注最低版本和推荐版本，例如 [Beast](https://github.com/HomoMC/Beast)，最低版本为 Java 8，推荐版本为 Java 21 mod 服务端。 ::: @@ -50,7 +50,7 @@ title: 选择、下载和安装 Java :::caution -此处下载链接可能不是最新版，如需下载最新版请跳转至 [手动下载](#手动下载) +此处下载链接可能不是最新版，如需下载最新版请跳转至 [手动下载](#手动下载)。 ::: @@ -80,14 +80,14 @@ title: 选择、下载和安装 Java ## 下载镜像 -[InJDK](https://d10.injdk.cn/openjdk/) 各种 JDK 的下载镜像 +[InJDK](https://d10.injdk.cn/openjdk/) 各种 JDK 的下载镜像。 ## Oracle 版 官方版本
- 怎么找到官网并从官网下载 + 怎么找到官网并从官网下载： ![](_assets/Oracle-1.png) ![](_assets/Oracle-2.png) @@ -126,7 +126,7 @@ java -version ![](_assets/cmd-2.png) -> 返回类似的消息即为 Java 已安装 +> 返回类似的消息即为 Java 已安装。 ## 使用 AJI 静默安装 Java @@ -136,8 +136,8 @@ java -version 食用方式： 1. 打开此链接下载 AJI: https://github.com/Lafcadia/AJI/releases/download/v0.0.2/main.exe -2. 下好了，右键选择以管理员权限打开 (如果不以管理员权限打开就无法绑定 Java 环境变量，虽然不给管理员权限程序也能正常运行，并安装 - Java，但可能会在后续阶段出现问题) +2. 下好了，右键选择以管理员权限打开（如果不以管理员权限打开就无法绑定 Java 环境变量，虽然不给管理员权限程序也能正常运行，并安装 + Java，但可能会在后续阶段出现问题） 3. ![示意图](https://github.com/user-attachments/assets/28035c47-d34b-4b38-b895-29f38366bef9) 4. 选择合适的版本的 Java，点击 `Install Java`，下载。 5. 不要关闭窗口，直到下方的提示栏从 `Installing...` 变为 `Complete.` @@ -146,4 +146,4 @@ java -version ## 本节视频教程 -[**点此前往 B 站**: 笨蛋级 MC 开服教程 - 第三集 P1:实机演示安装 Java](https://www.bilibili.com/video/BV1eT42167iZ/) +[**点此前往 B 站**: 笨蛋级 MC 开服教程 - 第三集 P1:实机演示安装 Java](https://www.bilibili.com/video/BV1eT42167iZ/)。 \ No newline at end of file diff --git a/src/content/docs/general/java/environment.mdx b/src/content/docs/general/java/environment.mdx index a7233bcd2..b30f299b2 100644 --- a/src/content/docs/general/java/environment.mdx +++ b/src/content/docs/general/java/environment.mdx @@ -10,7 +10,7 @@ title: 环境变量 在此处，`java` 等同于 `"C:\Program Files\Zulu\zulu-21\bin\java.exe"` -当你使用安装包安装 Java 时，通常会自动配置环境变量 +当你使用安装包安装 Java 时，通常会自动配置环境变量。 如果不是使用安装包安装，即没有配置环境变量，你应该会遇到这个情况： diff --git a/src/content/docs/general/java/faq.md b/src/content/docs/general/java/faq.md index f593f3fe7..ccdc1d5c9 100644 --- a/src/content/docs/general/java/faq.md +++ b/src/content/docs/general/java/faq.md @@ -5,8 +5,8 @@ title: FAQ ## 为什么 .jar 文件的图标是个白纸 1. 服务器根本没有安装 JRE 或者 JDK。 -2. 服务器上的 Java 未设置环境变量 (其实这个影响不大)。 -3. 没有绑定文件打开方式 (不过其实也没啥必要绑)。 +2. 服务器上的 Java 未设置环境变量（其实这个影响不大）。 +3. 没有绑定文件打开方式（不过其实也没啥必要绑）。 ## 怎么制作绿色版 Java & 绿色版怎么使用 @@ -17,4 +17,4 @@ title: FAQ ## cmd 键入 java 没反应 首先检查环境变量上面是否有个 `C:\Program Files\Common Files\Oracle\Java\javapath` 存在，如果有删掉即可，或者把 Java -环境变量移到第一个也可以 +环境变量移到第一个也可以。 diff --git a/src/content/docs/general/java/intro.md b/src/content/docs/general/java/intro.md index 8a63b208c..2320ef2d4 100644 --- a/src/content/docs/general/java/intro.md +++ b/src/content/docs/general/java/intro.md @@ -10,17 +10,17 @@ sidebar: ## JRE 和 JDK 是什么？我该怎么选择？ -**JRE** (Java Runtime Environment) 是 Java 的运行环境。面向 Java 程序的使用者，而不是开发者。如果你仅下载并安装了 JRE，那么你的系统只能运行 Java 程序。 +**JRE**（Java Runtime Environment）是 Java 的运行环境，面向 Java 程序的使用者而不是开发者。如果你仅下载并安装了 JRE，那么你的系统只能运行 Java 程序。 -JRE 是运行 Java 程序所必须环境的集合，包含 JVM 标准实现及 Java 核心类库。它包括 Java 虚拟机、Java 平台核心类和支持文件。它不包含开发工具（编译器、调试器等）。 +JRE 是运行 Java 程序所必须环境的集合，包含 JVM 标准实现及 Java 核心类库。它包括 Java 虚拟机、Java 平台核心类和支持文件，不包含开发工具（编译器、调试器等）。 -**JDK** (Java Development Kit) 又称 J2SDK (Java2 Software Development Kit)，是 Java 开发工具包，它提供了 Java 的开发环境（提供了编译器 javac 等工具，用于将 java 文件编译为 class 文件）和运行环境（提供了 JVM 和 Runtime 辅助包，用于解析 class 文件使其得到运行）。 +**JDK**（Java Development Kit）又称 J2SDK（Java2 Software Development Kit），是 Java 开发工具包。它提供了 Java 的开发环境（提供了编译器 javac 等工具，用于将 java 文件编译为 class 文件）和运行环境（提供了 JVM 和 Runtime 辅助包，用于解析 class 文件使其得到运行）。 如果你下载并安装了 JDK，那么你不仅可以开发 Java 程序，也同时拥有了运行 Java 程序的平台。JDK 是整个 Java 的核心，包括了 Java 运行环境（JRE）、一堆 Java 工具 tools.jar 和 Java 标准类库 rt.jar。 ### 总结 -**开服最好选择 JDK**，这样不会因为一些插件/mod 使用类似 ByteBuddy 等黑魔法导致报错，也可以轻松使用 Arthas 等分析工具。 +**开服最好选择 JDK**，这样不会因为一些插件 / Mod 使用类似 ByteBuddy 等“黑魔法”导致报错，也可以轻松使用 Arthas 等分析工具。 毕竟，现在谁还缺几十 MB 的存储空间，~~真缺那就别开服了~~。 @@ -28,4 +28,4 @@ JRE 是运行 Java 程序所必须环境的集合，包含 JVM 标准实现及 J 对于初学者，只需要阅读 [选择、下载和安装 Java](/general/java/choose-and-download-and-install-java) 部分，其余为扩展知识。 -![](_assets/lava.jpg) +![](_assets/lava.jpg) \ No newline at end of file diff --git a/src/content/docs/general/more/ask-for-help.md b/src/content/docs/general/more/ask-for-help.md index 6f5e47a8c..1a94a68d3 100644 --- a/src/content/docs/general/more/ask-for-help.md +++ b/src/content/docs/general/more/ask-for-help.md @@ -13,7 +13,7 @@ sidebar_position: 7 :::tip -我们 **非常推荐** 你阅读 [《提问的智慧》](https://github.com/ryanhanwu/How-To-Ask-Questions-The-Smart-Way/blob/main/README-zh_CN.md) +我们 **非常推荐** 你阅读 [《提问的智慧》](https://github.com/ryanhanwu/How-To-Ask-Questions-The-Smart-Way/blob/main/README-zh_CN.md)。 ::: @@ -27,11 +27,11 @@ sidebar_position: 7 **`什么是 Amethyst ？插件的 Wiki 在哪里？`** -- **不要把群和人当做搜索引擎** (除非打钱了)。 +- **不要把群和人当做搜索引擎**（除非打钱了）。 **`我玩家进不来服务器怎么办`** -- **描述模糊**，可能性太多以至于没有人猜出。 +- **描述模糊**，可能性太多以至于没有人能猜出。 **`不正确提供 log 或不提供 log`** @@ -43,7 +43,7 @@ sidebar_position: 7 - 在 **服务器** 问题中提供 **客户端** log。 - **不完整** 的 log，甚至 **不提供** log。 - 错误的将 **客户端** 收到的报错当做 **服务端** 报错。 -- **直接将成百上千行的 log 发到交流群** +- **直接将成百上千行的 log 发到交流群**。 :::caution @@ -57,9 +57,9 @@ sidebar_position: 7 为避免无效问题，问问题最好需要符合以下几个基础原则： -1. 先查 Wiki 或搜索 - [详细说明](#看完-wiki-再问) +1. 先查 Wiki 或搜索 —— [详细说明](#看完-wiki-再问)。 -2. 礼貌用语 +2. 礼貌用语。 例如，你应该： @@ -68,40 +68,40 @@ sidebar_position: 7 而不能： -- 开门见山：`服务器报错是这个 C++ Exception: std::optional 是啥情况` -- 发言不友好：`你不知道可以不说话，别在这浪费我时间` -- 斥责他人：`你是不是不会写插件啊，这插件怎么能开服就报错呢` +- 开门见山：`服务器报错是这个 C++ Exception: std::optional 是啥情况？` +- 发言不友好：`你不知道可以不说话，别在这浪费我时间。` +- 斥责他人：`你是不是不会写插件啊，这插件怎么能开服就报错呢？` -3. 明确遇到的问题，到 **对应群** 里问 +3. 明确遇到的问题，到 **对应群** 里问。 例如，你应该： -- 某插件出现不适配问题后在名为“我的世界服主交流群”的开服综合交流群里提问 `请问在升级 Paper1.20.4 之后遇到 xxx 插件不适配应该怎么办？` -- 某小众插件与 Leaves 核心出现兼容性问题后在该插件官方交流群里提问 `作者大大，你的 xxx 插件和 leaves 核心是不是有兼容性问题呢？` +- 某插件出现不适配问题后在名为“我的世界服主交流群”的开服综合交流群里提问：`请问在升级 Paper1.20.4 之后遇到 xxx 插件不适配应该怎么办？` +- 某小众插件与 Leaves 核心出现兼容性问题后，在该插件官方交流群里提问：`作者大大，你的 xxx 插件和 leaves 核心是不是有兼容性问题呢？` 而不能： -- PowerNukkitX 核心相关问题到 LeviLemina 交流群里提问 -- 路由器配置相关问题到某插件官方交流群里提问 -- 卡服问题到其他游戏交流群里提问 +- PowerNukkitX 核心相关问题到 LeviLamina 交流群里提问。 +- 路由器配置相关问题到某插件官方交流群里提问。 +- 卡服问题到其他游戏交流群里提问。 -4. 提到服务器环境 +4. 提到服务器环境。 例如，你应该： -- `大佬们我是 1.16.5 catserver 服务器，遇到了 xxx 问题` -- `最近我升级到了 1.21 Paper 核心，玩家反应 xxx 有人有类似的问题吗？` +- `大佬们，我是 1.16.5 Catserver 服务器，遇到了 xxx 问题。` +- `最近我升级到了 1.21 Paper 核心，玩家反应 xxx，有人有类似的问题吗？` 而不能： - 仅给出插件名和报错却不给出服务端版本等信息：`大佬们有没有人知道我这个 xxx 插件怎么加载不了，报错 NoClassDefFoundError？` -- 仅附上报错信息却没有给出任何服务端版本、加载器版本、插件列表等信息：`有没有大佬能帮我看看这个崩服是为什么，什么也不干跑一跑图就崩，ll加载器` +- 仅附上报错信息却没有给出任何服务端版本、加载器版本、插件列表等信息：`有没有大佬能帮我看看这个崩服是为什么，什么也不干跑一跑图就崩，ll 加载器？` -5. 给出合理的日志 - [详细说明](#给出日志) +5. 给出合理的日志 —— [详细说明](#给出日志)。 - + ### 看完 Wiki 再问 @@ -109,11 +109,11 @@ Wiki 就是让你解决常见问题的，不看这玩意儿就在那瞎问只会 几乎所有的软件都会附上 Wiki，它们一般位于： -- 插件的 README 文件 (GitHub 主页往下翻一般就是) -- 插件作者在社交媒体发布的视频文章等或自行搭建的网站 (入口一般可以在插件的论坛介绍页、官网、README 中找到) -- 插件作者在即时通讯软件上发布的视频文章等 (比如有的插件作者会让你加他的 QQ 群，之后把使用文档放在群文件或群公告里) +- 插件的 README 文件（GitHub 主页往下翻一般就是）。 +- 插件作者在社交媒体发布的视频文章等或自行搭建的网站（入口一般可以在插件的论坛介绍页、官网、README 中找到）。 +- 插件作者在即时通讯软件上发布的视频文章等（比如有的插件作者会让你加他的 QQ 群，之后把使用文档放在群文件或群公告里）。 -**请先耐心寻找这些文档**，实在找不到说明作者可能确实没有写，这种情况下再提问 +**请先耐心寻找这些文档**，实在找不到说明作者可能确实没有写，这种情况下再提问。 此外，Wiki 中一般会有搜索功能。如果 Wiki 中的内容非常多，对于你来说是很难找到自己想要的信息的。好在多数 Wiki 网站中都有搜索功能。你可以在页面中找到搜索框，然后在其中输入关键词即可。 @@ -123,9 +123,9 @@ Wiki 就是让你解决常见问题的，不看这玩意儿就在那瞎问只会 对于不是网站形式的 Wiki 来说，也有许多种办法来搜索： -#### docx (Word 文档) +#### docx（Word 文档） -按下 `Ctrl + F` (Windows) 或 `Command + F` (macOS) 即可启动 Microsoft Word 或 WPS 的搜索功能，搜索当前文档。 +按下 `Ctrl + F`（Windows）或 `Command + F`（macOS）即可启动 Microsoft Word 或 WPS 的搜索功能，搜索当前文档。 #### txt @@ -137,12 +137,11 @@ Wiki 就是让你解决常见问题的，不看这玩意儿就在那瞎问只会 #### 笨蛋脚本 -使用此 [脚本](https://script.8aka.org/update-log)， -会将日志自动上传到 `https://mclo.gs` (默认上传的日志是 `logs/latest.log`) +使用此 [脚本](https://script.8aka.org/update-log)，会将日志自动上传到 `https://mclo.gs`（默认上传的日志是 `logs/latest.log`）。 #### 如何上传 -当你询问问题的时候，发出你的报错日志 +当你询问问题的时候，发出你的报错日志。 :::tip @@ -150,47 +149,47 @@ Wiki 就是让你解决常见问题的，不看这玩意儿就在那瞎问只会 ::: -你需要明白你面对的是群友而不是道友，没有人可以在没有日志的情况下帮你解决问题， +你需要明白你面对的是群友而不是道友，没有人可以在没有日志的情况下帮你解决问题。 -如果你遇到的是大佬还可以给你算一卦。 +如果你遇到的是大佬，还可以给你算一卦。
- 如何使用 8aka Mclogs + 如何使用 8aka Mclogs > https://log.8aka.org ![](_assets/屏幕截图%202025-02-07%20182759.png) -服务器 log 文件在服务端根目录的 logs 文件夹，一般上传 `latest.log` (服务端最新的日志) 即可 +服务器 log 文件在服务端根目录的 logs 文件夹，一般上传 `latest.log`（服务端最新的日志）即可。 ![](_assets/屏幕截图%202025-02-07%20182930.png) -把这个链接复制粘贴发给大佬 +把这个链接复制粘贴发给大佬。
- 如何使用 Mclogs + 如何使用 Mclogs ![](\_assets/问问题的技巧/如何使用 Mclogs-1.png) -服务器 log 文件在服务端根目录的 logs 文件夹，一般上传 `latest.log` (服务端最新的日志) 即可 +服务器 log 文件在服务端根目录的 logs 文件夹，一般上传 `latest.log`（服务端最新的日志）即可。 ![](\_assets/问问题的技巧/如何使用 Mclogs-2.png) -把这个链接复制粘贴发给大佬 +把这个链接复制粘贴发给大佬。 :::tip ![](_assets/qnmd_raw.png) -不要点右上角的 Raw 进行分享，那是 API 接口链接，给开发人员提供的，不是分享链接的，不能用于分享日志使用 +不要点右上角的 Raw 进行分享，那是 API 接口链接，给开发人员提供的，不是分享链接，不能用于分享日志使用。 :::
-其他的贴 log 的网站 +其他的贴 log 的网站：
其他可用的网站 @@ -216,11 +215,11 @@ Wiki 就是让你解决常见问题的，不看这玩意儿就在那瞎问只会 :::caution -不遵守以上规则，可能会导致你被写入 **乐子文档** +不遵守以上规则，可能会导致你被写入 **乐子文档**。 ::: -**经典如何提问：https://settingdust.gitbook.io/stop-ask-questions-the-stupid-ways/** +**经典如何提问：** ### 经典老图 @@ -230,4 +229,4 @@ Wiki 就是让你解决常见问题的，不看这玩意儿就在那瞎问只会 ![](_assets/问问题的技巧/经典老图-3.jpg) -![](_assets/问问题的技巧/没事不要免费帮人.jpg) +![](_assets/问问题的技巧/没事不要免费帮人.jpg) \ No newline at end of file diff --git a/src/content/docs/general/preparation/text-editor/intro.md b/src/content/docs/general/preparation/text-editor/intro.md index d1f001355..4993c85da 100644 --- a/src/content/docs/general/preparation/text-editor/intro.md +++ b/src/content/docs/general/preparation/text-editor/intro.md @@ -12,8 +12,8 @@ sidebar: 请不要再使用 Windows 自带的记事本和写字板了。这些文本编辑器通常有以下问题： -1. 可能造成文件编码发生改变。小白操作时尤其容易出现，部分情况下用记事本和写字板保存文件后文件因编码改变等问题而无法服务器读取。 -2. 无法察觉到格式错误。有时编辑文件时会因为不小心删除或添加了些符号，导致配置文件语法错误，服务器无法识别。本文介绍的文本编辑器均能识别出这些格式错误并做出提示和警告，然而记事本和写字板却不具备这些功能。 +1. 可能造成文件编码发生改变。小白操作时尤其容易出现，部分情况下用记事本和写字板保存文件后，文件因编码改变等问题而无法被服务器读取。 +2. 无法察觉到格式错误。有时编辑文件时会因为不小心删除或添加了一些符号，导致配置文件语法错误，服务器无法识别。 3. 无法准确地辨认缩进等格式。这些文本编辑器由于默认不使用 [等宽字体](https://baike.baidu.com/item/%E7%AD%89%E5%AE%BD%E5%AD%97%E4%BD%93/8434037) 显示文字，导致其显示效果与原格式存在差异。 4. 没有语法高亮功能。在编辑配置文件时，语法高亮功能可以让你高效快速地找到指定配置项和值。它让配置文件更易于阅读，整体上提高了在服务器上进行操作的效率。本文介绍的文本编辑器均能识别出这些格式错误并做出提示和警告，然而记事本和写字板却不具备这些功能。 @@ -21,4 +21,4 @@ sidebar: 出于多方面原因，不推荐使用 GitHub 官方出品的 Atom，它已在 2022 年 12 月由于安全原因宣布停止维护。 -接下来介绍几个常用的文本编辑器，供大家选择。 +接下来介绍几个常用的文本编辑器，供大家选择。 \ No newline at end of file diff --git a/src/content/docs/general/preparation/text-editor/vscode.md b/src/content/docs/general/preparation/text-editor/vscode.md index c3716f890..db935e274 100644 --- a/src/content/docs/general/preparation/text-editor/vscode.md +++ b/src/content/docs/general/preparation/text-editor/vscode.md @@ -22,9 +22,9 @@ VS Code 会在未保存的文件后标记一个白点，提示你这个文件编 ![](_assets/vscode保存和自动保存.png) -保存按钮 (红色箭头)，也可以用快捷键来保存 `Ctrl + S`。 +保存按钮（红色箭头），也可以用快捷键来保存 `Ctrl + S`。 -开启自动保存 (绿色箭头)。 +开启自动保存（绿色箭头）。 ~~当年 TrMenu 的自动重载治好了我的 autosave~~ diff --git a/src/content/docs/general/process/database/backup.md b/src/content/docs/general/process/database/backup.md index 4054ba9e1..2d642a82f 100644 --- a/src/content/docs/general/process/database/backup.md +++ b/src/content/docs/general/process/database/backup.md @@ -46,15 +46,15 @@ mysql -u root -p mydb < mydb_backup.sql ## 使用 Navicat 备份 -展开你想要备份的数据库，点击备份，再点击新建备份 +展开你想要备份的数据库，点击备份，再点击新建备份： ![](_assets/35.png) -然后点击备份即可开始备份 +然后点击备份即可开始备份。 ![](_assets/36.png) -中间的命令行提示这一条的时候备份即已完成 +中间的命令行提示这一条的时候备份即已完成。 ![](_assets/37.png) @@ -62,43 +62,43 @@ mysql -u root -p mydb < mydb_backup.sql 当然可以！ -右键你的连接，点击编辑连接 +右键你的连接，点击编辑连接： ![](_assets/38.png) -点击数据库，修改这里的设置位置即可让 Navicat 将你的数据库备份到你想要到的地方了 +点击数据库，修改这里的设置位置即可让 Navicat 将你的数据库备份到你想要到的地方了。 ![](_assets/39.png) **如何使用备份？** -右键你想要使用的备份，然后点击还原备份 +右键你想要使用的备份，然后点击还原备份： ![](_assets/40.png) -然后在弹出的界面中点击还原，当命令行出现这句话的时候，数据库就还原成功了 +然后在弹出的界面中点击还原，当命令行出现这句话的时候，数据库就还原成功了。 ![](_assets/41.png) **对于数据量非常大的数据库，备份起来很慢，还容易出错，怎么办？** -遇到这种情况，不用慌张，我们这个时候转储 SQL 文件即可 +遇到这种情况，不用慌张，我们这个时候转储 SQL 文件即可。 -转储 SQL 文件，能够极大降低还原备份时出错、数据缺失的问题 +转储 SQL 文件，能够极大降低还原备份时出错、数据缺失的问题。 -我们右键想要转储为 SQL 文件的数据库，点击转储 SQL 文件，点击结构和数据 +我们右键想要转储为 SQL 文件的数据库，点击转储 SQL 文件，点击结构和数据： ![](_assets/42.png) -之后我们选择一下 SQL 文件的转出位置 +之后我们选择一下 SQL 文件的转出位置， -当命令行出现这句话的时候，即已完成转储 +当命令行出现这句话的时候，即已完成转储。 -之后当我们需要使用备份的时候，我们再次右键那个数据库，点击运行 SQL 文件 +之后当我们需要使用备份的时候，我们再次右键那个数据库，点击运行 SQL 文件： ![](_assets/44.png) -然后找到你之前转储的后缀为 `.sql` 的文件，选中并确定后点击开始。当命令行出现这句话的时候，数据库就还原成功了 +然后找到你之前转储的后缀为 `.sql` 的文件，选中并确定后点击开始。当命令行出现这句话的时候，数据库就还原成功了。 ![](_assets/45.png) @@ -122,7 +122,7 @@ TODO ### 进阶教程：新增备份账号 -> 什么是备份账号？简单来讲，备份账号是 1Panel 面板中不同的存储位置，即 **将备份存储在哪里** +> 什么是备份账号？简单来讲，备份账号是 1Panel 面板中不同的存储位置，即 **将备份存储在哪里**。 TODO @@ -132,23 +132,23 @@ TODO ![](_assets/31.png) -点击自动运行，然后点击新建批处理作业 +点击自动运行，然后点击新建批处理作业： ![](_assets/32.png) -之后分别点击：备份 - 需要备份的数据库名字 - backup 数据库名 +之后分别点击：备份 - 需要备份的数据库名字 - backup 数据库名： 即可添加备份任务 ![](_assets/33.png) -完成这些步骤后点击保存，设置完任务名称后点击设置计划任务 +完成这些步骤后点击保存，设置完任务名称后点击设置计划任务： ![](_assets/34.png) -点击触发器，新建触发器，然后自行设置备份任务时间 +点击触发器，新建触发器，然后自行设置备份任务时间， -最后保存计划任务就大功告成啦 +最后保存计划任务就大功告成啦。 ## 使用 1Panel 面板自动备份 diff --git a/src/content/docs/general/process/database/configure.md b/src/content/docs/general/process/database/configure.md index 5683ec9c0..994a290eb 100644 --- a/src/content/docs/general/process/database/configure.md +++ b/src/content/docs/general/process/database/configure.md @@ -6,9 +6,9 @@ sidebar: ## MySQL -MySQL 的配置文件在 Windows 中，是 `my.ini` ，默认在 `C:\Program Files\MySQL\MySQL Server X.X` 文件夹中 +MySQL 的配置文件在 Windows 中，是 `my.ini`，默认在 `C:\Program Files\MySQL\MySQL Server X.X` 文件夹中。 -而 Linux 中，是 `my.cnf` ，默认路径为 `/etc/my.cnf` +而 Linux 中，是 `my.cnf`，默认路径为 `/etc/my.cnf`。
示例配置文件 @@ -230,15 +230,15 @@ innodb_lock_wait_timeout = 120 :::caution -绝对不要直接把示例配置文件直接复制粘贴进你的配置文件当中 +绝对不要直接把示例配置文件直接复制粘贴进你的配置文件当中， -否则有可能会导致数据库无法启动 +否则有可能会导致数据库无法启动。 -正确的做法是看完注释之后根据自己的需要，自行去修改配置文件，然后重启或重载 MySQL 服务 +正确的做法是看完注释之后根据自己的需要，自行去修改配置文件，然后重启或重载 MySQL 服务。 ::: -此外，还有一些十分重要的配置项，建议修改，没有的配置项可以自行在配置文件中添加 +此外，还有一些十分重要的配置项，建议修改，没有的配置项可以自行在配置文件中添加。 :::note diff --git a/src/content/docs/general/process/database/install.md b/src/content/docs/general/process/database/install.md index 4d5c011cb..860d03489 100644 --- a/src/content/docs/general/process/database/install.md +++ b/src/content/docs/general/process/database/install.md @@ -6,7 +6,7 @@ sidebar: ## Windows 直接安装 -你可以选择直接下载安装包来安装，如果觉得麻烦，请看下面的 **使用工具安装** 或 **Linux 命令行安装** +你可以选择直接下载安装包来安装，如果觉得麻烦，请看下面的 **使用工具安装** 或 **Linux 命令行安装**。 :::tip @@ -16,15 +16,15 @@ sidebar: ::: -对于 Windows 用户，请下载 `.msi` 或 `zip` 的包，其中 `.msi` 是安装包，`.zip` 是绿色版，推荐下载 `.msi` 版本来安装 +对于 Windows 用户，请下载 `.msi` 或 `zip` 的包，其中 `.msi` 是安装包，`.zip` 是绿色版，推荐下载 `.msi` 版本来安装。 对于 MySQL 安装，请看这篇文章：[2024 年 MySQL 8.0 安装 配置 教程 最简易 (保姆级)](https://blog.csdn.net/m0_52559040/article/details/121843945) -在下载的时候请务必注意自己的系统、架构等是否与安装包上标的匹配 +在下载的时候请务必注意自己的系统、架构等是否与安装包上标的匹配！ ## Linux 命令行安装 -本部分讲解在命令行中安装常见数据库的方式。本教程以 Ubuntu 24.04 系统为例 +本部分讲解在命令行中安装常见数据库的方式。本教程以 Ubuntu 24.04 系统为例。 ### MySQL @@ -77,7 +77,7 @@ systemctl enable mysql mysql -uroot -p ``` -按提示输入密码登录到 MySQL +按提示输入密码登录到 MySQL： ![](_assets/linux/database/4.png) @@ -87,7 +87,7 @@ mysql -uroot -p ALTER user 'root'@'localhost' IDENTIFIED BY 'NewPassword'; ``` -将 NewPassword 修改为你自己设置的密码 +将 NewPassword 修改为你自己设置的密码。 **至此，MySQL 安装已经完成。** @@ -103,7 +103,7 @@ ALTER user 'root'@'localhost' IDENTIFIED BY 'NewPassword'; CREATE DATABASE IF NOT EXISTS XXX DEFAULT CHARACTER SET utf8mb4; ``` -这里的 XXX 可以选择是你要使用数据库的插件名称也可以是自定义字符 +这里的 XXX 可以选择是你要使用数据库的插件名称也可以是自定义字符。 #### 创建用户 @@ -123,9 +123,9 @@ UserName 填写用户名， `%` 代表所有 IP 地址，如果 Minecraft 服务端和数据库处于同一个服务器，建议改成 localhost 以增加安全性， -Password 填写用户的密码 (由于安全性设置，密码必须有大小写长度 8 位以上，并且默认关闭远程访问) +Password 填写用户的密码（由于安全性设置，密码必须有大小写长度 8 位以上，并且默认关闭远程访问） -如果需要设置密码强度为低，开启远程访问等不安全的操作请自行百度，对于修改安全设置之后的数据库安全问题，本站概不负责 +如果需要设置密码强度为低，开启远程访问等不安全的操作请自行百度，对于修改安全设置之后的数据库安全问题，本站概不负责。 ::: @@ -141,17 +141,17 @@ apt update apt install redis -y ``` -安装完成后输入 `systemctl start redis-server` +安装完成后输入 `systemctl start redis-server`。 ![](_assets/linux/database/5.png) -至此安装完成，输入 `redis-cli` 即可进入命令行管理 +至此安装完成，输入 `redis-cli` 即可进入命令行管理。 ![](_assets/linux/database/6.png) :::tip -使用 `systemctl enable redis-server` 使 Redis 开机自启 +使用 `systemctl enable redis-server` 使 Redis 开机自启。 ![](_assets/linux/database/7.png) @@ -159,13 +159,13 @@ apt install redis -y ## 使用工具安装 -我会告诉你 **我认为** 最简单的几种安装数据库的方法 +我会告诉你 **我认为** 最简单的几种安装数据库的方法。 ### 小皮数据库 :::note -小皮数据库仅支持 Windows 系统 +小皮数据库仅支持 Windows 系统。 ::: @@ -189,7 +189,7 @@ apt install redis -y
卸载 MySQL5 和安装 MySQL8 -MySQL5 版本太低了，很多插件需要更高版本的，装 MySQL8 就够用了 +MySQL5 版本太低了，很多插件需要更高版本的，装 MySQL8 就够用了。 ![](_assets/7.png) @@ -200,7 +200,7 @@ MySQL5 版本太低了，很多插件需要更高版本的，装 MySQL8 就够
初次启动 -安装好后在首页启动 MySQL +安装好后在首页启动 MySQL： ![](_assets/9.png) @@ -220,7 +220,7 @@ MySQL5 版本太低了，很多插件需要更高版本的，装 MySQL8 就够 ![](_assets/11.png) -然后你就可以建数据库了，建好之后把你填这里的信息填到插件的配置文件里 +然后你就可以建数据库了，建好之后把你填这里的信息填到插件的配置文件里。
@@ -228,7 +228,7 @@ MySQL5 版本太低了，很多插件需要更高版本的，装 MySQL8 就够 :::note -宝塔面板支持 Windows 和 Linux 系统 +宝塔面板支持 Windows 和 Linux 系统。 ::: @@ -251,13 +251,13 @@ MySQL5 版本太低了，很多插件需要更高版本的，装 MySQL8 就够 ![](_assets/19.png) -宝塔面板是必须要绑定账号的 +宝塔面板是必须要绑定账号的。 -按照提示去做 +按照提示去做： ![](_assets/20.png) -全 x 掉，一个都不需要装 +全 x 掉，一个都不需要装。 ![](_assets/21.png) @@ -278,7 +278,7 @@ MySQL5 版本太低了，很多插件需要更高版本的，装 MySQL8 就够 :::caution -1Panel 面板目前仅支持 Linux 系统，不支持 Windows 系统 +1Panel 面板目前仅支持 Linux 系统，不支持 Windows 系统。 ::: diff --git a/src/content/docs/general/process/database/intro.md b/src/content/docs/general/process/database/intro.md index beebb5d33..0eddb5c2c 100644 --- a/src/content/docs/general/process/database/intro.md +++ b/src/content/docs/general/process/database/intro.md @@ -16,7 +16,7 @@ sidebar: 1. 数据库的备份维护等所占用的时间远比将整个服务器停止后打包压缩备份快得多; -2. 同样的数据量，MySQL 比 YAML/txt/SQLite 等占用也小得多。特别是对于数据量大的插件 (30 GB 的 dynmap 文件使用 MySQL 后整个数据库将压缩到 15 GB); +2. 同样的数据量，MySQL 比 YAML/txt/SQLite 等占用也小得多。特别是对于数据量大的插件（30 GB 的 dynmap 文件使用 MySQL 后整个数据库将压缩到 15 GB）; 3. 读取速度快，某些插件使用 YAML 储存数据时启动一个插件甚至需要 10 s 以上，换用 MySQL 后服务器启动速度变快; diff --git a/src/content/docs/general/process/database/uninstall.md b/src/content/docs/general/process/database/uninstall.md index a1167b1a0..bc782fabd 100644 --- a/src/content/docs/general/process/database/uninstall.md +++ b/src/content/docs/general/process/database/uninstall.md @@ -4,7 +4,7 @@ sidebar: order: 6 --- -当你乱捣鼓一通，然后给你数据库整炸了，还不会修，那除了花钱请大佬最好的办法就是删掉重新安装 +当你乱捣鼓一通，然后给数据库整炸了，你还不会修，那除了花钱请大佬最好的办法就是删掉重新安装。 ## 宝塔面板 @@ -20,30 +20,30 @@ TODO ## Windows 平台 -首先，通过 PHPStudy 的控制面板，找到 MySQL 服务，并点击“暂停”按钮 +首先，通过 PHPStudy 的控制面板，找到 MySQL 服务，并点击“暂停”按钮。 -之后，找到 PHPStudy 的安装目录，找到 MySQL 的安装文件夹 +之后，找到 PHPStudy 的安装目录，找到 MySQL 的安装文件夹。 -注：通常命名为：MySQL 或者 mysqlXX（XX 为版本号） +注：通常命名为：MySQL 或者 mysqlXX（XX 为版本号）。 -然后直接删除这个文件夹 +然后直接删除这个文件夹。 -接下来，我们需要清理配置（清理方式可选择手动注释或者删除）文件（位于安装目录的 conf 文件夹下，数据库的配置文件名称为 mysql.conf） +接下来，我们需要清理配置（清理方式可选择手动注释或者删除）文件（位于安装目录的 conf 文件夹下，数据库的配置文件名称为 mysql.conf）。 -最后，我们重新启动 PHPStudy +最后，我们重新启动 PHPStudy。 ## Linux 平台 -首先，点击左侧面板的数据库，进入数据库列表管理页面 +首先，点击左侧面板的数据库，进入数据库列表管理页面。 -之后，选择需要的数据库，并点击删除 +之后，选择需要的数据库，并点击删除。 -最后，在弹出的提示框中点击确定，即可删除数据库 +最后，在弹出的提示框中点击确定，即可删除数据库。 ## 暴力删除 也许我们会遇到：用温和的方式弄不干净数据库的尸体，这尸体又影响我重新安装数据库了 -那就暴力的删干净吧 +那就暴力的删干净吧！ TODO diff --git a/src/content/docs/general/process/database/use.md b/src/content/docs/general/process/database/use.md index 6fb37b819..274df8901 100644 --- a/src/content/docs/general/process/database/use.md +++ b/src/content/docs/general/process/database/use.md @@ -6,15 +6,15 @@ sidebar: ## 使用数据库管理软件管理 -你要知道，在 数据库安装 那一栏。虽然有两种截然不同的方式安装数据库 +你要知道，在 数据库安装 那一栏。虽然有两种截然不同的方式安装数据库， -但是你安装的数据库，实质上都安装的是同一个东西，只不过管理工具不同 +但是你安装的数据库，实质上都安装的是同一个东西，只不过管理工具不同。 -什么是 **管理工具** ？就是帮助你方便管理你的数据库一类工具软件 +什么是 **管理工具** ？就是帮助你方便管理你的数据库一类工具软件。 -像宝塔这种运维面板、Navicat 这种数据库管理软件给数据库提供了 创建，删除，备份 等基础操作 (有图形界面)，让你无需学会数据库指令操作，就可以管理你的数据库 +像宝塔这种运维面板、Navicat 这种数据库管理软件给数据库提供了 创建，删除，备份 等基础操作 (有图形界面)，让你无需学会数据库指令操作，就可以管理你的数据库。 -当然，这并不是说你只能用这些工具管理数据库了，你仍然可以使用指令控制你的数据库 (无图形界面) +当然，这并不是说你只能用这些工具管理数据库了，你仍然可以使用指令控制你的数据库 （无图形界面）。 ### Navicat @@ -24,7 +24,7 @@ sidebar: ::: -**Navicat** 是一款企业级的简单易用的数据库管理软件 +**Navicat** 是一款企业级的简单易用的数据库管理软件。 #### 优势 @@ -43,7 +43,7 @@ sidebar:
连接数据库 -点击连接，并选择你想要连接的数据库的类型 +点击连接，并选择你想要连接的数据库的类型。 ![](_assets/25.png) @@ -61,13 +61,13 @@ sidebar: ![](_assets/26.png) -填写完毕后点击确定即可 +填写完毕后点击确定即可。 -顺利的话，点开数据库后会显示一个绿色图标的海豚，并列出内部的数据库 +顺利的话，点开数据库后会显示一个绿色图标的海豚，并列出内部的数据库。 ![](_assets/27.png) -否则他会报错 +否则他会报错。 一般有这几种情况导致连接不上： @@ -86,7 +86,7 @@ sidebar:
创建数据库 -右键数据库图标，点击新建数据库 +右键数据库图标，点击新建数据库： ![](_assets/28.png) @@ -100,7 +100,7 @@ sidebar: ![](_assets/29.png) -然后点击确定即可创建数据库 +然后点击确定即可创建数据库。
@@ -114,7 +114,7 @@ GitHub https://github.com/HeidiSQL/HeidiSQL ::: -**HeidiSQL** 是一款开源的简易数据库管理软件 +**HeidiSQL** 是一款开源的简易数据库管理软件。 #### 优势 @@ -145,9 +145,9 @@ TODO ### 宝塔面板 -宝塔面板实际上是一种 Linux 运维管理面板，同时兼有数据库管理功能 +宝塔面板实际上是一种 Linux 运维管理面板，同时兼有数据库管理功能。 -推荐 Linux 用户使用 +推荐 Linux 用户使用。 #### 教程 @@ -160,7 +160,7 @@ TODO ## 手动管理 -PS: 这年头谁还用指令管理数据库啊 +PS: 这年头谁还用指令管理数据库啊！ :::note @@ -171,7 +171,7 @@ CREATE DATABASE <数据库名称> CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ ``` 解释：`CHARACTER SET utf8mb4` 将数据库字符集设置为 utf8mb4，能够存储包括表情符号在内的所有 Unicode 字符。 -`utf8mb4_general_ci` 是一种不区分大小写 (case-insensitive) 的排序规则，如果你想区分大小写，可以改为 `utf8mb4_bin`，`_bin` 意为以二进制方式比较字符。 +`utf8mb4_general_ci` 是一种不区分大小写（case-insensitive）的排序规则，如果你想区分大小写，可以改为 `utf8mb4_bin`，`_bin` 意为以二进制方式比较字符。 ::: @@ -179,15 +179,15 @@ TODO ## 插件连接数据库 -下面，我们来演示一下怎么让插件连接上数据库 +下面，我们来演示一下怎么让插件连接上数据库。 我们以 MySQL 为例： -这是一般插件的数据库配置项 +这是一般插件的数据库配置项： ![](_assets/30.png) -我们来一一介绍他们的用途 +我们来一一介绍他们的用途： - enabled: 是否启用 MySQL 存储数据？如果是请填 `true`，否则填 `false`，默认是 `false`，而且有些插件是直接让你填写数据库类型的，默认是 SQLite。 对于这种配置文件，请把 SQLite 改成 MySQL 或者其他你使用的数据库名。 @@ -218,4 +218,4 @@ TODO - 数据库连接数满了 -请结合报错分析原因 +请结合报错分析原因。 diff --git a/src/content/docs/general/process/deploy/_assets/mcsm.png b/src/content/docs/general/process/deploy/_assets/mcsm.png index 0c1d77e12..2b45c1b28 100644 Binary files a/src/content/docs/general/process/deploy/_assets/mcsm.png and b/src/content/docs/general/process/deploy/_assets/mcsm.png differ diff --git a/src/content/docs/general/process/deploy/frp.mdx b/src/content/docs/general/process/deploy/frp.mdx index d2ce4e42f..3e3b252b8 100644 --- a/src/content/docs/general/process/deploy/frp.mdx +++ b/src/content/docs/general/process/deploy/frp.mdx @@ -17,7 +17,13 @@ title: 搭建内网穿透 (frp)
如何选择合适的节点？ -根据三角形两边之和大于第三边的定理，节点距离客户端或服务端越近，游戏延迟就越小。然而你无法确定客户端的地理位置，毕竟玩家来自大江南北。那么只有缩短节点与服务器之间的距离，才能保证所有玩家的延迟都最低。例如服务器位于河北，有两个节点分别位于山东枣庄和江苏宿迁，有两个玩家分别位于广东和辽宁，那么当选择离服务器更近的枣庄节点时，假设辽宁玩家到节点为 20 ms，广东玩家到节点为 50 ms，服务器到节点为 10 ms，那么辽宁玩家的游戏延迟就是 20+10=30 ms，广东玩家的游戏延迟就是 50ms+10ms=60 ms。当选择离服务器更远的宿迁节点时，假设辽宁玩家到节点为 40 ms，广东玩家到节点为 30 ms，服务器到节点为 30ms，那么辽宁玩家的游戏延迟就是 50+30=70 ms，广东玩家的游戏延迟就是 40+30=60 ms。选择宿迁节点时虽然广东玩家的延迟不变，但是辽宁玩家连接服务器时，数据从更远的宿迁绕了一圈再回来，延迟高了很多。因此选择运营商时，优先选择拥有离自己近的节点的运营商。 +根据三角形两边之和大于第三边的定理，节点距离客户端或服务端越近，游戏延迟就越小。然而你无法确定客户端的地理位置，毕竟玩家来自大江南北。那么只有缩短节点与服务器之间的距离，才能保证所有玩家的延迟都最低。 + +例如，服务器位于河北，有两个节点分别位于山东枣庄和江苏宿迁，有两个玩家分别位于广东和辽宁。那么当选择离服务器更近的枣庄节点时，假设辽宁玩家到节点的延迟为 20 ms，广东玩家到节点的延迟为 50 ms，服务器到节点的延迟为 10 ms，那么辽宁玩家的游戏延迟就是 20 + 10 = 30 ms，广东玩家的游戏延迟就是 50 + 10 = 60 ms。 + +当选择离服务器更远的宿迁节点时，假设辽宁玩家到节点的延迟为 40 ms，广东玩家到节点的延迟为 30 ms，服务器到节点的延迟为 30 ms，那么辽宁玩家的游戏延迟就是 40 + 30 = 70 ms，广东玩家的游戏延迟就是 30 + 30 = 60 ms。 + +选择宿迁节点时，虽然广东玩家的延迟不变，但是辽宁玩家连接服务器时，数据从更远的宿迁绕了一圈再回来，延迟高了很多。因此，选择运营商时，应优先选择拥有离自己近的节点的运营商。
6. 实名认证：为了在意外事故中更好地规划责任，很多内网穿透运营商都要求实名认证才能开始使用，或者部分节点需要实名认证。还有一些实名认证时还要求用户必须成年 (年满 18 岁)。况且实名认证服务提供方收费，内网穿透运营商可能会让你自行承担费用，目前价格通常在 1 元。所以在选择运营商时，如果你未成年，或者没有在线支付的能力，那么在一些运营商处可能会受到限制。 diff --git a/src/content/docs/general/process/deploy/purchase-server.md b/src/content/docs/general/process/deploy/purchase-server.md index 8dfe05864..37448a997 100644 --- a/src/content/docs/general/process/deploy/purchase-server.md +++ b/src/content/docs/general/process/deploy/purchase-server.md @@ -12,17 +12,17 @@ sidebar: ::: -搭建 Minecraft 服务器对服务器的 CPU 性能、内存大小、硬盘 I/O 速度和网络质量，网络带宽均有较高的要求。 +搭建 Minecraft 服务器对服务器的 CPU 性能、内存大小、硬盘 I/O 速度、网络质量和网络带宽均有较高的要求。 ## 云服务器 -如果你的服务器不是自己购买的而是从服务商处租用的，比如 VPS 或面板。至于这到底是什么，下一章会讲解。 +如果你的服务器不是自己购买的而是从服务商处租用的（比如 VPS 或面板），至于这到底是什么，下一章会讲解。 ### CPU #### 核心数 -总的说来，核心数量要根据玩家数量，服务器性质，预算选择。 +总的说来，核心数量要根据玩家数量、服务器性质、预算选择。 @@ -36,7 +36,7 @@ sidebar: 对于多端，核心数量主要取决于总人数，每 100 玩家多加 4 - 8 个核心是较为合理的。 -而 Folia 官方推荐的配置在 16 核心以上，如果是新手或对现有插件有严重依赖的不推荐使用，生态较差。 +而 Folia 官方推荐的配置在 16 核心以上，如果是新手或对现有插件有严重依赖的，不推荐使用，生态较差。 #### CPU 单核性能 @@ -46,7 +46,7 @@ sidebar: CPU 总占用不算高时，Minecraft 的服务器性能与 CPU 单核性能几乎为线性关系，单核性能翻倍几乎就可以多带一倍 **甚至更多** 的人。 -尽量选择不超开的云 (如上图，图中 50% 的性能差就在于低价云超开导致性能下降，不要贪图便宜，服务器到手后要自己跑分) +尽量选择不超开的云（如上图，图中 50% 的性能差就在于低价云超开导致性能下降，不要贪图便宜，服务器到手后要自己跑分）。 不超过 20 人时为节省成本可以使用 E5 主机，而单端人数多于 20 基本就意味着需要牺牲玩家的游戏体验或者需要换更好的 CPU。 @@ -54,13 +54,13 @@ CPU 总占用不算高时，Minecraft 的服务器性能与 CPU 单核性能几 :::note -内存几乎不用考虑 DDR4 / DDR5，高频/低频内存的区别，最重要的是内存大小。 +内存几乎不用考虑 DDR4 / DDR5、高频/低频内存的区别，最重要的是内存大小。 使用高频 DDR5 内存和 DDR4 内存开服基本没有差别，如果是自己买的服务器托管的就省点钱吧。 ::: -一般来说，mod 服比插件服占用高，高版本比低版本略高。尽量选择核心数与内存比例在 1:2 以上的套餐 (推荐 1:2 - 1:4)。 +一般来说，mod 服比插件服占用高，高版本比低版本略高。尽量选择核心数与内存比例在 1:2 以上的套餐（推荐 1:2 - 1:4）。 一方面，核心多内存少必然面临性能下降。另一方面，核心多内存少基本为超开，性能会比正常情况下差很多。 @@ -68,7 +68,7 @@ CPU 总占用不算高时，Minecraft 的服务器性能与 CPU 单核性能几 :::caution -并不是人越多需要的内存越多，不建议分配过多内存，否则导致 GC (内存垃圾回收) 时间过长导致 [卡顿](/general/basics/what-is-lag)。 +并不是人越多需要的内存越多，不建议分配过多内存，否则导致 GC（内存垃圾回收）时间过长，引发 [卡顿](/general/basics/what-is-lag)。 ::: @@ -76,9 +76,9 @@ CPU 总占用不算高时，Minecraft 的服务器性能与 CPU 单核性能几 根据玩家数量及视野情况分配。一般情况低版本全默认情况下平均每个玩家会使用 0.25 Mbps - 0.4 Mbps 的上行带宽。 -1.18 以上服务器平均每人使用 0.3 Mbps - 0.5 Mbps 上行带宽 (一群跑图佬另说) 也就是说一般提供的 10 M 带宽够带 15 - 20 人。 +1.18 以上服务器平均每人使用 0.3 Mbps - 0.5 Mbps 上行带宽（一群跑图佬另说）。也就是说，一般提供的 10 M 带宽够带 15 - 20 人。 -同样的有的服务商会提供所谓“共享上行”，有时会出现其他用户传文件，VPS 所在宿主机所有用户都变卡的情况，建议无论如何搞到一个独享带宽保底。 +同样的，有的服务商会提供所谓“共享上行”，有时会出现其他用户传文件，VPS 所在宿主机所有用户都变卡的情况，建议无论如何搞到一个独享带宽保底。 需要注意的是，想要家庭带宽开服要考虑到吃 DDoS 和部分运营商不提供公网或者公网上行速度非常慢的情况，只建议基友服使用，或者配合 frp 等流量转发方式使用。 @@ -87,7 +87,7 @@ CPU 总占用不算高时，Minecraft 的服务器性能与 CPU 单核性能几 Windows 系统一般有 Windows Server，它和普通的 Windows 系统操作没有什么区别，只要用过 Windows 就能快速上手，但是 Windows 系统相对占用系统资源更高。 Linux 系统常见的有 Ubuntu、CentOS 和 Debian。我们日常很少接触 Linux 系统，所以你可能需要事先学习 Linux 系统的操作。Linux 系统占用系统资源更低。 -如果希望长期开服，强烈推荐使用 Linux 系统 (如 Ubuntu/CentOS 等)，因为它不仅占用系统资源更低，而且由于其系统本身机制与 Windows 不同，长期运行要比 Windows 系统稳定得多。 +如果希望长期开服，强烈推荐使用 Linux 系统（如 Ubuntu/CentOS 等），因为它不仅占用系统资源更低，而且由于其系统本身机制与 Windows 不同，长期运行要比 Windows 系统稳定得多。 很多时候一些服务器软件也仅支持 Linux。 ## 物理机 @@ -98,19 +98,19 @@ Linux 系统常见的有 Ubuntu、CentOS 和 Debian。我们日常很少接触 L ### CPU -通常除非你有明确的需求，不建议为了开 MC 服务器而购买任何 E5 (洋垃圾)、至强金银铜牌和 EPYC 的服务器 CPU。优先选用英特尔酷睿和 AMD 锐龙 CPU。由于 MC 服务器对单核要求非常高，所以尽可能选择新款高频版本的 CPU。 +通常除非你有明确的需求，不建议为了开 MC 服务器而购买任何 E5（洋垃圾）、至强金银铜牌和 EPYC 的服务器 CPU。优先选用英特尔酷睿和 AMD 锐龙 CPU。由于 MC 服务器对单核要求非常高，所以尽可能选择新款高频版本的 CPU。 区分的方式是英特尔 CPU 后面带 K，比如 10600K、12700KF，AMD 的 CPU 后面带 X，比如 5600X、7950X。级别更高的 CPU 往往核心数和单核性能都更高。要开的服务器规模越大，就越有必要选购更高端的 CPU。 比如要开一个小型的服务器，使用 10300F 即可；要开一个大型的服务器，你可能必须要用 12700KF 才够用。 为服务器选择 CPU 并不需要带核显。核显是 CPU 自带的显卡，可以为主板 I/O 面板上自带的显示接口提供显示输出功能，并提供一定的图形渲染功能。 由于 MC 服务器所有渲染图像的工作都由玩家的设备自行完成，所以服务器不需要任何显卡的性能，你的显卡只需要保证能够进行视频输出即可，也就是“亮机卡”。如果你手里已经有现成的低性能的显卡，你可以直接购买不带核显的 CPU，比如带 F 的英特尔 CPU。 -如果没有低性能的 CPU，比如你手里有一张闲置的 2070 ~~(谁会手里有了 2070 还闲置啊)~~，那么除非你有特殊的需求，比如除了开服还用服务器跑 AI，就不建议把这张显卡放到服务器上使用，这种显卡待机情况下功耗更高，导致你家电表转得更快。 +如果没有低性能的 CPU，比如你手里有一张闲置的 2070 ~~（谁会手里有了 2070 还闲置啊）~~，那么除非你有特殊的需求，比如除了开服还用服务器跑 AI，就不建议把这张显卡放到服务器上使用，这种显卡待机情况下功耗更高，导致你家电表转得更快。 :::caution -做高版本生存服务器，买实体机千万不要考虑 E5 这种洋垃圾，否则你会吃大亏，切记!!! +做高版本生存服务器，买实体机千万不要考虑 E5 这种洋垃圾，否则你会吃大亏，切记！ -另外，13700K、13700KF、13900K、13900KF、14700K、14700KF、14900K、14900K 几款 CPU 被曝出由于其主频过高而导致不稳定 (运行软件时软件出错，这可能导致你的服务器崩溃甚至损坏) 的问题，建议开服暂时不使用。 +另外，13700K、13700KF、13900K、13900KF、14700K、14700KF、14900K、14900K 几款 CPU 被曝出由于其主频过高而导致不稳定（运行软件时软件出错，这可能导致你的服务器崩溃甚至损坏）的问题，建议开服暂时不使用。 ::: @@ -126,10 +126,10 @@ Linux 系统常见的有 Ubuntu、CentOS 和 Debian。我们日常很少接触 L 虽然是服务器，但是毕竟游戏服务器，需要的内存也是非常高的。通常不推荐购买“刚好够用”的内存容量，因为你的需求会随着服务器规模的扩大逐渐提高，导致后期你可能需要对内存进行升级或更换。如果不是预算非常紧张，建议先购买 CPU 所支持的最大内存容量的一半，数量为主板内存插槽数量的一半，后期需要扩容时，直接购买 **同品牌、同系列、同参数** 的内存加装。 -MC 服务器对内存的频率和时序几乎没有任何要求 (https://www.minebbs.com/threads/_cpu.17729)。 +MC 服务器对内存的频率和时序几乎没有任何要求（https://www.minebbs.com/threads/_cpu.17729）。 所以你可以选择更便宜的低频内存，例如 DDR3 的 1333 MHz、DDR4 的 2666 MHz、DDR5 的 4800 MHz。 -由于各内存颗粒工厂的产量 (~~失火频率~~) 不同，内存的价格会随时间出现变化。如果你时间充足，可以多关注数码资讯，选择最合适的时机抢购内存。 +由于各内存颗粒工厂的产量（~~失火频率~~）不同，内存的价格会随时间出现变化。如果你时间充足，可以多关注数码资讯，选择最合适的时机抢购内存。 ### 硬盘 @@ -139,11 +139,11 @@ MC 服务器对内存的频率和时序几乎没有任何要求 (https://www.min 选购固态硬盘时，需要注意以下事项： -1. **数据无价！！！**，不要选择小厂品牌的固态硬盘，尽可能选择大品牌，比如三星、长江、铠侠 (东芝)、西数、爱国者、英特尔。希捷和金士顿的固态硬盘虽然性价比不高，但是如果你有明确的需求，也不失为一种选择。 +1. **数据无价！** 不要选择小厂品牌的固态硬盘，尽可能选择大品牌，比如三星、长江、铠侠（东芝）、西数、爱国者、英特尔。希捷和金士顿的固态硬盘虽然性价比不高，但是如果你有明确的需求，也不失为一种选择。 2. 固态硬盘的价格和内存一样存在较大波动。 -3. 不建议选择二手固态硬盘！你有很大的可能性买到矿盘（可以理解为 写入量较大的硬盘）。如果非要购买，请注意备份！ +3. 不建议选择二手固态硬盘！你有很大的可能性买到矿盘（可以理解为写入量较大的硬盘）。如果非要购买，请注意备份！ 选购机械硬盘时，需要注意以下事项： -1. 机械硬盘的 I/O 速度 远低于固态硬盘，不要只因为机械硬盘便宜，就去选购机械硬盘！ -2. 不要去选择二手机械硬盘，如有购买，建议多备份或组 RAID 使用（RAID 0 除外）！ +1. 机械硬盘的 I/O 速度远低于固态硬盘，不要只因为机械硬盘便宜，就去选购机械硬盘！ +2. 不要去选择二手机械硬盘，如有购买，建议多备份或组 RAID 使用（RAID 0 除外）！ \ No newline at end of file