diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 8c2b7cb40..51f19f00c 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -1,51 +1,51 @@ # 为笨蛋文档做出贡献 -首先,感谢你抽出宝贵时间做出巨大贡献！！ +首先，感谢你抽出宝贵时间做出巨大贡献！！ -所有类型的更改都会最大限度通过,但在此之前,你需要先阅读以下几点来加快审核进度 +所有类型的更改都会最大限度通过，但在此之前，你需要先阅读以下几点来加快审核进度 ## 目录 - [这篇文档有问题](#这篇文档有问题) - [我想要为文档做出贡献](#我想要为文档做出贡献) - - [格式要求](#格式要求) - - [尽量使用个人分叉而不是组织分叉](#尽量使用个人分叉而不是组织分叉) -- [感谢](#感谢) + - [格式要求](#格式要求) + - [尽量使用个人分叉而不是组织分叉](#尽量使用个人分叉而不是组织分叉) +- [致谢](#致谢) ## 这篇文档有问题 -由于此文档由大量人员共同编辑,难免会有瑕疵,如果你发现了文档中的问题之处,请按照以下方法提交： +由于此文档由大量人员共同编辑，难免会有瑕疵，如果你发现了文档中的问题之处，请按照以下方法提交： -- 打开 [ISSUE](https://github.com/postyizhan/NitWikit/issues) -- 查看是否有相似问题,无论其处于打开状态还是关闭状态 +- 打开 [ISSUES](https://github.com/Cubic-Project/NitWikit/issues) +- 查看是否有相似问题，无论其处于打开状态还是关闭状态 - 尽可能详细地提出出错的地方和问题详情 -然后,我们将尽快处理该问题 +然后，我们将尽快处理该问题 ## 我想要为文档做出贡献 -我们不接受任何无意义或偏离主题的意见,所以你应当说明此更改的合理性,并且你应当在提交更改前查看是否有类似更改 +我们不接受任何无意义或偏离主题的意见，所以你应当说明此更改的合理性，并且你应当在提交更改前查看是否有类似更改 -你也可以提供针对[待办事项](https://github.com/postyizhan/NitWikit/blob/main/docs/contribution/todos.md)中未完成事项的更改来提高通过的几率 +你也可以提供针对 [待办事项](https://nitwikit.8aka.org/contribution/todos) 中未完成事项的更改来提高通过的几率 -记住！你的任何更改不止会影响到你,还有其他需要通过这篇文档来搭建服务器的人 +记住！你的任何更改不止会影响到你，还有其他需要通过这篇文档来搭建服务器的人 -我们可以在你说明未排版的前提下代替你进行排版,但在此之前,请遵循以下要求： +我们可以在你说明未排版的前提下代替你进行排版，但在此之前，请遵循以下要求： ### 格式要求 -对于文档,我们有格式要求,详见 [格式要求](https://github.com/postyizhan/NitWikit/blob/main/docs/contribution/writing-specification/writing-specification.md) +对于文档，我们有格式要求，详见 [格式要求](https://nitwikit.8aka.org/contribution/writing) 和 [图片处理](https://nitwikit.8aka.org/contribution/image) -若格式不规范但不会或不想排版时请在 PR 时提出**文档需排版**,否则我们极大概率会关闭此处更改 +若格式不规范但不会或不想排版时请在 PR 时提出 **文档需排版**，否则我们极大概率会关闭此类 PR ### 尽量使用个人分叉而不是组织分叉 -我们可能会在一些极端情况下去修改你的分叉,无论是解决大量冲突还是修改错误,这比你自己来回检查要快速且方便的多 +我们可能会在一些极端情况下去修改你的分叉，无论是解决大量冲突还是修改错误，这比你自己来回检查要快速且方便的多 -问题是,如果你是组织分叉,我们无法将对其进行更改,_详见 isaacs/github#1681_ ,这会导致我们会关闭它并手动合并,而不是被标记为合并 +问题是，如果你是组织分叉，我们无法将对其进行更改，_详见 isaacs/github#1681_，这会导致我们会关闭它并手动合并，而不是被标记为合并 -_我们更加希望它会显示为合并而不是被关闭_ +_我们更加希望它会显示为合并而不是被关闭。_ -#### 感谢 +## 致谢 感谢 [contributing-gen](https://contributing.md/) 生成的模板 diff --git a/README.md b/README.md index fde38daa1..b5b71434c 100644 --- a/README.md +++ b/README.md @@ -14,15 +14,14 @@ 这是一份适用于游戏 [Minecraft](https://www.minecraft.net/zh-hans) [Java 版](https://zh.minecraft.wiki/w/Java%E7%89%88) 及 [Bedrock (基岩) 版](https://zh.minecraft.wiki/w/%E5%9F%BA%E5%B2%A9%E7%89%88) -的服务器开服教程，在这里，你可以看到由众多用户经验编制而成的各色教程，希望它们可以成为你开服路上的一份趁手资料，也希望你能运营一个不错的服务器——一切皆有可能。动动手指来阅读第一章的内容吧。 +的服务器开服教程，在这里，你可以看到由众多用户经验编制而成的各色教程，希望它们可以成为你开服路上的一份趁手资料，也希望你能运营一个不错的服务器 —— 一切皆有可能。动动手指来阅读第一章的内容吧。 # 📖 开始阅读 - Docusaurus 主题：https://nitwikit.8aka.org -- VitePress 主题：https://nitwikit2.8aka.org -- [![](https://img.shields.io/badge/QQ群-1074062482-54B4EF?logo=data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAGwAAABsCAYAAACPZlfNAAAACXBIWXMAACE4AAAhOAFFljFgAAAAAXNSR0IArs4c6QAAAARnQU1BAACxjwv8YQUAAAsSSURBVHgB7Z1PbNvWHce/pGRZtltbAZbukH/MYUCaeIt3ybAGaOVgLbBhbZKhWHtpbQ87Loiz0zB0s7rusEOBuOhuw2BnPQwDtthpBww7SSnQYcvF8pp0vYnJvEMbYFbSprYlS+z7UaIty+Tjv0eKkvgBfiAt8VmP78vf+/Mj+R4QExMTExMTExMTE9PlSOgdFGaZprWjNq3r6VbBSJRpZqeZTWBXLDuKTbvJrIAeETGqkCCzzPLMNEG2gobwCmKEQULNMVuHOKHMbAGxcL65jOCFarUSGhdHjEsUiK36vAinIMYRWYTrVTzRLiCGyxQ6L1S7zSLGFGqvoiaWYVOI2QNVPVEVy7C4emyiIBptlp2tI+6I6JQQfbEMo4G2k4hKzzIHl4WWzWa1paUlLZ/PawsLC5qiKI7T0rHz8/N6WrLp6Wkvol1Fn6LAZWHNzc1p7ayvr2sTExO2aekYOrYd+p9u84FG/LLvyMNFIZE3WEFCZDIZrmeVSiXL9OS1bvLSzHtfkYXLq5pX4ARVdVZpFxcXuWmpenSbn+Y59A10hTouHKrO7OB5mVlV2I6TahUR8DIZ4ZOFy6uTVVn7PltdXcXk5KRuqqqCiQVW6KZp6Tsvv2GXBB3wsiTCZxouMSvwCxcu6EIRMzMzYNUaWFu177hWEQuFAq5du7aTjkSamprS05mldQANpgvoYajkXbcX7W3QysqKaRuXy+X2fU6fEcZ3VG22DgWMzgwNETzkbR0hj8vCrhI9hXcMj7CjXC6bfnbjxg0wwXD16lWw9gxMXH3LRALr1uvH3b17Fx4gsXo6ZLUMDx5m1qVv9RLaJ1g1uS8tfWZ4JQ+ztA4tjx7GU8yQqrF2SADq2ZEVi8V9IvLSmuEmYoIOV4thkYW3AtGNxko8lpeXPaf12H61WhY9SA4+CoU8gDee4nkIbxxH/9OHdxmWQw+Sh79CsQxPOQnizs7OmorlMQDcbsvoQYTc8yJvoG6+Ea13EwdsTUuhLAGeZdg6QiKsJ3+pUQ7tpDrEAWZlBExY47B+uB2hIATCCk0pEMBpRcI3jstQnpBwjNnYsKTvj41At8yIeYVRfqThwSM2OP5U0/++e1/T91dLtK1jVdUgALooiwiYSAv2zCkZL5xJMJEk3awEsYPSZZigJLIV79+u499MwBu3anj/Th0eUBACYbVh82g8xuaIS88n8NoPk54F8gt536//tI0/5Gtuki0ym0HAhOVhjiMBr0wm8ObMADoJeeLvLg3o1ezbf3UlWuCE1ek45vRAqo7eu+WpShIKVZHvusvHAYRAJ25gcqHq6MXfVPDjt6s7nYQwIaGe/UUFz/6y4vb3xxACYTUSeXiMt1EV+Sqzp8eDvbZIqDdYu+Wxw0EUmE0iYCIvmAG1Ky+ckXUBTx8XIx6JdJMJ9FvWTlHX3ycFxIKZQ+I9TV3+b8k4dlByLCBVceRBq6VG+yS4yi0gFswZ1P0/+gTbDkv7xloPmOeobKB871OI8CIeBYQgWChc+8qhlZeHR7UjiQFRwdbI2Kgkay8Pj2nzB766ghAI3MPWDn1tIiVJOydzu7qFO5UtfLD1BT6sVnCnuolu4khyAGdTw3gqPcS2Q/rfBhLkyYNrHxcQIIEPnFOQ9rzBOD4wqNtLI6P63w/rdSbcli7cf7e3dUE/rGziodbZsRjzHCZGCl+n/KZSODWQ1vdHZev2UkMt8MfeAvWwdUXJbNdSJU1z/8yDIeSDeo2JuaX/TWIS92pVJm4VfiDPGJUSOJpMYoxtj7AtfUYX09HEAFcYDuVHn1eOHy+rgd1mCdTDqtX0BUh1Tw+oUIGdHRzS97839JjlcYZw92rblseMsf81JjUEaK3CAiAzNDI4ze6KzSMgAhVMkuqXg45VGAIELIRjZKl+HghOsMDCB9TZ0PryPSope//wiSwCIjDB2jsb/USz8xEIgXQ6/HQ2eoTAOh+BeBh1NvpYLKLR+QiAQAT7+9bDy9QN71fo3P9ZeXQeARBElUgdDT2y8dTgML47NMIGnGm2P4Re5oOtDTZO3MTfNh7h9u7An2KLBQgkiG79TmfjHyz8REZQ5GA8ldbHVmeZkOM2UYMoYwzqTQRqR3jkIwgPK8HhE0Qk4O9/9QZOblZQu/0xqh99BO3hZ4gS0ujjGDh5EonxE1gbTuO5n//MTZSFOh1CHx0QLRhdUUtuEtCLdcYrsbW1/+H/3z6HsCFRkocPQz58CPLRQ0iefBIJtp88dYJ9N7pzHL0ceOCA6/IXWi2KrhJdjT9IKCcvjPNInnoSg899R9+vM8HNICEIEkYaawhAgpBJY4/vEcVJfs3e9ORAj/cVIAiRglHJT7lJ4PFF8D2QNwz/9CcICw+CZdEoGyFjMpGtvuvRvV/v6gQeLjKh70HHgrnEY63gqubhIVKwZ+CSbhTMIzQ2FXKyogTLos/nEbSBykbInQtRgk3DAyI6HWHjI89C2jFRgp1GjB1CYosiBFPg0d1ddo+7HQUC3iETIZjnurkbBXM6jZIFWfhEhGBZxDjFd8dDhGB91X75rBVcD33aERGaytp8T2do2uVvr15kFusbuXIJ23f+o0ftKRhcW1uDFRQbTBw5hDCxEczyXJso6DDk4rxnz+lWyzw4E504pXZvbY91CpupZudhPw+/Ah/49TC7wfLrvGPcNOByyJ5kRbFY5H2tovFiep5zzAR8LOXotw3jNaKLTVM5x/jtdYWKjViEisatlLc4x/iKCPkVzOrHVWZXmvvcs7x58ya6BQezlqrNbQ7WF6oCHwQlGN1lNVpnFZx7QQ6u2shAkzxzULF7cdL5Ws3ZETkPo3ZLbfvsBixYXl5Gt2AjWMHk7ysmx4Uy24AVOezvJZmRBafnZLfqQxSgPILf+7MK7i62HZeDD/x6mNqyvwrr5QcL4FSLNJd81KGZuTmosJ7kksqk2HZsxzDmoV+Cfd2cg8XV6XQi5U5iMxlmDvbltAgB4zAROG1EjUkuTU/abiLlTmIzibOblfucHhcZcrA4cZoKNqr49K6uhrysBIuTp3l4o4aNd5XQB2TBacui1GOkvNh41zT6BMuAcJSqRpsZu3PoM/KwKAyzOebDxmylpBbrnvCMQLjtmbGMVATFojwr6FMUREy0WCx7FHBEo3YkjI4I/YZNm1VEP4ulLWQyG39JT1eup/OfvJPWLn0/YVlYxhIcQUHDCd6ywq+eS2ifvDOoUV4rLM/oJ0io6lJ6buv64PrW9bTWam/+KKllhqVQhKOFcuzWX6G8UJ7a88msVFlKL2z8Ma0gZEKbGJ6E2s5sXq5rGguGSpbhLCdzxtNLFLRo6fnz5/VFSZ0+Pk0P0NDtHLppSlveAzW0yAFNhc5bnICQJeQGLm6+jpAIRTC6EuWUtAxJc/xInJtJk40lgUm41rc6SRAyegzBMDtIqNdeSrqdFFpNPUh/U5oJ/snYUATb+nN6kd3ImYIHDI979191lL/QEAQ09ewr5xrLhnidvVuqS2+lXtyYRcCEJNjQMmTN98sAJNp7t2r6JMt+F7ihRXaeP7O7tovfZUNY6kLqB5u9MUnz50sDEyktcVWDNsFrv9xAEy7T4jZk6n2aIXt3EmZWjaq0Pa1IythIY+JmWixHOSjjKM3IPS4JXNdFK0uQihWpduWxi9XAIyChdToMNpZYz2obiizVM3VJzsguxzb1lju2slYv1zW5XEvWygkkymmky9LFve2ItpTJbGIzU0Mtk9hONC4Wefc33fw+u+DKGqRyMyMqklCHLm6qiImJiYmJiYmJiYmJielZvgT9XQw6yizYKAAAAABJRU5ErkJggg==)](https://qm.qq.com/q/uiv3CPi00w) <-点击加入 +- [![](https://img.shields.io/badge/QQ群-1074062482-54B4EF?logo=data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAGwAAABsCAMAAAC4uKf/AAAAAXNSR0IArs4c6QAAAAlwSFlzAAAhOAAAITgBRZYxYAAAAJlQTFRFR3BMAAAAAAAAAAAA+q0INAUHAAAAAAAAAAAAAAAA5Z8HAAAA+K0HAAAA+qoK6yYv+q4I9q0GxBcf6hsm6BsmAAAAAAAA////6hwm+a4I+OnqhYWFQ0NDEgwKICAgOi4YY0UDYGBg83J5zMbGsRUdvoQG39/foKCg1xki8JWaNgYJJxsBcHBwYwsQh14EiRAWpnMF8E5XsLCww/r98QAAABZ0Uk5TAN2k74AQZUTDI/yAXZAY+Lg5wHU4j99m7pMAAAQqSURBVHja7ZrbdqIwFIYHKIrHqu1sFAgREfCs9f0fbgQJCaI1J9fc+F2VuvRz7/zJCsE/b9684aTTaed0Xu2xW6ZjAcExW53XmRxo4LzEZ/csuI+pXdey4CFGT28mHPgVQ2NxbQueYLS1tRA46OlycdHS0kPgpK0hGxZwYqmnxABuHFvR1QOG4BxnIVSEfhxHwPBXsYnA4LsXPAwl2MuvfWBQa6QDlMgt8FBZV+oWBEBxtCWx+HBaS1Zexs1EqheGXbdWmkeuMVuapsJ2RRlBkF4bF7iEnZ7SzEY8wtwSle44CgI/rUdkIOuygSUj45P6V7cPKMxjkwGDZWtZFP1KtisqO+f/8TJSGaGlo4sQlW0MyZjFLs2+ekQsYEFFQDCO3fB6SQih0Uf15Z5Ucq5fZloW/x7UCT1aCZ13Xgh1eqozml2votrE8yK4wVQaMkqYxVlQu/RDuMWSm2WS2FL5kKSjZZ+znR9Op6TbnRV0u0lyOuAt3NJSDiM+JKWkQXLAynEcAGVORA/ozhXjaDKu2VPmajKHGazTM1eyVZVx9zHBwOBIy6gu4VCpy2jyk3tRRAB6ZdR3YoTd05wMlV4ZBW3x/ALe0pLUZZM9Ahn2E3HX93Q6XR73GxAA7Y+ry9u+xQubXlnxGTf74zIX5XyJuuzPKSVXLvf7zQY1atls9qWG8mkLyr6mD1itliUromjwJdxFBSai8VDiW7AwJb4E46GGLReP15c2Wam5VhOh2/bNcSlrWh43Iptwk6wKy5VgRbmoYCB10LJe/HCl5fNnsUZQYUltTz3X9Z5ZFuvYy/f9MjczJlCQeyP7Wa8XBeuc2PNcCgKKKbHJx7eyhfuYUPymsAUMgYgsEN+Fm9KySHx3YAFDJCYT7WMb9MigLdpF8EVkPoge9ji6ZAbXusiyk5dBh2PIlMZMLPwDJZngoDkKskB0Hw4lFjOpmZX/c/1cZpGP4M2HUbYzdCu8C+6v4LJ9BkkIZz5aZIV0BSDvbXNO69JhVtaU3xVXjkFp5Tr9MOyqnxm/7Fx1zza4TkQGVbMtMqu52dGVo82VfbP6RiZJCDeYDAEZDvNZG8kXEh+0tBYLk6ONLbqAWmQp5sSvrb+28zwgNph2LSuAeGUh1FJhm89XYpv+ZZGTZy6yxvPBjsQhYCBYmBRktoAvUJih+pQJpRxRDJUfIA+4GxmQJqo/rduJxf61w+br+T1Dh9gEXOq2IH2YjUCTa9gfkZPtMHtQFiInu6O+kupjlnNAD3UeeRiDDsVx52iopmKP7VF0ThlTFiG4gruzkg851+j+oTMKop3v76IgBAJOZpSuTHGli1aH4C7o9pz6Q0FGuXP+vJ03H9GMJGRjaqN0k8McY2wY+an04URFjGssGZFxv//B0L8wHg+HxWvD8Xjcv319PHz/lvDNm//LP6Sx2t995a2wAAAAAElFTkSuQmCC)](https://qm.qq.com/q/uiv3CPi00w) <- 点击加入 -- [![](https://img.shields.io/discord/1342805340839870514.svg?label=&logo=discord&logoColor=ffffff&color=7389D8&labelColor=6A7EC2)](https://discord.com/invite/jN4Br8uhSS) <-Click to Join +- [![](https://img.shields.io/discord/1342805340839870514.svg?label=&logo=discord&logoColor=ffffff&color=7389D8&labelColor=6A7EC2)](https://discord.com/invite/jN4Br8uhSS) <- Click to Join ![:NitWikit](https://count.kjchmc.cn/get/@:NitWikit) @@ -32,11 +31,11 @@ - [GitHub](https://github.com/Cubic-Project/NitWikit) - [MineBBS](https://www.minebbs.com/threads/nitwikit-geyser.26356/) -- [klpbbs](https://klpbbs.com/forum.php?mod=viewthread&tid=136184&page=1&extra=#pid10518779) +- [苦力怕论坛](https://klpbbs.com/forum.php?mod=viewthread&tid=136184&page=1&extra=#pid10518779) - [九域](https://bbs.mc9y.net/threads/1624/) - [暮光方块论坛](https://bbs.tsfk.top/threads/399/) -- [mcbbs纪念版](https://mcbbs.co/thread-103-1-1.html) -- [mcutc 论坛](https://bbs.mcutc.cn/threads/560/) +- [MCBBS 纪念版](https://mcbbs.co/thread-103-1-1.html) +- [MCUTCBBS](https://bbs.mcutc.cn/threads/560/) - [HiMCBBS](https://www.himcbbs.com/threads/nitwikit-geyser.420/) # 🔨 构建文档 @@ -46,7 +45,7 @@ 1. 将此仓库克隆至本地 `git clone https://github.com/Cubic-Project/NitWikit.git` - 更快的克隆(推荐) + 更快的克隆 (推荐) `git clone --single-branch --depth 1 -b main https://github.com/Cubic-Project/NitWikit.git` 2. 移动至仓库根目录 `cd NitWikit` @@ -87,10 +86,10 @@ - 你不能声称这是你的作品 - 未经作者允许，你不得将本作品用于如下途径： - - 改编或转载 - - 盈利 + - 改编或转载 + - 盈利 - 你可以将本作品在不经授权的情况下用于： - - 带有出处的引用 + - 带有出处的引用 如果你希望部署你自己的文档副本，可以 diff --git a/convert.py b/convert.py deleted file mode 100644 index aef150934..000000000 --- a/convert.py +++ /dev/null @@ -1,768 +0,0 @@ -#!/usr/bin/env python3 -# -*- coding: utf-8 -*- -""" -智能图片格式转换器（保持原文件名） -=============================== - -将目录下的图片文件转换为AVIF或JXL格式，但保持原文件名不变（包括扩展名）。 -这样MD文件中的图片链接无需修改。 - -功能特性： -- 支持多种输入格式（jpg, jpeg, png, webp, bmp, tiff等） -- 支持两种输出格式（AVIF和JXL） -- 自动扫描目录下的所有图片文件 -- 转换为现代图像格式但保持原文件名 -- 智能压缩比检测，自动跳过无效转换 -- 支持dry-run模式（预览不执行） -- 多线程并行处理，加速转换 -- 可选择删除原始文件备份 -- 进度显示和详细日志记录 - -压缩优化： -- 自动检测转换效果，只转换能有效压缩的图片 -- 如果转换后体积变大，自动跳过 -- 可设置最小压缩比阈值 - -使用示例： - python image_to_avif_keep_name.py /path/to/images - python image_to_avif_keep_name.py /path/to/images --format jxl - python image_to_avif_keep_name.py /path/to/images --format avif --quality 90 - python image_to_avif_keep_name.py /path/to/images --threads 4 - python image_to_avif_keep_name.py /path/to/images --min-compression 10 -""" - -import os -import sys -import time -import argparse -import logging -import shutil -import tempfile -import threading -import concurrent.futures -from pathlib import Path -from datetime import datetime -from typing import List, Tuple, Set, Dict -from tqdm import tqdm - -try: - from PIL import Image - from PIL import ImageFile - - # 允许加载截断的图片 - ImageFile.LOAD_TRUNCATED_IMAGES = True - - # 检查AVIF支持 - import pillow_avif - - HAS_AVIF = True -except ImportError as e: - HAS_AVIF = False - MISSING_PACKAGES = [] - if 'PIL' in str(e): - MISSING_PACKAGES.append('Pillow') - if 'pillow_avif' in str(e): - MISSING_PACKAGES.append('pillow-avif') - -# 检查JXL支持 -try: - import pillow_jxl - - HAS_JXL = True -except ImportError: - HAS_JXL = False - MISSING_PACKAGES.append('pillow-jpegxl') - -# 支持的图片格式 -SUPPORTED_FORMATS = { - '.jpg', '.jpeg', '.png', '.webp', '.bmp', - '.tiff', '.tif', '.gif', '.ico' -} - - -# 日志配置 -def setup_logging(log_file: str) -> logging.Logger: - """设置日志记录""" - logger = logging.getLogger('avif_converter') - logger.setLevel(logging.DEBUG) - - # 文件处理器 - fh = logging.FileHandler(log_file, encoding='utf-8') - fh.setLevel(logging.DEBUG) - - # 控制台处理器 - ch = logging.StreamHandler() - ch.setLevel(logging.INFO) - - # 格式化器 - formatter = logging.Formatter( - '%(asctime)s - %(levelname)s - %(message)s', - datefmt='%Y-%m-%d %H:%M:%S' - ) - fh.setFormatter(formatter) - ch.setFormatter(logging.Formatter('%(levelname)s: %(message)s')) - - logger.addHandler(fh) - logger.addHandler(ch) - - return logger - - -class ImageConverter: - """图像转换器类，支持AVIF和JXL格式""" - - def __init__(self, directory: str, format: str = 'avif', quality: int = 80, - dry_run: bool = False, recursive: bool = True, delete_backup: bool = False, - check_compression: bool = True, min_compression_ratio: float = 0.05, - threads: int = 1, effort: int = 7, show_report: bool = True): - self.directory = Path(directory) - self.format = format.lower() # 'avif' 或 'jxl' - self.quality = quality - self.dry_run = dry_run - self.recursive = recursive - self.delete_backup = delete_backup - self.threads = max(1, threads) # 至少使用1个线程 - self.stats_lock = threading.Lock() # 用于保护统计数据的线程锁 - self.effort = effort # JXL特有的参数，压缩速度与质量的平衡，1-9 - self.check_compression = check_compression - self.min_compression_ratio = min_compression_ratio # 最小压缩比，默认5% - self.show_report = show_report # 是否在结束时显示详细报告 - - # 统计信息 - self.stats = { - 'found_images': 0, - 'converted': 0, - 'failed': 0, - 'skipped_larger': 0, # 因体积变大而跳过的文件 - 'skipped_minimal': 0, # 因压缩效果不明显而跳过的文件 - 'total_original_size': 0, - 'total_converted_size': 0, - 'total_saved_size': 0, # 总节省空间 - 'format_counts': {}, # 各种格式的统计 - 'conversion_time': 0, # 总转换时间 - 'max_compression': 0, # 最大压缩率 - 'min_compression': 100, # 最小压缩率 - 'avg_compression': 0, # 平均压缩率 - 'errors': [] - } - - # 设置日志 - timestamp = datetime.now().strftime('%Y%m%d_%H%M%S') - log_file = self.directory / f'avif_conversion_{timestamp}.log' - self.logger = setup_logging(str(log_file)) - - self.logger.info(f"开始处理目录: {self.directory}") - self.logger.info(f"参数 - 输出格式: {self.format.upper()}, 质量: {self.quality}, 递归: {self.recursive}, " - f"预览模式: {self.dry_run}, 删除备份: {self.delete_backup}, " - f"检测压缩比: {self.check_compression}, 最小压缩比: {self.min_compression_ratio:.1%}, " - f"线程数: {self.threads}" + - (f", 压缩速度等级: {self.effort}" if self.format == 'jxl' else "")) - - def find_images(self) -> List[Path]: - """查找所有支持的图片文件""" - images = [] - - if self.recursive: - pattern = '**/*' - else: - pattern = '*' - - for file_path in self.directory.glob(pattern): - if file_path.is_file() and file_path.suffix.lower() in SUPPORTED_FORMATS: - # 检查是否已经是目标格式（通过文件头判断） - if not self._is_already_converted(file_path): - images.append(file_path) - self.logger.debug(f"找到图片: {file_path}") - - # 统计原始格式 - try: - with self.stats_lock: - with Image.open(file_path) as img: - fmt = img.format.lower() if img.format else file_path.suffix.lower().strip('.') - if fmt in self.stats['format_counts']: - self.stats['format_counts'][fmt] += 1 - else: - self.stats['format_counts'][fmt] = 1 - except Exception: - # 如果无法打开图片，使用文件扩展名作为格式 - ext = file_path.suffix.lower().strip('.') - with self.stats_lock: - if ext in self.stats['format_counts']: - self.stats['format_counts'][ext] += 1 - else: - self.stats['format_counts'][ext] = 1 - else: - self.logger.debug(f"跳过已是{self.format.upper()}格式的文件: {file_path}") - - self.stats['found_images'] = len(images) - self.logger.info(f"找到 {len(images)} 个需要转换的图片文件") - return images - - def _is_already_converted(self, file_path: Path) -> bool: - """检查文件是否已经是目标格式""" - try: - with Image.open(file_path) as img: - if self.format == 'avif': - return img.format == 'AVIF' - elif self.format == 'jxl': - return img.format == 'JXL' - return False - except Exception: - return False - - def _test_compression(self, image_path: Path, original_size: int): - """测试转换压缩效果""" - try: - # 创建临时文件进行测试转换 - with tempfile.NamedTemporaryFile(suffix=f'.{self.format}', delete=False) as tmp_file: - temp_path = Path(tmp_file.name) - - try: - # 读取并转换图片到临时文件 - with Image.open(image_path) as img: - # 处理透明度 - if img.mode in ('RGBA', 'LA'): - pass - elif img.mode == 'P' and 'transparency' in img.info: - img = img.convert('RGBA') - else: - img = img.convert('RGB') - - # 保存为目标格式到临时文件 - if self.format == 'avif': - img.save( - temp_path, - 'AVIF', - quality=self.quality, - optimize=True - ) - elif self.format == 'jxl': - img.save( - temp_path, - 'JXL', - quality=self.quality, - effort=self.effort, # JXL特有参数 - lossless=False # 使用有损模式 - ) - - # 获取转换后文件大小 - converted_size = temp_path.stat().st_size - - # 计算压缩比 - if converted_size >= original_size: - return 'skip_larger' - - compression_ratio = ((original_size - converted_size) / original_size) * 100 - - # 更新压缩率统计 - with self.stats_lock: - if compression_ratio > self.stats['max_compression']: - self.stats['max_compression'] = compression_ratio - if self.stats['min_compression'] > compression_ratio > 0: - self.stats['min_compression'] = compression_ratio - - # 累加到平均压缩率计算 - if compression_ratio > 0: - current_count = self.stats['converted'] - if current_count > 0: - self.stats['avg_compression'] = ((self.stats['avg_compression'] * current_count) + - compression_ratio) / (current_count + 1) - else: - self.stats['avg_compression'] = compression_ratio - - # 检查是否达到最小压缩比 - if compression_ratio < (self.min_compression_ratio * 100): - return 'skip_minimal' - - return converted_size, compression_ratio - - finally: - # 清理临时文件 - if temp_path.exists(): - temp_path.unlink() - - except Exception as e: - self.logger.warning(f"测试压缩时出错 {image_path}: {str(e)}") - # 如果测试失败，假设转换有效 - return original_size * 0.7, 30.0 # 估算70%大小，30%压缩率 - - def convert_image(self, image_path: Path) -> bool: - """转换单个图片到AVIF格式，保持原文件名""" - try: - # 获取原始文件信息 - original_size = image_path.stat().st_size - - # 在多线程环境中安全更新统计信息 - with self.stats_lock: - self.stats['total_original_size'] += original_size - - if self.dry_run: - # 在预览模式下，如果启用了压缩比检测，进行测试转换 - if self.check_compression: - test_result = self._test_compression(image_path, original_size) - if test_result == 'skip_larger': - self.logger.info(f"[预览] 跳过（体积会变大）: {image_path}") - return False - elif test_result == 'skip_minimal': - self.logger.info(f"[预览] 跳过（压缩效果不明显）: {image_path}") - return False - else: - predicted_size, compression_ratio = test_result - self.logger.info( - f"[预览] 将转换: {image_path} " - f"({self._format_size(original_size)} -> {self._format_size(predicted_size)}, " - f"预计压缩 {compression_ratio:.1f}%)" - ) - else: - self.logger.info(f"[预览] 将转换: {image_path}") - return True - - # 实际转换模式 - # 如果启用压缩比检测，先进行测试 - if self.check_compression: - test_result = self._test_compression(image_path, original_size) - if test_result == 'skip_larger': - self.stats['skipped_larger'] += 1 - self.logger.info(f"跳过（转换后体积更大）: {image_path.name}") - return False - elif test_result == 'skip_minimal': - self.stats['skipped_minimal'] += 1 - self.logger.info(f"跳过（压缩效果不明显）: {image_path.name}") - return False - - # 创建备份文件名 - backup_path = image_path.with_suffix(f'{image_path.suffix}.backup') - - # 读取并转换图片 - with Image.open(image_path) as img: - # 处理透明度 - if img.mode in ('RGBA', 'LA'): - # 保持透明度 - pass - elif img.mode == 'P' and 'transparency' in img.info: - # 调色板模式带透明度，转换为RGBA - img = img.convert('RGBA') - else: - # 转换为RGB模式 - img = img.convert('RGB') - - # 备份原文件 - shutil.copy2(image_path, backup_path) - self.logger.debug(f"创建备份: {backup_path}") - - # 保存为目标格式，但使用原文件名 - if self.format == 'avif': - img.save( - image_path, # 使用原文件路径 - 'AVIF', - quality=self.quality, - optimize=True - ) - elif self.format == 'jxl': - img.save( - image_path, # 使用原文件路径 - 'JXL', - quality=self.quality, - effort=self.effort, # JXL特有参数 - lossless=False # 使用有损模式 - ) - if self.format == 'webp': - img.save( - image_path, # 使用原文件路径 - 'WEBP', - quality=self.quality, - optimize=True - ) - - # 获取转换后文件大小 - converted_size = image_path.stat().st_size - - # 在多线程环境中安全更新统计信息 - with self.stats_lock: - self.stats['total_converted_size'] += converted_size - - # 计算压缩比和节省空间 - saved_size = original_size - converted_size - self.stats['total_saved_size'] += saved_size - compression_ratio = (saved_size / original_size) * 100 - - self.logger.info( - f"转换成功: {image_path.name} " - f"({self._format_size(original_size)} -> {self._format_size(converted_size)}, " - f"压缩 {compression_ratio:.1f}%)" - ) - - # 如果需要，删除备份文件 - if self.delete_backup and backup_path.exists(): - backup_path.unlink() - self.logger.debug(f"删除备份: {backup_path}") - - # 在多线程环境中安全更新统计信息 - with self.stats_lock: - self.stats['converted'] += 1 - return True - - except Exception as e: - error_msg = f"转换失败 {image_path}: {str(e)}" - self.logger.error(error_msg) - - # 在多线程环境中安全更新统计信息 - with self.stats_lock: - self.stats['errors'].append(error_msg) - self.stats['failed'] += 1 - - # 如果转换失败，恢复原文件 - backup_path = image_path.with_suffix(f'{image_path.suffix}.backup') - if backup_path.exists(): - try: - shutil.copy2(backup_path, image_path) - backup_path.unlink() - self.logger.info(f"已恢复原文件: {image_path}") - except Exception as restore_error: - self.logger.error(f"恢复原文件失败: {restore_error}") - - return False - - def _format_size(self, size_bytes: int) -> str: - """格式化文件大小""" - for unit in ['B', 'KB', 'MB', 'GB']: - if size_bytes < 1024: - return f"{size_bytes:.1f} {unit}" - size_bytes /= 1024 - return f"{size_bytes:.1f} TB" - - def print_statistics(self): - """打印统计信息""" - if not self.show_report: - return - - print("\n" + "=" * 70) - print(f"图像转换报告 ({self.format.upper()}格式)") - print("=" * 70) - - # 基本统计信息 - print( - f"处理完成 │ 找到图片: {self.stats['found_images']} │ 成功转换: {self.stats['converted']} │ 失败: {self.stats['failed']}") - - # 显示跳过的文件统计 - if self.check_compression: - total_skipped = self.stats['skipped_larger'] + self.stats['skipped_minimal'] - print( - f"跳过文件 │ 总计: {total_skipped} │ 体积变大: {self.stats['skipped_larger']} │ 压缩效果不明显: {self.stats['skipped_minimal']}") - - # 空间节省统计 - if self.stats['total_original_size'] > 0: - original_size_mb = self.stats['total_original_size'] / (1024 * 1024) - - if self.stats['converted'] > 0: - converted_size_mb = self.stats['total_converted_size'] / (1024 * 1024) - saved_mb = self.stats['total_saved_size'] / (1024 * 1024) - saved_percent = (self.stats['total_saved_size'] / self.stats['total_original_size']) * 100 - - print("\n" + "-" * 70) - print("空间节省统计") - print("-" * 70) - print(f"原始总大小 : {original_size_mb:.2f} MB") - print(f"转换后总大小 : {converted_size_mb:.2f} MB") - print(f"节省空间 : {saved_mb:.2f} MB") - print(f"总体压缩率 : {saved_percent:.2f}%") - - # 计算平均压缩效果 - if self.stats['converted'] > 0: - avg_compression = (self.stats['total_saved_size'] / - (self.stats['total_original_size'] - - (self.stats['total_original_size'] - self.stats['total_converted_size']))) * 100 - print(f"平均压缩率 : {avg_compression:.2f}%") - - # 显示格式统计信息 - if self.stats['format_counts'] and len(self.stats['format_counts']) > 0: - print("\n" + "-" * 70) - print("原始图片格式统计") - print("-" * 70) - for fmt, count in sorted(self.stats['format_counts'].items(), key=lambda x: x[1], reverse=True): - percent = (count / self.stats['found_images']) * 100 if self.stats['found_images'] > 0 else 0 - print(f"{fmt.upper():<10}: {count:>5} 个文件 ({percent:.1f}%)") - - # 显示压缩比检测信息 - if self.check_compression: - print("\n" + "-" * 70) - print("压缩检测设置") - print("-" * 70) - print(f"检测阈值 : {self.min_compression_ratio:.1%}") - print(f"跳过体积变大 : {self.stats['skipped_larger']} 个文件") - print(f"跳过效果不佳 : {self.stats['skipped_minimal']} 个文件") - - # 显示错误信息 - if self.stats['errors']: - print("\n" + "-" * 70) - print("错误列表") - print("-" * 70) - for error in self.stats['errors'][:5]: # 只显示前5个错误 - print(f" - {error}") - if len(self.stats['errors']) > 5: - print(f" ... 还有 {len(self.stats['errors']) - 5} 个错误") - - # 总结报告 - if self.stats['total_original_size'] > 0 and self.stats['converted'] > 0: - saved_mb = self.stats['total_saved_size'] / (1024 * 1024) - saved_percent = (self.stats['total_saved_size'] / self.stats['total_original_size']) * 100 - - print("\n" + "=" * 70) - print( - f"总结: 成功将 {self.stats['converted']} 个图片转换为 {self.format.upper()} 格式，节省了 {saved_mb:.2f} MB 空间 ({saved_percent:.2f}%)") - else: - print("\n" + "=" * 70) - print(f"总结: 没有成功转换任何图片") - - print("=" * 70) - - def convert_all(self): - """转换所有图片""" - start_time = time.time() # 记录开始时间 - images = self.find_images() - - if not images: - print("没有找到需要转换的图片文件") - return - - if self.dry_run: - print(f"\n[预览模式] 将要转换 {len(images)} 个图片文件:") - for img in images[:10]: # 只显示前10个 - print(f" - {img}") - if len(images) > 10: - print(f" ... 还有 {len(images) - 10} 个文件") - print("\n使用 --execute 参数执行实际转换") - return - - print(f"\n开始转换 {len(images)} 个图片文件...") - - # 单线程处理 - if self.threads <= 1: - for i, image_path in enumerate(images, 1): - print(f"[{i}/{len(images)}] 处理: {image_path.name}") - self.convert_image(image_path) - # 多线程处理 - else: - print(f"使用 {self.threads} 个线程并行处理图片...") - - # 使用tqdm创建进度条 - with tqdm(total=len(images), desc="图片转换进度", unit="个") as pbar: - # 创建线程池 - with concurrent.futures.ThreadPoolExecutor(max_workers=self.threads) as executor: - # 保存所有任务的Future对象 - future_to_path = { - executor.submit(self._convert_thread_worker, image_path): image_path - for image_path in images - } - - # 当任务完成时更新进度条 - for future in concurrent.futures.as_completed(future_to_path): - pbar.update(1) - - def _convert_thread_worker(self, image_path): - """线程工作函数，负责转换单个图片""" - try: - # 获取图片名称，用于日志显示 - image_name = image_path.name - - # 转换图片 - success = self.convert_image(image_path) - - # 由于多线程环境，不在控制台打印信息，所有信息由日志和进度条处理 - return success - except Exception as e: - # 捕获线程中的所有异常 - with self.stats_lock: - error_msg = f"线程处理错误 {image_path}: {str(e)}" - self.logger.error(error_msg) - self.stats['errors'].append(error_msg) - self.stats['failed'] += 1 - return False - - # 记录总处理时间 - end_time = time.time() - self.stats['conversion_time'] = end_time - start_time - - self.print_statistics() - - -def check_dependencies(format): - """检查依赖包""" - global MISSING_PACKAGES - if format == 'avif' and not HAS_AVIF: - print("错误：缺少AVIF支持所需的Python包。") - print("请先安装以下包：") - for package in MISSING_PACKAGES: - print(f" pip install {package}") - print("\n或者使用：") - print(" pip install Pillow pillow-avif") - sys.exit(1) - elif format == 'jxl' and not HAS_JXL: - print("错误：缺少JXL支持所需的Python包。") - print("请先安装以下包：") - for package in MISSING_PACKAGES: - print(f" pip install {package}") - print("\n或者使用：") - print(" pip install Pillow pillow-jpegxl") - sys.exit(1) - - -def main(): - """主函数""" - parser = argparse.ArgumentParser( - description='将图片转换为AVIF或JXL格式，保持原文件名不变', - formatter_class=argparse.RawDescriptionHelpFormatter, - epilog=""" -使用示例: - %(prog)s /path/to/images # 转换目录下所有图片为AVIF（默认） - %(prog)s /path/to/images --format jxl # 转换为JXL格式 - %(prog)s /path/to/images --dry-run # 预览模式 - %(prog)s /path/to/images --quality 90 # 设置质量为90 - %(prog)s /path/to/images --threads 4 # 使用4个线程加速处理 - %(prog)s /path/to/images --no-recursive # 不处理子目录 - %(prog)s /path/to/images --delete-backup # 删除备份文件 - %(prog)s /path/to/images --no-compression-check # 强制转换所有文件 - %(prog)s /path/to/images --min-compression 10 # 设置最小压缩比为10% - %(prog)s /path/to/images --format jxl --effort 5 # JXL格式的编码速度/质量平衡 - %(prog)s /path/to/images --report # 显示详细的转换统计报告 - -注意： -- 转换后的图片仍保持原文件名，MD文件中的链接无需修改 -- 默认启用压缩比检测，只转换能有效压缩的图片 -- 如果转换后体积变大或压缩效果不明显，将自动跳过 -- AVIF和JXL都是现代高效图像格式，支持更高的压缩率 - """ - ) - - parser.add_argument( - 'directory', - help='要处理的目录路径' - ) - - parser.add_argument( - '--format', - type=str, - choices=['avif', 'jxl','webp'], - default='avif', - help='输出格式 (avif,webp 或 jxl, 默认: avif)' - ) - - parser.add_argument( - '--quality', - type=int, - default=80, - metavar='1-100', - help='图像压缩质量 (1-100, 默认: 80)' - ) - - parser.add_argument( - '--dry-run', - action='store_true', - help='预览模式，只显示操作不执行' - ) - - parser.add_argument( - '--no-recursive', - action='store_true', - help='不递归处理子目录' - ) - - parser.add_argument( - '--delete-backup', - action='store_true', - help='转换后删除备份文件（谨慎使用）' - ) - - parser.add_argument( - '--no-compression-check', - action='store_true', - help='禁用压缩比检测，强制转换所有文件' - ) - - parser.add_argument( - '--min-compression', - type=float, - default=5.0, - metavar='PERCENT', - help='最小压缩比百分比，低于此值跳过转换（默认: 5.0%%）' - ) - - parser.add_argument( - '--threads', - type=int, - default=1, - metavar='NUM', - help='使用的线程数（默认: 1）' - ) - - parser.add_argument( - '--report', - action='store_true', - help='显示详细的转换统计报告' - ) - - parser.add_argument( - '--effort', - type=int, - default=7, - choices=range(1, 10), - metavar='1-9', - help='JXL格式的编码速度等级 (1-9, 1最快/质量最低, 9最慢/质量最高, 默认: 7)' - ) - - parser.add_argument( - '--version', - action='version', - version='Image Converter (Keep Name) v1.3' - ) - - args = parser.parse_args() - - # 检查依赖 - check_dependencies(args.format) - - # 验证参数 - if not os.path.exists(args.directory): - print(f"错误: 目录不存在: {args.directory}") - sys.exit(1) - - if not os.path.isdir(args.directory): - print(f"错误: 不是一个目录: {args.directory}") - sys.exit(1) - - if not (1 <= args.quality <= 100): - print("错误: 质量参数必须在1-100之间") - sys.exit(1) - - if not (0 <= args.min_compression <= 100): - print("错误: 最小压缩比必须在0-100之间") - sys.exit(1) - - # 创建转换器实例 - converter = ImageConverter( - directory=args.directory, - format=args.format, - quality=args.quality, - dry_run=args.dry_run, - recursive=not args.no_recursive, - delete_backup=args.delete_backup, - check_compression=not args.no_compression_check, - min_compression_ratio=args.min_compression / 100.0, - threads=args.threads, - effort=args.effort, - show_report=args.report - ) - - # 执行转换 - try: - converter.convert_all() - except KeyboardInterrupt: - print("\n\n用户中断操作") - sys.exit(1) - except Exception as e: - print(f"\n发生错误: {e}") - sys.exit(1) - - -if __name__ == '__main__': - main() diff --git a/docs-about/ad.md b/docs-about/ad.md index f5f7d14be..c6b5d54ac 100644 --- a/docs-about/ad.md +++ b/docs-about/ad.md @@ -5,4 +5,4 @@ title: 广告 # 广告 -广告暂不开启 \ No newline at end of file +广告暂不开启 diff --git a/docs-about/arch.md b/docs-about/arch.md index bf300b3ef..bea904865 100644 --- a/docs-about/arch.md +++ b/docs-about/arch.md @@ -5,8 +5,8 @@ title: 文档框架 # 文档框架 -Cubic-Project 所有文档采用静态页面，主要为 Docusaurus,VitePress,mkdocs +Cubic-Project 所有文档采用静态页面，主要为 Docusaurus, VitePress, MkDocs -其中 `8aka.org` 所有的文档托管在 Cloudflare Page/Worker,`8aka.cn` 托管在 EdgeOne Page，并且进行了备案 +其中 `8aka.org` 所有的文档托管在 Cloudflare Page/Worker, `8aka.cn` 托管在 EdgeOne Page，并且进行了备案 `pvp.kim` 是 Cubic-Project 提供的免费的域名，你可以在 `domain.8aka.org` 上面注册 diff --git a/docs-about/contributors.md b/docs-about/contributors.md index 7483c564d..f56b3039a 100644 --- a/docs-about/contributors.md +++ b/docs-about/contributors.md @@ -7,8 +7,10 @@ import ContributorCard from '@site/src/components/ContributorCard'; # 贡献者名单 -:::tip 项目贡献者 +:::tip[项目贡献者] + 以下列表展示了所有为本项目做出贡献的开发者。我们对每一位贡献者表示衷心的感谢！ + ::: ## 贡献统计 @@ -21,7 +23,7 @@ import ContributorCard from '@site/src/components/ContributorCard'; ## 如何参与贡献 -我们欢迎并鼓励更多的人参与到文档的改进中来！如果你希望为本项目贡献内容，请查阅[贡献指南](https://github.com/Cubic-Project/NitWikit/blob/main/CONTRIBUTING.md)。 +我们欢迎并鼓励更多的人参与到文档的改进中来！如果你希望为本项目贡献内容，请查阅 [贡献指南](https://github.com/Cubic-Project/NitWikit/blob/main/CONTRIBUTING.md)。 参与贡献的方式包括但不限于： @@ -33,24 +35,34 @@ import ContributorCard from '@site/src/components/ContributorCard'; 1. Fork 本仓库到你的 GitHub 账户 2. 克隆你 Fork 的仓库到本地 + ```bash git clone https://github.com/你的用户名/NitWikit.git ``` + 如果你对历史记录没有需求，建议这么克隆 + ```bash git clone https://github.com/你的用户名/NitWikit.git --depth 1 ``` + 3. 创建新的分支 + ```bash git checkout -b feature/your-feature-name ``` + 4. 进行修改并提交 + ```bash git add . git commit -m "描述你的修改" ``` + 5. 推送到你的仓库 + ```bash git push origin feature/your-feature-name ``` + 6. 创建 Pull Request diff --git a/docs-about/intro.md b/docs-about/intro.md index 5a4fa0808..c81bd5433 100644 --- a/docs-about/intro.md +++ b/docs-about/intro.md @@ -9,9 +9,9 @@ title: 关于我们 👋你好！我是 Cubic-Project 团队的建立者与 NitWikit 的核心贡献者 llf ``` -emm Cubic-Project 的建立也确实过于 drama,由于此时,8aka-Team 组织被删除,因此我们需要新建立一个组织 +emm Cubic-Project 的建立也确实过于 drama，由于此时，8aka-Team 组织被删除，因此我们需要新建立一个组织 -Cubic 在群友的建议中被选中,成为了新组织的名字 +Cubic 在群友的建议中被选中，成为了新组织的名字 ## 驿站自述 @@ -36,7 +36,7 @@ Cubic 在群友的建议中被选中,成为了新组织的名字 但是“教程指北”之类的创意早被人使用过了，那段时间“笨蛋”一词有点成为口头禅， 再加上这个教程本来就是写给新手的，我就叫它笨蛋文档了，雪萌起了英文版名字 NitWikit -MC 里傻子村民的英文就是 nitwit，后缀又和 wiki 相近，所以组合成了 Nitwikit +MC 里傻子村民的英文就是 nitwit，后缀又和 Wiki 相近，所以组合成了 Nitwikit #### 发展历程？ @@ -46,7 +46,7 @@ MC 里傻子村民的英文就是 nitwit，后缀又和 wiki 相近，所以组 又想到从前想写的开服教程，最终我决定编写一个从未有人做过的，详细无比的开服教程。 一开始我只是拉着人才（他写反作弊部分）编写笨蛋文档，部署在 GitHub pages，然后 lilingfeng 和小杰自己跑来问我能不能参与维护， -以及一些路人像是 gyc123456-1 来给我 pr，后面还有 lim114514 在我不知情的情况下帮我买好 yizhan.wiki 这个域名，雪萌帮我想英文名字， +以及一些路人像是 gyc123456-1 来给我 PR，后面还有 lim114514 在我不知情的情况下帮我买好 yizhan.wiki 这个域名，雪萌帮我想英文名字， 画群头像，banner 图，MineBBS 宣传图，小涵想写 Bedrock 内容给文档拆成三块，突然冒出个糯米团子搞出个 VitePress 版文档， 有那么几个我不认识的人和我认识的三七为笨蛋文档录制视频，千屈帮助编写了好多好多内容，修了好多 bug，甚至重写文档整个界面等等。 不知不觉就有了六十多个贡献者，如果算上 GitHub 之外提供建议和帮助的人，远比这个数字要多。 diff --git a/docs-bedrock/bds-core/start/basic/server-file-structure.md b/docs-bedrock/bds-core/start/basic/server-file-structure.md deleted file mode 100644 index db63ee774..000000000 --- a/docs-bedrock/bds-core/start/basic/server-file-structure.md +++ /dev/null @@ -1,183 +0,0 @@ ---- -title: 服务端结构 -sidebar_position: 1 ---- - -# 服务端结构 - -我们先来简单看一眼 BDS **开服后** 的文件夹结构： - -```c -BDS服务端文件夹 -├─behavior_packs // 安装新行为包的文件夹 -├─config // 没啥用 -├─definitions // 貌似是生成群系的内容 -├─development_behavior_packs // 为开发者提供安装新行为包的文件夹 -├─development_resource_packs // 为开发者提供安装新资源包的文件夹 -├─development_skin_packs // 为开发者提供安装新皮肤包的文件夹 -├─resource_packs // 安装新资源包的文件夹 -├─world-templates // 世界模板 -├─worlds // 主世界文件夹 -│ └─Bedrock level // 世界存档 -│ ├─db // 存档数据文件夹 -│ ├─level_dat // 存档设定 -│ ├─level.dat_old // 存档设定 (旧) -│ └─level_name.txt // 存档名称 -├─allowlist.json // 白名单文件 -├─bedrock_server.exe // 服务端启动程序 -├─bedrock_server.pdb // 程序数据库文件 -├─bedrock_server_how_to.html // 如何使用 BDS 服务器的官方指南 (没多大用处，看看就行) -├─permissions.json // 管理员 (OP) 玩家相关数据 -├─release-notes.txt // 服务端发行版本详情 -├─server.properties // 配置文件 -└─valid_known_packs.json // 已知的附加包 -``` - - - -## 根目录下的一些文件 - -:::warning -请不要让你的服务端结构与文档解说结构有任何的 **缺少**，否则可能会出现 **玄学问题** - -若你 **一致认为** 有可删之处，那么以下是 **绝对可以删** 的服务端结构 (反正每次开服都会检测是否有这些文件夹，如果没有还是会创建的) - -
- 点击展开 - -- `config` -- development_behavior_packs -- development_resource_packs -- development_skin_packs -- world-templates -- bedrock_server_how_to.html(这个不会自己创建) -- release-notes.txt(这个不会自己创建) -- valid_known_packs.json - -
-::: - ---- - -- `behavior_packs` - - 用于安装新的行为包。行为包可以改变游戏中的某些行为，例如，它们可以修改怪物行为、游戏规则或添加新的游戏机制。 - - BUT! 没啥用...后续也不会涉及... - ---- - -- `config` - - 这个文件夹通常用于存储服务器的配置文件。 - - BUT! 没啥用...后续也不会涉及... - ---- - -- `definitions` - - 这个文件夹包含定义文件，这些文件通常用于定义游戏中的群系、结构、生物生成等信息。它们决定了世界中不同区域的特性和外观。 - - BUT! 没啥用...后续也不会涉及... - ---- - -- `development_behavior_packs` - - 为开发者提供安装新行为包的文件夹。这允许开发者测试和开发自定义的行为包，而不会影响到主服务器的行为包。 - - BUT! 没啥用...后续也不会涉及... - ---- - -- `development_resource_packs` - - 为开发者提供安装新资源包的文件夹。开发者可以在这里添加、测试和开发自定义的资源包，如纹理、模型和音效等。 - - BUT! 没啥用...后续也不会涉及... - ---- - -- `development_skin_packs` - - 为开发者提供安装新皮肤包的文件夹。开发者可以在这里添加和测试自定义的玩家皮肤和其他角色的外观。 - - BUT! 没啥用...后续也不会涉及... - ---- - -- `resource_packs` - - 用于安装新的资源包。资源包可以改变游戏中的视觉和声音元素，例如，它们可以提供新的纹理、音效和模型。 - - BUT! 没啥用...后续也不会涉及... - ---- - -- `world-templates` - - 包含世界模板，这些模板可以被用来快速创建具有特定设置和结构的新世界。 - - 有点用，但不多。 - ---- - -- `worlds` - - 这是存储主世界文件夹的地方。每个世界都有自己的子文件夹，其中包含该世界的所有数据，如地形、建筑、玩家进度等。 - - `Bedrock level` - - 包含特定世界的存档数据。 - - `db` - - 存档数据文件夹，通常包含有关世界的数据库文件。 - - `level_dat` - - 包含世界的基本设置和属性，如游戏规则、时间、天气等。 - - `level.dat_old` - - 旧版的存档设定文件，通常在更新或备份时使用。 - - `level_name.txt` - - 包含世界名称的文件。 - ---- - -- `allowlist.json` - - 白名单文件，列出了允许进入服务器的玩家列表。 - - (如果你在 `server.properties` 中开启了白名单，你就可以在该文件中添加和管理谁被允许或不被允许进入服务器)。 - ---- - -- `bedrock_server.exe` - - 服务端启动程序，用于启动和运行《我的世界》基岩版服务器。 - - - 你可以改名叫任何名字 (只要以 `.exe` 结尾就行)，但不建议你这么做，可能会导致成为后续操作报错的因素。例如： - 1. 若你使用 **面板** 开服，需要在对应的 **启动路径** 中修改服务端启动程序的文件名 - 2. 若你使用 **启用脚本** 开服，需要在脚本对应位置的 **启动命令** 中修改 **启动程序的文件名** 为 **该服务端启动程序的文件名**(bedrock_server.exe) - ---- - -- `bedrock_server.pdb` - - 程序数据库文件，通常用于调试和错误分析。 - ---- - -- `bedrock_server_how_to.html` - - 如何使用 BDS 服务器的官方指南，虽然你说“没多大用处”，但它可能包含有关配置和运行服务器的有用信息。 - - 有点用，但不多 - ---- - -- `permissions.json` - - 管理员 (OP) 玩家相关数据 (如 UUID 及游戏名称等相关信息)，包括权限设置和角色定义。 - ---- - -- `release-notes.txt` - - 服务端发行版本详情，包含了每个版本更新的日志和更改内容。 - - BUT! 没啥用...后续也不会涉及... - ---- - -- `server.properties` - - 服务器配置文件，用于调整各种服务器设置，如设置端口，设置游戏难度，设置游戏模式 (生存、创造等) 等。 - ---- - -- `valid_known_packs.json` - - 包含已知的附加包列表，这些包可能包括行为包、资源包等，服务器会根据这个列表来验证安装的包。 - - 有点用，但不多。 - ---- - -至此，大部分的以 BDS 为基础的服务器核心服务端的结构已经大致呈现在你眼前。 - -:::tip - -如果你的服务端有更多的文件，大概率是 [**插件加载器** / **插件**](../../process/plugins/plugins-loader-choose.md)(如针对 BDS 的 Levilamina 插件加载器会释放更多文件夹) 创建的文件夹，一般来说无需担心。 - -::: diff --git a/docs-bedrock/bds-core/bds-core.md b/docs-bedrock/bds/bds.md similarity index 100% rename from docs-bedrock/bds-core/bds-core.md rename to docs-bedrock/bds/bds.md diff --git a/docs-bedrock/bds-core/preparation/preparation.md b/docs-bedrock/bds/preparation/preparation.md similarity index 100% rename from docs-bedrock/bds-core/preparation/preparation.md rename to docs-bedrock/bds/preparation/preparation.md diff --git a/docs-bedrock/bds-core/preparation/text-editor.md b/docs-bedrock/bds/preparation/text-editor.md similarity index 100% rename from docs-bedrock/bds-core/preparation/text-editor.md rename to docs-bedrock/bds/preparation/text-editor.md diff --git a/docs-bedrock/bds-core/preparation/vcruntime.md b/docs-bedrock/bds/preparation/vcruntime.md similarity index 77% rename from docs-bedrock/bds-core/preparation/vcruntime.md rename to docs-bedrock/bds/preparation/vcruntime.md index fe4bb7079..cbff5b38b 100644 --- a/docs-bedrock/bds-core/preparation/vcruntime.md +++ b/docs-bedrock/bds/preparation/vcruntime.md @@ -5,11 +5,11 @@ sidebar_position: 3 # Visual C++ 运行库 -我的世界基岩版由于使用微软开发的 Visual C++ 编写，需要依赖 Visual C++ 运行库 (vc 运行库) 才能正常运行。在玩家的电脑上，由于 Windows 系统会自动为游戏补全这些运行库，所以玩家下载好基岩版之后就可以直接开始游戏。 +我的世界基岩版由于使用微软开发的 Visual C++ 编写，需要依赖 Visual C++ 运行库 (VC 运行库) 才能正常运行。在玩家的电脑上，由于 Windows 系统会自动为游戏补全这些运行库，所以玩家下载好基岩版之后就可以直接开始游戏。 -但是在基岩版的服务器软件 BDS 这边情况就有所不同了。BDS 只是一个可执行文件，它并不具备自己补全 vc 运行库的功能，需要手动进行安装，否则就会报错“缺少 vmruntimexxx.dll”。 +但是在基岩版的服务器软件 BDS 这边情况就有所不同了。BDS 只是一个可执行文件，它并不具备自己补全 VC 运行库的功能，需要手动进行安装，否则就会报错“缺少 vmruntimexxx.dll”。 你需要为服务器安装至少 [Visual C++ Redistributable for Visual Studio 2015-2022](https://aka.ms/vs/17/release/vc_redist.x64.exe) 这个运行库才行。 有时一些辅助软件也会依赖这个运行库，例如 LeviLamina 在缺少运行库时会报错“Error code: 1114 动态裢接库 (DLL) 初始化例程失败。”，安装这个运行库也可以解决问题。 -你也可以使用[常用 VC 运行库合集](https://cloud.wujiyan.cc/f/D0DIW/MSVBCRT.AIO.2024.08.16.exe)来快速安装 +你也可以使用 [常用 VC 运行库合集](https://cloud.wujiyan.cc/f/D0DIW/MSVBCRT.AIO.2024.08.16.exe) 来快速安装 diff --git a/docs-bedrock/bds-core/preparation/websites.md b/docs-bedrock/bds/preparation/websites.md similarity index 91% rename from docs-bedrock/bds-core/preparation/websites.md rename to docs-bedrock/bds/preparation/websites.md index 58d4cca2d..7acc28784 100644 --- a/docs-bedrock/bds-core/preparation/websites.md +++ b/docs-bedrock/bds/preparation/websites.md @@ -56,7 +56,7 @@ sidebar_label: BDS 可能用到的网站 ## GitHub -全球最大的代码托管平台 **_建议注册账号_**。 +全球最大的代码托管平台 ***建议注册账号***。
点击展开 @@ -89,13 +89,13 @@ sidebar_label: BDS 可能用到的网站
连不上怎么办 -这是由于 GitHub 是开放的外国网站，网站上时不时会有一些不能在此讨论的内容，所以运营商会刻意地屏蔽这个网站，在很多时候都不能正常访问。具体的表现如下：[只要 Github 域名指向任意 IP，该 IP 的 443 端口就会超时 3 分钟](https://blog.csdn.net/weixin_43659597/article/details/118882176)。 +这是由于 GitHub 是开放的外国网站，网站上时不时会有一些不能在此讨论的内容，所以运营商会刻意地屏蔽这个网站，在很多时候都不能正常访问。具体的表现如下：[只要 GitHub 域名指向任意 IP，该 IP 的 443 端口就会超时 3 分钟](https://blog.csdn.net/weixin_43659597/article/details/118882176)。 有以下几种解决办法： 1. 魔法 2. [改 hosts](https://www.cnblogs.com/eudaimonia/p/16001981.html#1034247326) -3. [Watt Toolkit](https://steampp.net/)：下载安装完成后，在左侧侧边栏切换到**网络加速**，点击**平台加速 (免费)**，往下翻勾上 GitHub，然后点击**一键加速**，随后就可以正常访问 GitHub 了 +3. [Watt Toolkit](https://steampp.net/)：下载安装完成后，在左侧侧边栏切换到 **网络加速**，点击 **平台加速 (免费)**，往下翻勾上 GitHub，然后点击 **一键加速**，随后就可以正常访问 GitHub 了
diff --git a/docs-bedrock/bds-core/process/BDSX/bdsx-install.md b/docs-bedrock/bds/process/bdsx/bdsx-install.md similarity index 61% rename from docs-bedrock/bds-core/process/BDSX/bdsx-install.md rename to docs-bedrock/bds/process/bdsx/bdsx-install.md index 8921ed6af..d4a08e57f 100644 --- a/docs-bedrock/bds-core/process/BDSX/bdsx-install.md +++ b/docs-bedrock/bds/process/bdsx/bdsx-install.md @@ -9,27 +9,27 @@ sidebar_position: 1 你需要在电脑上准备： -- 最新版[node.js](https://nodejs.org/zh-cn) -- [VSCode](https://code.visualstudio.com/)编辑器 -- 可选：[git](https://git-scm.com/download) +- 最新版 [Node.js](https://nodejs.org/zh-cn) +- [VS Code](https://code.visualstudio.com/) 编辑器 +- 可选：[Git](https://git-scm.com/download) 当前教程假设操作环境：Windows ## 方法一：直接下载启动 -前往 BDSX 开源仓库：[Github](https://github.com/bdsx/bdsx) +前往 BDSX 开源仓库：[GitHub](https://github.com/bdsx/bdsx) -1.如果未安装 git，请点击 `<>code` 按钮然后在显示的菜单中点击 `Download ZIP` 下载已经用 zip 打包好的源代码文件； +1.如果未安装 Git，请点击 `<>code` 按钮然后在显示的菜单中点击 `Download ZIP` 下载已经用 zip 打包好的源代码文件； -2.如果安装了 git，请使用 `cmd` cd 到一个空白文件夹后使用以下指令安装。 +2.如果安装了 Git，请使用 `cmd` cd 到一个空白文件夹后使用以下指令安装。 -```shell +```bash git clone https://github.com/bdsx/bdsx.git ``` -然后安装最新版 [node.js](https://nodejs.org/zh-cn)，安装完后打开 `cmd` 使用该指令检测是否成功安装：`npm -version` +然后安装最新版 [Node.js](https://nodejs.org/zh-cn)，安装完后打开 `cmd` 使用该指令检测是否成功安装：`npm -version` -显示以下内容即代表安装成功 (本人当前安装 node.js 版本为 10.8.1)： +显示以下内容即代表安装成功 (本人当前安装 Node.js 版本为 10.8.1)： ```text 10.8.1 @@ -41,19 +41,21 @@ git clone https://github.com/bdsx/bdsx.git 需要开服也是右键 `bdsx.bat` 使用管理员权限运行即可 -## 方法二：使用 VSCode 调试与运行 +## 方法二：使用 VS Code 调试与运行 :::danger + 该方案极其不建议，可能会出现很多离谱问题！ -如果你想尝试使用该方案，请联系 BDSX 的 Discore 频道相关开发者并在他们的指导下进行！ +如果你想尝试使用该方案，请联系 BDSX 的 Discord 频道相关开发者并在他们的指导下进行！ + ::: 下载源代码方法请详见 **方法一** -如果需要使用 VSCode 启动 BDSX，您需要 +如果需要使用 VS Code 启动 BDSX，您需要 -1. 使用 VSCode 打开此项目 +1. 使用 VS Code 打开此项目 2. 安装 Node Debug (legacy)。您可以在右下方看到建议通知框。 -3. 打开终端（Ctrl+Shift+｀） +3. 打开终端（Ctrl + Shift + ｀） 4. 运行 `npm i` 来安装 NPM 包与 BDS 5. 按下 `F5` 以构建并运行 diff --git a/docs-bedrock/bds-core/process/BDSX/bdsx.md b/docs-bedrock/bds/process/bdsx/bdsx.md similarity index 84% rename from docs-bedrock/bds-core/process/BDSX/bdsx.md rename to docs-bedrock/bds/process/bdsx/bdsx.md index 7e0643438..b9daf5094 100644 --- a/docs-bedrock/bds-core/process/BDSX/bdsx.md +++ b/docs-bedrock/bds/process/bdsx/bdsx.md @@ -5,7 +5,7 @@ sidebar_position: 3 # BDSX -BDSX 是一个支持 node.js 的 Minecraft 基岩版专用服务器（BDS）修改版本。基于官方 BDS 实现，包含了原版 Minecraft 的所有特性，并支持 Hook 函数与网络数据包以添加或修改服务器的功能与表现。 +BDSX 是一个支持 Node.js 的 Minecraft 基岩版专用服务器（BDS）修改版本。基于官方 BDS 实现，包含了原版 Minecraft 的所有特性，并支持 Hook 函数与网络数据包以添加或修改服务器的功能与表现。 以下内容为 BDSX 的配置教程 diff --git a/docs-bedrock/bds-core/process/EndStone/imgs/1-1.png b/docs-bedrock/bds/process/endstone/_images/1-1.png similarity index 100% rename from docs-bedrock/bds-core/process/EndStone/imgs/1-1.png rename to docs-bedrock/bds/process/endstone/_images/1-1.png diff --git a/docs-bedrock/bds-core/process/EndStone/imgs/1-2.png b/docs-bedrock/bds/process/endstone/_images/1-2.png similarity index 100% rename from docs-bedrock/bds-core/process/EndStone/imgs/1-2.png rename to docs-bedrock/bds/process/endstone/_images/1-2.png diff --git a/docs-bedrock/bds-core/process/EndStone/imgs/1-3.png b/docs-bedrock/bds/process/endstone/_images/1-3.png similarity index 100% rename from docs-bedrock/bds-core/process/EndStone/imgs/1-3.png rename to docs-bedrock/bds/process/endstone/_images/1-3.png diff --git a/docs-bedrock/bds-core/process/EndStone/imgs/1-4.png b/docs-bedrock/bds/process/endstone/_images/1-4.png similarity index 100% rename from docs-bedrock/bds-core/process/EndStone/imgs/1-4.png rename to docs-bedrock/bds/process/endstone/_images/1-4.png diff --git a/docs-bedrock/bds-core/process/EndStone/imgs/1-5.png b/docs-bedrock/bds/process/endstone/_images/1-5.png similarity index 100% rename from docs-bedrock/bds-core/process/EndStone/imgs/1-5.png rename to docs-bedrock/bds/process/endstone/_images/1-5.png diff --git a/docs-bedrock/bds-core/process/EndStone/imgs/1-6.png b/docs-bedrock/bds/process/endstone/_images/1-6.png similarity index 100% rename from docs-bedrock/bds-core/process/EndStone/imgs/1-6.png rename to docs-bedrock/bds/process/endstone/_images/1-6.png diff --git a/docs-bedrock/bds-core/process/EndStone/imgs/1-7.png b/docs-bedrock/bds/process/endstone/_images/1-7.png similarity index 100% rename from docs-bedrock/bds-core/process/EndStone/imgs/1-7.png rename to docs-bedrock/bds/process/endstone/_images/1-7.png diff --git a/docs-bedrock/bds-core/process/EndStone/imgs/1-8.png b/docs-bedrock/bds/process/endstone/_images/1-8.png similarity index 100% rename from docs-bedrock/bds-core/process/EndStone/imgs/1-8.png rename to docs-bedrock/bds/process/endstone/_images/1-8.png diff --git a/docs-bedrock/bds-core/process/EndStone/imgs/1-9.png b/docs-bedrock/bds/process/endstone/_images/1-9.png similarity index 100% rename from docs-bedrock/bds-core/process/EndStone/imgs/1-9.png rename to docs-bedrock/bds/process/endstone/_images/1-9.png diff --git a/docs-bedrock/bds-core/process/EndStone/imgs/1.png b/docs-bedrock/bds/process/endstone/_images/1.png similarity index 100% rename from docs-bedrock/bds-core/process/EndStone/imgs/1.png rename to docs-bedrock/bds/process/endstone/_images/1.png diff --git a/docs-bedrock/bds-core/process/EndStone/imgs/10.png b/docs-bedrock/bds/process/endstone/_images/10.png similarity index 100% rename from docs-bedrock/bds-core/process/EndStone/imgs/10.png rename to docs-bedrock/bds/process/endstone/_images/10.png diff --git a/docs-bedrock/bds-core/process/EndStone/imgs/2-1.png b/docs-bedrock/bds/process/endstone/_images/2-1.png similarity index 100% rename from docs-bedrock/bds-core/process/EndStone/imgs/2-1.png rename to docs-bedrock/bds/process/endstone/_images/2-1.png diff --git a/docs-bedrock/bds-core/process/EndStone/imgs/2-10.png b/docs-bedrock/bds/process/endstone/_images/2-10.png similarity index 100% rename from docs-bedrock/bds-core/process/EndStone/imgs/2-10.png rename to docs-bedrock/bds/process/endstone/_images/2-10.png diff --git a/docs-bedrock/bds-core/process/EndStone/imgs/2-11.png b/docs-bedrock/bds/process/endstone/_images/2-11.png similarity index 100% rename from docs-bedrock/bds-core/process/EndStone/imgs/2-11.png rename to docs-bedrock/bds/process/endstone/_images/2-11.png diff --git a/docs-bedrock/bds-core/process/EndStone/imgs/2-2.png b/docs-bedrock/bds/process/endstone/_images/2-2.png similarity index 100% rename from docs-bedrock/bds-core/process/EndStone/imgs/2-2.png rename to docs-bedrock/bds/process/endstone/_images/2-2.png diff --git a/docs-bedrock/bds-core/process/EndStone/imgs/2-3.png b/docs-bedrock/bds/process/endstone/_images/2-3.png similarity index 100% rename from docs-bedrock/bds-core/process/EndStone/imgs/2-3.png rename to docs-bedrock/bds/process/endstone/_images/2-3.png diff --git a/docs-bedrock/bds-core/process/EndStone/imgs/2-4.png b/docs-bedrock/bds/process/endstone/_images/2-4.png similarity index 100% rename from docs-bedrock/bds-core/process/EndStone/imgs/2-4.png rename to docs-bedrock/bds/process/endstone/_images/2-4.png diff --git a/docs-bedrock/bds-core/process/EndStone/imgs/2-5.png b/docs-bedrock/bds/process/endstone/_images/2-5.png similarity index 100% rename from docs-bedrock/bds-core/process/EndStone/imgs/2-5.png rename to docs-bedrock/bds/process/endstone/_images/2-5.png diff --git a/docs-bedrock/bds-core/process/EndStone/imgs/2-6.png b/docs-bedrock/bds/process/endstone/_images/2-6.png similarity index 100% rename from docs-bedrock/bds-core/process/EndStone/imgs/2-6.png rename to docs-bedrock/bds/process/endstone/_images/2-6.png diff --git a/docs-bedrock/bds-core/process/EndStone/imgs/2-7.png b/docs-bedrock/bds/process/endstone/_images/2-7.png similarity index 100% rename from docs-bedrock/bds-core/process/EndStone/imgs/2-7.png rename to docs-bedrock/bds/process/endstone/_images/2-7.png diff --git a/docs-bedrock/bds-core/process/EndStone/imgs/2-8.png b/docs-bedrock/bds/process/endstone/_images/2-8.png similarity index 100% rename from docs-bedrock/bds-core/process/EndStone/imgs/2-8.png rename to docs-bedrock/bds/process/endstone/_images/2-8.png diff --git a/docs-bedrock/bds-core/process/EndStone/imgs/2-9.png b/docs-bedrock/bds/process/endstone/_images/2-9.png similarity index 100% rename from docs-bedrock/bds-core/process/EndStone/imgs/2-9.png rename to docs-bedrock/bds/process/endstone/_images/2-9.png diff --git a/docs-bedrock/bds-core/process/EndStone/imgs/2.png b/docs-bedrock/bds/process/endstone/_images/2.png similarity index 100% rename from docs-bedrock/bds-core/process/EndStone/imgs/2.png rename to docs-bedrock/bds/process/endstone/_images/2.png diff --git a/docs-bedrock/bds-core/process/EndStone/imgs/3.png b/docs-bedrock/bds/process/endstone/_images/3.png similarity index 100% rename from docs-bedrock/bds-core/process/EndStone/imgs/3.png rename to docs-bedrock/bds/process/endstone/_images/3.png diff --git a/docs-bedrock/bds-core/process/EndStone/imgs/4.png b/docs-bedrock/bds/process/endstone/_images/4.png similarity index 100% rename from docs-bedrock/bds-core/process/EndStone/imgs/4.png rename to docs-bedrock/bds/process/endstone/_images/4.png diff --git a/docs-bedrock/bds-core/process/EndStone/imgs/5.png b/docs-bedrock/bds/process/endstone/_images/5.png similarity index 100% rename from docs-bedrock/bds-core/process/EndStone/imgs/5.png rename to docs-bedrock/bds/process/endstone/_images/5.png diff --git a/docs-bedrock/bds-core/process/EndStone/imgs/6.png b/docs-bedrock/bds/process/endstone/_images/6.png similarity index 100% rename from docs-bedrock/bds-core/process/EndStone/imgs/6.png rename to docs-bedrock/bds/process/endstone/_images/6.png diff --git a/docs-bedrock/bds-core/process/EndStone/imgs/7.png b/docs-bedrock/bds/process/endstone/_images/7.png similarity index 100% rename from docs-bedrock/bds-core/process/EndStone/imgs/7.png rename to docs-bedrock/bds/process/endstone/_images/7.png diff --git a/docs-bedrock/bds-core/process/EndStone/imgs/8.png b/docs-bedrock/bds/process/endstone/_images/8.png similarity index 100% rename from docs-bedrock/bds-core/process/EndStone/imgs/8.png rename to docs-bedrock/bds/process/endstone/_images/8.png diff --git a/docs-bedrock/bds-core/process/EndStone/imgs/9.png b/docs-bedrock/bds/process/endstone/_images/9.png similarity index 100% rename from docs-bedrock/bds-core/process/EndStone/imgs/9.png rename to docs-bedrock/bds/process/endstone/_images/9.png diff --git a/docs-bedrock/bds-core/process/EndStone/EndStone-install.md b/docs-bedrock/bds/process/endstone/endstone-install.md similarity index 78% rename from docs-bedrock/bds-core/process/EndStone/EndStone-install.md rename to docs-bedrock/bds/process/endstone/endstone-install.md index 03fab195c..7a6c2cc49 100644 --- a/docs-bedrock/bds-core/process/EndStone/EndStone-install.md +++ b/docs-bedrock/bds/process/endstone/endstone-install.md @@ -11,12 +11,12 @@ sidebar_position: 1 Windows 环境下： -- [VSCode](https://code.visualstudio.com/)编辑器 -- 可选：最新版[Python 3.12+ 环境](https://python.org) +- [VS Code](https://code.visualstudio.com/) 编辑器 +- 可选：最新版 [Python 3.12+ 环境](https://python.org) Linux 环境下： -- 最新版[Python 3.12+ 环境](https://python.org) 或者 最新版[Docker 环境](https://hub.docker.com/r/endstone/endstone/) +- 最新版 [Python 3.12+ 环境](https://python.org) 或者 最新版 [Docker 环境](https://hub.docker.com/r/endstone/endstone/) ## 方法一：直接下载启动 @@ -26,33 +26,33 @@ Linux 环境下： ### 一、下载 EndStone 本体 -前往 EndStone 开源仓库：[Github](https://github.com/EndstoneMC/endstone)，找到 Releases，打开后下载压缩包 +前往 EndStone 开源仓库：[GitHub](https://github.com/EndstoneMC/endstone)，找到 Releases，打开后下载压缩包 -![1](./imgs/1.png) +![1](./_images/1.png) -![2](./imgs/2.png) +![2](./_images/2.png) 将下载好的压缩包放到新建的文件夹内，或者上传到服务器上的新建好的文件夹内 -![3](./imgs/3.png) +![3](./_images/3.png) 解压后获得 EndStone 本体 -![4](./imgs/4.png) +![4](./_images/4.png) ### 二、下载 BDS 服务端 启动 start.bat，获得该版本的 EndStone 支持的 BDS 服务端版本 -![5](./imgs/5.png) +![5](./_images/5.png) 目前已知该版本的 EndStone 支持对接 1.21.41 版本 关闭界面，前往 [EndStone API](https://raw.githubusercontent.com/EndstoneMC/bedrock-server-data/main/bedrock_server_data.json) 找到相应版本的下载地址 -复制相应的 url 后的下载链接，直接粘贴到新窗口的 web 地址栏回车下载 BDS 服务端压缩包 +复制相应的 URL 后的下载链接，直接粘贴到新窗口的 web 地址栏回车下载 BDS 服务端压缩包 -![6](./imgs/6.png) +![6](./_images/6.png) 将下载后的服务端 zip 压缩包放入 EndStone 文件夹内 @@ -60,15 +60,15 @@ Linux 环境下： 创建 bedrock_server 文件夹 -![7](./imgs/7.png) +![7](./_images/7.png) 将 BDS 服务端 zip 压缩包解压到 bedrock_server 文件夹 然后，创建 `version.txt` 文件，打开并编辑以下内容，编辑完毕后保存 -![8](./imgs/8.png) +![8](./_images/8.png) -![9](./imgs/9.png) +![9](./_images/9.png) ### 四、启动服务器 @@ -76,7 +76,7 @@ Linux 环境下： 启动成功后会显示下面内容 -![10](./imgs/10.png) +![10](./_images/10.png) 恭喜你！你已经成功开启了可以支持插件的基岩版服务器！赶紧体验一下吧~ @@ -91,26 +91,28 @@ Linux 环境下： 前往 [Python 官网](https://python.org) 下载 Python 环境 :::info -Linux 请按照 [这个教程](https://blog.csdn.net/hd243608836/article/details/121417965) 或者必应搜索 **Python Linux 安装** 完成安装 python 最新版，_安装完毕请看第二步_ + +Linux 请按照 [这个教程](https://blog.csdn.net/hd243608836/article/details/121417965) 或者必应搜索 **Python Linux 安装** 完成安装 python 最新版，*安装完毕请看第二步* + ::: 运行 Python 安装包程序进行安装： -![101](./imgs/1-1.png) +![101](./_images/1-1.png) -![102](./imgs/1-2.png) +![102](./_images/1-2.png) -![103](./imgs/1-3.png) +![103](./_images/1-3.png) -安装完成后，打开 CMD（按住 `WIN + R` 打开后输入 `cmd` 回车），输入以下指令检测 python 是否正常安装 +安装完成后，打开 CMD（按住 `WIN + R` 打开后输入 `cmd` 回车），输入以下指令检测 Python 是否正常安装 -```cmd +```bash python ``` 安装好 CMD 会这么显示： -![104](./imgs/1-4.png) +![104](./_images/1-4.png) ### 二、安装 EndStone 本体 @@ -119,46 +121,50 @@ python 如果在 C 盘，请输入 `cd 替换具体文件夹路径` :::danger + **不建议将服务端放在 C 盘！** + ::: 如果在 D 盘，请按照下图操作进行（**Linux 一类系统可直接使用 `cd 文件夹路径` 进入相应目录**） -![105](./imgs/1-5.png) +![105](./_images/1-5.png) 输入下面指令安装 EndStone 本体 (Python 默认的下载会比较慢，如果想加快下载速度推荐必应搜索 **Python 换国内下载源** 配置，本教程不再过多阐述) -```cmd +```bash pip install endstone ``` 下载完后应该是这样的 -![106](./imgs/1-6.png) +![106](./_images/1-6.png) ### 三、安装 VC 运行库 前往 [Microsoft VC 运行库下载地址](https://www.microsoft.com/zh-CN/download/details.aspx?id=48145) 下载并安装 **VC 运行库** :::tip + 你可能注意到了，直接运行版本是可以直接运行的，貌似这一步被省略过去了 -实际上并不是，只是直接运行版本自带了 python 环境和 VC 运行库，一般情况下运行 EndStone 的 start.bat 是不会出现任何问题（**除非你作死把那个删了，但会有人去删掉它吗🤔**） +实际上并不是，只是直接运行版本自带了 Python 环境和 VC 运行库，一般情况下运行 EndStone 的 start.bat 是不会出现任何问题（**除非你作死把那个删了，但会有人去删掉它吗🤔**） + ::: ### 四、下载 BDS 服务端 CMD 控制台输入 `endstone` ，获得该版本的 EndStone 支持的 BDS 服务端版本 -![107](./imgs/1-7.png) +![107](./_images/1-7.png) 通过上图可知，目前该版本的 EndStone 支持对接 1.21.41 版本 关闭界面，前往 [EndStone API](https://raw.githubusercontent.com/EndstoneMC/bedrock-server-data/main/bedrock_server_data.json) -找到相应版本的下载地址，复制 url 后的下载链接，直接粘贴到新窗口的 web 地址栏回车下载 BDS 服务端压缩包 +找到相应版本的下载地址，复制 URL 后的下载链接，直接粘贴到新窗口的 web 地址栏回车下载 BDS 服务端压缩包 -![6](./imgs/6.png) +![6](./_images/6.png) 将下载后的服务端 zip 压缩包放入 EndStone 文件夹内 @@ -166,15 +172,15 @@ CMD 控制台输入 `endstone` ，获得该版本的 EndStone 支持的 BDS 服 创建 bedrock_server 文件夹 -![108](./imgs/1-8.png) +![108](./_images/1-8.png) 将 BDS 服务端 zip 压缩包解压到 bedrock_server 文件夹 然后，创建 `version.txt` 文件，打开并编辑以下内容，编辑完毕后保存 -![8](./imgs/8.png) +![8](./_images/8.png) -![9](./imgs/9.png) +![9](./_images/9.png) ### 六、启动服务器 @@ -182,16 +188,18 @@ CMD 控制台输入 `endstone` ，获得该版本的 EndStone 支持的 BDS 服 启动成功后会显示下面内容 -![109](./imgs/1-9.png) +![109](./_images/1-9.png) 恭喜你！你已经成功开启了可以支持插件的基岩版服务器！赶紧体验一下吧~ ## 方法三、使用 Docker 安装并运行 EndStone（目前不推荐） :::danger + 该方案教程大部分操作情况未知，外加 Docker 官方源因 DNS 污染等攻击 被国内防火墙拦截，目前不推荐 请等待教程作者的更新 + ::: 适用系统：Linux diff --git a/docs-bedrock/bds-core/process/EndStone/EndStone-plugins.md b/docs-bedrock/bds/process/endstone/endstone-plugins.md similarity index 69% rename from docs-bedrock/bds-core/process/EndStone/EndStone-plugins.md rename to docs-bedrock/bds/process/endstone/endstone-plugins.md index e81bfb6d5..4e3448e86 100644 --- a/docs-bedrock/bds-core/process/EndStone/EndStone-plugins.md +++ b/docs-bedrock/bds/process/endstone/endstone-plugins.md @@ -9,15 +9,15 @@ sidebar_position: 1 ### [MineBBS 论坛](https://www.minebbs.com/resources/categories/bdserver.38/)（发展国内基岩版社区的你敢说没有？） -![201](./imgs/2-1.png) +![201](./_images/2-1.png) ### [pip 源](https://pypi.org/search/?q=endstone) （EndStone 绝大多数插件都在这里发布了） -![202](./imgs/2-2.png) +![202](./_images/2-2.png) ### [Bedrinth 下载站](https://bedrinth.com/?platform=endstone) （除了 pip 外另一个比较知名的下载源，网速较慢，不太推荐） -![203](./imgs/2-3.png) +![203](./_images/2-3.png) ## 第二步、如何安装？ @@ -26,10 +26,13 @@ sidebar_position: 1 如果你在 MineBBS 上下载，或者其他人给你的一个 EndStone 插件，请看这里 :::tip -EndStone 的插件一般文件是以 .whl 或者 .dll 为后缀的文件，有的插件作者为了易于分发或者安装插件会将上述内容和配置文件一起弄成压缩文件 + +EndStone 的插件一般文件是以 `.whl` 或者 `.dll` 为后缀的文件，有的插件作者为了易于分发或者安装插件会将上述内容和配置文件一起弄成压缩文件 + ::: :::info + 附带：什么是 whl 文件： whl 格式本质上是一个压缩包，里面包含了 py 文件，以及经过编译的 pyd 文件。 @@ -38,10 +41,11 @@ whl 格式本质上是一个压缩包，里面包含了 py 文件，以及经过 说白了，whl 就是 Python 的压缩包。 -常玩 Java 版的话，你可以理解为它是 **Python 版 的 .jar 文件**，只是运行环境由 _Java_ 改为 _Python_（可以这么想吧） +常玩 Java 版的话，你可以理解为它是 **Python 版 的 .jar 文件**，只是运行环境由 *Java* 改为 *Python*（可以这么想吧） + ::: -![204](./imgs/2-4.png) +![204](./_images/2-4.png) #### 第一步、下载插件 @@ -53,7 +57,9 @@ whl 格式本质上是一个压缩包，里面包含了 py 文件，以及经过 压缩包请使用常用压缩软件打开备用 :::tip + 打开压缩包推荐使用 BandiZIP、360 压缩、7z 或者 WinRAR 等专业压缩文件 + ::: #### 第二步、安装插件 @@ -62,60 +68,62 @@ whl 格式本质上是一个压缩包，里面包含了 py 文件，以及经过 ##### 如果是 whl 文件 -1、打开 bedrock_server 文件夹，你会惊奇的发现：什么时候多了个 plugins 文件夹？！！ +1、打开 `bedrock_server` 文件夹，你会惊奇的发现：什么时候多了个 `plugins` 文件夹？！！ -![205](./imgs/2-5.png) +![205](./_images/2-5.png) -2、打开 plugins 文件夹，将下载的 whl 插件文件拽入该文件夹中 +2、打开 `plugins` 文件夹，将下载的 whl 插件文件拽入该文件夹中 3、启动！当 CMD 显示插件名称时说明插件已加载成功！ -![206](./imgs/2-6.png) +![206](./_images/2-6.png) 4、如果你真不知道如何辨别插件是否加载，请在后台输入 `plugins` 指令 -![207](./imgs/2-7.png) +![207](./_images/2-7.png) ##### 如果是压缩包文件 比如下面这个赖皮家伙（不是） -![208](./imgs/2-8.png) +![208](./_images/2-8.png) 教你三招： -1、按下 CTRL + A 全选，复制压缩包内的所有文件 +1、按下 `Ctrl + A` 全选，复制压缩包内的所有文件 -2、打开 bedrock_server\plugins 后，粘贴 +2、打开 `bedrock_server\plugins` 后，粘贴 3、启动！享受插件便利！ -![209](./imgs/2-9.png) +![209](./_images/2-9.png) ##### 插件配置 有的会在下载的压缩文件中提前准备好 -![208](./imgs/2-8.png) +![208](./_images/2-8.png) 有的会在启动一次服务器后自动生成 -![2010](./imgs/2-10.png) +![2010](./_images/2-10.png) -编辑他们很简单，打开相应插件的文件夹，然后使用 VSCode 或者 Nodepad-- 一类编辑器对插件进行配置 +编辑他们很简单，打开相应插件的文件夹，然后使用 VS Code 或者 Nodepad-- 一类编辑器对插件进行配置 :::danger -请注意插件配置的文件格式，并按照他们的规则去写！，如果插件有 wiki 一类请先看他们的 wiki 再编辑！ + +请注意插件配置的文件格式，并按照他们的规则去写！，如果插件有 Wiki 一类请先看他们的 Wiki 再编辑！ + ::: ### pip 安装 在上面给的 pip 渠道 上找到心仪的插件后，使用下面指令完成下载： -```cmd +```bash pip install 插件名 ``` -![2011](./imgs/2-11.png) +![2011](./_images/2-11.png) 然后重启服务器，插件会自动安装完毕啦~ diff --git a/docs-bedrock/bds-core/process/EndStone/EndStone.md b/docs-bedrock/bds/process/endstone/endstone.md similarity index 78% rename from docs-bedrock/bds-core/process/EndStone/EndStone.md rename to docs-bedrock/bds/process/endstone/endstone.md index f6c05b4d2..47588e032 100644 --- a/docs-bedrock/bds-core/process/EndStone/EndStone.md +++ b/docs-bedrock/bds/process/endstone/endstone.md @@ -7,14 +7,16 @@ sidebar_position: 3 EndStone 提供类似 Bukkit 插件开发者的友好 API，简化了低层系统 API 和挂钩的处理。可以使用 C++ 或 Python 编写插件。 -EndStone 的很多插件可以在 **minebbs** 或者 **PyPI** 上查找了，详情请看 [EndStone 安装教程](EndStone-plugins.md)。 +EndStone 的很多插件可以在 **MineBBS** 或者 **PyPI** 上查找了，详情请看 [EndStone 安装教程](endstone-plugins.md)。 以下内容为 EndStone 的安装、配置教程 EndStone 国内非官方交流群：982797241 :::info + 教程催更请找本教程编写作者：[virgil698](https://github.com/virgil698) + ::: import DocCardList from '@theme/DocCardList'; diff --git a/docs-bedrock/bds-core/process/LeviLamina/legacy-script-engine.md b/docs-bedrock/bds/process/levilamina/legacy-script-engine.md similarity index 65% rename from docs-bedrock/bds-core/process/LeviLamina/legacy-script-engine.md rename to docs-bedrock/bds/process/levilamina/legacy-script-engine.md index 5f3886918..ed16c4817 100644 --- a/docs-bedrock/bds-core/process/LeviLamina/legacy-script-engine.md +++ b/docs-bedrock/bds/process/levilamina/legacy-script-engine.md @@ -1,19 +1,19 @@ --- -title: Legacy Script Engine(LSE) +title: Legacy Script Engine (LSE) sidebar_position: 2 --- -# Legacy Script Engine(LSE) +# Legacy Script Engine (LSE) ## 什么是 Legacy Script Engine -Legacy Script Engine 简称 LSE，是 LeviLamina 上的一系列插件，被用作 LiteLoader Scipt Engine(LLSE) 到 LeviScript(LS) 的过渡。 +Legacy Script Engine 简称 LSE，是 LeviLamina 上的一系列插件，被用作 LiteLoader Scipt Engine (LLSE) 到 LeviScript (LS) 的过渡。 LSE 的一些特性与 LLSE 相同，你可以阅读 LLSE 来了解该插件的特点。以下是这两个插件的不同之处： 1. LSE 只能在 LeviLamina 上运行，LLSE 只能在 LiteLoader 上运行 2. LSE 的插件格式与 LLSE 不同。要想让 LSE 运行 LLSE 插件，需要 LSE 自动或服主手动进行格式转换。 3. LSE 虽然是 LeviLamina 开发计划的一部分，但是它被设计作为可选模块，需要服主额外安装。而 LLSE 则是集成在 LiteLoaderBDS 中，安装 LiteLoaderBDS 的过程中即安装完毕，不需要额外安装。 -4. LSE 的 python 脚本引擎 legacy-script-engine-python 与系统中的 python 解释器冲突。 +4. LSE 的 Python 脚本引擎 legacy-script-engine-python 与系统中的 Python 解释器冲突。 5. LSE 的更新仅提供版本适配和错误修复，不会更新新的 API 等功能，也不受理任何相关建议。 ## 插件内容 @@ -23,45 +23,45 @@ LSE 的一些特性与 LLSE 相同，你可以阅读 LLSE 来了解该插件的 - **LegacyMoney** ：用于为 LSE 插件提供经济 API 相关功能 - **LegacyParticleAPI** ：用于为 LSE 插件提供 ParticleAPI 相关功能 - **LegacyRemoteCall** ：用于为 LSE 插件提供插件间相互调用功能 -- **legacy-script-engine-lua** ：用于加载和运行 lua 插件 -- **legacy-script-engine-quickjs** ：用于加载和运行单文件 js 插件 (quickjs 插件) -- **legacy-script-engine-nodejs** ：用于加载和运行 nodejs 插件 -- **legacy-script-engine-python** ：用于加载和运行 python 插件，**和系统中的 python 解释器冲突** +- **legacy-script-engine-lua** ：用于加载和运行 Lua 插件 +- **legacy-script-engine-quickjs** ：用于加载和运行单文件 JS 插件 (QuickJS 插件) +- **legacy-script-engine-nodejs** ：用于加载和运行 Node.js 插件 +- **legacy-script-engine-python** ：用于加载和运行 Python 插件，**和系统中的 Python 解释器冲突** 这其中 LegacyMoney、LegacyParticleAPI、LegacyRemoteCall 几乎是必须安装的，因为很多插件都依赖这些插件运行。其他四个用于加载不同种类 LSE 插件的可以根据服务器所用到的插件的类型进行安装。 ## [安装方法](https://lse.liteldev.com/zh/) -### 使用 Lip 安装 +### 使用 lip 安装 :::tip -非常推荐使用 Lip 安装。手动安装 LSE 的过程极其复杂繁琐 +非常推荐使用 lip 安装。手动安装 LSE 的过程极其复杂繁琐 ::: 一次性安装 QuickJS 和 Lua 引擎 -```shell +```bash lip install github.com/LiteLDev/LegacyScriptEngine ``` -安装 nodejs 引擎 +安装 Node.js 引擎 -```shell +```bash lip install gitea.litebds.com/LiteLDev/legacy-script-engine-nodejs ``` -安装 python 引擎 +安装 Python 引擎 -```shell +```bash lip install gitea.litebds.com/LiteLDev/legacy-script-engine-python ``` :::warning -由于 legacy-script-engine-python 与系统中的 python 解释器冲突，安装时你需要确保系统中没有 python 解释器。如果系统中已安装 python 解释器，你需要将其**彻底卸载** 。 -如果你必须使用系统中的 python 解释器，你只能放弃所有的 python 插件。 +由于 legacy-script-engine-python 与系统中的 Python 解释器冲突，安装时你需要确保系统中没有 Python 解释器。如果系统中已安装 Python 解释器，你需要将其 **彻底卸载** 。 +如果你必须使用系统中的 Python 解释器，你只能放弃所有的 Python 插件。 ::: diff --git a/docs-bedrock/bds-core/process/LeviLamina/LeviLamina-Install.md b/docs-bedrock/bds/process/levilamina/levilamina-install.md similarity index 83% rename from docs-bedrock/bds-core/process/LeviLamina/LeviLamina-Install.md rename to docs-bedrock/bds/process/levilamina/levilamina-install.md index 287edd893..d83570db0 100644 --- a/docs-bedrock/bds-core/process/LeviLamina/LeviLamina-Install.md +++ b/docs-bedrock/bds/process/levilamina/levilamina-install.md @@ -7,25 +7,25 @@ sidebar_position: 1 ## 方法零：使用笨蛋脚本 -首先下载[安装脚本](https://script.8aka.org/liteloaderbds-install)，下载完后右键**以管理员启动**即可 +首先下载 [安装脚本](https://script.8aka.org/liteloaderbds-install)，下载完后右键 **以管理员启动** 即可 :::tip -你甚至不需要安装 VC 运行库，自动脚本会自行安装常用运行库，还会自动配置 Lip 镜像以加速下载 +你甚至不需要安装 VC 运行库，自动脚本会自行安装常用运行库，还会自动配置 lip 镜像以加速下载 ::: -## 方法一：使用 Lip 进行一键配置 +## 方法一：使用 lip 进行一键配置 -### 准备工作 - 安装 Lip +### 准备工作 - 安装 lip -首先，从 [GitHub](https://github.com/lippkg/lip/releases/latest) 下载 Lip 的最新版本的应用 +首先，从 [GitHub](https://github.com/lippkg/lip/releases/latest) 下载 lip 的最新版本的应用 -然后，解压文件到你想要安装 Lip 的位置。 +然后，解压文件到你想要安装 lip 的位置。 最后，将该位置添加到 PATH 环境变量中。 -要检查是否成功安装 Lip，请在终端中运行 `lip --version`。你应该看到刚刚安装的 lip 的版本。 +要检查是否成功安装 lip，请在终端中运行 `lip --version`。你应该看到刚刚安装的 lip 的版本。 如果你使用的是 Windows 系统，你也可以在 GitHub 中下载 `.exe` 后缀的安装程序来安装。 @@ -35,29 +35,29 @@ sidebar_position: 1 然后运行命令 -```shell +```bash lip install github.com/LiteLDev/LeviLamina ``` -Lip 会自动下载 BDS 并配置 LeviLamina 加载器 +lip 会自动下载 BDS 并配置 LeviLamina 加载器 :::info -如果因网络问题无法下载 GO 模块或 LeviLamina 及其依赖，可以运行命令 +如果因网络问题无法下载 Go 模块或 LeviLamina 及其依赖，可以运行命令 -```shell +```bash lip config GoModuleProxyURL ``` 和 -```shell +```bash lip config GitHubMirrorURL ``` 来配置镜像，官方给的镜像 -```shell +```bash lip config GoModuleProxyURL https://goproxy.cn lip config GitHubMirrorURL https://github.bibk.top ``` @@ -72,13 +72,13 @@ lip config GitHubMirrorURL https://github.bibk.top 现在，你已成功安装了 LeviLamina 了，要启动它，请运行命今 -```shell +```bash bedrock_server_mod.exe ``` ## 方法二：手动安装 (不推荐) -只有想要调试新版本的开发人员才会手动安装，手动安装只会安装允许 LeviLamina 运行的基本部件，它缺少 CrashLogger、I18N 等组件。 +只有想要调试新版本的开发人员才会手动安装，手动安装只会安装允许 LeviLamina 运行的基本部件，它缺少 CrashLogger、i18n 等组件。 ### 下载必要的文件 @@ -115,6 +115,6 @@ bedrock_server_mod.exe 现在，你已成功安装了 LeviLamina 了，要启动它，请运行命今 -```shell +```bash bedrock_server_mod.exe ``` diff --git a/docs-bedrock/bds-core/process/LeviLamina/LeviLamina-Plugins.md b/docs-bedrock/bds/process/levilamina/levilamina-plugins.md similarity index 62% rename from docs-bedrock/bds-core/process/LeviLamina/LeviLamina-Plugins.md rename to docs-bedrock/bds/process/levilamina/levilamina-plugins.md index e9087406f..382edaeec 100644 --- a/docs-bedrock/bds-core/process/LeviLamina/LeviLamina-Plugins.md +++ b/docs-bedrock/bds/process/levilamina/levilamina-plugins.md @@ -9,50 +9,51 @@ sidebar_position: 1 LeviLamina 的插件是以文件夹的格式存在的。通常插件文件夹中包含以下内容： + ```c 插件文件夹 -├─manifest.json // 插件元数据文件，该文件必须存在并格式正确才能被 LeviLamina 识别 +├─manifest.json // 插件元数据文件，该文件必须存在并格式正确才能被 LeviLamina 识别 ├─(插件配置文件和数据库)... // 插件生成的配置文件和数据库等，大多数插件的配置文件名叫 config.json，并以一个文件夹或一个 .db 或 .json 后缀文件作为数据库 ├─(插件代码或二进制文件)... // 插件源代码，通常是 .js、.lua、.dll 后缀的文件。不要删除，修改或重命名文件，否则可能导致插件无法运行！ ``` 通常情况下，你不需要手动修改 `manifest.json` 这个文件，因为插件作者会将它事先配置好。如果有特殊插件需要手动配置这个文件，该插件文档应该会给出相应教程。 -## 使用 Lip 安装插件 +## 使用 lip 安装插件 -如果你还没有安装 Lip，可以参考 [上一章的教程](/Bedrock/bds-core/process/LeviLamina/LeviLamina-Install#准备工作---安装-lip) 。 +如果你还没有安装 lip，可以参考 [上一章的教程](./levilamina-install.md#准备工作---安装-lip) 。 -要使用 Lip 安装插件，你必须确保该插件**支持通过 Lip 安装** 。如果插件文档没有写明任何使用 Lip 安装的方法或命令，你就不应该使用 Lip 安装该插件。 +要使用 lip 安装插件，你必须确保该插件 **支持通过 lip 安装** 。如果插件文档没有写明任何使用 lip 安装的方法或命令，你就不应该使用 lip 安装该插件。 -通常情况下，一个 Lip 插件的安装命令会像这样： +通常情况下，一个 lip 插件的安装命令会像这样： -```shell +```bash lip install <一个URL> ``` ### 通过命令安装插件 -在服务端根目录 (包含 `bedrock_server_mod.exe` 的文件夹) 打开 powershell，执行插件使用说明给出的 Lip 安装命令， +在服务端根目录 (包含 `bedrock_server_mod.exe` 的文件夹) 打开 PowerShell，执行插件使用说明给出的 lip 安装命令， ### 通过 LipUI 安装插件 TODO -随后插件将在服务器下次启动时被加载。要想让正在运行的服务器加载该插件，你必须**重启服务器** 。 +随后插件将在服务器下次启动时被加载。要想让正在运行的服务器加载该插件，你必须 **重启服务器** 。 ## 手动安装插件 -### 原生 (native) 插件 +### 原生 (Native) 插件 解压并整理插件文件夹，确保其结构符合上文结出的插件结构。**有时插件压缩包解压后里面会套一层文件夹，这点要格外留意。** -将插件文件夹放入服务器的 `plugins` 文件夹，它将在服务器下次启动时被加载。要想让正在运行的服务器加载该插件，你必须**重启服务器** 。 +将插件文件夹放入服务器的 `plugins` 文件夹，它将在服务器下次启动时被加载。要想让正在运行的服务器加载该插件，你必须 **重启服务器** 。 ### LSE 插件 要安装 LSE 插件，你的服务器必须安装了 [Legacy Script Engine](./legacy-script-engine.md) 作为前置。 -#### quick-js、lua、python 单文件 +#### QuickJS、Lua、Python 单文件 指只有一个 .js/.lua/.py 代码文件的插件。 @@ -60,12 +61,12 @@ TODO 此时服务器将警告 `WARN [legacy-script-engine-quickjs] Legacy plugins have been migrated， please restart the server to load them!`。 **此时插件并未被加载，你需要再次重启服务器** ，之后插件就能加载了。 -#### nodejs、python 多文件 +#### Node.js、Python 多文件 -指 .llplugin 后缀名或解压后为一个文件夹的 LSE 插件。 +指 `.llplugin` 后缀名或解压后为一个文件夹的 LSE 插件。 -如果插件为文件夹，那么检查该文件夹结构。如果其中包含 `manifest.json`，直接将其放入 `plugins` 文件夹即可。随后它将在服务器下次启动时被加载。要想让正在运行的服务器加载该插件，你必须**重启服务器** 。 +如果插件为文件夹，那么检查该文件夹结构。如果其中包含 `manifest.json`，直接将其放入 `plugins` 文件夹即可。随后它将在服务器下次启动时被加载。要想让正在运行的服务器加载该插件，你必须 **重启服务器** 。 -如果该插件为文件夹但不包含 `manifest.json`，你需要将其放入 `plugins` 文件夹后，按上文 quickjs、lua、python 单文件的操作方法进行操作。 +如果该插件为文件夹但不包含 `manifest.json`，你需要将其放入 `plugins` 文件夹后，按上文 QuickJS、Lua、Python 单文件的操作方法进行操作。 -如果该插件为 .llplugin 后缀名的单个文件，你需要将其后缀名改成 .zip 并解压，之后按照上面两种方法进行操作。 +如果该插件为 `.llplugin` 后缀名的单个文件，你需要将其后缀名改成 `.zip` 并解压，之后按照上面两种方法进行操作。 diff --git a/docs-bedrock/bds-core/process/LeviLamina/LeviLamina.md b/docs-bedrock/bds/process/levilamina/levilamina.md similarity index 100% rename from docs-bedrock/bds-core/process/LeviLamina/LeviLamina.md rename to docs-bedrock/bds/process/levilamina/levilamina.md diff --git a/docs-bedrock/bds-core/process/LiteLoaderBDS/install.md b/docs-bedrock/bds/process/liteloader-bds/install.md similarity index 86% rename from docs-bedrock/bds-core/process/LiteLoaderBDS/install.md rename to docs-bedrock/bds/process/liteloader-bds/install.md index c4ac391c9..5cdfaa15d 100644 --- a/docs-bedrock/bds-core/process/LiteLoaderBDS/install.md +++ b/docs-bedrock/bds/process/liteloader-bds/install.md @@ -16,7 +16,7 @@ LiteLoaderBDS 不会自动下载安装对应版本 BDS，你需要手动寻找 :::warning -LiteLoaderBDS 仅适配了 BDS 的 1.20.32 及以下版本。对于更高版本的 BDS 需要使用 [LeviLamina](../LeviLamina/LeviLamina.md) 加载器。 +LiteLoaderBDS 仅适配了 BDS 的 1.20.32 及以下版本。对于更高版本的 BDS 需要使用 [LeviLamina](../levilamina/levilamina.md) 加载器。 对于 1.20.40 - 1.20.51 版本，你需要使用其他加载器。如果你只需要兼容 1.20.40 - 1.20.51 的客户端进服，你可以选用 BDS 1.20.32、最新版 LiteLoader 和 Glacie 插件的方案。 ::: @@ -35,7 +35,7 @@ LiteLoaderBDS 仅适配了 BDS 的 1.20.32 及以下版本。对于更高版本 将这四个文件放进 BDS 的根目录。 -随后，双击运行 PreEditor.exe。该程序会弹出一个命令行窗口，当其中显示 **Done** 的时候，证明安装成功。 +随后，双击运行 `PreEditor.exe`。该程序会弹出一个命令行窗口，当其中显示 **Done** 的时候，证明安装成功。 ## 运行带有 LiteLoaderBDS 加载器的 BDS diff --git a/docs-bedrock/bds-core/process/LiteLoaderBDS/LiteLoaderBDS.md b/docs-bedrock/bds/process/liteloader-bds/liteloader-bds.md similarity index 88% rename from docs-bedrock/bds-core/process/LiteLoaderBDS/LiteLoaderBDS.md rename to docs-bedrock/bds/process/liteloader-bds/liteloader-bds.md index 95feb79b6..4d5bd86c0 100644 --- a/docs-bedrock/bds-core/process/LiteLoaderBDS/LiteLoaderBDS.md +++ b/docs-bedrock/bds/process/liteloader-bds/liteloader-bds.md @@ -5,11 +5,11 @@ sidebar_position: 4 # LiteLoaderBDS -LiteLoaderBDS 是 BDS 核心的一款功能强大的插件加载器，简称 ll，是 [LeviLamina](../LeviLamina/LeviLamina.md) 的前身，**现已停更**。 +LiteLoaderBDS 是 BDS 核心的一款功能强大的插件加载器，简称 LL，是 [LeviLamina](../levilamina/levilamina.md) 的前身，**现已停更**。 :::tip[你知道吗] -根据该加载器开发者所说，他们本来是因为 LiteLoaderBDS 的代码过于臃肿、难以维护、开发标准老旧、功能太过局限而希望重构 LiteLoaderBDS，后来转为计划启动新项目 LeviLamina。这也是 LeviLamina 的“ll3”别称的来历。 +根据该加载器开发者所说，他们本来是因为 LiteLoaderBDS 的代码过于臃肿、难以维护、开发标准老旧、功能太过局限而希望重构 LiteLoaderBDS，后来转为计划启动新项目 LeviLamina。这也是 LeviLamina 的“LL3”别称的来历。 ::: diff --git a/docs-bedrock/bds-core/process/LiteLoaderBDS/plugins.md b/docs-bedrock/bds/process/liteloader-bds/plugins.md similarity index 50% rename from docs-bedrock/bds-core/process/LiteLoaderBDS/plugins.md rename to docs-bedrock/bds/process/liteloader-bds/plugins.md index fc8e3bc61..6162d876f 100644 --- a/docs-bedrock/bds-core/process/LiteLoaderBDS/plugins.md +++ b/docs-bedrock/bds/process/liteloader-bds/plugins.md @@ -9,18 +9,18 @@ sidebar_position: 2 LiteLoaderBDS 的插件共有以下几类： -1. 原生插件 (native)：俗称 dll 插件。通常是一个 .dll 后缀的文件。 -2. QuickJS 插件 (qjs)：俗称单文件 js 插件。通常是一个 .js 后缀的文件。 -3. Lua 插件：通常是一个 .lua 后缀的文件。 -4. NodeJS 插件：通常是一个文件夹或是一个 .llplugin 后缀的文件。 -5. Python 插件：通常是一个文件夹或是一个 .py 后缀的文件。 -6. LL.NET 插件：通常是一个 .dll 后缀的文件。虽然和原生插件后缀相同，但是这种插件必须安装了 LL.NET 插件的依赖才能正常加载和运行。 +1. 原生插件 (Native)：俗称 DLL 插件。通常是一个 `.dll` 后缀的文件。 +2. QuickJS 插件 (QJS)：俗称单文件 JS 插件。通常是一个 `.js` 后缀的文件。 +3. Lua 插件：通常是一个 `.lua` 后缀的文件。 +4. Node.js 插件：通常是一个文件夹或是一个 `.llplugin` 后缀的文件。 +5. Python 插件：通常是一个文件夹或是一个 `.py` 后缀的文件。 +6. LL.NET 插件：通常是一个 `.dll` 后缀的文件。虽然和原生插件后缀相同，但是这种插件必须安装了 LL.NET 插件的依赖才能正常加载和运行。 ## 安装原生、QuickJS、Lua、Python 单文件插件 将插件的所有文件放入 `plugins` 文件夹，然后服务器将在下次启动时加载该插件。 -## 安装 NodeJS 插件 +## 安装 Node.js 插件 将插件的所有文件放入 `plugins` 文件夹中的 `nodejs` 文件夹，然后服务器将在下次启动时加载该插件。 diff --git a/docs-bedrock/bds-core/process/plugins/_images/levilamina-is-coming.png b/docs-bedrock/bds/process/plugins/_images/levilamina-is-coming.png similarity index 100% rename from docs-bedrock/bds-core/process/plugins/_images/levilamina-is-coming.png rename to docs-bedrock/bds/process/plugins/_images/levilamina-is-coming.png diff --git a/docs-bedrock/bds-core/process/plugins/_images/levilamina-will-archived.png b/docs-bedrock/bds/process/plugins/_images/levilamina-will-archived.png similarity index 100% rename from docs-bedrock/bds-core/process/plugins/_images/levilamina-will-archived.png rename to docs-bedrock/bds/process/plugins/_images/levilamina-will-archived.png diff --git a/docs-bedrock/bds-core/process/plugins/how-to-load-plugins.md b/docs-bedrock/bds/process/plugins/how-to-load-plugins.md similarity index 100% rename from docs-bedrock/bds-core/process/plugins/how-to-load-plugins.md rename to docs-bedrock/bds/process/plugins/how-to-load-plugins.md diff --git a/docs-bedrock/bds-core/process/plugins/plugins-loader-choose.md b/docs-bedrock/bds/process/plugins/plugins-loader-choose.md similarity index 88% rename from docs-bedrock/bds-core/process/plugins/plugins-loader-choose.md rename to docs-bedrock/bds/process/plugins/plugins-loader-choose.md index e8b0b4b51..86dcb1c8d 100644 --- a/docs-bedrock/bds-core/process/plugins/plugins-loader-choose.md +++ b/docs-bedrock/bds/process/plugins/plugins-loader-choose.md @@ -10,6 +10,8 @@ import TabItem from '@theme/TabItem'; ## 主流加载器 + + @@ -23,7 +25,7 @@ import TabItem from '@theme/TabItem'; | 推荐与否 | 非常推荐 | | 理由 | 插件生态不错，跟 [LiteLoader](#寿终正寝の加载器) 时代一样巅峰 | | 下载 | [GitHub 下载](https://github.com/LiteLDev/LeviLamina/releases) | -| 支持的 MC 版本 | 1.20.61-1.21.3(目前保持更新) | +| 支持的 MC 版本 | 1.20.61-1.21.3 (目前保持更新) | @@ -35,21 +37,21 @@ import TabItem from '@theme/TabItem'; | 介绍 | 提供类似 Bukkit 插件开发者的友好 API，简化了低层系统 API 和挂钩的处理。可以使用 C++ 或 Python 编写插件 | | 推荐与否 | 比较慢推荐 | | 理由 | 虽然几乎没有插件生态，仅社区有 **极少** 的插件，但最近形势较好，社区内有参与开发的声音，后续可能会追平 LeviLamina | -| 下载 | [Github 下载](https://github.com/EndstoneMC/endstone/releases) | -| 支持的 MC 版本 | 1.20.71 - 1.21.2(目前保持更新) | +| 下载 | [GitHub 下载](https://github.com/EndstoneMC/endstone/releases) | +| 支持的 MC 版本 | 1.20.71 - 1.21.2 (目前保持更新) | | 插件加载器 | 别名：BDSX | | -------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| 名称 | [bdsx](https://github.com/bdsx/bdsx) | -| 作者 | [bdsx](https://github.com/bdsx) | -| 介绍 | BDSX 是一个支持 node.js 的 Minecraft 基岩版专用服务器（BDS）修改版本。基于官方 BDS 实现，包含了原版 Minecraft 的所有特性，并支持 Hook 函数与网络数据包以添加或修改服务器的功能与表现。 | +| 名称 | [BDSX](https://github.com/bdsx/bdsx) | +| 作者 | [BDSX](https://github.com/bdsx) | +| 介绍 | BDSX 是一个支持 Node.js 的 Minecraft 基岩版专用服务器（BDS）修改版本。基于官方 BDS 实现，包含了原版 Minecraft 的所有特性，并支持 Hook 函数与网络数据包以添加或修改服务器的功能与表现。 | | 推荐与否 | 较为推荐 | | 理由 | 国内插件虽然少，但还是有很多的人去使用它，作者也从 19 年一直维护到现在 | | 下载 | [克隆源代码下载](https://github.com/bdsx/bdsx) | -| 插件下载 | [npm 源](https://www.npmjs.com/search?q=%40bdsx%2F)
[Github](https://github.com/topics/bdsx-plugins) | +| 插件下载 | [npm 源](https://www.npmjs.com/search?q=%40bdsx%2F)
[GitHub](https://github.com/topics/bdsx-plugins) | | 支持的 MC 版本 | 1.12 - 最新（目前保持更新） | @@ -62,13 +64,13 @@ import TabItem from '@theme/TabItem'; - + | 插件加载器 | 别名：SAPI | | -------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | 名称 | [原生 BDS Script API](https://wiki.mcbe-dev.net/-/6424) | | 作者 | [Mojang Studio](https://github.com/Mojang) | -| 介绍 | 随着 BDS 服务端的发展，官方已推出并逐渐完善基于 Javascript 语言的脚本 API，受到官方的支持与维护，可帮助创作者完成复杂的逻辑
(其加载器直接内置于 BDS 核心包内，不用腐竹手动下载，这里仅提供 BDS 核心下载方式) | +| 介绍 | 随着 BDS 服务端的发展，官方已推出并逐渐完善基于 JavaScript 语言的脚本 API，受到官方的支持与维护，可帮助创作者完成复杂的逻辑
(其加载器直接内置于 BDS 核心包内，不用腐竹手动下载，这里仅提供 BDS 核心下载方式) | | 推荐与否 | 非常不推荐 | | 理由 | 几乎没有插件生态，仅社区有 **极少** 的插件 | | 下载 | [官网下载](https://www.minecraft.net/zh-hans/download/server/bedrock)
[原子云下载](https://res.nullatom.com/Minecraft/Server/BDS) | @@ -86,15 +88,15 @@ import TabItem from '@theme/TabItem'; -| 插件加载器 | 别名：LL，LLv2([详情点我](#litexloader-合并至-liteloader2022 年 2 月 12 日)) | +| 插件加载器 | 别名：LL，LLv2 ([详情点我](#litexloader-合并至-liteloader-2022-年-2-月-12-日)) | | -------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | 名称 | [LiteLoaderBDS](https://github.com/LiteLDev/LiteLoaderBDSv2/) | | 作者 | [LiteLDev](https://github.com/LiteLDev) | | 介绍 | LiteLoaderBDSv2 是一款专为 BDS 编写的插件加载器，旨在弥补官方行为包开发接口的不足。LiteLoaderBDSv2 支持多种编程语言编写插件，并保证了插件开发与维护的便利性 | | 推荐与否 | 非常不推荐 | -| 理由 | 插件生态无可厚非，没人会否定它的巅峰时代，可惜岁月不饶人啊...如果你服务器愿意在此版本区间便罢了，因为不好找插件了 ([详情点我](#liteloader-宣布停更 2023 年 10 月份)) | +| 理由 | 插件生态无可厚非，没人会否定它的巅峰时代，可惜岁月不饶人啊...如果你服务器愿意在此版本区间便罢了，因为不好找插件了 ([详情点我](#liteloader-宣布停更-2023-年-10-月份)) | | 下载 | [GitHub 下载](https://github.com/LiteLDev/LeviLamina/releases) | -| 支持的 MC 版本 | 1.16.210-1.20.31.01(已存档)[^Archived] | +| 支持的 MC 版本 | 1.16.210 - 1.20.31.01 (已存档)[^Archived] | @@ -103,11 +105,11 @@ import TabItem from '@theme/TabItem'; | -------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | 名称 | [LiteXLoader](https://www.minebbs.com/threads/litexloader-x-bds.7439/) | | 作者 | [LiteDev](https://github.com/LiteLDev) | -| 介绍 | LiteXLoader 是一款专为 LiteLoader 编写的拓展类插件加载器，旨在弥补 LiteLoader 可开发语言的不足。LiteXLoader 支持多种编程语言编写插件，并保证了插件开发与维护的便利性，例如拓展支持 Node-Js、Python、Qucik-Js 的开发 | +| 介绍 | LiteXLoader 是一款专为 LiteLoader 编写的拓展类插件加载器，旨在弥补 LiteLoader 可开发语言的不足。LiteXLoader 支持多种编程语言编写插件，并保证了插件开发与维护的便利性，例如拓展支持 Node.js、Python、QuickJS 的开发 | | 推荐与否 | 非常不推荐 | | 理由 | 后续合并到 LiteLoader 中。[详情点我](#litexloader-合并至-liteloader2022 年 2 月 12 日) | -| 下载 | [Github 下载](https://github.com/EndstoneMC/endstone/releases) | -| 支持的 MC 版本 | 1.20.71 - 1.21.2(已存档)[^Archived] | +| 下载 | [GitHub 下载](https://github.com/EndstoneMC/endstone/releases) | +| 支持的 MC 版本 | 1.20.71 - 1.21.2 (已存档)[^Archived] | @@ -124,20 +126,20 @@ import TabItem from '@theme/TabItem'; 2024 年 6 月 6 日 凌晨，在发布的 1.21.10.22 Preview 版本的 BDS 中，LiteDev 开发成员注意到 PDB 文件被移除，紧接着社区开发者传来消息，称官方曾召开过会讨论 BDS 的 PDB 文件的去向。 结果显然是 **决定移除**。如果将来都是如此的话，那么我们将会在高版本迎来首个没有 PDB 的版本。 -官方声称他们知道此次行为会激怒社区开发者，并且是完全故意的。他们认为 MOD 存在所谓的 **“行业标准形式”**，使用调试符号和钩子 (Hook) 不是 MOD 的“行业标准形式”。 -也就是说，他们认为他们提供的 **附加组件** 才是 MOD 的“行业标准形式”，即宣布当前的所有 MOD 为 **非法**。 +官方声称他们知道此次行为会激怒社区开发者，并且是完全故意的。他们认为 mod 存在所谓的 **“行业标准形式”**，使用调试符号和钩子 (Hook) 不是 mod 的“行业标准形式”。 +也就是说，他们认为他们提供的 **附加组件** 才是 mod 的“行业标准形式”，即宣布当前的所有 mod 为 **非法**。 他们还认为，服务端符号文件只适用于制作客户端的作弊软件，而不适用于制作服务端的反作弊系统。这说法就好比说菜刀可以用来杀人，所以禁止出售菜刀 (？)。 但事实上客户端外挂并不使用 PDB 来查找函数地址，而是用签名来查找所需函数或变量的地址，但事实是服务端的反作弊 **极其依赖** PDB 符号文件。 他们甚至可能还不知道特们的合作服务器使用的都是自己开发的服务端，而不是 BDS，重新写一个服务端不叫修改。 -开 BDS 的目的是为了生存玩法，而第三方服务端缺少原生特性，顶多开小游戏服。但 MOD BDS 的存在，就是为了在拥有原生特性的服务器上支持一些原生插件。因此，我们有理由相信这只是一个借口，而真正的原因我们还不得而知。 -我个人猜测，这可能与 Minecraft 的商业化有关。毕竟 Minecraft 是一个商业游戏，而 MOD BDS 可能被视为对其商业模式的一种威胁。社区对这种不顺应社区需求的行为表示了不满，有人已经提出了抵制的声音，目前相关的请求帖子，已经获得了超过 1000 个赞同。 +开 BDS 的目的是为了生存玩法，而第三方服务端缺少原生特性，顶多开小游戏服。但 mod BDS 的存在，就是为了在拥有原生特性的服务器上支持一些原生插件。因此，我们有理由相信这只是一个借口，而真正的原因我们还不得而知。 +我个人猜测，这可能与 Minecraft 的商业化有关。毕竟 Minecraft 是一个商业游戏，而 mod BDS 可能被视为对其商业模式的一种威胁。社区对这种不顺应社区需求的行为表示了不满，有人已经提出了抵制的声音，目前相关的请求帖子，已经获得了超过 1000 个赞同。 我们也了解到官方相关负责人正在讨论此事。 -我们呼吁大家积极参与讨论，让官方了解我们的诉求！Partner 项目总监和工作室里的人讨论过，反正他们的观点是力推 CRIPT 的 API，这将势不可挡，未来是 [All in JavaScript(即 SAPI)](#主流加载器) 的时代， -只要社区的需求大且合理，他们就会添加对应的接口。在 PDB 方面，他们认为这是 **非行业化的**，他们不认为这是合适且合法的 MOD 的行为，并 **《希望》** 社区给出一定要 PDB 才能实现的功能。 +我们呼吁大家积极参与讨论，让官方了解我们的诉求！Partner 项目总监和工作室里的人讨论过，反正他们的观点是力推 CRIPT 的 API，这将势不可挡，未来是 [All in JavaScript (即 SAPI)](#主流加载器) 的时代， +只要社区的需求大且合理，他们就会添加对应的接口。在 PDB 方面，他们认为这是 **非行业化的**，他们不认为这是合适且合法的 mod 的行为，并 **《希望》** 社区给出一定要 PDB 才能实现的功能。 此后，著名插件加载器 LeviLamina 刚出生不久就胎死腹中了... ![LeviLamina 在未来将会存档](./_images/levilamina-will-archived.png) @@ -157,6 +159,6 @@ LiteLoaderBDS 最初是基于 BedrockX 开发的，在 2.0 版本进行了完全 ![LeviLamina 在来的路上](./_images/levilamina-is-coming.png) 所以并不是 LiteDev 扔下史山跑路了 (这是官方原话自嘲)，而是着手重构 LiteLoader，预计在未来发布 LiteLoaderBDSV3，即 LeviLamina。 -### LiteXLoader 合并至 LiteLoader(2022 年 2 月 12 日) +### LiteXLoader 合并至 LiteLoader (2022 年 2 月 12 日) -LiteXLoader 于 2022 年 2 月 12 日 合并至 LiteLoader 项目，LXL 成为 LL 的一个子模块。LiteLoaderBDS 将继续更新，作为 C++、Go、Js、Lua 和其他语言的通用加载器。所有以前的 LXL 插件将继续在新的 LL 版本下正常运行，所有现有的 API 将保持不变。 +LiteXLoader 于 2022 年 2 月 12 日 合并至 LiteLoader 项目，LXL 成为 LL 的一个子模块。LiteLoaderBDS 将继续更新，作为 C++、Go、JS、Lua 和其他语言的通用加载器。所有以前的 LXL 插件将继续在新的 LL 版本下正常运行，所有现有的 API 将保持不变。 diff --git a/docs-bedrock/bds-core/process/plugins/plugins.md b/docs-bedrock/bds/process/plugins/plugins.md similarity index 100% rename from docs-bedrock/bds-core/process/plugins/plugins.md rename to docs-bedrock/bds/process/plugins/plugins.md diff --git a/docs-bedrock/bds-core/process/process.md b/docs-bedrock/bds/process/process.md similarity index 100% rename from docs-bedrock/bds-core/process/process.md rename to docs-bedrock/bds/process/process.md diff --git a/docs-bedrock/bds-core/start/basic/basic.md b/docs-bedrock/bds/start/basic/basic.md similarity index 100% rename from docs-bedrock/bds-core/start/basic/basic.md rename to docs-bedrock/bds/start/basic/basic.md diff --git a/docs-bedrock/bds/start/basic/server-dir-structure.md b/docs-bedrock/bds/start/basic/server-dir-structure.md new file mode 100644 index 000000000..6e449ae1b --- /dev/null +++ b/docs-bedrock/bds/start/basic/server-dir-structure.md @@ -0,0 +1,186 @@ +--- +title: 服务端结构 +sidebar_position: 1 +--- + +# 服务端结构 + +我们先来简单看一眼 BDS **开服后** 的文件夹结构： + + +```c +BDS服务端文件夹 +├─behavior_packs // 安装新行为包的文件夹 +├─config // 没啥用 +├─definitions // 貌似是生成群系的内容 +├─development_behavior_packs // 为开发者提供安装新行为包的文件夹 +├─development_resource_packs // 为开发者提供安装新资源包的文件夹 +├─development_skin_packs // 为开发者提供安装新皮肤包的文件夹 +├─resource_packs // 安装新资源包的文件夹 +├─world-templates // 世界模板 +├─worlds // 主世界文件夹 +│ └─Bedrock level // 世界存档 +│ ├─db // 存档数据文件夹 +│ ├─level_dat // 存档设定 +│ ├─level.dat_old // 存档设定 (旧) +│ └─level_name.txt // 存档名称 +├─allowlist.json // 白名单文件 +├─bedrock_server.exe // 服务端启动程序 +├─bedrock_server.pdb // 程序数据库文件 +├─bedrock_server_how_to.html // 如何使用 BDS 服务器的官方指南 (没多大用处，看看就行) +├─permissions.json // 管理员 (OP) 玩家相关数据 +├─release-notes.txt // 服务端发行版本详情 +├─server.properties // 配置文件 +└─valid_known_packs.json // 已知的附加包 +``` + + + +## 根目录下的一些文件 + +:::warning + +请不要让你的服务端结构与文档解说结构有任何的 **缺少**，否则可能会出现 **玄学问题** + +若你 **一致认为** 有可删之处，那么以下是 **绝对可以删** 的服务端结构 (反正每次开服都会检测是否有这些文件夹，如果没有还是会创建的) + +
+ 点击展开 + +- `config` +- development_behavior_packs +- development_resource_packs +- development_skin_packs +- world-templates +- bedrock_server_how_to.html (这个不会自己创建) +- release-notes.txt (这个不会自己创建) +- valid_known_packs.json + +
+ +::: + +--- + +- `behavior_packs` + - 用于安装新的行为包。行为包可以改变游戏中的某些行为，例如，它们可以修改怪物行为、游戏规则或添加新的游戏机制。 + - BUT! 没啥用...后续也不会涉及... + +--- + +- `config` + - 这个文件夹通常用于存储服务器的配置文件。 + - BUT! 没啥用...后续也不会涉及... + +--- + +- `definitions` + - 这个文件夹包含定义文件，这些文件通常用于定义游戏中的群系、结构、生物生成等信息。它们决定了世界中不同区域的特性和外观。 + - BUT! 没啥用...后续也不会涉及... + +--- + +- `development_behavior_packs` + - 为开发者提供安装新行为包的文件夹。这允许开发者测试和开发自定义的行为包，而不会影响到主服务器的行为包。 + - BUT! 没啥用...后续也不会涉及... + +--- + +- `development_resource_packs` + - 为开发者提供安装新资源包的文件夹。开发者可以在这里添加、测试和开发自定义的资源包，如纹理、模型和音效等。 + - BUT! 没啥用...后续也不会涉及... + +--- + +- `development_skin_packs` + - 为开发者提供安装新皮肤包的文件夹。开发者可以在这里添加和测试自定义的玩家皮肤和其他角色的外观。 + - BUT! 没啥用...后续也不会涉及... + +--- + +- `resource_packs` + - 用于安装新的资源包。资源包可以改变游戏中的视觉和声音元素，例如，它们可以提供新的纹理、音效和模型。 + - BUT! 没啥用...后续也不会涉及... + +--- + +- `world-templates` + - 包含世界模板，这些模板可以被用来快速创建具有特定设置和结构的新世界。 + - 有点用，但不多。 + +--- + +- `worlds` + - 这是存储主世界文件夹的地方。每个世界都有自己的子文件夹，其中包含该世界的所有数据，如地形、建筑、玩家进度等。 + - `Bedrock level` + - 包含特定世界的存档数据。 + - `db` + - 存档数据文件夹，通常包含有关世界的数据库文件。 + - `level_dat` + - 包含世界的基本设置和属性，如游戏规则、时间、天气等。 + - `level.dat_old` + - 旧版的存档设定文件，通常在更新或备份时使用。 + - `level_name.txt` + - 包含世界名称的文件。 + +--- + +- `allowlist.json` + - 白名单文件，列出了允许进入服务器的玩家列表。 + - (如果你在 `server.properties` 中开启了白名单，你就可以在该文件中添加和管理谁被允许或不被允许进入服务器)。 + +--- + +- `bedrock_server.exe` + - 服务端启动程序，用于启动和运行《我的世界》基岩版服务器。 + + - 你可以改名叫任何名字 (只要以 `.exe` 结尾就行)，但不建议你这么做，可能会导致成为后续操作报错的因素。例如： + 1. 若你使用 **面板** 开服，需要在对应的 **启动路径** 中修改服务端启动程序的文件名 + 2. 若你使用 **启用脚本** 开服，需要在脚本对应位置的 **启动命令** 中修改 **启动程序的文件名** 为 **该服务端启动程序的文件名** (bedrock_server.exe) + +--- + +- `bedrock_server.pdb` + - 程序数据库文件，通常用于调试和错误分析。 + +--- + +- `bedrock_server_how_to.html` + - 如何使用 BDS 服务器的官方指南，虽然你说“没多大用处”，但它可能包含有关配置和运行服务器的有用信息。 + - 有点用，但不多 + +--- + +- `permissions.json` + - 管理员 (OP) 玩家相关数据 (如 UUID 及游戏名称等相关信息)，包括权限设置和角色定义。 + +--- + +- `release-notes.txt` + - 服务端发行版本详情，包含了每个版本更新的日志和更改内容。 + - BUT! 没啥用...后续也不会涉及... + +--- + +- `server.properties` + - 服务器配置文件，用于调整各种服务器设置，如设置端口，设置游戏难度，设置游戏模式 (生存、创造等) 等。 + +--- + +- `valid_known_packs.json` + - 包含已知的附加包列表，这些包可能包括行为包、资源包等，服务器会根据这个列表来验证安装的包。 + - 有点用，但不多。 + +--- + +至此，大部分的以 BDS 为基础的服务器核心服务端的结构已经大致呈现在你眼前。 + +:::tip + +如果你的服务端有更多的文件，大概率是 [**插件加载器** / **插件**](../../process/plugins/plugins-loader-choose.md)(如针对 BDS 的 Levilamina 插件加载器会释放更多文件夹) 创建的文件夹，一般来说无需担心。 + +::: diff --git a/docs-bedrock/bds-core/start/start.md b/docs-bedrock/bds/start/start.md similarity index 100% rename from docs-bedrock/bds-core/start/start.md rename to docs-bedrock/bds/start/start.md diff --git a/docs-bedrock/intro.md b/docs-bedrock/intro.md index 11eeecffa..4bd281f60 100644 --- a/docs-bedrock/intro.md +++ b/docs-bedrock/intro.md @@ -19,6 +19,6 @@ sidebar_position: 1 ## 更多 -对于文档中的错误请进入 [GitHub](https://github.com/Cubic-Project/NitWikit) 提出 Issue 或提交 Pr。 +对于文档中的错误请进入 [GitHub Issues](https://github.com/Cubic-Project/NitWikit) 提出 Issue 或提交 PR。 -欢迎加入 [企鹅群 🐧611076407](https://qm.qq.com/q/lEnfzgzxjq)。 +欢迎加入 [企鹅群🐧1074062482](https://qm.qq.com/q/UyurWW3zyI)。 diff --git a/docs-bedrock/qitabe-core/dragonfly/dragonfly.png b/docs-bedrock/misc/_images/dragonfly.png similarity index 100% rename from docs-bedrock/qitabe-core/dragonfly/dragonfly.png rename to docs-bedrock/misc/_images/dragonfly.png diff --git a/docs-bedrock/qitabe-core/allay-core/allay-core.md b/docs-bedrock/misc/allay/allay.md similarity index 100% rename from docs-bedrock/qitabe-core/allay-core/allay-core.md rename to docs-bedrock/misc/allay/allay.md diff --git a/docs-bedrock/qitabe-core/allay-core/allay/allay.md b/docs-bedrock/misc/allay/description.md similarity index 56% rename from docs-bedrock/qitabe-core/allay-core/allay/allay.md rename to docs-bedrock/misc/allay/description.md index 968dc911b..4ecfc2fdd 100644 --- a/docs-bedrock/qitabe-core/allay-core/allay/allay.md +++ b/docs-bedrock/misc/allay/description.md @@ -9,7 +9,7 @@ sidebar_position: 1
-[Allay 官网](https://docs.allaymc.org/) | [Github 仓库](https://github.com/AllayMC/Allay) +[Allay 官网](https://docs.allaymc.org/) | [GitHub 仓库](https://github.com/AllayMC/Allay)
@@ -18,53 +18,55 @@ sidebar_position: 1 Allay 是使用 Java 编写的 Minecraft: Bedrock Edition 第三方服务端软件，目标通过精心设计的架构来在保持高性能的同时保持高扩展性。 :::danger + 请注意，此项目仍处于非常早期的阶段且还未释放正式版，大量接口可能会在没有预先通知的情况下增加或删除。请不要在生产环境使用 Allay。 -你可以查看我们的 RoadMap 来获取开发进度。 +你可以查看我们的 Roadmap 来获取开发进度。 + ::: ## 特性 - 跨平台：Allay 基于 JVM，故可以在大多数能运行 JVM 的平台上运行。 - 高性能： - - 我们充分了解 Nukkit 系服务端在高负载环境下存在的问题，Allay 在同样的负载环境下于特定方面（eg: 实体物理）的性能比 Nukkit 高近百倍。 - - 除此之外，得益于重新设计的线程模型，Allay 能充分利用多核 CPU。这意味着你不需要刻意使用高频率的 CPU。 - - Allay 基于最新的 Java21，理论上能获得更好的性能 + - 我们充分了解 Nukkit 系服务端在高负载环境下存在的问题，Allay 在同样的负载环境下于特定方面（e.g. 实体物理）的性能比 Nukkit 高近百倍。 + - 除此之外，得益于重新设计的线程模型，Allay 能充分利用多核 CPU。这意味着你不需要刻意使用高频率的 CPU。 + - Allay 基于最新的 Java21，理论上能获得更好的性能 - 易于上手： - - 你可以使用 Java/JVM 语言编写适用于 Allay 的插件 - - 我们引入了 GraalVM 和 JavaScript 支持，这意味着你可以使用 JavaScript/TypeScript 编写插件并 - - 获得与 Java 同等的性能以及无缝互操作的能力。 + - 你可以使用 Java/JVM 语言编写适用于 Allay 的插件 + - 我们引入了 GraalVM 和 JavaScript 支持，这意味着你可以使用 JavaScript/TypeScript 编写插件并 + - 获得与 Java 同等的性能以及无缝互操作的能力。 - 高自定义性：Allay 提供大量 BDS 不具备的接口。除此之外，你甚至可以直接控制发包来获得最大的自定义性。 - 安全： - - Allay 相较于 BDS 对客户端发包有更多的校验，理论上不存在 BDS 存在的许多恶性漏洞。 - - Allay 默认开启网络加密。另外，Allay 内置资源包加密功能，可自动加密发送给客户端的资源包，一定程度上防止你的数据泄漏。 + - Allay 相较于 BDS 对客户端发包有更多的校验，理论上不存在 BDS 存在的许多恶性漏洞。 + - Allay 默认开启网络加密。另外，Allay 内置资源包加密功能，可自动加密发送给客户端的资源包，一定程度上防止你的数据泄漏。 - 大量新功能：不同于 Nukkit 系服务端，Allay 使用了大量 BDS 已经引入的新的协议功能，包括但不限于服务端权威物品栏，子区块发包... - 代码质量：我们非常注重代码质量，并借助大量的单元测试和重构保持项目稳定。 ## 开始使用 -Allay 基于 Java21，故在运行&构建 Allay 前你需要安装 Java21。 +Allay 基于 Java21，故在运行 & 构建 Allay 前你需要安装 Java21。 若你有开发脚本插件的需求，我们建议你使用 GraalVM 以获得最好性能。 ### 直接运行 -前往[Github Releases](https://github.com/AllayMC/Allay/releases)下载 +前往 [GitHub Releases](https://github.com/AllayMC/Allay/releases) 下载 使用以下启动脚本启动服务端（jar 文件名为示例，请改为你设置的 jar 核心名） -```cmd +```bash java -jar allay.jar ``` ### 源码运行 -```cmd +```bash gradlew Allay-Server:runShadow ``` ### 构建 -```cmd +```bash gradlew Allay-Server:build ``` diff --git a/docs-bedrock/qitabe-core/allay-core/preparation/preparation.md b/docs-bedrock/misc/allay/preparation.md similarity index 100% rename from docs-bedrock/qitabe-core/allay-core/preparation/preparation.md rename to docs-bedrock/misc/allay/preparation.md diff --git a/docs-bedrock/qitabe-core/dragonfly/dragonfly.md b/docs-bedrock/misc/dragonfly.md similarity index 83% rename from docs-bedrock/qitabe-core/dragonfly/dragonfly.md rename to docs-bedrock/misc/dragonfly.md index 314b4f28e..e8fb2392e 100644 --- a/docs-bedrock/qitabe-core/dragonfly/dragonfly.md +++ b/docs-bedrock/misc/dragonfly.md @@ -3,7 +3,7 @@ title: Dragonfly 核心介绍 sidebar_position: 1 --- -![DragonflyLogo](./dragonfly.png) +![DragonflyLogo](./_images/dragonfly.png) ## 什么是 Dragonfly @@ -17,4 +17,4 @@ Dragonfly 是用 Go 语言编写的 Minecraft Bedrock Edition 服务器软件。 ## 链接 -- [Github 链接](https://github.com/df-mc/dragonfly) +- [GitHub 链接](https://github.com/df-mc/dragonfly) diff --git a/docs-bedrock/qitabe-core/mcpeserver/mcpeserver.md b/docs-bedrock/misc/mcpeserver.md similarity index 87% rename from docs-bedrock/qitabe-core/mcpeserver/mcpeserver.md rename to docs-bedrock/misc/mcpeserver.md index 436bef778..290699ba5 100644 --- a/docs-bedrock/qitabe-core/mcpeserver/mcpeserver.md +++ b/docs-bedrock/misc/mcpeserver.md @@ -5,7 +5,7 @@ sidebar_position: 1 ## 什么是 MCPEServer -mcpeserver 是一个用 Golang 编写的 Minecraft 服务器启动器。 +MCPEServer 是一个用 Golang 编写的 Minecraft 服务器启动器。 它利用 Minecraft 安卓 APK 文件中的内置服务器组件来运行一个原生的基岩版（Bedrock）服务器。 该项目已经标记为“已弃用”，建议使用官方的 BDS（Bedrock Dedicated Server）。 @@ -18,7 +18,7 @@ mcpeserver 是一个用 Golang 编写的 Minecraft 服务器启动器。 - **自动补全命令**：支持命令行自动补全功能。 - **完整的基岩版服务器功能**：支持 Minecraft 基岩版的所有功能和特性。 -- **基于 Systemd 的服务**：可以作为 Systemd 服务运行，便于管理。 +- **基于 systemd 的服务**：可以作为 systemd 服务运行，便于管理。 - **基于 DBus 的接口**：支持 DBus 接口，便于与其他系统组件交互。 - **配置灵活**：提供详细的服务器配置文件，用户可以自定义服务器的各种设置，例如世界名称、端口、最大玩家数等。 - **易于安装和管理**：提供了针对 Arch Linux 的安装指南，其他 Linux 发行版也可以参考相关文档进行安装。 @@ -26,4 +26,4 @@ mcpeserver 是一个用 Golang 编写的 Minecraft 服务器启动器。 ## 链接 -- [Github 链接](https://github.com/codehz/mcpeserver) +- [GitHub 链接](https://github.com/codehz/mcpeserver) diff --git a/docs-bedrock/qitabe-core/qitabe-core.md b/docs-bedrock/misc/misc.md similarity index 100% rename from docs-bedrock/qitabe-core/qitabe-core.md rename to docs-bedrock/misc/misc.md diff --git a/docs-bedrock/qitabe-core/preparation/preparation.md b/docs-bedrock/misc/preparation/preparation.md similarity index 100% rename from docs-bedrock/qitabe-core/preparation/preparation.md rename to docs-bedrock/misc/preparation/preparation.md diff --git a/docs-bedrock/qitabe-core/preparation/text-editor.md b/docs-bedrock/misc/preparation/text-editor.md similarity index 100% rename from docs-bedrock/qitabe-core/preparation/text-editor.md rename to docs-bedrock/misc/preparation/text-editor.md diff --git a/docs-bedrock/qitabe-core/preparation/websites.md b/docs-bedrock/misc/preparation/websites.md similarity index 93% rename from docs-bedrock/qitabe-core/preparation/websites.md rename to docs-bedrock/misc/preparation/websites.md index f30fd251f..f1509e06d 100644 --- a/docs-bedrock/qitabe-core/preparation/websites.md +++ b/docs-bedrock/misc/preparation/websites.md @@ -89,13 +89,13 @@ PocketMine-MP 官方团队建设的 PMMP 技术论坛，支持下载 PocketMine-
连不上怎么办 -这是由于 GitHub 是开放的外国网站，网站上时不时会有一些不能在此讨论的内容，所以运营商会刻意地屏蔽这个网站，在很多时候都不能正常访问。具体的表现如下：[只要 Github 域名指向任意 IP，该 IP 的 443 端口就会超时 3 分钟](https://blog.csdn.net/weixin_43659597/article/details/118882176)。 +这是由于 GitHub 是开放的外国网站，网站上时不时会有一些不能在此讨论的内容，所以运营商会刻意地屏蔽这个网站，在很多时候都不能正常访问。具体的表现如下：[只要 GitHub 域名指向任意 IP，该 IP 的 443 端口就会超时 3 分钟](https://blog.csdn.net/weixin_43659597/article/details/118882176)。 有以下几种解决办法： 1. 魔法 2. [改 hosts](https://www.cnblogs.com/eudaimonia/p/16001981.html#1034247326) -3. [Watt Toolkit](https://steampp.net/)：下载安装完成后，在左侧侧边栏切换到**网络加速**，点击**平台加速 (免费)**，往下翻勾上 GitHub，然后点击**一键加速**，随后就可以正常访问 GitHub 了 +3. [Watt Toolkit](https://steampp.net/)：下载安装完成后，在左侧侧边栏切换到 **网络加速**，点击 **平台加速 (免费)**，往下翻勾上 GitHub，然后点击 **一键加速**，随后就可以正常访问 GitHub 了
diff --git a/docs-bedrock/nukkit-core/history/history.md b/docs-bedrock/nukkit/history.md similarity index 93% rename from docs-bedrock/nukkit-core/history/history.md rename to docs-bedrock/nukkit/history.md index c30ddfe6a..8ef893939 100644 --- a/docs-bedrock/nukkit-core/history/history.md +++ b/docs-bedrock/nukkit/history.md @@ -7,7 +7,9 @@ import Tabs from '@theme/Tabs'; import TabItem from '@theme/TabItem'; :::tip + 在《我的世界：基岩版》中，Nukkit 作为最早的服务器软件之一，开启了多人服务器的先河。它凭借高性能、稳定性和可定制性，为玩家和开发者提供了全新体验，推动了技术进步和社区繁荣。然而，随着网易《我的世界》的出现，Nukkit 逐渐成为历史的遗憾。但它的精神和贡献激励着后继开发者继续探索和创新，为基岩版社区注入新活力，书写新的未来。 + ::: ![Nukkit logo](https://wiki.mcbe-dev.net/w/thumb.php?f=Nukkit.png&width=96) @@ -34,7 +36,7 @@ Nukkit 拥有相当丰富的社区分支，例如 PM1E、PowerNukkit 和 PowerNu ### 劣势 - Nukkit 最初为小游戏服务器设计，抛弃了很多原版游戏特性； -- Java 虚拟机（jvm）环境版本兼容性差； +- Java 虚拟机（JVM）环境版本兼容性差； - Java 多线程的优势并未得到充分利用； - 传统的石山代码和一些过时的架构影响着服务端的性能。 @@ -49,9 +51,9 @@ Nukkit 拥有相当丰富的社区分支，例如 PM1E、PowerNukkit 和 PowerNu | NukkitX | 别名：NKX | | -------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| 相关链接 | [NukkitX 官网](https://cloudburstmc.org/)、[Github 仓库](https://github.com/CloudburstMC/Nukkit) | +| 相关链接 | [NukkitX 官网](https://cloudburstmc.org/)、[GitHub 仓库](https://github.com/CloudburstMC/Nukkit) | | 作者 | [CloudburstMC](https://github.com/CloudburstMC) | -| 介绍 | NukkitX（原为 Nukkit2.0）是一个基于 Java 开发的高性能、开源的 Minecraft Bedrock Edition 服务端软件，继承了 Nukkit 的代码并不断优化，支持多种平台和丰富的插件扩展，为玩家和开发者提供了更稳定、更灵活的多人游戏体验 | +| 介绍 | NukkitX（原为 Nukkit 2.0）是一个基于 Java 开发的高性能、开源的 Minecraft Bedrock Edition 服务端软件，继承了 Nukkit 的代码并不断优化，支持多种平台和丰富的插件扩展，为玩家和开发者提供了更稳定、更灵活的多人游戏体验 | | 下载 | [构建站](https://ci.opencollab.dev/job/NukkitX/job/Nukkit/job/master/) | | 支持的 MC 版本 | 1.14.x-最新版 (目前保持更新) | @@ -60,7 +62,7 @@ Nukkit 拥有相当丰富的社区分支，例如 PM1E、PowerNukkit 和 PowerNu | Nukkit-MOT | 别名：NMOT | | -------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| 相关链接 | [Nukkit-MOT 官网](https://www.nukkit-mot.com/)、[Github 仓库](https://github.com/MemoriesOfTime/Nukkit-MOT) | +| 相关链接 | [Nukkit-MOT 官网](https://www.nukkit-mot.com/)、[GitHub 仓库](https://github.com/MemoriesOfTime/Nukkit-MOT) | | 作者 | [MemoriesOfTime](https://github.com/MemoriesOfTime) | | 介绍 | Nukkit-MOT 是基于 NukkitPetteriM1Edition 开发的 Minecraft Bedrock Edition 服务器软件，支持 1.2 至 1.21.50 版本，内置生物 AI 和原版命令，支持多版本协议和丰富的游戏特性 | | 下载 | [构建站](https://motci.cn/job/Nukkit-MOT/job/master/) | @@ -71,10 +73,10 @@ Nukkit 拥有相当丰富的社区分支，例如 PM1E、PowerNukkit 和 PowerNu | PowerNukkitX | 别名：PNX | | -------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| 相关链接 | [PowerNukkitX 官网](https://www.powernukkitx.cn/)、[Github 仓库](https://github.com/PowerNukkitX/PowerNukkitX) | +| 相关链接 | [PowerNukkitX 官网](https://www.powernukkitx.cn/)、[GitHub 仓库](https://github.com/PowerNukkitX/PowerNukkitX) | | 作者 | [PowerNukkitX](https://github.com/PowerNukkitX) | | 介绍 | PowerNukkitX（简称 PNX）是基于 PowerNukkit 和 Nukkit 的修改优化版本，修复了其 bug，添加了 BlocklyNukkit，LiteLoaderBDS 插件等更多功能的支持，内置了 Java 版服务端插件史诗地形生成器 (Terra) | -| 下载 | [Github](https://github.com/PowerNukkitX/PowerNukkitX/releases/download/snapshot/powernukkitx-run.zip) | +| 下载 | [GitHub](https://github.com/PowerNukkitX/PowerNukkitX/releases/download/snapshot/powernukkitx-run.zip) | | 支持的 MC 版本 | 1.17.x-最新版 (目前保持更新) | @@ -83,7 +85,9 @@ Nukkit 拥有相当丰富的社区分支，例如 PM1E、PowerNukkit 和 PowerNu ### 受争议的服务端 :::info + 此类服务端是因为其发生了一些令人抽象的事情，亦或者是某些原因导致名气变差 or 暂缓更新，但不代表他们不会更新 + ::: @@ -91,12 +95,12 @@ Nukkit 拥有相当丰富的社区分支，例如 PM1E、PowerNukkit 和 PowerNu | NukkitPetteriM1Edition | 别名：PM1ENK、Nukkit-PM1E、PM1E | | ---------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| 相关链接 | [Github 仓库](https://github.com/PetteriM1/NukkitPetteriM1Edition) | +| 相关链接 | [GitHub 仓库](https://github.com/PetteriM1/NukkitPetteriM1Edition) | | 作者 | [PetteriM1](https://github.com/PetteriM1/) | | 介绍 | Nukkit PetteriM1 Edition 是一个基于 Java 开发的 Minecraft Bedrock Edition 服务器软件的定制版本，由 Nukkit 核心开发者 PetteriM1 制作，支持从 1.2 到 最新版版本 的多客户端，并内置生物 AI 和生成功能 | -| 下载 | [Github Releases](https://github.com/PetteriM1/NukkitPetteriM1Edition/releases) | +| 下载 | [GitHub Releases](https://github.com/PetteriM1/NukkitPetteriM1Edition/releases) | | 支持的 MC 版本 | 1.13.x-最新版 (目前保持更新) | -| **争议问题** | **2022 年 11 月 15 日，PetteriM1 删除了 PM1E 仓库下的所有代码，并表示接下来只会发布混淆过的 jar 文件供使用。此举引起了社区的强烈不满，据知情人士透露，这么做的原因是为了防止"别人抄袭他的代码"。而在闭源后，PM1ENK 又被指控在接下来的更新中存在对 PowerNukkitX 的抄袭。在此期间，一位名为 sora-kawaii 的 Github 用户成功反混淆了 PM1ENK 并公布了源码，公开的代码显示了 PM1ENK 对开源项目的抄袭。2023 年 1 月 18 日，PM1ENK 发布了更新，此次更新被认为使用了业内最贵的付费混淆器 ZKM 以加强混淆效果，这一违背开源协议的行为立刻掀起了社区中抵制 PM1ENK 的浪潮，随后社区推出了基于 PM1ENK 最后一个开源版本开发的 Nukkit-MOT 核心。_（参考文章：刀哥《[为什么你不应该使用 PM1ENK - 细说 PM1ENK 的罪状](https://www.minebbs.com/threads/pm1enk-pm1enk.16912/)》_）** | +| **争议问题** | **2022 年 11 月 15 日，PetteriM1 删除了 PM1E 仓库下的所有代码，并表示接下来只会发布混淆过的 jar 文件供使用。此举引起了社区的强烈不满，据知情人士透露，这么做的原因是为了防止"别人抄袭他的代码"。而在闭源后，PM1ENK 又被指控在接下来的更新中存在对 PowerNukkitX 的抄袭。在此期间，一位名为 sora-kawaii 的 GitHub 用户成功反混淆了 PM1ENK 并公布了源码，公开的代码显示了 PM1ENK 对开源项目的抄袭。2023 年 1 月 18 日，PM1ENK 发布了更新，此次更新被认为使用了业内最贵的付费混淆器 ZKM 以加强混淆效果，这一违背开源协议的行为立刻掀起了社区中抵制 PM1ENK 的浪潮，随后社区推出了基于 PM1ENK 最后一个开源版本开发的 Nukkit-MOT 核心。_（参考文章：刀哥《[为什么你不应该使用 PM1ENK - 细说 PM1ENK 的罪状](https://www.minebbs.com/threads/pm1enk-pm1enk.16912/)》_）** | @@ -108,9 +112,9 @@ Nukkit 拥有相当丰富的社区分支，例如 PM1E、PowerNukkit 和 PowerNu | Nukkit | 别名：NK | | -------------- | --------------------------------------------------------------------- | -| 相关链接 | [Github 仓库](https://github.com/Nukkit/Nukkit) | +| 相关链接 | [GitHub 仓库](https://github.com/Nukkit/Nukkit) | | 作者 | [Nukkit Project](https://github.com/Nukkit) | -| 介绍 | 第一代 Nukkit，现已停止更新并转移到 Nukkit2.0（项目重命名为 NukkitX） | +| 介绍 | 第一代 Nukkit，现已停止更新并转移到 Nukkit 2.0（项目重命名为 NukkitX） | | 下载 | 无 | | 支持的 MC 版本 | 携带版 0.12-1.14.x | @@ -119,10 +123,10 @@ Nukkit 拥有相当丰富的社区分支，例如 PM1E、PowerNukkit 和 PowerNu | PowerNukkit | --- | | -------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| 相关链接 | [PowerNukkit 官网](https://powernukkit.org/)、[Github 仓库](https://github.com/PowerNukkit/PowerNukkit) | +| 相关链接 | [PowerNukkit 官网](https://powernukkit.org/)、[GitHub 仓库](https://github.com/PowerNukkit/PowerNukkit) | | 作者 | [PowerNukkit](https://github.com/PowerNukkit/) | -| 介绍 | PowerNukkit 是一个基于 Nukkit 的 Minecraft Bedrock Edition 服务器软件分支，支持几乎所有单机方块和物品，增加了大量新特性（如含水方块、红石、副手槽等），并修复了众多在 Nukkit 上出现的 Bug | -| 下载 | [Github Releases](https://github.com/PowerNukkit/PowerNukkit/releases) | +| 介绍 | PowerNukkit 是一个基于 Nukkit 的 Minecraft Bedrock Edition 服务器软件分支，支持几乎所有单机方块和物品，增加了大量新特性（如含水方块、红石、副手槽等），并修复了众多在 Nukkit 上出现的 bug | +| 下载 | [GitHub Releases](https://github.com/PowerNukkit/PowerNukkit/releases) | | 支持的 MC 版本 | 1.12.x-1.18.0 | @@ -130,7 +134,7 @@ Nukkit 拥有相当丰富的社区分支，例如 PM1E、PowerNukkit 和 PowerNu | NukkitPetteriM1Edition-MOT | --- | | -------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| 相关链接 | [Github 仓库](https://github.com/MemoriesOfTime/NukkitPetteriM1Edition) | +| 相关链接 | [GitHub 仓库](https://github.com/MemoriesOfTime/NukkitPetteriM1Edition) | | 作者 | [MemoriesOfTime](https://github.com/MemoriesOfTime) | | 介绍 | NukkitPetteriM1Edition 事件发生后，MemoriesOfTime 团队第一时间保存了该项目的最后一次更新的代码，并结合了 sora-kawaii 反编译开源出来的代码进行续写并转移仓库为 **Nukkit-MOT** | | 下载 | 无 | diff --git a/docs-bedrock/nukkit-core/nukkit-core.md b/docs-bedrock/nukkit/nukkit.md similarity index 100% rename from docs-bedrock/nukkit-core/nukkit-core.md rename to docs-bedrock/nukkit/nukkit.md diff --git a/docs-bedrock/nukkit-core/preparation/choose-and-download-and-install-java.md b/docs-bedrock/nukkit/preparation/choose-and-download-and-install-java.md similarity index 100% rename from docs-bedrock/nukkit-core/preparation/choose-and-download-and-install-java.md rename to docs-bedrock/nukkit/preparation/choose-and-download-and-install-java.md diff --git a/docs-bedrock/nukkit-core/preparation/preparation.md b/docs-bedrock/nukkit/preparation/preparation.md similarity index 100% rename from docs-bedrock/nukkit-core/preparation/preparation.md rename to docs-bedrock/nukkit/preparation/preparation.md diff --git a/docs-bedrock/nukkit-core/preparation/text-editor.md b/docs-bedrock/nukkit/preparation/text-editor.md similarity index 100% rename from docs-bedrock/nukkit-core/preparation/text-editor.md rename to docs-bedrock/nukkit/preparation/text-editor.md diff --git a/docs-bedrock/nukkit-core/preparation/websites.md b/docs-bedrock/nukkit/preparation/websites.md similarity index 94% rename from docs-bedrock/nukkit-core/preparation/websites.md rename to docs-bedrock/nukkit/preparation/websites.md index 012c30548..da04c8d41 100644 --- a/docs-bedrock/nukkit-core/preparation/websites.md +++ b/docs-bedrock/nukkit/preparation/websites.md @@ -110,13 +110,13 @@ NukkitX 官方搭建的资源中心，支持下载 Nukkit 插件。
连不上怎么办 -这是由于 GitHub 是开放的外国网站，网站上时不时会有一些不能在此讨论的内容，所以运营商会刻意地屏蔽这个网站，在很多时候都不能正常访问。具体的表现如下：[只要 Github 域名指向任意 IP，该 IP 的 443 端口就会超时 3 分钟](https://blog.csdn.net/weixin_43659597/article/details/118882176)。 +这是由于 GitHub 是开放的外国网站，网站上时不时会有一些不能在此讨论的内容，所以运营商会刻意地屏蔽这个网站，在很多时候都不能正常访问。具体的表现如下：[只要 GitHub 域名指向任意 IP，该 IP 的 443 端口就会超时 3 分钟](https://blog.csdn.net/weixin_43659597/article/details/118882176)。 有以下几种解决办法： 1. 魔法 2. [改 hosts](https://www.cnblogs.com/eudaimonia/p/16001981.html#1034247326) -3. [Watt Toolkit](https://steampp.net/)：下载安装完成后，在左侧侧边栏切换到**网络加速**，点击**平台加速 (免费)**，往下翻勾上 GitHub，然后点击**一键加速**，随后就可以正常访问 GitHub 了 +3. [Watt Toolkit](https://steampp.net/)：下载安装完成后，在左侧侧边栏切换到 **网络加速**，点击 **平台加速 (免费)**，往下翻勾上 GitHub，然后点击 **一键加速**，随后就可以正常访问 GitHub 了
diff --git a/docs-bedrock/nukkit-core/start/basic/basic.md b/docs-bedrock/nukkit/start/basic/basic.md similarity index 100% rename from docs-bedrock/nukkit-core/start/basic/basic.md rename to docs-bedrock/nukkit/start/basic/basic.md diff --git a/docs-bedrock/nukkit-core/start/basic/server-file-structure.md b/docs-bedrock/nukkit/start/basic/server-file-structure.md similarity index 54% rename from docs-bedrock/nukkit-core/start/basic/server-file-structure.md rename to docs-bedrock/nukkit/start/basic/server-file-structure.md index 28967e1ec..c986cca55 100644 --- a/docs-bedrock/nukkit-core/start/basic/server-file-structure.md +++ b/docs-bedrock/nukkit/start/basic/server-file-structure.md @@ -7,11 +7,12 @@ sidebar_position: 1 我们先来简单看一眼 Nukkit **开服后** 的文件夹结构（大致结构是这样，部分分支会因为加了不同的功能结构会不一样）： + ```c Nukkit Server/ ├── nukkit-1.0-SNAPSHOT.jar //服务器核心 ├── start.bat // Windows 运行脚本 -├── start.sh // linux 运行脚本 +├── start.sh // Linux 运行脚本 ├── start.command // macOS 运行脚本 ├── server.properties // 服务端配置文件 ├── permissions.yml // 用于设置玩家权限的 @@ -40,65 +41,65 @@ Nukkit Server/ --- - `nukkit-1.0-SNAPSHOT.jar` - - 这是 Nukkit 的核心程序文件，用于启动和运行服务端。 + - 这是 Nukkit 的核心程序文件，用于启动和运行服务端。 --- - `start.bat / start.sh / start.command` - - 启动服务器的脚本文件，分别对应 Windows、Linux 和 macOS 系统，用于启动和运行《我的世界》基岩版服务器。 + - 启动服务器的脚本文件，分别对应 Windows、Linux 和 macOS 系统，用于启动和运行《我的世界》基岩版服务器。 - - 你可以改名叫任何名字 (只要以 `.bat / .sh / .command` 结尾就行)，但不建议你这么做，可能会导致成为后续操作报错的因素。例如： + - 你可以改名叫任何名字 (只要以 `.bat / .sh / .command` 结尾就行)，但不建议你这么做，可能会导致成为后续操作报错的因素。例如： 1. 若你使用 **面板** 开服，需要在对应的 **启动路径** 中修改服务端启动程序的文件名 2. 若你使用 **启用脚本** 开服，需要在脚本对应位置的 **启动命令** 中修改 **启动程序的文件名** 为 **该服务端启动程序的文件名** --- - `server.properties` - - 这是服务器的主要配置文件，用于设置服务器的各种参数，如服务器名称、端口号、最大玩家数、游戏模式等。 + - 这是服务器的主要配置文件，用于设置服务器的各种参数，如服务器名称、端口号、最大玩家数、游戏模式等。 --- - `permissions.yml` - - 用于设置玩家权限的文件，可以定义不同用户组的权限。 + - 用于设置玩家权限的文件，可以定义不同用户组的权限。 --- - `banned-players.txt 和 banned-ips.txt` - - 分别用于存储被封禁的玩家名单和 IP 地址。 + - 分别用于存储被封禁的玩家名单和 IP 地址。 --- - `worlds` - - 这是存储主世界文件夹的地方。每个世界都有自己的子文件夹，其中包含该世界的所有数据，如地形、建筑、玩家进度等。 - - `world` - - 包含特定世界的存档数据。 - - `level_dat` - - 世界的基本信息文件。 - - `region 文件夹` - - 存储世界区块数据。 - - `entities 文件夹` - - 存储世界中的实体数据。 + - 这是存储主世界文件夹的地方。每个世界都有自己的子文件夹，其中包含该世界的所有数据，如地形、建筑、玩家进度等。 + - `world` + - 包含特定世界的存档数据。 + - `level_dat` + - 世界的基本信息文件。 + - `region 文件夹` + - 存储世界区块数据。 + - `entities 文件夹` + - 存储世界中的实体数据。 --- - `plugins 文件夹` - - 用于存放所有插件的 .jar 文件。插件可以扩展服务器的功能，例如添加新的命令、游戏规则或事件处理。 + - 用于存放所有插件的 .jar 文件。插件可以扩展服务器的功能，例如添加新的命令、游戏规则或事件处理。 --- - `whitelist.txt` - - 白名单文件，列出了允许进入服务器的玩家列表。 - - (如果你在 `server.properties` 中开启了白名单，你就可以在该文件中添加和管理谁被允许或不被允许进入服务器)。 + - 白名单文件，列出了允许进入服务器的玩家列表。 + - (如果你在 `server.properties` 中开启了白名单，你就可以在该文件中添加和管理谁被允许或不被允许进入服务器)。 --- - `logs 文件夹` - - 存储服务器运行时生成的日志文件，用于记录服务器的运行状态和玩家行为。 + - 存储服务器运行时生成的日志文件，用于记录服务器的运行状态和玩家行为。 --- - `rcon_password.txt` - - 用于存储 RCON（远程控制）功能的密码。 + - 用于存储 RCON（远程控制）功能的密码。 --- diff --git a/docs-bedrock/nukkit-core/start/nukkitmot-core/nukkitmot/nukkitmot.md b/docs-bedrock/nukkit/start/nukkitmot/description.md similarity index 100% rename from docs-bedrock/nukkit-core/start/nukkitmot-core/nukkitmot/nukkitmot.md rename to docs-bedrock/nukkit/start/nukkitmot/description.md diff --git a/docs-bedrock/nukkit-core/start/nukkitmot-core/nukkitmot-core.md b/docs-bedrock/nukkit/start/nukkitmot/nukkitmot.md similarity index 100% rename from docs-bedrock/nukkit-core/start/nukkitmot-core/nukkitmot-core.md rename to docs-bedrock/nukkit/start/nukkitmot/nukkitmot.md diff --git a/docs-bedrock/nukkit-core/start/nukkitx-core/nukkitx/nukkitx.md b/docs-bedrock/nukkit/start/nukkitx/description.md similarity index 94% rename from docs-bedrock/nukkit-core/start/nukkitx-core/nukkitx/nukkitx.md rename to docs-bedrock/nukkit/start/nukkitx/description.md index 29d81f0d9..8066fc1a1 100644 --- a/docs-bedrock/nukkit-core/start/nukkitx-core/nukkitx/nukkitx.md +++ b/docs-bedrock/nukkit/start/nukkitx/description.md @@ -21,4 +21,4 @@ NukkitX 的开发团队 CloudburstMC 专注于维护和改进 NukkitX，但不 ## 链接 -- [Github 链接](https://github.com/CloudburstMC/Nukkit) +- [GitHub 链接](https://github.com/CloudburstMC/Nukkit) diff --git a/docs-bedrock/nukkit-core/start/nukkitx-core/nukkitx-core.md b/docs-bedrock/nukkit/start/nukkitx/nukkitx.md similarity index 100% rename from docs-bedrock/nukkit-core/start/nukkitx-core/nukkitx-core.md rename to docs-bedrock/nukkit/start/nukkitx/nukkitx.md diff --git a/docs-bedrock/nukkit-core/start/pm1e-core/zhengyi/zhengyi.png b/docs-bedrock/nukkit/start/pm1e/_images/controversy.png similarity index 100% rename from docs-bedrock/nukkit-core/start/pm1e-core/zhengyi/zhengyi.png rename to docs-bedrock/nukkit/start/pm1e/_images/controversy.png diff --git a/docs-bedrock/nukkit-core/start/pm1e-core/zhengyi/zhengyi.md b/docs-bedrock/nukkit/start/pm1e/controversy.md similarity index 94% rename from docs-bedrock/nukkit-core/start/pm1e-core/zhengyi/zhengyi.md rename to docs-bedrock/nukkit/start/pm1e/controversy.md index e8f6d5c9a..3c6ce6cb9 100644 --- a/docs-bedrock/nukkit-core/start/pm1e-core/zhengyi/zhengyi.md +++ b/docs-bedrock/nukkit/start/pm1e/controversy.md @@ -4,6 +4,7 @@ sidebar_position: 1 --- :::warning + Nukkit PetteriM1 Edition 是一个独立开发的开源项目，由 PetteriM1 及其团队负责维护和更新 该项目任何争议事件与 NitWiki 站点以及任何文档维护者没有任何关联 @@ -11,14 +12,17 @@ Nukkit PetteriM1 Edition 是一个独立开发的开源项目，由 PetteriM1 NitWiki 仅提供关于 Nukkit PetteriM1 Edition 的信息和教程，但不对该项目的开发、维护或任何相关争议负责 所有关于 Nukkit PetteriM1 Edition 的开发、更新和维护均由 PetteriM1 及其团队独立完成，与 NitWiki 站点和文档维护者无关 + ::: :::tip + 本事件自己去看，我们不会录入：刀哥《[为什么你不应该使用 PM1ENK - 细说 PM1ENK 的罪状](https://www.minebbs.com/threads/pm1enk-pm1enk.16912/)》 还有：NukkitPetteriM1Edition 不知道啥时候开始老老实实把源代码推回来了： -![?](./zhengyi.png) +![?](./_images/controversy.png) + ::: 大致事件如下： @@ -29,7 +33,7 @@ NitWiki 仅提供关于 Nukkit PetteriM1 Edition 的信息和教程，但不对 而在闭源后，PM1ENK 又被指控在接下来的更新中存在对 PowerNukkitX 的抄袭 -在此期间，一位名为 sora-kawaii 的 Github 用户成功反混淆了 PM1ENK 并公布了源码，公开的代码显示了 PM1ENK 对开源项目的抄袭 +在此期间，一位名为 sora-kawaii 的 GitHub 用户成功反混淆了 PM1ENK 并公布了源码，公开的代码显示了 PM1ENK 对开源项目的抄袭 2023 年 1 月 18 日，PM1ENK 发布了更新，此次更新被认为使用了业内最贵的付费混淆器 ZKM 以加强混淆效果 diff --git a/docs-bedrock/nukkit-core/start/pm1e-core/pm1e/pm1e.md b/docs-bedrock/nukkit/start/pm1e/description.md similarity index 81% rename from docs-bedrock/nukkit-core/start/pm1e-core/pm1e/pm1e.md rename to docs-bedrock/nukkit/start/pm1e/description.md index aaf753ae5..af2bf71df 100644 --- a/docs-bedrock/nukkit-core/start/pm1e-core/pm1e/pm1e.md +++ b/docs-bedrock/nukkit/start/pm1e/description.md @@ -14,15 +14,15 @@ NukkitPetteriM1Edition（简称 NukkitPM1E）是 PetteriM1 为他的服务器 Su ## 特色 - 内置生物 AI 和生物生成 -- 更多可用的方块、物品和命令（地图、盾牌、炼药锅、弩、更多的红石物品、一些教育版的化学方块、/playsound 命令等） +- 更多可用的方块、物品和命令（地图、盾牌、炼药锅、弩、更多的红石物品、一些教育版的化学方块、`/playsound` 命令等） - 更好的稳定性 - 修复了许多错误和漏洞 -- server.properties 中增加更多可供设置的内容 +- `server.properties` 中增加更多可供设置的内容 - 从 1.2.0 到最新版本的多版本支持（不再积极维护对最旧版本的支持，也不是所有的 beta 版本都受支持） -- 内置多世界命令（/world、/genworld、启动时自动加载所有世界的选项） +- 内置多世界命令（`/world`、`/genworld`、启动时自动加载所有世界的选项） - 许多性能改进 - 世界生成的一些调整和原版建筑结构的生成 ## 链接 -- [Github 链接](https://github.com/PetteriM1/NukkitPetteriM1Edition) +- [GitHub 链接](https://github.com/PetteriM1/NukkitPetteriM1Edition) diff --git a/docs-bedrock/nukkit-core/start/pm1e-core/pm1e-core.md b/docs-bedrock/nukkit/start/pm1e/pm1e.md similarity index 100% rename from docs-bedrock/nukkit-core/start/pm1e-core/pm1e-core.md rename to docs-bedrock/nukkit/start/pm1e/pm1e.md diff --git a/docs-bedrock/nukkit-core/start/pnx-core/pnx/pnx.md b/docs-bedrock/nukkit/start/pnx/description.md similarity index 88% rename from docs-bedrock/nukkit-core/start/pnx-core/pnx/pnx.md rename to docs-bedrock/nukkit/start/pnx/description.md index 47f732628..fccd6020e 100644 --- a/docs-bedrock/nukkit-core/start/pnx-core/pnx/pnx.md +++ b/docs-bedrock/nukkit/start/pnx/description.md @@ -8,13 +8,13 @@ sidebar_position: 1 ## 什么是 PowerNukkitX PowerNukkitX（简称 PNX）是由包括 BlocklyNukkit 团队在内的中国 Nukkit 开发者们负责开发维护的 Nukkit 分支版本， -修复了众多 BUG，改善了性能，及时跟进新版本支持、支持 1.19 所有新方块和新物品、支持新版下界、支持史诗地形生成器 (Terra)。 +修复了众多 bug，改善了性能，及时跟进新版本支持、支持 1.19 所有新方块和新物品、支持新版下界、支持史诗地形生成器 (Terra)。 在这些大更改的情况下，PNX 仍然保持了良好的插件兼容性，Nukkit 生态中的数千个插件仍然可以在 PNX 上运行。 得益于完全开源的代码，您在遵守开源协议的情况下使用 PowerNukkitX 没有任何法律风险， 内部的数十万 API 可以随意调用，您可以深入查看实现， 通过 JVM 生态中的各种工具及其方便地进行开发、调试、注入、拦截。也正因如此， -Nukkit 生态丰富多彩，成百上千各种各样的插件供您选择，您可以用您喜欢的任意 JVM 语言编写插件，如 Java,Kotlin,Scala…… ，同时也支持使用 Javascript 编写插件。 +Nukkit 生态丰富多彩，成百上千各种各样的插件供您选择，您可以用您喜欢的任意 JVM 语言编写插件，如 Java, Kotlin, Scala…… ，同时也支持使用 JavaScript 编写插件。 ## 特色 @@ -30,4 +30,4 @@ Nukkit 生态丰富多彩，成百上千各种各样的插件供您选择，您 ## 链接 -- [Github 链接](https://github.com/PowerNukkitX/PowerNukkitX) +- [GitHub 链接](https://github.com/PowerNukkitX/PowerNukkitX) diff --git a/docs-bedrock/nukkit-core/start/pnx-core/pnx-core.md b/docs-bedrock/nukkit/start/pnx/pnx.md similarity index 100% rename from docs-bedrock/nukkit-core/start/pnx-core/pnx-core.md rename to docs-bedrock/nukkit/start/pnx/pnx.md diff --git a/docs-bedrock/nukkit-core/start/start.md b/docs-bedrock/nukkit/start/start.md similarity index 100% rename from docs-bedrock/nukkit-core/start/start.md rename to docs-bedrock/nukkit/start/start.md diff --git a/docs-bedrock/pocketmine-core/pocketmine/pocketmine.md b/docs-bedrock/pocketmine/description.md similarity index 88% rename from docs-bedrock/pocketmine-core/pocketmine/pocketmine.md rename to docs-bedrock/pocketmine/description.md index 842fc9953..595cdc1a3 100644 --- a/docs-bedrock/pocketmine-core/pocketmine/pocketmine.md +++ b/docs-bedrock/pocketmine/description.md @@ -7,7 +7,9 @@ import Tabs from '@theme/Tabs'; import TabItem from '@theme/TabItem'; :::tip + 作为最早出现的 Minecraft Bedrock Edition 服务端之一，PocketMine-MP 与 Nukkit 一样，为基岩版社区贡献了重要力量。它凭借强大的功能和灵活的插件系统，成为众多玩家和开发者的选择。随着 PocketMine-MP 的知名度不断提升，我们相信后继开发者将继续在此基础上创新，为基岩版社区注入新活力，提供更优质的服务。 + ::: ![PMMPLogo](https://www.minebbs.com/attachments/pocketmine-light-rgb-gif.47206/) @@ -35,11 +37,11 @@ PMMP 是 PocketMine-MP 的分支，由 PMMP 团队负责更新维护，目前已 | PocketMine-MP | 别名：PMMP | | -------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- | -| 相关链接 | [PMMP 官网](https://pmmp.io/)、[Github 仓库](https://github.com/pmmp/PocketMine-MP) | +| 相关链接 | [PMMP 官网](https://pmmp.io/)、[GitHub 仓库](https://github.com/pmmp/PocketMine-MP) | | 作者 | [pmmp](https://github.com/pmmp/) | | 介绍 | PocketMine-MP 是一款高度可定制的 Minecraft: Bedrock Edition 服务器软件，支持多版本，具备强大的插件 API 和丰富的生态系统，适合需要自定义功能的服务器 | -| 下载 | [Github Releases](https://github.com/pmmp/PocketMine-MP/releases) | -| 支持的 MC 版本 | 携带版 0.7.2-1.21.50(目前保持更新) | +| 下载 | [GitHub Releases](https://github.com/pmmp/PocketMine-MP/releases) | +| 支持的 MC 版本 | 携带版 0.7.2-1.21.50 (目前保持更新) | @@ -47,11 +49,13 @@ PMMP 是 PocketMine-MP 的分支，由 PMMP 团队负责更新维护，目前已 ### 不稳定更新的服务端 :::warning + 此类服务端一般为个人或者团队非开源更新，不能保证长期更新 NitWiki 仅提供关于 PocketMine-MP 分支的信息和教程，但不对其项目的开发、维护或任何相关争议负责 所有关于 PocketMine-MP 分支的开发、更新和维护均由 PetteriM1 及其团队独立完成，与 NitWiki 站点和文档维护者无关 + ::: @@ -61,7 +65,7 @@ NitWiki 仅提供关于 PocketMine-MP 分支的信息和教程，但不对其项 | -------------- | ------------------------------------------------------------------------------------------- | | 相关链接 | [MineBBS 投稿贴](https://www.minebbs.com/resources/pmmp5-ng-nethergames-1-20-1-21-50.8967/) | | 作者 | [QYE](https://www.minebbs.com/members/qye.35358/) | -| 介绍 | 多版本的 pmmp5 核心-NG(NetherGames) 官方核心 - 支持 1.20-1.21.50 | +| 介绍 | 多版本的 pmmp5 核心-NG (NetherGames) 官方核心 - 支持 1.20-1.21.50 | | 下载 | [MineBBS](https://www.minebbs.com/resources/pmmp5-ng-nethergames-1-20-1-21-50.8967/) | | 支持的 MC 版本 | 1.20-1.21.50 | @@ -72,7 +76,7 @@ NitWiki 仅提供关于 PocketMine-MP 分支的信息和教程，但不对其项 | -------------- | ------------------------------------------------------------------------------------------- | | 相关链接 | [MineBBS 投稿贴](https://www.minebbs.com/resources/qf-qosgames-qfmc-pm4-1-20-1-20-50.7249/) | | 作者 | [QYE](https://www.minebbs.com/members/qye.35358/) | -| 介绍 | QF-QosGames(QFMC) 核心 PM4 多版本 - 现已支持 1.20-1.20.50 基岩版 | +| 介绍 | QF-QosGames (QFMC) 核心 PM4 多版本 - 现已支持 1.20-1.20.50 基岩版 | | 下载 | [MineBBS](https://www.minebbs.com/resources/qf-qosgames-qfmc-pm4-1-20-1-20-50.7249/) | | 支持的 MC 版本 | 1.20-1.20.50 | @@ -86,7 +90,7 @@ NitWiki 仅提供关于 PocketMine-MP 分支的信息和教程，但不对其项 | Turanic | --- | | -------------- | ------------------------------------------------------------------------------------------------ | -| 相关链接 | [Github 仓库](https://github.com/unresolved3169/Turanic) | +| 相关链接 | [GitHub 仓库](https://github.com/unresolved3169/Turanic) | | 作者 | [unresolved3169](https://github.com/unresolved3169) | | 介绍 | 基于 GenisysPro 的一个分支，添加了虚空维度、天气变化、下界门户等生存特性，现已停更并转移到 Altay | | 下载 | 无 | @@ -97,10 +101,10 @@ NitWiki 仅提供关于 PocketMine-MP 分支的信息和教程，但不对其项 | Altay | --- | | -------------- | ---------------------------------------------------------------------- | -| 相关链接 | [Github 仓库](https://github.com/unresolved3169/Altay) | +| 相关链接 | [GitHub 仓库](https://github.com/unresolved3169/Altay) | | 作者 | [unresolved3169](https://github.com/unresolved3169) | | 介绍 | 基于 Turanic 的优化版本，新增大量生存特性与优化，现已停更 | -| 下载 | [Github Releases](https://github.com/PowerNukkit/PowerNukkit/releases) | +| 下载 | [GitHub Releases](https://github.com/PowerNukkit/PowerNukkit/releases) | | 支持的 MC 版本 | 1.11.x | @@ -108,20 +112,20 @@ NitWiki 仅提供关于 PocketMine-MP 分支的信息和教程，但不对其项 | GenisysPro | --- | | -------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| 相关链接 | [Github 仓库](https://github.com/GenisysPro/GenisysPro/) | +| 相关链接 | [GitHub 仓库](https://github.com/GenisysPro/GenisysPro/) | | 作者 | [GenisysPro](https://github.com/GenisysPro/) | | 介绍 | GenisysPro 是一款基于 Genisys 开发的多功能 Minecraft 服务器软件，支持 Minecraft PE 和 Windows 10 Edition v1.1.x 版本，具备丰富的功能和性能优化，但目前已停更 | -| 下载 | [Github Releases](https://github.com/GenisysPro/GenisysPro/releases) | +| 下载 | [GitHub Releases](https://github.com/GenisysPro/GenisysPro/releases) | | 支持的 MC 版本 | 1.1.x | - + -| BlueLight-oldAPI | --- | +| BlueLight-OldAPI | --- | | ---------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| 相关链接 | [Github 仓库](https://github.com/BlueLightJapan/BlueLight) | +| 相关链接 | [GitHub 仓库](https://github.com/BlueLightJapan/BlueLight) | | 作者 | [BlueLightJapan](https://github.com/BlueLightJapan/) | -| 介绍 | BlueLight-oldAPI 是一款基于 PocketMine-MP 开发的 Minecraft: Pocket Edition 服务器软件，主要特点是支持旧 API（1.2 核心），能够在无需修改的情况下使用 1.0 的插件 | +| 介绍 | BlueLight-OldAPI 是一款基于 PocketMine-MP 开发的 Minecraft: Pocket Edition 服务器软件，主要特点是支持旧 API（1.2 核心），能够在无需修改的情况下使用 1.0 的插件 | | 下载 | 无 | | 支持的 MC 版本 | 1.2.x | @@ -130,7 +134,7 @@ NitWiki 仅提供关于 PocketMine-MP 分支的信息和教程，但不对其项 | Steadfast2 | --- | | -------------- | ------------------------------------------------------------------------------ | -| 相关链接 | [Github 仓库](https://github.com/Hydreon/Steadfast2) | +| 相关链接 | [GitHub 仓库](https://github.com/Hydreon/Steadfast2) | | 作者 | [Hydreon Corporation](https://github.com/Hydreon) | | 介绍 | 基于 PMMP 进行多版本协议优化，使不同版本能连接到一个服务器上，现已与 PMMP 合并 | | 下载 | 无 | diff --git a/docs-bedrock/pocketmine-core/pocketmine-core.md b/docs-bedrock/pocketmine/pocketmine.md similarity index 87% rename from docs-bedrock/pocketmine-core/pocketmine-core.md rename to docs-bedrock/pocketmine/pocketmine.md index b8420c566..2e5ce9582 100644 --- a/docs-bedrock/pocketmine-core/pocketmine-core.md +++ b/docs-bedrock/pocketmine/pocketmine.md @@ -1,7 +1,7 @@ --- title: PocketMine 核心 slug: /pocketmine-core -sidebar_position: 5 +sidebar_position: 4 --- # PocketMine 核心 diff --git a/docs-bedrock/pocketmine-core/preparation/choose-and-download-and-install-php.md b/docs-bedrock/pocketmine/preparation/choose-and-download-and-install-php.md similarity index 86% rename from docs-bedrock/pocketmine-core/preparation/choose-and-download-and-install-php.md rename to docs-bedrock/pocketmine/preparation/choose-and-download-and-install-php.md index 6314b43b5..fdd59ff06 100644 --- a/docs-bedrock/pocketmine-core/preparation/choose-and-download-and-install-php.md +++ b/docs-bedrock/pocketmine/preparation/choose-and-download-and-install-php.md @@ -6,6 +6,7 @@ sidebar_position: 1 # 选择、下载和安装 PHP :::tip + PHP 安装等待有缘人进行补充修改...... ps：因为 PHP 官网下载的 PHP 环境是纯净版，没有任何依赖，但是大多数 PHP 环境是需要部分依赖 @@ -17,8 +18,9 @@ ps：因为 PHP 官网下载的 PHP 环境是纯净版，没有任何依赖， 如果你是 PMMP 使用者并且愿意为我们提供更多关于 PMMP 的信息支持，请在 NitWiki 仓库中提 PR 或者 QQ 群联系 如果你真的需要安装 PMMP，请参考官方安装文档：[PMMP 安装文档](https://doc.pmmp.io/en/rtfd/installation.html) + ::: ## 安装环境 -推荐 PMMP 专门打包 PHP 的 Github 仓库下载对应系统的 PHP 文件：[Github Releases](https://github.com/pmmp/PHP-Binaries/releases) +推荐 PMMP 专门打包 PHP 的 GitHub 仓库下载对应系统的 PHP 文件：[GitHub Releases](https://github.com/pmmp/PHP-Binaries/releases) diff --git a/docs-bedrock/pocketmine-core/preparation/preparation.md b/docs-bedrock/pocketmine/preparation/preparation.md similarity index 100% rename from docs-bedrock/pocketmine-core/preparation/preparation.md rename to docs-bedrock/pocketmine/preparation/preparation.md diff --git a/docs-bedrock/pocketmine-core/preparation/text-editor.md b/docs-bedrock/pocketmine/preparation/text-editor.md similarity index 100% rename from docs-bedrock/pocketmine-core/preparation/text-editor.md rename to docs-bedrock/pocketmine/preparation/text-editor.md diff --git a/docs-bedrock/pocketmine-core/preparation/websites.md b/docs-bedrock/pocketmine/preparation/websites.md similarity index 93% rename from docs-bedrock/pocketmine-core/preparation/websites.md rename to docs-bedrock/pocketmine/preparation/websites.md index 54b1ca700..89bf217b7 100644 --- a/docs-bedrock/pocketmine-core/preparation/websites.md +++ b/docs-bedrock/pocketmine/preparation/websites.md @@ -91,13 +91,13 @@ PocketMine-MP 官方团队建设的 PMMP 技术论坛，支持下载 PocketMine-
连不上怎么办 -这是由于 GitHub 是开放的外国网站，网站上时不时会有一些不能在此讨论的内容，所以运营商会刻意地屏蔽这个网站，在很多时候都不能正常访问。具体的表现如下：[只要 Github 域名指向任意 IP，该 IP 的 443 端口就会超时 3 分钟](https://blog.csdn.net/weixin_43659597/article/details/118882176)。 +这是由于 GitHub 是开放的外国网站，网站上时不时会有一些不能在此讨论的内容，所以运营商会刻意地屏蔽这个网站，在很多时候都不能正常访问。具体的表现如下：[只要 GitHub 域名指向任意 IP，该 IP 的 443 端口就会超时 3 分钟](https://blog.csdn.net/weixin_43659597/article/details/118882176)。 有以下几种解决办法： 1. 魔法 2. [改 hosts](https://www.cnblogs.com/eudaimonia/p/16001981.html#1034247326) -3. [Watt Toolkit](https://steampp.net/)：下载安装完成后，在左侧侧边栏切换到**网络加速**，点击**平台加速 (免费)**，往下翻勾上 GitHub，然后点击**一键加速**，随后就可以正常访问 GitHub 了 +3. [Watt Toolkit](https://steampp.net/)：下载安装完成后，在左侧侧边栏切换到 **网络加速**，点击 **平台加速 (免费)**，往下翻勾上 GitHub，然后点击 **一键加速**，随后就可以正常访问 GitHub 了
diff --git a/docs-bedrock/super-basic/protocol-version-number.md b/docs-bedrock/super-basic/protocol-version-number.md index f543155b8..1102426eb 100644 --- a/docs-bedrock/super-basic/protocol-version-number.md +++ b/docs-bedrock/super-basic/protocol-version-number.md @@ -13,9 +13,9 @@ Minecraft Wiki 中有对该概念的 [详细介绍](https://zh.minecraft.wiki/w/ ## 更新规律 -通常来说，MOJANG 会在每个修订版本号十位发生改变时改变协议版本。例如，1.20.10 - 1.20.15 同为协议版本 594，而 1.20.30 开始协议版本变更为 618。 +通常来说，Mojang 会在每个修订版本号十位发生改变时改变协议版本。例如，1.20.10 - 1.20.15 同为协议版本 594，而 1.20.30 开始协议版本变更为 618。 之后的 1.20.31、1.20.32 都是 618 协议版本，到 1.20.40 时再次更新为 622。 -有时 MOJANG 会为了一些原因和目的在十位之内更新协议版本，例如 1.19.60 - 62 和 1.19.63 协议版本不同，1.21.0 - 1.21.1 和 1.21.2 - 1.21.3 协议版本不同。 +有时 Mojang 会为了一些原因和目的在十位之内更新协议版本，例如 1.19.60 - 62 和 1.19.63 协议版本不同，1.21.0 - 1.21.1 和 1.21.2 - 1.21.3 协议版本不同。 -通常 MOJANG 会每五周左右发布一次这种更新协议的版本。 +通常 Mojang 会每五周左右发布一次这种更新协议的版本。 diff --git a/docs-bedrock/super-basic/server-core-choose.md b/docs-bedrock/super-basic/server-core-choose.md index b58107116..b20c740ca 100644 --- a/docs-bedrock/super-basic/server-core-choose.md +++ b/docs-bedrock/super-basic/server-core-choose.md @@ -12,19 +12,21 @@ import TabItem from '@theme/TabItem'; :::warning -至本篇文档开始，**`BDS`** 一致指 **`Bedrock Dedicated Server`**，而不是指 **`Beidou Navigation Satellite System`**(北斗卫星导航系统) + +至本篇文档开始，**`BDS`** 一致指 **`Bedrock Dedicated Server`**，而不是指 **`Beidou Navigation Satellite System`** (北斗卫星导航系统) + ::: ![BDS 运行时的样子](_images/bedrock-core-running.png) -此服务器核心允许 _Minecraft 腐竹_ 在家里使用安装有 **Windows** 或 **Linux** 的设备或使用 **云服务托管**(云服务器) 来搭建属于自己的 BDS 服务器。 +此服务器核心允许 *Minecraft 腐竹* 在家里使用安装有 **Windows** 或 **Linux** 的设备或使用 **云服务托管** (云服务器) 来搭建属于自己的 BDS 服务器。 这是坐落于 **Minecraft 官网** 的服务端 (与 Java 的 Vanilla 服务端在一个页面)。作为官方服务端，它有着极其完善的 Minecraft 特性和流畅的游戏体验，几乎和单人一模一样，说是生存服首当之选也不为过。 **优势**： - 官方支持：作为 Mojang 官方推出的服务器端软件，BDS 能够获得官方的最新更新和支持，确保与 Minecraft 基岩版的最新版本兼容。 - 文档和社区支持：虽然官方提供了一些基本文档，但不如第三方服务器端软件的社区那样提供丰富的教程和支持。社区插件内容庞大，基本满足腐竹的日常需求 (虽然官方服务端无法加载插件，但可以通过 - [社区开发的加载器](/docs-bedrock/bds-core/process/plugins/plugins-loader-choose.md#bds - 社区开发的加载器) + [社区开发的加载器](../bds/process/plugins/plugins-loader-choose.md) 解决这一问题)。 - 稳定性：由于是官方产品，BDS 在稳定性方面通常表现良好，能够提供可靠的服务器体验。 @@ -36,9 +38,9 @@ import TabItem from '@theme/TabItem'; - 定制性有限：与一些第三方服务器端软件相比，BDS 的定制性和扩展性可能 **较为有限**，**不支持插件系统**，限制了服务器的个性化。 - 性能优化：虽然 BDS 性能稳定，但可能在某些方面 (如多核优化) 不如专门的第三方服务器端软件。它的生物运算运行在一个线程上。意味着你的服务器的流畅度主要取决于 **CPU 的单核性能**。 - 这使得地图越大，服务器就越 [卡顿](/start/basic/what-is-caton)，不如 Java 版服务端流畅，因为 Java 版服务端 **支持多核运行**。 + 这使得地图越大，服务器就越 [卡顿](/start/basic/what-is-lag)，不如 Java 版服务端流畅，因为 Java 版服务端 **支持多核运行**。 - 高级功能缺失：BDS 可能不支持一些高级功能，如自定义世界生成、高级权限管理等，这些通常需要第三方软件才能实现。 -- 内存泄漏：内存占用会 _缓慢_ 增加，有时严重的还会导致 **内存泄漏**。如果强行进行 **内存清理** 的话，会导致玩家在进入 **装有 材质包 / Addon 的服务器** 时 **该玩家客户端无法下载对应内容**，致使下载进度条卡条，只能让腐竹重启服务器解决。 +- 内存泄漏：内存占用会 *缓慢* 增加，有时严重的还会导致 **内存泄漏**。如果强行进行 **内存清理** 的话，会导致玩家在进入 **装有 材质包 / Addon 的服务器** 时 **该玩家客户端无法下载对应内容**，致使下载进度条卡条，只能让腐竹重启服务器解决。 总体来说，Bedrock Dedicated Server 适合那些希望获得官方支持、稳定性和兼容性的服务器管理员。如果你的服务器不需要复杂的定制或高级功能，BDS 是一个可靠的选择。然而，对于那些需要更多自定义选项和高级功能的用户，可能需要考虑使用第三方服务器端软件。 @@ -46,12 +48,14 @@ import TabItem from '@theme/TabItem'; :::warning + 至本篇文档开始，**`NK`** 一致指 **`Nukkit`**，但考虑到全称不长，因此二者都会出现在本文档中 + ::: ![Nukkit 运行时的样子](_images/nukkit-core-running.png) -它的名字，很像 Java 版服务端的 Bukkit。没错，它就是 _意图_ 创作出来类似 Bukkit 的基岩版服务端，编写语言正是 **Java**。 +它的名字，很像 Java 版服务端的 Bukkit。没错，它就是 *意图* 创作出来类似 Bukkit 的基岩版服务端，编写语言正是 **Java**。 **优势**： @@ -65,7 +69,7 @@ import TabItem from '@theme/TabItem'; **劣势**： - 更新滞后：Nukkit 的更新可能不如官方服务器端软件那样及时，可能无法立即支持最新的 Minecraft 版本和特性。 -- 生态系统限制：虽然 Nukkit 的插件生态系统活跃，但与一些更流行的服务器端软件 (如 Spigot/Paper)相比，可用的插件和资源可能较少。 +- 生态系统限制：虽然 Nukkit 的插件生态系统活跃，但与一些更流行的服务器端软件 (如 Spigot / Paper) 相比，可用的插件和资源可能较少。 - 多核优化不足：早期的 Nukkit 版本在多核处理器优化方面可能不如其他服务器端软件，这可能会 **限制其在高性能服务器上的性能表现**。 - 文档和教程：虽然社区活跃，但 **高质量的官方文档和教程可能相对缺乏**，新用户可能需要花费更多时间学习和解决问题。 - 稳定性问题：由于开源项目的性质，Nukkit 可能偶尔会出现稳定性问题，尤其是在处理大量玩家或复杂插件时。 @@ -75,20 +79,23 @@ import TabItem from '@theme/TabItem'; -:::danger [此核心短时间内不再可用] +:::danger[此核心短时间内不再可用] ![PNX 短时间内不再更新](_images/powernukkitx-core-rip.png) + ::: :::warning + 至本篇文档开始，**`PNX`** 一致指 **`PowerNukkitX`** + ::: ![PNX 运行时的样子](_images/powernukkitx-core-running.png) **优势**： -- 最新版 mcbe(基岩版) 协议支持：PNX 支持最新的 Minecraft 基岩版协议，这意味着它 **可以兼容最新的游戏版本和特性**。 +- 最新版 MCBE (基岩版) 协议支持：PNX 支持最新的 Minecraft 基岩版协议，这意味着它 **可以兼容最新的游戏版本和特性**。 - 丰富的原版特性支持：支持 1.19 版本的所有新方块和新物品，以及新版下界等特性。 - 高性能和高拓展性：PNX 进行了多核优化，提供了更高的性能和更好的扩展性。 - 384 格世界支持：允许在主世界达到 384 格的高度限制。 @@ -108,7 +115,9 @@ import TabItem from '@theme/TabItem'; :::warning + 至本篇文档开始，**`PMMP`** 一致指 **`PocketMine-MP`** + ::: ![PNX 运行时的样子](_images/pocketminemp-core-running.png) diff --git a/docs-bedrock/super-basic/server-type.md b/docs-bedrock/super-basic/server-type.md index 1d6dbe0c6..e7e773a84 100644 --- a/docs-bedrock/super-basic/server-type.md +++ b/docs-bedrock/super-basic/server-type.md @@ -28,7 +28,7 @@ sidebar_position: 2 - 喜欢传统 Minecraft 游戏体验的玩家。 - 腐竹希望专注于提供稳定和公平的游戏环境。 -## 2. Addon 服 (仅 BDS)z +## 2. Addon 服 (仅 BDS) ### 定义 diff --git a/docs-bedrock/super-basic/super-basic.md b/docs-bedrock/super-basic/super-basic.md index ca7402dfb..1c65ad3c7 100644 --- a/docs-bedrock/super-basic/super-basic.md +++ b/docs-bedrock/super-basic/super-basic.md @@ -1,6 +1,5 @@ --- title: 超级基础知识 -slug: /super-basic sidebar_position: 2 --- diff --git a/docs-bedrock/super-basic/version.md b/docs-bedrock/super-basic/version.md index 27a8e0739..a1932b1f7 100644 --- a/docs-bedrock/super-basic/version.md +++ b/docs-bedrock/super-basic/version.md @@ -13,7 +13,7 @@ sidebar_position: 4 - 1.20.50：由于该版本中有许多方块进行了“扁平化”，经过了代码重构，导致一些该版本以下的跨版本插件无法很好地兼容该版本及以上版本。 - 1.20.40：该版本中新的触控布局可以自定义位置 -- 1.20.x(没有确切版本，望大佬补充) ：大约从此版本开始，安卓版本出现了严重的卡顿问题，该问题截至撰写本文时仍未修复，社区也没有任何解决方案。 +- 1.20.x (没有确切版本，望大佬补充) ：大约从此版本开始，安卓版本出现了严重的卡顿问题，该问题截至撰写本文时仍未修复，社区也没有任何解决方案。 - 1.19.50：该版本加入了新的触控布局 - 1.18.30：从该版本开始，由于客户端实装了渲染龙，客户端无法使用传统的光影，只能使用硬件光追或延迟渲染改善游戏画面。 diff --git a/docs-bedrock/waterdogepe-core/preparation/preparation.md b/docs-bedrock/waterdogepe/preparation.md similarity index 100% rename from docs-bedrock/waterdogepe-core/preparation/preparation.md rename to docs-bedrock/waterdogepe/preparation.md diff --git a/docs-bedrock/waterdogepe-core/waterdogepe-core.md b/docs-bedrock/waterdogepe/waterdogepe.md similarity index 88% rename from docs-bedrock/waterdogepe-core/waterdogepe-core.md rename to docs-bedrock/waterdogepe/waterdogepe.md index 4ff4a9453..c328c511e 100644 --- a/docs-bedrock/waterdogepe-core/waterdogepe-core.md +++ b/docs-bedrock/waterdogepe/waterdogepe.md @@ -1,7 +1,7 @@ --- title: WaterdogePE 跨服 slug: /waterdogepe-core -sidebar_position: 5 +sidebar_position: 6 --- # WaterdogePE 跨服核心 diff --git a/docs-java/advance/_images/easybot.png b/docs-java/advance/_images/easybot.png deleted file mode 100644 index c06898d9f..000000000 Binary files a/docs-java/advance/_images/easybot.png and /dev/null differ diff --git a/docs-java/advance/_images/easybot_home.png b/docs-java/advance/_images/easybot_home.png deleted file mode 100644 index 6d34bb421..000000000 Binary files a/docs-java/advance/_images/easybot_home.png and /dev/null differ diff --git a/docs-java/advance/_images/easybot_player.png b/docs-java/advance/_images/easybot_player.png deleted file mode 100644 index 2a86bb4ec..000000000 Binary files a/docs-java/advance/_images/easybot_player.png and /dev/null differ diff --git a/docs-java/advance/_images/easybot_rcon.png b/docs-java/advance/_images/easybot_rcon.png deleted file mode 100644 index 56137ba91..000000000 Binary files a/docs-java/advance/_images/easybot_rcon.png and /dev/null differ diff --git a/docs-java/advance/advance.md b/docs-java/advance/advance.md index bf0cc7777..23ab80be8 100644 --- a/docs-java/advance/advance.md +++ b/docs-java/advance/advance.md @@ -1,5 +1,5 @@ --- -title: Java进阶教程 +title: Java 进阶教程 slug: /advance sidebar_position: 6 --- diff --git a/docs-java/advance/apply-for-a-domain-name.md b/docs-java/advance/apply-for-a-domain-name.md deleted file mode 100644 index 47f111e0a..000000000 --- a/docs-java/advance/apply-for-a-domain-name.md +++ /dev/null @@ -1,8 +0,0 @@ ---- -title: 申请域名 -sidebar_position: 3 ---- - -# 申请域名 - -请见 [通用 | 申请域名](/advance/domain-application-and-dns-resolution) diff --git a/docs-java/advance/command.yml.md b/docs-java/advance/command-yml.md similarity index 99% rename from docs-java/advance/command.yml.md rename to docs-java/advance/command-yml.md index 10cd48148..d8f02162e 100644 --- a/docs-java/advance/command.yml.md +++ b/docs-java/advance/command-yml.md @@ -41,7 +41,7 @@ aliases: 表明当前没有对命令方块的覆盖进行设置。 这个部分的作用是控制命令方块覆盖功能。在 Bukkit 的历史中，曾提供过一些与 Minecraft 原本不同版本的命令。通过这个设置，可以强制服务器专门为命令方块使用 Mojang 提供的版本的命令 (MC 原版命令)。 -而在命令方块之外使用的命令，将按照正常情况使用 Bukkit(或插件) 版本的命令。 +而在命令方块之外使用的命令，将按照正常情况使用 Bukkit (或插件) 版本的命令。 **命令覆盖：** diff --git a/docs-java/advance/domain-registration.md b/docs-java/advance/domain-registration.md new file mode 100644 index 000000000..4d09876c0 --- /dev/null +++ b/docs-java/advance/domain-registration.md @@ -0,0 +1,8 @@ +--- +title: 申请域名 +sidebar_position: 3 +--- + +# 申请域名 + +请见 [通用 | 申请域名](/advance/domain-and-dns) diff --git a/docs-java/advance/Linux.md b/docs-java/advance/linux.md similarity index 100% rename from docs-java/advance/Linux.md rename to docs-java/advance/linux.md diff --git a/docs-java/advance/loginchoices.md b/docs-java/advance/login-choices.md similarity index 91% rename from docs-java/advance/loginchoices.md rename to docs-java/advance/login-choices.md index 30531bbe8..fa732405a 100644 --- a/docs-java/advance/loginchoices.md +++ b/docs-java/advance/login-choices.md @@ -41,7 +41,7 @@ sidebar_position: 5 [Authlib-Injector](https://github.com/yushijinhun/authlib-injector) 是一个允许 Minecraft 使用自定义 Yggdrasil 验证服务器的工具。它可以提供与正版登录几乎相同的游戏体验，但使用的是非官方的身份验证服务器。 -:::info +::::info Authlib-Injector 仅作为工具，它本身不提供认证服务。你需要找到一个合适的、完全实现了 [Yggdrasil 服务端技术规范](https://github.com/yushijinhun/authlib-injector/wiki/Yggdrasil-%E6%9C%8D%E5%8A%A1%E7%AB%AF%E6%8A%80%E6%9C%AF%E8%A7%84%E8%8C%83) @@ -51,9 +51,13 @@ Authlib-Injector 仅作为工具，它本身不提供认证服务。你需要找 - [红石皮肤站](https://mcskin.com.cn/) :::warning + **不能确保以上列出的所有服务提供商绝对安全可靠，请注意甄别** + ::: +:::: + **优点：** - 继承了正版登录的部分优点。 @@ -86,6 +90,7 @@ Authlib-Injector 仅作为工具，它本身不提供认证服务。你需要找 恶意用户可以利用这一点进行假人压测、干扰或盗号行为。 ::: + **优点：** - 离线可玩 @@ -100,7 +105,7 @@ Authlib-Injector 仅作为工具，它本身不提供认证服务。你需要找 ## 自定义登录 -自定义登录通常需要客户端安装 MOD 来辅助登录。根据登录时机的不同，它可以属于内置登录或外置登录。由于市场上自定义登录程序较少，安全性难以评估，这里不做详细讨论。 +自定义登录通常需要客户端安装 mod 来辅助登录。根据登录时机的不同，它可以属于内置登录或外置登录。由于市场上自定义登录程序较少，安全性难以评估，这里不做详细讨论。 ## 无登录 @@ -126,7 +131,7 @@ Authlib-Injector 仅作为工具，它本身不提供认证服务。你需要找 ::: -### Floodgate(正版登录和基岩 (Xbox) 登录共存) +### Floodgate (正版登录和基岩 (Xbox) 登录共存) Floodgate 是一个允许使用 Minecraft 基岩版的游戏绕过 `通用外置登录` 直接加入游戏的逆天插件，它可以说也是一种混合验证登录插件，能让正版和基岩版共存。 @@ -143,6 +148,7 @@ Floodgate 是一个允许使用 Minecraft 基岩版的游戏绕过 `通用外置 ### 正版登录和通用外置登录共存 :::danger + 多外置共存问题最大，如果操作不当，可能导致一下后果： 1. 可能重名： @@ -155,6 +161,6 @@ Floodgate 是一个允许使用 Minecraft 基岩版的游戏绕过 `通用外置 ::: -相比于 `正版登录和离线(内置)登录共存` 以及 `Floodgate(正版登录和基岩版(Xbox)登录共存)`，他们两个通常都拥有专用的账号管理系统来防止玩家身份混淆和相关问题。然而，Yggdrasil 本身就是一个独立的账号管理系统，多外置之间通常无法直接通信和同步信息。因此在多外置系统共存的环境下，如果不设计一个完善的身份管理系统，极有可能出现上述后果，从而引发严重的安全和信任问题。 +相比于 `正版登录和离线 (内置) 登录共存` 以及 `Floodgate (正版登录和基岩版 (Xbox) 登录共存)`，他们两个通常都拥有专用的账号管理系统来防止玩家身份混淆和相关问题。然而，Yggdrasil 本身就是一个独立的账号管理系统，多外置之间通常无法直接通信和同步信息。因此在多外置系统共存的环境下，如果不设计一个完善的身份管理系统，极有可能出现上述后果，从而引发严重的安全和信任问题。 好在 UUID 碰撞概率相当的低，普通服主或管理员只需要考虑重名问题就好了，是吧。 diff --git a/docs-java/advance/slime-world.md b/docs-java/advance/slime-world.md index df479a965..1201ccc04 100644 --- a/docs-java/advance/slime-world.md +++ b/docs-java/advance/slime-world.md @@ -9,14 +9,14 @@ Slime 世界格式是 Hypixel 开发的一种世界存储格式 优势 -- 使用 ZStd 替换 ZLib，大大优化体积和加载速度 +- 使用 zstd 替换 zlib，大大优化体积和加载速度 - 支持数据库作为加载后端，多服小游戏非常有用 - 支持 readonly，玩完就没 - 预加载到内存当中，玩家不会因为加载卡顿 适合的服务器： -- 不适用于大型生存世界，而是适用于小型世界，如**迷你游戏地图或服务器大厅** +- 不适用于大型生存世界，而是适用于小型世界，如 **迷你游戏地图或服务器大厅** ## 下载 @@ -26,7 +26,7 @@ import TabItem from '@theme/TabItem'; -前往[Github Release](https://github.com/InfernalSuite/AdvancedSlimePaper/releases),找到适合的版本下载即可 +前往 [GitHub Release](https://github.com/InfernalSuite/AdvancedSlimePaper/releases)，找到适合的版本下载即可 - `plugin-***-R0.1-SNAPSHOT.1.jar` ASM 的插件版本 (推荐) - `asp-server.jar` ASM 的独立服务器核心版本 (基于 Paper) @@ -35,14 +35,14 @@ import TabItem from '@theme/TabItem'; -前往[Github Release](https://github.com/Swofty-Developments/Continued-Slime-World-Manager/releases),下载最新版 +前往 [GitHub Release](https://github.com/Swofty-Developments/Continued-Slime-World-Manager/releases)，下载最新版 - 下载`swoftyworldmanager-plugin-.jar` 到插件目录 - 下载`swoftyworldmanager-classmodifier-.jar` 到服务器根目录 添加启动参数 -```shell +```text -javaagent:swoftyworldmanager-classmodifier-.jar ``` @@ -76,7 +76,7 @@ worlds: **`source`** 存储世界的数据源名称 -可用选项：`file`,`mysql`,`mongodb`,也可以使用第三方插件提供的其他数据源。 +可用选项：`file`,`mysql`,`mongodb`，也可以使用第三方插件提供的其他数据源。 `loadOnStartup` 服务器启动时是否应加载世界 @@ -84,7 +84,7 @@ worlds: **`readOnly`** 只读选项 -描述：如果为`true`,对世界的更改将永远不会被存储。如果为`false`,世界将被锁定，因此其他服务器无法在**没有处于只读模式**的情况下**访问它** +描述：如果为`true`，对世界的更改将永远不会被存储。如果为`false`，世界将被锁定，因此其他服务器无法在 **没有处于只读模式** 的情况下 **访问它** :::tip @@ -136,21 +136,21 @@ mongodb: :::note -如果你要使用 MySQL 或 MongoDB，请将对应选项的`enabled` 设为 `true` +如果你要使用 MySQL 或 MongoDB，请将对应选项的 `enabled` 设为 `true` ::: ## 命令 -请查阅官方[wiki](https://infernalsuite.com/docs/asp/swp/commands) +请查阅官方 [Wiki](https://infernalsuite.com/docs/asp/swp/commands) -[1.8 版本 wiki](https://github.com/Swofty-Developments/Continued-Slime-World-Manager/blob/develop/.docs/usage/commands-and-permissions.md) +[1.8 版本 Wiki](https://github.com/Swofty-Developments/Continued-Slime-World-Manager/blob/develop/.docs/usage/commands-and-permissions.md) ## 转换世界 -请查阅官方[wiki](https://infernalsuite.com/docs/asp/swp/converting_worlds) +请查阅官方 [Wiki](https://infernalsuite.com/docs/asp/swp/converting_worlds) -[1.8 版本 wiki](https://github.com/Swofty-Developments/Continued-Slime-World-Manager/blob/develop/.docs/config/convert-world-to-srf.md) +[1.8 版本 Wiki](https://github.com/Swofty-Developments/Continued-Slime-World-Manager/blob/develop/.docs/config/convert-world-to-srf.md) ## 异步世界生成 @@ -160,7 +160,7 @@ mongodb: ::: -在配置文件中打开`enable_async_world_gen`选项即可 +在配置文件中打开 `enable_async_world_gen` 选项即可 ## FAQ @@ -170,7 +170,7 @@ mongodb: ### Slime 与 Multiverse-Core 兼容吗？ -Multiverse-Core 会检测到 Slime 世界为未加载状态，因为它找不到世界目录，然后直接忽略它们。不应该有任何问题;然而，Multiverse-Core 无法与 Slime 世界一起使用。 +Multiverse-Core 会检测到 Slime 世界为未加载状态，因为它找不到世界目录，然后直接忽略它们。不应该有任何问题；然而，Multiverse-Core 无法与 Slime 世界一起使用。 ### Slime 有世界大小限制吗？ diff --git a/docs-java/advance/YAML/extention.md b/docs-java/advance/yaml/extention.md similarity index 95% rename from docs-java/advance/YAML/extention.md rename to docs-java/advance/yaml/extention.md index 3897c36b3..a3d9500b5 100644 --- a/docs-java/advance/YAML/extention.md +++ b/docs-java/advance/yaml/extention.md @@ -11,7 +11,7 @@ sidebar_position: 3 锚点一定要先声明再使用。 -即整个 .yml 文件从上往下设置锚点**一定要**在引用锚点之前。 +即整个 `.yml` 文件从上往下设置锚点 **一定要** 在引用锚点之前。 否则会语法报错。 diff --git a/docs-java/advance/YAML/foundation.md b/docs-java/advance/yaml/general.md similarity index 100% rename from docs-java/advance/YAML/foundation.md rename to docs-java/advance/yaml/general.md diff --git a/docs-java/advance/YAML/YAML.md b/docs-java/advance/yaml/yaml.md similarity index 75% rename from docs-java/advance/YAML/YAML.md rename to docs-java/advance/yaml/yaml.md index 93f3f6df9..699be2492 100644 --- a/docs-java/advance/YAML/YAML.md +++ b/docs-java/advance/yaml/yaml.md @@ -8,11 +8,11 @@ sidebar_position: 2 ## 什么是 YAML? -> YAML 是 "YAML Ain't a Markup Language"(YAML 不是一种标记语言) 的递归缩写。在开发的这种语言时，YAML 的意思其实是："Yet Another Markup Language"(仍是一种标记语言)。 +> YAML 是 "YAML Ain't a Markup Language" (YAML 不是一种标记语言) 的递归缩写。在开发的这种语言时，YAML 的意思其实是："Yet Another Markup Language" (仍是一种标记语言)。 > > YAML 的语法和其他高级语言类似，并且可以简单表达清单、散列表、标量等数据形态。它使用空白符号缩进和大量依赖外观的特色，特别适合用来表达或编辑数据结构、各种配置文件、调试内容、文件大纲 (例如：许多电子邮件标题格式和 YAML 非常接近)。 > -> YAML 的配置文件后缀为 _.yml_ 或者 _.yaml_ ，如：`config.yml` 。 +> YAML 的配置文件后缀为 _.yml_ 或者 _.yaml_，如：`config.yml` 。 Minecraft 服务器用到的 YAML 语法都是非常非常基础的，只要了解一下就可以。(甚至看看配置文件就明白了) @@ -20,21 +20,23 @@ Minecraft 服务器用到的 YAML 语法都是非常非常基础的，只要了 - 大小写敏感 - 使用缩进表示层级关系 -- 缩进不允许使用 **TAB** ，只允许**空格** +- 缩进不允许使用 **TAB** ，只允许 **空格** - 缩进的空格数不重要，只要相同层级的元素左对齐即可 - `#` 表示注释 - 冒号后面有空格 - 字符串要加单引号或双引号 :::info + 在不涉及转义字符 (形如 \n， \r) 时，单双引号等价。 在部分特殊情况，字符串不需要加引号，仍然建议使用引号来减小歧义。 + ::: :::info -有可能你的文本编辑器用的缩进不是**空格**，这会导致插件报错。 +有可能你的文本编辑器用的缩进不是 **空格**，这会导致插件报错。 自己在文本编辑器找找或者浏览器搜下怎么改。 diff --git a/docs-java/intro.md b/docs-java/intro.md index a7aee6820..ee5423dd3 100644 --- a/docs-java/intro.md +++ b/docs-java/intro.md @@ -19,4 +19,4 @@ sidebar_position: 1 ## 更多 -对于文档中的错误请进入 [GitHub](https://github.com/Cubic-Project/NitWikit) 提出 Issue 或提交 Pr。 +对于文档中的错误请进入 [GitHub Issues](https://github.com/Cubic-Project/NitWikit/issues) 提出 Issue 或提交 PR。 diff --git a/docs-java/preparation/dumb-script-using.md b/docs-java/preparation/dumb-script-usage.md similarity index 96% rename from docs-java/preparation/dumb-script-using.md rename to docs-java/preparation/dumb-script-usage.md index a3660e64b..6984a14d2 100644 --- a/docs-java/preparation/dumb-script-using.md +++ b/docs-java/preparation/dumb-script-usage.md @@ -5,4 +5,4 @@ sidebar_position: 4 # 笨蛋脚本使用 -请见 [通用 | 笨蛋脚本使用](/preparation/dumb-script-using) +请见 [通用 | 笨蛋脚本使用](/preparation/dumb-script-usage) diff --git a/docs-java/preparation/websites.md b/docs-java/preparation/websites.md index 0b170113e..9a74f1f2c 100644 --- a/docs-java/preparation/websites.md +++ b/docs-java/preparation/websites.md @@ -30,7 +30,7 @@ sidebar_label: Java 版可能用到的网站 虽然不登录账号不影响你浏览仓库和下载 Release 等。 -但是登录后可以给作者发 Issues 来报告问题，提交新需求/建议，还可以下载 Actions 中的文件。 +但是登录后可以给作者发 Issue 来报告问题，提交新需求/建议，还可以下载 Actions 中的文件。 因此，建议注册并登陆账号。 @@ -46,13 +46,13 @@ GitHub 界面是全英文，可以尝试安装油猴汉化插件：https://githu
连不上怎么办 -这是由于 GitHub 是开放的外国网站，网站上时不时会有一些不能在此讨论的内容，所以运营商会刻意地屏蔽这个网站，在很多时候都不能正常访问。具体的表现如下：[只要 Github 域名指向任意 IP，该 IP 的 443 端口就会超时 3 分钟](https://blog.csdn.net/weixin_43659597/article/details/118882176)。 +这是由于 GitHub 是开放的外国网站，网站上时不时会有一些不能在此讨论的内容，所以运营商会刻意地屏蔽这个网站，在很多时候都不能正常访问。具体的表现如下：[只要 GitHub 域名指向任意 IP，该 IP 的 443 端口就会超时 3 分钟](https://blog.csdn.net/weixin_43659597/article/details/118882176)。 有以下几种解决办法： 1. 魔法 2. [改 hosts](https://www.cnblogs.com/eudaimonia/p/16001981.html#1034247326) -3. [Watt Toolkit](https://steampp.net/)：下载安装完成后，在左侧侧边栏切换到**网络加速**，点击**平台加速 (免费)**，往下翻勾上 GitHub，然后点击**一键加速**，随后就可以正常访问 GitHub 了 +3. [Watt Toolkit](https://steampp.net/)：下载安装完成后，在左侧侧边栏切换到 **网络加速**，点击 **平台加速 (免费)**，往下翻勾上 GitHub，然后点击 **一键加速**，随后就可以正常访问 GitHub 了
@@ -297,7 +297,7 @@ PaperMC 的现代化的插件平台，目前正在 Beta 阶段，插件相对较 能为你避开 90% 诈骗坑的 [防骗小技巧](https://www.pixelbbs.cn/t-1377-1-1.html)。 -> 像素论坛因[数据丢失](https://www.pixelbbs.cn/thread-3-1-1.html)，大部分页面已失效，以下为 Wayback Machine 存档。 +> 像素论坛因 [数据丢失](https://www.pixelbbs.cn/thread-3-1-1.html)，大部分页面已失效，以下为 Wayback Machine 存档。 > > - [失信人员名单页面](https://web.archive.org/web/20240715222153/https://www.pixelbbs.cn/f-50-1.html) > - [防骗小技巧](https://web.archive.org/web/20250122075709/https://www.pixelbbs.cn/t-1377-1-1.html) @@ -372,7 +372,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) > @@ -387,9 +387,9 @@ MOTD 是玩家进入服务器之前最先看到的东西，决定了玩家对一 - + https://misode.github.io/ - + 如果你喜欢编写数据包甚至资源包那么这个网站会很有用，他拥有大量的可视化编辑器，方便进行快速编辑，但是上手需要一定相关知识基础。 diff --git a/docs-java/process/cross-server/command.md b/docs-java/process/cross-server/command.md index 01a0c5fef..b24b4b688 100644 --- a/docs-java/process/cross-server/command.md +++ b/docs-java/process/cross-server/command.md @@ -10,14 +10,14 @@ import Tabs from '@theme/Tabs'; import TabItem from '@theme/TabItem'; - + | 命令 | 权限 | 描述 | | ---------------------------- | --------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `/alert` | `bungeecord.command.alert` | 发送一条整个群组的公告，会显示在所有的子服务器内。颜色符是&，使用&h 可以清除所有默认的格式 | -| `/alertraw ` | `bungeecord.command.alert` | 和上一个命令一样，但是仅允许使用 json 格式的内容 | +| `/alert` | `bungeecord.command.alert` | 发送一条整个群组的公告，会显示在所有的子服务器内。颜色符是 `&`，使用 `&h` 可以清除所有默认的格式 | +| `/alertraw ` | `bungeecord.command.alert` | 和上一个命令一样，但是仅允许使用 JSON 格式的内容 | | `/bungee` | N/A | 显示 BungeeCord 的版本信息 | | `/end` | `bungeecord.command.end` | 关闭 BungeeCord 跨服端，类似于 Bukkit 服务器下的/stop | | `/find` | `bungeecord.command.find` | 确认指定玩家是否在线和他现在在哪个子服务器内 | @@ -47,9 +47,10 @@ import TabItem from '@theme/TabItem'; - + | 命令 | 权限 | 描述 | | --- | --- | --- | | `/transfer` | `minecraft.command.transfer` | 原版自带的跨服指令 | + diff --git a/docs-java/process/cross-server/cross-server.md b/docs-java/process/cross-server/cross-server.md index 537fa27b8..7f3ff5403 100644 --- a/docs-java/process/cross-server/cross-server.md +++ b/docs-java/process/cross-server/cross-server.md @@ -8,9 +8,9 @@ sidebar_position: 4 简单的来说就是将多个服务器连成一个整体 (比如你经常看到的某些生存一区，生存二区)，玩家可以自由选择到哪个服务器，而不用退出重连， -不同服务器之间可以通过跨服同步(比如 HuskSync )和数据库同步数据，平时常听到的群组服也是一个意思. 跨服**通常**的实现方法是: +不同服务器之间可以通过跨服同步 (比如 HuskSync) 和数据库同步数据，平时常听到的群组服也是一个意思。跨服 **通常** 的实现方法是： -一个跨服端 (如 Velocity / BungeeCord ) 和多个子服 (如 Paper / Purpur / Leaf 等). 玩家只需要连接到跨服端即可让跨服端和子服联系，最后把玩家送到对应的服务器。 +一个跨服端 (如 Velocity / BungeeCord) 和多个子服 (如 Paper / Purpur / Leaf 等). 玩家只需要连接到跨服端即可让跨服端和子服联系，最后把玩家送到对应的服务器。 ## 原理讲解 @@ -22,7 +22,7 @@ sidebar_position: 4 :::info -BungeeCord / Velocity 端 (或他们的 Fork ) 在这里我们称为`跨服端`(或者称为 上游服务器 / 反向代理端) +BungeeCord / Velocity 端 (或他们的 Fork) 在这里我们称为 `跨服端` (或者称为 上游服务器 / 反向代理端) 这三个服务器都称为 `子服` 图中为三个子服，子服没有先后之分 (或者称为 下游服务器 / 后端服务器) @@ -34,24 +34,24 @@ BungeeCord / Velocity 端 (或他们的 Fork ) 在这里我们称为`跨服端`( ## 为什么需要跨服端？ -1. Minecraft 是个单核心游戏，玩家数量在超过 50-100 后几乎任何核心都无法保证完全流畅 ( Folia 除外)，而使用多个服务器则可以充分利用多核心优势，大服务器必备; +1. Minecraft 是个单核心游戏，玩家数量在超过 50-100 后几乎任何核心都无法保证完全流畅 (Folia 除外)，而使用多个服务器则可以充分利用多核心优势，大服务器必备; 2. 对多个服务器，玩家需要退出重新进入，且数据不能共享。仅仅只是开两个服务器无法产生有效交互。所以需要跨服端对服务器进行切换和交互的完善; -3. 对单个服务器，在内存有一点点富裕的情况下 (通常不到 1GB )，仍推荐使用跨服端，服务端对于反假人攻击的性能不如代理端，如果你被攻击了，更换成跨服端再说; +3. 对单个服务器，在内存有一点点富裕的情况下 (通常不到 1 GB)，仍推荐使用跨服端，服务端对于反假人攻击的性能不如代理端，如果你被攻击了，更换成跨服端再说; -4. 有些插件是跨服端才能安装的，而在 Bukkit 系下可能不稳定 (如[MultiLogin](https://github.com/CaaMoe/MultiLogin)). +4. 有些插件是跨服端才能安装的，而在 Bukkit 系下可能不稳定 (如 [MultiLogin](https://github.com/CaaMoe/MultiLogin)). ## 推荐用什么？ **推荐使用 Velocity**，除非你的版本不适合 Velocity 的现代转发。 -对于各个MC服务器**部署在不同的服务器**上，跨服代理和子服之间出现了没法进行稳定连接的情况时，也可以尝试原版1.20.5服务器新增的 [Transfer](./build-up/Transfer/transfer.md) 指令。 +对于各个 MC 服务器 **部署在不同的服务器** 上，跨服代理和子服之间出现了没法进行稳定连接的情况时，也可以尝试原版 1.20.5 服务器新增的 [Transfer](./setup/transfer/transfer.md) 指令。 ### 安装数据库 你都跨服了，估计会有多端数据同步的需求吧？ -看 [数据库相关](/database) +看 [通用 | 数据库相关](/database) 一般需要安装两个数据库，MySQL 和 Redis，MySQL 用于存储重要信息，比如账号密码，经济，权限 Redis 用于快速跨服同步 diff --git a/docs-java/process/cross-server/hide-the-real-IP.md b/docs-java/process/cross-server/hide-the-real-ip.md similarity index 74% rename from docs-java/process/cross-server/hide-the-real-IP.md rename to docs-java/process/cross-server/hide-the-real-ip.md index f15497847..4638de79d 100644 --- a/docs-java/process/cross-server/hide-the-real-IP.md +++ b/docs-java/process/cross-server/hide-the-real-ip.md @@ -11,7 +11,7 @@ sidebar_position: 7 - 注意不是所有 CDN 都支持四层转发 购买前请询问客服时候支持 -- 请自行寻找服务商，记得买国内节点(写着需要备案 MC 其实不需要的) +- 请自行寻找服务商，记得买国内节点 (写着需要备案 MC 其实不需要的) ### 配置 CDN 四层转发 (以 cdnfly 系统为例) @@ -26,4 +26,4 @@ sidebar_position: 7 ### 解析到自己域名 -- 可参考本文档中的 [申请域名](/advance/domain-application-and-dns-resolution) +- 可参考本文档中的 [申请域名](/advance/domain-and-dns) diff --git a/docs-java/process/cross-server/join-server.md b/docs-java/process/cross-server/join-server.md index ae654f14e..7e60bd6b5 100644 --- a/docs-java/process/cross-server/join-server.md +++ b/docs-java/process/cross-server/join-server.md @@ -55,8 +55,8 @@ https://github.com/gonalez/znpcs/wiki/Commands#server /znpcs action [id] add SERVER [server] ``` -- [id] 是 NPC 的 id. -- [server] 是子服名字。 +- `[id]` 是 NPC 的 id. +- `[server]` 是子服名字。 ### 菜单 diff --git a/docs-java/process/cross-server/plugin/back-server.md b/docs-java/process/cross-server/plugin/backend-only.md similarity index 100% rename from docs-java/process/cross-server/plugin/back-server.md rename to docs-java/process/cross-server/plugin/backend-only.md diff --git a/docs-java/process/cross-server/plugin/cross-both-hard.md b/docs-java/process/cross-server/plugin/proxy-backend-mandatory.md similarity index 80% rename from docs-java/process/cross-server/plugin/cross-both-hard.md rename to docs-java/process/cross-server/plugin/proxy-backend-mandatory.md index fd5896a1b..960e48307 100644 --- a/docs-java/process/cross-server/plugin/cross-both-hard.md +++ b/docs-java/process/cross-server/plugin/proxy-backend-mandatory.md @@ -29,7 +29,7 @@ sidebar_position: 3 Velocity -> 从 Minecraft 1.19.1 开始，Mojang 实现了一个[新的聊天系统](https://zh.minecraft.wiki/w/Java%E7%89%881.19.1#%E5%B8%B8%E8%A7%84)，该系统使用每个玩家拥有的签名密钥。Velocity 尚不完全支持取消或修改这种类型的消息和命令，因此你可以安装 SignedVelocity 插件，这将允许将消息或命令传输到你的服务器，在服务器上收到消息或命令后，将应用在 Velocity 中计算的结果。 —— Velocity 官方文档 +> 从 Minecraft 1.19.1 开始，Mojang 实现了一个 [新的聊天系统](https://zh.minecraft.wiki/w/Java%E7%89%881.19.1#%E5%B8%B8%E8%A7%84)，该系统使用每个玩家拥有的签名密钥。Velocity 尚不完全支持取消或修改这种类型的消息和命令，因此你可以安装 SignedVelocity 插件，这将允许将消息或命令传输到你的服务器，在服务器上收到消息或命令后，将应用在 Velocity 中计算的结果。 —— Velocity 官方文档 此外由于其功能实现，它也能修复因缺少个人信钥而导致无法加入服务器等问题。 diff --git a/docs-java/process/cross-server/plugin/cross-both.md b/docs-java/process/cross-server/plugin/proxy-backend-optional.md similarity index 93% rename from docs-java/process/cross-server/plugin/cross-both.md rename to docs-java/process/cross-server/plugin/proxy-backend-optional.md index 9e41ef30f..637981ff4 100644 --- a/docs-java/process/cross-server/plugin/cross-both.md +++ b/docs-java/process/cross-server/plugin/proxy-backend-optional.md @@ -54,7 +54,7 @@ import TabItem from '@theme/TabItem'; :::info -见 [插件 | ViaVersion](../../plugin/other/Via/Via.md) +见 [插件 | ViaVersion](../../plugin/misc/via/via.md) ::: @@ -89,7 +89,7 @@ import TabItem from '@theme/TabItem'; :::info -见 [插件 | Geyser](/docs-java/process/mobile-player/Geyser/introduction/overview.md) +见 [插件 | Geyser](../../mobile-player/geyser/introduction/overview.md) ::: @@ -122,7 +122,7 @@ import TabItem from '@theme/TabItem'; :::info -见 [插件 | ServerUtils](../../plugin/ManageTool/PluginManagement/ServerUtils.md) +见 [插件 | ServerUtils](../../plugin/management-tool/plugin-management/serverutils.md) ::: @@ -188,7 +188,7 @@ TODO :::info -见 [插件 | TAB](../../plugin/other/TAB&Scoreboard/TAB.md) +见 [插件 | TAB](../../plugin/misc/tab-scoreboard/tab.md) ::: @@ -206,7 +206,7 @@ TODO 想让他显示 PlaceholderAPI 的变量？请在所有子服务器上安装 [Tab-Bridge](https://www.spigotmc.org/resources/.83966/) -此外，如果你使用了 Layout 功能，如果你不安装此插件，会导致一些显示 Bug +此外，如果你使用了 Layout 功能，如果你不安装此插件，会导致一些显示 bug 因此强烈建议将 Tab-Bridge 一起安装 @@ -230,7 +230,7 @@ TODO :::info -[插件 | 皮肤 - skinsRestorer](../../plugin/other/SkinsRestorer.md) +[插件 | 皮肤 - SkinsRestorer](../../plugin/misc/skinsrestorer.md) ::: diff --git a/docs-java/process/cross-server/plugin/cross-only.md b/docs-java/process/cross-server/plugin/proxy-only.md similarity index 94% rename from docs-java/process/cross-server/plugin/cross-only.md rename to docs-java/process/cross-server/plugin/proxy-only.md index 921c1bbbd..7c082af8f 100644 --- a/docs-java/process/cross-server/plugin/cross-only.md +++ b/docs-java/process/cross-server/plugin/proxy-only.md @@ -31,7 +31,7 @@ sidebar_position: 1 一款轻量级的反假人插件，能够有效的防止大部分假人进入你的服务器。 -由于 Sonar 的程序设计，玩家通常不需要进行额外操作即可实现流量清洗，相对来讲较为“玩家友好”，且内置多种**反假人策略**和**验证方式**，可以任你选择。 +由于 Sonar 的程序设计，玩家通常不需要进行额外操作即可实现流量清洗，相对来讲较为“玩家友好”，且内置多种 **反假人策略** 和 **验证方式**，可以任你选择。 若使用了 Sonar 提供的 CAPTCHA 机制，在玩家进入服务器时，会进入 Sonar 创建的虚拟服务器中，玩家需要在聊天栏中输入随机生成的验证码才能进入服务器，这样可以防御 **99.9%** 的假人，以此实现极具优势的安全性保证，非常推荐安装。 @@ -81,8 +81,8 @@ sidebar_position: 1 - 下载适用于 Folia/Paper/Purpur 的文件时，需注意自 4.1.2 版本开始不再支持 1.19.x 及以下版本 - 在 Velocity 端安装好 AuthMeVelocity 后，需编辑 `plugins\authmevelocity` 中的 config.conf 文件，将其中的 `auth-servers` 配置项修改为登录服的服务器 -```conf -# 比如你的登录服在 velocity 中配置的名称是 login +```toml +# 比如你的登录服在 Velocity 中配置的名称是 login auth-servers=[ login ] @@ -91,6 +91,7 @@ auth-servers=[ 至于 Folia/Paper/Purpur 端则不需要修改任何配置，保证插件正常工作即可。 :::info + 推荐使用来自 HaHaWTH 佬的 [AuthMeReReloaded](https://github.com/HaHaWTH/AuthMeReReloaded) 引入了完整的 Velocity 支持。 如果你已经使用了这个分支的插件，只需要在配置文件中找到并开启： @@ -103,7 +104,8 @@ Hooks: velocity: true ``` -根据实际情况选择开启 Bungeecord 或 Velocity 配置项即可。 +根据实际情况选择开启 `bungeecord` 或 `velocity` 配置项即可。 + ::: 如果未修改 AuthMeVelocity 的配置，可能导致所有玩家无法进入服务器，提示连接超时 @@ -112,7 +114,7 @@ Hooks: 若 AuthMe 未被加载则会导致 AuthMeVelocity 要求玩家登录但玩家却无法登录，导致所有人无法正常在服务器中游玩。 - 如果在 AuthMeVelocity 被加载时出现形如以下报错： -```shell +```text java.lang.RuntimeException: Failed to download library ``` @@ -139,7 +141,7 @@ java.lang.RuntimeException: Failed to download library :::info -见 [插件 | LimboAuth](../../plugin/other/Login/LimboAuth.md) +见 [插件 | LimboAuth](../../plugin/misc/login/limboauth.md) ::: diff --git a/docs-java/process/cross-server/precautions.md b/docs-java/process/cross-server/precautions.md index 0a972edd6..f74f7aa02 100644 --- a/docs-java/process/cross-server/precautions.md +++ b/docs-java/process/cross-server/precautions.md @@ -18,9 +18,9 @@ sidebar_position: 8 - 如果你的服务器能直接获取公网（典型的比如带独立 IP 的云服务器）： 在系统防火墙中禁止该子服服务端可执行文件或该子服对应端口的入站。 - 如果子服与跨服端位于不同的局域网只能通过公网互相通信： - - 在跨服端和子服所处的两台服务器之间建立 VPN + - 在跨服端和子服所处的两台服务器之间建立 VPN （此处指虚拟专用网络，是通常用于登录学校内网或企业内网的那种网络，不是科学上网！），让子服和跨服端通过 VPN 通信 - - 选用有成熟的防止玩家绕过跨服端连接子服的方案，如 Velocity + Paper 或 BungeeCord + Spigot/Paper 等 + - 选用有成熟的防止玩家绕过跨服端连接子服的方案，如 Velocity + Paper 或 BungeeCord + Spigot/Paper 等 - 因某些原因有独立 IP 又无法开启防火墙： 选用有成熟的防止玩家绕过跨服端连接子服的方案，如 Velocity + Paper 或 BungeeCord + Spigot/Paper 等 @@ -46,7 +46,7 @@ sidebar_position: 8 ### 关闭权限 -在跨服端安装 [Luckperms](../plugin/ManageTool/Permission/Permission.md) 的跨服端对应版本然后执行命令： +在跨服端安装 [LuckPerms](../plugin/management-tool/permission/permission.md) 的跨服端对应版本然后执行命令： - BungeeCord @@ -60,9 +60,9 @@ sidebar_position: 8 /lpv group default permission set velocity.command.server false ``` -## bc 的语义扩大 +## bc / BC 的语义扩大 -bc 这个缩写应只指 BungeeCord 核心 +bc 或 BC 这两个缩写应只指 BungeeCord 核心 但是很多人用 bc 指 BungeeCord 和它的分支，甚至指所有的跨服端 (把 Velocity 和包括进去了) @@ -70,10 +70,10 @@ bc 这个缩写应只指 BungeeCord 核心 :::note -服务端有个命令是 `/bc`(broadcast 广播消息) ，用来发公告的，这和此处的 BungeeCord 没有关系 +服务端有个命令是 `/bc` (broadcast 广播消息) ，用来发公告的，这和此处的 BungeeCord 没有关系 ::: ## Velocity 的缩写 -最常见的缩写是 `vc` +最常见的缩写是 `vc` 或 `VC` diff --git a/docs-java/process/cross-server/server-core-choose.md b/docs-java/process/cross-server/server-core-choose.md index d76095eb5..ae417e1d3 100644 --- a/docs-java/process/cross-server/server-core-choose.md +++ b/docs-java/process/cross-server/server-core-choose.md @@ -13,7 +13,7 @@ sidebar_position: 1 ::: -### 关于 waterfall +### 关于 Waterfall [关于 Waterfall 停止维护的公告](https://forums.papermc.io/threads/announcing-the-end-of-life-of-waterfall.1088/)。 @@ -34,10 +34,10 @@ Waterfall 仍然会合并来自 BungeeCord 的更改。 | 名称 | 介绍 | 推荐与否 | 下载镜像 | | ---------------------------------------------------------- | ---------------------------------------------------------------------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | [Waterfall](https://papermc.io/software/waterfall) | Papermc 对 BungeeCord 的分支，但已停止向其添加新功能 | 不推荐 | [McRes](https://mcres.cn/downloads/waterfall.html) [FastMirror](https://www.fastmirror.net/#/download/Waterfall) [原子云](https://res.nullatom.com/Minecraft/Server/Waterfall/) [MCSL](https://sync.mcsl.com.cn/core/Waterfall) | -| [Lightfall](https://github.com/ArclightPowered/lightfall) | Arclight waterfall 的分支，支持 Forge 玩家进入服务器 | - | [McRes](https://dev.mcres.cn/job/Lightfall/lastBuild/) [FastMirror](https://www.fastmirror.net/#/download/lightfall) [MCSL](https://sync.mcsl.com.cn/core/Lightfall) | +| [Lightfall](https://github.com/ArclightPowered/lightfall) | Arclight 的 Waterfall 分支，支持 Forge 玩家进入服务器 | - | [McRes](https://dev.mcres.cn/job/Lightfall/lastBuild/) [FastMirror](https://www.fastmirror.net/#/download/lightfall) [MCSL](https://sync.mcsl.com.cn/core/Lightfall) | | [Velocity](https://papermc.io/software/velocity) | 新生代代理端核心，拥有高安全性和高性能，但是插件不如 BungeeCord 那边多 | 非常推荐 | [McRes(自己点进去找)](https://mcres.cn/) [FastMirror](https://www.fastmirror.net/#/download/Velocity) [原子云](https://res.nullatom.com/Minecraft/Server/Velocity/) [MCSL](https://sync.mcsl.com.cn/core/Velocity) | | [Velocity-CTD](https://github.com/GemstoneGG/Velocity-CTD) | Velocity 的分支，包含各种优化、命令和更多功能，如 Redis 支持、队列系统、管理命令等 | 推荐 | [GitHub Releases](https://github.com/GemstoneGG/Velocity-CTD/releases) | -| [BungeeCord](https://github.com/SpigotMC/BungeeCord) | 最古老的代理端核心，甚至有网页版 mc 的核心 | - | [McRes](https://repo.wdsj.io/repository/Bungeecord/BungeeCord.jar) [FastMirror](https://www.fastmirror.net/#/download/BungeeCord) [MCSL](https://sync.mcsl.com.cn/core/BungeeCord) | +| [BungeeCord](https://github.com/SpigotMC/BungeeCord) | 最古老的代理端核心，甚至有网页版 MC 的核心 | - | [McRes](https://repo.wdsj.io/repository/Bungeecord/BungeeCord.jar) [FastMirror](https://www.fastmirror.net/#/download/BungeeCord) [MCSL](https://sync.mcsl.com.cn/core/BungeeCord) | | [Gate](https://gate.minekube.com/) | 基于 Go 开发的核心，拥有超高的性能和极低内存占用。 | - | - | | [Travertine](https://github.com/PaperMC/Travertine) | Waterfall 1.7.10 的分支 | - | - | diff --git a/docs-java/process/cross-server/build-up/_images/BungeeCord.png b/docs-java/process/cross-server/setup/_images/BungeeCord.png similarity index 100% rename from docs-java/process/cross-server/build-up/_images/BungeeCord.png rename to docs-java/process/cross-server/setup/_images/BungeeCord.png diff --git a/docs-java/process/cross-server/build-up/_images/Velocity.png b/docs-java/process/cross-server/setup/_images/Velocity.png similarity index 100% rename from docs-java/process/cross-server/build-up/_images/Velocity.png rename to docs-java/process/cross-server/setup/_images/Velocity.png diff --git a/docs-java/process/cross-server/build-up/BungeeCord/bungeecord.md b/docs-java/process/cross-server/setup/bungeecord/bungeecord.md similarity index 64% rename from docs-java/process/cross-server/build-up/BungeeCord/bungeecord.md rename to docs-java/process/cross-server/setup/bungeecord/bungeecord.md index 9e93fbce4..a26c4a621 100644 --- a/docs-java/process/cross-server/build-up/BungeeCord/bungeecord.md +++ b/docs-java/process/cross-server/setup/bungeecord/bungeecord.md @@ -8,10 +8,10 @@ sidebar_position: 1 ![](../_images/BungeeCord.png) -此篇教程适用于 BungeeCord / waterfall +此篇教程适用于 BungeeCord / Waterfall 注意，BungeeCord 算是较为古老的核心 (好比后端服务器中的 Spigot) 如果开高版本尽量选择 Waterfall 或 Velocity -[关于 waterfall 停止维护](/Java/process/cross-server/server-core-choose#关于-waterfall) +[关于 Waterfall 停止维护](../../server-core-choose.md#关于-waterfall) diff --git a/docs-java/process/cross-server/build-up/BungeeCord/config.yml.md b/docs-java/process/cross-server/setup/bungeecord/config-yml.md similarity index 91% rename from docs-java/process/cross-server/build-up/BungeeCord/config.yml.md rename to docs-java/process/cross-server/setup/bungeecord/config-yml.md index ca5e16506..feeab4c05 100644 --- a/docs-java/process/cross-server/build-up/BungeeCord/config.yml.md +++ b/docs-java/process/cross-server/setup/bungeecord/config-yml.md @@ -6,11 +6,11 @@ sidebar_position: 2 # config.yml ```yaml -# forgeMOD 支持，如果你的服务器中有 MOD 服务器，请打开这个选项 +# Forge mod 支持，如果你的服务器中有 mod 服务器，请打开这个选项 forge_support: false # 玩家真实限制，它将限制整个服务器的玩家人数，-1 为不限 player_limit: -1 -# BC 服务器权限组 不建议用这东西而是使用 bc 版 luckperms +# BC 服务器权限组 不建议用这东西而是使用 BC 版 LuckPerms permissions: default: - bungeecord.command.server @@ -60,7 +60,7 @@ listeners: force_default_server: false # 一定要打开，否则会被拒绝 ip_forward: false -# BC op 设置，这也是漏洞之一，待会修改 +# BC OP 设置，这也是漏洞之一，待会修改 network_compression_threshold: 256 groups: md_5: diff --git a/docs-java/process/cross-server/build-up/BungeeCord/lobby.md b/docs-java/process/cross-server/setup/bungeecord/lobby.md similarity index 84% rename from docs-java/process/cross-server/build-up/BungeeCord/lobby.md rename to docs-java/process/cross-server/setup/bungeecord/lobby.md index 312b55f7c..73c2fa9c9 100644 --- a/docs-java/process/cross-server/build-up/BungeeCord/lobby.md +++ b/docs-java/process/cross-server/setup/bungeecord/lobby.md @@ -9,9 +9,9 @@ sidebar_position: 3 登录服和大厅服在原理上一样，所以这里只讲解登录服。 -在 config.yml 中找到： +在 `config.yml` 中找到： -```YAML +```yaml # 优先服务器列表 玩家将优先加入靠上设置的子服，进不去会尝试下一个子服 priorities: - lobby @@ -27,13 +27,13 @@ flowchart TD 玩家 -->|登录服炸了| 游戏服 ``` -- **在你的登录服安装 [登录插件](../../../plugin/other/Login/Login.md)** +- **在你的登录服安装 [登录插件](../../../plugin/misc/login/login.md)** 提供登录验证。 如果你使用 AuthMe，建议在 BungeeCord / Waterfall 安装 [AuthMeBungee](https://www.spigotmc.org/resources/.50219)。 -- **在你的登录服安装 [大厅插件](../../../plugin/WorldManagement/lobby/lobby.md)** +- **在你的登录服安装 [大厅插件](../../../plugin/world-management/lobby/lobby.md)** 提供各种大厅常用的功能如： diff --git a/docs-java/process/cross-server/build-up/BungeeCord/build-up.md b/docs-java/process/cross-server/setup/bungeecord/setup.md similarity index 92% rename from docs-java/process/cross-server/build-up/BungeeCord/build-up.md rename to docs-java/process/cross-server/setup/bungeecord/setup.md index d9cf2b153..3e1d104f2 100644 --- a/docs-java/process/cross-server/build-up/BungeeCord/build-up.md +++ b/docs-java/process/cross-server/setup/bungeecord/setup.md @@ -7,7 +7,7 @@ sidebar_position: 1 ## 下载 -前往 [核心选择](/docs-java/process/cross-server/server-core-choose.md) 下载 BungeeCord / Waterfall +前往 [核心选择](../../server-core-choose.md) 下载 BungeeCord / Waterfall BungeeCord 不再支持过旧版本 Minecraft @@ -28,7 +28,7 @@ BungeeCord 不再支持过旧版本 Minecraft 并且使用参数启动以生成初始文件 -如果想进一步优化可以使用 JVM 参数 [Waterfall 官方](https://docs.papermc.io/waterfall/getting-started#running-the-proxy)有推荐的 flags +如果想进一步优化可以使用 JVM 参数 [Waterfall 官方](https://docs.papermc.io/waterfall/getting-started#running-the-proxy) 有推荐的 flags ```bash java -Xms1024M -Xmx1024M -jar 核心名字.jar @@ -40,7 +40,7 @@ java -Xms1024M -Xmx1024M -jar 核心名字.jar 配置 BungeeCord 端根目录中的 `config.yml` -[详细配置文件讲解](config.yml.md) +[详细配置文件讲解](config-yml.md) ```yaml servers: @@ -78,7 +78,7 @@ servers: restricted: false ``` -### 子服 bc 模式 +### 子服 BC 模式 配置子服端根目录中的 `spigot.yml` diff --git a/docs-java/process/cross-server/build-up/build-up.md b/docs-java/process/cross-server/setup/setup.md similarity index 100% rename from docs-java/process/cross-server/build-up/build-up.md rename to docs-java/process/cross-server/setup/setup.md diff --git a/docs-java/process/cross-server/build-up/Transfer/build-up.md b/docs-java/process/cross-server/setup/transfer/setup.md similarity index 81% rename from docs-java/process/cross-server/build-up/Transfer/build-up.md rename to docs-java/process/cross-server/setup/transfer/setup.md index 2f4824516..ab17707c0 100644 --- a/docs-java/process/cross-server/build-up/Transfer/build-up.md +++ b/docs-java/process/cross-server/setup/transfer/setup.md @@ -7,7 +7,7 @@ sidebar_position: 1 ## 什么是 Transfer？ -Transfer 是 Minecraft 1.20.5 版本引入的**原生跨服功能**，与传统代理端不同，它采用去中心化架构，服务器之间直接传送玩家。 +Transfer 是 Minecraft 1.20.5 版本引入的 **原生跨服功能**，与传统代理端不同，它采用去中心化架构，服务器之间直接传送玩家。 ```mermaid graph TD @@ -23,13 +23,13 @@ graph TD - **服务端**：Minecraft 1.20.5+ (Vanilla/Paper/Spigot/Purpur) - **客户端**：Minecraft Java Edition 1.20.5+ -- **不支持**：基岩版、1.20.5以下版本 +- **不支持**：基岩版、1.20.5 以下版本 ## 核心配置 ### 启用 Transfer 功能 -在**所有服务器**的 `server.properties` 中添加： +在 **所有服务器** 的 `server.properties` 中添加： ```properties # 启用 Transfer 功能（关键配置） @@ -44,15 +44,15 @@ online-mode=false ### 网络配置要求 -:::warning 重要：网络访问要求 +:::warning[重要：网络访问要求] -Transfer 要求**所有服务器都能被客户端直接访问**： +Transfer 要求 **所有服务器都能被客户端直接访问**： ::: ## Transfer 的安全问题 -:::danger 重要安全警告 +:::danger[重要安全警告] Transfer **没有内置的安全机制**，与传统代理端不同： @@ -84,16 +84,16 @@ Transfer **没有内置的安全机制**，与传统代理端不同： ```yaml # 是否允许通过服务器列表直接进入服务器 -# 如果为 true，则该服务器被允许直接通过客户端进入，否则将仅允许 transfer +# 如果为 true，则该服务器被允许直接通过客户端进入，否则将仅允许 Transfer # 如果不是主城或者登录服，不建议打开该选项，否则安全性降低 allow-server-list: true # 跨服传送的令牌，两台服务器必须配置相同的令牌 -# 类似于 Velocity 的`forward.secret` +# 类似于 Velocity 的 `forward.secret` # 但貌似只有被传送的对象服务器才会检查这个 transfer-token: "your-secure-random-token" -# 允许的服务器IP和端口 +# 允许的服务器 IP 和端口 # 不在该列表里的服务器不被允许跳转 # 如果是公共服务器，请确保所有子服均暴露在公网下 @@ -108,7 +108,7 @@ allowed-servers: - "your-server-ip:25565" # 登录服 ``` -:::tip 安全令牌生成 +:::tip[安全令牌生成] ```bash # 生成32位随机令牌 @@ -132,6 +132,8 @@ accepts-transfers = true 独立服务器 --Transfer--> Velocity ---> 子服务器群组 ``` -:::warning 兼容性问题 +:::warning[兼容性问题] + OnlyTransfer 插件与 Velocity 的 Transfer 支持存在部分兼容性问题，建议在测试环境中验证。 + ::: diff --git a/docs-java/process/cross-server/build-up/Transfer/transfer.md b/docs-java/process/cross-server/setup/transfer/transfer.md similarity index 79% rename from docs-java/process/cross-server/build-up/Transfer/transfer.md rename to docs-java/process/cross-server/setup/transfer/transfer.md index 16235192f..e4614844e 100644 --- a/docs-java/process/cross-server/build-up/Transfer/transfer.md +++ b/docs-java/process/cross-server/setup/transfer/transfer.md @@ -10,9 +10,9 @@ sidebar_position: 2 ## 关于 Transfer -Transfer是一个新的，**不同于 BungeeCord 与 Velocity 的**跨服方法，在《我的世界》1.20.5版本被添加。 +Transfer 是一个新的，**不同于 BungeeCord 与 Velocity 的** 跨服方法，在《我的世界》1.20.5 版本被添加。 -其去除了中心地位的跨服代理服务器，提供了简单有效的简易跨服方式。[点此](./build-up.md)查看搭建方法。 +其去除了中心地位的跨服代理服务器，提供了简单有效的简易跨服方式。[点此](setup.md) 查看搭建方法。 指令格式如下（其中普通括号表示非必须填写）： @@ -21,7 +21,7 @@ Transfer是一个新的，**不同于 BungeeCord 与 Velocity 的**跨服方法 ## Transfer 适合谁？ - 不需要太多功能，仅想把多个服务器进行简单组合的人 -- 多个服务器不在同一网络环境下，用 BungeeCord 或者 Velocity 可能会出现~~高 Ping 战士~~高延迟现象的服务器。 +- 多个服务器不在同一网络环境下，用 BungeeCord 或者 Velocity 可能会出现 ~~高 Ping 战士~~ 高延迟现象的服务器。 - 不在意适配该功能的插件的数量，或对此早有对策的服务器。 - ~~安全性要求不高的服务器。~~ @@ -44,9 +44,9 @@ Transfer是一个新的，**不同于 BungeeCord 与 Velocity 的**跨服方法 ## Velocity 的 Transfer 支持 -Velocity 支持从别的服务器通过 Transfer 跳转至 Velocity，需要在velocity.toml里面找到这个`accepts-transfers = false`，改false为true。 +Velocity 支持从别的服务器通过 Transfer 跳转至 Velocity，需要在 `velocity.toml` 里面找到这个 `accepts-transfers = false`，改 false 为 true。 -你也可以从 Velocity 之下的1.20.5或更高版本的下游服务器跳转到其他服务器。 +你也可以从 Velocity 之下的 1.20.5 或更高版本的下游服务器跳转到其他服务器。 ## 关于 NeoForge @@ -68,6 +68,6 @@ Velocity 支持从别的服务器通过 Transfer 跳转至 Velocity，需要在v 一开始以为是 OnlyTransfer 插件在混合架构运作不佳，但后来在纯 Transfer 跨服架构大量对比测试，确定了问题来源为 NeoForge 客户端。 -经测试，NeoForge 1.21.1, 1.21.4, 1.21.7均存在此问题，其他版本很可能也有这类问题。 +经测试，NeoForge 1.21.1, 1.21.4, 1.21.7 均存在此问题，其他版本很可能也有这类问题。
diff --git a/docs-java/process/cross-server/build-up/Velocity-CTD/features.md b/docs-java/process/cross-server/setup/velocity-ctd/features.md similarity index 98% rename from docs-java/process/cross-server/build-up/Velocity-CTD/features.md rename to docs-java/process/cross-server/setup/velocity-ctd/features.md index 3303ad45b..baf9bd223 100644 --- a/docs-java/process/cross-server/build-up/Velocity-CTD/features.md +++ b/docs-java/process/cross-server/setup/velocity-ctd/features.md @@ -13,7 +13,7 @@ Velocity-CTD 在标准 Velocity 基础上增加了许多实用功能，本页面 Velocity-CTD 内置了完整的 Redis 支持，可以替代 RedisBungee 等插件，提供更稳定的 Redis 体验。 -:::info 什么时候需要 Redis？ +:::info[什么时候需要 Redis？] - **单代理服务器**：不需要 Redis - **多代理服务器**：必须启用 Redis 来同步数据 @@ -66,7 +66,7 @@ key-prefix = "myserver:" Velocity-CTD 内置了高效的队列系统，可以在服务器满员时自动将玩家加入队列，支持优先级、超时等高级功能。 -:::tip 队列系统优势 +:::tip[队列系统优势] - **自动化**：服务器满员时自动加入队列 - **优先级支持**：VIP 玩家可以获得更高优先级 @@ -84,7 +84,7 @@ enabled = true update-interval = 1000 # 队列更新间隔（毫秒） allow-multiple-queues = false # 是否允许同时在多个队列 timeout = 300 # 离线保留时间（秒） -max-queue-length = 0 # 最大队列长度（0=无限制） +max-queue-length = 0 # 最大队列长度（0=无限制） position-update-interval = 10 # 位置更新间隔（秒） priority-enabled = true # 启用优先级系统 ``` diff --git a/docs-java/process/cross-server/build-up/Velocity-CTD/lobby.md b/docs-java/process/cross-server/setup/velocity-ctd/lobby.md similarity index 96% rename from docs-java/process/cross-server/build-up/Velocity-CTD/lobby.md rename to docs-java/process/cross-server/setup/velocity-ctd/lobby.md index 856cbb5f0..136f7605e 100644 --- a/docs-java/process/cross-server/build-up/Velocity-CTD/lobby.md +++ b/docs-java/process/cross-server/setup/velocity-ctd/lobby.md @@ -34,7 +34,7 @@ flowchart TD ### 登录插件 -**在你的登录服安装 [登录插件](../../../plugin/other/Login/Login.md)** +**在你的登录服安装 [登录插件](../../../plugin/misc/login/login.md)** 提供登录验证。 @@ -42,7 +42,7 @@ flowchart TD ### 大厅插件 -**在你的登录服安装 [大厅插件](../../../plugin/WorldManagement/lobby/lobby.md)** +**在你的登录服安装 [大厅插件](../../../plugin/world-management/lobby/lobby.md)** 提供各种大厅常用的功能如： @@ -81,7 +81,7 @@ hub = ["lobby", "l", "spawn"] # 设置命令别名 权限配置： ```yaml -# 允许使用 hub 命令 +# 允许使用 /hub 命令 velocity.command.hub: true ``` diff --git a/docs-java/process/cross-server/build-up/Velocity-CTD/build-up.md b/docs-java/process/cross-server/setup/velocity-ctd/setup.md similarity index 91% rename from docs-java/process/cross-server/build-up/Velocity-CTD/build-up.md rename to docs-java/process/cross-server/setup/velocity-ctd/setup.md index 5158a9dc5..38171f2e9 100644 --- a/docs-java/process/cross-server/build-up/Velocity-CTD/build-up.md +++ b/docs-java/process/cross-server/setup/velocity-ctd/setup.md @@ -9,7 +9,7 @@ sidebar_position: 1 ## 下载 -在 [核心选择](/docs-java/process/cross-server/server-core-choose.md) 找到 Velocity-CTD 然后下载 +在 [核心选择](../../server-core-choose.md) 找到 Velocity-CTD 然后下载 或者直接从 [GitHub Releases](https://github.com/GemstoneGG/Velocity-CTD/releases) 下载最新版本 @@ -34,21 +34,21 @@ java -Xms1024M -Xmx1024M -jar velocity-ctd.jar > 在 **[servers]** 那里该填什么？ > -> > 答: +> > 答： > > `子服名 = "子服地址"` > > > > 如 `login = "0.0.0.0:25501"` :::danger -中文需要用引号括起来。如`"登录服" = "0.0.0.0:25501"` +中文需要用引号括起来。如 `"登录服" = "0.0.0.0:25501"` ::: -[详细配置文件讲解](velocity.toml.md) +[详细配置文件讲解](velocity-toml.md) ```toml -# velocity 端的端口号，数字 1000~65536 随意 +# Velocity 端的端口号，数字 1000~65536 随意 bind = "0.0.0.0:25577" # 正版验证，有 1.19.1+ 的子服不建议开启此项 online-mode = false @@ -60,7 +60,7 @@ player-info-forwarding-mode = "modern" # - "mods"：仅将后端服务器的 mod 列表传递到响应中。将使用具有 mod 列表的后端服务器的第一个服务器。如果无法联系后端服务器，则 Velocity 不会显示任何 mod 信息。 # - "description"：使用后端服务器的描述和 mod 列表。将使用响应的第一个服务器列表中的第一个服务器 (或强制主机) 进行描述和 mod 列表。 # - "all"：将后端服务器的响应用作代理响应。如果无法联系服务器，则使用 Velocity 配置。 -# 人话，motd 插件在代理端用"disabled"，否则用"all" +# 人话，motd 插件在代理端用 "disabled"，否则用"all" ping-passthrough = "all" # 子服名称和地址，名称不可包含"." [servers] @@ -136,7 +136,7 @@ Velocity-CTD 完全兼容 Velocity 的转发系统，配置方法与标准 Veloc Velocity-CTD 支持将玩家信息 (如 IP 地址、UUID 和皮肤) 转发到你的服务器。Velocity-CTD 支持三种转发格式： - **Velocity Modern 转发** (现代转发) 是一种自定义的转发格式 (modern 转发)，它更安全。 -- **BungeeCord 转发**(也称为*传统转发*)，它有更好的兼容性但安全性较低。 +- **BungeeCord 转发** (也称为 *传统转发*)，它有更好的兼容性但安全性较低。 - **BungeeGuard**，与传统 BungeeCord 转发相同，但包含了一个密钥。它比单独的 BungeeCord 转发更好，但不如 Velocity modern 转发理想。 你只能选择这些转发格式中的一种。目前不可能"混合匹配"转发模式或同时使用所有转发格式。一般来说，如果你只支持使用 Minecraft 1.13 及更新版本的客户端，请使用 Velocity Modern 转发； @@ -148,7 +148,7 @@ import TabItem from '@theme/TabItem'; -**`modern` 转发** 是 Velocity 的原生格式，以高效的二进制格式转发所有玩家信息，并采用 MAC 代码增加安全性，使非法服务器难以绕过你的 Velocity 代理。但它**仅支持 Minecraft 1.13 或更高版本**。 +**`modern` 转发** 是 Velocity 的原生格式，以高效的二进制格式转发所有玩家信息，并采用 MAC 代码增加安全性，使非法服务器难以绕过你的 Velocity 代理。但它 **仅支持 Minecraft 1.13 或更高版本**。 :::warning @@ -203,8 +203,8 @@ import TabItem from '@theme/TabItem'; ### 传统转发增加安全性 - 对于托管在共享主机上的代理，Velocity 可选地支持 **BungeeGuard**。 - - 将 `velocity.toml` 中的 `player-info-forwarding` 设置为 `bungeeguard`。 - - 在 BungeeGuard 配置的令牌部分添加 `forwarding.secret` 文件中的值。 + - 将 `velocity.toml` 中的 `player-info-forwarding` 设置为 `bungeeguard`。 + - 在 BungeeGuard 配置的令牌部分添加 `forwarding.secret` 文件中的值。 ### 为 Spigot / Paper 配置传统转发 diff --git a/docs-java/process/cross-server/build-up/Velocity-CTD/velocity-ctd.md b/docs-java/process/cross-server/setup/velocity-ctd/velocity-ctd.md similarity index 100% rename from docs-java/process/cross-server/build-up/Velocity-CTD/velocity-ctd.md rename to docs-java/process/cross-server/setup/velocity-ctd/velocity-ctd.md diff --git a/docs-java/process/cross-server/build-up/Velocity-CTD/velocity.toml.md b/docs-java/process/cross-server/setup/velocity-ctd/velocity-toml.md similarity index 98% rename from docs-java/process/cross-server/build-up/Velocity-CTD/velocity.toml.md rename to docs-java/process/cross-server/setup/velocity-ctd/velocity-toml.md index 6ad062728..d9edda972 100644 --- a/docs-java/process/cross-server/build-up/Velocity-CTD/velocity.toml.md +++ b/docs-java/process/cross-server/setup/velocity-ctd/velocity-toml.md @@ -18,7 +18,7 @@ config-version = "2.7" # 代理应该绑定到哪个端口？默认情况下，我们将绑定到 25565 端口的所有地址。 bind = "0.0.0.0:25565" -# 应该显示什么 MOTD(服务器消息)？当玩家将你的服务器添加到他们的服务器列表时，会显示这个。只接受 MiniMessage 格式。 +# 应该显示什么 MOTD (服务器消息)？当玩家将你的服务器添加到他们的服务器列表时，会显示这个。只接受 MiniMessage 格式。 motd = "<#09add3>一个 Velocity-CTD 服务器" # 我们应该显示多少最大玩家数？(Velocity 不支持在线玩家数的限制。) @@ -194,7 +194,7 @@ pubsub-enabled = true pubsub-prefix = "velocity-ctd:pubsub:" ``` -:::warning Redis 使用注意事项 +:::warning[Redis 使用注意事项] 1. **单代理服务器不需要 Redis**：如果你只有一个 Velocity-CTD 代理，无需启用 Redis 2. **多代理环境必须启用**：如果你有多个代理服务器，必须启用 Redis 来同步数据 @@ -255,7 +255,7 @@ priority-enabled = true default-priority = 0 ``` -:::tip 队列系统使用建议 +:::tip[队列系统使用建议] 1. **小型服务器**：通常不需要启用队列系统 2. **中大型服务器**：建议启用队列系统来管理负载 @@ -331,7 +331,7 @@ default-forwarding-mode = "modern" log-forwarding-changes = true ``` -:::warning 多转发系统注意事项 +:::warning[多转发系统注意事项] 1. **实验性功能**：多转发系统是实验性功能，可能存在兼容性问题 2. **配置复杂性**：需要为每个服务器正确配置对应的转发模式 @@ -350,6 +350,7 @@ log-forwarding-changes = true 这些是 Velocity-CTD 特有的性能优化选项，需要添加到 `[advanced]` 部分： + ```toml [advanced] # ... 其他标准 Velocity 配置 ... @@ -411,6 +412,7 @@ health-check-interval = 10 # 服务器被认为不健康的超时时间（秒） unhealthy-timeout = 30 ``` + ### 消息配置 @@ -592,6 +594,7 @@ read-timeout = 45000 ``` 3. **优化压缩设置**： + ```toml compression-threshold = 256 compression-level = 6 @@ -601,7 +604,7 @@ read-timeout = 45000 ### 转发模式配置 -:::danger 重要提醒 +:::danger[重要提醒] **转发模式必须与子服务器配置匹配**： diff --git a/docs-java/process/cross-server/build-up/Velocity/lobby.md b/docs-java/process/cross-server/setup/velocity/lobby.md similarity index 86% rename from docs-java/process/cross-server/build-up/Velocity/lobby.md rename to docs-java/process/cross-server/setup/velocity/lobby.md index ec9680ea8..4e6bc8abd 100644 --- a/docs-java/process/cross-server/build-up/Velocity/lobby.md +++ b/docs-java/process/cross-server/setup/velocity/lobby.md @@ -11,7 +11,7 @@ sidebar_position: 3 在 config.yml 中找到： -```TOML +```toml # 当玩家登录或从服务器被踢出时，我们应该尝试让他进入哪个服务器？ try = [ "lobby" @@ -28,13 +28,13 @@ flowchart TD 玩家 -->|登录服炸了| 游戏服 ``` -- **在你的登录服安装 [登录插件](../../../plugin/other/Login/Login.md)** +- **在你的登录服安装 [登录插件](../../../plugin/misc/login/login.md)** 提供登录验证。 如果你使用 AuthMe，建议在 Velocity 安装 [AuthMeVelocity](https://modrinth.com/plugin/authmevelocity)。 -- **在你的登录服安装 [大厅插件](../../../plugin/WorldManagement/lobby/lobby.md)** +- **在你的登录服安装 [大厅插件](../../../plugin/world-management/lobby/lobby.md)** 提供各种大厅常用的功能如： diff --git a/docs-java/process/cross-server/build-up/Velocity/build-up.md b/docs-java/process/cross-server/setup/velocity/setup.md similarity index 87% rename from docs-java/process/cross-server/build-up/Velocity/build-up.md rename to docs-java/process/cross-server/setup/velocity/setup.md index 30e093ced..0a7608c7d 100644 --- a/docs-java/process/cross-server/build-up/Velocity/build-up.md +++ b/docs-java/process/cross-server/setup/velocity/setup.md @@ -9,7 +9,7 @@ sidebar_position: 1 ## 下载 -在 [核心选择](/docs-java/process/cross-server/server-core-choose.md) 找到 Velocity 然后下载 +在 [核心选择](../../server-core-choose.md) 找到 Velocity 然后下载 ## 启动 @@ -18,7 +18,7 @@ sidebar_position: 1 并且使用参数启动以生成初始文件 如果想进一步优化可以使用 JVM 参数 -[Velocity 官方](https://docs.papermc.io/velocity/getting-started#launching-velocity-under-windows)有推荐的 Flags +[Velocity 官方](https://docs.papermc.io/velocity/getting-started#launching-velocity-under-windows) 有推荐的 Flags ```bash java -Xms1024M -Xmx1024M -jar 核心名字.jar @@ -32,25 +32,25 @@ java -Xms1024M -Xmx1024M -jar 核心名字.jar > 在 **[servers]** 那里该填什么？ > -> > 答: +> > 答： > > `子服名 = "子服地址"` > > > > 如 `login = "0.0.0.0:25501"` :::danger -中文需要用引号括起来。如`"登录服" = "0.0.0.0:25501"` +中文需要用引号括起来。如 `"登录服" = "0.0.0.0:25501"` ::: -[详细配置文件讲解](velocity.toml.md) +[详细配置文件讲解](velocity-toml.md) ```toml -# velocity 端的端口号，数字 1000~65536 随意 +# Velocity 端的端口号，数字 1000~65536 随意 bind = "0.0.0.0:25577" # 正版验证，有 1.19.1+ 的子服不建议开启此项 online-mode = false -# 1.13+ 这里填 modern 1.12-填 bungeeguard +# 1.13+ 这里填 modern 1.12- 填 bungeeguard player-info-forwarding-mode = "modern" # 是否应将服务器列表 ping 请求传递给后端服务器？ # 可用选项： @@ -58,7 +58,7 @@ player-info-forwarding-mode = "modern" # - "mods"：仅将后端服务器的 mod 列表传递到响应中。将使用具有 mod 列表的后端服务器的第一个服务器。如果无法联系后端服务器，则 Velocity 不会显示任何 mod 信息。 # - "description"：使用后端服务器的描述和 mod 列表。将使用响应的第一个服务器列表中的第一个服务器 (或强制主机) 进行描述和 mod 列表。 # - "all"：将后端服务器的响应用作代理响应。如果无法联系服务器，则使用 Velocity 配置。 -# 人话，motd 插件在代理端用"disabled"，否则用"all" +# 人话，motd 插件在代理端用 "disabled"，否则用"all" ping-passthrough = "all" # 子服名称和地址，名称不可包含”.” [servers] @@ -84,8 +84,8 @@ try = [ Velocity 支持将玩家信息 (如 IP 地址、UUID 和皮肤) 转发到你的服务器。Velocity 支持三种转发格式： - **Velocity Modern 转发** (现代转发) 是一种自定义的转发格式 (modern 转发)，它更安全。 -- **BungeeCord 转发**(也称为*传统转发*)，它有更好的兼容性但安全性较低。 -- **BungeeGuard**，与传统 BungeeCord 转发相同，但包含了一个密钥。它比单独的 BungeeCord 转发更好，但不如 Velocitymodern 转发理想。 +- **BungeeCord 转发** (也称为 *传统转发*)，它有更好的兼容性但安全性较低。 +- **BungeeGuard**，与传统 BungeeCord 转发相同，但包含了一个密钥。它比单独的 BungeeCord 转发更好，但不如 Velocity 的 modern 转发理想。 你只能选择这些转发格式中的一种。目前不可能“混合匹配”转发模式或同时使用所有转发格式。一般来说，如果你只支持使用 Minecraft 1.13 及更新版本的客户端，请使用 Velocity Modern 转发； 否则，你必须使用 BungeeCord 转发。 @@ -96,7 +96,7 @@ import TabItem from '@theme/TabItem'; -**`modern` 转发** 是 Velocity 的原生格式，以高效的二进制格式转发所有玩家信息，并采用 MAC 代码增加安全性，使非法服务器难以绕过你的 Velocity 代理。但它**仅支持 Minecraft 1.13 或更高版本**。 +**`modern` 转发** 是 Velocity 的原生格式，以高效的二进制格式转发所有玩家信息，并采用 MAC 代码增加安全性，使非法服务器难以绕过你的 Velocity 代理。但它 **仅支持 Minecraft 1.13 或更高版本**。 :::warning @@ -151,8 +151,8 @@ import TabItem from '@theme/TabItem'; ### 传统转发增加安全性 - 对于托管在共享主机上的代理，Velocity 可选地支持 **BungeeGuard**。 - - 将 `velocity.toml` 中的 `player-info-forwarding` 设置为 `bungeeguard`。 - - 在 BungeeGuard 配置的令牌部分添加 `forwarding.secret` 文件中的值。 + - 将 `velocity.toml` 中的 `player-info-forwarding` 设置为 `bungeeguard`。 + - 在 BungeeGuard 配置的令牌部分添加 `forwarding.secret` 文件中的值。 ### 为 Spigot / Paper 配置传统转发 diff --git a/docs-java/process/cross-server/build-up/Velocity/velocity.toml.md b/docs-java/process/cross-server/setup/velocity/velocity-toml.md similarity index 97% rename from docs-java/process/cross-server/build-up/Velocity/velocity.toml.md rename to docs-java/process/cross-server/setup/velocity/velocity-toml.md index f7e4e0aaa..175370563 100644 --- a/docs-java/process/cross-server/build-up/Velocity/velocity.toml.md +++ b/docs-java/process/cross-server/setup/velocity/velocity-toml.md @@ -14,7 +14,7 @@ config-version = "2.7" # 代理应该绑定到哪个端口？默认情况下，我们将绑定到 25577 端口的所有地址。 bind = "0.0.0.0:25577" -# 应该显示什么 MOTD(服务器消息)？当玩家将你的服务器添加到他们的服务器列表时，会显示这个。只接受 MiniMessage 格式。 +# 应该显示什么 MOTD (服务器消息)？当玩家将你的服务器添加到他们的服务器列表时，会显示这个。只接受 MiniMessage 格式。 motd = "<#09add3>一个 Velocity 服务器" # 我们应该显示多少最大玩家数？(Velocity 不支持在线玩家数的限制。) diff --git a/docs-java/process/cross-server/build-up/Velocity/velocity.md b/docs-java/process/cross-server/setup/velocity/velocity.md similarity index 78% rename from docs-java/process/cross-server/build-up/Velocity/velocity.md rename to docs-java/process/cross-server/setup/velocity/velocity.md index e8e92e3d4..21a8903dd 100644 --- a/docs-java/process/cross-server/build-up/Velocity/velocity.md +++ b/docs-java/process/cross-server/setup/velocity/velocity.md @@ -14,25 +14,25 @@ sidebar_position: 2 ### 什么是 Velocity？ -Velocity 可以说是目前最优秀的**Minecraft 代理端**之一，由经验丰富的 PaperMC 团队研发，Velocity 拥有先进的转发方式和极高的安全性。与此同时，Velocity 也有优秀的性能表现 +Velocity 可以说是目前最优秀的 **Minecraft 代理端** 之一，由经验丰富的 PaperMC 团队研发，Velocity 拥有先进的转发方式和极高的安全性。与此同时，Velocity 也有优秀的性能表现 使用 Velocity，能让你的群组服务器锦上添花 -如果你开的是 mod 群组服务器，那么强烈推荐使用 Velocity，因为他对 forge 和 fabric 服务端做了特别的适配 +如果你开的是 mod 群组服务器，那么强烈推荐使用 Velocity，因为他对 Forge 和 Fabric 服务端做了特别的适配 -当然，Mod 服务端原生不支持 Velocity，需要安装让 Mod 端支持 Velocity 的 Mod +当然，mod 服务端原生不支持 Velocity，需要安装让 mod 端支持 Velocity 的 mod -- Fabric 端支持 Velocity Mod：[CrossTitch](https://www.curseforge.com/minecraft/mc-mods/crossstitch) +- Fabric 端支持 Velocity mod：[CrossTitch](https://www.curseforge.com/minecraft/mc-mods/crossstitch) -- Fabric 端支持 Velocity Mod：[FabricProxy-Lite](https://modrinth.com/mod/fabricproxy-lite) +- Fabric 端支持 Velocity mod：[FabricProxy-Lite](https://modrinth.com/mod/fabricproxy-lite) -- Forge 端支持 Velocity Mod：[Proxy Compatible Forge](https://modrinth.com/mod/proxy-compatible-forge) +- Forge 端支持 Velocity mod：[Proxy Compatible Forge](https://modrinth.com/mod/proxy-compatible-forge) ## FAQ -1. Q：velocity 支持 Bungeecord 和 Waterfall 插件吗？ +1. Q：Velocity 支持 BungeeCord 和 Waterfall 插件吗？ A：不支持，因为如果支持 BungeeCord 插件的话，那么很多 Velocity 的功能就无从实现了。 @@ -62,7 +62,7 @@ Can't connect to server lobby: If you wish to use IP forwarding, please enable i Can't connect to server lobby: Your server did not send a forwarding request to the proxy. Is it set up correctly? ``` -这些报错是你不正确配置代理端引起的 [点此前往了解 velocity 配置](velocity.toml.md) +这些报错是你不正确配置代理端引起的 [点此前往了解 Velocity 配置](velocity-toml.md) 此外，如果你同时启用了 BungeeCord 模式，也会报出以上错误，如果你使用 Velocity，那么请务必关闭 BungeeCord 模式 @@ -81,7 +81,7 @@ A: 如果你的服务器会出现这种情况： [connected player] player1 (/localhost: 58943): kicked from server hub: Invalid payload REGISTER! ``` -这种情况一般发生在插件服群组中。当有些人使用 Mod 客户端进入服务器时，有可能出现这种问题。 +这种情况一般发生在插件服群组中。当有些人使用 mod 客户端进入服务器时，有可能出现这种问题。 如果你使用 Paper (或者其他 Fork 版本) 1.12.2 或者以上的服务端，你可以在启动脚本中添加 flag `-Dpaper.disableChannelLimit=true` 来解决这个问题 @@ -89,8 +89,8 @@ A: 如果你的服务器会出现这种情况： 5. Q：在加入到 Froge 服务器时 readTimeout -A: 一句话，Mod 太多太大导致连接时间延长了。 -你可以减少服务器的 Mod 数量或者在 Velocity 配置文件中设置 `read-timeout` 的值，同时在你的 Forge 子服的启动参数中添加 `-Dfml.readTimeout` 参数来提高阈值。 +A: 一句话，mod 太多太大导致连接时间延长了。 +你可以减少服务器的 mod 数量或者在 Velocity 配置文件中设置 `read-timeout` 的值，同时在你的 Forge 子服的启动参数中添加 `-Dfml.readTimeout` 参数来提高阈值。 比如，你想设置你的 readTimeout 时间到 120 秒 那么你可以设置： @@ -98,13 +98,13 @@ A: 一句话，Mod 太多太大导致连接时间延长了。 `-Dfml.readTimeout=120` (单位：秒) -这样，将服务器重启后，readTimeout 时间就拉长了，下次就可以正常进入服务器了 +这样，将服务器重启后，`readTimeout` 时间就拉长了，下次就可以正常进入服务器了 6. Q：我可以每个子服都使用不同的转发模式吗？ A: 不行，至少现在不行，你只能在 `velocity.toml` 中设置一个单一的转发模式 -关于各个不同的转发模式，可以看到这里 [搭建](./build-up.md#子服配置) +关于各个不同的转发模式，可以看到这里 [搭建](setup.md#子服配置) 有大佬提出了关于这个问题的 [PR](https://github.com/PaperMC/Velocity/pull/1357) diff --git a/docs-java/process/dashboard.md b/docs-java/process/dashboard.md index 3e6c69ac3..69eebf7b3 100644 --- a/docs-java/process/dashboard.md +++ b/docs-java/process/dashboard.md @@ -3,4 +3,4 @@ title: 搭建面板 sidebar_position: 7 --- -请见 [通用 | 搭建面板](/process/dashboard) +请见 [通用 | 搭建面板](/process/panel) diff --git a/docs-java/process/maintenance/anticheat/anti-crash.md b/docs-java/process/maintenance/anticheat/anti-crash.md index b38929766..f5920be73 100644 --- a/docs-java/process/maintenance/anticheat/anti-crash.md +++ b/docs-java/process/maintenance/anticheat/anti-crash.md @@ -70,7 +70,7 @@ sidebar_position: 5 ### 运行环境类 -这类漏洞基本上很难避免，如 log4j，在未发现之前谁也不知道。 +这类漏洞基本上很难避免，如 Log4j，在未发现之前谁也不知道。 服主还是尽可能的多关注网络信息，保证自己能尽快了解到一些漏洞的产生，防止被攻击者钻空子。 @@ -78,7 +78,7 @@ sidebar_position: 5 :::tip -防御原版漏洞最好的方法永远是将你的服务端核心**更新到最新版** +防御原版漏洞最好的方法永远是将你的服务端核心 **更新到最新版** 以下解决方案大部分都是为非最新版本提供的，有些特殊的在最新版本也能生效 @@ -90,9 +90,9 @@ sidebar_position: 5 这类如果你是低版本服务器，就需要安装相应的插件进行防御，以下是一些推荐的插件，**推荐以下四个插件一起安装** -#### AnarchyExploitFixes(免费) +#### AnarchyExploitFixes (免费) -[下载地址](https://github.com/xGinko/AnarchyExploitFixes/releases),一个 Minecraft 原版漏洞的修复插件 +[下载地址](https://github.com/xGinko/AnarchyExploitFixes/releases)，一个 Minecraft 原版漏洞的修复插件 例如非法物品，无效游戏名 :::tip @@ -103,23 +103,23 @@ sidebar_position: 5 #### LPX (付费) -[购买地址](https://builtbybit.com/resources/lpx-antipacketexploit.15709/),准确来说，LPX 防御的不是原版漏洞，而是防止攻击者使用特殊的包让 -Netty 处理超时 (NettyCrashers),虽然不会崩服，但会严重影响玩家游戏体验 +[购买地址](https://builtbybit.com/resources/lpx-antipacketexploit.15709/)，准确来说，LPX 防御的不是原版漏洞，而是防止攻击者使用特殊的包让 +Netty 处理超时 (NettyCrashers)，虽然不会崩服，但会严重影响玩家游戏体验 这个插件在最新版本依旧有用 #### Panilla (付费开源) -[购买地址](https://www.spigotmc.org/resources/panilla-prevent-hacked-items.65694/)(被标为 inactive 是因为换维护者了，还没通知 Spigot),[GitHub](https://github.com/ds58/Panilla) +[购买地址](https://www.spigotmc.org/resources/panilla-prevent-hacked-items.65694/) (被标为 inactive 是因为换维护者了，还没通知 Spigot), [GitHub](https://github.com/ds58/Panilla) Panilla 主要是用于防止服务器上滥用 NBT 和数据包的插件，禁用了一些生存模式下无法获得的东西，修复了一些漏洞，该插件不仅可以预防服务器崩溃，还可预防非法 NBT 导致客户端崩溃 :::warning -有服主反映说 Panilla 会影响潜影盒中的物品 (物品消失),所以在安装到生产服务器前请**测试** +有服主反映说 Panilla 会影响潜影盒中的物品 (物品消失)，所以在安装到生产服务器前请 **测试** ::: #### Surf (免费) -[下载地址](https://github.com/Winds-Studio/Surf/releases),Surf 修复了很多 Minecraft 漏洞，同时支持 Folia +[下载地址](https://github.com/Winds-Studio/Surf/releases)，Surf 修复了很多 Minecraft 漏洞，同时支持 Folia diff --git a/docs-java/process/maintenance/anticheat/anticheat.md b/docs-java/process/maintenance/anticheat/anticheat.md index a41118a07..2e3feefcd 100644 --- a/docs-java/process/maintenance/anticheat/anticheat.md +++ b/docs-java/process/maintenance/anticheat/anticheat.md @@ -19,7 +19,7 @@ slug: /anticheat 一般认为的作弊包括但不限于： - 种子推演 -- RNG(随机数) 预测 +- RNG (随机数) 预测 - 自动前往、药品、举盾、挖矿等 - 刀刀暴击、杀戮光环等战斗作弊 - 穿墙、高跳、飞行等移动作弊 @@ -27,7 +27,7 @@ slug: /anticheat ## 注意 -反作弊在尽量不影响合法玩家游玩的前提下，**惩戒**和**阻拦**作弊玩家。 +反作弊在尽量不影响合法玩家游玩的前提下，**惩戒** 和 **阻拦** 作弊玩家。 但由于 Minecraft 协议的特殊性，很多数据是服务端难以判断是否合法的。 diff --git a/docs-java/process/maintenance/anticheat/anticheatplugins.md b/docs-java/process/maintenance/anticheat/anticheatplugins.md index 869b2b83e..e7684a66f 100644 --- a/docs-java/process/maintenance/anticheat/anticheatplugins.md +++ b/docs-java/process/maintenance/anticheat/anticheatplugins.md @@ -7,7 +7,7 @@ sidebar_position: 1 :::tip[写在最前] -混合端**不要**用下面所列的反作弊插件，建议使用 [次元反作弊](https://www.mcmod.cn/class/6578.html)，[SkAc 反作弊](https://www.mcmod.cn/class/18057.html) 或 [猫反作弊](https://www.wxmwl.com/?p=95) +混合端 **不要** 用下面所列的反作弊插件，建议使用 [次元反作弊](https://www.mcmod.cn/class/6578.html)，[SkAc 反作弊](https://www.mcmod.cn/class/18057.html) 或 [猫反作弊](https://www.wxmwl.com/?p=95) 次元反作弊的交流群：327175980 @@ -201,7 +201,7 @@ TotemGuard 是一个专门检测 AutoTotem 作弊的轻量级反作弊插件 ### 扩展工具 -这些插件自身不提供反作弊功能,但是可用于反作弊,推荐全部看一遍 +这些插件自身不提供反作弊功能，但是可用于反作弊，推荐全部看一遍 diff --git a/docs-java/process/maintenance/anticheat/antixray.md b/docs-java/process/maintenance/anticheat/antixray.md index 8bcab2841..2ac7098fc 100644 --- a/docs-java/process/maintenance/anticheat/antixray.md +++ b/docs-java/process/maintenance/anticheat/antixray.md @@ -25,7 +25,7 @@ sidebar_position: 2 #### 自动版 -请使用[笨蛋脚本](https://script.8aka.org/auto-antiseedcracker)，在服务器根目录执行即可自动配置!! +请使用 [笨蛋脚本](https://script.8aka.org/auto-antiseedcracker)，在服务器根目录执行即可自动配置!! #### 特征使用随机种子 @@ -75,9 +75,9 @@ seed-stronghold: default :::danger[特别注意] -在 1.21.1 之前，开启或关闭 Leaf 安全种子**必须**删除原有存档！ +在 1.21.1 之前，开启或关闭 Leaf 安全种子 **必须** 删除原有存档！ -在 1.21.1 后支持直接转换为安全种子，不需要**删除存档**! +在 1.21.1 后支持直接转换为安全种子，不需要 **删除存档**! ::: @@ -93,9 +93,9 @@ seed-stronghold: default #### 自动版 -使用[笨蛋脚本](https://script.8aka.org/auto_antixray)，在服务器根目录执行脚本即可自动配置!! +使用 [笨蛋脚本](https://script.8aka.org/auto_antixray)，在服务器根目录执行脚本即可自动配置!! -⚠警告：`engine-mode: 3` 在 `paper 1.19.3` 往后的版本才添加⚠ +⚠警告：`engine-mode: 3` 在 `Paper 1.19.3` 往后的版本才添加⚠ > 主世界推荐配置 @@ -168,7 +168,7 @@ anticheat:
- 配置Ⅱ - *带宽消耗中等，效果中等 + 配置Ⅱ - *带宽消耗中等，效果中等* ```yaml anticheat: @@ -373,9 +373,9 @@ anticheat: enabled: false ``` -注意，如果你需要隐藏暴露在空气中的方块，需要将 `air` 添加到 `hidden-blocks` 和 `replacement-blocks` ，但这非常影响性能，不推荐。 +注意，如果你需要隐藏暴露在空气中的方块，需要将 `air` 添加到 `hidden-blocks` 和 `replacement-blocks`，但这非常影响性能，不推荐。 -如果你需要隐藏岩浆中的方块，请打开`lava-obscures`,但会影响性能 +如果你需要隐藏岩浆中的方块，请打开 `lava-obscures`，但会影响性能 :::info @@ -396,9 +396,9 @@ anticheat: #### RayTraceAntiXray(推荐) [RayTraceAntiXray](https://builtbybit.com/resources/raytraceantixray.24914/)， -[开源](https://github.com/stonar96/RayTraceAntiXray)付费且仅售 7 美元。 +[开源](https://github.com/stonar96/RayTraceAntiXray) 付费且仅售 7 美元。 -是一款用于隐藏 paper 服务器中使用 `engine-mode: 1` 时暴露在空气中的未隐藏方块的插件。 +是一款用于隐藏 Paper 服务器中使用 `engine-mode: 1` 时暴露在空气中的未隐藏方块的插件。 其使用了异步多线程光线追踪，判断玩家是否能看到目标方块，从而在玩家能够看到目标方块时发送真实方块信息。 @@ -440,7 +440,7 @@ world-settings: - spawner world_nether: anti-xray: - # 注意，ancient_debris(下界合金) 永远不会自然生成在暴露于空气的地方。 + # 注意，ancient_debris (下界合金) 永远不会自然生成在暴露于空气的地方。 # 普通引擎模式：1 已经足够，在下界禁用射线追踪。 ray-trace: false # 调整世界名称。 @@ -488,7 +488,7 @@ world-settings: # 调整世界名称。 world_nether: anti-xray: - # 注意，ancient_debris(下界合金) 永远不会自然生成在暴露于空气的地方。 + # 注意，ancient_debris (下界合金) 永远不会自然生成在暴露于空气的地方。 # 普通引擎模式：1 已经足够，在下界禁用射线追踪。 ray-trace: false # 调整世界名称。 diff --git a/docs-java/process/maintenance/anticheat/honeypot.md b/docs-java/process/maintenance/anticheat/honeypot.md index 41d1919d7..fc3a8bc40 100644 --- a/docs-java/process/maintenance/anticheat/honeypot.md +++ b/docs-java/process/maintenance/anticheat/honeypot.md @@ -9,7 +9,7 @@ sidebar_position: 5 Honeypot 是一款采用"蜜罐陷阱"机制的反作弊插件，通过诱导恶意玩家触发陷阱来检测和处理破坏行为。 -通常被用来检测 x-ray 玩家 +通常被用来检测 X-ray 玩家 ### 工作原理 @@ -131,7 +131,7 @@ honeypots: ## 使用策略 -### X-Ray 检测 +### X-ray 检测 1. **钻石层布置** - 在 Y=11-16 层放置假钻石矿 @@ -151,6 +151,7 @@ honeypots: - 设置警告或踢出动作 2. **仓库保护** + ```bash # 将箱子设为蜜罐 /honeypot create theft_warn diff --git a/docs-java/process/maintenance/anticheat/rng.md b/docs-java/process/maintenance/anticheat/rng.md index eb426ba7b..51569d386 100644 --- a/docs-java/process/maintenance/anticheat/rng.md +++ b/docs-java/process/maintenance/anticheat/rng.md @@ -38,7 +38,7 @@ RNG 是 **随机数生成器** 的简写。 [Paper](https://papermc.io) 核心 (包括它们的分支)，可以防止玩家破解 RNG。 -其中， [Purpur](https://purpurmc.org/) 和 [Leaves](https://leavesmc.org/) (包括它们的分支) 可以自行选择使用的 RNG 算法。 +其中，[Purpur](https://purpurmc.org/) 和 [Leaves](https://leavesmc.org/) (包括它们的分支) 可以自行选择使用的 RNG 算法。 对于 [Purpur](https://purpurmc.org/) 和 [Leaves](https://leavesmc.org/) 用户，你可以根据自己的核心类型按照下文修改配置 (默认就是开启的)： diff --git a/docs-java/process/maintenance/backup.md b/docs-java/process/maintenance/backup.md index 8ac1c08a8..a53525b64 100644 --- a/docs-java/process/maintenance/backup.md +++ b/docs-java/process/maintenance/backup.md @@ -11,10 +11,10 @@ sidebar_position: 5 推荐两个备份插件 (高效的备份，无需停服即可备份)： -[ebackup](https://www.spigotmc.org/resources/ebackup-simple-and-reliable-backups-for-your-server-supports-ftp-sftp.69917/) +[eBackup](https://www.spigotmc.org/resources/ebackup-simple-and-reliable-backups-for-your-server-supports-ftp-sftp.69917/) 可设置黑名单不备份某些文件，FTP 远程备份支持 -[serverbackup](https://www.spigotmc.org/resources/server-backup-ingame-dropbox-ftp-backup-1-8-1-20-multithreaded.79320/) +[Server Backup](https://www.spigotmc.org/resources/server-backup-ingame-dropbox-ftp-backup-1-8-1-20-multithreaded.79320/) 可支持动态备份 (即只备份最近变更过的文件)，占用空间更小 :::warning @@ -57,9 +57,9 @@ python main.py [相对/绝对目录] [时长] [类型] ### 手动备份 -Windows 系统在服务器根目录右键点击压缩即可 (如果时间比较急推荐 zip，如果空间比较紧推荐 7zip)。 +Windows 系统在服务器根目录右键点击压缩即可 (如果时间比较急推荐 zip，如果空间比较紧推荐 7-Zip)。 -Linux 使用指令 `tar -czvf backup_date.tar.gz /[path]/` (如果使用 7zip 请自行查看 7zip 指令)。 +Linux 使用指令 `tar -czvf backup_date.tar.gz /[path]/` (如果使用 7-Zip 请自行查看 7-Zip 指令)。 面板 - 大多数面板都可以像 Windows 一键压缩。 diff --git a/docs-java/process/maintenance/lang/javascript/extend/graaljs.md b/docs-java/process/maintenance/lang/javascript/extend/graaljs.md index 0f924bbea..56115184e 100644 --- a/docs-java/process/maintenance/lang/javascript/extend/graaljs.md +++ b/docs-java/process/maintenance/lang/javascript/extend/graaljs.md @@ -9,28 +9,28 @@ sidebar_position: 2 ### Nashorn 兼容 -`nashorn-compat`选项下可用的功能包括： +`nashorn-compat` 选项下可用的功能包括： - `Java.isJavaFunction`, `Java.isJavaMethod`, `Java.isScriptObject`, `Java.isScriptFunction` - `new Interface|AbstractClass(fn|obj)` - `JavaImporter` - `JSAdapter` -- `java.lang.String`方法 +- `java.lang.String` 方法 - `load("nashorn:parser.js")`, `load("nashorn:mozilla_compat.js")` - `exit`, `quit` -[Nashorn 语法扩展](nashorn.md#nashorn-语法扩展) 可以通过`js.syntax-extensions`实验性选项启用。如果启用 Nashorn 兼容模式（`js.nashorn-compat`），这些扩展也会默认启用。 +[Nashorn 语法扩展](nashorn.md#nashorn-语法扩展) 可以通过 `js.syntax-extensions` 实验性选项启用。如果启用 Nashorn 兼容模式（`js.nashorn-compat`），这些扩展也会默认启用。 ### 类访问 -要访问 Java 类，GraalJS 支持`Java.type(typeName)`函数： +要访问 Java 类，GraalJS 支持 `Java.type(typeName)` 函数： ```js var FileClass = Java.type("java.io.File"); ``` -如果允许宿主类查找（`allowHostClassLookup`），则默认情况下可以访问`java`全局属性。 -例如，访问`java.io.File`的现有代码应该重写为使用`Java.type(name)`函数： +如果允许宿主类查找（`allowHostClassLookup`），则默认情况下可以访问 `java` 全局属性。 +例如，访问 `java.io.File` 的现有代码应该重写为使用 `Java.type(name)` 函数： ```js // GraalJS（和 Nashorn）兼容的语法 @@ -39,17 +39,17 @@ var FileClass = Java.type("java.io.File"); var FileClass = java.io.File; ``` -GraalJS 提供了`Packages`、`java`等全局属性以便兼容性。 -然而，尽可能明确地使用`Java.type`访问所需的类更为推荐，原因有两个： +GraalJS 提供了 `Packages`、`java` 等全局属性以便兼容性。 +然而，尽可能明确地使用 `Java.type` 访问所需的类更为推荐，原因有两个： 1. 它一次性解析类，而不是尝试将每个属性解析为类。 -2. 如果类无法找到或不可访问，`Java.type`会立即抛出`TypeError`，而不是默默地将未解析的名称当作包处理。 +2. 如果类无法找到或不可访问，`Java.type` 会立即抛出 `TypeError`，而不是默默地将未解析的名称当作包处理。 -可以使用`js.java-package-globals`标志来禁用 Java 包的全局字段（设置为`false`以避免创建这些字段；默认值为`true`）。 +可以使用 `js.java-package-globals` 标志来禁用 Java 包的全局字段（设置为 `false` 以避免创建这些字段；默认值为 `true`）。 ### 构造 Java 对象 -可以使用 JavaScript 的`new`关键字构造 Java 对象： +可以使用 JavaScript 的 `new` 关键字构造 Java 对象： ```js var FileClass = Java.type("java.io.File"); @@ -73,12 +73,12 @@ var fileName = file.getName(); ### 方法参数的转换 -JavaScript 定义了操作`double`数字类型。 -出于性能考虑，GraalJS 可能会在内部使用额外的 Java 数据类型（例如`int`类型）。 +JavaScript 定义了操作 `double` 数字类型。 +出于性能考虑，GraalJS 可能会在内部使用额外的 Java 数据类型（例如 `int` 类型）。 在调用 Java 方法时，可能需要进行值转换。 -当 Java 方法期望一个`long`参数，而提供了一个`int`时，会发生这种情况（`type widening`）。 -如果这种转换会导致丢失信息，`TypeError`会被抛出： +当 Java 方法期望一个 `long` 参数，而提供了一个 `int` 时，会发生这种情况（`type widening`）。 +如果这种转换会导致丢失信息，`TypeError` 会被抛出： ```java // Java @@ -99,7 +99,7 @@ javaObject.intArg(1.1); // 丢失转换，TypeError! ``` 注意，参数值必须符合参数类型。 -你可以使用自定义[目标类型映射](https://www.graalvm.org/truffle/javadoc/org/graalvm/polyglot/HostAccess.Builder.html#targetTypeMapping-java.lang.Class-java.lang.Class-java.util.function.Predicate-java.util.function.Function-)来覆盖此行为。 +你可以使用自定义 [目标类型映射](https://www.graalvm.org/truffle/javadoc/org/graalvm/polyglot/HostAccess.Builder.html#targetTypeMapping-java.lang.Class-java.lang.Class-java.util.function.Predicate-java.util.function.Function-) 来覆盖此行为。 ### 方法选择 @@ -122,10 +122,10 @@ javaObject.foo(1.1); // 将调用 foo(double); javaObject.foo(Math.pow(2, 32)); // 将调用 foo(long); ``` -要覆盖此行为，可以使用`javaObject['methodName(paramTypes)']`语法显式选择方法重载。 +要覆盖此行为，可以使用 `javaObject['methodName(paramTypes)']` 语法显式选择方法重载。 参数类型需要用逗号分隔且不带空格，对象类型需要完全限定（例如，`'get(java.lang.String,java.lang.String[])'`）。 请注意，这与 Nashorn 不同，Nashorn 允许额外的空格和简单名称。 -在上面的例子中，可能总是希望调用`foo(long)`，即使`foo(short)`可以通过无损转换访问（`foo(1)`）： +在上面的例子中，可能总是希望调用 `foo(long)`，即使 `foo(short)` 可以通过无损转换访问（`foo(1)`）： ```js javaObject["foo(int)"]; @@ -133,7 +133,7 @@ javaObject["foo(double)"]; ``` 注意，参数值仍然必须符合参数类型。 -你可以使用自定义[目标类型映射](https://www.graalvm.org/truffle/javadoc/org/graalvm/polyglot/HostAccess.Builder.html#targetTypeMapping-java.lang.Class-java.lang.Class-java.util.function.Predicate-java.util.function.Function-)来覆盖此行为。 +你可以使用自定义 [目标类型映射](https://www.graalvm.org/truffle/javadoc/org/graalvm/polyglot/HostAccess.Builder.html#targetTypeMapping-java.lang.Class-java.lang.Class-java.util.function.Predicate-java.util.function.Function-) 来覆盖此行为。 显式选择方法重载也在方法重载模糊不清且无法自动解析时有用，或者当你想要覆盖默认选择时： @@ -166,9 +166,9 @@ GraalJS 的未来版本可能会取消此限制。 ### 包访问 -GraalJS 提供了一个`Packages`全局属性： +GraalJS 提供了一个 `Packages` 全局属性： -```shell +```text > Packages.java.io.File JavaClass[java.io.File] ``` @@ -199,7 +199,7 @@ iarr[0] = iarr[iarr.length] * 2; ### Map 访问 -在 GraalJS 中，你可以创建和访问 Java Map，例如`java.util.HashMap`： +在 GraalJS 中，你可以创建和访问 Java Map，例如 `java.util.HashMap`： ```js var HashMap = Java.type("java.util.HashMap"); @@ -219,7 +219,7 @@ for (var key in map) { ### List 访问 -在 GraalJS 中，你可以创建和访问 Java List，例如`java.util.ArrayList`： +在 GraalJS 中，你可以创建和访问 Java List，例如 `java.util.ArrayList`： ```js var ArrayList = Java.type("java.util.ArrayList"); @@ -237,18 +237,18 @@ for (var idx in list) { ### 字符串访问 GraalJS 可以与 Java 字符串互操作。 -字符串的长度可以通过`length`属性查询（请注意，`length`是一个值属性，不能像函数一样调用）： +字符串的长度可以通过 `length` 属性查询（请注意，`length` 是一个值属性，不能像函数一样调用）： ```js var javaString = new (Java.type("java.lang.String"))("Java"); javaString.length === 4; ``` -请注意，GraalJS 在内部使用 Java 字符串来表示 JavaScript 字符串，因此上述代码与 JavaScript 字符串字面量`"Java"`实际上是不可区分的。 +请注意，GraalJS 在内部使用 Java 字符串来表示 JavaScript 字符串，因此上述代码与 JavaScript 字符串字面量 `"Java"` 实际上是不可区分的。 ### 迭代属性 -Java 类和 Java 对象的属性（字段和方法）可以通过 JavaScript 的`for..in`循环进行迭代： +Java 类和 Java 对象的属性（字段和方法）可以通过 JavaScript 的 `for..in` 循环进行迭代： ```java var m = Java.type('java.lang.Math') @@ -262,17 +262,17 @@ for (var i in m) { print(i); } ## JavaImporter -`JavaImporter`功能仅在 Nashorn 兼容模式下可用（通过`js.nashorn-compat`选项）。 +`JavaImporter` 功能仅在 Nashorn 兼容模式下可用（通过 `js.nashorn-compat` 选项）。 ## Java 类和 Java 对象的控制台输出 -GraalJS 提供了`print`和`console.log`。 +GraalJS 提供了 `print` 和 `console.log`。 -GraalJS 提供了与 Nashorn 兼容的内置`print`函数。 +GraalJS 提供了与 Nashorn 兼容的内置 `print` 函数。 -`console.log`由 Node.js 直接提供。 +`console.log` 由 Node.js 直接提供。 它不会特别处理互操作对象。 -请注意，GraalJS 中的`console.log`默认实现仅是`print`的别名，而 Node 的实现仅在 Node.js 环境下可用。 +请注意，GraalJS 中的 `console.log` 默认实现仅是 `print` 的别名，而 Node 的实现仅在 Node.js 环境下可用。 ## 异常 @@ -289,32 +289,32 @@ try { ## Promises -GraalJS 支持 JavaScript`Promise`对象与 Java 的互操作性。 -Java 对象可以作为*thenable*对象暴露给 JavaScript 代码，允许 JavaScript 代码`await`Java 对象。 -此外，JavaScript 的`Promise`对象是常规的 JavaScript 对象，可以通过本文件中描述的机制从 Java 访问。 +GraalJS 支持 JavaScript `Promise` 对象与 Java 的互操作性。 +Java 对象可以作为 *thenable* 对象暴露给 JavaScript 代码，允许 JavaScript 代码 `await` Java 对象。 +此外，JavaScript 的 `Promise` 对象是常规的 JavaScript 对象，可以通过本文件中描述的机制从 Java 访问。 这使得 Java 代码能够在 JavaScript Promise 被解析或拒绝时从 JavaScript 回调。 -### 使用`await`与 Java 对象 +### 使用 `await` 与 Java 对象 -JavaScript 应用程序可以使用`await`表达式与 Java 对象交互。 +JavaScript 应用程序可以使用 `await` 表达式与 Java 对象交互。 当 Java 和 JavaScript 必须与异步事件交互时，这非常有用。 -要将 Java 对象暴露给 GraalJS 作为*thenable*对象，Java 对象应实现一个名为`then()`的方法，其签名如下： +要将 Java 对象暴露给 GraalJS 作为 *thenable* 对象，Java 对象应实现一个名为 `then()` 的方法，其签名如下： ```java void then(Value onResolve, Value onReject); ``` -当`await`与实现`then()`的 Java 对象一起使用时，GraalJS 将把该对象视为 JavaScript `Promise`。 -`onResolve`和`onReject`参数是可执行的`Value`对象，应由 Java 代码使用来恢复或中止与相应 Java 对象关联的 JavaScript `await`表达式。 -更多详细示例用法可以在 GraalJS [单元测试](https://github.com/graalvm/graaljs/blob/master/graal-js/src/com.oracle.truffle.js.test/src/com/oracle/truffle/js/test/interop/AsyncInteropTest.java)中找到。 +当 `await` 与实现 `then()` 的 Java 对象一起使用时，GraalJS 将把该对象视为 JavaScript `Promise`。 +`onResolve` 和 `onReject` 参数是可执行的 `Value` 对象，应由 Java 代码使用来恢复或中止与相应 Java 对象关联的 JavaScript `await` 表达式。 +更多详细示例用法可以在 GraalJS [单元测试](https://github.com/graalvm/graaljs/blob/master/graal-js/src/com.oracle.truffle.js.test/src/com/oracle/truffle/js/test/interop/AsyncInteropTest.java) 中找到。 ## 扩展 Java 类 -GraalJS 支持使用`Java.extend`函数扩展 Java 类和接口。 +GraalJS 支持使用 `Java.extend` 函数扩展 Java 类和接口。 ### Java.extend -`Java.extend(types...)`返回一个生成的适配器 Java 类对象，该对象扩展了指定的 Java 类和/或接口。 +`Java.extend(types...)` 返回一个生成的适配器 Java 类对象，该对象扩展了指定的 Java 类和/或接口。 例如： ```js @@ -336,7 +336,7 @@ var impl = new Ext({ impl.superclassMethod(); ``` -可以通过`Java.super(adapterInstance)`调用父类方法。 +可以通过 `Java.super(adapterInstance)` 调用父类方法。 这是一个综合示例： ```js @@ -360,7 +360,7 @@ fw.write("***lmno**", 3, 4); print(sw); // ABCDEFGHIJKLMNO ``` -请注意，在`nashorn-compat`模式下，你还可以使用接口或抽象类的类型对象上的新操作符来扩展接口和抽象类： +请注意，在 `nashorn-compat` 模式下，你还可以使用接口或抽象类的类型对象上的新操作符来扩展接口和抽象类： ```js // --experimental-options --js.nashorn-compat diff --git a/docs-java/process/maintenance/lang/javascript/extend/nashorn.md b/docs-java/process/maintenance/lang/javascript/extend/nashorn.md index 8f33cc79a..6cbeb7b9c 100644 --- a/docs-java/process/maintenance/lang/javascript/extend/nashorn.md +++ b/docs-java/process/maintenance/lang/javascript/extend/nashorn.md @@ -7,7 +7,7 @@ sidebar_position: 1 ## 访问 Java 类 -要从 JavaScript 访问原始类型和引用类型的 Java 类型，可以调用`Java.type()`函数，返回与传入的类名称对应的类型对象。例如，以下示例演示了如何获取各种类型对象： +要从 JavaScript 访问原始类型和引用类型的 Java 类型，可以调用 `Java.type()` 函数，返回与传入的类名称对应的类型对象。例如，以下示例演示了如何获取各种类型对象： ```js var ArrayList = Java.type("java.util.ArrayList"); @@ -22,14 +22,14 @@ var int2DArrayType = Java.type("int[][]"); var anArrayList = new Java.type("java.util.ArrayList"); ``` -可以使用`Java.type()`返回的类型对象来访问静态字段和方法： +可以使用 `Java.type()` 返回的类型对象来访问静态字段和方法： ```js var File = Java.type("java.io.File"); File.createTempFile("nashorn", ".tmp"); ``` -要访问静态内部类，可以在`Java.type()`方法的参数中使用美元符号（$）。以下示例演示了如何返回`java.awt.geom.Arc2D`中的`Float`内部类的类型对象： +要访问静态内部类，可以在 `Java.type()` 方法的参数中使用美元符号（$）。以下示例演示了如何返回 `java.awt.geom.Arc2D` 中的 `Float` 内部类的类型对象： ```js var Float = Java.type("java.awt.geom.Arc2D$Float"); @@ -44,11 +44,11 @@ var Float = Arc2D.Float; 对于非静态内部类，必须将外部类的实例作为构造函数的第一个参数。 -尽管 JavaScript 中的类型对象与 Java 中的`java.lang.Class`对象类似，但它们是不同的。你可以使用`class`和`static`属性将两者互相转换。 +尽管 JavaScript 中的类型对象与 Java 中的 `java.lang.Class` 对象类似，但它们是不同的。你可以使用 `class` 和 `static` 属性将两者互相转换。 ## 导入 Java 包和类 -为了通过简化名称访问 Java 类，可以使用`importPackage()`和`importClass()`函数来导入 Java 包和类。以下示例展示了如何使用这两个函数： +为了通过简化名称访问 Java 类，可以使用 `importPackage()` 和 `importClass()` 函数来导入 Java 包和类。以下示例展示了如何使用这两个函数： ```js // 加载兼容性脚本 @@ -65,11 +65,11 @@ frame.setVisible(true); print(frame.title); ``` -标准的 Java SE 包有快捷方式（例如，`java`代表`Packages.java`，`javax`代表`Packages.javax`，`org`代表`Packages.org`）。`java.lang`包不会默认导入，因为其类可能与 JavaScript 中的内建对象（如 Object、Boolean、Math 等）冲突。 +标准的 Java SE 包有快捷方式（例如，`java` 代表 `Packages.java`，`javax` 代表 `Packages.javax`，`org` 代表 `Packages.org`）。`java.lang` 包不会默认导入，因为其类可能与 JavaScript 中的内建对象（如 Object、Boolean、Math 等）冲突。 ## 使用 Java 数组 -要创建一个 Java 数组对象，首先需要获取 Java 数组的类型对象，然后实例化它。访问数组元素和`length`属性的语法与 Java 中相同。以下示例演示了如何创建一个 Java 数组对象并访问其元素： +要创建一个 Java 数组对象，首先需要获取 Java 数组的类型对象，然后实例化它。访问数组元素和 `length` 属性的语法与 Java 中相同。以下示例演示了如何创建一个 Java 数组对象并访问其元素： ```js var StringArray = Java.type("java.lang.String[]"); @@ -83,7 +83,7 @@ print(a.length); print(a[0]); ``` -给定一个 JavaScript 数组，可以使用`Java.to()`方法将其转换为 Java 数组。你必须将 JavaScript 数组变量传递给此方法，并指定要返回的数组类型。 +给定一个 JavaScript 数组，可以使用 `Java.to()` 方法将其转换为 Java 数组。你必须将 JavaScript 数组变量传递给此方法，并指定要返回的数组类型。 ```js // 创建 JavaScript 数组 @@ -96,7 +96,7 @@ print(javaIntArray[0]); // 输出数字 1 ## 实现 Java 接口 -在 JavaScript 中实现 Java 接口的语法类似于在 Java 中声明匿名类。你可以实例化一个接口，并在同一个表达式中实现其方法。以下示例演示了如何实现`Runnable`接口： +在 JavaScript 中实现 Java 接口的语法类似于在 Java 中声明匿名类。你可以实例化一个接口，并在同一个表达式中实现其方法。以下示例演示了如何实现 `Runnable` 接口： ```js // 创建一个实现 Runnable 接口的对象，run 方法作为 JavaScript 函数实现 @@ -116,7 +116,7 @@ th.join(); ## 扩展抽象 Java 类 -你可以通过传递一个 JavaScript 对象并在其中实现抽象方法来实例化抽象 Java 类的匿名子类。以下示例展示了如何实例化`java.util.TimerTask`类的一个子类： +你可以通过传递一个 JavaScript 对象并在其中实现抽象方法来实例化抽象 Java 类的匿名子类。以下示例展示了如何实例化 `java.util.TimerTask` 类的一个子类： ```js var TimerTask = Java.type("java.util.TimerTask"); @@ -129,7 +129,7 @@ var task = new TimerTask({ ### 扩展具体 Java 类 -对于具体的 Java 类，不能直接使用类似于抽象类的扩展语法。要扩展具体类，必须使用`Java.extend()`函数。以下示例演示了如何扩展`java.lang.Thread`类并实现`run()`方法： +对于具体的 Java 类，不能直接使用类似于抽象类的扩展语法。要扩展具体类，必须使用 `Java.extend()` 函数。以下示例演示了如何扩展 `java.lang.Thread` 类并实现 `run()` 方法： ```js var Thread = Java.type("java.lang.Thread"); @@ -155,7 +155,7 @@ print(__FILE__, __LINE__, __DIR__); ## 加载脚本 -在 JavaScript 中加载额外的脚本文件非常方便。我们可以使用`load`函数加载本地或远程脚本。 +在 JavaScript 中加载额外的脚本文件非常方便。我们可以使用 `load` 函数加载本地或远程脚本。 ```javascript load("https://cdnjs.cloudflare.com/ajax/libs/underscore.js/1.6.0/underscore-min.js"); @@ -175,7 +175,7 @@ loadWithNewGlobal("script.js"); ### 将 JSON 对象传递给 Java -`Java.asJSONCompatible(obj)`函数接受一个脚本对象并返回一个与大多数 Java JSON 库兼容的对象。它将所有数组作为`List`对象暴露，而其他对象则作为`Map`对象暴露。 +`Java.asJSONCompatible(obj)` 函数接受一个脚本对象并返回一个与大多数 Java JSON 库兼容的对象。它将所有数组作为 `List` 对象暴露，而其他对象则作为 `Map` 对象暴露。 ## Nashorn 语法扩展 diff --git a/docs-java/process/maintenance/lang/javascript/javascript.md b/docs-java/process/maintenance/lang/javascript/javascript.md index e4e6583ee..1d89834f8 100644 --- a/docs-java/process/maintenance/lang/javascript/javascript.md +++ b/docs-java/process/maintenance/lang/javascript/javascript.md @@ -6,7 +6,7 @@ sidebar_position: 3 # JavaScript -JavaScript 在 Minecraft 中有着相当广泛的应用，很多插件和 Mod 都在内部提供了 JavaScript +JavaScript 在 Minecraft 中有着相当广泛的应用，很多插件和 mod 都在内部提供了 JavaScript 常见的实现： @@ -18,19 +18,19 @@ JavaScript 在 Minecraft 中有着相当广泛的应用，很多插件和 Mod 推荐在 [W3School](https://www.w3school.com.cn/js/index.asp) 上学习基础知识 -如果只需要在 Minecraft 上使用，则不需要学习`JS HTML DOM`,`JS Browser BOM` 和 `JS Async` +如果只需要在 Minecraft 上使用，则不需要学习 `JS HTML DOM`,`JS Browser BOM` 和 `JS Async` ## 引擎 JavaScript 运行在 JVM 上是需要执行引擎的，不同的 JS 引擎支持的版本和功能不一样，目前主要有以下引擎： -目前主要有 Nashorn,Rhino,GraalJS,Javet 四个引擎 +目前主要有 Nashorn, Rhino, GraalJS, Javet 四个引擎 Rhino 和 Javet 在 Minecraft 中目前应用很少，因此后续部分仅介绍 Nashorn 和 GraalJS :::warning -你无法改变插件/Mod 使用的 JS 引擎 (除非你有能力改源代码),当然你可以督促作者更改 JS 引擎 +你无法改变插件/mod 使用的 JS 引擎 (除非你有能力改源代码)，当然你可以督促作者更改 JS 引擎 ::: @@ -40,8 +40,8 @@ Nashorn 和 GraalJS 支持版本范围不同 (点击 ES 标准可查看添加的 Nashorn 支持版本： -- [ECMAScript 5.x(ES 5)](https://www.w3school.com.cn/js/js_es5.asp) -- [ECMAScript 2015(ES 6)](https://www.w3school.com.cn/js/js_es6.asp)(不完全支持) +- [ECMAScript 5.x (ES 5)](https://www.w3school.com.cn/js/js_es5.asp) +- [ECMAScript 2015 (ES 6)](https://www.w3school.com.cn/js/js_es6.asp) (不完全支持) - [JavaScript 扩展语法](extend/nashorn.md#nashorn-语法扩展) :::warning @@ -52,8 +52,8 @@ Nashorn 不支持 2015 年后的 ES 特性，在使用的时候请确保 Nashorn GraalJS 支持版本： -- [ECMAScript 5.x(ES 5)](https://www.w3school.com.cn/js/js_es5.asp) -- [ECMAScript 2015(ES 6)](https://www.w3school.com.cn/js/js_es6.asp) +- [ECMAScript 5.x (ES 5)](https://www.w3school.com.cn/js/js_es5.asp) +- [ECMAScript 2015 (ES 6)](https://www.w3school.com.cn/js/js_es6.asp) - [ECMAScript 2016](https://www.w3school.com.cn/js/js_2016.asp) - [ECMAScript 2017](https://www.w3school.com.cn/js/js_2017.asp) - [ECMAScript 2018](https://www.w3school.com.cn/js/js_2018.asp) @@ -75,7 +75,7 @@ Nashorn 目前支持 Java 8 + 以上的版本，GraalJS 支持 Java 11+ 版本 ### 性能 -根据 [Github 性能测试](https://github.com/caoccao/GraalJS-vs-Javet-vs-Nashorn), +根据 [GitHub 性能测试](https://github.com/caoccao/GraalJS-vs-Javet-vs-Nashorn), GraalJS 在非 GraalVM 上的执行性能是 Nashorn 的 8 倍，在 GraalVM 上的执行性能为 10~12 倍 ### 其他功能 @@ -86,6 +86,6 @@ GraalJS 有着 Nashorn 很多没有的功能 (虽然 Minecraft 不一定用得 - 更加安全，可以管控 JS 代码的执行权限 - **支持重载全局层面的运算符** - 与 Nashorn 完全兼容 (需要开启选项) -- 可以运行 WebAssembly,Python,Ruby -- 可以使用 NodeJS 和 NPM +- 可以运行 WebAssembly、Python、Ruby +- 可以使用 Node.js 和 npm - ... diff --git a/docs-java/process/maintenance/lang/kether/basic.md b/docs-java/process/maintenance/lang/kether/basic.md index 6fddcc8d0..08215568a 100644 --- a/docs-java/process/maintenance/lang/kether/basic.md +++ b/docs-java/process/maintenance/lang/kether/basic.md @@ -5,7 +5,7 @@ sidebar_position: 2 # 基础 -> 动作，又称语句，每个动作都功能明确，如：Tell(输出文本) +> 动作，又称语句，每个动作都功能明确，如：Tell (输出文本) 在这一节中，我将告诉你在 kether 中的一些基本概念 @@ -17,13 +17,13 @@ sidebar_position: 2 ![](_images/vul-tell.png) -这个动作的作用是给玩家发送一条信息 (图中的 1 ) +这个动作的作用是给玩家发送一条信息 (图中的 1) 下面的 `< > Result:` 是动作的返回值 (下面会讲) :::note -非调试 (/vul evel) 是不会看到这个的 +非调试 (`/vul evel`) 是不会看到这个的 ![](_images/result.png) @@ -37,7 +37,7 @@ sidebar_position: 2 我们可以用下面的 `color Text` 动作来搞颜色 -## 彩色 (color Text) +## 彩色 (Color Text) > https://kether.tabooproject.org/list.html#Color_Text @@ -92,7 +92,7 @@ sidebar_position: 2 所以在 [语句的连用](#语句的连用) 那里，我们可以在 `tell` 后面接一个 `color` 动作 -那么问题来了，为什么在 [Tell](#输出文本 Tell) 那里可以接一句话 (此处写了个 1)？ +那么问题来了，为什么在 [Tell](#输出文本-tell) 那里可以接一句话 (此处写了个 1)？ ![](_images/vul-tell.png) diff --git a/docs-java/process/maintenance/lang/kether/if.md b/docs-java/process/maintenance/lang/kether/if.md index 2eabae134..5ca39376f 100644 --- a/docs-java/process/maintenance/lang/kether/if.md +++ b/docs-java/process/maintenance/lang/kether/if.md @@ -21,7 +21,7 @@ sidebar_position: 3 ![](_images/vul-perm.png) -我是 op，所以我拥有此权限，返回了 true +我是 OP，所以我拥有此权限，返回了 true 同 [PlaceholderAPI](./basic#变量-placeholderapi) 一样，**Permission** 也有一个简写 **perm** @@ -235,7 +235,7 @@ any [ 动作1 动作2 动作3 更多 ] /vul eval if any [ perm vulpecula.command not perm luckperms.editor ] then tell 通过 else 不通过 ``` -_玩家拥有权限 vulpecula.command_ 和 _没有权限 luckperms.editor_ 满足其中一个或多个就通过 +*玩家拥有权限 vulpecula.command* 和 *没有权限 luckperms.editor* 满足其中一个或多个就通过 ![](_images/if_3.png) @@ -267,7 +267,7 @@ any [ 可是我想判断的是 `null` 这四个字母！这咋办？ -还记得之前学的 [literal](./basic#actiontoken和-literal) 吗？ +还记得之前学的 [literal](./basic.md#actiontoken和-literal) 吗？ ```yaml check 你要判断的东西 == literal null diff --git a/docs-java/process/maintenance/lang/kether/kether.md b/docs-java/process/maintenance/lang/kether/kether.md index 0c9c6c66e..80221647b 100644 --- a/docs-java/process/maintenance/lang/kether/kether.md +++ b/docs-java/process/maintenance/lang/kether/kether.md @@ -6,13 +6,13 @@ sidebar_position: 2 # 概览 -kether 并不是一个插件，而是使用 Taboolib 框架开发的插件 (如 TrMenu，TrChat，Adyeshach) 所使用的脚本语言。 +Kether 并不是一个插件，而是使用 Taboolib 框架开发的插件 (如 TrMenu，TrChat，Adyeshach) 所使用的脚本语言。 推荐教程：https://www.yuque.com/sacredcraft/kether -kether 语句表：https://kether.tabooproject.org/list.html +Kether 语句表：https://kether.tabooproject.org/list.html -vscode 插件-kether 动作补全：https://github.com/LiteCat0905/Kether-snippet +VS Code 插件-Kether 动作补全：https://github.com/LiteCat0905/Kether-snippet import DocCardList from '@theme/DocCardList'; diff --git a/docs-java/process/maintenance/lang/kether/math.md b/docs-java/process/maintenance/lang/kether/math.md index dbfc93d80..79c4f315a 100644 --- a/docs-java/process/maintenance/lang/kether/math.md +++ b/docs-java/process/maintenance/lang/kether/math.md @@ -49,12 +49,12 @@ math 1 + 3 * 5 / 6 - 2 详细请查看：https://github.com/TabooLib/taboolib/blob/master/module/module-kether/src/main/kotlin/taboolib/module/kether/action/transform/ActionJexl3.kt -- 加法：a + b -- 减法：a - b -- 乘法：a \* b -- 除法：a / b +- 加法：`a + b` +- 减法：`a - b` +- 乘法：`a \* b` +- 除法：`a / b` -- 取余：取余操作使用 % 符号。例如，计算 10 除以 3 的余数：10 % 3。 +- 取余：取余操作使用 `%` 符号。例如，计算 `10` 除以 `3` 的余数：`10 % 3`。 当然也可以使用括号： diff --git a/docs-java/process/maintenance/lang/kether/idk.md b/docs-java/process/maintenance/lang/kether/misc.md similarity index 80% rename from docs-java/process/maintenance/lang/kether/idk.md rename to docs-java/process/maintenance/lang/kether/misc.md index 75448a1c1..07ddfa94f 100644 --- a/docs-java/process/maintenance/lang/kether/idk.md +++ b/docs-java/process/maintenance/lang/kether/misc.md @@ -1,5 +1,5 @@ --- -title: 不知道放在哪 +title: 杂项 sidebar_position: 6 --- @@ -9,7 +9,7 @@ sidebar_position: 6 ## inline -inline 是在一段文本中插入语句，实际上会创造一个新的 kether 环境 +inline 是在一段文本中插入语句，实际上会创造一个新的 Kether 环境 例如这个 TrMenu 例子中： @@ -27,15 +27,15 @@ inline 是在一段文本中插入语句，实际上会创造一个新的 kether 而第二个 tell 打印了空值 -因为第二个 tell 后面是一个新的 kether 环境，里面没有原 kether 环境里的变量 +因为第二个 tell 后面是一个新的 Kether 环境，里面没有原 Kether 环境里的变量 -同时，你也不能使用原插件提供的 kether 私有语句，不过你可以尝试 [导入语句](https://www.yuque.com/sacredcraft/kether/namespace#zVbkg) +同时，你也不能使用原插件提供的 Kether 私有语句，不过你可以尝试 [导入语句](https://www.yuque.com/sacredcraft/kether/namespace#zVbkg) ![](_images/inline.png) ## join -join 是拼接多个语句，不会像 inline 那样创造新的环境，所以没有上述特性，join 里的语句会使用原 kether 环境 +join 是拼接多个语句，不会像 inline 那样创造新的环境，所以没有上述特性，join 里的语句会使用原 Kether 环境 ## 行内复合文本 diff --git a/docs-java/process/maintenance/lang/kether/preparation.md b/docs-java/process/maintenance/lang/kether/preparation.md index 2c0cf6128..eafdbc645 100644 --- a/docs-java/process/maintenance/lang/kether/preparation.md +++ b/docs-java/process/maintenance/lang/kether/preparation.md @@ -23,9 +23,9 @@ sidebar_position: 1 :::info -**别的插件执行 kether？** +**别的插件执行 Kether？** -好吧，如果你已经安装了其他可以用命令调试 kether 的插件...... +好吧，如果你已经安装了其他可以用命令调试 Kether 的插件...... **TrMenu v3** diff --git a/docs-java/process/maintenance/lang/kether/variable.md b/docs-java/process/maintenance/lang/kether/variable.md index cf3b5cc9f..a92af8eaa 100644 --- a/docs-java/process/maintenance/lang/kether/variable.md +++ b/docs-java/process/maintenance/lang/kether/variable.md @@ -36,9 +36,9 @@ TODO 思考 ing... -## kether +## Kether -此处讲解 kether 自己的变量，此变量特点是 kether 环境摧毁就消失 +此处讲解 Kether 自己的变量，此变量特点是 Kether 环境摧毁就消失 比如：TrMenu 关闭菜单，Vulpecula 的命令执行完成 @@ -74,7 +74,7 @@ get {token} | &{token} 还记得我说过的吗 -> 此变量特点是 kether 环境摧毁就消失 +> 此变量特点是 Kether 环境摧毁就消失 是的，当你执行完 `/vul eval set yizhan to 114514` 之后，kether 环境已经被摧毁了，所以这个变量就消失了 @@ -92,7 +92,7 @@ get {token} | &{token} ![](_images/var_4.png) -看到这里，你就应该知道，为什么前面讲 [彩色 (color Text)](./basic#彩色-color-text) 动作的时候会说 +看到这里，你就应该知道，为什么前面讲 [彩色 (Color Text)](./basic.md#彩色-color-text) 动作的时候会说 > 这里要用 `" "` 把要打印的信息包裹起来 > 否则他会把这个当成变量，具体的会在后面讲到 diff --git a/docs-java/process/maintenance/lang/kether/Vulpecula.md b/docs-java/process/maintenance/lang/kether/vulpecula.md similarity index 93% rename from docs-java/process/maintenance/lang/kether/Vulpecula.md rename to docs-java/process/maintenance/lang/kether/vulpecula.md index 640ee9717..6849b760f 100644 --- a/docs-java/process/maintenance/lang/kether/Vulpecula.md +++ b/docs-java/process/maintenance/lang/kether/vulpecula.md @@ -33,7 +33,7 @@ sidebar_position: 11 `GitHub` https://github.com/Lanscarlos/Vulpecula -`文档(中文)` https://www.yuque.com/lanscarlos/vulpecula-doc +`文档 (中文)` https://www.yuque.com/lanscarlos/vulpecula-doc ::: diff --git a/docs-java/process/maintenance/lang/lang.md b/docs-java/process/maintenance/lang/lang.md index d96d53b24..b939f6e14 100644 --- a/docs-java/process/maintenance/lang/lang.md +++ b/docs-java/process/maintenance/lang/lang.md @@ -1,6 +1,6 @@ # 脚本语言 -在 Minecraft 中，一些服主在实现一些功能的时候 (通常是一些简单的功能),不会使用 Java,Kotlin,Scala 等编程语言实现，而是通过一些脚本插件实现 +在 Minecraft 中，一些服主在实现一些功能的时候 (通常是一些简单的功能)，不会使用 Java、Kotlin、Scala 等编程语言实现，而是通过一些脚本插件实现 脚本插件可以让你通过编写简单的脚本代码来实现极高自定义的功能（就像是自己写插件一样？） @@ -19,10 +19,10 @@ 通用语言是一些功能非常完备的语言，在 Minecraft 中常用的有以下语言： - Skript -- Kether(语言自身功能并不完备，但可以运行 JavaScript，并且有许多扩展，归为通用语言) +- Kether (语言自身功能并不完备，但可以运行 JavaScript，并且有许多扩展，归为通用语言) - JavaScript - Jexl -- OGNL(少见，已知实现是 Arthas) +- OGNL (少见，已知实现是 Arthas) 这些编程语言还可以与 Java 进行交互，实现非常复杂的功能 @@ -39,7 +39,7 @@ - Denizen - ... -在这部分文档中不会介绍特定语言，学习请查看官方 wiki +在这部分文档中不会介绍特定语言，学习请查看官方 Wiki import DocCardList from '@theme/DocCardList'; diff --git a/docs-java/process/maintenance/lang/skript/AdvancedTutorials.md b/docs-java/process/maintenance/lang/skript/advanced-tutorials.md similarity index 75% rename from docs-java/process/maintenance/lang/skript/AdvancedTutorials.md rename to docs-java/process/maintenance/lang/skript/advanced-tutorials.md index ca0383be6..a93abf299 100644 --- a/docs-java/process/maintenance/lang/skript/AdvancedTutorials.md +++ b/docs-java/process/maintenance/lang/skript/advanced-tutorials.md @@ -25,7 +25,7 @@ sidebar_position: 3 下面的代码块包含了一些 **skript-reflect** 基础的语法。 -其作用是在有玩家使用 **EssentialsX** 的 tpa 尝试`/tpa lilingfeng`时阻止这件事 +其作用是在有玩家使用 **EssentialsX** 的 tpa 尝试 `/tpa lilingfeng` 时阻止这件事 ```skript import: @@ -48,28 +48,28 @@ import: net.ess3.api.events.TPARequestEvent ``` -这两行代码意为导入`net.ess3.api.events`包中的`TPARequestEvent`**类**。 +这两行代码意为导入 `net.ess3.api.events` 包中的 `TPARequestEvent` **类**。 -`import:`块必须放在脚本的最左端，前面不能有缩进。 +`import:` 块必须放在脚本的最左端，前面不能有缩进。 对类的调用必须在导入完成后进行，因此我们建议你尽可能将此语句放在脚本中靠顶端的位置。 -通过`import:`块导入类后， **skript-reflect** 将创建一个 **Expressions** ，允许你通过其名称轻易地引用 Java 类。 +通过 `import:` 块导入类后， **skript-reflect** 将创建一个 **Expressions**，允许你通过其名称轻易地引用 Java 类。 ```skript on TPARequestEvent: ``` -这行代码意为注册监听`TPARequestEvent`事件，与普通 sk 里注册事件的语法没啥区别。 +这行代码意为注册监听 `TPARequestEvent` 事件，与普通 sk 里注册事件的语法没啥区别。 ```skript set {_ess_IUser} to event.getTarget() # 获取IUser对象 set {_player} to {_ess_IUser}.getBase() # 获取Player对象 ``` -这行代码意为调用这个事件里的`getTarget()`方法，来获取 tpa 的目标，其返回一个`IUser`。 +这行代码意为调用这个事件里的 `getTarget()` 方法，来获取 tpa 的目标，其返回一个 `IUser`。 -这个`IUser`是 EssentialsX 的一个**接口**，`User`类**实现**了它，可以在[essentialsx 的 javadoc](https://jd-v2.essentialsx.net/net/ess3/api/iuser)里查看。 +这个 `IUser` 是 EssentialsX 的一个 **接口**，`User` 类 **实现** 了它，可以在 [EssentialsX 的 Javadoc](https://jd-v2.essentialsx.net/net/ess3/api/iuser) 里查看。 ```skript if {_player} is player("lilingfeng"): @@ -91,31 +91,31 @@ on TPARequestEvent: 修改假人的名字这一行为应该在假人加入服务器时进行，所以我们得监听这一事件。 -我们需要找到 bot 事件到底是哪个，查询[Leaves 的 Javadoc](https://repo.leavesmc.org/javadoc/snapshots/org/leavesmc/leaves/leaves-api/1.20.6-R0.1-SNAPSHOT)： +我们需要找到 bot 事件到底是哪个，查询 [Leaves 的 Javadoc](https://repo.leavesmc.org/javadoc/snapshots/org/leavesmc/leaves/leaves-api/1.20.6-R0.1-SNAPSHOT)： ![搜索事件](_images/SearchEvent.png) -这里查询找到了`org.leavesmc.leaves.event.bot.BotEvent`事件。 +这里查询找到了 `org.leavesmc.leaves.event.bot.BotEvent` 事件。 -看命名就知道应该会有更详细的**子类**来**继承**它，点进去看看，可以看到： +看命名就知道应该会有更详细的 **子类** 来 **继承** 它，点进去看看，可以看到： ![查找子类](_images/QuerySubclasses.png) -通过看类名可以知道，`BotJoinEvent`就是我们要的事件。 +通过看类名可以知道，`BotJoinEvent` 就是我们要的事件。 看介绍，发现这个事件会“Called when a fakeplayer joins a server” -接下来让我们看看这个类有哪些**方法**。 +接下来让我们看看这个类有哪些 **方法**。 ![查找方法](_images/SearchMethods.png) -可以看到，最主要的是一个`getBot()`方法，在让我们看看这个方法会返回什么。 +可以看到，最主要的是一个 `getBot()` 方法，在让我们看看这个方法会返回什么。 -点击超链接，可以看到这个方法会返回一个`Bot`对象。 +点击超链接，可以看到这个方法会返回一个 `Bot` 对象。 -这个`Bot`接口是继承自`Player`的，也就是说，`Player`有的方法，`Bot`都有。 +这个 `Bot` 接口是继承自 `Player` 的，也就是说，`Player` 有的方法，`Bot` 都有。 -再次查询 [Bukkit API](https://bukkit.windit.net/javadoc/org/bukkit/entity/Player.html) 可以找到`Player`类有的方法，如`Player#setPlayerListName()`，这正是我们需要的方法。 +再次查询 [Bukkit API](https://bukkit.windit.net/javadoc/org/bukkit/entity/Player.html) 可以找到 `Player` 类有的方法，如 `Player#setPlayerListName()`，这正是我们需要的方法。 #### 编写程序 @@ -132,8 +132,7 @@ on BotJoinEvent: {_bot}.setPlayerListName("假的%{_bot_name}%") # 修改假人在tab列表里的名字 ``` -这一过程也可适用于其他插件，比如[zimzaza4 大蛇](https://github.com/zimzaza4)的 -[Skript-Floodgate-Api](https://github.com/zimzaza4/Skript-Floodgate-Api) ， +这一过程也可适用于其他插件，比如 [zimzaza4 大蛇](https://github.com/zimzaza4) 的 [Skript-Floodgate-Api](https://github.com/zimzaza4/Skript-Floodgate-Api)， 就是利用 **skript-reflect** 来调用 [Floodagate API](https://wiki.geysermc.org/floodgate/api/) 的。 可以查看下面的教程来详细学习 **skript-reflect** 的基础功能 (对，下面这一大坨只是基础) @@ -148,13 +147,13 @@ on BotJoinEvent: #### 导入 Java 类 -##### _在解析时导入类 (推荐)_ +##### *在解析时导入类 (推荐)* -在大多数情况下，无需运行脚本即可知道所需类的确切限定名称。如果是这种情况，你应该使用 **skript-reflect** 的`import`块： +在大多数情况下，无需运行脚本即可知道所需类的确切限定名称。如果是这种情况，你应该使用 **skript-reflect** 的 `import` 块： :::info -为避免冲突，`import`块创建的表达式仅对导入它们的脚本可用。你必须在使用它们的每个脚本中导入 Java 类。 +为避免冲突，`import` 块创建的表达式仅对导入它们的脚本可用。你必须在使用它们的每个脚本中导入 Java 类。 ::: @@ -185,9 +184,9 @@ command /example: ###### 在低于 1.17 的 Minecraft 版本上导入 NMS 类 -由于 **Minecraft** 1.17 以下版本的 **NMS** 包会随着每个 **Minecraft** 版本而变化，因此你应该动态生成包前缀。有关详细信息，请参阅[计算选项](https://tpgamesnl.gitbook.io/skript-reflect/advanced/computed-options#using-computed-options-for-nms-imports)。 +由于 **Minecraft** 1.17 以下版本的 **NMS** 包会随着每个 **Minecraft** 版本而变化，因此你应该动态生成包前缀。有关详细信息，请参阅 [计算选项](https://tpgamesnl.gitbook.io/skript-reflect/advanced/computed-options#using-computed-options-for-nms-imports)。 -##### _在运行时导入类_ +##### *在运行时导入类* 有时，在执行脚本之前，无法确定所需的类引用。 @@ -207,7 +206,7 @@ on script load: message "%{Player}%" # org.bukkit.entity.Player ``` -###### _从对象_ +###### *从对象* 语法： @@ -228,7 +227,7 @@ command /example: ###### 在 effect 命令中导入 -由于导入块在 effect 命令中不可用，因此你可以使用 import effect(仅在 effect 命令中可用)： +由于导入块在 effect 命令中不可用，因此你可以使用 import effect (仅在 effect 命令中可用)： ```skript import [as ] @@ -236,11 +235,11 @@ import [as ] 此导入只能在以上效果命令中使用，直到你停止服务器。 -##### _处理内部类_ +##### *处理内部类* -有时，一个类可能嵌套在另一个类中。当引用类的完全限定名称时，内部类使用一个`$`而不是`.` +有时，一个类可能嵌套在另一个类中。当引用类的完全限定名称时，内部类使用一个 `$` 而不是 `.` -例如，将`org.bukkit.entity.EnderDragon.Phase`变成`org.bukkit.entity.EnderDragon$Phase`。 +例如，将 `org.bukkit.entity.EnderDragon.Phase` 变成 `org.bukkit.entity.EnderDragon$Phase`。 内部类通常比其周围的类具有更通用的名称，因此应在别名下导入这些名称： @@ -261,7 +260,7 @@ on load: #### 运行 Java 代码 -##### _调用方法_ +##### *调用方法* 语法： @@ -277,7 +276,7 @@ event-block.breakNaturally() player.giveExpLevels({_levels}) ``` -方法可以用作 **Effects** 、 **Expressions** 和 **Conditions** 。如果用作**Conditions**，则只要方法的返回值不是 `false` 、`null`或`0`， +方法可以用作 **Effects** 、 **Expressions** 和 **Conditions** 。如果用作**Conditions**，则只要方法的返回值不是 `false`、`null` 或 `0`， 这个 **Conditions** 就会通过。 ###### 调用非公共方法 @@ -302,7 +301,7 @@ System.out.println[Object]({_something}) Math.max[int, int](0, {_value}) ``` -##### _调用字段_ +##### *调用字段* 语法： @@ -320,7 +319,7 @@ Math.max[int, int](0, {_value}) {_hashmap}.[HashMap]modCount ``` -##### _调用构造函数_ +##### *调用构造函数* 语法： @@ -350,13 +349,13 @@ on EnderDragonChangePhaseEvent: :::warning -一些插件使用自己的事件处理系统，或者不通过 **Bukkit** 的事件执行器传递他们的事件 ( **Skript** 的一些内部事件就是这种情况)。 +一些插件使用自己的事件处理系统，或者不通过 **Bukkit** 的事件执行器传递他们的事件 (**Skript** 的一些内部事件就是这种情况)。 -为了侦听事件，它必须扩展`org.bukkit.event.Event`并由 **Bukkit** 的事件执行器执行。 +为了侦听事件，它必须扩展 `org.bukkit.event.Event` 并由 **Bukkit** 的事件执行器执行。 ::: -你还可以使用同一处理程序侦听多个事件。这些事件不必相关，但如果尝试访问在一个事件中可用但在另一个事件中不可用的方法，则应采取适当的预防措施。例如，如果要同时侦听`org.bukkit.event.entity.ProjectileLaunchEvent`和`org.bukkit.event.entity.ProjectileHitEvent`： +你还可以使用同一处理程序侦听多个事件。这些事件不必相关，但如果尝试访问在一个事件中可用但在另一个事件中不可用的方法，则应采取适当的预防措施。例如，如果要同时侦听 `org.bukkit.event.entity.ProjectileLaunchEvent` 和 `org.bukkit.event.entity.ProjectileHitEvent`： ```skript import: @@ -367,9 +366,9 @@ on ProjectileLaunchEvent and ProjectileHitEvent: # your code ``` -##### 使用`event` **Expressions** +##### 使用 `event` **Expressions** -**skript-reflect** 公开一个叫做`event`的 **Expressions**，允许你使用反射访问事件值。 +**skript-reflect** 公开一个叫做 `event` 的 **Expressions**，允许你使用反射访问事件值。 语法： @@ -409,7 +408,7 @@ on EnderDragonChangePhaseEvent with priority highest: # your code ``` -可以使用`org.bukkit.event.EventPriority`中定义的任何事件优先级。优先级较低的事件处理程序在优先级较高的事件处理程序之前运行。 +可以使用 `org.bukkit.event.EventPriority` 中定义的任何事件优先级。优先级较低的事件处理程序在优先级较高的事件处理程序之前运行。 事件优先级： @@ -422,7 +421,7 @@ on EnderDragonChangePhaseEvent with priority highest: ##### 处理已取消的事件 -默认情况下，如果事件被优先级较低的处理程序取消，则不会调用事件处理程序。可以通过指定处理程序应处理`all`事件来更改此行为。 +默认情况下，如果事件被优先级较低的处理程序取消，则不会调用事件处理程序。可以通过指定处理程序应处理 `all` 事件来更改此行为。 示例： @@ -501,7 +500,7 @@ new %javatype%[%integer%] null ``` -在 **Java** 中表示 `null` 。这与 **Skript** 的``不同 . +在 **Java** 中表示 `null`。这与 **Skript** 的 `` 不同。 ##### Bits @@ -549,7 +548,7 @@ effect put %objects% in %objects%: 返回对象的字段、方法或构造函数的列表，包括其修饰符和参数。 -如果需要不带修饰符或参数详细信息的字段或方法名称列表，请参阅[成员名称](https://tpgamesnl.gitbook.io/skript-reflect/basics/utilities#member-names)。 +如果需要不带修饰符或参数详细信息的字段或方法名称列表，请参阅 [成员名称](https://tpgamesnl.gitbook.io/skript-reflect/basics/utilities#member-names)。 ##### 成员的名字 @@ -575,7 +574,7 @@ effect put %objects% in %objects%: %javatype%.class ``` -从给定的 **Java** 类型返回对类的引用。返回`java.lang.Class`类型的对象。此表达式还支持不需要导入的基元类型。 +从给定的 **Java** 类型返回对类的引用。返回 `java.lang.Class` 类型的对象。此表达式还支持不需要导入的基元类型。 ##### 插件实例 @@ -585,4 +584,4 @@ effect put %objects% in %objects%: 返回给定插件的实例 (字符串形式的名称或插件类)。 -更高级的用法及详细内容请自行查阅[skript-reflect 文档](https://tpgamesnl.gitbook.io/skript-reflect) +更高级的用法及详细内容请自行查阅 [skript-reflect 文档](https://tpgamesnl.gitbook.io/skript-reflect) diff --git a/docs-java/process/maintenance/lang/skript/BasicTutorials.md b/docs-java/process/maintenance/lang/skript/basic-tutorials.md similarity index 93% rename from docs-java/process/maintenance/lang/skript/BasicTutorials.md rename to docs-java/process/maintenance/lang/skript/basic-tutorials.md index b1e66c749..64fa76848 100644 --- a/docs-java/process/maintenance/lang/skript/BasicTutorials.md +++ b/docs-java/process/maintenance/lang/skript/basic-tutorials.md @@ -54,7 +54,7 @@ on join: 效果可以是修改游戏模式、发送消息、移动玩家等任何能够改变游戏世界的动作。 -在 SK 中效果是脚本中实际执行的操作或指令，用于**改变游戏结果或执行动作** +在 SK 中效果是脚本中实际执行的操作或指令，用于 **改变游戏结果或执行动作** 举例： @@ -75,7 +75,7 @@ on player jump: 表达式是计算值或引用数据的语句。它们可以返回各种类型的结果。如数字、字符串、列表等。 -在 SK 中一般配合条件判断，用于**在脚本中传递和处理数据**。 +在 SK 中一般配合条件判断，用于 **在脚本中传递和处理数据**。 举例： @@ -110,7 +110,7 @@ on bed enter: 功能是封装了特定逻辑的代码块，可以在脚本中多次调用，常用的功能是计算、向量等类型的。 -在 SK 中，作用主要是**快捷计算、指定类型 (如世界、颜色、玩家类型) 等** +在 SK 中，作用主要是 **快捷计算、指定类型 (如世界、颜色、玩家类型) 等** 举例： @@ -175,13 +175,13 @@ Skript 仍然是编程语言，所有的编程语言都必须在拥有理论基 ### 缩进 -在 Skript 中 如果一行代码以 ":" 结尾 那么下一行需要进行缩进操作，如果没有就不需要进行缩进。 +在 Skript 中 如果一行代码以 `:` 结尾 那么下一行需要进行缩进操作，如果没有就不需要进行缩进。 缩进的方式可以选择两个/四个空格或者一个 Tab (Tab 虽然不是很规范但是真的很爽)。 ### 文本编辑器 -推荐使用 Vscode 安装 Skript 拓展。或者使用 [Skeditor](https://forums.skunity.com/resources/skeditor.1517/)高亮语法。 +推荐使用 VS Code 安装 Skript 拓展。或者使用 [Skeditor](https://forums.skunity.com/resources/skeditor.1517/) 高亮语法。 ### Helloworld @@ -202,11 +202,11 @@ on join: 想必你一定有一些想法，市面上可能找不到，而且因为你不会使用 Java 写插件所以难以实现。 -前往 [skhub](https://skripthub.net/docs/) 或 [skunity](https://docs.skunity.com/syntax)查询 Skript 语法，现在开始构思你的插件吧。 +前往 [Skript Hub](https://skripthub.net/docs/) 或 [skUnity Docs](https://docs.skunity.com/syntax) 查询 Skript 语法，现在开始构思你的插件吧。 ### 如何使用语法 -首先，最重要的是 Event(事件)，这是所有逻辑的先决要素，我们在[skhub](https://skripthub.net/docs/) 或 [skunity](https://docs.skunity.com/syntax) 上， +首先，最重要的是 Event (事件)，这是所有逻辑的先决要素，我们在 [Skript Hub](https://skripthub.net/docs/) 或 [skUnity Docs](https://docs.skunity.com/syntax) 上， 在侧边栏中选中 (Skript 和 Events)，即可筛选 Skript 原生事件。此处以指令监听器为例： @@ -234,7 +234,7 @@ on join: ##### `%type%` -表示这部分只能是固定的某种 type，如 `%itemtype%`，这部分可以勾选 [skhub](https://skripthub.net/docs/) 侧边栏 `Type` 获取。 +表示这部分只能是固定的某种 type，如 `%itemtype%`，这部分可以勾选 [Skript Hub](https://skripthub.net/docs/) 侧边栏 `Type` 获取。 #### 属性 @@ -267,7 +267,7 @@ on command "/op": ### 最初的脚本 -在这个板块中，请利用 [skhub](https://skripthub.net/docs/) 或 [skunity](https://docs.skunity.com/syntax)查询 Skript 语法，满足缩进等要求，尝试写一些最基础脚本吧~ +在这个板块中，请利用 [Skript Hub](https://skripthub.net/docs/) 或 [skUnity Docs](https://docs.skunity.com/syntax) 查询 Skript 语法，满足缩进等要求，尝试写一些最基础脚本吧~ #### 事件 @@ -287,7 +287,7 @@ on command "/op": ##### 事件优先级 -要注意，事件的监听是有优先级的，其中有六个优先级，其中执行顺序为**从上到下**分别为： +要注意，事件的监听是有优先级的，其中有六个优先级，其中执行顺序为 **从上到下** 分别为： | 优先级 | Priority | | ----------- | -------- | @@ -327,7 +327,7 @@ on teleport with priority lowest: 例如，我们想写一个脚本，检测玩家在 00:00 - 06:00 没有在床上睡觉，那么就每秒扣玩家 1 生命值。 -查询 [skhub](https://skripthub.net/docs/) 或 [skunity](https://docs.skunity.com/syntax) ，根据直觉选择，与时间和睡觉有关系的事件可能有这些： +查询 [Skript Hub](https://skripthub.net/docs/) 或 [skUnity Docs](https://docs.skunity.com/syntax)，根据直觉选择，与时间和睡觉有关系的事件可能有这些： ```skript every 10 seconds: @@ -409,7 +409,7 @@ at 00:00 in world "world":
参考写法，不唯一 -不刷新怪物的事件建议去掉，直接设置**难度为和平**。 +不刷新怪物的事件建议去掉，直接设置 **难度为和平**。 ```skript # 不推荐，即使这是有用的！ @@ -477,11 +477,11 @@ TODO
参考写法，不唯一 -:::tip +::::tip 1. `command /xxx` 后一定要使用 `trigger:` 否则指令将不会注册并报错。 2. `/xxx` 为 "指令"，第 n 个空格后的参数即为 `arg-n`，如此处的 `` 为 `arg-1` -3. 参数类型可以查 [skhub](https://skripthub.net/docs/) 选择 `type` 为参数类型，万能参数可用 `string` / `text`。 +3. 参数类型可以查 [Skript Hub](https://skripthub.net/docs/) 选择 `type` 为参数类型，万能参数可用 `string` / `text`。 4. 参数以 `<>` 引用起来时说明该参数为必要参数，如果输入时没有这个参数时会提示格式错误，如果这个参数是可以省略的，那么可以使用类似 `[]` 的方法。 在这里，我们分析一下指令，应该是 `/world xxx` 中的 `xxx` 代表世界，所以我们选择 `/world ` 作为指令。 @@ -513,6 +513,8 @@ if arg-1 is world "world": ::: +:::: + 所以，我们选择使用局部变量暂存玩家的坐标，并基于玩家所在世界及目标世界计算变量， 最后根据计算出的量直接使用 `teleport player to [location]` 传送即可。 @@ -581,13 +583,13 @@ command /world : :::warning -后文为 TUCAOEVER 在 mcbbs 的教程未参考部分，没有进行任何格式化，TODO +后文为 TUCAOEVER 在 MCBBS 的教程未参考部分，没有进行任何格式化，TODO -# ::: +::: --- -### Conditions(条件) +### Conditions (条件) 条件用于判断句：有没有，是不是。它的基本格式为 "if" + 条件。 @@ -637,7 +639,7 @@ on command "/op": --- -### Effects(效果) +### Effects (效果) 与其说它是效果，不如称作行动。 @@ -727,7 +729,7 @@ send subtitle %text% [to %players%] [for %time span%] [with fade[(-| )]in %time --- -### Expressions(表达) & Types(类型) +### Expressions (表达) & Types (类型) 有一天你心血来潮，想要调整玩家的最大血量。 @@ -735,12 +737,12 @@ send subtitle %text% [to %players%] [for %time span%] [with fade[(-| )]in %time 但是实际上是这样么？ -实际上并不是，所谓的 Effect(效果) 虽然都是 `动词 + 名词` 形式，但是对于 Effect(效果) 而言。 +实际上并不是，所谓的 Effect (效果) 虽然都是 `动词 + 名词` 形式，但是对于 Effect (效果) 而言。 注重的是 `动词` 而非后面跟着的 `名词` 例如 `在玩家所在位置生成僵尸`。 -Effect(效果) 所能提供的 只有 "生成" -通过查阅[官方文档](https://docs.skriptlang.org/docs.html?search=#EffSecSpawn)，我们知道生成的用法基本为： +Effect (效果) 所能提供的 只有 "生成" +通过查阅 [官方文档](https://docs.skriptlang.org/docs.html?search=#EffSecSpawn)，我们知道生成的用法基本为： ```skript (spawn|summon) %entity types% [%directions% %locations%] @@ -749,7 +751,7 @@ Effect(效果) 所能提供的 只有 "生成" 但是除去这个词语，我们还剩 "在玩家所在位置" 和 "僵尸"。 -这两个词我们又该怎么处理呢？这时候我们就需要用到 Expressions(表达)。 +这两个词我们又该怎么处理呢？这时候我们就需要用到 Expressions (表达)。 位置的英文单词是 "Location" 我们在官方 Doc 查到了多种有关 "Location" 的表达 @@ -761,19 +763,19 @@ Effect(效果) 所能提供的 只有 "生成" 但是这只解决了我们 "所在位置" 的问题 并没有解决 "玩家" 和 "僵尸" 的问题。 -我们可以看到 "所在位置"，Expressions(表达) 是没有主语的。 +我们可以看到 "所在位置"，Expressions (表达) 是没有主语的。 -Skript 不同于其他语言，正如我在开头所展示的，相比较 Java 而言 Skript 更**注重的是语言而非编程**。 +Skript 不同于其他语言，正如我在开头所展示的，相比较 Java 而言 Skript 更 **注重的是语言而非编程**。 我们需要把这些零碎的东西组成句子，必不可少的是主语，次要的是宾语。 -这时候我们就需要引入 Types(类型)，但凡你发现你的表达里缺少主语/宾语 (对象)，来这里准没错： +这时候我们就需要引入 Types (类型)，但凡你发现你的表达里缺少主语/宾语 (对象)，来这里准没错： https://docs.skriptlang.org/classes.html 通过翻译我们可以轻松知道玩家的英文以及僵尸的英文，分别为 "player"和"zombie"。 -与之相对应的，我们分别在 Types(类别) 中找到： +与之相对应的，我们分别在 Types (类别) 中找到： - https://docs.skriptlang.org/docs.html?search=#player - https://docs.skriptlang.org/docs.html?search=#entity @@ -862,7 +864,7 @@ Loop 即 循环结构，是 Skript 里非常常用的结构语句，主要用于 (To Be Added.) -### Loop + Types(类型) 结构 +### Loop + Types (类型) 结构 (To Be Added.) @@ -978,12 +980,12 @@ command /<指令名称> <参数>: 指令名称前的斜杠字符 (/) 是可选的 (但这并不意味着你可以在执行指令时不带斜杠)。 - 参数 (可选) 可以通过将参数放在 "[]" 中来使其成为可选参数。 - - 类型参数 + - 类型参数 可以通过使用规定的格式来限制参数的类型，例如：``。 - - 类型为 "text/string" 的参数可以接受任何字符，但 "object" 类型不能用作于参数 (编者注：原因大抵是无法输入 `object`)。 - - 类型可以是多个 (例如 number -> numbers entity -> entities)。通过这样的方法，可以使参数接受多个值。 - - "= default value" 这一部分是可选的，如果指令执行者未输入参数，系统将自动使用默认值。 - - 同样你也可以使用这样的方式设置参数默认值，例如：``。 + - 类型为 "text/string" 的参数可以接受任何字符，但 "object" 类型不能用作于参数 (编者注：原因大抵是无法输入 `object`)。 + - 类型可以是多个 (例如 number -> numbers entity -> entities)。通过这样的方法，可以使参数接受多个值。 + - "= default value" 这一部分是可选的，如果指令执行者未输入参数，系统将自动使用默认值。 + - 同样你也可以使用这样的方式设置参数默认值，例如：``。 以下是一份指令示例： @@ -1083,7 +1085,7 @@ file "plugins/SUPERGUILDS/playerdata/%uuid of player%.yml" does not exists: SG_writeFile("Datas.Username"， "**EVER"， "playerdata/%uuid of player%") ``` -**使用**方法的时候请勿画蛇添足在前面另加 "function"。 +**使用** 方法的时候请勿画蛇添足在前面另加 "function"。 通过这样的方法我们大大减少了代码量，提高了开发效率。你以为 Function 就结束了？ diff --git a/docs-java/process/maintenance/lang/skript/skript.md b/docs-java/process/maintenance/lang/skript/skript.md index ee422d664..25915a508 100644 --- a/docs-java/process/maintenance/lang/skript/skript.md +++ b/docs-java/process/maintenance/lang/skript/skript.md @@ -12,7 +12,7 @@ sidebar_position: 1 引用的内容主要来源于 -TUCAOEVER 在 mcbbs 的教程 +TUCAOEVER 在 MCBBS 的教程 法棍 在 CSKB 发布的 [sk 教程](https://kb.corona.studio/zhCN/skript/startup.html) @@ -82,8 +82,8 @@ on join: ## 基础教程 -见[“基础教程”](BasicTutorials.md)。 +见[“基础教程”](basic-tutorials.md)。 ## 进阶教程 -见[“高级教程”](AdvancedTutorials.md)。 +见[“高级教程”](advanced-tutorials.md)。 diff --git "a/docs-java/process/maintenance/optimize/_images/TPS\344\270\215\347\250\263\345\256\232\346\234\211\344\274\230\345\214\226\346\217\222\344\273\266\346\216\250\350\215\220\345\220\227.png" "b/docs-java/process/maintenance/optimize/_images/TPS\344\270\215\347\250\263\345\256\232\346\234\211\344\274\230\345\214\226\346\217\222\344\273\266\346\216\250\350\215\220\345\220\227.png" deleted file mode 100644 index 57ea58b50..000000000 Binary files "a/docs-java/process/maintenance/optimize/_images/TPS\344\270\215\347\250\263\345\256\232\346\234\211\344\274\230\345\214\226\346\217\222\344\273\266\346\216\250\350\215\220\345\220\227.png" and /dev/null differ diff --git a/docs-java/process/maintenance/optimize/_images/g1gc.png b/docs-java/process/maintenance/optimize/_images/g1gc.png deleted file mode 100644 index eb9824a7e..000000000 Binary files a/docs-java/process/maintenance/optimize/_images/g1gc.png and /dev/null differ diff --git a/docs-java/process/maintenance/optimize/_images/zgc.png b/docs-java/process/maintenance/optimize/_images/zgc.png deleted file mode 100644 index 6ec374c0c..000000000 Binary files a/docs-java/process/maintenance/optimize/_images/zgc.png and /dev/null differ diff --git a/docs-java/process/maintenance/optimize/ask-for-help.md b/docs-java/process/maintenance/optimize/ask-for-help.md index 5294be9d1..6c4b1e5d7 100644 --- a/docs-java/process/maintenance/optimize/ask-for-help.md +++ b/docs-java/process/maintenance/optimize/ask-for-help.md @@ -19,7 +19,7 @@ sidebar_position: 7 ![](_images/怎么让大佬帮我/spark_start.png) -在你服务器卡顿的时候开启， **一段时间后** 结束它 +在你服务器卡顿的时候开启，**一段时间后** 结束它 3. 结束 Spark 记录 diff --git a/docs-java/process/maintenance/optimize/go.mdx b/docs-java/process/maintenance/optimize/go.mdx index 0ea603d70..8d4088d41 100644 --- a/docs-java/process/maintenance/optimize/go.mdx +++ b/docs-java/process/maintenance/optimize/go.mdx @@ -23,22 +23,22 @@ import TabItem from '@theme/TabItem'; ## 更简单的 自动优化脚本，[下载](https://script.8aka.org/auto-optimize) -，在服务器根目录执行，目前支持 CraftBukkit，Spigot，Paper，Pufferfish，Purpur，Gale，Leaf +，在服务器根目录执行，目前支持 CraftBukkit、Spigot、Paper、Pufferfish、Purpur、Gale、Leaf :::tip 以下教程的优化项并不全面 (比如没有 Leaf 配置项)，如果你希望了解所有的优化配置项 -你可以看看**笨蛋脚本的源代码**或**服务器核心的文档** +你可以看看 **笨蛋脚本的源代码** 或 **服务器核心的文档** Leaf 和 Gale 的优化配置项请前往：[Leaf 官方文档](https://www.leafmc.one/zh/docs)，CatServer -可以看[这个帖子](https://bbs.mcmod.cn/thread-10697-1-1.html) +可以看 [这个帖子](https://bbs.mcmod.cn/thread-10697-1-1.html) ::: ## 网络优化 -网络优化主要目的是解决服务器上行带宽占用导致的玩家 **Ping**(即网络延迟) 过高导致的糟糕游戏体验。 +网络优化主要目的是解决服务器上行带宽占用导致的玩家 **Ping** (即网络延迟) 过高导致的糟糕游戏体验。 ### 降低服务器视野距离 @@ -522,7 +522,7 @@ mob-spawn-range: 8 因为我们降低了总生物的刷新频率和数量，生物的总密度会明显下降，考虑到过远处的怪物对于游戏性影响非常小。 -我们可以缩小生物刷新范围 (以区块为单位，且不会大于[模拟距离](#手动调整)) 从而获得和原版接近的密度。 +我们可以缩小生物刷新范围 (以区块为单位，且不会大于 [模拟距离](#手动调整)) 从而获得和原版接近的密度。 推荐值： @@ -536,7 +536,7 @@ mob-spawn-range: 8 :::tip -如果你只调`mob-spawn-range`，不更改 `spawn-limit`，会导致玩家周围刷很多怪，影响游玩 +如果你只调 `mob-spawn-range`，不更改 `spawn-limit`，会导致玩家周围刷很多怪，影响游玩 ::: @@ -635,7 +635,7 @@ water_creature: ::: -覆盖 [spigot.yml] 中的同名项。它让你决定一个实体可以同时处理多少次碰撞。`0`将导致无法推动其他实体，包括玩家。`2`应该可以处理大部分情况。 +覆盖 `spigot.yml` 中的同名项。它让你决定一个实体可以同时处理多少次碰撞。`0`将导致无法推动其他实体，包括玩家。`2`应该可以处理大部分情况。 值得注意的是，这将会破坏 maxEntityCramming gamerule 也就是生物堆叠窒息。 #### fix-climbing-bypassing-cramming-rule @@ -745,7 +745,7 @@ nerf-spawner-mobs: false ::: -这一项打开时候会大幅影响刷怪塔及游戏体验，因此 paper 为此做了[更加人性化的选项](#spawner-nerfed-mobs-should-jump)。 +这一项打开时候会大幅影响刷怪塔及游戏体验，因此 Paper 为此做了 [更加人性化的选项](#spawner-nerfed-mobs-should-jump)。 ##### spawner-nerfed-mobs-should-jump @@ -801,7 +801,7 @@ tick-inactive-villagers: true 由于村民被僵尸跟踪时会触发非常复杂的寻路、铁傀儡召唤等行为。 -大量村民被僵尸恐吓时会造成卡顿，当 TPS 低于`purpur.yml` 中设置的 `lagging-threshold` 值时，启用此项会阻止僵尸追赶村民。 +大量村民被僵尸恐吓时会造成卡顿，当 TPS 低于 `purpur.yml` 中设置的 `lagging-threshold` 值时，启用此项会阻止僵尸追赶村民。 :::tip @@ -860,7 +860,7 @@ sensor: > 当 [Pufferfish's DAB](#dab) 启用时，不建议修改该项任何默认值。 -`acquirepoi`是村民最频繁的行为，因此它的间隔已经大大增加了。如果村民有寻路问题，请减少此项。 +`acquirepoi` 是村民最频繁的行为，因此它的间隔已经大大增加了。如果村民有寻路问题，请减少此项。 #### 寻路 @@ -876,7 +876,7 @@ sensor: 禁用此项将减少寻路次数，从而提高性能。在某些情况下，这会导致生物看起来更加迟钝； -它们只会每 5 个 tick(0.25 秒) 被动更新一次路径。 +它们只会每 5 个 tick (0.25 秒) 被动更新一次路径。 ### 掉落物及经验 @@ -988,7 +988,7 @@ exp: 4.0 ::: -创造模式玩家射出的箭消失的时间 (以 tick 为单位)。因为玩家无法捡起这些箭，所以你不妨将其设置为`20`(1 秒) 之类的值。 +创造模式玩家射出的箭消失的时间 (以 tick 为单位)。因为玩家无法捡起这些箭，所以你不妨将其设置为`20` (1 秒) 之类的值。 ### 盔甲架 @@ -1072,7 +1072,7 @@ ticks-per: `hopper-check` 控制了漏斗一次运输多少物品。 -在漏斗特别多的服务器中，合理搭配`hopper-transfer` 和 `hopper-check` 可以降低漏斗占用。( +在漏斗特别多的服务器中，合理搭配 `hopper-transfer` 和 `hopper-check` 可以降低漏斗占用。( 但可能略微影响一些机器的行为，如分类机) 另外，使用更高的 `hopper-check` 能够增加漏斗在单位时间的物品传输效率， @@ -1094,7 +1094,7 @@ ticks-per: 在 `paper-world-default.yml` 中控制是否启用爆炸优化。 -将此项设为`true`可以将原版爆炸算法替换成优化版本，略微牺牲非常小的爆炸伤害换取爆炸时的大量性能提升。 +将此项设为 `true` 可以将原版爆炸算法替换成优化版本，略微牺牲非常小的爆炸伤害换取爆炸时的大量性能提升。 :::tip diff --git a/docs-java/process/maintenance/optimize/jvm/common.md b/docs-java/process/maintenance/optimize/jvm/common.md index b9b030972..c481c9229 100644 --- a/docs-java/process/maintenance/optimize/jvm/common.md +++ b/docs-java/process/maintenance/optimize/jvm/common.md @@ -8,23 +8,23 @@ slug: /optimize/jvm/common ## 大页支持 -注意在 WINDOWS 上使用大页，必须要以管理员启动 +注意在 Windows 上使用大页，必须要以管理员启动 当然，在动手前，让我们先试一试是不是系统已经支持了这项功能，在控制台执行此命令 -```shell +```bash java -Xlog:gc+init -XX:+UseLargePages -Xmx1g -version ``` 如果出现了以下字样，那么说明不完全兼容： -```shell +```text UseLargePages disabled, no large pages configured and available on the system. ``` 那么就说明当前系统并不支持大页，不过不要急，可以试一下这一行命令： -```shell +```bash java -Xlog:gc+init -XX:+UseTransparentHugePages -Xmx1g -version ``` @@ -34,13 +34,13 @@ java -Xlog:gc+init -XX:+UseTransparentHugePages -Xmx1g -version 如果支持 LargePages，加上此参数 -```shell +```text -XX:+UseLargePages -XX:LargePageSizeInBytes=2m ``` 如果支持 TransparentHugePages，加上此参数 -```shell +```text -XX:+UseTransparentHugePages ``` @@ -54,7 +54,7 @@ java -Xlog:gc+init -XX:+UseTransparentHugePages -Xmx1g -version 如果你使用的是 Pufferfish 的分支 (Purpur，Leaf，Leaves，Gale)，你可以添加此参数 -```shell +```text --add-modules=jdk.incubator.vector ``` @@ -64,20 +64,20 @@ java -Xlog:gc+init -XX:+UseTransparentHugePages -Xmx1g -version 如果你使用的是 Leaf，你可以添加参数使用国内下载源： -```shell +```text -DLeaf.library-download-repo=https://maven.aliyun.com/repository/public ``` -如果你使用的是 Paper 1.21.6(及其分支) 之后的版本 ，可以使用以下系统属性配置 Maven 中心仓库镜像： +如果你使用的是 Paper 1.21.6 (及其分支) 之后的版本，可以使用以下系统属性配置 Maven 中心仓库镜像： -```shell +```text -Dorg.bukkit.plugin.java.LibraryLoader.centralURL=https://maven.aliyun.com/repository/central ``` 或者设置环境变量（优先级更高）： -```shell -# Linux/MacOS +```bash +# Linux/macOS export PAPER_DEFAULT_CENTRAL_REPOSITORY=https://maven.aliyun.com/repository/central # Windows (PowerShell) @@ -96,7 +96,7 @@ set PAPER_DEFAULT_CENTRAL_REPOSITORY=https://maven.aliyun.com/repository/central - **华为云 Maven 中心仓库**: `https://repo.huaweicloud.com/repository/maven/` - **腾讯云 Maven 中心仓库**: `https://mirrors.cloud.tencent.com/nexus/repository/maven-public/` -:::tip 性能提示 +:::tip[性能提示] 使用国内镜像源可以显著提升插件依赖库的下载速度，特别是在服务器首次启动或安装新插件时。 @@ -106,13 +106,13 @@ set PAPER_DEFAULT_CENTRAL_REPOSITORY=https://maven.aliyun.com/repository/central 防止乱码 -```shell +```text -Dfile.encoding=UTF-8 ``` -如果仍然乱码,可以添加运行: +如果仍然乱码，可以添加运行： -```shell +```bash chcp 65001 # for Windows ``` @@ -120,16 +120,16 @@ chcp 65001 # for Windows (仅适合 Leaf 或者 Gale) -```shell +```text -Dgale.log.warning.root=false -Dgale.log.warning.offline.mode=false ``` ## 更快的安全随机数生成器 -(仅适合 Linux 和 MacOS 系统，在 Windows 上无效) +(仅适合 Linux 和 macOS 系统，在 Windows 上无效) (原版 Minecraft 仅在个人信息公钥签名中使用到 SecureRandom) -```shell +```text -Djava.security.egd=file:/dev/urandom ``` @@ -137,7 +137,7 @@ chcp 65001 # for Windows (仅适合 Java17 及以上) -```shell +```text -Xlog:async ``` @@ -149,17 +149,17 @@ chcp 65001 # for Windows (仅适合 Paper 和 Paper Fork) -```shell +```text -Dpaper.playerconnection.keepalive=60 ``` -如果你的网络不好，可以适当延长 keepalive 时间，打开[alternate-keepalive](/docs-java/process/maintenance/optimize/go.mdx#心跳连接) +如果你的网络不好，可以适当延长 keepalive 时间，打开[alternate-keepalive](../go.mdx#心跳连接) ## 禁用文件夹遍历和符号链接验证 (仅适合 Paper 和 Paper Fork) -```shell +```text -Dpaper.disableWorldSymlinkValidation=true ``` diff --git a/docs-java/process/maintenance/optimize/jvm/dragonwell11.md b/docs-java/process/maintenance/optimize/jvm/dragonwell11.md index 122d7760d..f13e40e0c 100644 --- a/docs-java/process/maintenance/optimize/jvm/dragonwell11.md +++ b/docs-java/process/maintenance/optimize/jvm/dragonwell11.md @@ -24,7 +24,7 @@ slug: /optimize/jvm/dragonwell Dragonwell 11 的 ZGC 不同于 OpenJDK11 的 ZGC，Dragonwell 通过移植 OpenJDK 15+ 的 ZGC 补丁，使得 Dragonwell 的 ZGC 可以投入生产环境 -添加参数 `-XX:+UseZGC -XX:AllocatePrefetchStyle=1`以启用 +添加参数 `-XX:+UseZGC -XX:AllocatePrefetchStyle=1` 以启用 ## G1GC @@ -32,7 +32,7 @@ Dragonwell 11 的 ZGC 不同于 OpenJDK11 的 ZGC，Dragonwell 通过移植 Open -```shell +```text -XX:+UseG1GC -XX:MaxGCPauseMillis=130 -XX:+UnlockExperimentalVMOptions -XX:+ExplicitGCInvokesConcurrent -XX:+AlwaysPreTouch -XX:G1NewSizePercent=28 -XX:G1HeapRegionSize=16M -XX:G1ReservePercent=20 -XX:G1MixedGCCountTarget=3 -XX:InitiatingHeapOccupancyPercent=10 -XX:G1MixedGCLiveThresholdPercent=90 -XX:G1RSetUpdatingPauseTimePercent=0 -XX:SurvivorRatio=32 -XX:MaxTenuringThreshold=1 -XX:G1SATBBufferEnqueueingThresholdPercent=30 -XX:G1ConcMarkStepDurationMillis=5 -XX:G1ConcRefinementServiceIntervalMillis=150 -XX:G1ConcRSHotCardLimit=16 -XX:+G1BarrierSimple ``` @@ -42,7 +42,7 @@ Dragonwell 11 的 ZGC 不同于 OpenJDK11 的 ZGC，Dragonwell 通过移植 Open 可以节约 10% 左右的 Java 对象内存占用，并可能提升程序性能。**目前仅支持 G1GC 和 ParallelGC** -添加参数`-XX:+UseCompactObjectHeaders` +添加参数 `-XX:+UseCompactObjectHeaders` ## Wisp @@ -56,4 +56,4 @@ Wisp 在 JVM 上提供了一种用户态的线程实现。开启 Wisp2 后，Jav ::: -添加参数`-XX:+UnlockExperimentalVMOptions -XX:+UseWisp2` +添加参数 `-XX:+UnlockExperimentalVMOptions -XX:+UseWisp2` diff --git a/docs-java/process/maintenance/optimize/jvm/dragonwell8.md b/docs-java/process/maintenance/optimize/jvm/dragonwell8.md index 149eade62..44426980c 100644 --- a/docs-java/process/maintenance/optimize/jvm/dragonwell8.md +++ b/docs-java/process/maintenance/optimize/jvm/dragonwell8.md @@ -46,19 +46,19 @@ JWarmup 的基本原理：根据前一次程序运行的情况，记录下热点 -添加参数`-XX:-ClassUnloading -XX:-CMSClassUnloadingEnabled -XX:-ClassUnloadingWithConcurrentMark -XX:CompilationWarmUpLogfile=jwarmup.log -XX:+CompilationWarmUpRecording -XX:CompilationWarmUpRecordTime=300` +添加参数 `-XX:-ClassUnloading -XX:-CMSClassUnloadingEnabled -XX:-ClassUnloadingWithConcurrentMark -XX:CompilationWarmUpLogfile=jwarmup.log -XX:+CompilationWarmUpRecording -XX:CompilationWarmUpRecordTime=300` #### 使用阶段 (一般是生产环境) -添加参数`-XX:+CompilationWarmUp -XX:-TieredCompilation -XX:CompilationWarmUpLogfile=jwarmup.log -XX:CompilationWarmUpDeoptTime=0` +添加参数 `-XX:+CompilationWarmUp -XX:-TieredCompilation -XX:CompilationWarmUpLogfile=jwarmup.log -XX:CompilationWarmUpDeoptTime=0` ## 对象头压缩 可以节约 10% 左右的 Java 对象内存占用，并可能提升程序性能。 -添加参数`-XX:+UseCompactObjectHeaders` +添加参数 `-XX:+UseCompactObjectHeaders` ## Wisp @@ -72,7 +72,7 @@ Wisp 在 JVM 上提供了一种用户态的线程实现。开启 Wisp2 后，Jav ::: -添加参数`-XX:+UnlockExperimentalVMOptions -XX:+UseWisp2` +添加参数 `-XX:+UnlockExperimentalVMOptions -XX:+UseWisp2` ## G1ElasticHeap diff --git a/docs-java/process/maintenance/optimize/jvm/graal.md b/docs-java/process/maintenance/optimize/jvm/graal.md index 2e81f7919..31d564859 100644 --- a/docs-java/process/maintenance/optimize/jvm/graal.md +++ b/docs-java/process/maintenance/optimize/jvm/graal.md @@ -16,7 +16,7 @@ slug: /optimize/jvm/graalvm :::warning -GraalVM 24 以上应该移除`-Dgraal.OptWriteMotion=true` 参数，同时将`-Dgraal.` 改为 `-Djdk.graal.` +GraalVM 24 以上应该移除 `-Dgraal.OptWriteMotion=true` 参数，同时将 `-Dgraal.` 改为 `-Djdk.graal.` ::: diff --git a/docs-java/process/maintenance/optimize/jvm/jvm.md b/docs-java/process/maintenance/optimize/jvm/jvm.md index af6cea2ea..2f80154f1 100644 --- a/docs-java/process/maintenance/optimize/jvm/jvm.md +++ b/docs-java/process/maintenance/optimize/jvm/jvm.md @@ -8,7 +8,7 @@ slug: /optimize/jvm 这篇文章可以说是整个笨蛋文档中编写历时最久的 ()，为了确保正确性，我们在 Windows 和 Linux 上进行了大量性能测试，结果可以说是十分出人意料 -这场测试的细节和日志，报告，Spark，GCLog 等可以在[Test - Java](https://github.com/lilingfengdev/Test-Java)找到 +这场测试的细节和日志，报告，Spark，GCLog 等可以在 [Test - Java](https://github.com/lilingfengdev/Test-Java) 找到 ## Java 选择 @@ -33,19 +33,19 @@ flowchart TD 好的兼容性 -->|不需要,需要有实力| E[Azul Zing] ``` -:::tip Zulu 的性能 +:::tip[Zulu 的性能] -根据官方对 Zulu 的定位，Zulu 的重点是**安全性和稳定性**，而非性能 +根据官方对 Zulu 的定位，Zulu 的重点是 **安全性和稳定性**，而非性能 -大部分人对`Zulu 性能好`这一错误看法主要是来源于同一公司 Azul 旗下的另一款产品 Zing +大部分人对 `Zulu 性能好` 这一错误看法主要是来源于同一公司 Azul 旗下的另一款产品 Zing 该产品 (Zing) 的主要侧重点是性能，但是，如果你不想折腾，想拥有一个超高稳定性的环境，Zulu 仍然是你的最佳选择 ::: -:::tip 兼容性 +:::tip[兼容性] -根据我们的测试，GraalVM,Dragonwell,Zulu 目前都没有被报告过不兼容 +根据我们的测试，GraalVM、Dragonwell、Zulu 目前都没有被报告过不兼容 Zing 21 在已测试的 Leaf 1.21.1 环境下已未发现对市场主流插件 (如 LuckPerms, Oraxen, ItemsAdder) 的不兼容，目前仅有 HuskHomes 的 MariaDB 驱动异常导致 JVM Crash 的报告，切换回 MySQL 后可持续稳定运行 @@ -65,14 +65,14 @@ import TabItem from '@theme/TabItem'; Dragonwell 分为 Standard Edition 和 Extended Edition，推荐下载 Extended Edition -- [官网](https://dragonwell-jdk.io/) 下载区域选择`China Mainland` +- [官网](https://dragonwell-jdk.io/) 下载区域选择 `China Mainland` - [Dragonwell 8 预览](https://github.com/dragonwell-project/dragonwell8/releases) - [Dragonwell 11 预览](https://github.com/dragonwell-project/dragonwell11/releases) -GraalVM 分为 Community Edition(CE) 和 Enterprise Edition(EE)，除非你服务器大到会被 Oracle 找上门，不然请选择 Enterprise Edition +GraalVM 分为 Community Edition (CE) 和 Enterprise Edition (EE)，除非你服务器大到会被 Oracle 找上门，不然请选择 Enterprise Edition 推荐下载最新版，也就是 Java 24 @@ -104,7 +104,7 @@ Azul Zulu 支持 Java 8 以上，Java 7 和 6 需要成为客户才能下载 -OpenJ9 有认证版和非认证版，主要是因为和 OpenJ9 的关系和操作系统的关系而使用不同的许可证罢了，本质代码是一样的，直接下`IBM Semeru Runtime Open Edition`就行 +OpenJ9 有认证版和非认证版，主要是因为和 OpenJ9 的关系和操作系统的关系而使用不同的许可证罢了，本质代码是一样的，直接下 `IBM Semeru Runtime Open Edition` 就行 - [官网](https://developer.ibm.com/languages/java/semeru-runtimes/downloads/) - [下载镜像](https://d.injdk.cn/download/ibm) diff --git a/docs-java/process/maintenance/optimize/jvm/openj9.md b/docs-java/process/maintenance/optimize/jvm/openj9.md index cd0aec16f..576a742ee 100644 --- a/docs-java/process/maintenance/optimize/jvm/openj9.md +++ b/docs-java/process/maintenance/optimize/jvm/openj9.md @@ -18,7 +18,7 @@ OpenJ9 是完全重新设计的 JVM，拥有独立的垃圾回收系统，与 Ho **重要兼容性说明** -由于 Paper 服务端内置 Spark 性能分析器，而 Spark 与 OpenJ9 不兼容，因此默认情况下**不能在 Paper 服务端上使用 OpenJ9**。 +由于 Paper 服务端内置 Spark 性能分析器，而 Spark 与 OpenJ9 不兼容，因此默认情况下 **不能在 Paper 服务端上使用 OpenJ9**。 ::: diff --git a/docs-java/process/maintenance/optimize/jvm/zing.md b/docs-java/process/maintenance/optimize/jvm/zing.md index a3209fc56..268c8be73 100644 --- a/docs-java/process/maintenance/optimize/jvm/zing.md +++ b/docs-java/process/maintenance/optimize/jvm/zing.md @@ -24,7 +24,7 @@ Azul Zing 的专业性较强，新手请不要使用 ::: -若要启用 ReadyNow，请添加以下命令行选项，其中两者``通常相同： +若要启用 ReadyNow，请添加以下命令行选项，其中两者 `` 通常相同： `-XX:ProfileLogIn=` 指示 Azul Platform Prime 使用现有配置文件日志中的信息。 @@ -32,7 +32,7 @@ Azul Zing 的专业性较强，新手请不要使用 然后，运行应用程序将自动生成或更新配置文件日志。此配置文件日志将在应用程序的后续运行时使用，从而改进预热。 -官方推荐所有重要函数执行**5 万遍** +官方推荐所有重要函数执行 **5 万遍** ### 编译存储（已弃用） @@ -54,15 +54,15 @@ C4 是 Zing 中唯一的垃圾收集器，取代了 OpenJDK 中可用的其他 ## 紧凑字符串 -添加选项`-XX:+CompactStrings`可减少内存占用，提高字符串密集型应用程序的性能，并减少花费在垃圾回收上的时间 +添加选项 `-XX:+CompactStrings` 可减少内存占用，提高字符串密集型应用程序的性能，并减少花费在垃圾回收上的时间 ## 更高级别的 Falcon 优化 -使用选项`-XX:FalconOptimizationLevel=3`可以获得更高级别的优化，但会出现更多兼容性问题 +使用选项 `-XX:FalconOptimizationLevel=3` 可以获得更高级别的优化，但会出现更多兼容性问题 ## 多层级 Falcon 优化 -使用选项`-XX:+UseMultiTiering` 通过添加多个编译层级，可以调整预热速度、编译器 CPU 使用时间和达到最佳性能所需时间之间的权衡。 +使用选项 `-XX:+UseMultiTiering` 通过添加多个编译层级，可以调整预热速度、编译器 CPU 使用时间和达到最佳性能所需时间之间的权衡。 ## Zing System Tool @@ -70,11 +70,11 @@ C4 是 Zing 中唯一的垃圾收集器，取代了 OpenJDK 中可用的其他 [官方安装教程](https://docs.azul.com/prime/zst/installation) -使用`-XX:+UseZST` 开启 +使用 `-XX:+UseZST` 开启 :::info -**关于 ZST 的使用**：根据 Azul 官方说明，如果你的 Linux 内核版本足够新，你可以**不使用 ZST**，直接安装 Zing 即可。ZST 组件是可选的，主要用于较旧的内核版本。 +**关于 ZST 的使用**：根据 Azul 官方说明，如果你的 Linux 内核版本足够新，你可以 **不使用 ZST**，直接安装 Zing 即可。ZST 组件是可选的，主要用于较旧的内核版本。 ::: @@ -88,7 +88,7 @@ C4 是 Zing 中唯一的垃圾收集器，取代了 OpenJDK 中可用的其他 动态减少提交的 Java 堆大小，以避免容器环境中出现的内存溢出（OOM）错误，这通常会导致 OOM 终止和崩溃。 -使用`-XX:+UseDefensiveHeapShrinking` 开启 +使用 `-XX:+UseDefensiveHeapShrinking` 开启 ## 缓解 Intel 缩肛 diff --git a/docs-java/process/maintenance/optimize/kernel.md b/docs-java/process/maintenance/optimize/kernel.md index cd9322afa..4eded72d8 100644 --- a/docs-java/process/maintenance/optimize/kernel.md +++ b/docs-java/process/maintenance/optimize/kernel.md @@ -19,21 +19,21 @@ tuned 调优服务可以通过设置调优配置文件来调整操作系统， -```shell +```bash sudo apt install tuned ``` - + -```shell +```bash sudo yum install tuned ``` -```shell +```bash sudo pacman -S tuned ``` @@ -42,19 +42,19 @@ sudo pacman -S tuned 然后启动： -```shell +```bash systemctl enable tuned --now ``` 然后运行工具并使用以下命令调整内核： -```shell +```bash tuned-adm profile throughput-performance ``` ## 设置大页面 -打开文件 `/etc/sysctl.conf`,在末尾添加以下内容 +打开文件 `/etc/sysctl.conf`，在末尾添加以下内容 ```text vm.nr_hugepages = <需要的页数> @@ -66,7 +66,7 @@ vm.nr_hugepages = <需要的页数> (分配的内存数 (单位：MB)) / 2 + 300 ``` -比如我分配了 12GB 的内存 (也就是 12288 MB),那么设置的值为`12288 / 2+ 300 = 6444`,最后的设置应该长这样 +比如我分配了 12GB 的内存 (也就是 12288 MB)，那么设置的值为 `12288 / 2+ 300 = 6444`，最后的设置应该长这样 ```text vm.nr_hugepages = 6444 @@ -78,19 +78,19 @@ vm.nr_hugepages = 6444 首先需要检查操作系统是否支持大页面： -```shell +```bash cat /sys/kernel/mm/transparent_hugepage/shmem_enabled ``` 如果返回包含以下内容，那么操作系统支持透明大页面 -```shell +```bash always within_size advise never deny force ``` 然后运行以下命令激活透明大页面 -```shell +```bash echo madvise | sudo tee /sys/kernel/mm/transparent_hugepage/enabled echo advise | sudo tee /sys/kernel/mm/transparent_hugepage/shmem_enabled echo defer | sudo tee /sys/kernel/mm/transparent_hugepage/defrag @@ -99,7 +99,7 @@ echo 1 | sudo tee /sys/kernel/mm/transparent_hugepage/khugepaged/defrag 最后，我们需要配置开机自启动 -```shell +```bash sudo apt install sysfsutils sudo tee /etc/sysfs.d/enableTHP.conf < /etc/sysctl.conf -# ------ 网络调优: 基本 ------ -# TTL 配置, Linux 默认 64 +# ------ 网络调优：基本 ------ +# TTL 配置，Linux 默认 64 # net.ipv4.ip_default_ttl=64 -# 参阅 RFC 1323. 应当启用. +# 参阅 RFC 1323. 应当启用。 net.ipv4.tcp_timestamps=1 -# ------ END 网络调优: 基本 ------ +# ------ END 网络调优：基本 ------ -# ------ 网络调优: 内核 Backlog 队列和缓存相关 ------ +# ------ 网络调优：内核 Backlog 队列和缓存相关 ------ # Ref: https://www.starduster.me/2020/03/02/linux-network-tuning-kernel-parameter/ # Ref: https://blog.cloudflare.com/optimizing-tcp-for-high-throughput-and-low-latency/ # Ref: https://zhuanlan.zhihu.com/p/149372947 -# 以下四项实际上和 net.ipv4.tcp_rmem, net.ipv4.tcp_wmem 重复, 设定一个即可 +# 以下四项实际上和 net.ipv4.tcp_rmem, net.ipv4.tcp_wmem 重复，设定一个即可 # https://github.com/torvalds/linux/blob/87d6aab2389e5ce0197d8257d5f8ee965a67c4cd/net/ipv4/tcp_output.c#L241-L248 # net.core.wmem_default=1310720 # net.core.rmem_default=1310720 @@ -213,7 +215,7 @@ net.ipv4.tcp_timestamps=1 # net.core.wmem_max=536870912 # 由左往右为 最小值 默认值 最大值 # 有条件建议依据实测结果调整 tcp_rmem, tcp_wmem 相关数值 -# 个人实测差别不大, 可能是我网本来就比较好 +# 个人实测差别不大，可能是我网本来就比较好 # 缓冲区相关配置均和内存相关 net.ipv4.tcp_rmem=8192 262144 536870912 net.ipv4.tcp_wmem=4096 16384 536870912 @@ -227,23 +229,23 @@ net.ipv4.tcp_abort_on_overflow=1 # 所有网卡每次软中断最多处理的总帧数量 net.core.netdev_budget = 600 # 流控和拥塞控制相关调优 -# Egress traffic control 相关. 可选 fq, cake -# 实测二者区别不大, 保持默认 fq 即可 +# Egress traffic control 相关。可选 fq, cake +# 实测二者区别不大，保持默认 fq 即可 net.core.default_qdisc=fq # Xanmod 内核 6.X 版本目前默认使用 bbr3, 无需设置 # 实测比 bbr, bbr2 均有提升 -# 不过网络条件不同会影响. 有需求请实测. +# 不过网络条件不同会影响。有需求请实测。 # net.ipv4.tcp_congestion_control=bbr3 # 显式拥塞通知 -# 已被发现在高度拥塞的网络上是有害的. +# 已被发现在高度拥塞的网络上是有害的。 # net.ipv4.tcp_ecn=1 # TCP 自动窗口 # 要支持超过 64KB 的 TCP 窗口必须启用 net.ipv4.tcp_window_scaling=1 -# 开启后, TCP 拥塞窗口会在一个 RTO 时间 -# 空闲之后重置为初始拥塞窗口 (CWND) 大小. -# 大部分情况下, 尤其是大流量长连接, 设置为 0. -# 对于网络情况时刻在相对剧烈变化的场景, 设置为 1. +# 开启后，TCP 拥塞窗口会在一个 RTO 时间 +# 空闲之后重置为初始拥塞窗口 (CWND) 大小。 +# 大部分情况下，尤其是大流量长连接，设置为 0. +# 对于网络情况时刻在相对剧烈变化的场景，设置为 1. net.ipv4.tcp_slow_start_after_idle=1 # nf_conntrack 调优 # Add Ref: https://gist.github.com/lixingcong/0e13b4123d29a465e364e230b2e45f60 @@ -257,16 +259,16 @@ net.ipv4.netfilter.ip_conntrack_tcp_timeout_established=7200 # TIME-WAIT 状态调优 # Ref: http://vincent.bernat.im/en/blog/2014-tcp-time-wait-state-linux.html # Ref: https://www.cnblogs.com/lulu/p/4149312.html -# 4.12 内核中此参数已经永久废弃, 不用纠结是否需要开启 +# 4.12 内核中此参数已经永久废弃，不用纠结是否需要开启 # net.ipv4.tcp_tw_recycle=0 -## 只对客户端生效, 服务器连接上游时也认为是客户端 +## 只对客户端生效，服务器连接上游时也认为是客户端 net.ipv4.tcp_tw_reuse=1 -# 系统同时保持TIME_WAIT套接字的最大数量 +# 系统同时保持 TIME_WAIT 套接字的最大数量 # 如果超过这个数字 TIME_WAIT 套接字将立刻被清除 net.ipv4.tcp_max_tw_buckets=55000 -# ------ END 网络调优: 内核 Backlog 队列和缓存相关 ------ +# ------ END 网络调优：内核 Backlog 队列和缓存相关 ------ -# ------ 网络调优: 其他 ------ +# ------ 网络调优：其他 ------ # Ref: https://zhuanlan.zhihu.com/p/149372947 # Ref: https://www.starduster.me/2020/03/02/linux-network-tuning-kernel-parameter/\#netipv4tcp_max_syn_backlog_netipv4tcp_syncookies # 启用选择应答 @@ -278,13 +280,13 @@ net.ipv4.tcp_fack=1 # TCP SYN 连接超时重传次数 net.ipv4.tcp_syn_retries=3 net.ipv4.tcp_synack_retries=3 -# TCP SYN 连接超时时间, 设置为 5 约为 30s +# TCP SYN 连接超时时间，设置为 5 约为 30s net.ipv4.tcp_retries2=5 # 开启 SYN 洪水攻击保护 -# 注意: tcp_syncookies 启用时, 此时实际上没有逻辑上的队列长度, -# Backlog 设置将被忽略. syncookie 是一个出于对现实的妥协, -# 严重违反 TCP 协议的设计, 会造成 TCP option 不可用, 且实现上 -# 通过计算 hash 避免维护半开连接也是一种 tradeoff 而非万金油, +# 注意：tcp_syncookies 启用时，此时实际上没有逻辑上的队列长度， +# Backlog 设置将被忽略。syncookie 是一个出于对现实的妥协， +# 严重违反 TCP 协议的设计，会造成 TCP option 不可用，且实现上 +# 通过计算 hash 避免维护半开连接也是一种 tradeoff 而非万金油， # 勿听信所谓“安全优化教程”而无脑开启 net.ipv4.tcp_syncookies=0 @@ -299,9 +301,9 @@ net.ipv4.conf.all.rp_filter=2 net.ipv4.tcp_fin_timeout=10 # Ref: https://xwl-note.readthedocs.io/en/latest/linux/tuning.html -# 默认情况下一个 TCP 连接关闭后, 把这个连接曾经有的参数保存到dst_entry中 -# 只要 dst_entry 没有失效, 下次新建立相同连接的时候就可以使用保存的参数来初始化这个连接. -# 通常情况下是关闭的, 高并发配置为 1. +# 默认情况下一个 TCP 连接关闭后，把这个连接曾经有的参数保存到 dst_entry 中 +# 只要 dst_entry 没有失效，下次新建立相同连接的时候就可以使用保存的参数来初始化这个连接。 +# 通常情况下是关闭的，高并发配置为 1. net.ipv4.tcp_no_metrics_save=1 # unix socket 最大队列 net.unix.max_dgram_qlen=1024 @@ -313,7 +315,7 @@ net.ipv4.route.gc_timeout=100 net.ipv4.tcp_mtu_probing = 1 # No Ref -# 开启并记录欺骗, 源路由和重定向包 +# 开启并记录欺骗，源路由和重定向包 net.ipv4.conf.all.log_martians=1 net.ipv4.conf.default.log_martians=1 # 处理无源路由的包 @@ -322,19 +324,19 @@ net.ipv4.conf.default.accept_source_route=0 # TCP KeepAlive 调优 # 最大闲置时间 net.ipv4.tcp_keepalive_time=600 -# 最大失败次数, 超过此值后将通知应用层连接失效 +# 最大失败次数，超过此值后将通知应用层连接失效 net.ipv4.tcp_keepalive_probes=3 # 发送探测包的时间间隔 net.ipv4.tcp_keepalive_intvl=15 -# 放弃回应一个 TCP 连接请求前, 需要进行多少次重试 +# 放弃回应一个 TCP 连接请求前，需要进行多少次重试 net.ipv4.tcp_retries1 = 5 -# 在丢弃激活(已建立通讯状况)的 TCP 连接之前, 需要进行多少次重试 +# 在丢弃激活 (已建立通讯状况) 的 TCP 连接之前，需要进行多少次重试 net.ipv4.tcp_retries2 = 5 # 孤立 Socket net.ipv4.tcp_orphan_retries = 3 -# 系统所能处理不属于任何进程的TCP sockets最大数量 +# 系统所能处理不属于任何进程的 TCP sockets 最大数量 net.ipv4.tcp_max_orphans=3276800 -# arp_table的缓存限制优化 +# arp_table 的缓存限制优化 net.ipv4.neigh.default.gc_thresh1=128 net.ipv4.neigh.default.gc_thresh2=512 net.ipv4.neigh.default.gc_thresh3=4096 @@ -342,30 +344,30 @@ net.ipv4.neigh.default.gc_stale_time=120 net.ipv4.conf.default.arp_announce=2 net.ipv4.conf.lo.arp_announce=2 net.ipv4.conf.all.arp_announce=2 -# ------ END 网络调优: 其他 ------ +# ------ END 网络调优：其他 ------ # ------ 内核调优 ------ # Ref: Aliyun, etc # 内核 Panic 后 1 秒自动重启 kernel.panic=1 -# 允许更多的PIDs, 减少滚动翻转问题 +# 允许更多的 PIDs, 减少滚动翻转问题 kernel.pid_max=32768 # 内核所允许的最大共享内存段的大小（bytes） kernel.shmmax=4294967296 -# 在任何给定时刻, 系统上可以使用的共享内存的总量（pages） +# 在任何给定时刻，系统上可以使用的共享内存的总量（pages） kernel.shmall=1073741824 -# 设定程序core时生成的文件名格式 +# 设定程序 core 时生成的文件名格式 kernel.core_pattern=core_%e -# 当发生oom时, 自动转换为panic +# 当发生 oom 时，自动转换为 panic vm.panic_on_oom=1 -# 表示强制Linux VM最低保留多少空闲内存（Kbytes） +# 表示强制 Linux VM 最低保留多少空闲内存（Kbytes） # vm.min_free_kbytes=1048576 -# 该值高于100, 则将导致内核倾向于回收directory和inode cache +# 该值高于 100, 则将导致内核倾向于回收 directory 和 inode cache vm.vfs_cache_pressure=250 -# 表示系统进行交换行为的程度, 数值（0-100）越高, 越可能发生磁盘交换 +# 表示系统进行交换行为的程度，数值（0-100）越高，越可能发生磁盘交换 vm.swappiness=10 -# 仅用10%做为系统cache +# 仅用 10% 做为系统 cache vm.dirty_ratio=10 vm.overcommit_memory=1 # 增加系统文件描述符限制 @@ -379,28 +381,28 @@ kernel.sysrq=1 # net.ipv4.tcp_low_latency=1 # Ref: https://gist.github.com/lixingcong/0e13b4123d29a465e364e230b2e45f60 -# 当某个节点可用内存不足时, 系统会倾向于从其他节点分配内存. 对 Mongo/Redis 类 cache 服务器友好 +# 当某个节点可用内存不足时，系统会倾向于从其他节点分配内存。对 Mongo/Redis 类 cache 服务器友好 vm.zone_reclaim_mode=0 # Ref: Unknwon -# 开启F-RTO(针对TCP重传超时的增强的恢复算法). -# 在无线环境下特别有益处, 因为在这种环境下分组丢失典型地是因为随机无线电干扰而不是中间路由器阻塞 +# 开启 F-RTO(针对 TCP 重传超时的增强的恢复算法). +# 在无线环境下特别有益处，因为在这种环境下分组丢失典型地是因为随机无线电干扰而不是中间路由器阻塞 net.ipv4.tcp_frto = 2 # TCP FastOpen net.ipv4.tcp_fastopen = 3 # TCP 流中重排序的数据报最大数量 net.ipv4.tcp_reordering = 300 -# 开启后, 在重传时会试图发送满大小的包. 这是对一些有 BUG 的打印机的绕过方式 +# 开启后，在重传时会试图发送满大小的包。这是对一些有 bug 的打印机的绕过方式 net.ipv4.tcp_retrans_collapse = 0 # 自动阻塞判断 net.ipv4.tcp_autocorking = 1 -# TCP内存自动调整 +# TCP 内存自动调整 net.ipv4.tcp_moderate_rcvbuf = 1 -# 单个TSO段可消耗拥塞窗口的比例, 默认值为 3 +# 单个 TSO 段可消耗拥塞窗口的比例，默认值为 3 net.ipv4.tcp_tso_win_divisor = 3 # 对于在 RFC1337 中描述的 TIME-WAIT Assassination Hazards in TCP 问题的修复 net.ipv4.tcp_rfc1337 = 1 -# 包转发. 出于安全考虑, Linux 系统默认禁止数据包转发 +# 包转发。出于安全考虑，Linux 系统默认禁止数据包转发 net.ipv4.ip_forward = 0 # 取消对广播 ICMP 包的回应 net.ipv4.icmp_echo_ignore_broadcasts = 1 diff --git a/docs-java/process/maintenance/optimize/optimize.md b/docs-java/process/maintenance/optimize/optimize.md index cf4f73116..d8990b260 100644 --- a/docs-java/process/maintenance/optimize/optimize.md +++ b/docs-java/process/maintenance/optimize/optimize.md @@ -9,7 +9,7 @@ sidebar_position: 1 每个服务器可能有自己的卡顿原因，在这部分先做最基础的通用优化，如果你使用后作用不大请参考性能分析板块。 -> "过早的优化是万恶之源",过早优化会让服务端不稳定，甚至 10x slower +> "过早的优化是万恶之源"，过早优化会让服务端不稳定，甚至 10x slower 在此之前，请一定查看 [优化误区](optimized-plugin.md)，停止此类无效"优化"，然后根据下面的步骤进行操作。 @@ -19,7 +19,7 @@ sidebar_position: 1 仅仅需要你下载一个小小的 Java 安装程序，或者更改 JVM 参数 (大白话来说就是开服参数)。 -参见 [JVM 优化](/Java/optimize/jvm) +参见 [JVM 优化](./jvm/jvm.md) ## 第二步 - 预生成 @@ -44,7 +44,7 @@ sidebar_position: 1 ::: -完整版请查看[核心选择](/docs-java/start/server-core-choose/server-core-choose.md) +完整版请查看 [核心选择](../../../start/server-core-choose/server-core-choose.md) ## 第四步 - 调整服务端配置 diff --git a/docs-java/process/maintenance/optimize/optimized-plugin.md b/docs-java/process/maintenance/optimize/optimized-plugin.md index 4ef8a9259..be0363dc6 100644 --- a/docs-java/process/maintenance/optimize/optimized-plugin.md +++ b/docs-java/process/maintenance/optimize/optimized-plugin.md @@ -7,7 +7,7 @@ sidebar_position: 6 ## 混合端 -由于混合端本身的问题，混合端能进行的优化很少，并且混合端**不可以装大部分优化 MOD**，但是你仍然可以进行除安装优化 mod 以外的其他优化操作 +由于混合端本身的问题，混合端能进行的优化很少，并且混合端 **不可以装大部分优化 mod**，但是你仍然可以进行除安装优化 mod 以外的其他优化操作 ~~不使用混合端来达到最佳的优化~~ @@ -18,7 +18,7 @@ sidebar_position: 6 我们在这里列出的不建议使用的插件是一个类型的插件，而不是仅仅只是不推荐某个插件。对于推荐的"优化插件" ，其实大多数也是通过限制红石/漏斗/实体数量和 AI 等完成的， -在狭义上任何使用插件操作限制任何东西都不能称之为"_优化_"而是"_限制_"，这里只是以"_优化插件_"代指一些"_限制插件_". +在狭义上任何使用插件操作限制任何东西都不能称之为"*优化*"而是"*限制*"，这里只是以"*优化插件*"代指一些"*限制插件*". 所以说，使用这些"优化插件"，不如更换服务端核心，甚至不如优化启动参数和调优服务端配置文件 @@ -42,16 +42,16 @@ sidebar_position: 6 因此，停止使用类似插件，如： -_[TooManyGen](https://modrinth.com/plugin/toomanygen) - 惩罚玩家跑图，实际上这是非常影响游戏体验的，有更好的选择。_ +*[TooManyGen](https://modrinth.com/plugin/toomanygen) - 惩罚玩家跑图，实际上这是非常影响游戏体验的，有更好的选择。* ### 对于 AI 有影响的插件 使用 Pufferfish DAB 降低远处生物的 AI 比插件利用 API 更加有效和符合游戏逻辑， -因此，停止使用类似插件，如: +因此，停止使用类似插件，如： -_LaggRemover (Fork) - 有时候会导致即使插件卸载，实体 AI 也被移除了，比不上 Pufferfish(使用 Purpur Fork 即可) 根据距离衰减的 -AI._ +*LaggRemover (Fork) - 有时候会导致即使插件卸载，实体 AI 也被移除了，比不上 Pufferfish (使用 Purpur Fork 即可) 根据距离衰减的 +AI.* ### 任何对于内存 GC 进行操作的插件 @@ -59,7 +59,7 @@ AI._ 因此，停止使用类似插件，如： -_Spartan - 一款性能非常差的付费反作弊，如果你买了那么恭喜你你被骗了 (大嘘)，如果近期购买请立即申请退款!_ +*Spartan - 一款性能非常差的付费反作弊，如果你买了那么恭喜你你被骗了 (大嘘)，如果近期购买请立即申请退款!* ### 村民优化插件 @@ -76,12 +76,12 @@ _Spartan - 一款性能非常差的付费反作弊，如果你买了那么恭喜 地面上的物品很少会导致性能问题，而且物品往往会自行消失，如果你的服务器掉落物特别多，请调整以下两个参数： -[点这里查看正确方法 #alt-item-despawn-rate](go.mdx#alt-item-despawn-rate) +[点这里查看正确方法 #alt-item-despawn-rate](go.mdx#alt-item-despawn-rate)， [点这里查看正确方法 #merge-radius](go.mdx#merge-radius) 因此，停止使用类似插件，如： -_[ClearLagg](https://www.spigotmc.org/resources/clearlagg.68271/) - 清理物品插件_ +*[ClearLagg](https://www.spigotmc.org/resources/clearlagg.68271/) - 清理物品插件* ### 生物清理插件 @@ -91,16 +91,16 @@ _[ClearLagg](https://www.spigotmc.org/resources/clearlagg.68271/) - 清理物品 因此，停止使用类似插件，如： -_[Cleaner](https://www.minebbs.com/resources/cleaner-addon.4816/) - 清理生物/物品插件_ +*[Cleaner](https://www.minebbs.com/resources/cleaner-addon.4816/) - 清理生物/物品插件* ### 实体堆叠插件 除非玩家乐意养殖非常非常多生物，否则对生物进行堆叠仍然会使服务器浪费性能在刷新更多的生物上，否则请不要安装堆叠插件。 -因此，停止使用类似插件，如: +因此，停止使用类似插件，如： -_[StackMob](https://www.spigotmc.org/resources/stackmob-enhance-your-servers-performance-without-the-sacrifice.29999/) - -实体密集时进行堆叠的插件 (若一定要使用仍推荐本插件而不是其他堆叠插件)_ +*[StackMob](https://www.spigotmc.org/resources/stackmob-enhance-your-servers-performance-without-the-sacrifice.29999/) - +实体密集时进行堆叠的插件 (若一定要使用仍推荐本插件而不是其他堆叠插件)* 其实叠加后的一小段时间，应该是占用下降的，但是服务器会因为实际的实体变少，重新刷新怪物，这会让占用缓慢恢复。 @@ -111,8 +111,10 @@ _[StackMob](https://www.spigotmc.org/resources/stackmob-enhance-your-servers-per 综上所述，不要安装堆叠插件。 :::tip -补充一点，我可以推荐给你这个，只在服务器 mspt 超过阈值才堆叠动物。如果你本身有 farmcontrol 之类的插件控制总量，那这个插件的使用是安全、无感、且能起到一定的“优化”作用的。
+ +补充一点，我可以推荐给你这个，只在服务器 MSPT 超过阈值才堆叠动物。如果你本身有 FarmControl 之类的插件控制总量，那这个插件的使用是安全、无感、且能起到一定的“优化”作用的。
https://github.com/quiquelhappy/StackMob-5 + ::: ### 爆炸优化插件 @@ -147,7 +149,7 @@ Paper 酱为你在 `/config/paper-world-default.yml` 中准备了爆炸优化。 1. ChunkAnalyser - 简单的搜索世界的红石，漏斗，实体之类，有很多平替插件如 [Insights](https://modrinth.com/plugin/insights)/ [Entitydetection](https://www.spigotmc.org/resources/entitydetection-tile-entity-support.20588/)； -2. LagMonitor，LagMap，Benchmark - 很鸡肋的性能检测 (不如 [Spark](performance-analysis.md#spark) )； +2. LagMonitor，LagMap，Benchmark - 很鸡肋的性能检测 (不如 [Spark](performance-analysis.md#spark))； 3. RedstoneCuller - 直接破坏红石机器，平替插件 [AntiRedstoneClock](https://hangar.papermc.io/OneLiteFeather/AntiRedstoneClock-Remastered)； @@ -157,7 +159,7 @@ Paper 酱为你在 `/config/paper-world-default.yml` 中准备了爆炸优化。 ，体验远好于此插件； 5. ChunkLimiter - - 平替插件 [Farmcontrol](https://www.spigotmc.org/resources/farmcontrol-1-15-1-19.86923/) / [Mob-Farm-Manager](https://www.spigotmc.org/resources/mob-farm-manager-supports-1-7-10-up-to-1-20-hopper-support.15127/) + 平替插件 [FarmControl](https://www.spigotmc.org/resources/farmcontrol-1-15-1-19.86923/) / [Mob-Farm-Manager](https://www.spigotmc.org/resources/mob-farm-manager-supports-1-7-10-up-to-1-20-hopper-support.15127/) ，甚至更多配置项； 6. Dynamic View Distance - @@ -173,7 +175,7 @@ Paper 酱为你在 `/config/paper-world-default.yml` 中准备了爆炸优化。 但是这样的插件往往功能多而不专，如 CMI 经济经常出 bug 且不支持跨服。 -而 ESS 使用 yml 储存大量的玩家数据，经常被发现有刷钱漏洞等高血压操作。 +而 ESS 使用 YAML 储存大量的玩家数据，经常被发现有刷钱漏洞等高血压操作。 这些插件往往因为功能多导致有些代码没有被优化好，无法和专精某一方面的插件媲美。 @@ -187,19 +189,19 @@ Paper 酱为你在 `/config/paper-world-default.yml` 中准备了爆炸优化。 主要是包括一些甚至不到 10kb 的插件，功能仅仅只是右键西瓜能够收获，或是禁止农田踩踏等。 -这些插件功能很可能被一些其他的插件甚至核心自带了 (如 purpur 可设置农田是否可踩踏)。 +这些插件功能很可能被一些其他的插件甚至核心自带了 (如 Purpur 可设置农田是否可踩踏)。 虽然一般来说这些插件不会对性能有影响，但是的确能够降低服务器维护难度等。 ### 拥有相似功能的插件 -顾名思义，同时安装两个基础插件如 CMI 和 ESS，两个权限插件 GroupManager 和 Luckperms，两个经济插件， +顾名思义，同时安装两个基础插件如 CMI 和 ESS，两个权限插件 GroupManager 和 LuckPerms，两个经济插件， 不但可能由于插件矛盾导致性能问题，更有可能直接出现权限失效、保护功能失效等严重问题。 -## 有用的~~优化~~限制插件 +## 有用的 ~~优化~~ 限制插件 -:::warning 红石限制？ +:::warning[红石限制？] 目前，市面上的红石限制插件限制红石的方式都是通过破坏或停用实现的 @@ -228,7 +230,7 @@ Minecraft 1.20.1 开始，这还没有修复。 这个插件通过用一个自定义的、更快、更简单的搜索替换原版埋藏的寻宝来修复这些类型的崩溃：它只是在合理的距离内随机选择一个海滩并将宝藏放在那里。由于这主要是异步的，因此不会导致延迟。 -详细使用和局限性，请看[官方页面](https://hangar.papermc.io/Kyle/OkTreasures) +详细使用和局限性，请看 [官方页面](https://hangar.papermc.io/Kyle/OkTreasures) ### Chunky Border @@ -258,7 +260,7 @@ Minecraft 1.20.1 开始，这还没有修复。 ESU 是一款多合一插件，但优化只需要 NetworkThrottleModule 省流模块即可 -通过压缩区块数据包中玩家不可见的方块信息以有效降低上行带宽的占用。对非作弊玩家的影响为零。经过深度优化，每个区块的处理耗时低于 1ms. 负载低于 GrimAC 与其他假矿插件. +通过压缩区块数据包中玩家不可见的方块信息以有效降低上行带宽的占用。对非作弊玩家的影响为零。经过深度优化，每个区块的处理耗时低于 1 ms. 负载低于 GrimAC 与其他假矿插件。 在百人原版生存服的测试环境中，该功能帮助降低了约 50% 的上行带宽。详情说明请检查模块配置中的注释。 - **该功能与假矿插件相冲突，不可共同安装。插件有较一般的反矿透效果** diff --git a/docs-java/process/maintenance/optimize/performance-analysis.md b/docs-java/process/maintenance/optimize/performance-analysis.md index 404321729..a7332fc1c 100644 --- a/docs-java/process/maintenance/optimize/performance-analysis.md +++ b/docs-java/process/maintenance/optimize/performance-analysis.md @@ -21,9 +21,9 @@ Spark 是一个 Minecraft 的性能分析器，支持广泛 (如 Bukkit，Bungee `GitHub` https://github.com/lucko/spark -`文档(英文)` https://spark.lucko.me/docs +`文档 (英文)` https://spark.lucko.me/docs -`文档(中文)` https://continue-project.netlify.app/spark +`文档 (中文)` https://continue-project.netlify.app/spark ::: @@ -45,23 +45,23 @@ Spark 是一个 Minecraft 的性能分析器，支持广泛 (如 Bukkit，Bungee 如果分析器已经启动，你可以输入下面这些命令： -/spark profiler open 打开分析报告页而无需停止； +`/spark profiler open` 打开分析报告页而无需停止； -/spark profiler stop 停止分析并浏览分析结果； +`/spark profiler stop` 停止分析并浏览分析结果； -/spark profiler cancel 取消分析操作，并取消上传报告。 +`/spark profiler cancel` 取消分析操作，并取消上传报告。 在其他情况下，你可以使用这些基本的操作命令： -/spark profiler start 在默认操作模式下开始分析； +`/spark profiler start` 在默认操作模式下开始分析； -/spark profiler info 检查当前分析的状态。 +`/spark profiler info` 检查当前分析的状态。 这是主要的指令，为了更多的功能，更精准的分析等可以在后面加上参数。具体请查看 [profiler 指令使用方法](https://continue-project.netlify.app/spark/#/spark.command-usage) :::tip -Spark 中内存占用并非平均内存占用，而是**瞬间内存占用**，所以有些时候会出现 Spark 上显示内存占用小实际很大的情况 +Spark 中内存占用并非平均内存占用，而是 **瞬间内存占用**，所以有些时候会出现 Spark 上显示内存占用小实际很大的情况 ::: @@ -83,7 +83,7 @@ Timings 是一个 Spigot 自带的性能分析器，由于其监听每一个事 在可预见的未来 Timings 将会被移除，作为新手可以直接跳过。如果你使用 Paper 服务器，请禁用 Timings！虽然它是一个很好的诊断工具， -但由于其不断不断启动和停止虚拟“秒表”，会对性能产生非常大的影响。因此无论服务器规模大小只需禁用计时即可实现 _10-30%_ 的性能提升。 +但由于其不断不断启动和停止虚拟“秒表”，会对性能产生非常大的影响。因此无论服务器规模大小只需禁用计时即可实现 *10-30%* 的性能提升。 可以通过在 `/config/paper-global.yml` 中 `timings.enabled` 设为 `false` 禁用。 @@ -93,18 +93,18 @@ Timings 是一个 Spigot 自带的性能分析器，由于其监听每一个事 :::warning -这部分需要一些基础知识，一般 Spark 分析不出来才会尝试其他软件。_一般服主不必要学习这部分内容_。 +这部分需要一些基础知识，一般 Spark 分析不出来才会尝试其他软件。*一般服主不必要学习这部分内容*。 ::: -### arthas +### Arthas Arthas 是一款阿里巴巴开发的在线性能分析软件，可实时查看应用 JVM /内存/ GC /线程 的状态信息，甚至包括查看方法调用的出入参、异常，监测方法执行耗时等，一般用于排查某些插件的 CPU 占用情况和插件线程占用分析。 [官方文档链接](https://arthas.aliyun.com/doc/) -### jprofiler +### JProfiler -jprofiler 是一款付费的易用的性能分析软件，甚至可以对 MySQL，内存泄漏进行分析，可视化展示。 +JProfiler 是一款付费的易用的性能分析软件，甚至可以对 MySQL，内存泄漏进行分析，可视化展示。 [官方链接](https://www.ej-technologies.com/products/jprofiler/overview.html) diff --git a/docs-java/process/maintenance/optimize/storage-space-optimization.md b/docs-java/process/maintenance/optimize/storage-space-optimization.md index 25b16d6c8..dadb1c71c 100644 --- a/docs-java/process/maintenance/optimize/storage-space-optimization.md +++ b/docs-java/process/maintenance/optimize/storage-space-optimization.md @@ -9,13 +9,13 @@ sidebar_position: 4 对于 `/plugins` 文件夹储存是否需要进行优化这个问题，有个很简单的判断方法就是查看总占用， -如果超过了 200 MB，那么很有可能有些插件使用了 Sqlite / yml / zip 等方式储存了一些东西， +如果超过了 200 MB，那么很有可能有些插件使用了 SQLite / YAML / zip 等方式储存了一些东西， 在服务器有一定人数的情况下这并不是推荐的储存方式，在某些情况下可能对储存空间会有一定的占用。 ### 使用数据库 -合理使用数据库可以降低服务器硬盘占用。详见[数据库相关](/database) +合理使用数据库可以降低服务器硬盘占用。详见 [通用 | 数据库相关](/database) ## 备份空间优化 @@ -23,15 +23,15 @@ sidebar_position: 4 推荐两个备份插件 (高效的备份，无需停服即可备份)： -[ebackup](https://www.spigotmc.org/resources/ebackup-simple-and-reliable-backups-for-your-server-supports-ftp-sftp.69917/) +[eBackup](https://www.spigotmc.org/resources/ebackup-simple-and-reliable-backups-for-your-server-supports-ftp-sftp.69917/) 可设置黑名单不备份某些文件，FTP 远程备份支持 -[serverbackup](https://www.spigotmc.org/resources/server-backup-ingame-dropbox-ftp-backup-1-8-1-20-multithreaded.79320/) +[Server Backup](https://www.spigotmc.org/resources/server-backup-ingame-dropbox-ftp-backup-1-8-1-20-multithreaded.79320/) 可支持增量备份 (即只备份最近变更过的文件)，占用空间更小 ## 存档存储空间优化 -Minecraft 默认的区块格式是 ANVIL，但是这个区块格式有很多弊端，比如存了一些无用信息，使用了强制对齐等， +Minecraft 默认的区块格式是 Anvil，但是这个区块格式有很多弊端，比如存了一些无用信息，使用了强制对齐等， 且至今还使用着古老的 zlib 压缩格式，所以如果硬盘吃紧时候，可以尝试对其进行调整。 @@ -57,15 +57,15 @@ Leaf/Luminol 等核心最新版已应用修复补丁，虽然性能会受到影 ::: -此格式是由著名的 Xymb 大佬开发，相比于 ANVIL，可以节省巨大的空间 +此格式是由著名的 Xymb 大佬开发，相比于 Anvil，可以节省巨大的空间 主世界可以节省大约 50% 的空间，末地大约为 90% ，且使用现代的 zstd & lz4 压缩，可以获得更快的加载和保存速度。 ##### 转换区域格式 -使用之前你需要将 ANVIL 转换成 Linear 区域格式，如果你使用的是 Leaves，你可以在服务端内部自动转换。 +使用之前你需要将 Anvil 转换成 Linear 区域格式，如果你使用的是 Leaves，你可以在服务端内部自动转换。 -[转换工具](https://github.com/xymb-endcrystalme/LinearRegionFileFormatTools) ，转换非常简单你只需要看着教程做就行 ( +[转换工具](https://github.com/xymb-endcrystalme/LinearRegionFileFormatTools)，转换非常简单你只需要看着教程做就行 ( 记得做备份) ##### 开启区域格式 @@ -76,7 +76,7 @@ Leaf/Luminol 等核心最新版已应用修复补丁，虽然性能会受到影 ##### 不兼容的插件 -目前已知不兼容线性区域的格式的插件极少无比：ServerBackup 一款备份插件，会由于找不到 mca 文件报错。 +目前已知不兼容线性区域的格式的插件极少无比：Server Backup 一款备份插件，会由于找不到 mca 文件报错。 ，大部分在线网页地图浏览程序，以及 Residence 部分不兼容 ( 感谢 z 大神的优雅代码，当传送到一个未加载区块的领地时会崩溃),Regionerator 不兼容 @@ -84,7 +84,7 @@ Leaf/Luminol 等核心最新版已应用修复补丁，虽然性能会受到影 感谢 HaHaWTH 提供的测试结果，测试内容为使用 Chunky 加载半径 1000 格的方块并保存，测试核心为 Leaf，实际结果可能与测试结果有出入。 -| 世界 | ANVIL(原版格式) | Linear(压缩比为一) | Linear(压缩比为六，默认压缩比) | Linear(压缩比为 22)(最大压缩比) | +| 世界 | Anvil (原版格式) | Linear (压缩比为 1) | Linear (压缩比为 6，默认压缩比) | Linear (压缩比为 22)(最大压缩比) | | -------- | --------------- | ------------------ | ------------------------------ | ------------------------------- | | 主世界 | 192MB | 142MB | 117MB | 92MB | | 地狱 | 118MB | 70MB | 60MB | 46MB | @@ -100,7 +100,7 @@ Leaf/Luminol 等核心最新版已应用修复补丁，虽然性能会受到影 #### Slime -请查看[Slime 区域格式](/Java/advance/slime-world) +请查看 [Slime 区域格式](../../../advance/slime-world.md) ## 其他 @@ -110,7 +110,7 @@ Leaf/Luminol 等核心最新版已应用修复补丁，虽然性能会受到影 3。重装系统，并最小化安装 (不安装非必要软件)； -4。检查是否有多余的 Java(一般来说开服一个版本的 Java 即可)。 +4。检查是否有多余的 Java (一般来说开服一个版本的 Java 即可)。 :::warning diff --git a/docs-java/process/maintenance/resourcepack/compress.md b/docs-java/process/maintenance/resourcepack/compress.md index 99f088371..cd815d486 100644 --- a/docs-java/process/maintenance/resourcepack/compress.md +++ b/docs-java/process/maintenance/resourcepack/compress.md @@ -1,29 +1,29 @@ --- -title: 压缩&混淆 +title: 压缩 & 混淆 sidebar_position: 3 --- -# 压缩&混淆 +# 压缩 & 混淆 为了让玩家更快的下载资源包 (并节省你的流量),你需要对资源包进行压缩 或者为了防止他人轻易的偷走你的资源包，你也需要对资源包进行混淆 -:::tip 混淆的安全性 +:::tip[混淆的安全性] 就算你进行了最高强度的混淆，也不意味着你的材质包不会被偷走，只是难度变大了 ::: -推荐使用 [PackSquash](https://packsquash.aylas.org/) 进行压缩和混淆，注意：**本部分内容仅限于 ZIP 层面的压缩&混淆** +推荐使用 [PackSquash](https://packsquash.aylas.org/) 进行压缩和混淆，注意：**本部分内容仅限于 ZIP 层面的压缩 & 混淆** ## 下载 -前往[官网](https://packsquash.aylas.org/) 下载即可 +前往 [官网](https://packsquash.aylas.org/) 下载即可 ## 使用 -PackSquash 需要你在目录下创建配置文件`packsquash.toml`才可以使用 +PackSquash 需要你在目录下创建配置文件 `packsquash.toml` 才可以使用 然后向文件中写入以下内容 @@ -31,15 +31,15 @@ PackSquash 需要你在目录下创建配置文件`packsquash.toml`才可以使 pack_directory = 'C:\path\to\pack(填写你的资源包所在目录)' ``` -然后在当前目录运行`packsquash packsquash.toml` 即可 +然后在当前目录运行 `packsquash packsquash.toml` 即可 ## 其他选项 :::tip -这并不是所有的选项，**只列出了一些**对于新手有用的选项 +这并不是所有的选项，**只列出了一些** 对于新手有用的选项 -同时简化了一些选项表达，完整版请参考[GitHub Wiki](https://github.com/ComunidadAylas/PackSquash/wiki/Options-files) +同时简化了一些选项表达，完整版请参考 [GitHub Wiki](https://github.com/ComunidadAylas/PackSquash/wiki/Options-files) ::: @@ -55,13 +55,13 @@ output_file_path = 'C:\path\to\result\pack\zip\file\my_pack.zip' zip_spec_conformance_level = 'pedantic' ``` -默认取值为`pedantic`,表示完全遵循 ZIP 文件规范，所有的查看和托管都可以识别 +默认取值为 `pedantic`，表示完全遵循 ZIP 文件规范，所有的查看和托管都可以识别 -`disregard`为加料模式，包括提取保护和改进的内部 ZIP 文件结构压缩，会获得更好的性能，非常推荐 +`disregard` 为加料模式，包括提取保护和改进的内部 ZIP 文件结构压缩，会获得更好的性能，非常推荐 :::warning -并不是所有的托管和查看程序都能识别`disregard`模式的 zip 文件 +并不是所有的托管和查看程序都能识别 `disregard` 模式的 zip 文件 ::: @@ -72,7 +72,7 @@ size_increasing_zip_obfuscation = true ``` 当使用`disregard`模式时，启用此选项将增加对生成的 ZIP -文件进行查看、提取或篡改的保护，这会略微增加其大小。此选项不影响是否添加**不增加文件大小**的保护，并且如果 ZIP 标准不提供保护，则没有任何影响 +文件进行查看、提取或篡改的保护，这会略微增加其大小。此选项不影响是否添加 **不增加文件大小** 的保护，并且如果 ZIP 标准不提供保护，则没有任何影响 ### 压缩保密性 diff --git a/docs-java/process/maintenance/resourcepack/plugins/entity.md b/docs-java/process/maintenance/resourcepack/plugins/entity.md index 5b1e16692..87804428d 100644 --- a/docs-java/process/maintenance/resourcepack/plugins/entity.md +++ b/docs-java/process/maintenance/resourcepack/plugins/entity.md @@ -50,7 +50,7 @@ import TabItem from '@theme/TabItem'; ::: -[ModelEngineDecoration](https://www.spigotmc.org/resources/106916/) 是 ModelEngine V4 的一个扩展，可以把生物实体变成装饰 +[ModelEngineDecoration](https://www.spigotmc.org/resources/106916/) 是 ModelEngine v4 的一个扩展，可以把生物实体变成装饰 diff --git a/docs-java/process/maintenance/resourcepack/plugins/framework.md b/docs-java/process/maintenance/resourcepack/plugins/framework.md index dc8579f4a..505d59c2a 100644 --- a/docs-java/process/maintenance/resourcepack/plugins/framework.md +++ b/docs-java/process/maintenance/resourcepack/plugins/framework.md @@ -15,9 +15,9 @@ import TabItem from '@theme/TabItem'; `SpigotMC` https://www.spigotmc.org/resources/73355 -`GitHub(主页)` https://github.com/ItemsAdder +`GitHub (主页)` https://github.com/ItemsAdder -`GitHub(可以反馈 BUG)` https://github.com/PluginBugs/Issues-ItemsAdder +`GitHub (可以反馈 bug)` https://github.com/PluginBugs/Issues-ItemsAdder `文档 (英文)` https://itemsadder.devs.beer @@ -36,7 +36,7 @@ import TabItem from '@theme/TabItem'; https://zhangshenxing.github.io/VanillaModTutorial - 第二步： -使用 IA 官方 WIKI 并结合原版材质包开发产出内容，但是请注意 IA 内有大量无用功能和屎山代码，所以将 IA 当作一个打包器是最优解的选择 +使用 IA 官方 Wiki 并结合原版材质包开发产出内容，但是请注意 IA 内有大量无用功能和屎山代码，所以将 IA 当作一个打包器是最优解的选择 https://itemsadder.devs.beer - 第三步：如何让你的服务器更加劣质的办法 (仅我个人而言，如果你看的很不舒服我很抱歉，如果你要对号入座那就是你是对的) @@ -45,7 +45,7 @@ https://itemsadder.devs.beer 3. 乱加插件，看啥加啥，导致服务器变成性能答辩，这种服开不了几个月就跑路 4. 在高版本非特殊需求还在使用单端开发，没有采用最基本的群组框架 - ————来自 ia 群 群公告 + ————来自 IA 群 群公告 ``` 连基础都没学不要他妈的问问问 @@ -77,7 +77,7 @@ https://itemsadder.devs.beer :::info -`Modrinth(社区版)` https://modrinth.com/plugin/craftengine +`Modrinth (社区版)` https://modrinth.com/plugin/craftengine `Polymart` https://polymart.org/product/7624/craftengine @@ -92,7 +92,9 @@ https://itemsadder.devs.beer ::: :::warning + 本项目处于开发状态，如遇到错误请到 [GitHub](https://github.com/Xiao-MoMi/craft-engine/issues) 提交问题 + ::: ## 插件特点 @@ -131,18 +133,23 @@ CraftEngine 使用一个服务端的真实体存储家具的数据，然后将 ### 资源包保护 :::info[说明] -CraftEngine 提供了比 [PackSquash](/Java/process/maintenance/resourcepack/compress) 更强大的内置资源包保护。 -因为 CraftEngine 侧重于保护性所以使用保护功能时会导致资源包大小增加，如果侧重于压缩率更推荐使用 [PackSquash](/Java/process/maintenance/resourcepack/compress)。 +CraftEngine 提供了比 [PackSquash](../compress.md) 更强大的内置资源包保护。 + +因为 CraftEngine 侧重于保护性所以使用保护功能时会导致资源包大小增加，如果侧重于压缩率更推荐使用 [PackSquash](../compress.md)。 + ::: :::danger + 不要尝试解压开启了 crash-tools 的的资源包！ + ::: :::warning 如果发现有可以破解资源包的工具可以前往本插件的 [Discord](https://discord.gg/WVKdaUPR3S) 打开工单反馈！ + ::: ```yaml title="推荐配置" diff --git a/docs-java/process/maintenance/resourcepack/plugins/hud.md b/docs-java/process/maintenance/resourcepack/plugins/hud.md index 2979bc1a5..f1eb58f7e 100644 --- a/docs-java/process/maintenance/resourcepack/plugins/hud.md +++ b/docs-java/process/maintenance/resourcepack/plugins/hud.md @@ -38,7 +38,7 @@ import TabItem from '@theme/TabItem'; ::: -付费的 HUD 的插件，以前的名字为 HappyHUD，支持的版本为 `1.19-1.21`,非常不推荐的插件: +付费的 HUD 的插件，以前的名字为 HappyHUD，支持的版本为 `1.19-1.21`,非常不推荐的插件： - Wiki 写的非常糟糕，完全不如 BetterHud - HappyHUD 改个名后要求全部重新付费 diff --git a/docs-java/process/maintenance/resourcepack/plugins/other.md b/docs-java/process/maintenance/resourcepack/plugins/misc.md similarity index 85% rename from docs-java/process/maintenance/resourcepack/plugins/other.md rename to docs-java/process/maintenance/resourcepack/plugins/misc.md index 6dc02d16b..f20ef0ca5 100644 --- a/docs-java/process/maintenance/resourcepack/plugins/other.md +++ b/docs-java/process/maintenance/resourcepack/plugins/misc.md @@ -17,7 +17,7 @@ import TabItem from '@theme/TabItem'; `SpigotMC` https://www.spigotmc.org/resources/119966/ -`Github` https://github.com/Mitality/BodyHealth +`GitHub` https://github.com/Mitality/BodyHealth ::: @@ -32,7 +32,7 @@ import TabItem from '@theme/TabItem'; `SpigotMC` https://www.spigotmc.org/resources/116619/ -`Github` https://github.com/toxicity188/BetterHealthBar3 +`GitHub` https://github.com/toxicity188/BetterHealthBar3 `文档 (英文)` https://github.com/toxicity188/BetterHealthBar3/wiki @@ -66,7 +66,7 @@ import TabItem from '@theme/TabItem'; `SpigotMC` https://www.spigotmc.org/resources/114756/ -`Github` https://github.com/JNNGL/VanillaMinimaps +`GitHub` https://github.com/JNNGL/VanillaMinimaps `Modrinth` https://modrinth.com/plugin/vanillaminimaps @@ -84,9 +84,9 @@ import TabItem from '@theme/TabItem'; `SpigotMC` https://www.spigotmc.org/resources/93795/ -`Github` https://github.com/ValMobile/RealisticSurvival +`GitHub` https://github.com/ValMobile/RealisticSurvival -`文档(英文)` https://github.com/ValMobile/RealisticSurvival/wiki +`文档 (英文)` https://github.com/ValMobile/RealisticSurvival/wiki ::: diff --git a/docs-java/process/maintenance/resourcepack/plugins/tooltip.md b/docs-java/process/maintenance/resourcepack/plugins/tooltip.md index d6cf41da1..136091454 100644 --- a/docs-java/process/maintenance/resourcepack/plugins/tooltip.md +++ b/docs-java/process/maintenance/resourcepack/plugins/tooltip.md @@ -11,7 +11,7 @@ title: Tooltip `GitHub` https://github.com/Septicuss/tooltips -`文档(英文)` https://tooltips.gitbook.io/tooltips/ +`文档 (英文)` https://tooltips.gitbook.io/tooltips/ ::: diff --git a/docs-java/process/maintenance/resourcepack/protect.md b/docs-java/process/maintenance/resourcepack/protect.md index 13efa7949..be506bb8b 100644 --- a/docs-java/process/maintenance/resourcepack/protect.md +++ b/docs-java/process/maintenance/resourcepack/protect.md @@ -9,7 +9,7 @@ sidebar_position: 4 资源包保护主要分为两种： -- 无客户端 mod(客户端此时不需要做任何事情) +- 无客户端 mod (客户端此时不需要做任何事情) - 有客户端 mod 这个保护并不是 100% 的防御， @@ -29,7 +29,7 @@ sidebar_position: 4 无客户端 mod 保护方案由于技术限制，保护方式集中于 ZIP 格式保护 (如破坏格式),和混淆打乱 (Oraxen 命名空间打乱等) -> 教程：[压缩&混淆](compress.md) +> 教程：[压缩 & 混淆](compress.md) ## 有客户端 mod @@ -68,9 +68,9 @@ sidebar_position: 4 一个高版本的资源包保护插件，支持 1.18.1, 1.20.1, 1.21.1, 支持 NeoForge/Fabric 服务端 1. 在服务器上安装此插件和 packetevents 插件 -2. 开启服务端，编辑 ~/plugins/ResourceHack/config.yml 配置加密密钥 +2. 开启服务端，编辑 `~/plugins/ResourceHack/config.yml` 配置加密密钥 3. 重启服务端或 reload 插件 -4. 使用 `/res encrypt `（需要`resack.encrypt`权限）加密资源包 +4. 使用 `/res encrypt `（需要 `resack.encrypt` 权限）加密资源包 5. 配置资源包托管 客户端： diff --git a/docs-java/process/maintenance/resourcepack/resourcepack.md b/docs-java/process/maintenance/resourcepack/resourcepack.md index 7be9b3e3e..deb8a2402 100644 --- a/docs-java/process/maintenance/resourcepack/resourcepack.md +++ b/docs-java/process/maintenance/resourcepack/resourcepack.md @@ -8,7 +8,7 @@ slug: /resourcepack :::tip -这一部分的教程不是教你如何**制作**资源包，而是教你如何**托管/压缩/混淆**资源包!! +这一部分的教程不是教你如何 **制作** 资源包，而是教你如何 **托管/压缩/混淆** 资源包!! ::: @@ -18,7 +18,7 @@ slug: /resourcepack :::note -因为 ItemsAdder(ia) 太有名于是所有类似服务器都被称为 ia 服了 +因为 ItemsAdder (IA) 太有名于是所有类似服务器都被称为 IA 服了 ::: @@ -61,13 +61,13 @@ slug: /resourcepack 社区都发展成这样了，某些人还以为资源包“必须修改原版物品” “生存一得到原版东西就露馅” -还有不少半吊子都不如的人以为做到折叠中的效果必须要 ia 或某某特定插件。 +还有不少半吊子都不如的人以为做到折叠中的效果必须要 IA 或某某特定插件。 -这都是原版资源包能做到的东西，ia 只是一个打包器，你有能力甚至可以自己手搓材质包。 +这都是原版资源包能做到的东西，IA 只是一个打包器，你有能力甚至可以自己手搓材质包。 ## 注意 -JAVA 版的资源包分发与基岩版不同，它是云分发的，提供给客户端的应该是一个**直链**，而不是资源包本身 +Java 版的资源包分发与基岩版不同，它是云分发的，提供给客户端的应该是一个 **直链**，而不是资源包本身 不管你用什么方式，都必须是直链才可正常使用！ diff --git a/docs-java/process/maintenance/resourcepack/send.md b/docs-java/process/maintenance/resourcepack/send.md index 1a8f3b480..8258ea20f 100644 --- a/docs-java/process/maintenance/resourcepack/send.md +++ b/docs-java/process/maintenance/resourcepack/send.md @@ -13,7 +13,7 @@ sidebar_position: 2 RoseResourcepack 是一个强大的资源包管理插件，拥有许多很好的功能 -- **集成资源包托管：直接从您的服务器托管资源包**(比 IA 那个唐诗好多了) +- **集成资源包托管：直接从您的服务器托管资源包** (比 IA 那个唐诗好多了) - 多版本支持：兼容 Minecraft 1.16.5 至 1.21.3 版本。 - MiniMessage 支持：使用 MiniMessage 自定义消息。 - 与其他插件集成：与 BetterHUD、ItemsAdder 和 Oraxen 等插件兼容。 @@ -44,13 +44,13 @@ https://ce.gtemc.cn/zh-Hans/getting_start/set_up_host ## 托管网站 -以下均为 ia 文档中所说的 第三方平台托管 (external-host) +以下均为 IA 文档中所说的 第三方平台托管 (external-host) import Tabs from '@theme/Tabs'; import TabItem from '@theme/TabItem'; - + 官网：https://www.setup.md/usercontent @@ -68,7 +68,7 @@ import TabItem from '@theme/TabItem'; - 注册要开梯子 - + 官网：https://mc-packs.net/ @@ -93,12 +93,12 @@ import TabItem from '@theme/TabItem'; ### Cloudflare R2 -免费的 Cloudflare R2 提供 10 GB 的免费空间，只不过需要**绑定银行卡或者 PayPal**(不会花钱)，非常推荐 +免费的 Cloudflare R2 提供 10 GB 的免费空间，只不过需要 **绑定银行卡或者 PayPal** (不会花钱)，非常推荐 -- 使用方法：创建一个 R2 存储桶，名称自选，位置选择`亚太地区 (APAC)`(速度最快)，默认存储类一定要选择 `标准` +- 使用方法：创建一个 R2 存储桶，名称自选，位置选择 `亚太地区 (APAC)` (速度最快)，默认存储类一定要选择 `标准` ，创建好后直接上传资源包就可以了 (可以设置自定义域) -- 无域名方案：完成上一步后，打开设置，找到`R2.dev 子域 `，点击 `允许访问` 即可使用 CF 提供的免费域名 +- 无域名方案：完成上一步后，打开设置，找到 `R2.dev 子域`，点击 `允许访问` 即可使用 CF 提供的免费域名 图文教程：https://juejin.cn/post/7331584783611281444 @@ -161,7 +161,7 @@ CF Worker 的一个附属品，用来当可持久存储的，用来当资源包 国内的网络环境不建议用这个 -- 方案一：首先创建一个新的仓库，接着创建发行版，把资源包上传至发行版，复制下载链接，将链接填入 ia 的 第三方平台托管 ( +- 方案一：首先创建一个新的仓库，接着创建发行版，把资源包上传至发行版，复制下载链接，将链接填入 IA 的 第三方平台托管 ( external-host) 或使用 server.properties - 方案二：首先创建一个新的仓库，接着上传资源包文件到仓库中，点击你上传的文件，复制这单个文件的下载链接 @@ -185,7 +185,7 @@ CF Worker 的一个附属品，用来当可持久存储的，用来当资源包 国内的代码托管平台，访问速度快，推荐使用 -- 方案一：首先创建一个新的仓库，接着创建发行版，把资源包上传至发行版，复制下载链接，将链接填入 ia 的 第三方平台托管 ( +- 方案一：首先创建一个新的仓库，接着创建发行版，把资源包上传至发行版，复制下载链接，将链接填入 IA 的 第三方平台托管 ( external-host) 或使用 server.properties - 方案二：首先创建一个新的仓库，接着上传资源包文件到仓库中，点击你上传的文件，复制这单个文件的下载链接 @@ -208,7 +208,7 @@ CF Worker 的一个附属品，用来当可持久存储的，用来当资源包 国内访问比较稳定的代码托管平台 -- 方案一：首先创建一个新的仓库，接着创建发行版，把资源包上传至发行版，复制下载链接，将链接填入 ia 的 第三方平台托管 ( +- 方案一：首先创建一个新的仓库，接着创建发行版，把资源包上传至发行版，复制下载链接，将链接填入 IA 的 第三方平台托管 ( external-host) 或使用 server.properties - 方案二：首先创建一个新的仓库，接着上传资源包文件到仓库中，点击你上传的文件，复制这单个文件的下载链接 @@ -228,7 +228,7 @@ CF Worker 的一个附属品，用来当可持久存储的，用来当资源包 -ia 的文档教了如何使用 +IA 的文档教了如何使用 [Google Drive](https://itemsadder.devs.beer/v/chinese/plugin-usage/resourcepack-hosting/google-drive-1.17.1+) 和 [OneDrive](https://itemsadder.devs.beer/v/chinese/plugin-usage/resourcepack-hosting/onedrive) 进行材质托管 @@ -275,13 +275,13 @@ ItemsAdder，可以直接在服务器上托管资源包：https://itemsadder.dev ## 分发 -通常，IA,RoseResourcepack 这些插件会自动将资源包发送给玩家 +通常，IA，RoseResourcepack 这些插件会自动将资源包发送给玩家 当然，你也可以使用自带的`server.properties` 进行分发 ### 例子 -我们拿到 slimefun 的资源包直链地址是: +我们拿到 Slimefun 的资源包直链地址是： https://github.com/xMikux/Slimefun-Resourcepack/releases/download/latest-build/Slimefun-ResourcePack.zip ， 然后我们打开`server.properties`，找到以下内容： diff --git a/docs-java/process/maintenance/resourcepack/software.md b/docs-java/process/maintenance/resourcepack/software.md index fd8be2052..8beb10a40 100644 --- a/docs-java/process/maintenance/resourcepack/software.md +++ b/docs-java/process/maintenance/resourcepack/software.md @@ -15,7 +15,7 @@ sidebar_position: 1 ## Minecraft Title Generator -一个用来整服务器 title 的 blockbench 插件 +一个用来整服务器 title 的 Blockbench 插件 ![](_images/title.png) diff --git a/docs-java/process/mobile-player/Geyser/Upgrade/Slimefun.md b/docs-java/process/mobile-player/Geyser/Upgrade/Slimefun.md deleted file mode 100644 index eeb2d753f..000000000 --- a/docs-java/process/mobile-player/Geyser/Upgrade/Slimefun.md +++ /dev/null @@ -1,28 +0,0 @@ ---- -title: 兼容 Slimefun -sidebar_position: 2 ---- - -# 兼容 Slimefun - -:::danger - -想要显示自定义物品纹理，你必须在服务端使用[粘液科技资源包](https://github.com/xMikux/Slimefun-Resourcepack/releases) -，后才可以正常使用 - -::: - -## 下载 - -第一步，下载[资源包](https://dl.8aka.org/plugins/Slimefun.mcpack)，安装到 `服务端/geyser/packs` 文件夹 - -![](_image/Geyser4.png) - -第二步，下载[Mapping](https://dl.8aka.org/plugins/RYSurvival-SlimefunMapping.jar)，安装到 `服务端/geyser/extensions` -文件夹 - -![](Extended/_image/Geyser5.png) - -另一个扩展的 [Slimefun 资源包](https://dl.8aka.org/plugins/slimefun-extension.zip) 下载后全部拖入 Geyser 文件夹即可使用 - -**重启**服务端即可！ diff --git a/docs-java/process/mobile-player/Geyser/Upgrade/_image/Geyser3.png b/docs-java/process/mobile-player/Geyser/Upgrade/_image/Geyser3.png deleted file mode 100644 index 4caf8004e..000000000 Binary files a/docs-java/process/mobile-player/Geyser/Upgrade/_image/Geyser3.png and /dev/null differ diff --git a/docs-java/process/mobile-player/_images/trollstone_i1.png b/docs-java/process/mobile-player/_images/trollstone_i1.png deleted file mode 100644 index dbc66dd9b..000000000 Binary files a/docs-java/process/mobile-player/_images/trollstone_i1.png and /dev/null differ diff --git a/docs-java/process/mobile-player/_images/trollstone_i3.png b/docs-java/process/mobile-player/_images/trollstone_i3.png deleted file mode 100644 index 806a3d496..000000000 Binary files a/docs-java/process/mobile-player/_images/trollstone_i3.png and /dev/null differ diff --git a/docs-java/process/mobile-player/client/Amethyst_iOS.md b/docs-java/process/mobile-player/client/Amethyst_iOS.md deleted file mode 100644 index f871a60bb..000000000 --- a/docs-java/process/mobile-player/client/Amethyst_iOS.md +++ /dev/null @@ -1,227 +0,0 @@ ---- -title: 在 iOS 上安装 Amethyst -sidebar_position: 3 ---- - -# 在 iOS 上安装 Amethyst - -## 方法一：使用 AltStore - -### （针对 Windows 用户，Windows 用户尚不支持在 iOS 17 上使用 AltJIT） - -1.点击此 [链接](https://www.i4.cn)下载爱思助手电脑端并安装 - -2.打开爱思助手，点击“工具箱->iTunes 及驱动->安装 iTunes”来安装 iTunes -![](../_images/i4_1.png) -![](../_images/i4_2.png) -![](../_images/i4_3.png) - -3.点击此 [链接](https://updates.cdn-apple.com/2020/windows/001-39935-20200911-1A70AA56-F448-11EA-8CC0-99D41950005E/iCloudSetup.exe)下载 iCloud 电脑端并安装 - -4.点击此 [链接](https://cdn.altstore.io/file/altstore/altinstaller.zip)下载 AltServer - -5.解压 AltInstaller.zip 并运行 Setup.exe - -6.将你的设备连接到电脑，并确保其已解锁。 - -7.打开 iTunes，然后在设备上启用“通过 Wi-Fi 与此 iPhone 同步” -![](../_images/iTunes_1.png) -![](../_images/iTunes_2.png) 8.点击右下角任务栏中的 AltServer 图标。然后前往“Install AltStore”，并选择你的 iOS 设备。 - -![](../_images/Alt_1.png) - -9.输入您的 Apple ID 电子邮件地址和密码。 - -![](../_images/Alt_2.png) - -10.等待几秒钟，然后会出现一个 AltServer 通知，提示 AltStore 已成功安装到您的设备上。 - -11.在 iOS 设备上，前往“设置”->“通用”->“描述文件和设备管理”。点击“信任 您的 Apple ID”，然后再次点击“信任”进行确认。 - -（要在 iOS 16 或更高版本上使用 AltStore，您需要前往“设置”->“隐私和安全”->“开发者模式”在设备上启用开发者模式。） - -12.从此 [链接](https://github.com/AngelAuraMC/Amethyst-iOS/actions) 下载 Amethyst 的 ipa 安装包。**（需要使用 github 账号才能继续下载）** - -### 手机开启 JIT - -13.打开“My Apps”选项卡，然后长按 Amethyst。 - -14.按“Enable JIT”启动应用程序，几秒钟内您就会看到 AltStore 通知，提示 JIT 已启用。 - -### 电脑开启 JIT - -16.首先，确保 Amethyst 在设备前台运行。 - -17.点击右下角任务栏中的 AltServer 图标。然后点击“Enable JIT”>您的设备，然后选择 Amethyst - -## 方法二：使用 TrollStore - -### 支持范围 - -A8 处理器的 iPhone，iPad 等在 iOS/iPadOS 14.0 beta 2 ~ 15.8.4 可以安装 - -A9-A11 处理器的 iPhone，iPad 等在 iOS/iPadOS 14.0 beta 2 ~ 17.0 除 16.7.x（不包含 RC）以外可以安装 - -A12-A17/M1-M2处理器的iPhone，iPad等在iOS/iPadOS 14.0 beta 2 ~ 17.0 除 16.7.x（不包含 RC）以外可以安装 - -### 安装 TrollStore - -#### 以下方法支持固件版本 14.0 至 15.1.1 的所有 iOS/iPadOS 设备、固件版本 15.2 至 16.6.1 的 A9(X) - -#### 以及更高版本设备以及版本 17.0 beta 1 至 17.0 beta 4 的 A10(X) 设备 - -1.点击此 [链接](https://www.i4.cn)下载爱思助手电脑端并安装。 - -2.将你的设备连接到电脑，并确保其已解锁。 - -3.点击此 [链接](https://github.com/alfiecg24/TrollInstallerX/releases/latest/download/TrollInstallerX.ipa)下载 TrollInstallerX。 - -4.打开爱思助手，点击“工具箱->iTunes 及驱动->安装 iTunes”来安装 iTunes。 - -5.在爱思助手中，点击“工具箱->IPA 签名->添加 IPA 文件”将你下载好的 TrollInstallerX 选中，之后点击打开 - -6.在刚刚的 IPA 签名的窗口中，点击使用 Apple ID 签名，点击添加 Apple ID - -7.现在，在使用 Apple ID 窗口中，填写你的 Apple ID 和密码 - -8.在 UDID（设备标识）中选择与你设备 UDID 相同的一项，点击确定 - -9.选择 TrollInstallerX 和你刚才添加的 Apple ID，点击开始签名 - -10.签名成功后点击打开已签名 IPA 位置，双击 TrollInstallerX.ipa，选择你的设备点击安装 - -11.在你的设备上，前往“设置”->“通用”->“描述文件和设备管理”。点击“信任 [您的 Apple ID]”，然后再次点击“信任”进行确认 - -（iOS 16 或更高版本上使用 TrollInstallerX，您需要前往“设置”->“隐私和安全”->“开发者模式”在设备上启用开发者模式。） - -12.打开 TrollInstallerX，点击“Install TrollStore” - -13.当提示要“install the persistence helper”请点击您**最不经常使用的应用程序** - -（如果您不知道点击哪个应用，请选择 Tips） - -14.在适用于 A15、A16 和 M2 设备的 iOS 16.5.1 以及适用于 A12 及更高版本的设备的 iOS 16.6 至 16.6.1 上， - -你需要打开你安装的“persistence helper”并且点击 Install TrollStore - -15.从此 [链接](https://github.com/AngelAuraMC/Amethyst-iOS/actions) 下载 Amethyst 的 tipa 安装包。**（安装包需要使用 github 账号才能继续下载）** - -16.打开 Amethyst - -#### 以下方法支持 iOS/iPadOS 15.0 至 15.5 beta 4 和 15.6 beta 1 至 15.6 beta 3 A11 及更早版本的设备 - -#### iOS/iPadOS 14.0 beta 2 至 15.6.1 和 16.0 beta 1 至 16.0 beta 3 A12 及更高版本的设备 - -1.打开 Safari - -2.在您的设备上打开此页面 - -3.在您的设备上，使用 Safari 访问（itms-services://?action=download-manifest&url=https://jailbreaks.app/cdn/plists/TrollHelper.plist） - -4.点击 Install - -5.一个名为的应用程序 GTA Car Tracker 现在将安装到您的设备上 - -6.打开 GTA Car Tracker，点击 Register Persistence Helper，点击 Install TrollStore - -（如果重新启动，重新执行第六步） - -7.从此 [链接](https://github.com/AngelAuraMC/Amethyst-iOS/actions) 下载 Amethyst 的 tipa 安装包。**（tipa 安装包需要使用 github 账号才能继续下载）** - -8.打开 Amethyst - -#### 以下方法支持 iOS/iPadOS 16.7 RC、17.0 beta 5~17.0 - -1.安装 python3 最新版本，[官网下载地址](https://www.python.org/downloads/)。 - -2.点击此 [链接](https://www.i4.cn)下载爱思助手电脑端并安装。 - -3.打开爱思助手，点击“工具箱->iTunes 及驱动->安装 iTunes”来安装 iTunes -![](../_images/i4_1.png) -![](../_images/i4_2.png) -![](../_images/i4_3.png) - -4.下载[TrollRestore](https://github.com/JJTech0130/TrollRestore/releases/download/1.0/TrollRestore.exe) - -5.将你的设备连接到电脑，并确保其已解锁。 - -6.打开文件资源管理器，找到下载/提取的文件的保存位置。 - -7.双击 TrollRestore - -8.出现提示时，输入要覆盖的系统应用程序的名称，然后按回车键 - -（如果您不确定要覆盖哪个应用程序，请通过输入覆盖 Tips 应用程序 Tips） - -9.解锁您的设备，打开你覆盖的系统应用程序，点击 Install TrollStore - -10.从此 [链接](https://github.com/AngelAuraMC/Amethyst-iOS/actions) 下载 Amethyst 的 tipa 安装包。**（在 GitHub Actions 需要使用 github 账号才能继续下载）** - -11.打开 Amethyst - -## 方法三：牛蛙助手 - -~~虽然简单但是不推荐，因为广告太多了~~ - -1.点击[这里](https://ios222.com/)下载牛蛙助手 - -2.点击此 [链接](https://www.i4.cn)下载爱思助手电脑端并安装 - -3.打开爱思助手，点击“工具箱->iTunes 及驱动->安装 iTunes”来安装 iTunes -![](../_images/i4_1.png) -![](../_images/i4_2.png) -![](../_images/i4_3.png) - -4.打开牛蛙助手，将你的苹果设备链接至电脑（先把设备解锁） - -5.点击“立即安装” - -6.打开手机上的牛蛙助手 - -7.点击一下->允许->设置->已下载描述文件->安装->输入手机密码->安装->安装 - -8.打开手机上的牛蛙助手，点击 IPA 签名->证书->右上方的“+”->apple 证书 - -9.输入你的 appleID 和密码，点击确定 - -10.从此 [链接](https://github.com/AngelAuraMC/Amethyst-iOS/actions) 下载 Amethyst 的 ipa 安装包。**（需要使用 github 账号才能继续下载）** - -11.点击文件管理->右上方的“+”->导入资源，导入你刚才下载的 IPA 文件 - -12.点击应用->找到 Amethyst，点击它->签名 - -13.找到“已签名”点击一下->找到 Amethyst，点击它->点击安装->点击安装 - -14.回到牛蛙助手的主页->JIT->找到 Amethyst，点击它->点击使用 JIT 启动 - -（iOS/iPadOS 16+ 记得前往“设置”->“隐私和安全”->“开发者模式”在设备上启用开发者模式。） - -## 方法四：越狱 - -:::warning - -本文档不对你的设备安全负责 - -请你在知道你在做什么的情况下，使用越狱的方法 - -（越狱可以获得手机最高权限） - -::: - -| 越狱名称 | 支持版本 (iOS/iPad OS) | 支持芯片 | -| ------------------------------------------- | ---------------------- | ------------- | -| [Electra](https://coolstar.org/electra/) | 11.0~11.1.2 | A9-A11 | -| [Chimera](https://chimera.coolstar.org/) | 12.0~12.5.5 | A9~A12 | -| [Odyssey](https://theodyssey.dev/) | 13.0~13.7 | A9~A13 | -| [Unc0ver](https://unc0ver.dev/) | 11.0~14.8 | A9~A14 | -| [Taurine](https://taurine.app/) | 14.0~14.8.1 | A9~A12 | -| [Dopamine](https://ellekit.space/dopamine/) | 15.0~16.6.1* | A12~A16,M1~M2 | -| [Checkraln](https://checkra.in/) | 12.0~15.4.1 | A7~A11 | -| [Paleraln](https://palera.in/) | 15.0~? | A7~A11 | - -*Dopamine 到 iOS 16.6 - 16.6.1 不支持 A12 及更新版本的设备，iOS 16.5.1 - 16.6.1 不支持 A15-A16/M2 版本的设备。 - -除了 Paleraln 和 Checkraln 需要使用 U 盘或者 Linux 或者 macOS，其他基本上就是签名->安装->打开->点 jailbreak 就可以了 - -基本上就是**安装 TrollStore**第一个方法 1~11 步 -~~懒得写了~~ diff --git a/docs-java/process/mobile-player/client/amethyst-ios.md b/docs-java/process/mobile-player/client/amethyst-ios.md new file mode 100644 index 000000000..eb0f78466 --- /dev/null +++ b/docs-java/process/mobile-player/client/amethyst-ios.md @@ -0,0 +1,232 @@ +--- +title: 在 iOS 上安装 Amethyst +sidebar_position: 3 +--- + +# 在 iOS 上安装 Amethyst + +## 方法一：使用 AltStore + +### （针对 Windows 用户，Windows 用户尚不支持在 iOS 17 上使用 AltJIT） + +1. 点击此 [链接](https://www.i4.cn) 下载爱思助手电脑端并安装 + +2. 打开爱思助手，点击“工具箱->iTunes 及驱动->安装 iTunes”来安装 iTunes + +![](../_images/i4_1.png) +![](../_images/i4_2.png) +![](../_images/i4_3.png) + +3. 点击此 [链接](https://updates.cdn-apple.com/2020/windows/001-39935-20200911-1A70AA56-F448-11EA-8CC0-99D41950005E/iCloudSetup.exe) 下载 iCloud 电脑端并安装 + +4. 点击此 [链接](https://cdn.altstore.io/file/altstore/altinstaller.zip) 下载 AltServer + +5. 解压 AltInstaller.zip 并运行 Setup.exe + +6. 将你的设备连接到电脑，并确保其已解锁。 + +7. 打开 iTunes，然后在设备上启用“通过 Wi-Fi 与此 iPhone 同步” +![](../_images/iTunes_1.png) +![](../_images/iTunes_2.png) + +8. 点击右下角任务栏中的 AltServer 图标。然后前往“Install AltStore”，并选择你的 iOS 设备。 + +![](../_images/Alt_1.png) + +9. 输入您的 Apple ID 电子邮件地址和密码。 + +![](../_images/Alt_2.png) + +10. 等待几秒钟，然后会出现一个 AltServer 通知，提示 AltStore 已成功安装到您的设备上。 + +11. 在 iOS 设备上，前往“设置”->“通用”->“描述文件和设备管理”。点击“信任 您的 Apple ID”，然后再次点击“信任”进行确认。 + +（要在 iOS 16 或更高版本上使用 AltStore，您需要前往“设置”->“隐私和安全”->“开发者模式”在设备上启用开发者模式。） + +12. 从此 [链接](https://github.com/AngelAuraMC/Amethyst-iOS/actions) 下载 Amethyst 的 ipa 安装包。**（需要使用 GitHub 账号才能继续下载）** + +### 手机开启 JIT + +13. 打开“My Apps”选项卡，然后长按 Amethyst。 + +14. 按“Enable JIT”启动应用程序，几秒钟内您就会看到 AltStore 通知，提示 JIT 已启用。 + +### 电脑开启 JIT + +16. 首先，确保 Amethyst 在设备前台运行。 + +17. 点击右下角任务栏中的 AltServer 图标。然后点击“Enable JIT”>您的设备，然后选择 Amethyst + +## 方法二：使用 TrollStore + +### 支持范围 + +A8 处理器的 iPhone，iPad 等在 iOS/iPadOS 14.0 beta 2 ~ 15.8.4 可以安装 + +A9-A11 处理器的 iPhone，iPad 等在 iOS/iPadOS 14.0 beta 2 ~ 17.0 除 16.7.x（不包含 RC）以外可以安装 + +A12-A17/M1-M2处理器的iPhone，iPad等在iOS/iPadOS 14.0 beta 2 ~ 17.0 除 16.7.x（不包含 RC）以外可以安装 + +### 安装 TrollStore + +#### 以下方法支持固件版本 14.0 至 15.1.1 的所有 iOS/iPadOS 设备、固件版本 15.2 至 16.6.1 的 A9(X) + +#### 以及更高版本设备以及版本 17.0 beta 1 至 17.0 beta 4 的 A10 (X) 设备 + +1. 点击此 [链接](https://www.i4.cn) 下载爱思助手电脑端并安装。 + +2. 将你的设备连接到电脑，并确保其已解锁。 + +3. 点击此 [链接](https://github.com/alfiecg24/TrollInstallerX/releases/latest/download/TrollInstallerX.ipa) 下载 TrollInstallerX。 + +4. 打开爱思助手，点击“工具箱->iTunes 及驱动->安装 iTunes”来安装 iTunes。 + +5. 在爱思助手中，点击“工具箱->IPA 签名->添加 IPA 文件”将你下载好的 TrollInstallerX 选中，之后点击打开 + +6. 在刚刚的 IPA 签名的窗口中，点击使用 Apple ID 签名，点击添加 Apple ID + +7. 现在，在使用 Apple ID 窗口中，填写你的 Apple ID 和密码 + +8. 在 UDID（设备标识）中选择与你设备 UDID 相同的一项，点击确定 + +9. 选择 TrollInstallerX 和你刚才添加的 Apple ID，点击开始签名 + +10. 签名成功后点击打开已签名 IPA 位置，双击 TrollInstallerX.ipa，选择你的设备点击安装 + +11. 在你的设备上，前往“设置”->“通用”->“描述文件和设备管理”。点击“信任 [您的 Apple ID]”，然后再次点击“信任”进行确认 + +（iOS 16 或更高版本上使用 TrollInstallerX，您需要前往“设置”->“隐私和安全”->“开发者模式”在设备上启用开发者模式。） + +12. 打开 TrollInstallerX，点击“Install TrollStore” + +13. 当提示要“install the persistence helper”请点击您 **最不经常使用的应用程序** + +（如果您不知道点击哪个应用，请选择 Tips） + +14. 在适用于 A15、A16 和 M2 设备的 iOS 16.5.1 以及适用于 A12 及更高版本的设备的 iOS 16.6 至 16.6.1 上， + +你需要打开你安装的“persistence helper”并且点击 Install TrollStore + +15. 从此 [链接](https://github.com/AngelAuraMC/Amethyst-iOS/actions) 下载 Amethyst 的 tipa 安装包。**（安装包需要使用 GitHub 账号才能继续下载）** + +16. 打开 Amethyst + +#### 以下方法支持 iOS/iPadOS 15.0 至 15.5 beta 4 和 15.6 beta 1 至 15.6 beta 3 A11 及更早版本的设备 + +#### iOS/iPadOS 14.0 beta 2 至 15.6.1 和 16.0 beta 1 至 16.0 beta 3 A12 及更高版本的设备 + +1. 打开 Safari + +2. 在您的设备上打开此页面 + +3. 在您的设备上，使用 Safari 访问 `itms-services://?action=download-manifest&url=https://jailbreaks.app/cdn/plists/TrollHelper.plist` + +4. 点击 Install + +5. 一个名为的应用程序 GTA Car Tracker 现在将安装到您的设备上 + +6. 打开 GTA Car Tracker，点击 Register Persistence Helper，点击 Install TrollStore + +（如果重新启动，重新执行第六步） + +7. 从此 [链接](https://github.com/AngelAuraMC/Amethyst-iOS/actions) 下载 Amethyst 的 tipa 安装包。**（tipa 安装包需要使用 GitHub 账号才能继续下载）** + +8. 打开 Amethyst + +#### 以下方法支持 iOS/iPadOS 16.7 RC、17.0 beta 5~17.0 + +1. 安装 Python3 最新版本，[官网下载地址](https://www.python.org/downloads/)。 + +2. 点击此 [链接](https://www.i4.cn) 下载爱思助手电脑端并安装。 + +3. 打开爱思助手，点击“工具箱->iTunes 及驱动->安装 iTunes”来安装 iTunes + +![](../_images/i4_1.png) +![](../_images/i4_2.png) +![](../_images/i4_3.png) + +4. 下载 [TrollRestore](https://github.com/JJTech0130/TrollRestore/releases/download/1.0/TrollRestore.exe) + +5. 将你的设备连接到电脑，并确保其已解锁。 + +6. 打开文件资源管理器，找到下载/提取的文件的保存位置。 + +7. 双击 TrollRestore + +8. 出现提示时，输入要覆盖的系统应用程序的名称，然后按回车键 + +（如果您不确定要覆盖哪个应用程序，请通过输入覆盖 Tips 应用程序 Tips） + +9. 解锁您的设备，打开你覆盖的系统应用程序，点击 Install TrollStore + +10. 从此 [链接](https://github.com/AngelAuraMC/Amethyst-iOS/actions) 下载 Amethyst 的 tipa 安装包。**（在 GitHub Actions 需要使用 GitHub 账号才能继续下载）** + +11. 打开 Amethyst + +## 方法三：牛蛙助手 + +~~虽然简单但是不推荐，因为广告太多了~~ + +1. 点击 [这里](https://ios222.com/) 下载牛蛙助手 + +2. 点击此 [链接](https://www.i4.cn) 下载爱思助手电脑端并安装 + +3. 打开爱思助手，点击“工具箱->iTunes 及驱动->安装 iTunes”来安装 iTunes + +![](../_images/i4_1.png) +![](../_images/i4_2.png) +![](../_images/i4_3.png) + +4. 打开牛蛙助手，将你的苹果设备链接至电脑（先把设备解锁） + +5. 点击“立即安装” + +6. 打开手机上的牛蛙助手 + +7. 点击一下->允许->设置->已下载描述文件->安装->输入手机密码->安装->安装 + +8. 打开手机上的牛蛙助手，点击 IPA 签名->证书->右上方的“+”->apple 证书 + +9. 输入你的 appleID 和密码，点击确定 + +10. 从此 [链接](https://github.com/AngelAuraMC/Amethyst-iOS/actions) 下载 Amethyst 的 ipa 安装包。**（需要使用 GitHub 账号才能继续下载）** + +11. 点击文件管理->右上方的“+”->导入资源，导入你刚才下载的 IPA 文件 + +12. 点击应用->找到 Amethyst，点击它->签名 + +13. 找到“已签名”点击一下->找到 Amethyst，点击它->点击安装->点击安装 + +14. 回到牛蛙助手的主页->JIT->找到 Amethyst，点击它->点击使用 JIT 启动 + +（iOS/iPadOS 16+ 记得前往“设置”->“隐私和安全”->“开发者模式”在设备上启用开发者模式。） + +## 方法四：越狱 + +:::warning + +本文档不对你的设备安全负责 + +请你在知道你在做什么的情况下，使用越狱的方法 + +（越狱可以获得手机最高权限） + +::: + +| 越狱名称 | 支持版本 (iOS/iPad OS) | 支持芯片 | +| ------------------------------------------- | ---------------------- | ------------- | +| [Electra](https://coolstar.org/electra/) | 11.0~11.1.2 | A9-A11 | +| [Chimera](https://chimera.coolstar.org/) | 12.0~12.5.5 | A9~A12 | +| [Odyssey](https://theodyssey.dev/) | 13.0~13.7 | A9~A13 | +| [Unc0ver](https://unc0ver.dev/) | 11.0~14.8 | A9~A14 | +| [Taurine](https://taurine.app/) | 14.0~14.8.1 | A9~A12 | +| [Dopamine](https://ellekit.space/dopamine/) | 15.0~16.6.1* | A12~A16,M1~M2 | +| [Checkraln](https://checkra.in/) | 12.0~15.4.1 | A7~A11 | +| [Paleraln](https://palera.in/) | 15.0~? | A7~A11 | + +*Dopamine 到 iOS 16.6 - 16.6.1 不支持 A12 及更新版本的设备，iOS 16.5.1 - 16.6.1 不支持 A15-A16/M2 版本的设备。 + +除了 Paleraln 和 Checkraln 需要使用 U 盘或者 Linux 或者 macOS，其他基本上就是签名->安装->打开->点 jailbreak 就可以了 + +基本上就是 **安装 TrollStore** 第一个方法 1~11 步 +~~懒得写了~~ diff --git a/docs-java/process/mobile-player/client/Android_all.md b/docs-java/process/mobile-player/client/android-all.md similarity index 51% rename from docs-java/process/mobile-player/client/Android_all.md rename to docs-java/process/mobile-player/client/android-all.md index 4d4444795..046480393 100644 --- a/docs-java/process/mobile-player/client/Android_all.md +++ b/docs-java/process/mobile-player/client/android-all.md @@ -7,12 +7,12 @@ sidebar_position: 4 | 启动器名称 | 是否正常更新 | 下载地址 | | ---------- | ------------ | --------------------------------------------------------------------- | -| FCL | 是 | [Github](https://github.com/FCL-Team/FoldCraftLauncher/releases) | -| ZL | 是 | [Github](https://github.com/ZalithLauncher/ZalithLauncher/releases) | -| ZL2 | 是 | [Github](https://github.com/ZalithLauncher/ZalithLauncher2/releases) | -| Amethyst | 是 | [Github](https://github.com/AngelAuraMC/Amethyst-Android/actions) | -| HMCL(-PE) | 否 | [Github](https://github.com/HMCL-dev/HMCL-PE/releases) | -| MCinaBox | 否 | [Github](https://github.com/AOF-Dev/MCinaBox/releases) | -| Pojav | 否 | [Github](https://github.com/PojavLauncherTeam/PojavLauncher/releases) | +| FCL | 是 | [GitHub](https://github.com/FCL-Team/FoldCraftLauncher/releases) | +| ZL | 是 | [GitHub](https://github.com/ZalithLauncher/ZalithLauncher/releases) | +| ZL2 | 是 | [GitHub](https://github.com/ZalithLauncher/ZalithLauncher2/releases) | +| Amethyst | 是 | [GitHub](https://github.com/AngelAuraMC/Amethyst-Android/actions) | +| HMCL-PE | 否 | [GitHub](https://github.com/HMCL-dev/HMCL-PE/releases) | +| MCinaBox | 否 | [GitHub](https://github.com/AOF-Dev/MCinaBox/releases) | +| Pojav | 否 | [GitHub](https://github.com/PojavLauncherTeam/PojavLauncher/releases) | -下载完成直接安装就好了，推荐的渲染器是[MobileGlues](https://github.com/MobileGL-Dev/MobileGlues-release/releases) +下载完成直接安装就好了，推荐的渲染器是 [MobileGlues](https://github.com/MobileGL-Dev/MobileGlues-release/releases) diff --git a/docs-java/process/mobile-player/client/pcl.md b/docs-java/process/mobile-player/client/pcl.md index 3f51fa1ff..4e6641dee 100644 --- a/docs-java/process/mobile-player/client/pcl.md +++ b/docs-java/process/mobile-player/client/pcl.md @@ -14,31 +14,31 @@ title: 手机直装模板 已经与原版共存的了，避免与本仓库主的服务器客户端冲突，建议修改 -(应用包名) -文件：`FCL/build.gradle` +(应用包名) +文件：`FCL/build.gradle` 位置：`applicationId` -(文件提供器) -文件：`FCLLibrary/src/main/res/values/strings.xml` +(文件提供器) +文件：`FCLLibrary/src/main/res/values/strings.xml` 位置：`file_browser_provider`, `file_browser_document_provider` -(默认 FCL 客户端公共目录) -文件：`FCLauncher/src/main/java/com/tungsten/fclauncher/utils/FCLPath.java` +(默认 FCL 客户端公共目录) +文件：`FCLauncher/src/main/java/com/tungsten/fclauncher/utils/FCLPath.java` 位置：`STORAGE_DIR` ### 应用版本号 -(实际版本号) -文件：`FCL/build.gradle` +(实际版本号) +文件：`FCL/build.gradle` 位置：`versionCode` 和 `versionName` -(显示版本号) -文件：`FCL/src/main/res/values/strings.xml` +(显示版本号) +文件：`FCL/src/main/res/values/strings.xml` 位置：`app_version` ### 应用图标 -文件：`FCL/src/main/res/drawable/ic_launcher` + (`.png`|`_round.png`) +文件：`FCL/src/main/res/drawable/ic_launcher` + (`.png`|`_round.png`) 文件：`FCL/src/main/res/drawable/img_app.png` ### 首次启动的 EULA 页面 @@ -47,12 +47,12 @@ title: 手机直装模板 ### 默认主题颜色 -文件：`FCLLibrary/src/main/java/com/tungsten/fcllibrary/component/theme/ThemeEngine.java` +文件：`FCLLibrary/src/main/java/com/tungsten/fcllibrary/component/theme/ThemeEngine.java 位置：`getDefaultColor` ### 删除多余的 Java -路径：`FCL/src/main/assets/app_runtime/java/` +路径：`FCL/src/main/assets/app_runtime/java/` 不需要哪个就删哪个，只留自己客户端需要的那个即可 ### 背景图 @@ -69,13 +69,13 @@ title: 手机直装模板 删掉 `android:visibility="gone"` 即可在主页面显示 FCL 的皮肤展示 -在该文件中还可以给主页面加任意组件，如果需要加点击事件 +在该文件中还可以给主页面加任意组件，如果需要加点击事件 文件：`FCL/src/main/java/com/tungsten/fcl/ui/main/MainUI.java` ### 创建账户页面 -(离线登录，离线账户用户名的规则) -文件：`FCL/src/main/java/com/tungsten/fcl/ui/account/CreateAccountDialog.java` +(离线登录，离线账户用户名的规则) +文件：`FCL/src/main/java/com/tungsten/fcl/ui/account/CreateAccountDialog.java` 位置：`USERNAME_CHECKER_PATTERN` 默认的规则是，允许中文、英文、数字、下划线 @@ -100,7 +100,7 @@ title: 手机直装模板 更新策略是，删除原有的所有文件，再释放安装包内文件。 -为了避免**安装包太大**，建议打包的客户端删除 libraries 和 assets，否则过大的安装包，会导致储存空间占用翻倍、增加使用门槛，且让玩家失去下载安装包的耐心。 +为了避免 **安装包太大**，建议打包的客户端删除 libraries 和 assets，否则过大的安装包，会导致储存空间占用翻倍、增加使用门槛，且让玩家失去下载安装包的耐心。 ### 显示公告 @@ -118,9 +118,9 @@ title: 手机直装模板 ## 构建 -首先你需要安装 Android Studio，使用 git 命令克隆仓库 +首先你需要安装 Android Studio，使用 `git` 命令克隆仓库 -```shell +```bash git clone https://github.com/MrXiaoM/FoldCraftLauncher ``` diff --git a/docs-java/process/mobile-player/client/Pojav_Android.md b/docs-java/process/mobile-player/client/pojav-android.md similarity index 92% rename from docs-java/process/mobile-player/client/Pojav_Android.md rename to docs-java/process/mobile-player/client/pojav-android.md index 6a7e76ff3..f83739f3e 100644 --- a/docs-java/process/mobile-player/client/Pojav_Android.md +++ b/docs-java/process/mobile-player/client/pojav-android.md @@ -7,9 +7,9 @@ sidebar_position: 1 :::warning -PojavLauncher已于2025年5月17日宣布停更 +PojavLauncher 已于 2025 年 5 月 17 日宣布停更 -建议使用Amethyst或者FCL替代PojavLauncher +建议使用 Amethyst 或者 FCL 替代 PojavLauncher ::: diff --git a/docs-java/process/mobile-player/client/Pojav_iOS.md b/docs-java/process/mobile-player/client/pojav-ios.md similarity index 72% rename from docs-java/process/mobile-player/client/Pojav_iOS.md rename to docs-java/process/mobile-player/client/pojav-ios.md index 16a3ea6d1..7bfaa3921 100644 --- a/docs-java/process/mobile-player/client/Pojav_iOS.md +++ b/docs-java/process/mobile-player/client/pojav-ios.md @@ -7,9 +7,9 @@ sidebar_position: 2 :::warning -PojavLauncher已于2025年5月17日宣布停更 +PojavLauncher 已于 2025 年 5 月 17 日宣布停更 -建议使用Amethyst或者FCL替代PojavLauncher +建议使用 Amethyst 或者 FCL 替代 PojavLauncher ::: @@ -28,12 +28,15 @@ PojavLauncher已于2025年5月17日宣布停更 从此 [链接](https://github.com/PojavLauncherTeam/PojavLauncher_iOS/releases) 下载 Pojav 的 ipa 安装包 在手机上的牛蛙助手中导入 ipa 文件 + ![](../_images/1.PNG) 点击签名进行自签 (刚开始用自签会被封号，不会很严重修改密码就好了，自签只有一周的使用时间，过了时间要重新签名) + ![](../_images/2.PNG) 点击进行安装 + ![](../_images/3.PNG) ### 启动 PojavLauncher @@ -43,11 +46,14 @@ PojavLauncher已于2025年5月17日宣布停更 ### 补充 安装完之后若点击程序出现未受信任的提示 + ![](../_images/trollstone_i.png) + 请打开设置 → 通用 → VPN 与设备管理， 点击对应的配置描述文件信任它 若牛蛙提示下图，就按它说的打开牛蛙的 VPN + ![](../_images/4.PNG) ## 方法二：使用 TrollStore @@ -70,11 +76,11 @@ PojavLauncher已于2025年5月17日宣布停更 - iOS14-beta2～iOS14.8.1 的系统 (A8～A11 处理器) - iOS15.5 系统 (A9～A11 处理器) -- iOS15.6 beta4～iOS15.6.1(A9～A11 处理器) -- iOS15.7～iOS15.8.2(A9～A17，M1～M2 处理器) -- iOS16 beta1～beta3(A9～A11 处理器) -- iOS16 beta4～iOS16.6.1(A9 以上，M1～M2 处理器) -- iOS17 beta1～beta4(A9～A11 处理器) +- iOS15.6 beta4～iOS15.6.1( A9～A11 处理器) +- iOS15.7～iOS15.8.2 (A9～A17，M1～M2 处理器) +- iOS16 beta1～beta3 (A9～A11 处理器) +- iOS16 beta4～iOS16.6.1 (A9 以上，M1～M2 处理器) +- iOS17 beta1～beta4 (A9～A11 处理器) 那么 [点此查看](https://ios.cfw.guide/installing-trollstore-trollinstallerx/) TrollInstallerX 的安装方法。 **(非常之复杂，怕麻烦的，没电脑的，没有苹果官方 Type C 转 Lighting 或者 C2C 的线的，但是又只能用这个方法安装 TrollStore 的劝退)** @@ -82,54 +88,60 @@ PojavLauncher已于2025年5月17日宣布停更 如果你是： - iOS14-beta2～iOS14.8.1 的系统 (A12 以上，M1～M2 处理器) -- iOS15～iOS15.5 beta4(A8 以上，M1～M2 处理器) +- iOS15～iOS15.5 beta4 (A8 以上，M1～M2 处理器) - iOS15.5 系统 (A12 以上，M1～M2 处理器) -- iOS15.6 beta4～iOS15.6.1(A12 以上，M1～M2 处理器) -- iOS16 beta1～beta3(A12 以上，M1～M2 处理器) +- iOS15.6 beta4～iOS15.6.1 (A12 以上，M1～M2 处理器) +- iOS16 beta1～beta3 (A12 以上，M1～M2 处理器) 那么复制此链接到你的 Safari 浏览器地址栏 `itms-services://?action=download-manifest&url=https://jailbreaks.app/cdn/plists/TrollHelper.plist` -以此安装 TrollHelperOTA，然后**按顺序**点击 Register Persistence Helper 和 Install TrollStore 即可安装。**(期间可能黑屏或重启。)** +以此安装 TrollHelperOTA，然后 **按顺序** 点击 Register Persistence Helper 和 Install TrollStore 即可安装。**(期间可能黑屏或重启。)** 如果你是： -- iOS16.7RC(A9～A11 处理器) -- iOS17 beta5～iOS17.0(A9～A11 处理器) +- iOS16.7RC (A9～A11 处理器) +- iOS17 beta5～iOS17.0 (A9～A11 处理器) -那么你需要一个**已经越狱了**的苹果设备按照 [这个教程](https://ios.cfw.guide/installing-trollstore-trollhelper/) 使用 TrollHelper 安装 TrollStore。 +那么你需要一个 **已经越狱了** 的苹果设备按照 [这个教程](https://ios.cfw.guide/installing-trollstore-trollhelper/) 使用 TrollHelper 安装 TrollStore。 ~~(你手机都越狱了还用 TrollStore 干嘛，直接用其他 ipa/dpkg 包管理安装 Pojav~~ 如果你是： -- iOS15.5(A8 处理器) -- iOS15.6 beta4～iOS15.6.1(A8 处理器) +- iOS15.5 (A8 处理器) +- iOS15.6 beta4～iOS15.6.1 (A8 处理器) 那么 [点此查看](https://ios.cfw.guide/installing-trollstore-trollinstallermdc/) TrollInstallerMDC 的安装方法。 **(较复杂，怕麻烦的，没电脑的，没有苹果官方 Type C 转 Lighting 或者 C2C 的线的，但是又只能用这个方法安装 TrollStore 的劝退)** 如果你是： -- iOS15.7.2～iOS15.8.2(A8 处理器) +- iOS15.7.2～iOS15.8.2 (A8 处理器) 那么 [点此查看](https://ios.cfw.guide/installing-trollstore-trollmisaka) TrollMisaka 的安装方法。 **(也挺复杂，怕麻烦的，没电脑的，没有苹果官方 Type C 转 Lighting 或者 C2C 的线的，但是又只能用这个方法安装 TrollStore 的劝退)**
-总之，当你~~终于~~历经千辛万苦安装完 TrollStore 之后，你的内心可能痛苦，可能舒畅；但不管怎么样，最痛苦的过程结束了，后面的 Pojav 安装将会异常轻松。 +总之，当你 ~~终于~~ 历经千辛万苦安装完 TrollStore 之后，你的内心可能痛苦，可能舒畅；但不管怎么样，最痛苦的过程结束了，后面的 Pojav 安装将会异常轻松。 ![](../_images/troll-icon.jpg) 现在你应该能看见这个图标了。 现在，你需要从 [此链接](https://github.com/PojavLauncherTeam/PojavLauncher_iOS/actions) 下载 PojavLauncher 的 ipa 安装包。 -下载的时候有**两个注意事项**：1.你需要一个 GitHub 账号，不然你没法在 Actions 里面下载东西。2.你使用的是 TrollStore 方案，那么就下载 `net.kdt.pojavlauncher-ios-trollstore.tipa`，~~别告诉我你用的是 TVOS~~。 +下载的时候有 **两个注意事项**： + +1. 你需要一个 GitHub 账号，不然你没法在 Actions 里面下载东西。 +2. 你使用的是 TrollStore 方案，那么就下载 `net.kdt.pojavlauncher-ios-trollstore.tipa`，~~别告诉我你用的是 TVOS~~。 下载完 Pojav 安装包后，我们来到 TrollStore 里面。 + ![](../_images/troll-idid.PNG) + 咱们要打开 ldid，以确保能正常安装没有签名的安装包。 然后回到主界面，点击右上角加号，选择你刚刚下载的 tipa 文件，点击，然后就会安装，安装完之后差不多是这样的。 + ![](../_images/troll-ui.PNG) ~~(你不用管 DolphiniOS 干什么的，这是用来玩老游戏的模拟器)~~ diff --git a/docs-java/process/mobile-player/Geyser/_images/geyser.png b/docs-java/process/mobile-player/geyser/_images/geyser.png similarity index 100% rename from docs-java/process/mobile-player/Geyser/_images/geyser.png rename to docs-java/process/mobile-player/geyser/_images/geyser.png diff --git a/docs-java/process/mobile-player/Geyser/geyser.md b/docs-java/process/mobile-player/geyser/geyser.md similarity index 100% rename from docs-java/process/mobile-player/Geyser/geyser.md rename to docs-java/process/mobile-player/geyser/geyser.md diff --git a/docs-java/process/mobile-player/Geyser/introduction/_image/VersionChoose.png b/docs-java/process/mobile-player/geyser/introduction/_image/VersionChoose.png similarity index 100% rename from docs-java/process/mobile-player/Geyser/introduction/_image/VersionChoose.png rename to docs-java/process/mobile-player/geyser/introduction/_image/VersionChoose.png diff --git a/docs-java/process/mobile-player/Geyser/introduction/FAQ.md b/docs-java/process/mobile-player/geyser/introduction/faq.md similarity index 87% rename from docs-java/process/mobile-player/Geyser/introduction/FAQ.md rename to docs-java/process/mobile-player/geyser/introduction/faq.md index 66338cb2d..70be163b7 100644 --- a/docs-java/process/mobile-player/Geyser/introduction/FAQ.md +++ b/docs-java/process/mobile-player/geyser/introduction/faq.md @@ -25,12 +25,12 @@ Java 版和基岩版的 UUID 不一致，请查阅进阶教程 ## frp 搭建内网穿透想显示真实 IP 怎么办 -在 frp 中[开启 proxy protocol](/advance/frp#配置-proxy-protocol) +在 frp 中[开启 PROXY protocol](/advance/frp#配置-proxy-protocol) 后，在配置文件里将 enable-proxy-protocol 设置为 true。后续如果不再使用内网穿透，**一定记得把这个配置改回 false** ## 皮肤不显示怎么办 -这可能是因为你在安装 floodgate 后又安装了额外的皮肤组件导致的 +这可能是因为你在安装 Floodgate 后又安装了额外的皮肤组件导致的 请查阅进阶教程 ## 头颅不显示怎么办 @@ -55,7 +55,7 @@ Java 版和基岩版的 UUID 不一致，请查阅进阶教程 - **手贱开启 enable-proxy-protocol** -如果你不使用像 TCPShield、frp 的反向代理，请保证你的 enable-proxy-protocol 选项是设置为 false 的 +如果你不使用像 TCPShield、frp 的反向代理，请保证你的 `enable-proxy-protocol` 选项是设置为 `false` 的 - **启动时提示 java.net.BindException: Address already in use: bind** @@ -65,7 +65,7 @@ Java 版和基岩版的 UUID 不一致，请查阅进阶教程 这通常和你的主机端的端口有关。最常见的是，跟 Java 版的常用的 TCP 协议的端口不同，你的主机很有可能没有开放基岩版所使用的 UDP 协议的端口。 -一个确认此问题的方法是关闭你的服务器，然后选择其他 基岩版服务端，例如 Nukkit(你不一定非要用 Nukkit) 以检查是否是该问题导致的 +一个确认此问题的方法是关闭你的服务器，然后选择其他 基岩版服务端，例如 Nukkit (你不一定非要用 Nukkit) 以检查是否是该问题导致的 - **尝试重启服务器和游戏** @@ -83,7 +83,7 @@ Java 版和基岩版的 UUID 不一致，请查阅进阶教程 ## 加入服务器后出现区块空白 -如果你的服务器使用的是 Java 18 以下并且 CPU 支持 AVX512(通常来说是 Intel 10 代以上和 AMD),你可以尝试添加启动参数 +如果你的服务器使用的是 Java 18 以下并且 CPU 支持 AVX512 (通常来说是 Intel 10 代以上和 AMD)，你可以尝试添加启动参数 ```text -XX:+UnlockDiagnosticVMOptions -XX:-UseAESCTRIntrinsics @@ -100,4 +100,4 @@ Java 版和基岩版的 UUID 不一致，请查阅进阶教程 可以在服务器上安装 [SeeMore](https://modrinth.com/plugin/seemore) 来解决这个问题 -如果还不行，你可以升级**电脑配置** +如果还不行，你可以升级 **电脑配置** diff --git a/docs-java/process/mobile-player/Geyser/introduction/install.md b/docs-java/process/mobile-player/geyser/introduction/install.md similarity index 87% rename from docs-java/process/mobile-player/Geyser/introduction/install.md rename to docs-java/process/mobile-player/geyser/introduction/install.md index 5202e44f2..4e79abd71 100644 --- a/docs-java/process/mobile-player/Geyser/introduction/install.md +++ b/docs-java/process/mobile-player/geyser/introduction/install.md @@ -10,7 +10,7 @@ sidebar_position: 2 Geyser 有以下版本类型： - Spigot -- Bungeecord +- BungeeCord - Velocity - Fabric - NeoForge @@ -21,7 +21,7 @@ Geyser 有以下版本类型： Spigot 版本 可以作为插件安装在以 Spigot 及其分叉 (如 Paper) 为核心的服务端上 -Bungeecord、Velocity 和 ViaProxy 版本 可以作为插件安装在这些代理端上 +BungeeCord、Velocity 和 ViaProxy 版本 可以作为插件安装在这些代理端上 Fabric 和 NeoForge 版本 可以作为模组安装在这些模组端上 @@ -32,9 +32,9 @@ Standalone 版本 可以作为一个独立的代理端启动 在安装前，你需要找到合适的 Geyser 版本，你可以参考下图： ![version](_image/VersionChoose.png) -- 1、运行独立版**仍需要 Java16**及以上环境，只不过你可以将其和目标服务器所处的 Java 环境隔开 此外**在任何情况下**，你都可使用独立版，甚至独立版可以和其目标不在同一服务器上 +- 1、运行独立版 **仍需要 Java16** 及以上环境，只不过你可以将其和目标服务器所处的 Java 环境隔开 此外 **在任何情况下**，你都可使用独立版，甚至独立版可以和其目标不在同一服务器上 - 2、你可以通过 ViaVersion 插件来适配版本，这会允许不同版本的玩家进入服务器，不过问题不大 -- 3、[Hydraulic](https://github.com/GeyserMC/Hydraulic) 可以允许你加入带客户端模组的服务器，但是项目处于**早期开发阶段**，你可以做个尝试，但是请不要在实际情况下使用 +- 3、[Hydraulic](https://github.com/GeyserMC/Hydraulic) 可以允许你加入带客户端模组的服务器，但是项目处于 **早期开发阶段**，你可以做个尝试，但是请不要在实际情况下使用 ## 下载 @@ -107,7 +107,7 @@ remote: **`port`**:(重要选项) 请和目标服务器 (插件版必须与`server-port`一致) 一致对外开放的端口一致 -**`auth-type`**：有 offline/online 和 floodgate 模式，offline 和 online 分别对应离线和正版，你目标服务器用的什么就选什么，floodgate 会在后续教程中解释 +**`auth-type`**：有 offline/online 和 floodgate 模式，offline 和 online 分别对应离线和正版，你目标服务器用的什么就选什么，Floodgate 会在后续教程中解释 ### 其他项 @@ -131,7 +131,7 @@ above-bedrock-nether-building: false **`passthrough-player-counts`**：将玩家数量和最大玩家数量发给基岩玩家 -**`show-cooldown`**：由于基岩版没有战斗冷却，此功能会模拟一个冷却提示器，你可以设置为 title(小标题)、actionbar(物品栏上方的标题) 或 false(关闭) +**`show-cooldown`**：由于基岩版没有战斗冷却，此功能会模拟一个冷却提示器，你可以设置为 title (小标题)、actionbar (物品栏上方的标题) 或 false (关闭) **`show-coordinates`**：是否向玩家显示坐标 @@ -139,14 +139,14 @@ above-bedrock-nether-building: false ## floodagte -为进一步兼容，你需要安装 [floodgate](https://geysermc.org/download#floodgate),[MCSL 下载镜像](https://sync.mcsl.com.cn/core/Floodgate) +为进一步兼容，你需要安装 [Floodgate](https://geysermc.org/download#floodgate)，[MCSL 下载镜像](https://sync.mcsl.com.cn/core/Floodgate) -Mod 服务器请安装[Floodgate-Modded](https://modrinth.com/mod/floodgate),适用于 Mod 的 Floodgate +mod 服务器请安装 [Floodgate-Modded](https://modrinth.com/mod/floodgate)，适用于 mod 的 Floodgate -floodgate 可作为一个插件/Mod 装到 Spigot 及其分支的核心上或 BungeeCord、Velocity 之类的代理上 +Floodgate 可作为一个插件/mod 装到 Spigot 及其分支的核心上或 BungeeCord、Velocity 之类的代理上 群组服/独立版 Geyser 的 Floodgate 安装需要进行一些额外步骤，请跟随教程完成 -floodgate 是一个允许 **Minecraft 基岩版** 帐号加入 **Minecraft Java 版** 正版服务器而无需其 **正版账号** 的混合模式插件 +Floodgate 是一个允许 **Minecraft 基岩版** 帐号加入 **Minecraft Java 版** 正版服务器而无需其 **正版账号** 的混合模式插件 但 **不止于此** @@ -158,7 +158,7 @@ floodgate 是一个允许 **Minecraft 基岩版** 帐号加入 **Minecraft Java - 提供一个通用的 API，使更多插件可以兼容基岩版玩家 - 以基岩版 XUID 作为 UUID 储存数据，使在基岩版玩家改名后不丢失数据 -所以就算**非正版服务器**，也有**必要**安装此插件来获取更强大的兼容性 +所以就算 **非正版服务器**，也有 **必要** 安装此插件来获取更强大的兼容性 此外，Floodgate 有个小缺点，在安装之后你无法直接使基岩版玩家和 Java 版玩家数据互通，这将在进阶教程中给出两个可行的解决办法 @@ -192,7 +192,7 @@ username-prefix: "." 若是遇到重名，则会出现一个 ID 拥有两个完全不同的 UUID，这可能会发生一些无法预知的错误，而使用 `.` 前缀是因为 Java 正版玩家名中不可使用 `.` **但是** -这在离线服中，有几个问题: +这在离线服中，有几个问题： - 离线服玩家名是可以任意修改的，所以 Java 玩家一样可以使用相同前缀进入服务器 - 部分登录插件会禁止诸如带有 `.` 玩家名的玩家进入服务器，这会导致基岩版玩家无法进入服务器 @@ -256,7 +256,7 @@ send-floodgate-data: true ::: -下载[脚本](https://script.8aka.org/geyser-egg)，为你自动生成 Geyser 环境，免于配置 +下载 [脚本](https://script.8aka.org/geyser-egg)，为你自动生成 Geyser 环境，免于配置 即使不用配置，你仍然需要看完 wiki，**明白你在做什么** diff --git a/docs-java/process/mobile-player/Geyser/introduction/introduction.md b/docs-java/process/mobile-player/geyser/introduction/introduction.md similarity index 100% rename from docs-java/process/mobile-player/Geyser/introduction/introduction.md rename to docs-java/process/mobile-player/geyser/introduction/introduction.md diff --git a/docs-java/process/mobile-player/Geyser/introduction/overview.md b/docs-java/process/mobile-player/geyser/introduction/overview.md similarity index 78% rename from docs-java/process/mobile-player/Geyser/introduction/overview.md rename to docs-java/process/mobile-player/geyser/introduction/overview.md index fc0d94ed8..8828df565 100644 --- a/docs-java/process/mobile-player/Geyser/introduction/overview.md +++ b/docs-java/process/mobile-player/geyser/introduction/overview.md @@ -15,9 +15,9 @@ sidebar_position: 1 `MC 百科`：https://www.mcmod.cn/class/9757.html -`文档(英文)`：https://wiki.geysermc.org/ +`文档 (英文)`：https://wiki.geysermc.org/ -`文档(中文)`：https://docs.superiormc.cn/v/geyser-wiki +`文档 (中文)`：https://docs.superiormc.cn/v/geyser-wiki ::: @@ -25,7 +25,7 @@ Geyser 是连接 Java 版和基岩版 的一座桥梁。可以让基岩版玩家 :::danger -Geyser 并不适合 Mod 服务器，不要尝试 +Geyser 并不适合 mod 服务器，不要尝试 ::: diff --git a/docs-java/process/mobile-player/Geyser/Upgrade/_image/CIMM1.jpg b/docs-java/process/mobile-player/geyser/upgrade/_images/CIMM1.jpg similarity index 100% rename from docs-java/process/mobile-player/Geyser/Upgrade/_image/CIMM1.jpg rename to docs-java/process/mobile-player/geyser/upgrade/_images/CIMM1.jpg diff --git a/docs-java/process/mobile-player/Geyser/Upgrade/_image/CIMM2.jpg b/docs-java/process/mobile-player/geyser/upgrade/_images/CIMM2.jpg similarity index 100% rename from docs-java/process/mobile-player/Geyser/Upgrade/_image/CIMM2.jpg rename to docs-java/process/mobile-player/geyser/upgrade/_images/CIMM2.jpg diff --git a/docs-java/process/mobile-player/Geyser/Upgrade/_image/CIMM3.jpg b/docs-java/process/mobile-player/geyser/upgrade/_images/CIMM3.jpg similarity index 100% rename from docs-java/process/mobile-player/Geyser/Upgrade/_image/CIMM3.jpg rename to docs-java/process/mobile-player/geyser/upgrade/_images/CIMM3.jpg diff --git a/docs-java/process/mobile-player/Geyser/Upgrade/_image/CIMM4.jpg b/docs-java/process/mobile-player/geyser/upgrade/_images/CIMM4.jpg similarity index 100% rename from docs-java/process/mobile-player/Geyser/Upgrade/_image/CIMM4.jpg rename to docs-java/process/mobile-player/geyser/upgrade/_images/CIMM4.jpg diff --git a/docs-java/process/mobile-player/Geyser/Upgrade/_image/Geyser4.png b/docs-java/process/mobile-player/geyser/upgrade/_images/Geyser4.png similarity index 100% rename from docs-java/process/mobile-player/Geyser/Upgrade/_image/Geyser4.png rename to docs-java/process/mobile-player/geyser/upgrade/_images/Geyser4.png diff --git a/docs-java/process/mobile-player/Geyser/Upgrade/Custom-item-model-map.md b/docs-java/process/mobile-player/geyser/upgrade/custom-item-model-map.md similarity index 73% rename from docs-java/process/mobile-player/Geyser/Upgrade/Custom-item-model-map.md rename to docs-java/process/mobile-player/geyser/upgrade/custom-item-model-map.md index 64f4c8b98..4afb25cbb 100644 --- a/docs-java/process/mobile-player/Geyser/Upgrade/Custom-item-model-map.md +++ b/docs-java/process/mobile-player/geyser/upgrade/custom-item-model-map.md @@ -9,7 +9,7 @@ Geyser 提供了自定义物品映射功能，可以为 CustomModelData 物品 ## Kas-tle 的 java2bedrock -java2bedrock.sh(俗称转换器) 是一个自动资源包转换工具，可以将 JAVA 版的资源包转化成基岩版资源包的工具 +java2bedrock.sh (俗称转换器) 是一个自动资源包转换工具，可以将 Java 版的资源包转化成基岩版资源包的工具 :::tip @@ -25,33 +25,33 @@ java2bedrock.sh(俗称转换器) 是一个自动资源包转换工具，可以 :::tip -转换器需要在 linux 系统上运行，如果你使用 WINDOWS，你可以选择 wsl 或者虚拟机 +转换器需要在 Linux 系统上运行，如果你使用 Windows，你可以选择 WSL 或者虚拟机 ::: 本地运行你只需要执行 -```shell +```bash ./converter.sh 资源包名称.zip ``` -如果你需要更加复杂的转换，请查看项目的 Github +如果你需要更加复杂的转换，请查看项目的 GitHub ### 在线转换 :::tip -你需要拥有一个 GitHUB 账号才可以 +你需要拥有一个 GitHub 账号才可以 ::: #### 操作步骤 - 首先你需要新建一个 Issue -- 在类型选择**Pack Conversion** -- 在**Java Pack Direct Download URL** 填上你的资源包下载地址 (不能是网盘，要求是直链) +- 在类型选择 **Pack Conversion** +- 在 **Java Pack Direct Download URL** 填上你的资源包下载地址 (不能是网盘，要求是直链) - 最后勾上最下面的用户协议，点击开始就可以 -- 转换好后，有个机器人会提醒你去 Github Action 下载，下载就来就是转换好的基岩版资源包 +- 转换好后，有个机器人会提醒你去 GitHub Action 下载，下载就来就是转换好的基岩版资源包 ### 字体图像转换 @@ -59,7 +59,7 @@ AZPixel-Team 的 Java2Bedrock :::tip -注意！字体偏移是 Java 版独有的，基岩版没有这个功能，因此一些利用字体偏移做到的东西 (如 IA 菜单) 无法正常显示，但你可以通过万能的 jsonui 来实现，或者给大佬爆金币定制基岩 jsonui +注意！字体偏移是 Java 版独有的，基岩版没有这个功能，因此一些利用字体偏移做到的东西 (如 IA 菜单) 无法正常显示，但你可以通过万能的 JSON UI 来实现，或者给大佬爆金币定制基岩 JSON UI 我非常建议使用这个来管理基岩版的字体资源包，否则你的字体图像管理是非常痛苦的 @@ -69,7 +69,7 @@ AZPixel-Team 的 Java2Bedrock 与上面没有区别 -- 但是在填写资源包下载地址地方的下面，要把`Font Conversion`选项设置为 Ture +- 但是在填写资源包下载地址地方的下面，要把 `Font Conversion` 选项设置为 `true` [项目地址](https://github.com/AZPixel-Team/Java2Bedrock) @@ -77,25 +77,25 @@ AZPixel-Team 的 Java2Bedrock :::tip -此教程需要你有一定的动手和理解基岩版资源包结构，你可以动脑去看[基岩版资源包模板](https://github.com/Mojang/bedrock-samples/releases)学习 +此教程需要你有一定的动手和理解基岩版资源包结构，你可以动脑去看 [基岩版资源包模板](https://github.com/Mojang/bedrock-samples/releases) 学习 -此教程假设你已能熟练使用 ItemsAdder 插件、并且正在边看[Geyser Wiki](https://wiki.geysermc.org/geyser/custom-items/)边看这文档学着做 +此教程假设你已能熟练使用 ItemsAdder 插件、并且正在边看 [Geyser Wiki](https://wiki.geysermc.org/geyser/custom-items/) 边看这文档学着做 ::: ### 物品映射 -这里我非常推荐使用[Geyser Wiki](https://wiki.geysermc.org/geyser/custom-items/)中的 Json 映射方式，方便编写和修改 +这里我非常推荐使用 [Geyser Wiki](https://wiki.geysermc.org/geyser/custom-items/) 中的 JSON 映射方式，方便编写和修改 #### 注册物品行为 这是一个律师勋章，我想让他在基岩版上也显示 -![](./_image/CIMM1.jpg) +![](./_images/CIMM1.jpg) -我们来到 `服务端/plugins/geyser/custom_mappings` 目录，创建一个 json 文件用于 Geyser 映射自定义物品 +我们来到 `服务端/plugins/geyser/custom_mappings` 目录，创建一个 JSON 文件用于 Geyser 映射自定义物品 -![](./_image/CIMM2.jpg) +![](./_images/CIMM2.jpg) 名字可以根据自己喜好起，我这里命名为 `test_item.json`。 @@ -103,7 +103,7 @@ AZPixel-Team 的 Java2Bedrock 回到游戏，手持律师勋章，执行 `/iatag` 指令 -![](./_image/CIMM3.jpg) +![](./_images/CIMM3.jpg) 我们看到他的 `ID` 是 `minecraft:paper`，以及 `CustomModelData(简称CMD)` 值是 10534 @@ -127,7 +127,7 @@ AZPixel-Team 的 Java2Bedrock } ``` -json 文件不允许有注释，如果你要复制过去记得删除注释 +JSON 文件不允许有注释，如果你要复制过去记得删除注释 保存，然后我们的自定义物品 Geyser 已经注册好了，接下来是基岩版资源包方面的教程 @@ -143,7 +143,7 @@ json 文件不允许有注释，如果你要复制过去记得删除注释 现在在 `资源包/textures` 目录下，创建个 `item_textures.json` 文件用于指定物品的纹理 -![](./_image/CIMM4.jpg) +![](./_images/CIMM4.jpg) 在 `item_textures.json` 中写入 diff --git a/docs-java/process/mobile-player/Geyser/Upgrade/Extended/_image/Geyser5.png b/docs-java/process/mobile-player/geyser/upgrade/extended/_images/Geyser5.png similarity index 100% rename from docs-java/process/mobile-player/Geyser/Upgrade/Extended/_image/Geyser5.png rename to docs-java/process/mobile-player/geyser/upgrade/extended/_images/Geyser5.png diff --git a/docs-java/process/mobile-player/Geyser/Upgrade/Extended/_image/GeyserExtras.gif b/docs-java/process/mobile-player/geyser/upgrade/extended/_images/GeyserExtras.gif similarity index 100% rename from docs-java/process/mobile-player/Geyser/Upgrade/Extended/_image/GeyserExtras.gif rename to docs-java/process/mobile-player/geyser/upgrade/extended/_images/GeyserExtras.gif diff --git a/docs-java/process/mobile-player/Geyser/Upgrade/Extended/_image/img.png b/docs-java/process/mobile-player/geyser/upgrade/extended/_images/img.png similarity index 100% rename from docs-java/process/mobile-player/Geyser/Upgrade/Extended/_image/img.png rename to docs-java/process/mobile-player/geyser/upgrade/extended/_images/img.png diff --git a/docs-java/process/mobile-player/Geyser/Upgrade/Extended/_image/img_1.png b/docs-java/process/mobile-player/geyser/upgrade/extended/_images/img_1.png similarity index 100% rename from docs-java/process/mobile-player/Geyser/Upgrade/Extended/_image/img_1.png rename to docs-java/process/mobile-player/geyser/upgrade/extended/_images/img_1.png diff --git a/docs-java/process/mobile-player/Geyser/Upgrade/Extended/compatible.md b/docs-java/process/mobile-player/geyser/upgrade/extended/compatible.md similarity index 88% rename from docs-java/process/mobile-player/Geyser/Upgrade/Extended/compatible.md rename to docs-java/process/mobile-player/geyser/upgrade/extended/compatible.md index e67918218..7ed248f79 100644 --- a/docs-java/process/mobile-player/Geyser/Upgrade/Extended/compatible.md +++ b/docs-java/process/mobile-player/geyser/upgrade/extended/compatible.md @@ -17,15 +17,15 @@ sidebar_position: 3 #玩家加入服务器后执行事件 on join: trigger: - #如果玩家是通过 floodgate 加入服务器就让控制台执行此指令 + #如果玩家是通过 Floodgate 加入服务器就让控制台执行此指令 if player is from floodgate: make console execute command "say 欢迎基岩版玩家 %player% 加入服务器!" #如不是就让控制台执行此指令 - else: make console execute command "say 欢迎JAVA版玩家 %player% 加入服务器!" + else: make console execute command "say 欢迎Java版玩家 %player% 加入服务器!" ``` ## LuckBedrock -此插件为 Luckperms 权限管理插件提供了一个额外的情境判断， +此插件为 LuckPerms 权限管理插件提供了一个额外的情境判断， 使你可以设置仅基岩版玩家的权限或仅 Java 版玩家的权限，让你不再因为权限管理而急眼！ diff --git a/docs-java/process/mobile-player/Geyser/Upgrade/Extended/Extended.md b/docs-java/process/mobile-player/geyser/upgrade/extended/extended.md similarity index 70% rename from docs-java/process/mobile-player/Geyser/Upgrade/Extended/Extended.md rename to docs-java/process/mobile-player/geyser/upgrade/extended/extended.md index 83b142d21..a4d973e04 100644 --- a/docs-java/process/mobile-player/Geyser/Upgrade/Extended/Extended.md +++ b/docs-java/process/mobile-player/geyser/upgrade/extended/extended.md @@ -1,10 +1,10 @@ --- -title: Geyser扩展 +title: Geyser 扩展 sidebar_position: 1 slug: /Geyser/Upgrade --- -# Geyser扩展 +# Geyser 扩展 这里是进阶教程，你可以通过进阶教程获得更好的基岩版兼容 让基岩版玩家拥有更加接近原生基岩版服务器的体验 @@ -17,16 +17,16 @@ slug: /Geyser/Upgrade :::warning 基岩版资源包与 Java 版格式完全不同，需要手动进行转换 -基岩版的资源包扩展名均为.mcpack(其实.zip 也行) +基岩版的资源包扩展名均为 `.mcpack` (其实 `.zip` 也行) 资源包转换在后续教程会提及 ::: 此外基岩版不需要额外创建直链下载的链接，直接通过服务器即可传输资源包 -来到`服务端/plugins/geyser-spigot/packs/`目录 +来到 `服务端/plugins/geyser-spigot/packs/` 目录 -将资源包放入 Packs 文件夹后，重载/Geyser reload 或重启服务器即可 +将资源包放入 Packs 文件夹后，重载 `/Geyser reload` 或重启服务器即可 注意！重载 Geyser 来加载资源包可能会导致一些奇怪的问题发生，没事还是建议重启服务器来加载资源包 @@ -38,10 +38,10 @@ GeyserUtils 是 zimzaza4 开发的 Geyser 扩展工具 [下载 GeyserUtils](https://github.com/zimzaza4/GeyserUtils) -把`geyserutils-spigot`放入插件文件夹 +把 `geyserutils-spigot` 放入插件文件夹 -将`geyserutils-geyser`放入 geyser 的`extensions`文件夹 +将 `geyserutils-geyser` 放入 Geyser 的 `extensions` 文件夹 -![](_image/Geyser5.png) +![](./_images/Geyser5.png) 这样就安装好了 diff --git a/docs-java/process/mobile-player/Geyser/Upgrade/Extended/Fix.md b/docs-java/process/mobile-player/geyser/upgrade/extended/fix.md similarity index 89% rename from docs-java/process/mobile-player/Geyser/Upgrade/Extended/Fix.md rename to docs-java/process/mobile-player/geyser/upgrade/extended/fix.md index 64ea6525b..42f58dfa7 100644 --- a/docs-java/process/mobile-player/Geyser/Upgrade/Extended/Fix.md +++ b/docs-java/process/mobile-player/geyser/upgrade/extended/fix.md @@ -67,18 +67,18 @@ GeyserOptionalPack 是一个可选资源包 - 发光箭实体纹理 (没有实体描边渲染 (基岩版本身就没有)，只有箭矢纹理) - 提供超过记分板字符限制的绕过方式 - 隐藏在 Java 版中没有的 UI 元素，例如： - - 制图台中的文本输入字段 - - 创造模式下的 2x2 工作台 - - 命令方块菜单中的时钟延迟和重命名字段 - - Java 版中不存在的结构方块选项 + - 制图台中的文本输入字段 + - 创造模式下的 2x2 工作台 + - 命令方块菜单中的时钟延迟和重命名字段 + - Java 版中不存在的结构方块选项 ## 箱子优化 基岩版原版无法看到 9x1,9x2 等大小的箱子，GeyserMoreRows -可以解决这个问题，[GitHub](https://github.com/GeyserExtensionists/GeyserMoreRows),需要自行构建，不会可以加入 zim 的 +可以解决这个问题，[GitHub](https://github.com/GeyserExtensionists/GeyserMoreRows)，需要自行构建，不会可以加入 zim 的 discord 下载预构建 -下载后还需安装[基岩资源包](https://raw.githubusercontent.com/GeyserExtensionists/GeyserMoreRows/refs/heads/main/MorerowsPack.mcpack) 和 PacketEvents +下载后还需安装 [基岩资源包](https://raw.githubusercontent.com/GeyserExtensionists/GeyserMoreRows/refs/heads/main/MorerowsPack.mcpack) 和 PacketEvents ## 更好的第三人称 @@ -105,7 +105,7 @@ discord 下载预构建 此插件为 Geyser 提供了 JE 攻击冷却指示器样式 -![](_image/GeyserExtras.gif) +![](./_images/GeyserExtras.gif) 还有!: @@ -132,16 +132,16 @@ discord 下载预构建 ## 展示实体修复 正常情况下，展示实体在基岩版无法显示，GeyserDisplayEntity -可以解决这个问题，[GitHub](https://github.com/GeyserExtensionists/GeyserDisplayEntity),需要自行构建，不会可以加入 zim 的 +可以解决这个问题，[GitHub](https://github.com/GeyserExtensionists/GeyserDisplayEntity)，需要自行构建，不会可以加入 zim 的 discord 下载预构建 -该插件对于 IA,ORX 这些插件特别好使，让基岩版玩家不用再看口口了 +该插件对于 IA、ORX 这些插件特别好使，让基岩版玩家不用再看口口了 ## Broadcaster Xbox Live 广播 让服务器在 Xbox Live 上显示为可加入的会话，朋友可以直接从 Xbox 好友列表加入服务器。 -![img.png](_image/img_1.png) +![img.png](./_images/img_1.png) ### 工作原理 @@ -158,7 +158,7 @@ Broadcaster 通过模拟 Xbox Live 客户端，将你的 Geyser/基岩版服务 2. **安装扩展** - ```bash + ```text 服务器根目录/ ├── plugins/ │ └── Geyser-Spigot/ @@ -171,7 +171,8 @@ Broadcaster 通过模拟 Xbox Live 客户端，将你的 Geyser/基岩版服务 4. **查看认证信息** - 服务器启动后，控制台会显示认证码： - ```bash + + ```text To sign in, use a web browser to open the page https://www.microsoft.com/link and enter the code XXXXXXXX to authenticate. ``` @@ -206,7 +207,7 @@ Broadcaster 通过模拟 Xbox Live 客户端，将你的 Geyser/基岩版服务 自定义图片功能允许你为服务器设置专属的展示图片，该图片会在 Xbox Live 好友列表和个人资料页面中显示。 -![](_image/img.png) +![](./_images/img.png) 将制作好的图片重命名为 `screenshot.jpg`,放到配置文件目录即可 diff --git a/docs-java/process/mobile-player/Geyser/Upgrade/Extended/More.md b/docs-java/process/mobile-player/geyser/upgrade/extended/more.md similarity index 92% rename from docs-java/process/mobile-player/Geyser/Upgrade/Extended/More.md rename to docs-java/process/mobile-player/geyser/upgrade/extended/more.md index b35140bc7..f39ff1c7a 100644 --- a/docs-java/process/mobile-player/Geyser/Upgrade/Extended/More.md +++ b/docs-java/process/mobile-player/geyser/upgrade/extended/more.md @@ -23,7 +23,7 @@ sidebar_position: 4 GeyserVoice 是一个 Java 服务端插件，旨在通过集成 VoiceCraft Proximity Chat 应用程序来增强 Minecraft 服务器上的多人游戏体验。该插件允许 Java 和 Bedrock 版本的玩家无缝地参与基于邻近的语音对话。 -[下载](https://github.com/SineVector241/VoiceCraft-MCBE_Proximity_Chat/releases/)，[wiki](https://github.com/mineserv-top/GeyserVoice/wiki/) +[下载](https://github.com/SineVector241/VoiceCraft-MCBE_Proximity_Chat/releases/)，[Wiki](https://github.com/mineserv-top/GeyserVoice/wiki/) ## GeyserPreventServerSwitch @@ -39,7 +39,7 @@ GeyserVoice 是一个 Java 服务端插件，旨在通过集成 VoiceCraft Proxi Boar 使用基岩版客户端的 server-auth-with-rewind 方法，即服务器端移动预测和验证，来检测作弊行为。 -相比于其他反作弊,拥有更好的性能和准确度 +相比于其他反作弊，拥有更好的性能和准确度 ### 安装配置 diff --git a/docs-java/process/mobile-player/Geyser/Upgrade/Geyser-skull.md b/docs-java/process/mobile-player/geyser/upgrade/geyser-skull.md similarity index 92% rename from docs-java/process/mobile-player/Geyser/Upgrade/Geyser-skull.md rename to docs-java/process/mobile-player/geyser/upgrade/geyser-skull.md index df88a0485..fd662d52b 100644 --- a/docs-java/process/mobile-player/Geyser/Upgrade/Geyser-skull.md +++ b/docs-java/process/mobile-player/geyser/upgrade/geyser-skull.md @@ -15,7 +15,7 @@ sidebar_position: 3 ## 如何修复 -要在间歇泉中设置自定义头，你必须选择如何注册你的方块。最简单的方法是使用 custom-skulls.yml +要在间歇泉中设置自定义头，你必须选择如何注册你的方块。最简单的方法是使用 `custom-skulls.yml` ### custom-skulls.yml @@ -57,7 +57,7 @@ skin-hashes： -你只需要提取出你所需要显示的头颅，根据类别添加到配置文件中，然后**重启服务端**，就可以显示 +你只需要提取出你所需要显示的头颅，根据类别添加到配置文件中，然后 **重启服务端**，就可以显示 ### 玩家用户名 @@ -73,7 +73,7 @@ skin-hashes： base64 编码的 JSON。 如果在 Paper 服务器上，则可以通过将项目握在手中并运行命令来获取头骨的此数据。这会将项目的 NBT 数据输出到聊天和控制台。 -纹理字符串位于`SkullOwner`标签下、`Properties`标签下、`textures`标签下。例如：/paper dumpitem +纹理字符串位于 `SkullOwner` 标签下、`Properties` 标签下、`textures` 标签下。例如：`/paper dumpitem` @@ -92,10 +92,10 @@ base64 编码的 JSON。 那么你可能会问，像 Slimefun 那么多，有什么快点的方法吗？当然是有的 -GeyserHeads 是一个小工具，可以提取 Slimefun,DeluxeMenu，手 +GeyserHeads 是一个小工具，可以提取 Slimefun、DeluxeMenu，手 中的头颅并自动保存到配置文件，[下载地址](https://github.com/Hahaa13/GeyserHeads/releases) -使用方法: +使用方法： - `/geyserheads load Slimefun` 导出 Slimefun 头颅 - `/geyserheads load Hand` 导出手上的头颅 diff --git a/docs-java/process/mobile-player/Geyser/Upgrade/GeyserMEG4-supports.md b/docs-java/process/mobile-player/geyser/upgrade/geysermeg4-supports.md similarity index 91% rename from docs-java/process/mobile-player/Geyser/Upgrade/GeyserMEG4-supports.md rename to docs-java/process/mobile-player/geyser/upgrade/geysermeg4-supports.md index 9b6165046..e6d147d88 100644 --- a/docs-java/process/mobile-player/Geyser/Upgrade/GeyserMEG4-supports.md +++ b/docs-java/process/mobile-player/geyser/upgrade/geysermeg4-supports.md @@ -9,7 +9,7 @@ sidebar_position: 6 ## GeyserModelEngine -一个能让你 Geyser 服务器支持 MEG4 的奇妙插件，通过给基岩版发送个史蒂夫发送 4d 皮肤给基岩版玩家，支持原版 Geyser +一个能让你 Geyser 服务器支持 MEG4 的奇妙插件，通过给基岩版发送个史蒂夫发送 4D 皮肤给基岩版玩家，支持原版 Geyser 只需要往资源包里塞动画文件即可，可以有效防止那些进服下个资源包就跑白嫖你模型的贼，但同时限制也挺多 @@ -39,9 +39,9 @@ sidebar_position: 6 :::warning -这个是真自定义实体！不支持原版 Geyser，你需要搭配[Geyser 自定义实体分支](https://github.com/zimzaza4/Geyser)和资源包一起使用才能正常工作 +这个是真自定义实体！不支持原版 Geyser，你需要搭配 [Geyser 自定义实体分支](https://github.com/zimzaza4/Geyser) 和资源包一起使用才能正常工作 -你可以使用`GeyserModelEnginePackGenerator`来自动生成资源包，详细教程看项目地址 +你可以使用 `GeyserModelEnginePackGenerator` 来自动生成资源包，详细教程看项目地址 ::: diff --git a/docs-java/process/mobile-player/Geyser/Upgrade/link.md b/docs-java/process/mobile-player/geyser/upgrade/link.md similarity index 65% rename from docs-java/process/mobile-player/Geyser/Upgrade/link.md rename to docs-java/process/mobile-player/geyser/upgrade/link.md index ca49eb5f0..3fc030815 100644 --- a/docs-java/process/mobile-player/Geyser/Upgrade/link.md +++ b/docs-java/process/mobile-player/geyser/upgrade/link.md @@ -13,7 +13,7 @@ sidebar_position: 4 ::: -GlobalLink 是 Geyser 提供的链接服务器，用于链接基岩版和 Java 版的账户。链接完后将会在**所有**启用全局链接的服务器上生效 +GlobalLink 是 Geyser 提供的链接服务器，用于链接基岩版和 Java 版的账户。链接完后将会在 **所有** 启用全局链接的服务器上生效 :::warning @@ -27,18 +27,18 @@ GlobalLink 是 Geyser 提供的链接服务器，用于链接基岩版和 Java 要链接你的账户，你需要执行以下操作： -1. 使用你的 Java 和 Bedrock 账户加入 GlobalLinkServer +1. 使用你的 Java 和 Bedrock 账户加入 GlobalLinkServer (IP: `link.geysermc.org`，Java 端口：`25565`，Bedrock 端口：`19132`) -2. 在 Java **或** Bedrock 账户上键入`/linkaccount`开始链接过程 +2. 在 Java **或** Bedrock 账户上键入 `/linkaccount` 开始链接过程 3. 你将收到一个带有随机数字的消息，你需要在未开始链接过程的账户上输入该数字。 -4. 在另一个账户上键入`/linkaccount <收到的随机数字>`输入随机数字 +4. 在另一个账户上键入 `/linkaccount <收到的随机数字>` 输入随机数字 5. 你应该在 Bedrock 和 Java 账户上都被踢出服务器，并收到成功链接你的账户的消息。 -要取消全局链接的账户链接，请在 Java 或 Bedrock 上加入 GlobalLinkServer(如上所述进行链接),并使用`/unlinkaccount`命令。 +要取消全局链接的账户链接，请在 Java 或 Bedrock 上加入 GlobalLinkServer (如上所述进行链接)，并使用 `/unlinkaccount` 命令。 默认情况下，每个运行 Floodgate 的服务器应该已启用全局链接，但如果你禁用了它，你可以通过打开 Floodgate 配置： -```yml +```yaml # 玩家链接配置 player-link: # 是否启用链接系统。关闭此选项将阻止玩家使用链接功能，即使他们已经链接。 @@ -50,25 +50,24 @@ player-link: 保存配置并重新启动服务器后，你应该可以使用全局链接。 -如果你不想使用全局链接，可以在 Floodgate 配置中禁用`enable-global-linking`。 +如果你不想使用全局链接，可以在 Floodgate 配置中禁用 `enable-global-linking`。 ## 本地链接 -你还可以在服务器上设置本地链接数据库。本地链接可以与全局链接同时使用。本地数据库中的链接条目将**覆盖**全局链接服务器中的条目。 +你还可以在服务器上设置本地链接数据库。本地链接可以与全局链接同时使用。本地数据库中的链接条目将 **覆盖** 全局链接服务器中的条目。 请注意，如果你有代理（BungeeCord 或 Velocity），则只需在代理上执行以下步骤。 1. 下载链接数据库扩展之一：[这里](https://ci.opencollab.dev/job/GeyserMC/job/Floodgate/job/fix-weird-via-issue/)。 - 选择合适的扩展名：如果你已经有数据库或想要有多代理设置，请选择`mysql`。否则选择`sqlite`。完整名称应为 - `floodgate-*type*-database.jar`。 -2. 将刚下载的数据库扩展 jar 文件复制到 floodgate 插件文件夹中（例如`/plugins/floodgate/`）。 -3. 在 Floodgate 的`player-link`部分中启用`enable-own-linking`。 -4. 在`player-link`部分中将`type`设置为你的数据库类型（目前只能是`mysql`或`sqlite`） + 选择合适的扩展名：如果你已经有数据库或想要有多代理设置，请选择 `mysql`。否则选择 `sqlite`。完整名称应为 `floodgate-*type*-database.jar`。 +2. 将刚下载的数据库扩展 jar 文件复制到 Floodgate 插件文件夹中（例如 `/plugins/floodgate/`）。 +3. 在 Floodgate 的 `player-link` 部分中启用 `enable-own-linking`。 +4. 在 `player-link` 部分中将 `type` 设置为你的数据库类型（目前只能是 `mysql` 或 `sqlite`） 5. 重新启动服务器 -如果你选择了`mysql`，则应在 Floodgate 数据文件夹内生成一个新的数据库数据文件夹。你可以在其中输入数据库凭据。完成后，请再次重新启动服务器。 +如果你选择了 `mysql`，则应在 Floodgate 数据文件夹内生成一个新的数据库数据文件夹。你可以在其中输入数据库凭据。完成后，请再次重新启动服务器。 -就是这样。你可以按照键入`/linkaccount`时收到的说明来链接你的账户。 +就是这样。你可以按照键入 `/linkaccount` 时收到的说明来链接你的账户。 ### ForcePlayerLink diff --git a/docs-java/process/mobile-player/Geyser/Upgrade/Menu.md b/docs-java/process/mobile-player/geyser/upgrade/menu.md similarity index 94% rename from docs-java/process/mobile-player/Geyser/Upgrade/Menu.md rename to docs-java/process/mobile-player/geyser/upgrade/menu.md index 1a1c5c8ca..e26db1f5b 100644 --- a/docs-java/process/mobile-player/Geyser/Upgrade/Menu.md +++ b/docs-java/process/mobile-player/geyser/upgrade/menu.md @@ -11,13 +11,13 @@ sidebar_position: 4 -可以在[GitHub](https://github.com/onebeastchris/MagicMenu/releases/tag/1.0.3) 下载，或者使用[下载镜像](https://dl.8aka.org/plugins/MagicMenu-1.0.3.jar) 下载 +可以在 [GitHub](https://github.com/onebeastchris/MagicMenu/releases/tag/1.0.3) 下载，或者使用 [下载镜像](https://dl.8aka.org/plugins/MagicMenu-1.0.3.jar) 下载 ## 配置 -如果你是一个聪明人，看默认的`config.yml`就能看懂 +如果你是一个聪明人，看默认的 `config.yml` 就能看懂 ````yaml # 查看所有占位符请访问 https://github.com/onebeastchris/MagicMenu/blob/master/setup.md @@ -164,7 +164,7 @@ menus: ## 注意事项 -基岩版菜单中的图片**必须**是 URL，而不是资源包，你可以使用[笨蛋图床](https://image.8aka.org)上传你的图片 +基岩版菜单中的图片 **必须** 是 URL，而不是资源包，你可以使用 [笨蛋图床](https://image.8aka.org) 上传你的图片 ## NPC Form @@ -192,7 +192,7 @@ menus: 专门用于制作商店菜单的插件，[项目地址](https://github.com/kejonaMC/BedrockFormShop) -[下载地址](https://ci.kejonamc.dev/job/BedrockFormShop/job/master/),这是官方[Wiki](https://github.com/kejonaMC/BedrockFormShop/wiki) +[下载地址](https://ci.kejonamc.dev/job/BedrockFormShop/job/master/)，这是官方 [Wiki](https://github.com/kejonaMC/BedrockFormShop/wiki) ### Residence 领地 @@ -230,4 +230,4 @@ zimzaza4 开发的 Skript Geyser 菜单扩展，可以使用 Skript 创建菜单 同时也是目前唯一一个支持 NPC Form 的插件！ -[项目地址](https://github.com/zimzaza4/Skript-Floodgate-Api),安装和使用请查看 readme，建议在使用前读一遍源代码，有些功能没写上去 +[项目地址](https://github.com/zimzaza4/Skript-Floodgate-Api)，安装和使用请查看 README，建议在使用前读一遍源代码，有些功能没写上去 diff --git a/docs-java/process/mobile-player/geyser/upgrade/slimefun.md b/docs-java/process/mobile-player/geyser/upgrade/slimefun.md new file mode 100644 index 000000000..62a1ab7a2 --- /dev/null +++ b/docs-java/process/mobile-player/geyser/upgrade/slimefun.md @@ -0,0 +1,27 @@ +--- +title: 兼容 Slimefun +sidebar_position: 2 +--- + +# 兼容 Slimefun + +:::danger + +想要显示自定义物品纹理，你必须在服务端使用 [粘液科技资源包](https://github.com/xMikux/Slimefun-Resourcepack/releases)，后才可以正常使用 + +::: + +## 下载 + +第一步，下载 [资源包](https://dl.8aka.org/plugins/Slimefun.mcpack)，安装到 `服务端/geyser/packs` 文件夹 + +![](./_images/Geyser4.png) + +第二步，下载 [Mapping](https://dl.8aka.org/plugins/RYSurvival-SlimefunMapping.jar)，安装到 `服务端/geyser/extensions` +文件夹 + +![](./extended/_images/Geyser5.png) + +另一个扩展的 [Slimefun 资源包](https://dl.8aka.org/plugins/slimefun-extension.zip) 下载后全部拖入 Geyser 文件夹即可使用 + +**重启** 服务端即可！ diff --git a/docs-java/process/mobile-player/Geyser/Upgrade/upgrade.md b/docs-java/process/mobile-player/geyser/upgrade/upgrade.md similarity index 75% rename from docs-java/process/mobile-player/Geyser/Upgrade/upgrade.md rename to docs-java/process/mobile-player/geyser/upgrade/upgrade.md index 71b9db48f..abe4d7789 100644 --- a/docs-java/process/mobile-player/Geyser/Upgrade/upgrade.md +++ b/docs-java/process/mobile-player/geyser/upgrade/upgrade.md @@ -1,10 +1,10 @@ --- -title: Geyser进阶 +title: Geyser 进阶 slug: /geyser/upgrade sidebar_position: 2 --- -# Geyser进阶 +# Geyser 进阶 import DocCardList from '@theme/DocCardList'; diff --git a/docs-java/process/mobile-player/mobile-player.md b/docs-java/process/mobile-player/mobile-player.md index c242f04e7..6c9f635f4 100644 --- a/docs-java/process/mobile-player/mobile-player.md +++ b/docs-java/process/mobile-player/mobile-player.md @@ -13,7 +13,7 @@ sidebar_position: 4 使基岩版客户端进入 Java 版服务器的代理软件。 -[点此阅读](/Java/Geyser) 关于 Geyser 的文档。 +[点此阅读](./geyser/geyser.md) 关于 Geyser 的文档。 ## 基岩版客户端下载 diff --git a/docs-java/process/plugin/ManageTool/BasicPlugins/EssentialsX/Q&A.md b/docs-java/process/plugin/ManageTool/BasicPlugins/EssentialsX/Q&A.md deleted file mode 100644 index 98bbbb927..000000000 --- a/docs-java/process/plugin/ManageTool/BasicPlugins/EssentialsX/Q&A.md +++ /dev/null @@ -1,14 +0,0 @@ ---- -title: 常见问题 -sidebar_position: 7 ---- - -# 常见问题 - -## 你没有权限与 xxx 交互。 - -![](../../Permission/_images/日志-1.png) - -🏆来的我不是叫你不要装 ess 全家桶？ - -删了你的 EssentialsXAntiBuild 或者看 [这里](../../Permission/Tips.md) diff --git a/docs-java/process/plugin/ManageTool/BasicPlugins/delete.md b/docs-java/process/plugin/ManageTool/BasicPlugins/delete.md deleted file mode 100644 index 5cc47ebde..000000000 --- a/docs-java/process/plugin/ManageTool/BasicPlugins/delete.md +++ /dev/null @@ -1,18 +0,0 @@ ---- -title: 删掉基础插件 -sidebar_position: 3 ---- - -# 删掉基础插件 - -[CMI](./CMI/) 在拼命的加新功能，多而不精，插件变得臃肿不堪小白比较难上手 - -[EssentialsX](./EssentialsX/) 却在拼命追求稳定性，一点新功能不加的，现在随便个 tpa 插件都有点击聊天框信息同意传送的功能，他却没有，你还不能自己写 json 补 - -也许，是时候删除这俩玩意了 - -实际上，经济功能装个 [XConomy](../../Front-Plugin/XConomy.md) 足够了 - -而对于 tpa，warp，home，back 等传送功能，或许你可以试试 [HuskHomes](https://www.spigotmc.org/resources/.83767/) - -CMI 的那些功能几乎都有可以平替的插件 diff --git a/docs-java/process/plugin/ManageTool/PluginManagement/PlugManX.md b/docs-java/process/plugin/ManageTool/PluginManagement/PlugManX.md deleted file mode 100644 index 160214e52..000000000 --- a/docs-java/process/plugin/ManageTool/PluginManagement/PlugManX.md +++ /dev/null @@ -1,20 +0,0 @@ ---- -title: PlugMan -sidebar_position: 2 ---- - -# PlugMan - -:::info - -`Bukkit(旧)` https://dev.bukkit.org/projects/plugman - -`SpigotMC` https://www.spigotmc.org/resources/.88135/ - -`GitHub(旧)` https://github.com/ryan-clancy/PlugMan - -`GitHub(新)` https://github.com/Test-Account666/PlugManX - -::: - -老牌插件管理插件。 diff --git a/docs-java/process/plugin/WorldManagement/worldgen/_images/terra-community-8.png b/docs-java/process/plugin/WorldManagement/worldgen/_images/terra-community-8.png deleted file mode 100644 index b2479962e..000000000 Binary files a/docs-java/process/plugin/WorldManagement/worldgen/_images/terra-community-8.png and /dev/null differ diff --git a/docs-java/process/plugin/game/Dragon_Core.md b/docs-java/process/plugin/game/dragoncore.md similarity index 82% rename from docs-java/process/plugin/game/Dragon_Core.md rename to docs-java/process/plugin/game/dragoncore.md index c08413dc4..b6bc36fe1 100644 --- a/docs-java/process/plugin/game/Dragon_Core.md +++ b/docs-java/process/plugin/game/dragoncore.md @@ -7,10 +7,10 @@ sidebar_position: 4 ## ![介绍](_images/Dragon_Core/1.jpg) -龙之核心是基于 Minecraft 1.12.2 版本，以插件 (服务端) + MOD(客户端) 的方式， +龙之核心是基于 Minecraft 1.12.2 版本，以插件 (服务端) + mod (客户端) 的方式， 实现了丰富的在服务端制作各种客户端功能的方法。 -与 [萌芽引擎](Germ_Engine.md) 为同类型插件 +与 [萌芽引擎](germengine.md) 为同类型插件 ## 链接 diff --git a/docs-java/process/plugin/game/Germ_Engine.md b/docs-java/process/plugin/game/germengine.md similarity index 86% rename from docs-java/process/plugin/game/Germ_Engine.md rename to docs-java/process/plugin/game/germengine.md index d59b79d67..71a4f3ba6 100644 --- a/docs-java/process/plugin/game/Germ_Engine.md +++ b/docs-java/process/plugin/game/germengine.md @@ -15,14 +15,14 @@ sidebar_position: 5 ## ![介绍](_images/Germ_Engine/6.png) -萌芽引擎是基于 Minecraft 1.12.2 版本，以插件 (服务端) + MOD(客户端) 的方式， +萌芽引擎是基于 Minecraft 1.12.2 版本，以插件 (服务端) + mod (客户端) 的方式， 站在巨人的肩膀上实现了全面且丰富的在服务端制作各种客户端功能的方法。 使用萌芽引擎可以很大的程度拓展游戏内容、提升玩家游玩体验。 他包含了多种功能其主要的有时装渲染、界面拓展、模型、动作、道具拓展…… 萌芽引擎经历了 4 年时间的成长 50 多个版本迭代，目前同时在线客户端超过 5 万， 并且在 300 多台服务器上同时运行。这使得它成为了当今国内 Minecraft 内容制作的潮流。 -与 [龙之核心](Dragon_Core.md) 为同类型插件 +与 [龙之核心](dragoncore.md) 为同类型插件 ## 链接 @@ -40,4 +40,4 @@ sidebar_position: 5 萌芽引擎 JavaDoc：http://javadoc.germmc.com 1.12.2-Bukkit：http://bukkitapi.germmc.com -旧版 WIKI①(已过时)：http://wiki.germmc.com 旧版 WIKI②(已过时)：http://engine.germmc.com +旧版 Wiki① (已过时)：http://wiki.germmc.com 旧版 Wiki② (已过时)：http://engine.germmc.com diff --git a/docs-java/process/plugin/game/Nova.md b/docs-java/process/plugin/game/nova.md similarity index 79% rename from docs-java/process/plugin/game/Nova.md rename to docs-java/process/plugin/game/nova.md index 12ba48663..19b1c38f1 100644 --- a/docs-java/process/plugin/game/Nova.md +++ b/docs-java/process/plugin/game/nova.md @@ -17,10 +17,10 @@ sidebar_position: 2 一个新兴的玩法插件，旨在插件端利用材质包还原 mod 的游戏效果 -启用插件时要下载的依赖非常多，甚至他要把 mc 原版资源包下载下来以备使用 +启用插件时要下载的依赖非常多，甚至他要把 MC 原版资源包下载下来以备使用 下载完成后 Nova 的插件文件夹有一个多 G 建议下载依赖时候挂梯，不然就国内的网络环境嘛 -建议看 MineBBS 搬运贴，图文介绍 + addon 指路 +建议看 MineBBS 搬运贴，图文介绍 + Addon 指路 diff --git a/docs-java/process/plugin/game/Slimefun/AutoUpdate.md b/docs-java/process/plugin/game/slimefun/auto-update.md similarity index 88% rename from docs-java/process/plugin/game/Slimefun/AutoUpdate.md rename to docs-java/process/plugin/game/slimefun/auto-update.md index eed7ffb4d..bd28a507b 100644 --- a/docs-java/process/plugin/game/Slimefun/AutoUpdate.md +++ b/docs-java/process/plugin/game/slimefun/auto-update.md @@ -9,7 +9,7 @@ sidebar_position: 2 1. 修改附属的配置 -将**所有附属插件**的更新关闭 +将 **所有附属插件** 的更新关闭 以 Bump 附属为例： @@ -18,7 +18,7 @@ options: auto-update: false ``` -将 auto-update 设置为 false +将 `auto-update` 设置为 `false` 2. 安装 GuizhanLibPlugin 插件 @@ -26,11 +26,11 @@ options: 3. 修改 GuizhanLibPlugin 的更新配置 -将 auto-update 设置为 true +将 `auto-update` 设置为 `true` -将 location 设置为 cn +将 `location` 设置为 `cn` -(建议) 将 lang 设置为 zh_CN +(建议) 将 `lang` 设置为 `zh_CN` 下方配置供你参考 diff --git a/docs-java/process/plugin/game/Slimefun/WhatLag.md b/docs-java/process/plugin/game/slimefun/find-lag.md similarity index 100% rename from docs-java/process/plugin/game/Slimefun/WhatLag.md rename to docs-java/process/plugin/game/slimefun/find-lag.md diff --git a/docs-java/process/plugin/game/Slimefun/ResourcePackForSlimefun.md b/docs-java/process/plugin/game/slimefun/resourcepack-for-slimefun.md similarity index 60% rename from docs-java/process/plugin/game/Slimefun/ResourcePackForSlimefun.md rename to docs-java/process/plugin/game/slimefun/resourcepack-for-slimefun.md index 12549f043..ef45e906c 100644 --- a/docs-java/process/plugin/game/Slimefun/ResourcePackForSlimefun.md +++ b/docs-java/process/plugin/game/slimefun/resourcepack-for-slimefun.md @@ -7,6 +7,6 @@ sidebar_position: 3 鬼斩的粘液科技材质 (不再更新)：https://ybw0014.net/post/guizhancraft-resource-pack -建议使用 (还提供了 ia 支持)：https://github.com/xMikux/Slimefun-Resourcepack/blob/main/.github/README.zh-cn.md +建议使用 (还提供了 IA 支持)：https://github.com/xMikux/Slimefun-Resourcepack/blob/main/.github/README.zh-cn.md -geyser 可以看 [此处](/docs-java/process/mobile-player/Geyser/Upgrade/Slimefun.md) +Geyser 可以看 [此处](../../../mobile-player/geyser/upgrade/slimefun.md) diff --git a/docs-java/process/plugin/game/Slimefun/Slimefun.md b/docs-java/process/plugin/game/slimefun/slimefun.md similarity index 63% rename from docs-java/process/plugin/game/Slimefun/Slimefun.md rename to docs-java/process/plugin/game/slimefun/slimefun.md index 0471f3a73..ca557a2a5 100644 --- a/docs-java/process/plugin/game/Slimefun/Slimefun.md +++ b/docs-java/process/plugin/game/slimefun/slimefun.md @@ -8,15 +8,15 @@ sidebar_position: 1 :::info -`Bukkit(旧)` https://dev.bukkit.org/projects/slimefun +`Bukkit (旧)` https://dev.bukkit.org/projects/slimefun `MineBBS` https://www.minebbs.com/resources/1-16-1-20-slimefun.7287 -`GitHub(官方)` https://github.com/Slimefun/Slimefun4 +`GitHub (官方)` https://github.com/Slimefun/Slimefun4 -`GitHub(中文)` https://github.com/SlimefunGuguProject/Slimefun4 +`GitHub (中文)` https://github.com/SlimefunGuguProject/Slimefun4 -`非官方中文wiki` https://slimefun-wiki.guizhanss.cn/ +`非官方中文 Wiki` https://slimefun-wiki.guizhanss.cn/ `中文附属插件表` https://slimefun-wiki.guizhanss.cn/Addons @@ -24,7 +24,7 @@ sidebar_position: 1 ::: -一个玩法插件，为你的服务器提供类似 mod 的体验和更低的 TPS(大嘘)。 +一个玩法插件，为你的服务器提供类似 mod 的体验和更低的 TPS (大嘘)。 ## 停止维护 diff --git a/docs-java/process/plugin/game/title/DeluxeTags.md b/docs-java/process/plugin/game/title/deluxetags.md similarity index 100% rename from docs-java/process/plugin/game/title/DeluxeTags.md rename to docs-java/process/plugin/game/title/deluxetags.md diff --git a/docs-java/process/plugin/game/title/MiniPlayerTitle.md b/docs-java/process/plugin/game/title/miniplayertitle.md similarity index 93% rename from docs-java/process/plugin/game/title/MiniPlayerTitle.md rename to docs-java/process/plugin/game/title/miniplayertitle.md index 0d84b9b19..e09996d8e 100644 --- a/docs-java/process/plugin/game/title/MiniPlayerTitle.md +++ b/docs-java/process/plugin/game/title/miniplayertitle.md @@ -30,9 +30,9 @@ sidebar_position: 1 - 本插件支持 PlayerTitle 的 [新版 RGB 颜色格式](https://ricedoc.handyplus.cn/wiki/PlayerTitle/rgb/#新版本格式) （详情见下文） - 支持 PostgresSQL 和 Sqlite 数据库 - 本插件使用 **TUI** 作为简易的交互方式，非 PlayerTitle 的箱子 UI -- 支持设置称号**限量销售、限时销售** +- 支持设置称号 **限量销售、限时销售** - 支持玩家使用称号币自定义称号 -- 支持外部经济系统（需要 Vault 前置支持）（3.0.6+） +- 支持外部经济系统（需要 Vault 前置支持（3.0.6+） - 支持 PlaceholderAPI (4.0.0+) ## 支持版本 diff --git a/docs-java/process/plugin/game/title/MythicPrefixes.md b/docs-java/process/plugin/game/title/mythicprefixes.md similarity index 67% rename from docs-java/process/plugin/game/title/MythicPrefixes.md rename to docs-java/process/plugin/game/title/mythicprefixes.md index a05669551..254f3fbf6 100644 --- a/docs-java/process/plugin/game/title/MythicPrefixes.md +++ b/docs-java/process/plugin/game/title/mythicprefixes.md @@ -13,14 +13,14 @@ sidebar_position: 5 `GitHub` https://github.com/ManyouTeam/MythicPrefixes -`文档(英文)` https://mythicprefixes.superiormc.cn +`文档 (英文)` https://mythicprefixes.superiormc.cn -`文档(中文)` https://docs.superiormc.cn/cha-jian/mian-fei-cha-jian-cheng-hao-you-buff +`文档 (中文)` https://docs.superiormc.cn/cha-jian/mian-fei-cha-jian-cheng-hao-you-buff ::: 国人开发，插件开源 -其 [付费版本](https://www.spigotmc.org/resources/.120329) 与 [免费版本](https://www.spigotmc.org/resources/.100994) 的区别可以在英文维基的[这个页面](https://mythicprefixes.superiormc.cn/info/compare)浏览。 +其 [付费版本](https://www.spigotmc.org/resources/.120329) 与 [免费版本](https://www.spigotmc.org/resources/.100994) 的区别可以在英文维基的 [这个页面](https://mythicprefixes.superiormc.cn/info/compare) 浏览。 如果你用不到较为复杂的条件判断、基岩版菜单和默认前缀功能，那么免费版即可满足你的要求。 diff --git a/docs-java/process/plugin/game/title/PlayerTitle.md b/docs-java/process/plugin/game/title/playertitle.md similarity index 100% rename from docs-java/process/plugin/game/title/PlayerTitle.md rename to docs-java/process/plugin/game/title/playertitle.md diff --git a/docs-java/process/plugin/game/title/UserPrefix.md b/docs-java/process/plugin/game/title/userprefix.md similarity index 75% rename from docs-java/process/plugin/game/title/UserPrefix.md rename to docs-java/process/plugin/game/title/userprefix.md index 8c82c2315..5a4b4dfb8 100644 --- a/docs-java/process/plugin/game/title/UserPrefix.md +++ b/docs-java/process/plugin/game/title/userprefix.md @@ -9,21 +9,12 @@ sidebar_position: 2 ![](./_images/UserPrefix/1.png) - - CodeFactor - - - CodeSize - - - Download - - - Java CI with Maven - - - Support - +[![CodeFactor](https://www.codefactor.io/repository/github/carmjos/userprefix/badge?s=b76fec1f64726b5f19989aace6adb5f85fdab840)](https://www.codefactor.io/repository/github/carmjos/userprefix) +![CodeSize](https://img.shields.io/github/languages/code-size/CarmJos/UserPrefix) +[![Download](https://img.shields.io/github/downloads/CarmJos/UserPrefix/total)](https://github.com/CarmJos/UserPrefix/releases) +[![Java CI with Maven](https://github.com/CarmJos/UserPrefix/actions/workflows/maven.yml/badge.svg?branch=master)](https://github.com/CarmJos/UserPrefix/actions/workflows/maven.yml) +![Support](https://img.shields.io/badge/Minecraft-Java%201.8--Latest-green) +![](https://visitor-badge.glitch.me/badge?page_id=userprefix.readme) 轻便、高效、实时的用户前缀系统。 @@ -56,12 +47,12 @@ sidebar_position: 2 - 简单的聊天变量修改功能！(不推荐使用) `[自 v2.1.0 版本起]` - 自动排序，且可翻页的 GUI！ - 支持 PlaceholderAPI 变量！(凡支持的都可以使用，如 BungeeTabListPlus) -- 支持[Hex 颜色](https://www.hexcolortool.com/)！(1.16 以上版本) `[自 v1.2.3 版本起]` - - 格式： `&(#颜色代码)` - - 示例：LightSlateBlue `&(#8470FF)` 、 DarkSlateBlue `&(#483D8B)` +- 支持 [Hex 颜色](https://www.hexcolortool.com/)！(1.16 以上版本) `[自 v1.2.3 版本起]` + - 格式： `&(#颜色代码)` + - 示例：LightSlateBlue `&(#8470FF)` 、 DarkSlateBlue `&(#483D8B)` - 支持渐变色！(1.16 以上版本) `[自 v1.2.3 版本起]` - - 格式： `&<#颜色代码1>消息内容&<#颜色代码2>` - - 示例： `&<#8470FF>Hello World!&<#483D8B>` + - 格式： `&<#颜色代码1>消息内容&<#颜色代码2>` + - 示例： `&<#8470FF>Hello World!&<#483D8B>` ## 注意事项 @@ -69,13 +60,13 @@ sidebar_position: 2 本插件理论全版本支持，如果出现图标不加载、声音无法播放等问题请检查配置文件中物品与声音的 type 在当前版本是否存在。 -以声音举例，村民表示可以的声音在低版本中为“`VILLAGER_YES`”,而在高版本中则变为了“`ENTITY_VILLAGER_YES`”。 +以声音举例，村民表示可以的声音在低版本中为 `VILLAGER_YES`,而在高版本中则变为了 `ENTITY_VILLAGER_YES`。 ### 2. 计分板异常问题 头顶上前缀的显示与 TabList 的排序均使用到了计分板 API。 -如有冲突导致其他插件的计分板无法显示，请关掉配置文件中`functions.on-name-prefix`。 +如有冲突导致其他插件的计分板无法显示，请关掉配置文件中 `functions.on-name-prefix`。 ## 链接 diff --git a/docs-java/process/plugin/ManageTool/AntiGrief/AntiGrief.md b/docs-java/process/plugin/management-tool/anti-grief/anti-grief.md similarity index 75% rename from docs-java/process/plugin/ManageTool/AntiGrief/AntiGrief.md rename to docs-java/process/plugin/management-tool/anti-grief/anti-grief.md index 03d8add3a..6a6a3e8fa 100644 --- a/docs-java/process/plugin/ManageTool/AntiGrief/AntiGrief.md +++ b/docs-java/process/plugin/management-tool/anti-grief/anti-grief.md @@ -6,13 +6,13 @@ sidebar_position: 3 # 概览 -记录玩家放置，破坏，存储物品等使用 [CoreProtect](CoreProtect.md) 或 [PrismRefracted](PrismRefracted.md)。 +记录玩家放置，破坏，存储物品等使用 [CoreProtect](coreprotect.md) 或 [PrismRefracted](prismrefracted.md)。 可以依据记录让插件把一定区域回滚到某个时间点。 ~~就像 TT2 协议一样~~ 就像范围回溯时间的魔法。 -查玩家背包用 [InvSee++](InvSee++.md)。 +查玩家背包用 [InvSee++](invseeplusplus.md)。 import DocCardList from '@theme/DocCardList'; diff --git a/docs-java/process/plugin/ManageTool/AntiGrief/CoreProtect.md b/docs-java/process/plugin/management-tool/anti-grief/coreprotect.md similarity index 100% rename from docs-java/process/plugin/ManageTool/AntiGrief/CoreProtect.md rename to docs-java/process/plugin/management-tool/anti-grief/coreprotect.md diff --git a/docs-java/process/plugin/ManageTool/AntiGrief/InvSee++.md b/docs-java/process/plugin/management-tool/anti-grief/invseeplusplus.md similarity index 83% rename from docs-java/process/plugin/ManageTool/AntiGrief/InvSee++.md rename to docs-java/process/plugin/management-tool/anti-grief/invseeplusplus.md index 15a939cfb..fca4f2854 100644 --- a/docs-java/process/plugin/ManageTool/AntiGrief/InvSee++.md +++ b/docs-java/process/plugin/management-tool/anti-grief/invseeplusplus.md @@ -19,7 +19,7 @@ sidebar_label: 查包 - InvSee++ InvSee++ 可以查看和编辑其他玩家的物品栏和末影箱。 -[Essentials](/Java/process/plugin/ManageTool/BasicPlugins/EssentialsX/) 也有这个功能，但 InvSee 可以： +[Essentials](../basic-plugins/essentialsx/essentialsx.md) 也有这个功能，但 InvSee++ 可以： - 拿走或替换玩家的装备 - 查询离线玩家的背包 @@ -47,8 +47,8 @@ InvSee++ 可以查看和编辑其他玩家的物品栏和末影箱。 #### 指令 -- /invgive (添加到背包) -- /endergive (添加到末影箱) +- `/invgive` (添加到背包) +- `/endergive` (添加到末影箱) 指令格式和普通的 give 指令一模一样。 @@ -58,7 +58,7 @@ InvSee++ 可以查看和编辑其他玩家的物品栏和末影箱。 #### 指令 -- /invclear (清除背包中的物品) -- /enderclear (清除末影箱中的物品) +- `/invclear` (清除背包中的物品) +- `/enderclear` (清除末影箱中的物品) 指令格式和普通的 clear 指令一模一样。 diff --git a/docs-java/process/plugin/ManageTool/AntiGrief/PrismRefracted.md b/docs-java/process/plugin/management-tool/anti-grief/prismrefracted.md similarity index 85% rename from docs-java/process/plugin/ManageTool/AntiGrief/PrismRefracted.md rename to docs-java/process/plugin/management-tool/anti-grief/prismrefracted.md index 9390b4a70..60d933261 100644 --- a/docs-java/process/plugin/ManageTool/AntiGrief/PrismRefracted.md +++ b/docs-java/process/plugin/management-tool/anti-grief/prismrefracted.md @@ -11,7 +11,7 @@ sidebar_label: 记录 - PrismRefracted `GitHub` https://github.com/prism/PrismRefracted -`GitHub(汉化版)` https://github.com/Rothes/PrismRefracted +`GitHub (汉化版)` https://github.com/Rothes/PrismRefracted ::: diff --git a/docs-java/process/plugin/ManageTool/BasicPlugins/BasicPlugins.md b/docs-java/process/plugin/management-tool/basic-plugins/basic-plugins.md similarity index 100% rename from docs-java/process/plugin/ManageTool/BasicPlugins/BasicPlugins.md rename to docs-java/process/plugin/management-tool/basic-plugins/basic-plugins.md diff --git a/docs-java/process/plugin/ManageTool/BasicPlugins/CMI/_images/1.jpg b/docs-java/process/plugin/management-tool/basic-plugins/cmi/_images/1.jpg similarity index 100% rename from docs-java/process/plugin/ManageTool/BasicPlugins/CMI/_images/1.jpg rename to docs-java/process/plugin/management-tool/basic-plugins/cmi/_images/1.jpg diff --git a/docs-java/process/plugin/ManageTool/BasicPlugins/CMI/_images/2.png b/docs-java/process/plugin/management-tool/basic-plugins/cmi/_images/2.png similarity index 100% rename from docs-java/process/plugin/ManageTool/BasicPlugins/CMI/_images/2.png rename to docs-java/process/plugin/management-tool/basic-plugins/cmi/_images/2.png diff --git a/docs-java/process/plugin/ManageTool/BasicPlugins/CMI/CMI.md b/docs-java/process/plugin/management-tool/basic-plugins/cmi/cmi.md similarity index 59% rename from docs-java/process/plugin/ManageTool/BasicPlugins/CMI/CMI.md rename to docs-java/process/plugin/management-tool/basic-plugins/cmi/cmi.md index 8c32242a9..bbb205561 100644 --- a/docs-java/process/plugin/ManageTool/BasicPlugins/CMI/CMI.md +++ b/docs-java/process/plugin/management-tool/basic-plugins/cmi/cmi.md @@ -9,7 +9,7 @@ sidebar_position: 2 ![](_images/2.png) -广泛使用，特别知名的付费基础插件，提供了**巨量**的功能，BUG 和无脑盗版用户。 +广泛使用，特别知名的付费基础插件，提供了 **巨量** 的功能，bug 和无脑盗版用户。 ## 链接 @@ -19,9 +19,9 @@ sidebar_position: 2 `MineBBS` https://www.minebbs.com/resources/.7380 -`文档(英文)` https://www.zrips.net/cmi +`文档 (英文)` https://www.zrips.net/cmi -`文档(中文)` https://cmi.pueh.cn +`文档 (中文)` https://cmi.pueh.cn ::: diff --git a/docs-java/process/plugin/ManageTool/BasicPlugins/CMI/eco.md b/docs-java/process/plugin/management-tool/basic-plugins/cmi/eco.md similarity index 62% rename from docs-java/process/plugin/ManageTool/BasicPlugins/CMI/eco.md rename to docs-java/process/plugin/management-tool/basic-plugins/cmi/eco.md index 2e13111c4..86d552076 100644 --- a/docs-java/process/plugin/ManageTool/BasicPlugins/CMI/eco.md +++ b/docs-java/process/plugin/management-tool/basic-plugins/cmi/eco.md @@ -5,11 +5,11 @@ sidebar_position: 3 # 经济 -要使CMI的经济系统正常运行，您需要选择以下两种解决方案之一： +要使 CMI 的经济系统正常运行，您需要选择以下两种解决方案之一： 1. 使用重新编译的 Vault 版本（[点击此处获取](https://www.zrips.net/cmivault)），该版本直接支持 CMI 经济系统，并与其他插件具有最佳兼容性。 2. 使用经济注入器（[点击此处获取](https://zrips.net/cmii)），该工具可为任何 Vault 版本添加 CMI 经济支持。 -两种方法均有效，但第二种方式可能会与某些插件存在小问题，因为这些插件可能在Vault加载后、注入器生效前抢先加载。 +两种方法均有效，但第二种方式可能会与某些插件存在小问题，因为这些插件可能在 Vault 加载后、注入器生效前抢先加载。 -注意： 别忘了在配置文件中启用经济功能（enable Economy）。 +注意：别忘了在配置文件中启用经济功能（enable Economy）。 diff --git a/docs-java/process/plugin/ManageTool/BasicPlugins/CMI/question.md b/docs-java/process/plugin/management-tool/basic-plugins/cmi/question.md similarity index 100% rename from docs-java/process/plugin/ManageTool/BasicPlugins/CMI/question.md rename to docs-java/process/plugin/management-tool/basic-plugins/cmi/question.md diff --git a/docs-java/process/plugin/management-tool/basic-plugins/delete.md b/docs-java/process/plugin/management-tool/basic-plugins/delete.md new file mode 100644 index 000000000..84ba39f18 --- /dev/null +++ b/docs-java/process/plugin/management-tool/basic-plugins/delete.md @@ -0,0 +1,18 @@ +--- +title: 删掉基础插件 +sidebar_position: 3 +--- + +# 删掉基础插件 + +[CMI](./cmi/cmi.md) 在拼命的加新功能，多而不精，插件变得臃肿不堪小白比较难上手 + +[EssentialsX](./essentialsx/essentialsx.md) 却在拼命追求稳定性，一点新功能不加的，现在随便个 tpa 插件都有点击聊天框信息同意传送的功能，他却没有，你还不能自己写 JSON 补 + +也许，是时候删除这俩玩意了 + +实际上，经济功能装个 [XConomy](../../plugin-dependencies/xconomy.md) 足够了 + +而对于 tpa，warp，home，back 等传送功能，或许你可以试试 [HuskHomes](https://www.spigotmc.org/resources/.83767/) + +CMI 的那些功能几乎都有可以平替的插件 diff --git a/docs-java/process/plugin/ManageTool/BasicPlugins/EssentialsX/_images/1.png b/docs-java/process/plugin/management-tool/basic-plugins/essentialsx/_images/1.png similarity index 100% rename from docs-java/process/plugin/ManageTool/BasicPlugins/EssentialsX/_images/1.png rename to docs-java/process/plugin/management-tool/basic-plugins/essentialsx/_images/1.png diff --git a/docs-java/process/plugin/ManageTool/BasicPlugins/EssentialsX/_images/2.png b/docs-java/process/plugin/management-tool/basic-plugins/essentialsx/_images/2.png similarity index 100% rename from docs-java/process/plugin/ManageTool/BasicPlugins/EssentialsX/_images/2.png rename to docs-java/process/plugin/management-tool/basic-plugins/essentialsx/_images/2.png diff --git a/docs-java/process/plugin/ManageTool/BasicPlugins/EssentialsX/_images/3.png b/docs-java/process/plugin/management-tool/basic-plugins/essentialsx/_images/3.png similarity index 100% rename from docs-java/process/plugin/ManageTool/BasicPlugins/EssentialsX/_images/3.png rename to docs-java/process/plugin/management-tool/basic-plugins/essentialsx/_images/3.png diff --git a/docs-java/process/plugin/ManageTool/BasicPlugins/EssentialsX/_images/banner.png b/docs-java/process/plugin/management-tool/basic-plugins/essentialsx/_images/banner.png similarity index 100% rename from docs-java/process/plugin/ManageTool/BasicPlugins/EssentialsX/_images/banner.png rename to docs-java/process/plugin/management-tool/basic-plugins/essentialsx/_images/banner.png diff --git a/docs-java/process/plugin/ManageTool/BasicPlugins/EssentialsX/_images/kit_1.png b/docs-java/process/plugin/management-tool/basic-plugins/essentialsx/_images/kit_1.png similarity index 100% rename from docs-java/process/plugin/ManageTool/BasicPlugins/EssentialsX/_images/kit_1.png rename to docs-java/process/plugin/management-tool/basic-plugins/essentialsx/_images/kit_1.png diff --git a/docs-java/process/plugin/ManageTool/BasicPlugins/EssentialsX/_images/kit_2.png b/docs-java/process/plugin/management-tool/basic-plugins/essentialsx/_images/kit_2.png similarity index 100% rename from docs-java/process/plugin/ManageTool/BasicPlugins/EssentialsX/_images/kit_2.png rename to docs-java/process/plugin/management-tool/basic-plugins/essentialsx/_images/kit_2.png diff --git a/docs-java/process/plugin/ManageTool/BasicPlugins/EssentialsX/_images/kit_3.png b/docs-java/process/plugin/management-tool/basic-plugins/essentialsx/_images/kit_3.png similarity index 100% rename from docs-java/process/plugin/ManageTool/BasicPlugins/EssentialsX/_images/kit_3.png rename to docs-java/process/plugin/management-tool/basic-plugins/essentialsx/_images/kit_3.png diff --git a/docs-java/process/plugin/ManageTool/BasicPlugins/EssentialsX/_images/kit_4.png b/docs-java/process/plugin/management-tool/basic-plugins/essentialsx/_images/kit_4.png similarity index 100% rename from docs-java/process/plugin/ManageTool/BasicPlugins/EssentialsX/_images/kit_4.png rename to docs-java/process/plugin/management-tool/basic-plugins/essentialsx/_images/kit_4.png diff --git a/docs-java/process/plugin/ManageTool/BasicPlugins/EssentialsX/_images/warp_1.png b/docs-java/process/plugin/management-tool/basic-plugins/essentialsx/_images/warp_1.png similarity index 100% rename from docs-java/process/plugin/ManageTool/BasicPlugins/EssentialsX/_images/warp_1.png rename to docs-java/process/plugin/management-tool/basic-plugins/essentialsx/_images/warp_1.png diff --git a/docs-java/process/plugin/ManageTool/BasicPlugins/EssentialsX/_images/warp_2.png b/docs-java/process/plugin/management-tool/basic-plugins/essentialsx/_images/warp_2.png similarity index 100% rename from docs-java/process/plugin/ManageTool/BasicPlugins/EssentialsX/_images/warp_2.png rename to docs-java/process/plugin/management-tool/basic-plugins/essentialsx/_images/warp_2.png diff --git a/docs-java/process/plugin/ManageTool/BasicPlugins/EssentialsX/_images/warp_3.png b/docs-java/process/plugin/management-tool/basic-plugins/essentialsx/_images/warp_3.png similarity index 100% rename from docs-java/process/plugin/ManageTool/BasicPlugins/EssentialsX/_images/warp_3.png rename to docs-java/process/plugin/management-tool/basic-plugins/essentialsx/_images/warp_3.png diff --git a/docs-java/process/plugin/ManageTool/BasicPlugins/EssentialsX/ConfigTips.md b/docs-java/process/plugin/management-tool/basic-plugins/essentialsx/config-tips.md similarity index 90% rename from docs-java/process/plugin/ManageTool/BasicPlugins/EssentialsX/ConfigTips.md rename to docs-java/process/plugin/management-tool/basic-plugins/essentialsx/config-tips.md index 473b05614..00754e0f2 100644 --- a/docs-java/process/plugin/ManageTool/BasicPlugins/EssentialsX/ConfigTips.md +++ b/docs-java/process/plugin/management-tool/basic-plugins/essentialsx/config-tips.md @@ -5,7 +5,7 @@ sidebar_position: 2 # Config 快速指南 -我们为懒人列出了配置文件那些比较重要的选项 (善用 CTRL + F ) ： +我们为懒人列出了配置文件那些比较重要的选项 (善用 `Ctrl + F`)： ## 传送 @@ -58,14 +58,14 @@ auto-afk-kick: -1 ``` 在超时 (以秒为单位) 后，用户将被踢出服务器。 -拥有 essentials.afk.kickexempt 权限可以避免被踢出。 -设置为 -1 表示不会超时。 +拥有 `essentials.afk.kickexempt` 权限可以避免被踢出。 +设置为 `-1` 表示不会超时。 ```yaml afk-list-name: "挂机中" ``` -设置玩家 AFK 时的列表名称。默认情况下为 none。 +设置玩家 AFK 时的列表名称。默认情况下为 `none`。 ## 杂项 @@ -83,7 +83,7 @@ custom-new-username-message: "&e[&a+&e]&6 比驿站丑的新玩家 {USERNAME} 你可以在此处设置自定义加入和退出消息。 -将此设置为 none 以使用默认的原版消息。 +将此设置为 `none` 以使用默认的原版消息。 ## 家 @@ -121,7 +121,7 @@ kit: tools 是否想要玩家第一次进入服务器时赠送新手礼物？ -设置为 '' 可禁用此功能。 +设置为 `''` 可禁用此功能。 ## EssentialsX Chat diff --git a/docs-java/process/plugin/ManageTool/BasicPlugins/EssentialsX/config.yml.md b/docs-java/process/plugin/management-tool/basic-plugins/essentialsx/config-yml.md similarity index 99% rename from docs-java/process/plugin/ManageTool/BasicPlugins/EssentialsX/config.yml.md rename to docs-java/process/plugin/management-tool/basic-plugins/essentialsx/config-yml.md index 26516b00d..ebb2a0bfa 100644 --- a/docs-java/process/plugin/ManageTool/BasicPlugins/EssentialsX/config.yml.md +++ b/docs-java/process/plugin/management-tool/basic-plugins/essentialsx/config-yml.md @@ -439,7 +439,7 @@ per-warp-permission: false # 按组排序 /list 命令的输出。 # 您可以通过在此定义所需行为来隐藏和合并在 /list 中显示的组。 -# 详细说明和示例可以在 wiki 上找到：https://wiki.ess3.net/wiki/List +# 详细说明和示例可以在 Wiki 上找到：https://wiki.ess3.net/wiki/List list: # 要在 /list 中将多个组合并到一个名称下，请在一行中列出每个组，用空格分隔。 #Staff: owner admin moderator @@ -820,7 +820,7 @@ confirm-home-overwrite: false starting-balance: 0 # 定义使用给定命令每次使用的成本。 -# 某些命令如 /repair 有子成本。查看 wiki 获取更多信息。 +# 某些命令如 /repair 有子成本。查看 Wiki 获取更多信息。 command-costs: # 使 /example 每次使用花费 $1000： #example: 1000 @@ -936,7 +936,7 @@ chat: # 更多信息请参见 https://essentialsx.net/wiki/Color-Permissions.html。 # # 您还可以为每种聊天类型指定子格式。 - # 有关聊天格式的更多信息，请访问 wiki：https://wiki.ess3.net/wiki/Chat_Formatting#Chat_Formatting + # 有关聊天格式的更多信息，请访问 Wiki：https://wiki.ess3.net/wiki/Chat_Formatting#Chat_Formatting # # 可用占位符： # {MESSAGE} - 聊天消息的内容。 @@ -1113,7 +1113,7 @@ protect: # 是否应禁用跌落伤害？ fall: false - # 是否应禁用PvP？ + # 是否应禁用 PvP？ # 如果设置为 true，拥有 'essentials.protect.pvp' 权限的玩家仍能够互相攻击。 # 但是，他们无法攻击没有该权限节点的玩家。 pvp: false diff --git a/docs-java/process/plugin/ManageTool/BasicPlugins/EssentialsX/EssentialsX.md b/docs-java/process/plugin/management-tool/basic-plugins/essentialsx/essentialsx.md similarity index 81% rename from docs-java/process/plugin/ManageTool/BasicPlugins/EssentialsX/EssentialsX.md rename to docs-java/process/plugin/management-tool/basic-plugins/essentialsx/essentialsx.md index d981e513c..64e8c1055 100644 --- a/docs-java/process/plugin/ManageTool/BasicPlugins/EssentialsX/EssentialsX.md +++ b/docs-java/process/plugin/management-tool/basic-plugins/essentialsx/essentialsx.md @@ -12,11 +12,11 @@ sidebar_position: 1 EssentialsX 是一个基于 Spigot 服务端的基础插件，为从大到小的服务器提供核心功能。这些功能包括： - **玩家可以自由设置家** -- 服务器**传送**或给玩家提供**物品套组**，可以设置跨世界或单独世界。 -- 玩家与玩家间的**私有消息，传送，发送传送请求** -- 玩家自定义**昵称** -- 很多的管理员工具包括**踢出服务器，临时禁止登陆服务器、禁言与监禁** -- 内建经济系统，包括**木牌商店、付费执行命令和完全的 Vault 支持** +- 服务器 **传送** 或给玩家提供 **物品套组**，可以设置跨世界或单独世界。 +- 玩家与玩家间的 **私有消息，传送，发送传送请求** +- 玩家自定义 **昵称** +- 很多的管理员工具包括 **踢出服务器，临时禁止登陆服务器、禁言与监禁** +- 内建经济系统，包括 **木牌商店、付费执行命令和完全的 Vault 支持** 此外，EssentialsX 的选择模块提供了更多综合的功能如聊天、世界保护、GeoIP 查找还有更多……请前往 [模块故障](https://github.com/TecoStudio/EssentialsX-Wiki-zh_CN/wiki/1.3---%E6%A8%A1%E5%9D%97%E6%95%85%E9%9A%9C) 部分阅读更多内容。 @@ -38,9 +38,9 @@ EssentialsX 是一个基于 Spigot 服务端的基础插件，为从大到小的 `GitHub` https://github.com/EssentialsX/Essentials -`文档(英文)` https://essentialsx.net/wiki/Home.html +`文档 (英文)` https://essentialsx.net/wiki/Home.html -`文档(中文)` https://docs.tecostudio.cn/EssentialsX +`文档 (中文)` https://docs.tecostudio.cn/EssentialsX `插件百科` https://mineplugin.org/EssentialsX @@ -50,8 +50,8 @@ EssentialsX 是一个基于 Spigot 服务端的基础插件，为从大到小的 Essentials 插件分为两个版本： -- essentials(早已停更) 适合 mc 1.7.10 [下载](https://mineplugin.org/Essentials/Downloads) -- essentialsX 适合 mc 1.8+ [下载](https://essentialsx.net/downloads.html) +- essentials(早已停更) 适合 MC 1.7.10 [下载](https://mineplugin.org/Essentials/Downloads) +- essentialsX 适合 MC 1.8+ [下载](https://essentialsx.net/downloads.html)
怎么找到官网并从官网下载 essx diff --git a/docs-java/process/plugin/management-tool/basic-plugins/essentialsx/faq.md b/docs-java/process/plugin/management-tool/basic-plugins/essentialsx/faq.md new file mode 100644 index 000000000..ff0ae014b --- /dev/null +++ b/docs-java/process/plugin/management-tool/basic-plugins/essentialsx/faq.md @@ -0,0 +1,14 @@ +--- +title: 常见问题 +sidebar_position: 7 +--- + +# 常见问题 + +## 你没有权限与 xxx 交互。 \ + +![](../../permission/_images/日志-1.png) + +🏆来的我不是叫你不要装 ess 全家桶？ + +删了你的 EssentialsXAntiBuild 或者看 [这里](../../permission/tips.md) diff --git a/docs-java/process/plugin/ManageTool/BasicPlugins/EssentialsX/kit.md b/docs-java/process/plugin/management-tool/basic-plugins/essentialsx/kit.md similarity index 93% rename from docs-java/process/plugin/ManageTool/BasicPlugins/EssentialsX/kit.md rename to docs-java/process/plugin/management-tool/basic-plugins/essentialsx/kit.md index 98d65ac7f..664a7d921 100644 --- a/docs-java/process/plugin/ManageTool/BasicPlugins/EssentialsX/kit.md +++ b/docs-java/process/plugin/management-tool/basic-plugins/essentialsx/kit.md @@ -47,7 +47,7 @@ sidebar_position: 5 ### 保存 nbt -[点击此处](ConfigTips.md#礼包工具包) +[点击此处](config-tips.md#礼包工具包) ### kit 执行命令 @@ -66,7 +66,7 @@ iloveyizhan: ### 变量 -[点击此处](PapiSupport.md) +[点击此处](papi-support.md) ```text %essentials_has_kit_% - 是否有 XX 工具包 diff --git a/docs-java/process/plugin/ManageTool/BasicPlugins/EssentialsX/PapiSupport.md b/docs-java/process/plugin/management-tool/basic-plugins/essentialsx/papi-support.md similarity index 94% rename from docs-java/process/plugin/ManageTool/BasicPlugins/EssentialsX/PapiSupport.md rename to docs-java/process/plugin/management-tool/basic-plugins/essentialsx/papi-support.md index 43e166a95..260bc67fa 100644 --- a/docs-java/process/plugin/ManageTool/BasicPlugins/EssentialsX/PapiSupport.md +++ b/docs-java/process/plugin/management-tool/basic-plugins/essentialsx/papi-support.md @@ -7,7 +7,7 @@ sidebar_position: 4 `官方文档` https://wiki.placeholderapi.com/users/placeholder-list/#essentials -`插件百科(严重过期)` https://mineplugin.org/PlaceholderAPI(%E6%97%A7) +`插件百科 (严重过期)` https://mineplugin.org/PlaceholderAPI(%E6%97%A7) ::: diff --git a/docs-java/process/plugin/ManageTool/BasicPlugins/EssentialsX/warp.md b/docs-java/process/plugin/management-tool/basic-plugins/essentialsx/warp.md similarity index 100% rename from docs-java/process/plugin/ManageTool/BasicPlugins/EssentialsX/warp.md rename to docs-java/process/plugin/management-tool/basic-plugins/essentialsx/warp.md diff --git a/docs-java/process/plugin/ManageTool/BasicPlugins/SunLight/_images/1.png b/docs-java/process/plugin/management-tool/basic-plugins/sunlight/_images/1.png similarity index 100% rename from docs-java/process/plugin/ManageTool/BasicPlugins/SunLight/_images/1.png rename to docs-java/process/plugin/management-tool/basic-plugins/sunlight/_images/1.png diff --git a/docs-java/process/plugin/ManageTool/BasicPlugins/SunLight/_images/2.png b/docs-java/process/plugin/management-tool/basic-plugins/sunlight/_images/2.png similarity index 100% rename from docs-java/process/plugin/ManageTool/BasicPlugins/SunLight/_images/2.png rename to docs-java/process/plugin/management-tool/basic-plugins/sunlight/_images/2.png diff --git a/docs-java/process/plugin/ManageTool/BasicPlugins/SunLight/_images/3.png b/docs-java/process/plugin/management-tool/basic-plugins/sunlight/_images/3.png similarity index 100% rename from docs-java/process/plugin/ManageTool/BasicPlugins/SunLight/_images/3.png rename to docs-java/process/plugin/management-tool/basic-plugins/sunlight/_images/3.png diff --git a/docs-java/process/plugin/ManageTool/BasicPlugins/SunLight/_images/4.png b/docs-java/process/plugin/management-tool/basic-plugins/sunlight/_images/4.png similarity index 100% rename from docs-java/process/plugin/ManageTool/BasicPlugins/SunLight/_images/4.png rename to docs-java/process/plugin/management-tool/basic-plugins/sunlight/_images/4.png diff --git a/docs-java/process/plugin/ManageTool/BasicPlugins/SunLight/_images/5.png b/docs-java/process/plugin/management-tool/basic-plugins/sunlight/_images/5.png similarity index 100% rename from docs-java/process/plugin/ManageTool/BasicPlugins/SunLight/_images/5.png rename to docs-java/process/plugin/management-tool/basic-plugins/sunlight/_images/5.png diff --git a/docs-java/process/plugin/ManageTool/BasicPlugins/SunLight/SunLight.md b/docs-java/process/plugin/management-tool/basic-plugins/sunlight/sunlight.md similarity index 82% rename from docs-java/process/plugin/ManageTool/BasicPlugins/SunLight/SunLight.md rename to docs-java/process/plugin/management-tool/basic-plugins/sunlight/sunlight.md index a2caa37f3..c69ef560d 100644 --- a/docs-java/process/plugin/ManageTool/BasicPlugins/SunLight/SunLight.md +++ b/docs-java/process/plugin/management-tool/basic-plugins/sunlight/sunlight.md @@ -7,15 +7,9 @@ sidebar_position: 3 ![](_images/1.png) - - - - - - - - - +[![Discord](./_images/2.png)](https://discord.gg/EwNFGsnGaW) +[![Ko-fi](./_images/3.png)](https://ko-fi.com/nightexpress) +[![Documentation](./_images/4.png)](https://nightexpress.gitbook.io/sunlight) ## 特点 @@ -44,7 +38,7 @@ sidebar_position: 3 `GitHub` https://github.com/nulli0n/SunLight-spigot -`文档(英文)` https://github.com/nulli0n/SunLight-spigot/wiki +`文档 (英文)` https://github.com/nulli0n/SunLight-spigot/wiki `插件百科` https://mineplugin.org/SunLight-Core diff --git a/docs-java/process/plugin/ManageTool/chat/_images/TrChat/1.png b/docs-java/process/plugin/management-tool/chat/_images/TrChat/1.png similarity index 100% rename from docs-java/process/plugin/ManageTool/chat/_images/TrChat/1.png rename to docs-java/process/plugin/management-tool/chat/_images/TrChat/1.png diff --git a/docs-java/process/plugin/ManageTool/chat/Carbon.md b/docs-java/process/plugin/management-tool/chat/carbon.md similarity index 100% rename from docs-java/process/plugin/ManageTool/chat/Carbon.md rename to docs-java/process/plugin/management-tool/chat/carbon.md diff --git a/docs-java/process/plugin/ManageTool/chat/chat.md b/docs-java/process/plugin/management-tool/chat/chat.md similarity index 100% rename from docs-java/process/plugin/ManageTool/chat/chat.md rename to docs-java/process/plugin/management-tool/chat/chat.md diff --git a/docs-java/process/plugin/ManageTool/chat/HuskChat.md b/docs-java/process/plugin/management-tool/chat/huskchat.md similarity index 99% rename from docs-java/process/plugin/ManageTool/chat/HuskChat.md rename to docs-java/process/plugin/management-tool/chat/huskchat.md index 486d97d9f..7964906de 100644 --- a/docs-java/process/plugin/ManageTool/chat/HuskChat.md +++ b/docs-java/process/plugin/management-tool/chat/huskchat.md @@ -6,7 +6,9 @@ sidebar_position: 2 # HuskChat :::danger + 根据 SpigotMC 和 GitHub 上的官方消息，此插件已停止开发。 + ::: :::info diff --git a/docs-java/process/plugin/ManageTool/chat/TrChat.md b/docs-java/process/plugin/management-tool/chat/trchat.md similarity index 72% rename from docs-java/process/plugin/ManageTool/chat/TrChat.md rename to docs-java/process/plugin/management-tool/chat/trchat.md index 3aab0311f..fd9d86ead 100644 --- a/docs-java/process/plugin/ManageTool/chat/TrChat.md +++ b/docs-java/process/plugin/management-tool/chat/trchat.md @@ -16,7 +16,7 @@ sidebar_position: 1 - 云端词库，你无需自行添加过多的敏感词，插件将自动从云端更新敏感词库（当前 0.7k+） - 物品展示，所有频道均支持展示玩家容器内物品，支持指定槽位、同时展示多个物品，支持设置冷却 - 聊天冷却，自定义玩家聊天间隔，防止刷屏 -- At@玩家，支持高亮@玩家，并通过音效+TITLE 等方式提醒，支持设置冷却 +- At@玩家，支持高亮@玩家，并通过音效 + TITLE 等方式提醒，支持设置冷却 - 监听私聊，管理员支持切换监听模式，开始时将被推送玩家的私聊内容 - 颜色代码，通过独立的权限控制玩家是否能够使用某颜色代码，支持聊天、书本、铁砧等 - 多聊天格式，单个聊天频道支持多个聊天格式，通过权限优先级筛选 @@ -31,18 +31,10 @@ sidebar_position: 1 - - Version - - - Issues - - - Last Commit - - - Downloads - +[![Version](https://img.shields.io/github/v/release/TrPlugins/TrChat?logo=VirusTotal&style=for-the-badge)](https://github.com/FlickerProjects/TrChat/releases) +[![Issues](https://img.shields.io/github/issues/TrPlugins/TrChat?logo=StackOverflow&style=for-the-badge)](https://github.com/FlickerProjects/TrChat/issues) +[![Last Commit](https://img.shields.io/github/last-commit/TrPlugins/TrChat?logo=ApacheRocketMQ&style=for-the-badge&color=1e90ff)](https://github.com/FlickerProjects/TrChat/commits/v2) +[![Downloads](https://img.shields.io/github/downloads/TrPlugins/TrChat/total?style=for-the-badge&logo=docusign)](https://github.com/NEZNAMY/TAB/blob/main/LICENSE) [TrChat](https://github.com/TrPlugins/TrChat) 是基于 [TabooLib](https://github.com/TabooLib/taboolib) 开发，发布于 2019-8-16 的高级聊天系统插件 diff --git a/docs-java/process/plugin/ManageTool/items/_images/mmoitems.png b/docs-java/process/plugin/management-tool/items/_images/mmoitems.png similarity index 100% rename from docs-java/process/plugin/ManageTool/items/_images/mmoitems.png rename to docs-java/process/plugin/management-tool/items/_images/mmoitems.png diff --git a/docs-java/process/plugin/ManageTool/items/_images/mmoitems_2.webp b/docs-java/process/plugin/management-tool/items/_images/mmoitems_2.webp similarity index 100% rename from docs-java/process/plugin/ManageTool/items/_images/mmoitems_2.webp rename to docs-java/process/plugin/management-tool/items/_images/mmoitems_2.webp diff --git a/docs-java/process/plugin/ManageTool/items/Crucible.md b/docs-java/process/plugin/management-tool/items/crucible.md similarity index 55% rename from docs-java/process/plugin/ManageTool/items/Crucible.md rename to docs-java/process/plugin/management-tool/items/crucible.md index 0d740f08a..f4d2e1007 100644 --- a/docs-java/process/plugin/ManageTool/items/Crucible.md +++ b/docs-java/process/plugin/management-tool/items/crucible.md @@ -9,9 +9,9 @@ sidebar_position: 4 `mythiccraft` https://mythiccraft.io/index.php?resources/.2 -`文档(英文)` https://git.mythiccraft.io/mythiccraft/mythiccrucible/-/wikis/home +`文档 (英文)` https://git.mythiccraft.io/mythiccraft/mythiccrucible/-/wikis/home -`文档(中文)` https://gitlab.com/TranslatedByShark/MythicCrucible-Manual-CN/-/wikis/home +`文档 (中文)` https://gitlab.com/TranslatedByShark/MythicCrucible-Manual-CN/-/wikis/home `插件百科` https://mineplugin.org/Crucible diff --git a/docs-java/process/plugin/ManageTool/items/EcoItems.md b/docs-java/process/plugin/management-tool/items/ecoItems.md similarity index 64% rename from docs-java/process/plugin/ManageTool/items/EcoItems.md rename to docs-java/process/plugin/management-tool/items/ecoItems.md index ba36f496b..8fe6faaf9 100644 --- a/docs-java/process/plugin/ManageTool/items/EcoItems.md +++ b/docs-java/process/plugin/management-tool/items/ecoItems.md @@ -11,9 +11,9 @@ sidebar_position: 3 `GitHub` https://github.com/Auxilor/EcoItems -`文档(英文)` https://plugins.auxilor.io/ecoitems +`文档 (英文)` https://plugins.auxilor.io/ecoitems -`文档(中文)` https://docs.superiormc.cn/v/ecox-doc +`文档 (中文)` https://docs.superiormc.cn/v/ecox-doc ::: diff --git a/docs-java/process/plugin/ManageTool/items/items.md b/docs-java/process/plugin/management-tool/items/items.md similarity index 100% rename from docs-java/process/plugin/ManageTool/items/items.md rename to docs-java/process/plugin/management-tool/items/items.md diff --git a/docs-java/process/plugin/ManageTool/items/other.md b/docs-java/process/plugin/management-tool/items/misc.md similarity index 75% rename from docs-java/process/plugin/ManageTool/items/other.md rename to docs-java/process/plugin/management-tool/items/misc.md index 2c5277ffe..13a8c406b 100644 --- a/docs-java/process/plugin/ManageTool/items/other.md +++ b/docs-java/process/plugin/management-tool/items/misc.md @@ -11,6 +11,6 @@ sidebar_position: 9 - [ItemsAdder](../../../maintenance/resourcepack/plugins/framework.md) - [Oraxen](../../../maintenance/resourcepack/plugins/framework.md) -- [MythicMobs](../../other/MythicMobs.md) -- [CMI](../BasicPlugins/CMI/CMI.md) -- [SunLight](../BasicPlugins/SunLight/SunLight.md) +- [MythicMobs](../../misc/mythicmobs.md) +- [CMI](../basic-plugins/cmi/cmi.md) +- [SunLight](../basic-plugins/sunlight/sunlight.md) diff --git a/docs-java/process/plugin/ManageTool/items/MMOItems.md b/docs-java/process/plugin/management-tool/items/mmoitems.md similarity index 84% rename from docs-java/process/plugin/ManageTool/items/MMOItems.md rename to docs-java/process/plugin/management-tool/items/mmoitems.md index 85b69f40e..db4b1d557 100644 --- a/docs-java/process/plugin/ManageTool/items/MMOItems.md +++ b/docs-java/process/plugin/management-tool/items/mmoitems.md @@ -13,9 +13,9 @@ sidebar_position: 1 `GitLab` https://gitlab.com/phoenix-dvpmt/mmoitems -`文档(英文)` https://gitlab.com/phoenix-dvpmt/mmoitems/-/wikis/home +`文档 (英文)` https://gitlab.com/phoenix-dvpmt/mmoitems/-/wikis/home -`文档(中文)` https://mmoitems.magicmc.top +`文档 (中文)` https://mmoitems.magicmc.top ::: diff --git a/docs-java/process/plugin/ManageTool/items/NeigeItems.md b/docs-java/process/plugin/management-tool/items/neigeitems.md similarity index 100% rename from docs-java/process/plugin/ManageTool/items/NeigeItems.md rename to docs-java/process/plugin/management-tool/items/neigeitems.md diff --git a/docs-java/process/plugin/ManageTool/items/Ratziel.md b/docs-java/process/plugin/management-tool/items/ratziel.md similarity index 84% rename from docs-java/process/plugin/ManageTool/items/Ratziel.md rename to docs-java/process/plugin/management-tool/items/ratziel.md index 134b040e1..4d0cbff90 100644 --- a/docs-java/process/plugin/ManageTool/items/Ratziel.md +++ b/docs-java/process/plugin/management-tool/items/ratziel.md @@ -15,4 +15,4 @@ sidebar_position: 5 ::: -插件本体开源付费，详情见 [Github](https://github.com/TheFloodDragon/Ratziel-Beta) 或者 [MineBBS](https://www.minebbs.com/resources/ratziel.12580/) +插件本体开源付费，详情见 [GitHub](https://github.com/TheFloodDragon/Ratziel-Beta) 或者 [MineBBS](https://www.minebbs.com/resources/ratziel.12580/) diff --git a/docs-java/process/plugin/ManageTool/items/SX-Item.md b/docs-java/process/plugin/management-tool/items/sx-item.md similarity index 100% rename from docs-java/process/plugin/ManageTool/items/SX-Item.md rename to docs-java/process/plugin/management-tool/items/sx-item.md diff --git a/docs-java/process/plugin/ManageTool/items/Zaphkiel.md b/docs-java/process/plugin/management-tool/items/zaphkiel.md similarity index 100% rename from docs-java/process/plugin/ManageTool/items/Zaphkiel.md rename to docs-java/process/plugin/management-tool/items/zaphkiel.md diff --git a/docs-java/process/plugin/ManageTool/ManageTool.md b/docs-java/process/plugin/management-tool/management-tool.md similarity index 100% rename from docs-java/process/plugin/ManageTool/ManageTool.md rename to docs-java/process/plugin/management-tool/management-tool.md diff --git a/docs-java/process/plugin/ManageTool/Permission/_images/1.png b/docs-java/process/plugin/management-tool/permission/_images/1.png similarity index 100% rename from docs-java/process/plugin/ManageTool/Permission/_images/1.png rename to docs-java/process/plugin/management-tool/permission/_images/1.png diff --git a/docs-java/process/plugin/ManageTool/Permission/_images/2.png b/docs-java/process/plugin/management-tool/permission/_images/2.png similarity index 100% rename from docs-java/process/plugin/ManageTool/Permission/_images/2.png rename to docs-java/process/plugin/management-tool/permission/_images/2.png diff --git a/docs-java/process/plugin/ManageTool/Permission/_images/3.png b/docs-java/process/plugin/management-tool/permission/_images/3.png similarity index 100% rename from docs-java/process/plugin/ManageTool/Permission/_images/3.png rename to docs-java/process/plugin/management-tool/permission/_images/3.png diff --git a/docs-java/process/plugin/ManageTool/Permission/_images/command.png b/docs-java/process/plugin/management-tool/permission/_images/command.png similarity index 100% rename from docs-java/process/plugin/ManageTool/Permission/_images/command.png rename to docs-java/process/plugin/management-tool/permission/_images/command.png diff --git a/docs-java/process/plugin/ManageTool/Permission/_images/editor.png b/docs-java/process/plugin/management-tool/permission/_images/editor.png similarity index 100% rename from docs-java/process/plugin/ManageTool/Permission/_images/editor.png rename to docs-java/process/plugin/management-tool/permission/_images/editor.png diff --git a/docs-java/process/plugin/ManageTool/Permission/_images/memory_1.png b/docs-java/process/plugin/management-tool/permission/_images/memory_1.png similarity index 100% rename from docs-java/process/plugin/ManageTool/Permission/_images/memory_1.png rename to docs-java/process/plugin/management-tool/permission/_images/memory_1.png diff --git a/docs-java/process/plugin/ManageTool/Permission/_images/memory_10.png b/docs-java/process/plugin/management-tool/permission/_images/memory_10.png similarity index 100% rename from docs-java/process/plugin/ManageTool/Permission/_images/memory_10.png rename to docs-java/process/plugin/management-tool/permission/_images/memory_10.png diff --git a/docs-java/process/plugin/ManageTool/Permission/_images/memory_11.png b/docs-java/process/plugin/management-tool/permission/_images/memory_11.png similarity index 100% rename from docs-java/process/plugin/ManageTool/Permission/_images/memory_11.png rename to docs-java/process/plugin/management-tool/permission/_images/memory_11.png diff --git a/docs-java/process/plugin/ManageTool/Permission/_images/memory_12.png b/docs-java/process/plugin/management-tool/permission/_images/memory_12.png similarity index 100% rename from docs-java/process/plugin/ManageTool/Permission/_images/memory_12.png rename to docs-java/process/plugin/management-tool/permission/_images/memory_12.png diff --git a/docs-java/process/plugin/ManageTool/Permission/_images/memory_2.png b/docs-java/process/plugin/management-tool/permission/_images/memory_2.png similarity index 100% rename from docs-java/process/plugin/ManageTool/Permission/_images/memory_2.png rename to docs-java/process/plugin/management-tool/permission/_images/memory_2.png diff --git a/docs-java/process/plugin/ManageTool/Permission/_images/memory_3.png b/docs-java/process/plugin/management-tool/permission/_images/memory_3.png similarity index 100% rename from docs-java/process/plugin/ManageTool/Permission/_images/memory_3.png rename to docs-java/process/plugin/management-tool/permission/_images/memory_3.png diff --git a/docs-java/process/plugin/ManageTool/Permission/_images/memory_4.png b/docs-java/process/plugin/management-tool/permission/_images/memory_4.png similarity index 100% rename from docs-java/process/plugin/ManageTool/Permission/_images/memory_4.png rename to docs-java/process/plugin/management-tool/permission/_images/memory_4.png diff --git a/docs-java/process/plugin/ManageTool/Permission/_images/memory_5.png b/docs-java/process/plugin/management-tool/permission/_images/memory_5.png similarity index 100% rename from docs-java/process/plugin/ManageTool/Permission/_images/memory_5.png rename to docs-java/process/plugin/management-tool/permission/_images/memory_5.png diff --git a/docs-java/process/plugin/ManageTool/Permission/_images/memory_6.png b/docs-java/process/plugin/management-tool/permission/_images/memory_6.png similarity index 100% rename from docs-java/process/plugin/ManageTool/Permission/_images/memory_6.png rename to docs-java/process/plugin/management-tool/permission/_images/memory_6.png diff --git a/docs-java/process/plugin/ManageTool/Permission/_images/memory_7.png b/docs-java/process/plugin/management-tool/permission/_images/memory_7.png similarity index 100% rename from docs-java/process/plugin/ManageTool/Permission/_images/memory_7.png rename to docs-java/process/plugin/management-tool/permission/_images/memory_7.png diff --git a/docs-java/process/plugin/ManageTool/Permission/_images/memory_8.png b/docs-java/process/plugin/management-tool/permission/_images/memory_8.png similarity index 100% rename from docs-java/process/plugin/ManageTool/Permission/_images/memory_8.png rename to docs-java/process/plugin/management-tool/permission/_images/memory_8.png diff --git a/docs-java/process/plugin/ManageTool/Permission/_images/memory_9.png b/docs-java/process/plugin/management-tool/permission/_images/memory_9.png similarity index 100% rename from docs-java/process/plugin/ManageTool/Permission/_images/memory_9.png rename to docs-java/process/plugin/management-tool/permission/_images/memory_9.png diff --git a/docs-java/process/plugin/ManageTool/Permission/_images/on.png b/docs-java/process/plugin/management-tool/permission/_images/on.png similarity index 100% rename from docs-java/process/plugin/ManageTool/Permission/_images/on.png rename to docs-java/process/plugin/management-tool/permission/_images/on.png diff --git a/docs-java/process/plugin/ManageTool/Permission/_images/paste-1.png b/docs-java/process/plugin/management-tool/permission/_images/paste-1.png similarity index 100% rename from docs-java/process/plugin/ManageTool/Permission/_images/paste-1.png rename to docs-java/process/plugin/management-tool/permission/_images/paste-1.png diff --git a/docs-java/process/plugin/ManageTool/Permission/_images/paste-2.png b/docs-java/process/plugin/management-tool/permission/_images/paste-2.png similarity index 100% rename from docs-java/process/plugin/ManageTool/Permission/_images/paste-2.png rename to docs-java/process/plugin/management-tool/permission/_images/paste-2.png diff --git a/docs-java/process/plugin/ManageTool/Permission/_images/ummm.jpg b/docs-java/process/plugin/management-tool/permission/_images/ummm.jpg similarity index 100% rename from docs-java/process/plugin/ManageTool/Permission/_images/ummm.jpg rename to docs-java/process/plugin/management-tool/permission/_images/ummm.jpg diff --git "a/docs-java/process/plugin/ManageTool/Permission/_images/\346\227\245\345\277\227-1.png" "b/docs-java/process/plugin/management-tool/permission/_images/\346\227\245\345\277\227-1.png" similarity index 100% rename from "docs-java/process/plugin/ManageTool/Permission/_images/\346\227\245\345\277\227-1.png" rename to "docs-java/process/plugin/management-tool/permission/_images/\346\227\245\345\277\227-1.png" diff --git "a/docs-java/process/plugin/ManageTool/Permission/_images/\346\227\245\345\277\227-2.png" "b/docs-java/process/plugin/management-tool/permission/_images/\346\227\245\345\277\227-2.png" similarity index 100% rename from "docs-java/process/plugin/ManageTool/Permission/_images/\346\227\245\345\277\227-2.png" rename to "docs-java/process/plugin/management-tool/permission/_images/\346\227\245\345\277\227-2.png" diff --git "a/docs-java/process/plugin/ManageTool/Permission/_images/\346\255\243\347\273\217\347\254\221+\346\211\213.jpg" "b/docs-java/process/plugin/management-tool/permission/_images/\346\255\243\347\273\217\347\254\221+\346\211\213.jpg" similarity index 100% rename from "docs-java/process/plugin/ManageTool/Permission/_images/\346\255\243\347\273\217\347\254\221+\346\211\213.jpg" rename to "docs-java/process/plugin/management-tool/permission/_images/\346\255\243\347\273\217\347\254\221+\346\211\213.jpg" diff --git a/docs-java/process/plugin/ManageTool/Permission/Command.md b/docs-java/process/plugin/management-tool/permission/command.md similarity index 100% rename from docs-java/process/plugin/ManageTool/Permission/Command.md rename to docs-java/process/plugin/management-tool/permission/command.md diff --git a/docs-java/process/plugin/ManageTool/Permission/Group.md b/docs-java/process/plugin/management-tool/permission/group.md similarity index 91% rename from docs-java/process/plugin/ManageTool/Permission/Group.md rename to docs-java/process/plugin/management-tool/permission/group.md index 901007054..24ecb06b5 100644 --- a/docs-java/process/plugin/ManageTool/Permission/Group.md +++ b/docs-java/process/plugin/management-tool/permission/group.md @@ -21,8 +21,8 @@ sidebar_position: 3 **_默认权限组的权限有好多啊！我懒得重新加权限到新的权限组了，每次有更改还要一起改一大堆！怎么办？_** -我们可以用到**继承**。 +我们可以用到 **继承**。 运行 `/luckperms group NBplus parent add default`，这样就能让 NBplus 权限组继承所有默认权限组中的权限。 -更多请查看：[Luckperms 中文教程](https://izzelaliz.gitbooks.io/luckperms-wiki/content/Usage.html) +更多请查看：[LuckPerms 中文教程](https://izzelaliz.gitbooks.io/luckperms-wiki/content/Usage.html) diff --git a/docs-java/process/plugin/ManageTool/Permission/meta.md b/docs-java/process/plugin/management-tool/permission/meta.md similarity index 92% rename from docs-java/process/plugin/ManageTool/Permission/meta.md rename to docs-java/process/plugin/management-tool/permission/meta.md index 083f73491..74dae0ecc 100644 --- a/docs-java/process/plugin/ManageTool/Permission/meta.md +++ b/docs-java/process/plugin/management-tool/permission/meta.md @@ -11,7 +11,7 @@ sidebar_position: 6 ## 权限 -实际上，你可以给予用户和组 _不存在的_(没有被其他插件使用) 的权限节点 +实际上，你可以给予用户和组 *不存在的* (没有被其他插件使用) 的权限节点 这些权限有着和其他权限一样的性质 @@ -69,7 +69,7 @@ sidebar_position: 6 -用权限的好处是适用性广，不过对 op 不太方便，因为 op 所有权限都是 true 嘛 +用权限的好处是适用性广，不过对 OP 不太方便，因为 OP 所有权限都是 true 嘛 ## 限时权限 @@ -141,13 +141,13 @@ sidebar_position: 6 我给玩家 11h 的限时权限，今日 24 点一过就是无权限状态，那些判断此权限的东西就变成每日刷新了 -实现 (kether)： +实现 (Kether)： 搓命令： -```yaml +```kether inline "lp user {{sender}} permission settemp nitwikit.demo true {{math 24 - time as HH}}h{{math 60 - time as mm}}m{{math 60 - time as ss}}s" ``` @@ -157,7 +157,7 @@ tell 搓出来的看看 执行命令： -```yaml +```kether command inline "lp user {{sender}} permission settemp nitwikit.demo true {{math 24 - time as HH}}h{{math 60 - time as mm}}m{{math 60 - time as ss}}s" as console ``` @@ -193,7 +193,7 @@ command inline "lp user {{sender}} permission settemp nitwikit.demo true {{math ![](_images/memory_10.png) -此方法 op 不受影响，但适用性没权限广，因为一些插件只支持判断权限 +此方法 OP 不受影响，但适用性没权限广，因为一些插件只支持判断权限 :::warning @@ -207,8 +207,7 @@ command inline "lp user {{sender}} permission settemp nitwikit.demo true {{math 但是使用 lp 的命令设置 meta 要写一大串不说，还会输出 log -好在 [Vulpecula](https://github.com/Lanscarlos/Vulpecula) 的 -[memory](https://www.yuque.com/lanscarlos/vulpecula-wiki-v2/og93eqlegc0geyfi) 动作可以用来设置 meta +好在 [Vulpecula](https://github.com/Lanscarlos/Vulpecula) 的 [memory](https://www.yuque.com/lanscarlos/vulpecula-wiki-v2/og93eqlegc0geyfi) 动作可以用来设置 meta ```text memory 键名 to 值 using lp @@ -234,7 +233,7 @@ memory 键名 using lp ### 称号系统 -见 [案例 | Invero|称号系统](../../../plugin/other/Menu/Invero.md) +见 [案例 | Invero|称号系统](../../../plugin/misc/menu/invero.md) ## 限时 meta diff --git a/docs-java/process/plugin/ManageTool/Permission/Permission.md b/docs-java/process/plugin/management-tool/permission/permission.md similarity index 82% rename from docs-java/process/plugin/ManageTool/Permission/Permission.md rename to docs-java/process/plugin/management-tool/permission/permission.md index 09c520bfd..ab358d38c 100644 --- a/docs-java/process/plugin/ManageTool/Permission/Permission.md +++ b/docs-java/process/plugin/management-tool/permission/permission.md @@ -21,11 +21,11 @@ sidebar_position: 1 :::tip[注意] -我们只推荐 Luckperms 作为服务器的权限插件。本文档不会涉及其他任何权限插件。 +我们只推荐 LuckPerms 作为服务器的权限插件。本文档不会涉及其他任何权限插件。 ::: -**不建议使用** Luckperms 以外的权限插件如： +**不建议使用** LuckPerms 以外的权限插件如： - GroupManager - PermissionsEx @@ -49,9 +49,9 @@ sidebar_position: 1 `GitHub` https://github.com/LuckPerms/LuckPerms -`文档(英文)` https://luckperms.net/wiki/Home +`文档 (英文)` https://luckperms.net/wiki/Home -`文档(中文)` https://continue-project.netlify.app/LuckPerms +`文档 (中文)` https://continue-project.netlify.app/LuckPerms `插件百科` https://mineplugin.org/LuckPerms @@ -71,6 +71,6 @@ sidebar_position: 1 ## 存储方式 -LuckPerms 可以使用 yml 文件存储数据，易于编辑，但我推荐使用 h2（默认）或者连接数据库使用。 +LuckPerms 可以使用 YAML 格式存储数据，易于编辑，但我推荐使用 H2（默认）或者连接数据库使用。 如果你想更改存储方式，可见：https://continue-project.netlify.app/LuckPerms/storage.html diff --git a/docs-java/process/plugin/ManageTool/Permission/Tips.md b/docs-java/process/plugin/management-tool/permission/tips.md similarity index 100% rename from docs-java/process/plugin/ManageTool/Permission/Tips.md rename to docs-java/process/plugin/management-tool/permission/tips.md diff --git a/docs-java/process/plugin/ManageTool/Permission/WhatIsPermission.md b/docs-java/process/plugin/management-tool/permission/what-is-permission.md similarity index 85% rename from docs-java/process/plugin/ManageTool/Permission/WhatIsPermission.md rename to docs-java/process/plugin/management-tool/permission/what-is-permission.md index ac62734aa..058ba2380 100644 --- a/docs-java/process/plugin/ManageTool/Permission/WhatIsPermission.md +++ b/docs-java/process/plugin/management-tool/permission/what-is-permission.md @@ -43,8 +43,8 @@ undefined 表示权限未在 LuckPerms 中明确设置。 在极少数情况下，插件会将未定义的权限默认为 true，在这种情况下，你需要将其明确设置为 false。 -### op 是不是拥有所有权限？？ +### OP 是不是拥有所有权限？？ -当然了！不过你可以给这名 op 玩家明确设置某权限是 false。 +当然了！不过你可以给这名 OP 玩家明确设置某权限是 false。 -不过不建议直接给管理人员 op，分职其责给特定的权限就好。 +不过不建议直接给管理人员 OP，分职其责给特定的权限就好。 diff --git a/docs-java/process/plugin/ManageTool/PluginManagement/PluginManagement.md b/docs-java/process/plugin/management-tool/plugin-management/plugin-management.md similarity index 100% rename from docs-java/process/plugin/ManageTool/PluginManagement/PluginManagement.md rename to docs-java/process/plugin/management-tool/plugin-management/plugin-management.md diff --git a/docs-java/process/plugin/ManageTool/PluginManagement/Plugin Portal.md b/docs-java/process/plugin/management-tool/plugin-management/plugin-portal.md similarity index 100% rename from docs-java/process/plugin/ManageTool/PluginManagement/Plugin Portal.md rename to docs-java/process/plugin/management-tool/plugin-management/plugin-portal.md diff --git a/docs-java/process/plugin/management-tool/plugin-management/plugmanx.md b/docs-java/process/plugin/management-tool/plugin-management/plugmanx.md new file mode 100644 index 000000000..3ba5e270b --- /dev/null +++ b/docs-java/process/plugin/management-tool/plugin-management/plugmanx.md @@ -0,0 +1,20 @@ +--- +title: PlugMan +sidebar_position: 2 +--- + +# PlugMan + +:::info + +`Bukkit (旧)` https://dev.bukkit.org/projects/plugman + +`SpigotMC` https://www.spigotmc.org/resources/.88135/ + +`GitHub (旧)` https://github.com/ryan-clancy/PlugMan + +`GitHub (新)` https://github.com/Test-Account666/PlugManX + +::: + +老牌插件管理插件。 diff --git a/docs-java/process/plugin/ManageTool/PluginManagement/ServerUtils.md b/docs-java/process/plugin/management-tool/plugin-management/serverutils.md similarity index 100% rename from docs-java/process/plugin/ManageTool/PluginManagement/ServerUtils.md rename to docs-java/process/plugin/management-tool/plugin-management/serverutils.md diff --git a/docs-java/process/plugin/ManageTool/PluginManagement/Yum.md b/docs-java/process/plugin/management-tool/plugin-management/yum.md similarity index 100% rename from docs-java/process/plugin/ManageTool/PluginManagement/Yum.md rename to docs-java/process/plugin/management-tool/plugin-management/yum.md diff --git a/docs-java/process/plugin/ManageTool/task/_images/TypeWriter/TW_Banner_Transparant.png b/docs-java/process/plugin/management-tool/task/_images/TypeWriter/TW_Banner_Transparant.png similarity index 100% rename from docs-java/process/plugin/ManageTool/task/_images/TypeWriter/TW_Banner_Transparant.png rename to docs-java/process/plugin/management-tool/task/_images/TypeWriter/TW_Banner_Transparant.png diff --git a/docs-java/process/plugin/ManageTool/task/_images/TypeWriter/cinematic.gif b/docs-java/process/plugin/management-tool/task/_images/TypeWriter/cinematic.gif similarity index 100% rename from docs-java/process/plugin/ManageTool/task/_images/TypeWriter/cinematic.gif rename to docs-java/process/plugin/management-tool/task/_images/TypeWriter/cinematic.gif diff --git a/docs-java/process/plugin/ManageTool/task/BeautyQuests.md b/docs-java/process/plugin/management-tool/task/beautyquests.md similarity index 100% rename from docs-java/process/plugin/ManageTool/task/BeautyQuests.md rename to docs-java/process/plugin/management-tool/task/beautyquests.md diff --git a/docs-java/process/plugin/ManageTool/task/BetonQuest.md b/docs-java/process/plugin/management-tool/task/betonquest.md similarity index 67% rename from docs-java/process/plugin/ManageTool/task/BetonQuest.md rename to docs-java/process/plugin/management-tool/task/betonquest.md index c7fb46ee0..d945682ce 100644 --- a/docs-java/process/plugin/ManageTool/task/BetonQuest.md +++ b/docs-java/process/plugin/management-tool/task/betonquest.md @@ -13,8 +13,8 @@ sidebar_position: 4 `GitHub` https://github.com/BetonQuest/BetonQuest -`文档(英文)` https://betonquest.org +`文档 (英文)` https://betonquest.org -`文档(中文)` https://miao-3.gitbook.io/betonquest-zhong-wen-wiki +`文档 (中文)` https://miao-3.gitbook.io/betonquest-zhong-wen-wiki ::: diff --git a/docs-java/process/plugin/ManageTool/task/Chemdah.md b/docs-java/process/plugin/management-tool/task/chemdah.md similarity index 97% rename from docs-java/process/plugin/ManageTool/task/Chemdah.md rename to docs-java/process/plugin/management-tool/task/chemdah.md index c4f8d884b..bcff3ad35 100644 --- a/docs-java/process/plugin/ManageTool/task/Chemdah.md +++ b/docs-java/process/plugin/management-tool/task/chemdah.md @@ -25,7 +25,7 @@ sidebar_position: 1 官方文档并不完善，使用此插件你可能需要付费购买第三方文档（WTF？？） -如果你对这一切感到不满，可以试试竞品 [TypeWriter](TypeWriter.md) +如果你对这一切感到不满，可以试试竞品 [TypeWriter](typewriter.md) ## Bstats diff --git a/docs-java/process/plugin/ManageTool/task/MangoQuest.md b/docs-java/process/plugin/management-tool/task/mangoquest.md similarity index 100% rename from docs-java/process/plugin/ManageTool/task/MangoQuest.md rename to docs-java/process/plugin/management-tool/task/mangoquest.md diff --git a/docs-java/process/plugin/ManageTool/task/PlayerTask.md b/docs-java/process/plugin/management-tool/task/playertask.md similarity index 100% rename from docs-java/process/plugin/ManageTool/task/PlayerTask.md rename to docs-java/process/plugin/management-tool/task/playertask.md diff --git a/docs-java/process/plugin/ManageTool/task/QuestCreator.md b/docs-java/process/plugin/management-tool/task/questcreator.md similarity index 100% rename from docs-java/process/plugin/ManageTool/task/QuestCreator.md rename to docs-java/process/plugin/management-tool/task/questcreator.md diff --git a/docs-java/process/plugin/ManageTool/task/QuestEngine.md b/docs-java/process/plugin/management-tool/task/questengine.md similarity index 100% rename from docs-java/process/plugin/ManageTool/task/QuestEngine.md rename to docs-java/process/plugin/management-tool/task/questengine.md diff --git a/docs-java/process/plugin/ManageTool/task/Quests.md b/docs-java/process/plugin/management-tool/task/quests.md similarity index 100% rename from docs-java/process/plugin/ManageTool/task/Quests.md rename to docs-java/process/plugin/management-tool/task/quests.md diff --git a/docs-java/process/plugin/ManageTool/task/task.md b/docs-java/process/plugin/management-tool/task/task.md similarity index 94% rename from docs-java/process/plugin/ManageTool/task/task.md rename to docs-java/process/plugin/management-tool/task/task.md index 244ce54c5..12926739d 100644 --- a/docs-java/process/plugin/ManageTool/task/task.md +++ b/docs-java/process/plugin/management-tool/task/task.md @@ -34,17 +34,17 @@ sidebar_position: 9 | 本地化支持 | ✅ | ✅ | ✅ | ✅ | ✅ | ❌ | | 活跃开发 | ✅ | ✅ | ✅ | ✅ | ✅ | ❌ | | 开源 | ✅ | ✅ | ✅ | ✅ | ✅ | ❌ | -| 支持1.13+ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | +| 支持 1.13+ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | | 数据库支持 | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | | 变量支持 | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | | 任务编辑器 | ❌ | ✅ | ✅ | ✅ | ✅ | ✅ | | 多分支对话 | ✅ | ❌ | ❌ | ✅ | ✅ | ✅ | -| 脚本API | ✅ | ✅ | ✅ | ✅ | ❌ | ✅ | +| 脚本 API | ✅ | ✅ | ✅ | ✅ | ❌ | ✅ | | 可重复任务 | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | | 对话系统 | ✅ | ✅ | ❌ | ✅ | ✅ | ✅ | | 团队任务 | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | -| NPC支持 | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | -| 客户端NPC | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | +| NPC 支持 | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | +| 客户端 NPC | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | | 客户端全息图 | ✅ | ❌ | ❌ | ❌ | ✅ | ✅ | | 客户端粒子效果 | ✅ | ❌ | ❌ | ❌ | ✅ | ✅ | | 玩家隐藏 | ✅ | ❌ | ❌ | ❌ | ✅ | ❌ | diff --git a/docs-java/process/plugin/ManageTool/task/TypeWriter.md b/docs-java/process/plugin/management-tool/task/typewriter.md similarity index 93% rename from docs-java/process/plugin/ManageTool/task/TypeWriter.md rename to docs-java/process/plugin/management-tool/task/typewriter.md index c9d76005f..72c011f09 100644 --- a/docs-java/process/plugin/ManageTool/task/TypeWriter.md +++ b/docs-java/process/plugin/management-tool/task/typewriter.md @@ -31,9 +31,9 @@ TypeWriter 是一款适用于 Paper 服务端的插件，它能通过简洁而 `MineBBS` https://www.minebbs.com/resources/.7951 -`文档(英文)` https://docs.typewritermc.com +`文档 (英文)` https://docs.typewritermc.com -`文档(中文)` https://typewriter.8aka.org +`文档 (中文)` https://typewriter.8aka.org ::: diff --git a/docs-java/process/plugin/other/_images/QuickShop.jpg b/docs-java/process/plugin/misc/_images/QuickShop.jpg similarity index 100% rename from docs-java/process/plugin/other/_images/QuickShop.jpg rename to docs-java/process/plugin/misc/_images/QuickShop.jpg diff --git a/docs-java/process/plugin/other/Holograms/_images/DecentHolograms/DecentHolograms_1.png b/docs-java/process/plugin/misc/holograms/_images/DecentHolograms/DecentHolograms_1.png similarity index 100% rename from docs-java/process/plugin/other/Holograms/_images/DecentHolograms/DecentHolograms_1.png rename to docs-java/process/plugin/misc/holograms/_images/DecentHolograms/DecentHolograms_1.png diff --git a/docs-java/process/plugin/other/Holograms/_images/DecentHolograms/DecentHolograms_2.png b/docs-java/process/plugin/misc/holograms/_images/DecentHolograms/DecentHolograms_2.png similarity index 100% rename from docs-java/process/plugin/other/Holograms/_images/DecentHolograms/DecentHolograms_2.png rename to docs-java/process/plugin/misc/holograms/_images/DecentHolograms/DecentHolograms_2.png diff --git a/docs-java/process/plugin/other/Holograms/_images/DecentHolograms/DecentHolograms_3.png b/docs-java/process/plugin/misc/holograms/_images/DecentHolograms/DecentHolograms_3.png similarity index 100% rename from docs-java/process/plugin/other/Holograms/_images/DecentHolograms/DecentHolograms_3.png rename to docs-java/process/plugin/misc/holograms/_images/DecentHolograms/DecentHolograms_3.png diff --git a/docs-java/process/plugin/other/Holograms/_images/DecentHolograms/DecentHolograms_4.png b/docs-java/process/plugin/misc/holograms/_images/DecentHolograms/DecentHolograms_4.png similarity index 100% rename from docs-java/process/plugin/other/Holograms/_images/DecentHolograms/DecentHolograms_4.png rename to docs-java/process/plugin/misc/holograms/_images/DecentHolograms/DecentHolograms_4.png diff --git a/docs-java/process/plugin/other/Holograms/_images/DecentHolograms/DecentHolograms_5.png b/docs-java/process/plugin/misc/holograms/_images/DecentHolograms/DecentHolograms_5.png similarity index 100% rename from docs-java/process/plugin/other/Holograms/_images/DecentHolograms/DecentHolograms_5.png rename to docs-java/process/plugin/misc/holograms/_images/DecentHolograms/DecentHolograms_5.png diff --git a/docs-java/process/plugin/other/Holograms/_images/DecentHolograms/DecentHolograms_6.png b/docs-java/process/plugin/misc/holograms/_images/DecentHolograms/DecentHolograms_6.png similarity index 100% rename from docs-java/process/plugin/other/Holograms/_images/DecentHolograms/DecentHolograms_6.png rename to docs-java/process/plugin/misc/holograms/_images/DecentHolograms/DecentHolograms_6.png diff --git "a/docs-java/process/plugin/other/Holograms/_images/hd\345\267\262\347\273\217\345\275\222\346\241\243.png" "b/docs-java/process/plugin/misc/holograms/_images/hd\345\267\262\347\273\217\345\275\222\346\241\243.png" similarity index 100% rename from "docs-java/process/plugin/other/Holograms/_images/hd\345\267\262\347\273\217\345\275\222\346\241\243.png" rename to "docs-java/process/plugin/misc/holograms/_images/hd\345\267\262\347\273\217\345\275\222\346\241\243.png" diff --git a/docs-java/process/plugin/other/Holograms/_images/holo.png b/docs-java/process/plugin/misc/holograms/_images/holo.png similarity index 100% rename from docs-java/process/plugin/other/Holograms/_images/holo.png rename to docs-java/process/plugin/misc/holograms/_images/holo.png diff --git a/docs-java/process/plugin/other/Holograms/DecentHolograms.md b/docs-java/process/plugin/misc/holograms/decentholograms.md similarity index 73% rename from docs-java/process/plugin/other/Holograms/DecentHolograms.md rename to docs-java/process/plugin/misc/holograms/decentholograms.md index 27ffcbc57..910481369 100644 --- a/docs-java/process/plugin/other/Holograms/DecentHolograms.md +++ b/docs-java/process/plugin/misc/holograms/decentholograms.md @@ -5,18 +5,10 @@ sidebar_position: 2 # DecentHolograms - - Release - - - Downloads - - - Code Size - - - License - +[![Release](https://img.shields.io/github/v/release/DecentSoftware-eu/DecentHolograms)](https://github.com/DecentSoftware-eu/DecentHolograms/releases) +[![Downloads](https://img.shields.io/spiget/downloads/96927?label=Downloads)](https://www.spigotmc.org/resources/.96927) +[![Code Size](https://img.shields.io/github/languages/code-size/DecentSoftware-eu/DecentHolograms)](https://github.com/DecentSoftware-eu/DecentHolograms) +[![License](https://img.shields.io/github/license/DecentSoftware-eu/DecentHolograms)](https://github.com/DecentSoftware-eu/DecentHolograms/blob/main/LICENSE) ```text 一个轻量级但功能强大的全息图插件，具有许多功能和配置项。 @@ -61,13 +53,13 @@ sidebar_position: 2 但搬运者（我）有一点歪门邪道 - AdvancedGUI“文本"固定，不再转向玩家 -- [资源包做字体（ia 文档）](https://itemsadder.devs.beer/v/chinese/plugin-usage/adding-content/fonts) 使用资源包来改变字体 +- [资源包做字体（IA 文档）](https://itemsadder.devs.beer/v/chinese/plugin-usage/adding-content/fonts) 使用资源包来改变字体 ## 汉化 插件命令帮助写死在代码里了，不能在语言文件汉化 -你可以在 MineBBS 或我 fork 的仓库的 GitHub actions 下载内核汉化版本 +你可以在 MineBBS 或我 Fork 的仓库的 GitHub Actions 下载内核汉化版本 汉化仓库：https://github.com/postyizhan/DecentHolograms-CN @@ -83,16 +75,16 @@ sidebar_position: 2 `MineBBS` https://www.minebbs.com/resources/.9059 -`文档(英文)` https://wiki.decentholograms.eu +`文档 (英文)` https://wiki.decentholograms.eu -`文档(中文)` https://continue-project.netlify.app/DecentHolograms +`文档 (中文)` https://continue-project.netlify.app/DecentHolograms ::: ## 贡献 ![](https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat) ​ -欢迎提交 pr！但对于重大的更改，请先创建一个 issues 来讨论此更改 +欢迎提交 PR！但对于重大的更改，请先创建一个 Issue 来讨论此更改 ## 构建 diff --git a/docs-java/process/plugin/other/Holograms/Holograms.md b/docs-java/process/plugin/misc/holograms/holograms.md similarity index 100% rename from docs-java/process/plugin/other/Holograms/Holograms.md rename to docs-java/process/plugin/misc/holograms/holograms.md diff --git a/docs-java/process/plugin/other/Holograms/HolographicDisplays.md b/docs-java/process/plugin/misc/holograms/holographicdisplays.md similarity index 83% rename from docs-java/process/plugin/other/Holograms/HolographicDisplays.md rename to docs-java/process/plugin/misc/holograms/holographicdisplays.md index 808c546ac..c8e493240 100644 --- a/docs-java/process/plugin/other/Holograms/HolographicDisplays.md +++ b/docs-java/process/plugin/misc/holograms/holographicdisplays.md @@ -15,7 +15,7 @@ sidebar_position: 3 ::: -老牌全息图插件，不过咱建议用 [DecentHolograms](DecentHolograms.md) +老牌全息图插件，不过咱建议用 [DecentHolograms](decentholograms.md) ## 停更 diff --git a/docs-java/process/plugin/other/Login/Authme.md b/docs-java/process/plugin/misc/login/authme.md similarity index 54% rename from docs-java/process/plugin/other/Login/Authme.md rename to docs-java/process/plugin/misc/login/authme.md index 42d6f2159..303099550 100644 --- a/docs-java/process/plugin/other/Login/Authme.md +++ b/docs-java/process/plugin/misc/login/authme.md @@ -15,13 +15,13 @@ sidebar_position: 2 `Modrinth` https://modrinth.com/plugin/authmereloaded -`GitHub(原版)` https://github.com/AuthMe/AuthMeReloaded +`GitHub (原版)` https://github.com/AuthMe/AuthMeReloaded -`GitHub(电棍的fork)` https://github.com/HaHaWTH/AuthMeReReloaded +`GitHub (HaHaWTH 的 fork)` https://github.com/HaHaWTH/AuthMeReReloaded -`文档(英文)` https://github.com/AuthMe/AuthMeReloaded/wiki +`文档 (英文)` https://github.com/AuthMe/AuthMeReloaded/wiki -`文档(中文)` https://pluginscdtribe.github.io/wiki/authme +`文档 (中文)` https://pluginscdtribe.github.io/wiki/authme `插件百科` https://mineplugin.org/Authme @@ -29,13 +29,13 @@ sidebar_position: 2 老牌登录插件 Authme -建议使用[电棍的 fork](https://github.com/HaHaWTH/AuthMeReReloaded)，这是它的[中文介绍](https://github.com/HaHaWTH/AuthMeReReloaded/blob/master/README-zh.md) +建议使用 HaHaWTH 佬的 [AuthMeReReloaded](https://github.com/HaHaWTH/AuthMeReReloaded)，这是它的 [中文介绍](https://github.com/HaHaWTH/AuthMeReReloaded/blob/master/README-zh.md) 如果你也使用了跨服端，请在跨服端安装对应的 AuthMe [AuthMeBungee](https://www.spigotmc.org/resources/.50219/) -[AuthMeVelocity](../../../../process/cross-server/plugin/cross-only.md#authmevelocity) +[AuthMeVelocity](../../../../process/cross-server/plugin/proxy-only.md#authmevelocity) ## 扩展 diff --git a/docs-java/process/plugin/other/Login/CatSeedLogin.md b/docs-java/process/plugin/misc/login/catseedlogin.md similarity index 83% rename from docs-java/process/plugin/other/Login/CatSeedLogin.md rename to docs-java/process/plugin/misc/login/catseedlogin.md index 91bd510f8..38aa908a7 100644 --- a/docs-java/process/plugin/other/Login/CatSeedLogin.md +++ b/docs-java/process/plugin/misc/login/catseedlogin.md @@ -9,7 +9,7 @@ sidebar_position: 3 `GitHub` https://github.com/CatSeed/CatSeedLogin -`GitHub(fork)` https://github.com/zhinghu/CatSeedLogin +`GitHub (fork)` https://github.com/zhinghu/CatSeedLogin ::: diff --git a/docs-java/process/plugin/other/Login/LibreLogin.md b/docs-java/process/plugin/misc/login/librelogin.md similarity index 100% rename from docs-java/process/plugin/other/Login/LibreLogin.md rename to docs-java/process/plugin/misc/login/librelogin.md diff --git a/docs-java/process/plugin/other/Login/LimboAuth.md b/docs-java/process/plugin/misc/login/limboauth.md similarity index 87% rename from docs-java/process/plugin/other/Login/LimboAuth.md rename to docs-java/process/plugin/misc/login/limboauth.md index e50f91a07..02b7e932c 100644 --- a/docs-java/process/plugin/other/Login/LimboAuth.md +++ b/docs-java/process/plugin/misc/login/limboauth.md @@ -25,7 +25,7 @@ sidebar_position: 4 :::danger -**不要** 在你的 _Spigot/Paper_ 或者 _BungeeCord/Waterfall_ 端上 **安装此插件!!!** +**不要** 在你的 *Spigot/Paper* 或者 *BungeeCord/Waterfall* 端上 **安装此插件!!!** ::: diff --git a/docs-java/process/plugin/other/Login/Login.md b/docs-java/process/plugin/misc/login/login.md similarity index 100% rename from docs-java/process/plugin/other/Login/Login.md rename to docs-java/process/plugin/misc/login/login.md diff --git "a/docs-java/process/plugin/other/Menu/_images/TrMenu/trm\344\270\200\345\256\232\350\246\201\347\234\213wiki\345\221\220.jpg" "b/docs-java/process/plugin/misc/menu/_images/TrMenu/trm\344\270\200\345\256\232\350\246\201\347\234\213wiki\345\221\220.jpg" similarity index 100% rename from "docs-java/process/plugin/other/Menu/_images/TrMenu/trm\344\270\200\345\256\232\350\246\201\347\234\213wiki\345\221\220.jpg" rename to "docs-java/process/plugin/misc/menu/_images/TrMenu/trm\344\270\200\345\256\232\350\246\201\347\234\213wiki\345\221\220.jpg" diff --git "a/docs-java/process/plugin/other/Menu/_images/\344\270\272\351\232\276.jpg" "b/docs-java/process/plugin/misc/menu/_images/\344\270\272\351\232\276.jpg" similarity index 100% rename from "docs-java/process/plugin/other/Menu/_images/\344\270\272\351\232\276.jpg" rename to "docs-java/process/plugin/misc/menu/_images/\344\270\272\351\232\276.jpg" diff --git "a/docs-java/process/plugin/other/Menu/_images/\345\255\220\345\233\276\346\240\207\345\206\231\345\212\250\344\275\234.png" "b/docs-java/process/plugin/misc/menu/_images/\345\255\220\345\233\276\346\240\207\345\206\231\345\212\250\344\275\234.png" similarity index 100% rename from "docs-java/process/plugin/other/Menu/_images/\345\255\220\345\233\276\346\240\207\345\206\231\345\212\250\344\275\234.png" rename to "docs-java/process/plugin/misc/menu/_images/\345\255\220\345\233\276\346\240\207\345\206\231\345\212\250\344\275\234.png" diff --git a/docs-java/process/plugin/other/Menu/ChestCommands.md b/docs-java/process/plugin/misc/menu/chestcommands.md similarity index 75% rename from docs-java/process/plugin/other/Menu/ChestCommands.md rename to docs-java/process/plugin/misc/menu/chestcommands.md index 9758e4b37..4b32c9e0e 100644 --- a/docs-java/process/plugin/other/Menu/ChestCommands.md +++ b/docs-java/process/plugin/misc/menu/chestcommands.md @@ -11,9 +11,9 @@ sidebar_position: 2 `GitHub` https://github.com/filoghost/ChestCommands -`文档(英文)` https://filoghost.me/docs/chest-commands +`文档 (英文)` https://filoghost.me/docs/chest-commands -`文档(中文)` https://plugins.8aka.org/ChestCommands/intro +`文档 (中文)` https://plugins.8aka.org/ChestCommands/intro ::: diff --git a/docs-java/process/plugin/other/Menu/DeluxeMenus.md b/docs-java/process/plugin/misc/menu/deluxemenus.md similarity index 59% rename from docs-java/process/plugin/other/Menu/DeluxeMenus.md rename to docs-java/process/plugin/misc/menu/deluxemenus.md index b18c0b4fb..167b13a8d 100644 --- a/docs-java/process/plugin/other/Menu/DeluxeMenus.md +++ b/docs-java/process/plugin/misc/menu/deluxemenus.md @@ -11,8 +11,8 @@ sidebar_position: 3 `GitHub` https://github.com/HelpChat/DeluxeMenus -`文档(英文)` https://wiki.helpch.at/helpchat-plugins/deluxemenus +`文档 (英文)` https://wiki.helpch.at/helpchat-plugins/deluxemenus -`文档(中文)` https://deluxemenu.wiki.complexstudio.net +`文档 (中文)` https://deluxemenu.wiki.complexstudio.net ::: diff --git a/docs-java/process/plugin/other/Menu/Invero.md b/docs-java/process/plugin/misc/menu/invero.md similarity index 100% rename from docs-java/process/plugin/other/Menu/Invero.md rename to docs-java/process/plugin/misc/menu/invero.md diff --git a/docs-java/process/plugin/other/Menu/Menu.md b/docs-java/process/plugin/misc/menu/menu.md similarity index 100% rename from docs-java/process/plugin/other/Menu/Menu.md rename to docs-java/process/plugin/misc/menu/menu.md diff --git a/docs-java/process/plugin/other/Menu/TrMenu.md b/docs-java/process/plugin/misc/menu/trmenu.md similarity index 82% rename from docs-java/process/plugin/other/Menu/TrMenu.md rename to docs-java/process/plugin/misc/menu/trmenu.md index 253b1f78a..076a9d401 100644 --- a/docs-java/process/plugin/other/Menu/TrMenu.md +++ b/docs-java/process/plugin/misc/menu/trmenu.md @@ -7,18 +7,10 @@ sidebar_position: 4 ![](https://gitee.com/postyizhan/images-hosting/releases/download/gif/animation.gif) - - Release - - - Downloads - - - Code Size - - - License - +[![Release](https://img.shields.io/github/v/release/CoderKuo/TrMenu)](https://github.com/CoderKuo/TrMenu/releases) +[![Downloads](https://img.shields.io/github/downloads/CoderKuo/TrMenu/total)](https://github.com/CoderKuo/TrMenu/releases) +[![Code Size](https://img.shields.io/github/languages/code-size/CoderKuo/TrMenu)](https://github.com/CoderKuo/TrMenu) +[![License](https://img.shields.io/badge/license-TrMenu-lightgreen.svg)](https://github.com/CoderKuo/TrMenu/blob/stable/v3/LICENSE.md) ```text 一个功能强大的菜单插件，国人插件。目前由社区维护。 @@ -30,7 +22,7 @@ sidebar_position: 4 - 支持 1.8.9 ~ 最新版本 - 修复头颅显示问题 -- [国际化语言](https://github.com/Dreeam-qwq/TrMenu/pull/64) +- [国际化语言](https://github.com/CoderKuo/TrMenu/pull/64) - 更多功能... Notice：维护这个分支完全是个人兴趣。 @@ -41,7 +33,7 @@ Notice：维护这个分支完全是个人兴趣。 - 大量的模块已经确认拥有更好的性能，同时提供了一个特别的方式来检测 TrMenu 的性能表现 - 一如既往的强大功能：几乎所有功能都经过优化和保留，并添加了新功能。 - 功能与脚本：统一并标准化了内联函数的使用，重构了 TrMenu 动作，并全面支持新的 kether 脚本语言。 -- 更多信息：请看 wiki +- 更多信息：请看 Wiki ## 链接 @@ -63,9 +55,9 @@ Notice：维护这个分支完全是个人兴趣。 `MineBBS` https://www.minebbs.com/resources/trmenu-bug.9080/ -`GitHub(不推荐，已停止维护)` https://github.com/TrPlugins/TrMenu/tree/stable/v3 +`GitHub (不推荐，已停止维护)` https://github.com/TrPlugins/TrMenu/tree/stable/v3 -`GitHub(推荐，社区维护)` https://github.com/CoderKuo/TrMenu +`GitHub (推荐，社区维护)` https://github.com/CoderKuo/TrMenu ::: @@ -101,9 +93,9 @@ TrMenu 入门学习文档 ![](_images/TrMenu/trm一定要看wiki呐.jpg) -## vscode 插件 +## VS Code 插件 -与 TrMenu 或 [kether](/Java/lang/kether) 有关的 vscode 插件 +与 TrMenu 或 [Kether](../../../maintenance/lang/kether/basic.md) 有关的 VS Code 插件 - [TrMenu-Helper](https://marketplace.visualstudio.com/items?itemName=hhhhhy.trmenu-helper) @@ -111,7 +103,7 @@ TrMenu 语法提示 - [kether-snippet](https://marketplace.visualstudio.com/items?itemName=LiteCat.kether-snippet) -kether 语法提示 +Kether 语法提示 ## bStats​ @@ -121,7 +113,7 @@ kether 语法提示 :::warning -请使用 最新的 **TrMenu 社区版** 不保证**旧**版本可用性 +请使用 最新的 **TrMenu 社区版** 不保证 **旧** 版本可用性 ::: @@ -147,7 +139,7 @@ kether 语法提示 #### 子图标写动作 -因为 `condition` 会执行里面的 kether 语句 +因为 `condition` 会执行里面的 Kether 语句 所以你可以这样子在菜单打开或重新计算子图标的时候跑一遍这些语句 @@ -227,9 +219,9 @@ Sneaking-Offhand: :::tip -你需要安装 [CheckItem](/Java/process/plugin/Front-Plugin/PlaceHolderAPI/CheckItem) +你需要安装 [CheckItem](../../plugin-dependencies/placeholderapi/check-item.md) -并 [开启 give 和 remove](/Java/process/plugin/Front-Plugin/PlaceHolderAPI/CheckItem#启用-give-和-remove) 和 [更改-boolean](/Java/process/plugin/Front-Plugin/PlaceHolderAPI/Q&A#更改-boolean) +并 [开启 give 和 remove](../../plugin-dependencies/placeholderapi/check-item.md#启用-give-和-remove) 和 [更改-boolean](../../plugin-dependencies/placeholderapi/faq.md#更改-boolean) ::: @@ -238,8 +230,8 @@ Sneaking-Offhand: **知识点：** - TrMenu 文档熟读并背诵 -- [kether](/Java/process/maintenance/lang/kether/basic) -- [CheckItem](/Java/process/plugin/Front-Plugin/PlaceHolderAPI/CheckItem) +- [kether](../../../maintenance/lang/kether/basic.md) +- [CheckItem](../../plugin-dependencies/placeholderapi/check-item.md) ```yaml "写法1": @@ -294,8 +286,8 @@ Sneaking-Offhand: **知识点：** - TrMenu 文档熟读并背诵 -- [kether](/Java/process/maintenance/lang/kether/basic) -- [CheckItem](../../Front-Plugin/PlaceHolderAPI/CheckItem) +- [kether](../../../maintenance/lang/kether/basic.md) +- [CheckItem](../../plugin-dependencies/placeholderapi/check-item.md) - [妙妙写法](#妙妙写法) - [\{condition=\}条件](https://hhhhhy.gitbook.io/trmenu-v3/menu/action/option#tiao-jian) diff --git a/docs-java/process/plugin/other/Other.md b/docs-java/process/plugin/misc/misc.md similarity index 100% rename from docs-java/process/plugin/other/Other.md rename to docs-java/process/plugin/misc/misc.md diff --git a/docs-java/process/plugin/other/money.md b/docs-java/process/plugin/misc/money.md similarity index 100% rename from docs-java/process/plugin/other/money.md rename to docs-java/process/plugin/misc/money.md diff --git a/docs-java/process/plugin/other/MOTD/MiniMOTD.md b/docs-java/process/plugin/misc/motd/minimotd.md similarity index 83% rename from docs-java/process/plugin/other/MOTD/MiniMOTD.md rename to docs-java/process/plugin/misc/motd/minimotd.md index 1a84a76e2..cc8c65080 100644 --- a/docs-java/process/plugin/other/MOTD/MiniMOTD.md +++ b/docs-java/process/plugin/misc/motd/minimotd.md @@ -15,7 +15,7 @@ sidebar_position: 2 `GitHub` https://github.com/jpenilla/MiniMOTD -`文档(英文)` https://github.com/jpenilla/MiniMOTD/wiki +`文档 (英文)` https://github.com/jpenilla/MiniMOTD/wiki ::: diff --git a/docs-java/process/plugin/other/MOTD/MOTD.md b/docs-java/process/plugin/misc/motd/motd.md similarity index 100% rename from docs-java/process/plugin/other/MOTD/MOTD.md rename to docs-java/process/plugin/misc/motd/motd.md diff --git a/docs-java/process/plugin/other/MythicMobs.md b/docs-java/process/plugin/misc/mythicmobs.md similarity index 82% rename from docs-java/process/plugin/other/MythicMobs.md rename to docs-java/process/plugin/misc/mythicmobs.md index ab9bc73c1..efd15f2ce 100644 --- a/docs-java/process/plugin/other/MythicMobs.md +++ b/docs-java/process/plugin/misc/mythicmobs.md @@ -16,9 +16,9 @@ sidebar_label: 实体 - MythicMobs `Modrinth` https://modrinth.com/plugin/mythicmobs -`文档(英文)` https://git.mythiccraft.io/mythiccraft/MythicMobs/-/wikis/home +`文档 (英文)` https://git.mythiccraft.io/mythiccraft/MythicMobs/-/wikis/home -`文档(中文)` https://gitlab.com/TranslatedByShark/Mythic-Manual-CN/-/wikis/home +`文档 (中文)` https://gitlab.com/TranslatedByShark/Mythic-Manual-CN/-/wikis/home `插件百科` https://mineplugin.org/MythicMobs/Mobs diff --git a/docs-java/process/plugin/other/npc/_images/Adyeshach/Adyeshach-1.png b/docs-java/process/plugin/misc/npc/_images/Adyeshach/Adyeshach-1.png similarity index 100% rename from docs-java/process/plugin/other/npc/_images/Adyeshach/Adyeshach-1.png rename to docs-java/process/plugin/misc/npc/_images/Adyeshach/Adyeshach-1.png diff --git a/docs-java/process/plugin/other/npc/_images/Citizens/Citizens-1.png b/docs-java/process/plugin/misc/npc/_images/Citizens/Citizens-1.png similarity index 100% rename from docs-java/process/plugin/other/npc/_images/Citizens/Citizens-1.png rename to docs-java/process/plugin/misc/npc/_images/Citizens/Citizens-1.png diff --git a/docs-java/process/plugin/other/npc/Adyeshach.md b/docs-java/process/plugin/misc/npc/adyeshach.md similarity index 69% rename from docs-java/process/plugin/other/npc/Adyeshach.md rename to docs-java/process/plugin/misc/npc/adyeshach.md index 49e4ad654..4e87d4b77 100644 --- a/docs-java/process/plugin/other/npc/Adyeshach.md +++ b/docs-java/process/plugin/misc/npc/adyeshach.md @@ -6,15 +6,9 @@ sidebar_position: 4 ![](_images/Adyeshach/Adyeshach-1.png) - - Forks - - - License - - - License - +[![Forks](https://img.shields.io/github/forks/taboolib/adyeshach)](https://github.com/TabooLib/adyeshach) +[![Stars](https://img.shields.io/github/stars/taboolib/adyeshach)](https://github.com/TabooLib/adyeshach) +[![License](https://img.shields.io/github/license/taboolib/adyeshach)](https://github.com/TabooLib/adyeshach/blob/2.0/LICENSE) ```text Adyeshach 是一款基于 TabooLib 进行开发的纯发包 NPC 插件，旨在大幅提升性能并提供更高级的功能和 API。 diff --git a/docs-java/process/plugin/other/npc/Citizens.md b/docs-java/process/plugin/misc/npc/citizens.md similarity index 75% rename from docs-java/process/plugin/other/npc/Citizens.md rename to docs-java/process/plugin/misc/npc/citizens.md index 201a94c03..e2c10befb 100644 --- a/docs-java/process/plugin/other/npc/Citizens.md +++ b/docs-java/process/plugin/misc/npc/citizens.md @@ -7,15 +7,9 @@ sidebar_position: 2 ![](_images/Citizens/Citizens-1.png) - - Forks - - - Stars - - - License - +[![Forks](https://img.shields.io/github/forks/CitizensDev/Citizens2?style=flat)](https://github.com/CitizensDev/Citizens2) +[![Stars](https://img.shields.io/github/stars/CitizensDev/Citizens2?style=flat)](https://github.com/CitizensDev/Citizens2) +[![License](https://img.shields.io/github/license/CitizensDev/Citizens2)](https://github.com/CitizensDev/Citizens2/blob/master/LICENSE) ```text 老牌 NPC 插件。 @@ -55,7 +49,7 @@ sidebar_position: 2 `官网` https://wiki.citizensnpcs.co/Citizens_Wiki -`Bukkit(旧)` https://dev.bukkit.org/projects/citizens +`Bukkit (旧)` https://dev.bukkit.org/projects/citizens `SpigotMC` https://www.spigotmc.org/resources/citizens.13811 @@ -71,7 +65,7 @@ sidebar_position: 2 ## 下载 -在 SpigotMC 帖内自行寻找免费方式，以 _懒_ _看不懂英文_ _它是英文的_ 为由 通常会遭到群友的谩骂 +在 SpigotMC 帖内自行寻找免费方式，以 *懒* *看不懂英文* *它是英文的* 为由 通常会遭到群友的谩骂 ## 执行命令 diff --git a/docs-java/process/plugin/other/npc/NPC.md b/docs-java/process/plugin/misc/npc/npc.md similarity index 74% rename from docs-java/process/plugin/other/npc/NPC.md rename to docs-java/process/plugin/misc/npc/npc.md index 2fc7c05a2..d7f36df15 100644 --- a/docs-java/process/plugin/other/npc/NPC.md +++ b/docs-java/process/plugin/misc/npc/npc.md @@ -8,7 +8,7 @@ sidebar_position: 6 :::danger -**混合端不建议使用 npc 插件** +**混合端不建议使用 NPC 插件** **混合端不要给插件作者反馈问题** @@ -16,9 +16,9 @@ sidebar_position: 6 ::: -混合端可以去用 [Taterzens](https://www.mcmod.cn/class/3837.html) 或 [自定义 npc mod](https://www.mcmod.cn/class/45.html) +混合端可以去用 [Taterzens](https://www.mcmod.cn/class/3837.html) 或 [自定义 NPC mod](https://www.mcmod.cn/class/45.html) -自定义 npc 执行命令需要开启命令方块 +自定义 NPC 执行命令需要开启命令方块 [如何启用命令方块？](/docs-java/start/config-server.md#启用命令方块) diff --git a/docs-java/process/plugin/other/npc/ZNPCsPlus.md b/docs-java/process/plugin/misc/npc/znpcsplus.md similarity index 100% rename from docs-java/process/plugin/other/npc/ZNPCsPlus.md rename to docs-java/process/plugin/misc/npc/znpcsplus.md diff --git a/docs-java/process/plugin/other/QuickShop.md b/docs-java/process/plugin/misc/quickshop.md similarity index 77% rename from docs-java/process/plugin/other/QuickShop.md rename to docs-java/process/plugin/misc/quickshop.md index 0df5bccc6..8ef0a1764 100644 --- a/docs-java/process/plugin/other/QuickShop.md +++ b/docs-java/process/plugin/misc/quickshop.md @@ -12,17 +12,17 @@ sidebar_label: 商店 - QuickShop ~~用此插件做系统商店的通常是些新手服主或半吊子人~~ -[QuickShop](QuickShop.md#quickshop) 原本由 [KaiKikuchi](https://github.com/KaiKikuchi) 维护 +[QuickShop](quickshop.md#quickshop) 原本由 [KaiKikuchi](https://github.com/KaiKikuchi) 维护 -弃坑之后 [Ghost-chu](https://github.com/Ghost-chu) fork 接手并做了 [QuickShop-Reremake](QuickShop.md#quickshop-reremakeghost-chupotatocraft-studio) +弃坑之后 [Ghost-chu](https://github.com/Ghost-chu) fork 接手并做了 [QuickShop-Reremake](quickshop.md#quickshop-reremake-ghost-chupotatocraft-studio) ~~Ghost-chu 大佬放弃维护后曾在某群抱怨这么多人用这个插件，连个 star 都不愿意点~~ -[PotatoCraft-Studio](https://github.com/PotatoCraft-Studio) 团队 fork 了 [Ghost-chu](https://github.com/Ghost-chu) 大佬的仓库，维护 [PotatoCraft-Studio](https://github.com/PotatoCraft-Studio) 版本的 [QuickShop-Reremake](QuickShop.md#quickshop-reremakeghost-chupotatocraft-studio) +[PotatoCraft-Studio](https://github.com/PotatoCraft-Studio) 团队 fork 了 [Ghost-chu](https://github.com/Ghost-chu) 大佬的仓库，维护 [PotatoCraft-Studio](https://github.com/PotatoCraft-Studio) 版本的 [QuickShop-Reremake](quickshop.md#quickshop-reremake-ghost-chupotatocraft-studio) 但是看起来很久没更新了，大概也弃坑了 -[PotatoCraft-Studio](https://github.com/PotatoCraft-Studio) 团队的 [QuickShop-Reremake](QuickShop.md#quickshop-reremakeghost-chupotatocraft-studio) 的后续版本 [QuickShop-Hikari](QuickShop.md#quickshop-hikari) 目前由 [creatorfromhell](https://github.com/creatorfromhell) 维护 +[PotatoCraft-Studio](https://github.com/PotatoCraft-Studio) 团队的 [QuickShop-Reremake](quickshop.md#quickshop-reremake-ghost-chupotatocraft-studio) 的后续版本 [QuickShop-Hikari](quickshop.md#quickshop-hikari) 目前由 [creatorfromhell](https://github.com/creatorfromhell) 维护 :::info @@ -46,7 +46,7 @@ sidebar_label: 商店 - QuickShop 停止维护 -## QuickShop-Reremake(Ghost-chu/PotatoCraft-Studio) +## QuickShop-Reremake (Ghost-chu/PotatoCraft-Studio) :::info diff --git a/docs-java/process/plugin/other/SkinsRestorer.md b/docs-java/process/plugin/misc/skinsrestorer.md similarity index 91% rename from docs-java/process/plugin/other/SkinsRestorer.md rename to docs-java/process/plugin/misc/skinsrestorer.md index 238d8d605..fa05beb04 100644 --- a/docs-java/process/plugin/other/SkinsRestorer.md +++ b/docs-java/process/plugin/misc/skinsrestorer.md @@ -22,7 +22,7 @@ sidebar_label: 皮肤 - SkinsRestorer 这个插件可以让盗版 (离线) 服务器使用皮肤。 -SkinsRestorer 是一体化设计，没有“单端版” “bc 版”之说，同一个 jar 文件可以直接扔 单端 / BungeeCord / Velocity 的 `plugins` 文件夹里加载 +SkinsRestorer 是一体化设计，没有“单端版” “BC 版”之说，同一个 jar 文件可以直接扔 单端 / BungeeCord / Velocity 的 `plugins` 文件夹里加载 :::tip diff --git a/docs-java/process/plugin/other/TAB&Scoreboard/_images/SimpleScore/SimpleScore.png b/docs-java/process/plugin/misc/tab-scoreboard/_images/SimpleScore/SimpleScore.png similarity index 100% rename from docs-java/process/plugin/other/TAB&Scoreboard/_images/SimpleScore/SimpleScore.png rename to docs-java/process/plugin/misc/tab-scoreboard/_images/SimpleScore/SimpleScore.png diff --git a/docs-java/process/plugin/other/TAB&Scoreboard/_images/TAB/TAB-1.png b/docs-java/process/plugin/misc/tab-scoreboard/_images/TAB/TAB-1.png similarity index 100% rename from docs-java/process/plugin/other/TAB&Scoreboard/_images/TAB/TAB-1.png rename to docs-java/process/plugin/misc/tab-scoreboard/_images/TAB/TAB-1.png diff --git a/docs-java/process/plugin/other/TAB&Scoreboard/_images/TAB/TAB-2.png b/docs-java/process/plugin/misc/tab-scoreboard/_images/TAB/TAB-2.png similarity index 100% rename from docs-java/process/plugin/other/TAB&Scoreboard/_images/TAB/TAB-2.png rename to docs-java/process/plugin/misc/tab-scoreboard/_images/TAB/TAB-2.png diff --git a/docs-java/process/plugin/other/TAB&Scoreboard/_images/TAB/TAB-3.png b/docs-java/process/plugin/misc/tab-scoreboard/_images/TAB/TAB-3.png similarity index 100% rename from docs-java/process/plugin/other/TAB&Scoreboard/_images/TAB/TAB-3.png rename to docs-java/process/plugin/misc/tab-scoreboard/_images/TAB/TAB-3.png diff --git a/docs-java/process/plugin/other/TAB&Scoreboard/_images/TAB/TAB-4.png b/docs-java/process/plugin/misc/tab-scoreboard/_images/TAB/TAB-4.png similarity index 100% rename from docs-java/process/plugin/other/TAB&Scoreboard/_images/TAB/TAB-4.png rename to docs-java/process/plugin/misc/tab-scoreboard/_images/TAB/TAB-4.png diff --git a/docs-java/process/plugin/other/TAB&Scoreboard/_images/TAB/TAB-5.png b/docs-java/process/plugin/misc/tab-scoreboard/_images/TAB/TAB-5.png similarity index 100% rename from docs-java/process/plugin/other/TAB&Scoreboard/_images/TAB/TAB-5.png rename to docs-java/process/plugin/misc/tab-scoreboard/_images/TAB/TAB-5.png diff --git a/docs-java/process/plugin/other/TAB&Scoreboard/_images/TAB/TAB-6.png b/docs-java/process/plugin/misc/tab-scoreboard/_images/TAB/TAB-6.png similarity index 100% rename from docs-java/process/plugin/other/TAB&Scoreboard/_images/TAB/TAB-6.png rename to docs-java/process/plugin/misc/tab-scoreboard/_images/TAB/TAB-6.png diff --git a/docs-java/process/plugin/other/TAB&Scoreboard/_images/TAB/TAB-7.png b/docs-java/process/plugin/misc/tab-scoreboard/_images/TAB/TAB-7.png similarity index 100% rename from docs-java/process/plugin/other/TAB&Scoreboard/_images/TAB/TAB-7.png rename to docs-java/process/plugin/misc/tab-scoreboard/_images/TAB/TAB-7.png diff --git a/docs-java/process/plugin/other/TAB&Scoreboard/_images/TAB/TAB-8.png b/docs-java/process/plugin/misc/tab-scoreboard/_images/TAB/TAB-8.png similarity index 100% rename from docs-java/process/plugin/other/TAB&Scoreboard/_images/TAB/TAB-8.png rename to docs-java/process/plugin/misc/tab-scoreboard/_images/TAB/TAB-8.png diff --git a/docs-java/process/plugin/other/TAB&Scoreboard/_images/TAB/TAB-9.png b/docs-java/process/plugin/misc/tab-scoreboard/_images/TAB/TAB-9.png similarity index 100% rename from docs-java/process/plugin/other/TAB&Scoreboard/_images/TAB/TAB-9.png rename to docs-java/process/plugin/misc/tab-scoreboard/_images/TAB/TAB-9.png diff --git a/docs-java/process/plugin/other/TAB&Scoreboard/_images/TitleManager/1.gif b/docs-java/process/plugin/misc/tab-scoreboard/_images/TitleManager/1.gif similarity index 100% rename from docs-java/process/plugin/other/TAB&Scoreboard/_images/TitleManager/1.gif rename to docs-java/process/plugin/misc/tab-scoreboard/_images/TitleManager/1.gif diff --git a/docs-java/process/plugin/other/TAB&Scoreboard/_images/TitleManager/2.png b/docs-java/process/plugin/misc/tab-scoreboard/_images/TitleManager/2.png similarity index 100% rename from docs-java/process/plugin/other/TAB&Scoreboard/_images/TitleManager/2.png rename to docs-java/process/plugin/misc/tab-scoreboard/_images/TitleManager/2.png diff --git "a/docs-java/process/plugin/other/TAB&Scoreboard/_images/\345\225\245\346\230\257TAB.png" "b/docs-java/process/plugin/misc/tab-scoreboard/_images/\345\225\245\346\230\257TAB.png" similarity index 100% rename from "docs-java/process/plugin/other/TAB&Scoreboard/_images/\345\225\245\346\230\257TAB.png" rename to "docs-java/process/plugin/misc/tab-scoreboard/_images/\345\225\245\346\230\257TAB.png" diff --git "a/docs-java/process/plugin/other/TAB&Scoreboard/_images/\345\225\245\346\230\257\350\256\241\345\210\206\346\235\277.png" "b/docs-java/process/plugin/misc/tab-scoreboard/_images/\345\225\245\346\230\257\350\256\241\345\210\206\346\235\277.png" similarity index 100% rename from "docs-java/process/plugin/other/TAB&Scoreboard/_images/\345\225\245\346\230\257\350\256\241\345\210\206\346\235\277.png" rename to "docs-java/process/plugin/misc/tab-scoreboard/_images/\345\225\245\346\230\257\350\256\241\345\210\206\346\235\277.png" diff --git a/docs-java/process/plugin/other/TAB&Scoreboard/SimpleScore.md b/docs-java/process/plugin/misc/tab-scoreboard/simplescore.md similarity index 100% rename from docs-java/process/plugin/other/TAB&Scoreboard/SimpleScore.md rename to docs-java/process/plugin/misc/tab-scoreboard/simplescore.md diff --git a/docs-java/process/plugin/other/TAB&Scoreboard/Tab&Scoreboard.md b/docs-java/process/plugin/misc/tab-scoreboard/tab-scoreboard.md similarity index 100% rename from docs-java/process/plugin/other/TAB&Scoreboard/Tab&Scoreboard.md rename to docs-java/process/plugin/misc/tab-scoreboard/tab-scoreboard.md diff --git a/docs-java/process/plugin/other/TAB&Scoreboard/TAB.md b/docs-java/process/plugin/misc/tab-scoreboard/tab.md similarity index 95% rename from docs-java/process/plugin/other/TAB&Scoreboard/TAB.md rename to docs-java/process/plugin/misc/tab-scoreboard/tab.md index 536e52832..35c010529 100644 --- a/docs-java/process/plugin/other/TAB&Scoreboard/TAB.md +++ b/docs-java/process/plugin/misc/tab-scoreboard/tab.md @@ -5,18 +5,10 @@ sidebar_position: 2 # TAB - - Releases - - - Downloads - - - Languages - - - License - +[![Releases](https://img.shields.io/github/v/release/NEZNAMY/TAB)](https://github.com/NEZNAMY/TAB/releases) +[![Downloads](https://img.shields.io/spiget/downloads/57806?label=Downloads)](https://www.spigotmc.org/resources/.57806) +[![Code Size](https://img.shields.io/github/languages/code-size/NEZNAMY/TAB)](https://github.com/NEZNAMY/TAB) +[![License](https://img.shields.io/github/license/NEZNAMY/TAB)](https://github.com/NEZNAMY/TAB/blob/main/LICENSE) ```text TAB 是一个用于在不同位置显示信息的多功能插件，旨在在功能、兼容性和性能方面超越所有类似的插件。 @@ -24,7 +16,7 @@ TAB 是一个用于在不同位置显示信息的多功能插件，旨在在功 此插件拥有自由的配置文件，无论你是只需要最简单的功能，或者制作一些复杂的功能，此插件都能满足你的需求！ -默认配置已经包含足够的示例让你理解此插件的配置，另外，此插件拥有全面的 wiki。 +默认配置已经包含足够的示例让你理解此插件的配置，另外，此插件拥有全面的 Wiki。 ## 照片 @@ -123,8 +115,8 @@ TAB 是一个用于在不同位置显示信息的多功能插件，旨在在功 3. 世界上每个人都可以无限制地使用我的空闲时间。（？） 4. 在不损失任何功能的情况下提高插件的性能。 -- 你可以加入这个大好人的 [community discord](https://discord.gg/YPqXt63YQj) 来得到其他好心人的支持 - 注：discord 在国内不能访问，需要挂梯 +- 你可以加入这个大好人的 [Community Discord](https://discord.gg/YPqXt63YQj) 来得到其他好心人的支持 + 注：Discord 在国内不能访问，需要挂梯 ## API @@ -142,9 +134,9 @@ https://github.com/NEZNAMY/TAB/wiki/Developer-API `GitHub` https://github.com/NEZNAMY/TAB -`文档(英文)` https://github.com/NEZNAMY/TAB/wiki +`文档 (英文)` https://github.com/NEZNAMY/TAB/wiki -`文档(中文)` https://docs.superiormc.cn/v/tab-wiki +`文档 (中文)` https://docs.superiormc.cn/v/tab-wiki `插件百科` https://mineplugin.org/Tab @@ -157,7 +149,9 @@ https://github.com/NEZNAMY/TAB/wiki/Developer-API
mmessage.yml -```YAML + + +```yaml announce-command-usage: |- 用法: /tab announce <种类> <名称> <长度> 当前支持种类: &lbar, scoreboard @@ -237,6 +231,8 @@ nametag: no-arg-from-console: '&c从控制台运行此指令时需要指定玩家' ``` + +
## 配置文件汉化 @@ -246,7 +242,9 @@ nametag:
config.yml -```YAML + + +```yaml # https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Header-&-Footer # 头部和底部显示 header-footer: @@ -561,12 +559,14 @@ global-playerlist: # 从后端服务器而不是代理获取权限和组 use-bukkit-permissions-manager: false -# 有时服务器可能在Tab列表中使用离线UUID而不是在线UUID，例如禁用waterfall的Tab列表重写选项 +# 有时服务器可能在Tab列表中使用离线UUID而不是在线UUID，例如禁用Waterfall的Tab列表重写选项 # 如果遇到Tab列表格式化不工作的问题，请切换此选项（设置为相反值） # 仅影响启用在线模式的代理 use-online-uuid-in-tablist: true ``` + +
## Bstats diff --git a/docs-java/process/plugin/other/TAB&Scoreboard/TitleManager.md b/docs-java/process/plugin/misc/tab-scoreboard/titlemanager.md similarity index 100% rename from docs-java/process/plugin/other/TAB&Scoreboard/TitleManager.md rename to docs-java/process/plugin/misc/tab-scoreboard/titlemanager.md diff --git "a/docs-java/process/plugin/other/Via/_images/\347\211\210\346\234\254\345\205\274\345\256\271\345\233\276.png" "b/docs-java/process/plugin/misc/via/_images/\347\211\210\346\234\254\345\205\274\345\256\271\345\233\276.png" similarity index 100% rename from "docs-java/process/plugin/other/Via/_images/\347\211\210\346\234\254\345\205\274\345\256\271\345\233\276.png" rename to "docs-java/process/plugin/misc/via/_images/\347\211\210\346\234\254\345\205\274\345\256\271\345\233\276.png" diff --git a/docs-java/process/plugin/other/Via/MoreforVia.md b/docs-java/process/plugin/misc/via/more-for-via.md similarity index 92% rename from docs-java/process/plugin/other/Via/MoreforVia.md rename to docs-java/process/plugin/misc/via/more-for-via.md index 6a44e1a2a..dec6a4051 100644 --- a/docs-java/process/plugin/other/Via/MoreforVia.md +++ b/docs-java/process/plugin/misc/via/more-for-via.md @@ -20,8 +20,8 @@ sidebar_position: 5 ::: -在 1.20 中，sb mojang 在锻造台上添加了一个新的 UI(也就是添加了锻造模板)，如果你的 1.16-1.19 服务器运行 ViaBackwards，那么 1.20+ 玩家将无法打开锻造台。 -同样的事情在 1.20+ 服务器和 1.16-1.19 客户端上也是如此。该插件还使 1.7-1.15 客户端能够打开锻造台。( 你可以恢复到旧的 1.16-1.19 锻造台，不需要下界升级锻造模板) +在 1.20 中，sb Mojang 在锻造台上添加了一个新的 UI (也就是添加了锻造模板)，如果你的 1.16-1.19 服务器运行 ViaBackwards，那么 1.20+ 玩家将无法打开锻造台。 +同样的事情在 1.20+ 服务器和 1.16-1.19 客户端上也是如此。该插件还使 1.7-1.15 客户端能够打开锻造台。(你可以恢复到旧的 1.16-1.19 锻造台，不需要下界升级锻造模板) ## ViaChatFixer @@ -136,7 +136,7 @@ sidebar_position: 5 功能： -- 与 Minecraft 1.8 及更高版本兼容 Spigot/Velocity/Bungeecord，包括最新版本。 +- 与 Minecraft 1.8 及更高版本兼容 Spigot/Velocity/BungeeCord，包括最新版本。 - 自动从 Jenkins 下载 ViaVersion、ViaBackwards、ViaRewind 和 ViaRewind-Legacy-Support 的成功版本及其开发版本。 - config.yml 允许你指定要更新的 Via 以及是否使用每个插件的开发版本。 - /updatevias 命令强制更新检查器对所有 Via(需要 autoviaupdater.admin 权限) diff --git a/docs-java/process/plugin/other/Via/Via.md b/docs-java/process/plugin/misc/via/via.md similarity index 90% rename from docs-java/process/plugin/other/Via/Via.md rename to docs-java/process/plugin/misc/via/via.md index 23081947f..d415372a4 100644 --- a/docs-java/process/plugin/other/Via/Via.md +++ b/docs-java/process/plugin/misc/via/via.md @@ -73,13 +73,13 @@ ViaProxy 是独立的代理程序，支持任意客户端版本连接任意服 - 愚人节快照 (3D Shareware，20w14infinite，25w14craftmine) - 战斗测试快照 (Combat Test 8c) - 基岩版 1.21.93 ([某些功能缺失](https://github.com/RaphiMC/ViaBedrock#features)) -- 快照版本 15w31a 和 15w31b (需要 [ViaSnapshot](/advance/ViaProxy/plugins/compatibility#viasnapshot)) +- 快照版本 15w31a 和 15w31b (需要 [ViaSnapshot](/advance/viaproxy/plugins/compatibility#viasnapshot)) ### 支持的客户端版本 - Release (1.7.2 - 1.21.8) - Beta 1.7.3 (需要 [ViaProxyBeta2Release](https://github.com/ViaVersionAddons/ViaProxyBeta2Release)) -- 基岩版 (需要 [Geyser](/Java/Geyser) 插件) +- 基岩版 (需要 [Geyser](../../../mobile-player/geyser/geyser.md) 插件) ViaProxy 可以让现代客户端进入十年前的 Classic 服务器，也可以实现 Java 版与基岩版之间的互通！ @@ -87,7 +87,7 @@ ViaProxy 可以让现代客户端进入十年前的 Classic 服务器，也可 官方发布页面：[GitHub Release](https://github.com/ViaVersion/ViaProxy/releases) -Jenkins 构建：[ViaVersion Jenkins](https://ci.viaversion.com/view/All/job/ViaProxy/) +Jenkins 构建：[ViaVersion Jenkins](https://ci.viaversion.com/view/all/job/ViaProxy/) ## 笨蛋脚本 @@ -109,7 +109,7 @@ Jenkins 构建：[ViaVersion Jenkins](https://ci.viaversion.com/view/All/job/Via ### 如果我拥有代理端，我应该将 Via 安装到哪里？ -Bungeecord、Velocity 和各种 Minecraft 服务端均可以安装 Via。但如果你有反作弊、反假人等， +BungeeCord、Velocity 和各种 Minecraft 服务端均可以安装 Via。但如果你有反作弊、反假人等， 对数据包进行大量操作的插件，后端服务器获取的玩家版本为代理端的版本，并非玩家客户端版本， @@ -131,8 +131,8 @@ Via 的目的是允许兼容，但不打算添加新的项目、方块和功能 ### 我的玩家因为发送太多数据包而被踢？ -如果你没有使用 paper fork 可以在配置中增加 max-pps，如果使用 paper fork， +如果你没有使用 Paper Fork 可以在配置中增加 `max-pps`，如果使用 Paper fork， -如果使用 paper fork，请直接将其调整为 -1，并调整 paper 的 pps 限制。 +如果使用 Paper Fork，请直接将其调整为 `-1`，并调整 Paper 的 pps 限制。 (尝试增加到玩家没有问题，不要全部禁用，这会导致服务器被玩家恶意使用数据包卡顿) diff --git a/docs-java/process/plugin/other/Via/ViaBackwards.md b/docs-java/process/plugin/misc/via/viabackwards.md similarity index 94% rename from docs-java/process/plugin/other/Via/ViaBackwards.md rename to docs-java/process/plugin/misc/via/viabackwards.md index ceabeb8fe..6282c45c8 100644 --- a/docs-java/process/plugin/other/Via/ViaBackwards.md +++ b/docs-java/process/plugin/misc/via/viabackwards.md @@ -17,7 +17,7 @@ sidebar_position: 3 ::: -Via 三件套中的向下兼容，需要安装 [ViaVersion](ViaVersion.md) 作为前置 +Via 三件套中的向下兼容，需要安装 [ViaVersion](viaversion.md) 作为前置 [ViaBackwards 构建站](https://ci.viaversion.com/view/ViaBackwards/job/ViaBackwards/) diff --git a/docs-java/process/plugin/other/Via/ViaRewind.md b/docs-java/process/plugin/misc/via/viarewind.md similarity index 100% rename from docs-java/process/plugin/other/Via/ViaRewind.md rename to docs-java/process/plugin/misc/via/viarewind.md diff --git a/docs-java/process/plugin/other/Via/ViaVersion.md b/docs-java/process/plugin/misc/via/viaversion.md similarity index 89% rename from docs-java/process/plugin/other/Via/ViaVersion.md rename to docs-java/process/plugin/misc/via/viaversion.md index b07e09169..768364ef8 100644 --- a/docs-java/process/plugin/other/Via/ViaVersion.md +++ b/docs-java/process/plugin/misc/via/viaversion.md @@ -21,7 +21,7 @@ sidebar_position: 2 ::: -ViaVersion 是 Via 三件套的核心，提供了向上兼容，如果你想要向下兼容，可以再安装 [ViaBackwards](ViaBackwards.md) 和 [ViaRewind](ViaRewind.md) +ViaVersion 是 Via 三件套的核心，提供了向上兼容，如果你想要向下兼容，可以再安装 [ViaBackwards](viabackwards.md) 和 [ViaRewind](viarewind.md) [ViaVersion 构建站](https://ci.viaversion.com/job/ViaVersion) diff --git a/docs-java/process/plugin/more/_images/148869708-310e7ec4-7d89-40e8-8fc6-38d2e6116cb7.png b/docs-java/process/plugin/more/_images/148869708-310e7ec4-7d89-40e8-8fc6-38d2e6116cb7.png deleted file mode 100644 index c8b8f4fdb..000000000 Binary files a/docs-java/process/plugin/more/_images/148869708-310e7ec4-7d89-40e8-8fc6-38d2e6116cb7.png and /dev/null differ diff --git a/docs-java/process/plugin/more/_images/155235807-250932d3-0ffd-43ca-92c8-3112df12a64e.png b/docs-java/process/plugin/more/_images/155235807-250932d3-0ffd-43ca-92c8-3112df12a64e.png deleted file mode 100644 index 7796ed8c0..000000000 Binary files a/docs-java/process/plugin/more/_images/155235807-250932d3-0ffd-43ca-92c8-3112df12a64e.png and /dev/null differ diff --git a/docs-java/process/plugin/more/_images/327982758-d0903a79-e55d-4634-babb-063af2ef0c7c.gif b/docs-java/process/plugin/more/_images/327982758-d0903a79-e55d-4634-babb-063af2ef0c7c.gif deleted file mode 100644 index 5283ae810..000000000 Binary files a/docs-java/process/plugin/more/_images/327982758-d0903a79-e55d-4634-babb-063af2ef0c7c.gif and /dev/null differ diff --git a/docs-java/process/plugin/more/_images/9d106a9197f3a7b34e5941716f48a3bb0acf76ce.gif b/docs-java/process/plugin/more/_images/9d106a9197f3a7b34e5941716f48a3bb0acf76ce.gif deleted file mode 100644 index f86a4ccda..000000000 Binary files a/docs-java/process/plugin/more/_images/9d106a9197f3a7b34e5941716f48a3bb0acf76ce.gif and /dev/null differ diff --git a/docs-java/process/plugin/more/_images/videoframe_0.png b/docs-java/process/plugin/more/_images/videoframe_0.png deleted file mode 100644 index e9d88e00c..000000000 Binary files a/docs-java/process/plugin/more/_images/videoframe_0.png and /dev/null differ diff --git a/docs-java/process/plugin/more/_images/videoframe_5048.png b/docs-java/process/plugin/more/_images/videoframe_5048.png deleted file mode 100644 index 5f1667c92..000000000 Binary files a/docs-java/process/plugin/more/_images/videoframe_5048.png and /dev/null differ diff --git a/docs-java/process/plugin/more/color-message.md b/docs-java/process/plugin/more/color-message.md index 940c3f3a9..4ddde6034 100644 --- a/docs-java/process/plugin/more/color-message.md +++ b/docs-java/process/plugin/more/color-message.md @@ -9,7 +9,7 @@ sidebar_position: 7 ## 格式化代码 -**格式化代码 (Formatting code)**，又称**颜色代码 (Color code)**，能使在游戏中加入含颜色和格式信息。 +**格式化代码 (Formatting code)**，又称 **颜色代码 (Color code)**，能使在游戏中加入含颜色和格式信息。 在 Minecraft 中，可以以分节符号 (`§`) 产生带色文字。 @@ -25,7 +25,7 @@ sidebar_position: 7 你也可以在按住 `Alt` 键的同时，**小键盘** **按顺序** 输入 `167` 以输出 `§` 符号 -_(注意：![image](https://github.com/user-attachments/assets/49472da4-9b50-4fa3-92d1-f14cdb08cbb4) 使用新版时字符对应错误，请使用旧版)_ +*(注意：![image](https://github.com/user-attachments/assets/49472da4-9b50-4fa3-92d1-f14cdb08cbb4) 使用新版时字符对应错误，请使用旧版)* ::: @@ -71,14 +71,14 @@ MiniMessage 的实质是一个叫 Adventure 的库，这是它的 [文档](https | Minestom | Build 7494725 | 内容有点杂，详见[minestom wiki](https://wiki.minestom.net/feature/adventure) | | Fabric | `adventure-platform-fabric` 5.3.0\* | 虽然不是一个东西 (?)，但是体验是一样的 | -_详情可以参阅 [Adventure 原生支持](https://docs.papermc.io/adventure/platform/native/)_ +*详情可以参阅 [Adventure 原生支持](https://docs.papermc.io/adventure/platform/native/)* :::note 平台原生支持 ≠ 使用此平台开发的模组/插件支持！！！ 举个例子，仔细观察上述列表，你会发现 bukkit 并没有支持 MiniMessage，所以你会发现大部分基于 Bukkit 开发的插件没有 MiniMessage 这一功能 (如 EssentialsX)， -_除非他们自身引入了 Adventure 库 (如 PlaceholderAPI)。_ +*除非他们自身引入了 Adventure 库 (如 PlaceholderAPI)。* 而基于 Paper 开发的大部分插件都引入了这一功能，所以不要发现一个新奇玩意就到处瞎套。 @@ -123,13 +123,13 @@ Icons: Hello World! ``` -在非严格模式下，所有标记名称**都不区分大小写**，以减少冲突的可能性 (懒癌晚期患者狂喜)，但美观和符合规定起见，请使用小写字母编写以便减少被他人嘲讽的几率： +在非严格模式下，所有标记名称 **都不区分大小写**，以减少冲突的可能性 (懒癌晚期患者狂喜)，但美观和符合规定起见，请使用小写字母编写以便减少被他人嘲讽的几率： ```xml Hello World! ``` -此外，这里有一个[测试网站](https://webui.advntr.dev/)，他可以使得你无需启动 Minecraft 便可以预览实际效果。 +此外，这里有一个 [测试网站](https://webui.advntr.dev/)，他可以使得你无需启动 Minecraft 便可以预览实际效果。 关于实际使用格式详见 [标准标签](https://docs.papermc.io/adventure/minimessage/format/#standard-tags)。 @@ -137,7 +137,7 @@ Icons: TabooLib Components，当你使用 TabooLib 框架的插件时，可以使用此写法 -可以更方便的编写 json 文本信息，而不只是局限于颜色 +可以更方便的编写 JSON 文本信息，而不只是局限于颜色 > [https://plugins.ptms.ink/category/行内复合文本](https://plugins.ptms.ink/category/%E8%A1%8C%E5%86%85%E5%A4%8D%E5%90%88%E6%96%87%E6%9C%AC) \ > https://taboo.8aka.org/components/ diff --git a/docs-java/process/plugin/more/faq.md b/docs-java/process/plugin/more/faq.md index 2409e9dec..beecaac32 100644 --- a/docs-java/process/plugin/more/faq.md +++ b/docs-java/process/plugin/more/faq.md @@ -74,9 +74,9 @@ org.bukkit.plugin.InvalidPluginException: java.lang.UnsupportedClassVersionError ## 循环依赖 -指的是 A 依赖 B,B 依赖 C,C 依赖 A，导致 Paper 无法判断加载顺序 +指的是 A 依赖 B、B 依赖 C、C 依赖 A，导致 Paper 无法判断加载顺序 -解决方案：添加参数`-Dpaper.useLegacyPluginLoading=true` 即可 +解决方案：添加参数 `-Dpaper.useLegacyPluginLoading=true` 即可 ## 重复插件 diff --git a/docs-java/process/plugin/more/plugin-abbreviation.md b/docs-java/process/plugin/more/plugin-abbreviation.md index 52625c41f..dccf11b42 100644 --- a/docs-java/process/plugin/more/plugin-abbreviation.md +++ b/docs-java/process/plugin/more/plugin-abbreviation.md @@ -5,7 +5,7 @@ sidebar_position: 4 # 插件缩写 -**_请不要随便使用不知名插件的缩写！_** +***请不要随便使用不知名插件的缩写！*** ## 缩写从何而来？ diff --git a/docs-java/process/plugin/more/plugin-build/first.md b/docs-java/process/plugin/more/plugin-build/first.md index 068e15e18..ef69dbb8e 100644 --- a/docs-java/process/plugin/more/plugin-build/first.md +++ b/docs-java/process/plugin/more/plugin-build/first.md @@ -69,7 +69,8 @@ sidebar_position: 2 #### Maven 项目结构 -```text + +```yaml 项目根目录 ├── src/ # 源代码目录 │ ├── main/ # 主要代码目录 @@ -95,7 +96,8 @@ sidebar_position: 2 #### Gradle 项目结构 -```text + +```yaml 项目根目录 ├── src/ # 源代码目录 │ ├── main/ # 主要代码目录 @@ -145,6 +147,7 @@ sidebar_position: 2 ``` - **config.yml**：插件的默认配置文件 + ```yaml settings: debug: false @@ -170,6 +173,7 @@ sidebar_position: 2 ``` - **Gradle (build.gradle)**： + ```groovy dependencies { compileOnly 'io.papermc.paper:paper-api:1.19.4-R0.1-SNAPSHOT' diff --git a/docs-java/process/plugin/more/plugin-build/github-actions-build.md b/docs-java/process/plugin/more/plugin-build/github-actions-build.md index 35f64ba8c..e5810d681 100644 --- a/docs-java/process/plugin/more/plugin-build/github-actions-build.md +++ b/docs-java/process/plugin/more/plugin-build/github-actions-build.md @@ -122,6 +122,7 @@ jobs: ``` 3. **Java 配置**： + ```yaml - name: Set up JDK uses: actions/setup-java@v2 diff --git a/docs-java/process/plugin/more/plugin-build/idea-build.md b/docs-java/process/plugin/more/plugin-build/idea-build.md index c75ae2c65..5ad25595a 100644 --- a/docs-java/process/plugin/more/plugin-build/idea-build.md +++ b/docs-java/process/plugin/more/plugin-build/idea-build.md @@ -34,7 +34,7 @@ sidebar_position: 4 ![build2](./_image/image-3.png) 3. 在 `build/libs` 目录找到生成的 jar 文件 -> 如果遇到依赖下载慢的问题，可以参考[配置镜像源](./mirror-config.md)文档。 +> 如果遇到依赖下载慢的问题，可以参考 [配置镜像源](./mirror-config.md) 文档。 ## 常见问题 diff --git a/docs-java/process/plugin/more/plugin-build/mirror-config.md b/docs-java/process/plugin/more/plugin-build/mirror-config.md index bda7b92c2..8c83cfeb4 100644 --- a/docs-java/process/plugin/more/plugin-build/mirror-config.md +++ b/docs-java/process/plugin/more/plugin-build/mirror-config.md @@ -37,7 +37,7 @@ Maven 的镜像配置在 `settings.xml` 文件中： https://maven.aliyun.com/repository/public - + aliyun-spring spring @@ -45,7 +45,7 @@ Maven 的镜像配置在 `settings.xml` 文件中： https://maven.aliyun.com/repository/spring - + aliyun-google google @@ -76,19 +76,19 @@ repositories { url = 'https://maven.aliyun.com/repository/public' } - // 阿里云Spring仓库 + // 阿里云 Spring 仓库 maven { name = "Aliyun-Spring" url = 'https://maven.aliyun.com/repository/spring' } - // 阿里云Google仓库 + // 阿里云 Google 仓库 maven { name = "Aliyun-Google" url = 'https://maven.aliyun.com/repository/google' } - // 保留原有的Maven中央仓库（作为备用） + // 保留原有的 Maven 中央仓库（作为备用） mavenCentral() } ``` diff --git a/docs-java/process/plugin/more/plugin-build/terminal-build.md b/docs-java/process/plugin/more/plugin-build/terminal-build.md index 96db5171c..4591b5842 100644 --- a/docs-java/process/plugin/more/plugin-build/terminal-build.md +++ b/docs-java/process/plugin/more/plugin-build/terminal-build.md @@ -10,14 +10,15 @@ sidebar_position: 5 ### 1. 安装 JDK 1. **Windows**： - - 从[JDK 选择](/preparation/java/choose-and-download-and-install-java)选择并下载 jdk + - 从 [JDK 选择](/preparation/java/choose-and-download-and-install-java) 选择并下载 JDK - 按照提示完成安装 - - 配置[环境变量](/preparation/java/environment) + - 配置 [环境变量](/preparation/java/environment) - 验证安装： 1. 按 `Win + R`，输入 `cmd` 打开终端 2. 输入 `java -version` 3. 如果看到类似下面的输出，说明安装成功： - ```bash + + ```text java version "1.8.0_301" Java(TM) SE Runtime Environment (build 1.8.0_301-b09) Java HotSpot(TM) 64-Bit Server VM (build 25.301-b09, mixed mode) @@ -41,16 +42,18 @@ sidebar_position: 5 1. **Maven**： - **Windows**： - 1. 访问[Maven 官网](https://maven.apache.org/download.cgi)下载最新版本 + 1. 访问 [Maven 官网](https://maven.apache.org/download.cgi) 下载最新版本 2. 下载 `apache-maven-x.x.x-bin.zip`（x.x.x 是版本号） 3. 解压到合适位置（建议：`C:\Program Files\Apache\maven`） - 4. 配置[环境变量](/preparation/java/environment)： + 4. 配置 [环境变量](/preparation/java/environment)： - 新建系统变量 `MAVEN_HOME`，值为 Maven 解压目录 - 在 `Path` 变量末尾添加 `;%MAVEN_HOME%\bin` 5. 验证安装： + ```bash mvn -version ``` + - **Linux**： ```bash @@ -66,22 +69,24 @@ sidebar_position: 5 2. **Gradle**（可选，如果项目使用 Gradle）： - **Windows**： - 1. 访问[Gradle 官网](https://gradle.org/releases/)下载最新版本 + 1. 访问 [Gradle 官网](https://gradle.org/releases/) 下载最新版本 2. 下载 `gradle-x.x.x-bin.zip`（x.x.x 是版本号） 3. 解压到合适位置（建议：`C:\Program Files\Gradle`） 4. 配置环境变量： - 新建系统变量 `GRADLE_HOME`，值为 Gradle 解压目录 - 在 `Path` 变量末尾添加 `;%GRADLE_HOME%\bin` 5. 验证安装： + ```bash gradle -version ``` + - **Linux**： ```bash - # 使用 SDKMAN 安装（推荐） - curl -s "https://get.sdkman.io" | bash # 安装 SDKMAN - source "$HOME/.sdkman/bin/sdkman-init.sh" # 初始化 SDKMAN + # 使用 SDKMAN\! 安装（推荐） + curl -s "https://get.sdkman.io" | bash # 安装 SDKMAN! + source "$HOME/.sdkman/bin/sdkman-init.sh" # 初始化 SDKMAN! sdk install gradle # 安装 Gradle # 验证安装 @@ -93,11 +98,11 @@ sidebar_position: 5 ### 1. 进入项目目录 ```bash -# Windows示例（如果项目在D盘的minecraft文件夹） +# Windows 示例（如果项目在 D 盘的 minecraft文件夹） D: cd minecraft\plugins\MyPlugin -# Linux/macOS示例 +# Linux/macOS 示例 cd ~/minecraft/plugins/MyPlugin # 验证是否在正确目录 @@ -157,11 +162,11 @@ jar 文件通常命名为：`项目名-版本号.jar` Wrapper 是项目专用的 Gradle 启动器，不需要本地安装 Gradle。 ```bash -# Windows系统 -# 如果是第一次运行，可能需要下载Gradle +# Windows 系统 +# 如果是第一次运行，可能需要下载 Gradle gradlew.bat clean build -# Linux/macOS系统 +# Linux/macOS 系统 chmod +x ./gradlew # 给予执行权限 ./gradlew clean build # 清理并构建 ``` @@ -193,7 +198,7 @@ ls -l build/libs 如果看到类似 `Could not resolve dependency` 的错误： 1. **配置镜像源**： - 参考[配置镜像源](./mirror-config.md)文档进行配置。 + 参考 [配置镜像源](./mirror-config.md) 文档进行配置。 2. **手动下载依赖**： @@ -245,6 +250,7 @@ ls -l build/libs 2. **Gradle 项目**： 在 `build.gradle` 中添加： + ```groovy tasks.withType(JavaCompile) { options.encoding = 'UTF-8' diff --git a/docs-java/process/plugin/more/plugin-config.md b/docs-java/process/plugin/more/plugin-config.md index 0677d3b26..c48eaa0a5 100644 --- a/docs-java/process/plugin/more/plugin-config.md +++ b/docs-java/process/plugin/more/plugin-config.md @@ -7,9 +7,9 @@ sidebar_position: 2 插件的配置文件一般在 `/plugins/插件名字/` 文件夹中，常见的配置文件一般是 `config.yml` 。 -> 插件一般会使用 **Yaml** 作为配置文件格式，建议先学习 [Yaml](../../../advance/YAML/YAML.md) 语法。 +> 插件一般会使用 **YAML** 作为配置文件格式，建议先学习 [YAML](../../../advance/yaml/yaml.md) 语法。 -我们在开始前所做的准备工作中，推荐你安装任意一款推荐的文档编辑软件：请查看[文本编辑器](/preparation/text-editor) +我们在开始前所做的准备工作中，推荐你安装任意一款推荐的文档编辑软件：请查看 [文本编辑器](/preparation/text-editor) 如果你是 Windows，现在让我们双击 .yml 文件就可以开始修改配置文件了！ @@ -41,11 +41,18 @@ import TabItem from '@theme/TabItem'; 插件文件夹中有类似 Language、lang、locale 之类的文件夹 (或其他东西？)： -![](\_images/查看语言 -1.png) + + +![](_images/查看语言-1.png) 请寻找 zhcn、zh-cn、zh-CN、chinese 等字眼： -![](\_images/查看语言 -2.png) + + + +![](_images/查看语言-2.png) + + 然后一般要去插件配置文件 (多数为 config.yml) 把语言改成这里的文件名 (此处为 zh_cn)。 @@ -57,9 +64,11 @@ import TabItem from '@theme/TabItem'; 如果我们在插件文件夹找不到语言文件夹，可以直接用解压缩软件打开 jar 包： -![](\_images/查看语言 - 拆开 jar.png) + + +![](_images/查看语言-拆开jar.png) -还有可能写在插件文档里，在项目 README 里，甚至在配置文件的注释里。 + 碰到这之外的情况就需要你自己摸索了 @@ -81,7 +90,7 @@ import TabItem from '@theme/TabItem'; 然后把语言项改成 zh_CN、Chinese 等，具体应该写什么这地方。插件配置的注释可能提到 -也可以找找 [插件文件夹](/Java/process/plugin/more/plugin-config?plugin-language=folder) 和 [拆开 jar 文件](/Java/process/plugin/more/plugin-config?plugin-language=jar) +也可以找找 [插件文件夹](plugin-config.md?plugin-language=folder) 和 [拆开 jar 文件](plugin-config.md?plugin-language=jar) @@ -98,7 +107,7 @@ import TabItem from '@theme/TabItem'; ```text -请将我给出的以 yml 格式存储的 Minecraft 插件的配置文件汉化，且不改变本身的可执行性，其中被两个 % 包裹的为变量请不要翻译，请翻译时不要带翻译腔，而是要翻译得自然、流畅和地道，使用优美和高雅的表达方式并代入 Minecraft 游戏内进行翻译，翻译后请以 markdown 代码块的格式发送 +请将我给出的以 YAML 格式存储的 Minecraft 插件的配置文件汉化，且不改变本身的可执行性，其中被两个 % 包裹的为变量请不要翻译，请翻译时不要带翻译腔，而是要翻译得自然、流畅和地道，使用优美和高雅的表达方式并代入 Minecraft 游戏内进行翻译，翻译后请以 Markdown 代码块的格式发送 ``` @@ -113,9 +122,9 @@ import TabItem from '@theme/TabItem'; 如果你要用的这个插件没有以上所提到的所有情况... -他**可能**把你要改的语言直接写死在代码里了，你要自己去改代码... +他 **可能** 把你要改的语言直接写死在代码里了，你要自己去改代码... -比如驿站内核汉化的 [DecentHolograms](../other/Holograms/DecentHolograms.md) +比如驿站内核汉化的 [DecentHolograms](../misc/holograms/decentholograms.md) diff --git a/docs-java/process/plugin/more/plugin-download.md b/docs-java/process/plugin/more/plugin-download.md index 0b5a37ba9..a706dfba7 100644 --- a/docs-java/process/plugin/more/plugin-download.md +++ b/docs-java/process/plugin/more/plugin-download.md @@ -7,17 +7,17 @@ sidebar_position: 1 ## 选择插件 -很好，相信你已经在 [可能用到的网站](/Java/preparation/websites) 看到了很多链接，面对成千上万的插件我们应该如何进行选择呢？ +很好，相信你已经在 [可能用到的网站](../../../preparation/websites.md) 看到了很多链接，面对成千上万的插件我们应该如何进行选择呢？ 我们在此以 spigotmc.org 为例 (假设你已经注册成功)，讲解如何选择插件。 -1. (_可选，推荐_) 安装一个 SpigotMC 专用的[搜索引擎](https://fof1092.de/Plugins/SSE/Redirect/)，作为浏览器插件安装即可。 +1. (*可选，推荐*) 安装一个 SpigotMC 专用的 [搜索引擎](https://fof1092.de/Plugins/SSE/Redirect/)，作为浏览器插件安装即可。 - 使用 SpigotSearchEngine(SpigotMC 搜索引擎) 后，你能得到比 SpigotMC 自带的搜索相关性强得多的搜索结果。 + 使用 SpigotSearchEngine (SpigotMC 搜索引擎) 后，你能得到比 SpigotMC 自带的搜索相关性强得多的搜索结果。 -2. (_可选_) 如果你觉得大量的英语很头大，请打开你的浏览器自带的翻译器，如 Edge/Chrome。 +2. (*可选*) 如果你觉得大量的英语很头大，请打开你的浏览器自带的翻译器，如 Edge/Chrome。 ![](_images/浏览器翻译.png) @@ -27,8 +27,12 @@ sidebar_position: 1
安装搜索引擎后应该长啥样？ + + ![](_images/Spigot搜索.png) + +
1. 查看这些插件的下载次数、最后更新时间、评价分数、插件特性、语言支持、是否开源、是否付费等。 @@ -53,7 +57,7 @@ sidebar_position: 1 -**_不要装多个同类型插件，不要把 CMI 和 EssentialX 装在一起，也不要一个服务器装 3 ~ 4 个菜单插件！！！_** +***不要装多个同类型插件，不要把 CMI 和 EssentialX 装在一起，也不要一个服务器装 3 ~ 4 个菜单插件！！！*** ## 下载插件 @@ -67,7 +71,7 @@ TODO ### 历史版本 -**建议**你用**最新版本**的插件，但如果你因为一些原因必须要用旧版的话... +**建议** 你用 **最新版本** 的插件，但如果你因为一些原因必须要用旧版的话... import Tabs from '@theme/Tabs'; import TabItem from '@theme/TabItem'; diff --git a/docs-java/process/plugin/more/tittle-tattle.md b/docs-java/process/plugin/more/tittle-tattle.md index 4fabce3a9..06fd11023 100644 --- a/docs-java/process/plugin/more/tittle-tattle.md +++ b/docs-java/process/plugin/more/tittle-tattle.md @@ -9,7 +9,7 @@ sidebar_position: 9 并非如此！ -事实上，大多数付费插件都能找到很好的免费替代，比如开源的 BetterHud 比付费的 HappyHUD(MythicHUD) 好很多。 +事实上，大多数付费插件都能找到很好的免费替代，比如开源的 BetterHud 比付费的 HappyHUD (MythicHUD) 好很多。 ## 插件不能做的事 @@ -39,11 +39,11 @@ Paper 服务器有一个鲜为人知的功能，那就是 update 文件夹。以 2. 逐个下载你想要更新的插件，并将它们放入 update 文件夹中。 3. 重启服务器，不要删除或修改 update 文件夹之外的任何插件。 -通过这种方式，你可以在服务器运行时同时更新所有插件， 而无需关闭服务器或替换正在运行的服务器中的插件 JAR 文件。 你无需在更新 Paper 本身之前重启服务器。 这个功能允许你同时更新 Paper 和插件，而无需任何额外的停机时间。 +通过这种方式，你可以在服务器运行时同时更新所有插件，而无需关闭服务器或替换正在运行的服务器中的插件 JAR 文件。你无需在更新 Paper 本身之前重启服务器。这个功能允许你同时更新 Paper 和插件，而无需任何额外的停机时间。 ## Spigot Library Booster -Spigot 在 1.17 之后新增了一个名 为LibraryLoader 的玩意，可以让插件在运行时下载所需依赖，无需将其包括在插件本体中，这显然是一个好消息，但是对于国内用户来说就显得不那么友好，Spigot 默认没有提供对下载源的自定义功能，导致只能从 maven 中心源缓慢地下载依赖文件甚至超时，本工具就是针对这种情况进行解决。 +Spigot 在 1.17 之后新增了一个名 为 LibraryLoader 的玩意，可以让插件在运行时下载所需依赖，无需将其包括在插件本体中，这显然是一个好消息，但是对于国内用户来说就显得不那么友好，Spigot 默认没有提供对下载源的自定义功能，导致只能从 maven 中心源缓慢地下载依赖文件甚至超时，本工具就是针对这种情况进行解决。 :::info @@ -51,7 +51,7 @@ Spigot 在 1.17 之后新增了一个名 为LibraryLoader 的玩意，可以让 ::: -如果你使用 Leaf 核心或 Paper 1.21.6(及其分支) 之后的版本，可以直接 [这样做](/docs-java/process/maintenance/optimize/jvm/common.md#下载源加速)，不需要使用此工具。 +如果你使用 Leaf 核心或 Paper 1.21.6 (及其分支) 之后的版本，可以直接 [这样做](/docs-java/process/maintenance/optimize/jvm/common.md#下载源加速)，不需要使用此工具。 ## 圈内破事 diff --git a/docs-java/process/plugin/Front-Plugin/PlaceHolderAPI/_images/CheckItem/checkitem.png b/docs-java/process/plugin/plugin-dependencies/placeholderapi/_images/CheckItem/checkitem.png similarity index 100% rename from docs-java/process/plugin/Front-Plugin/PlaceHolderAPI/_images/CheckItem/checkitem.png rename to docs-java/process/plugin/plugin-dependencies/placeholderapi/_images/CheckItem/checkitem.png diff --git a/docs-java/process/plugin/Front-Plugin/PlaceHolderAPI/_images/CheckItem/getinfo_1.png b/docs-java/process/plugin/plugin-dependencies/placeholderapi/_images/CheckItem/getinfo_1.png similarity index 100% rename from docs-java/process/plugin/Front-Plugin/PlaceHolderAPI/_images/CheckItem/getinfo_1.png rename to docs-java/process/plugin/plugin-dependencies/placeholderapi/_images/CheckItem/getinfo_1.png diff --git a/docs-java/process/plugin/Front-Plugin/PlaceHolderAPI/_images/CheckItem/getinfo_2.png b/docs-java/process/plugin/plugin-dependencies/placeholderapi/_images/CheckItem/getinfo_2.png similarity index 100% rename from docs-java/process/plugin/Front-Plugin/PlaceHolderAPI/_images/CheckItem/getinfo_2.png rename to docs-java/process/plugin/plugin-dependencies/placeholderapi/_images/CheckItem/getinfo_2.png diff --git a/docs-java/process/plugin/Front-Plugin/PlaceHolderAPI/_images/CheckItem/remove-item.png b/docs-java/process/plugin/plugin-dependencies/placeholderapi/_images/CheckItem/remove-item.png similarity index 100% rename from docs-java/process/plugin/Front-Plugin/PlaceHolderAPI/_images/CheckItem/remove-item.png rename to docs-java/process/plugin/plugin-dependencies/placeholderapi/_images/CheckItem/remove-item.png diff --git "a/docs-java/process/plugin/Front-Plugin/PlaceHolderAPI/_images/CheckItem/\347\216\251\345\256\266\350\203\214\345\214\205\346\247\275\344\275\215\345\233\276.webp" "b/docs-java/process/plugin/plugin-dependencies/placeholderapi/_images/CheckItem/\347\216\251\345\256\266\350\203\214\345\214\205\346\247\275\344\275\215\345\233\276.webp" similarity index 100% rename from "docs-java/process/plugin/Front-Plugin/PlaceHolderAPI/_images/CheckItem/\347\216\251\345\256\266\350\203\214\345\214\205\346\247\275\344\275\215\345\233\276.webp" rename to "docs-java/process/plugin/plugin-dependencies/placeholderapi/_images/CheckItem/\347\216\251\345\256\266\350\203\214\345\214\205\346\247\275\344\275\215\345\233\276.webp" diff --git "a/docs-java/process/plugin/Front-Plugin/PlaceHolderAPI/_images/CheckItem/\350\277\236\347\273\255\344\275\277\347\224\250-1.png" "b/docs-java/process/plugin/plugin-dependencies/placeholderapi/_images/CheckItem/\350\277\236\347\273\255\344\275\277\347\224\250-1.png" similarity index 100% rename from "docs-java/process/plugin/Front-Plugin/PlaceHolderAPI/_images/CheckItem/\350\277\236\347\273\255\344\275\277\347\224\250-1.png" rename to "docs-java/process/plugin/plugin-dependencies/placeholderapi/_images/CheckItem/\350\277\236\347\273\255\344\275\277\347\224\250-1.png" diff --git "a/docs-java/process/plugin/Front-Plugin/PlaceHolderAPI/_images/CheckItem/\350\277\236\347\273\255\344\275\277\347\224\250-2.png" "b/docs-java/process/plugin/plugin-dependencies/placeholderapi/_images/CheckItem/\350\277\236\347\273\255\344\275\277\347\224\250-2.png" similarity index 100% rename from "docs-java/process/plugin/Front-Plugin/PlaceHolderAPI/_images/CheckItem/\350\277\236\347\273\255\344\275\277\347\224\250-2.png" rename to "docs-java/process/plugin/plugin-dependencies/placeholderapi/_images/CheckItem/\350\277\236\347\273\255\344\275\277\347\224\250-2.png" diff --git "a/docs-java/process/plugin/Front-Plugin/PlaceHolderAPI/_images/CheckItem/\350\277\236\347\273\255\344\275\277\347\224\250-3.png" "b/docs-java/process/plugin/plugin-dependencies/placeholderapi/_images/CheckItem/\350\277\236\347\273\255\344\275\277\347\224\250-3.png" similarity index 100% rename from "docs-java/process/plugin/Front-Plugin/PlaceHolderAPI/_images/CheckItem/\350\277\236\347\273\255\344\275\277\347\224\250-3.png" rename to "docs-java/process/plugin/plugin-dependencies/placeholderapi/_images/CheckItem/\350\277\236\347\273\255\344\275\277\347\224\250-3.png" diff --git a/docs-java/process/plugin/Front-Plugin/PlaceHolderAPI/_images/Math/1.png b/docs-java/process/plugin/plugin-dependencies/placeholderapi/_images/Math/1.png similarity index 100% rename from docs-java/process/plugin/Front-Plugin/PlaceHolderAPI/_images/Math/1.png rename to docs-java/process/plugin/plugin-dependencies/placeholderapi/_images/Math/1.png diff --git a/docs-java/process/plugin/Front-Plugin/PlaceHolderAPI/_images/Math/2.png b/docs-java/process/plugin/plugin-dependencies/placeholderapi/_images/Math/2.png similarity index 100% rename from docs-java/process/plugin/Front-Plugin/PlaceHolderAPI/_images/Math/2.png rename to docs-java/process/plugin/plugin-dependencies/placeholderapi/_images/Math/2.png diff --git a/docs-java/process/plugin/Front-Plugin/PlaceHolderAPI/_images/Math/3.png b/docs-java/process/plugin/plugin-dependencies/placeholderapi/_images/Math/3.png similarity index 100% rename from docs-java/process/plugin/Front-Plugin/PlaceHolderAPI/_images/Math/3.png rename to docs-java/process/plugin/plugin-dependencies/placeholderapi/_images/Math/3.png diff --git a/docs-java/process/plugin/Front-Plugin/PlaceHolderAPI/_images/Math/4.png b/docs-java/process/plugin/plugin-dependencies/placeholderapi/_images/Math/4.png similarity index 100% rename from docs-java/process/plugin/Front-Plugin/PlaceHolderAPI/_images/Math/4.png rename to docs-java/process/plugin/plugin-dependencies/placeholderapi/_images/Math/4.png diff --git a/docs-java/process/plugin/Front-Plugin/PlaceHolderAPI/_images/ParseOther/ParseOther.png b/docs-java/process/plugin/plugin-dependencies/placeholderapi/_images/ParseOther/ParseOther.png similarity index 100% rename from docs-java/process/plugin/Front-Plugin/PlaceHolderAPI/_images/ParseOther/ParseOther.png rename to docs-java/process/plugin/plugin-dependencies/placeholderapi/_images/ParseOther/ParseOther.png diff --git a/docs-java/process/plugin/Front-Plugin/PlaceHolderAPI/_images/PlaceHolderAPI/1.png b/docs-java/process/plugin/plugin-dependencies/placeholderapi/_images/PlaceHolderAPI/1.png similarity index 100% rename from docs-java/process/plugin/Front-Plugin/PlaceHolderAPI/_images/PlaceHolderAPI/1.png rename to docs-java/process/plugin/plugin-dependencies/placeholderapi/_images/PlaceHolderAPI/1.png diff --git a/docs-java/process/plugin/Front-Plugin/PlaceHolderAPI/_images/PlaceHolderAPI/10.png b/docs-java/process/plugin/plugin-dependencies/placeholderapi/_images/PlaceHolderAPI/10.png similarity index 100% rename from docs-java/process/plugin/Front-Plugin/PlaceHolderAPI/_images/PlaceHolderAPI/10.png rename to docs-java/process/plugin/plugin-dependencies/placeholderapi/_images/PlaceHolderAPI/10.png diff --git a/docs-java/process/plugin/Front-Plugin/PlaceHolderAPI/_images/PlaceHolderAPI/11.png b/docs-java/process/plugin/plugin-dependencies/placeholderapi/_images/PlaceHolderAPI/11.png similarity index 100% rename from docs-java/process/plugin/Front-Plugin/PlaceHolderAPI/_images/PlaceHolderAPI/11.png rename to docs-java/process/plugin/plugin-dependencies/placeholderapi/_images/PlaceHolderAPI/11.png diff --git a/docs-java/process/plugin/Front-Plugin/PlaceHolderAPI/_images/PlaceHolderAPI/12.png b/docs-java/process/plugin/plugin-dependencies/placeholderapi/_images/PlaceHolderAPI/12.png similarity index 100% rename from docs-java/process/plugin/Front-Plugin/PlaceHolderAPI/_images/PlaceHolderAPI/12.png rename to docs-java/process/plugin/plugin-dependencies/placeholderapi/_images/PlaceHolderAPI/12.png diff --git a/docs-java/process/plugin/Front-Plugin/PlaceHolderAPI/_images/PlaceHolderAPI/2.png b/docs-java/process/plugin/plugin-dependencies/placeholderapi/_images/PlaceHolderAPI/2.png similarity index 100% rename from docs-java/process/plugin/Front-Plugin/PlaceHolderAPI/_images/PlaceHolderAPI/2.png rename to docs-java/process/plugin/plugin-dependencies/placeholderapi/_images/PlaceHolderAPI/2.png diff --git a/docs-java/process/plugin/Front-Plugin/PlaceHolderAPI/_images/PlaceHolderAPI/3.png b/docs-java/process/plugin/plugin-dependencies/placeholderapi/_images/PlaceHolderAPI/3.png similarity index 100% rename from docs-java/process/plugin/Front-Plugin/PlaceHolderAPI/_images/PlaceHolderAPI/3.png rename to docs-java/process/plugin/plugin-dependencies/placeholderapi/_images/PlaceHolderAPI/3.png diff --git a/docs-java/process/plugin/Front-Plugin/PlaceHolderAPI/_images/PlaceHolderAPI/4.png b/docs-java/process/plugin/plugin-dependencies/placeholderapi/_images/PlaceHolderAPI/4.png similarity index 100% rename from docs-java/process/plugin/Front-Plugin/PlaceHolderAPI/_images/PlaceHolderAPI/4.png rename to docs-java/process/plugin/plugin-dependencies/placeholderapi/_images/PlaceHolderAPI/4.png diff --git a/docs-java/process/plugin/Front-Plugin/PlaceHolderAPI/_images/PlaceHolderAPI/5.png b/docs-java/process/plugin/plugin-dependencies/placeholderapi/_images/PlaceHolderAPI/5.png similarity index 100% rename from docs-java/process/plugin/Front-Plugin/PlaceHolderAPI/_images/PlaceHolderAPI/5.png rename to docs-java/process/plugin/plugin-dependencies/placeholderapi/_images/PlaceHolderAPI/5.png diff --git a/docs-java/process/plugin/Front-Plugin/PlaceHolderAPI/_images/PlaceHolderAPI/6.png b/docs-java/process/plugin/plugin-dependencies/placeholderapi/_images/PlaceHolderAPI/6.png similarity index 100% rename from docs-java/process/plugin/Front-Plugin/PlaceHolderAPI/_images/PlaceHolderAPI/6.png rename to docs-java/process/plugin/plugin-dependencies/placeholderapi/_images/PlaceHolderAPI/6.png diff --git a/docs-java/process/plugin/Front-Plugin/PlaceHolderAPI/_images/PlaceHolderAPI/7.png b/docs-java/process/plugin/plugin-dependencies/placeholderapi/_images/PlaceHolderAPI/7.png similarity index 100% rename from docs-java/process/plugin/Front-Plugin/PlaceHolderAPI/_images/PlaceHolderAPI/7.png rename to docs-java/process/plugin/plugin-dependencies/placeholderapi/_images/PlaceHolderAPI/7.png diff --git a/docs-java/process/plugin/Front-Plugin/PlaceHolderAPI/_images/PlaceHolderAPI/8.png b/docs-java/process/plugin/plugin-dependencies/placeholderapi/_images/PlaceHolderAPI/8.png similarity index 100% rename from docs-java/process/plugin/Front-Plugin/PlaceHolderAPI/_images/PlaceHolderAPI/8.png rename to docs-java/process/plugin/plugin-dependencies/placeholderapi/_images/PlaceHolderAPI/8.png diff --git a/docs-java/process/plugin/Front-Plugin/PlaceHolderAPI/_images/PlaceHolderAPI/9.png b/docs-java/process/plugin/plugin-dependencies/placeholderapi/_images/PlaceHolderAPI/9.png similarity index 100% rename from docs-java/process/plugin/Front-Plugin/PlaceHolderAPI/_images/PlaceHolderAPI/9.png rename to docs-java/process/plugin/plugin-dependencies/placeholderapi/_images/PlaceHolderAPI/9.png diff --git a/docs-java/process/plugin/Front-Plugin/PlaceHolderAPI/_images/Progress/Progress.png b/docs-java/process/plugin/plugin-dependencies/placeholderapi/_images/Progress/Progress.png similarity index 100% rename from docs-java/process/plugin/Front-Plugin/PlaceHolderAPI/_images/Progress/Progress.png rename to docs-java/process/plugin/plugin-dependencies/placeholderapi/_images/Progress/Progress.png diff --git "a/docs-java/process/plugin/Front-Plugin/PlaceHolderAPI/_images/Q&A/\345\217\230\351\207\217\344\270\213\350\275\275\345\244\261\350\264\245.png" "b/docs-java/process/plugin/plugin-dependencies/placeholderapi/_images/Q&A/\345\217\230\351\207\217\344\270\213\350\275\275\345\244\261\350\264\245.png" similarity index 100% rename from "docs-java/process/plugin/Front-Plugin/PlaceHolderAPI/_images/Q&A/\345\217\230\351\207\217\344\270\213\350\275\275\345\244\261\350\264\245.png" rename to "docs-java/process/plugin/plugin-dependencies/placeholderapi/_images/Q&A/\345\217\230\351\207\217\344\270\213\350\275\275\345\244\261\350\264\245.png" diff --git "a/docs-java/process/plugin/Front-Plugin/PlaceHolderAPI/_images/Q&A/\345\217\230\351\207\217\344\270\215\346\230\276\347\244\272-1.png" "b/docs-java/process/plugin/plugin-dependencies/placeholderapi/_images/Q&A/\345\217\230\351\207\217\344\270\215\346\230\276\347\244\272-1.png" similarity index 100% rename from "docs-java/process/plugin/Front-Plugin/PlaceHolderAPI/_images/Q&A/\345\217\230\351\207\217\344\270\215\346\230\276\347\244\272-1.png" rename to "docs-java/process/plugin/plugin-dependencies/placeholderapi/_images/Q&A/\345\217\230\351\207\217\344\270\215\346\230\276\347\244\272-1.png" diff --git "a/docs-java/process/plugin/Front-Plugin/PlaceHolderAPI/_images/Q&A/\345\217\230\351\207\217\344\270\215\346\230\276\347\244\272-2.png" "b/docs-java/process/plugin/plugin-dependencies/placeholderapi/_images/Q&A/\345\217\230\351\207\217\344\270\215\346\230\276\347\244\272-2.png" similarity index 100% rename from "docs-java/process/plugin/Front-Plugin/PlaceHolderAPI/_images/Q&A/\345\217\230\351\207\217\344\270\215\346\230\276\347\244\272-2.png" rename to "docs-java/process/plugin/plugin-dependencies/placeholderapi/_images/Q&A/\345\217\230\351\207\217\344\270\215\346\230\276\347\244\272-2.png" diff --git a/docs-java/process/plugin/Front-Plugin/PlaceHolderAPI/ChangeOutput.md b/docs-java/process/plugin/plugin-dependencies/placeholderapi/change-output.md similarity index 57% rename from docs-java/process/plugin/Front-Plugin/PlaceHolderAPI/ChangeOutput.md rename to docs-java/process/plugin/plugin-dependencies/placeholderapi/change-output.md index 5c9b64bdb..75f5e263d 100644 --- a/docs-java/process/plugin/Front-Plugin/PlaceHolderAPI/ChangeOutput.md +++ b/docs-java/process/plugin/plugin-dependencies/placeholderapi/change-output.md @@ -33,16 +33,16 @@ sidebar_position: 9 ``` - `<选项>`： - - `equals` - 完全匹配内容 - - `ignorecase` - 忽略英文字符的大小写 - - `ignorecolor` - 忽略传入的彩色代码 - - `contains` - 包含匹配内容 - - `>=` - 检查输入是否大等于匹配内容 - - `>` - 检查输入是否等于匹配内容 - - `<=` - 检查输入是否小等于匹配内容 - - `<输入内容>` - 待比较的文本 - - `<匹配内容>` - 参与比较的文本或关键词 - - `<匹配输出的内容>` - 符合比较条件时输出的内容 - - `<不匹配输出的内容>` - 不符合比较条件时输出的内容 + - `equals` - 完全匹配内容 + - `ignorecase` - 忽略英文字符的大小写 + - `ignorecolor` - 忽略传入的彩色代码 + - `contains` - 包含匹配内容 + - `>=` - 检查输入是否大等于匹配内容 + - `>` - 检查输入是否等于匹配内容 + - `<=` - 检查输入是否小等于匹配内容 + - `<输入内容>` - 待比较的文本 + - `<匹配内容>` - 参与比较的文本或关键词 + - `<匹配输出的内容>` - 符合比较条件时输出的内容 + - `<不匹配输出的内容>` - 不符合比较条件时输出的内容 所有参数均可嵌入变量，需以 `{}` 替代百分号。 diff --git a/docs-java/process/plugin/Front-Plugin/PlaceHolderAPI/CheckItem.md b/docs-java/process/plugin/plugin-dependencies/placeholderapi/check-item.md similarity index 86% rename from docs-java/process/plugin/Front-Plugin/PlaceHolderAPI/CheckItem.md rename to docs-java/process/plugin/plugin-dependencies/placeholderapi/check-item.md index 98ab2a905..0a0544b64 100644 --- a/docs-java/process/plugin/Front-Plugin/PlaceHolderAPI/CheckItem.md +++ b/docs-java/process/plugin/plugin-dependencies/placeholderapi/check-item.md @@ -7,7 +7,7 @@ sidebar_position: 4 :::info -因高版本（1.20.4+）的 CheckItem 对 NBT 的检查存在问题，HelpChat Discord 上的 Blitz 及部分开发者对其进行了针对性修复，可从[这里](https://cdn.discordapp.com/attachments/573429521554866178/1377020689734701086/Expansion-CheckItem.jar?ex=683abdb4&is=68396c34&hm=833ab3aa7e997a35c1f85df41a18b28467e432d28884408bf6ecd5adb7b7f775&)（外网链接）直接下载。 +因高版本（1.20.4+）的 CheckItem 对 NBT 的检查存在问题，HelpChat Discord 上的 Blitz 及部分开发者对其进行了针对性修复，可从 [这里](https://cdn.discordapp.com/attachments/573429521554866178/1377020689734701086/Expansion-CheckItem.jar?ex=683abdb4&is=68396c34&hm=833ab3aa7e997a35c1f85df41a18b28467e432d28884408bf6ecd5adb7b7f775&)（外网链接）直接下载。 原文[见此](https://discord.com/channels/164280494874165248/573429521554866178/1377020690330423326)。 @@ -40,7 +40,7 @@ sidebar_position: 4 /papi parse me %checkitem_remove_diamond% ``` -在 [启用 give 和 remove](#启用 give 和 remove) 后，跑一下图中的变量会收取玩家所有的钻石 +在 [启用 give 和 remove](#启用-give-和-remove) 后，跑一下图中的变量会收取玩家所有的钻石 变量中 **remove** 的位置在作者项目的 README 中，并没有名字，其实这个地方决定了这个变量的效果 @@ -50,7 +50,7 @@ sidebar_position: 4 这里返回了 yes -[如何返回 true/false？](/docs-java/process/plugin/Front-Plugin/PlaceHolderAPI/Q&A.md#更改-boolean) +[如何返回 true/false？](/docs-java/process/plugin/plugin-dependencies/placeholderapi/faq.md#更改-boolean) 例如： @@ -154,9 +154,9 @@ sidebar_position: 4 ![](_images/CheckItem/连续使用-3.png) -### 例子：收取 ia 物品 +### 例子：收取 IA 物品 -收取指定 ia 物品的指定数量 +收取指定 IA 物品的指定数量 ```text %checkitem_remove_nbtstrings:itemsadder..id..data=ia 物品 ID,amt:数量% @@ -167,7 +167,7 @@ sidebar_position: 4 - nbtstrings - amt -其他物品库多数也会像 ia 一样给物品打上自己的 nbt 标签，照着改改就好 +其他物品库多数也会像 IA 一样给物品打上自己的 nbt 标签，照着改改就好 ## 启用 give 和 remove diff --git a/docs-java/process/plugin/Front-Plugin/PlaceHolderAPI/CommonUsage.md b/docs-java/process/plugin/plugin-dependencies/placeholderapi/common-usage.md similarity index 94% rename from docs-java/process/plugin/Front-Plugin/PlaceHolderAPI/CommonUsage.md rename to docs-java/process/plugin/plugin-dependencies/placeholderapi/common-usage.md index 8c325d529..b6ddaffc5 100644 --- a/docs-java/process/plugin/Front-Plugin/PlaceHolderAPI/CommonUsage.md +++ b/docs-java/process/plugin/plugin-dependencies/placeholderapi/common-usage.md @@ -5,7 +5,7 @@ sidebar_position: 2 # 常用变量 -这里只列出**部分**扩展的**部分**变量，这几个变量老是有人问 +这里只列出 **部分** 扩展的 **部分** 变量，这几个变量老是有人问 如果你想了解全部变量，点击 [此处](https://continue-project.netlify.app/PlaceholderAPI/user-guides.placeholder-list.html) @@ -36,7 +36,7 @@ sidebar_position: 2 ```text %server_online% - 服务器在线人数 %server_max_players% - 服务器最大在线人数 -%server_tps% - 服务器 tps +%server_tps% - 服务器 TPS %server_tps_5% %server_tps_15% %server_tps_1_colored% @@ -90,7 +90,7 @@ Multiverse-Core v5 已经内置 papi 支持，不再需要额外下载扩展 -[案例 | 中文世界名](../../WorldManagement/Multiverse/Q&A_1.md#世界别名) +[案例 | 中文世界名](../../world-management/multiverse/faq1.md#世界别名) ## PlayerPoints diff --git a/docs-java/process/plugin/Front-Plugin/PlaceHolderAPI/Q&A.md b/docs-java/process/plugin/plugin-dependencies/placeholderapi/faq.md similarity index 93% rename from docs-java/process/plugin/Front-Plugin/PlaceHolderAPI/Q&A.md rename to docs-java/process/plugin/plugin-dependencies/placeholderapi/faq.md index af4cee2ce..31f19f41a 100644 --- a/docs-java/process/plugin/Front-Plugin/PlaceHolderAPI/Q&A.md +++ b/docs-java/process/plugin/plugin-dependencies/placeholderapi/faq.md @@ -29,9 +29,9 @@ sidebar_position: 2 在上方图片中，可以看到箭头所指一行是 `%vault_eco_balance%` -你需要安装 [Vault](./../Vault/vault.md) 插件和 [经济插件](../XConomy.md) +你需要安装 [Vault](./../vault/vault.md) 插件和 [经济插件](../xconomy.md) -接着，确保你安装了 [PlaceHolderAPI](PlaceHolderAPI.md) 插件，执行下方命令 +接着，确保你安装了 [PlaceHolderAPI](placeholderapi.md) 插件，执行下方命令 ```bash /papi ecloud download Vault diff --git a/docs-java/process/plugin/Front-Plugin/PlaceHolderAPI/JavaScript.md b/docs-java/process/plugin/plugin-dependencies/placeholderapi/javascript.md similarity index 100% rename from docs-java/process/plugin/Front-Plugin/PlaceHolderAPI/JavaScript.md rename to docs-java/process/plugin/plugin-dependencies/placeholderapi/javascript.md diff --git a/docs-java/process/plugin/Front-Plugin/PlaceHolderAPI/Math.md b/docs-java/process/plugin/plugin-dependencies/placeholderapi/math.md similarity index 89% rename from docs-java/process/plugin/Front-Plugin/PlaceHolderAPI/Math.md rename to docs-java/process/plugin/plugin-dependencies/placeholderapi/math.md index 252178a10..a00afb46b 100644 --- a/docs-java/process/plugin/Front-Plugin/PlaceHolderAPI/Math.md +++ b/docs-java/process/plugin/plugin-dependencies/placeholderapi/math.md @@ -46,7 +46,7 @@ math: Debug: false ``` -修改`Decimals: 3`即可修改默认输出的小数位数 +修改 `Decimals: 3` 即可修改默认输出的小数位数 或者： @@ -73,7 +73,7 @@ math: 使用 `{}` 代替变量的 `%` -比如 [Server 扩展](https://wiki.placeholderapi.com/users/placeholder-list/#server)的 `%server_online%` 显示当前服务器在线玩家数 +比如 [Server 扩展](https://wiki.placeholderapi.com/users/placeholder-list/#server) 的 `%server_online%` 显示当前服务器在线玩家数 ![](_images/Math/4.png) diff --git a/docs-java/process/plugin/Front-Plugin/PlaceHolderAPI/ParseOther.md b/docs-java/process/plugin/plugin-dependencies/placeholderapi/parse-other.md similarity index 100% rename from docs-java/process/plugin/Front-Plugin/PlaceHolderAPI/ParseOther.md rename to docs-java/process/plugin/plugin-dependencies/placeholderapi/parse-other.md diff --git a/docs-java/process/plugin/Front-Plugin/PlaceHolderAPI/PlaceHolderAPI.md b/docs-java/process/plugin/plugin-dependencies/placeholderapi/placeholderapi.md similarity index 94% rename from docs-java/process/plugin/Front-Plugin/PlaceHolderAPI/PlaceHolderAPI.md rename to docs-java/process/plugin/plugin-dependencies/placeholderapi/placeholderapi.md index 5115454cb..3593a7004 100644 --- a/docs-java/process/plugin/Front-Plugin/PlaceHolderAPI/PlaceHolderAPI.md +++ b/docs-java/process/plugin/plugin-dependencies/placeholderapi/placeholderapi.md @@ -24,7 +24,7 @@ sidebar_position: 1 PlaceholderAPI 是适用于 Spigot 及其衍生服务端的插件，它允许服务器管理者以固定的格式替换占位符 (俗称变量) 为各种插件的信息。 -也可以做到一些你以为它不能做的事，比如 Math(数学运算) Checkitem(操作玩家物品) JavaScript(执行 js) Progress(制作进度条)。 +也可以做到一些你以为它不能做的事，比如 Math (数学运算)、Checkitem (操作玩家物品)、JavaScript (执行 JS)、Progress (制作进度条)。 对于插件的变量支持，通常由插件自己提供，或者安装变量扩展来提供变量。变量扩展可以在游戏内通过 PAPI eCloud 下载安装。现有超过 230 个扩展可下载，可支持非常多的插件，比如 Essentials、Factions、LuckPerms、Vault 等。如果你是开发者，并且希望为你的插件添加 PlaceholderAPI 支持，请参阅 [API 使用文档](https://github.com/PlaceholderAPI/PlaceholderAPI/wiki/Hook-into-PlaceholderAPI)。 @@ -64,7 +64,7 @@ PlaceholderAPI 已破 170 万下载量，同时使用本插件的服务器数已
点击展开 -```YAML +```yaml # PlaceholderAPI # 版本：2.11.4 # 作者：extended_clip @@ -73,7 +73,7 @@ PlaceholderAPI 已破 170 万下载量，同时使用本插件的服务器数已 # 变量扩展中心：https://api.extendedclip.com/all/ # 文档：https://wiki.placeholderapi.com/ # Discord: https://helpch.at/discord -# 插件默认不提供任何变量. +# 插件默认不提供任何变量。 # 请用这个命令下载变量：/papi ecloud check_updates: true cloud_enabled: true @@ -93,7 +93,7 @@ debug: false
点击展开 -```YAML +```yaml permissions: placeholderapi.*: description: "允许使用所有 PAPI 命令" @@ -219,15 +219,15 @@ eCloud 命令 `GitHub` https://github.com/PlaceholderAPI/PlaceholderAPI -`文档(英文)` https://wiki.placeholderapi.com +`文档 (英文)` https://wiki.placeholderapi.com -`文档(中文)` https://continue-project.netlify.app/PlaceholderAPI +`文档 (中文)` https://continue-project.netlify.app/PlaceholderAPI `插件百科` https://mineplugin.org/PlaceHolderAPI ::: -本页内容~~抄袭~~借鉴自 [此处](https://www.minebbs.com/resources/.8229) +本页内容 ~~抄袭~~ 借鉴自 [此处](https://www.minebbs.com/resources/.8229) ## Bstats diff --git a/docs-java/process/plugin/Front-Plugin/PlaceHolderAPI/Progress.md b/docs-java/process/plugin/plugin-dependencies/placeholderapi/progress.md similarity index 100% rename from docs-java/process/plugin/Front-Plugin/PlaceHolderAPI/Progress.md rename to docs-java/process/plugin/plugin-dependencies/placeholderapi/progress.md diff --git a/docs-java/process/plugin/Front-Plugin/PlaceHolderAPI/String.md b/docs-java/process/plugin/plugin-dependencies/placeholderapi/string.md similarity index 95% rename from docs-java/process/plugin/Front-Plugin/PlaceHolderAPI/String.md rename to docs-java/process/plugin/plugin-dependencies/placeholderapi/string.md index a4ccf8408..58a1bd694 100644 --- a/docs-java/process/plugin/Front-Plugin/PlaceHolderAPI/String.md +++ b/docs-java/process/plugin/plugin-dependencies/placeholderapi/string.md @@ -47,7 +47,7 @@ sidebar_position: 9 "9": "₉" ``` -变量列表： +变量列表： `%string_equals__%` - 检查 `string` 和 `match` 是否为相同字符串（区分大小写） `%string_equalsIgnoreCase__%` - 检查 `string` 和 `match` 是否相同（不区分大小写） @@ -62,10 +62,10 @@ sidebar_position: 9 `%string_lastIndexOf__%` - 返回 `match` 在 `string` 中最后一次出现的索引。如果不存在则返回 -1 -`%string_substring__%` - 返回从 `startIndex` 开始的子字符串 +`%string_substring__%` - 返回从 `startIndex` 开始的子字符串 **支持负索引作为起始索引** -`%string_substring_,_%` - 返回从 `startIndex` 开始到 `endIndex` 之前结束的子字符串 +`%string_substring_,_%` - 返回从 `startIndex` 开始到 `endIndex` 之前结束的子字符串 **支持负索引作为结束索引** `%string_shuffle_%` - 返回字符顺序被打乱的 `string` @@ -94,5 +94,5 @@ sidebar_position: 9 `%string_occurences_count__%` - 计算 `match` 在 `string` 中出现的次数 -**支持 PlaceholderAPI 变量。只需使用大括号（`{}`）而不是百分号（`%%`）。** +**支持 PlaceholderAPI 变量。只需使用大括号（`{}`）而不是百分号（`%%`）。** 例如：`%string_equals_{server_name}_Lobby%` - 将基于 `%server_name%` 变量检查当前服务器名称是否为 lobby。 diff --git a/docs-java/process/plugin/Front-Plugin/PlayerPoints.md b/docs-java/process/plugin/plugin-dependencies/playerpoints.md similarity index 65% rename from docs-java/process/plugin/Front-Plugin/PlayerPoints.md rename to docs-java/process/plugin/plugin-dependencies/playerpoints.md index bcb616e3d..b29c33fbe 100644 --- a/docs-java/process/plugin/Front-Plugin/PlayerPoints.md +++ b/docs-java/process/plugin/plugin-dependencies/playerpoints.md @@ -7,15 +7,15 @@ sidebar_position: 4 :::info -`Bukkit(旧)` https://dev.bukkit.org/projects/playerpoints +`Bukkit (旧)` https://dev.bukkit.org/projects/playerpoints `SpigotMC` https://www.spigotmc.org/resources/playerpoints.80745/ `GitHub` https://github.com/Rosewood-Development/PlayerPoints -`文档(英文)` https://github.com/Rosewood-Development/PlayerPoints/wiki +`文档 (英文)` https://github.com/Rosewood-Development/PlayerPoints/wiki -`文档(中文)` https://continue-project.netlify.app/PlayerPoints/README.html +`文档 (中文)` https://continue-project.netlify.app/PlayerPoints/README.html `插件百科` https://mineplugin.org/PlayerPoints diff --git a/docs-java/process/plugin/Front-Plugin/Front-Plugin.md b/docs-java/process/plugin/plugin-dependencies/plugin-dependencies.md similarity index 100% rename from docs-java/process/plugin/Front-Plugin/Front-Plugin.md rename to docs-java/process/plugin/plugin-dependencies/plugin-dependencies.md diff --git a/docs-java/process/plugin/Front-Plugin/ProtocolLib.md b/docs-java/process/plugin/plugin-dependencies/protocollib.md similarity index 76% rename from docs-java/process/plugin/Front-Plugin/ProtocolLib.md rename to docs-java/process/plugin/plugin-dependencies/protocollib.md index 7e2be8852..66ae1475b 100644 --- a/docs-java/process/plugin/Front-Plugin/ProtocolLib.md +++ b/docs-java/process/plugin/plugin-dependencies/protocollib.md @@ -7,7 +7,7 @@ sidebar_position: 5 :::info -`Bukkit(旧)` https://dev.bukkit.org/projects/protocollib +`Bukkit (旧)` https://dev.bukkit.org/projects/protocollib `SpigotMC` https://www.spigotmc.org/resources/protocollib.1997/ @@ -19,7 +19,7 @@ sidebar_position: 5 ::: -如果你是一个腐竹，那么你不需要知道这个插件具体怎么用，因为你**不需要配置**这个插件任何东西，这是给插件开发者用的，如果你用的某个插件需要 ProtocolLib，装上即可 +如果你是一个腐竹，那么你不需要知道这个插件具体怎么用，因为你 **不需要配置** 这个插件任何东西，这是给插件开发者用的，如果你用的某个插件需要 ProtocolLib，装上即可 1.8-1.19.4 用 [5.0.0](https://github.com/dmulloy2/ProtocolLib/releases/tag/5.0.0) diff --git a/docs-java/process/plugin/Front-Plugin/Vault/ServiceIO.md b/docs-java/process/plugin/plugin-dependencies/vault/serviceio.md similarity index 66% rename from docs-java/process/plugin/Front-Plugin/Vault/ServiceIO.md rename to docs-java/process/plugin/plugin-dependencies/vault/serviceio.md index f0afaafa3..17b8a12a4 100644 --- a/docs-java/process/plugin/Front-Plugin/Vault/ServiceIO.md +++ b/docs-java/process/plugin/plugin-dependencies/vault/serviceio.md @@ -33,26 +33,26 @@ ServiceIO 的一个关键特性是与现有 Vault 接口的无缝集成，允许 ## 命令 -- /service convert banks：转换所有 banks 和 bank accounts -- /service convert chat：转换所有聊天数据（前缀、后缀、昵称等） -- /service convert economy：转换所有经济数据（账户和余额） -- /service convert groups：转换所有群组数据（群组、前缀、后缀、权限、成员） -- /service convert permissions：转换所有权限数据（用户、权限） +- `/service convert banks`：转换所有 banks 和 bank accounts +- `/service convert chat`：转换所有聊天数据（前缀、后缀、昵称等） +- `/service convert economy`：转换所有经济数据（账户和余额） +- `/service convert groups`：转换所有群组数据（群组、前缀、后缀、权限、成员） +- `/service convert permissions`：转换所有权限数据（用户、权限） ## 信息 -- /service info bank: 查看已安装的 bank 提供插件 -- /service info chat: 查看已安装的 chat 提供插件 -- /service info economy: 查看已安装的经济提供插件 -- /service info groups: 查看已安装的群组提供插件 -- /service info permissions: 查看已安装的权提供插件 +- `/service info bank`: 查看已安装的 bank 提供插件 +- `/service info chat`: 查看已安装的 chat 提供插件 +- `/service info economy`: 查看已安装的经济提供插件 +- `/service info groups`: 查看已安装的群组提供插件 +- `/service info permissions`: 查看已安装的权提供插件 ## 权限 -- /service convert：需要 service.convert -- /service info：需要 service.info -- service.admin 权限允许访问所有 ServiceIO 命令 -- 且 vault.admin 等同于 service.admin +- `/service convert`：需要 `service.convert` +- `/service info`：需要 `service.info` +- `service.admin` 权限允许访问所有 ServiceIO 命令 +- 且 `vault.admin` 等同于 `service.admin` ## 链接 @@ -68,8 +68,7 @@ ServiceIO 的一个关键特性是与现有 Vault 接口的无缝集成，允许 ## 联系 -[![](https://img.shields.io/discord/1293606111177609277?logo=discord&label=Discord)](https://thenextlvl.net/discord) -\<- 点击加入 作者的 Discord +点击加入 作者的 Discord [![](https://img.shields.io/discord/1293606111177609277?logo=discord&label=Discord)](https://thenextlvl.net/discord) ## Bstats diff --git a/docs-java/process/plugin/Front-Plugin/Vault/vault.md b/docs-java/process/plugin/plugin-dependencies/vault/vault.md similarity index 92% rename from docs-java/process/plugin/Front-Plugin/Vault/vault.md rename to docs-java/process/plugin/plugin-dependencies/vault/vault.md index ebb0abf54..6ff7203cb 100644 --- a/docs-java/process/plugin/Front-Plugin/Vault/vault.md +++ b/docs-java/process/plugin/plugin-dependencies/vault/vault.md @@ -34,8 +34,8 @@ sidebar_position: 2 人话：Vault 只是提供经济的插件的前置，本身并不提供经济功能，就是给众多经济系统提供了一个统一接口 -想要经济可以看看 [XConomy](../XConomy.md) 页面 +想要经济可以看看 [XConomy](../xconomy.md) 页面 -## Vault 支持旧版和新版本 mc 吗 +## Vault 支持旧版和新版本 MC 吗 支持，不用在意 SpigotMC 上标注的版本。 diff --git a/docs-java/process/plugin/Front-Plugin/Vault/VaultUnlocked.md b/docs-java/process/plugin/plugin-dependencies/vault/vaultunlocked.md similarity index 85% rename from docs-java/process/plugin/Front-Plugin/Vault/VaultUnlocked.md rename to docs-java/process/plugin/plugin-dependencies/vault/vaultunlocked.md index 90dcbaeef..c27f66f98 100644 --- a/docs-java/process/plugin/Front-Plugin/Vault/VaultUnlocked.md +++ b/docs-java/process/plugin/plugin-dependencies/vault/vaultunlocked.md @@ -26,7 +26,7 @@ Vault 的分支版本，提供更多功能 ## 权限 -- vault.admin：拥有权限的玩家将收到更新提醒 +- `vault.admin`：拥有权限的玩家将收到更新提醒 ## 链接 @@ -48,7 +48,7 @@ Vault 的分支版本，提供更多功能 ## 联系 -[![](https://img.shields.io/badge/Discord-creatorfromhell-blue?logo=Discord)](https://discord.gg/WNdwzpy) \<- 点击加入 作者的 Discord +点击加入 作者的 Discord [![](https://img.shields.io/badge/Discord-creatorfromhell-blue?logo=Discord)](https://discord.gg/WNdwzpy) ## Bstats diff --git a/docs-java/process/plugin/Front-Plugin/XConomy.md b/docs-java/process/plugin/plugin-dependencies/xconomy.md similarity index 51% rename from docs-java/process/plugin/Front-Plugin/XConomy.md rename to docs-java/process/plugin/plugin-dependencies/xconomy.md index 3724ad1c3..830f45e70 100644 --- a/docs-java/process/plugin/Front-Plugin/XConomy.md +++ b/docs-java/process/plugin/plugin-dependencies/xconomy.md @@ -5,7 +5,7 @@ sidebar_position: 3 # 经济插件 -这里指以 [Vault](Vault/vault.md) 为前置的为服务器提供经济的 **一类插件** +这里指以 [Vault](./vault/vault.md) 为前置的为服务器提供经济的 **一类插件** 如 XConomy @@ -23,7 +23,7 @@ sidebar_position: 3 国人插件 -如果你已经安装了 [基础插件](/Java/Essentials) 并且**没有跨服的需求**，可以不安装这个插件 +如果你已经安装了 [基础插件](../management-tool/basic-plugins/basic-plugins.md) 并且 **没有跨服的需求**，可以不安装这个插件 因为基础插件已经提供了经济 @@ -31,7 +31,7 @@ sidebar_position: 3 ### 连接数据库 -如果你使用的是**MySQL 8**，并且无法正常连接到数据库，请下载 [DatabaseDrivers](https://github.com/YiC200333/DatabaseDrivers/releases) (1.17.X 以上版本服务器不需要) +如果你使用的是 **MySQL 8**，并且无法正常连接到数据库，请下载 [DatabaseDrivers](https://github.com/YiC200333/DatabaseDrivers/releases) (1.17.X 以上版本服务器不需要) MariaDB 必须安装 DatabaseDrivers diff --git a/docs-java/process/plugin/plugin.md b/docs-java/process/plugin/plugin.md index 484917702..d90e44df3 100644 --- a/docs-java/process/plugin/plugin.md +++ b/docs-java/process/plugin/plugin.md @@ -2,7 +2,7 @@ title: 插件 slug: /plugin sidebar_position: 1 -sidebar_label: Java插件 +sidebar_label: Java 插件 --- # 插件 @@ -11,7 +11,7 @@ sidebar_label: Java插件 建议阅读： -- [YAML 语法](../../advance/YAML/YAML.md) - 了解大部分插件配置文件的语法。 +- [YAML 语法](../../advance/yaml/yaml.md) - 了解大部分插件配置文件的语法。 - [特征文件](./more/plugin-signature-file.md) - 了解插件的一些信息。 - [颜色代码](./more/color-message.md) - 改变服务器中文本的颜色 - [什么是乱码](/start/basic/what-is-messy-code) - 了解文本文件中的字符有时为什么会变得奇奇怪怪。 @@ -28,7 +28,7 @@ sidebar_label: Java插件 :::danger -服务器在**开发阶段**可以使用 PlugmanX，ServerUtils 等插件热重载插件。 +服务器在 **开发阶段** 可以使用 PlugmanX，ServerUtils 等插件热重载插件。 过了开发阶段后切记，多数插件自带了重载（上方就是）。 @@ -60,7 +60,7 @@ sidebar_label: Java插件 安装的插件列表 - ProtocolLib 必备前置 -- Luckperms 权限管理插件 +- LuckPerms 权限管理插件 - PlaceholderAPI 必备前置 - PlugManx 插件管理 - WorldEdit 创世神 @@ -72,7 +72,7 @@ sidebar_label: Java插件 - TrChat 聊天插件 - MiniMotd MOTD 插件 -Via 自动安装已经移动到[此处](./other/Via/Via.md#笨蛋脚本) +Via 自动安装已经移动到 [此处](./misc/via/via.md#笨蛋脚本)
diff --git a/docs-java/process/plugin/protection/_images/Residence-github.png b/docs-java/process/plugin/protection/_images/Residence-github.png deleted file mode 100644 index 418316443..000000000 Binary files a/docs-java/process/plugin/protection/_images/Residence-github.png and /dev/null differ diff --git a/docs-java/process/plugin/protection/ASkyBlock.md b/docs-java/process/plugin/protection/askyblock.md similarity index 80% rename from docs-java/process/plugin/protection/ASkyBlock.md rename to docs-java/process/plugin/protection/askyblock.md index 634e0e4d4..f2e56dcf5 100644 --- a/docs-java/process/plugin/protection/ASkyBlock.md +++ b/docs-java/process/plugin/protection/askyblock.md @@ -19,4 +19,4 @@ sidebar_label: 空岛 - ASkyBlock 支持到 1.12 -需要 1.13+ 使用 [BSkyBlock](/Java/process/plugin/protection/BentoBox#bskyblock) +需要 1.13+ 使用 [BSkyBlock](bentobox.md#bskyblock) diff --git a/docs-java/process/plugin/protection/BentoBox.md b/docs-java/process/plugin/protection/bentobox.md similarity index 69% rename from docs-java/process/plugin/protection/BentoBox.md rename to docs-java/process/plugin/protection/bentobox.md index c7eecae0d..9fc38a37a 100644 --- a/docs-java/process/plugin/protection/BentoBox.md +++ b/docs-java/process/plugin/protection/bentobox.md @@ -17,15 +17,15 @@ sidebar_label: 领域 - BentoBox `GitHub` https://github.com/BentoBoxWorld/BentoBox -`文档(英文)` https://docs.bentobox.world/en/latest +`文档 (英文)` https://docs.bentobox.world/en/latest -`文档(中文)` https://docs.bentobox.world/zh/latest +`文档 (中文)` https://docs.bentobox.world/zh/latest ::: 著名的领域生存插件。 -含有 BSkyBlock(空岛)AOneBlock(单方块空岛)AcidIsland(海岛) 等多种模式。 +含有 BSkyBlock (空岛)、AOneBlock (单方块空岛)、AcidIsland (海岛) 等多种模式。 ## BSkyBlock diff --git a/docs-java/process/plugin/protection/Dominion.md b/docs-java/process/plugin/protection/dominion.md similarity index 96% rename from docs-java/process/plugin/protection/Dominion.md rename to docs-java/process/plugin/protection/dominion.md index a22610442..a94873dbb 100644 --- a/docs-java/process/plugin/protection/Dominion.md +++ b/docs-java/process/plugin/protection/dominion.md @@ -32,7 +32,7 @@ sidebar_label: 领地 - Dominion 1. 版本更新快（几乎是遇到一个 bug 修一个然后发一个版本），服务态度好（前提你是正常用户不是捣乱的），作者温柔又善良（嘻嘻） 2. 完全开源、免费，专为高版本开发。 -3. 支持导入 [Residence](./Residence.md) 插件的绝大多数数据。 +3. 支持导入 [Residence](./residence.md) 插件的绝大多数数据。 ## 缺点 diff --git a/docs-java/process/plugin/protection/GriefDefender.md b/docs-java/process/plugin/protection/griefdefender.md similarity index 77% rename from docs-java/process/plugin/protection/GriefDefender.md rename to docs-java/process/plugin/protection/griefdefender.md index 950068e3d..99cf3e8f0 100644 --- a/docs-java/process/plugin/protection/GriefDefender.md +++ b/docs-java/process/plugin/protection/griefdefender.md @@ -11,9 +11,9 @@ sidebar_label: 领地 - GriefDefender `GitHub` https://github.com/bloodmc/GriefDefender -`文档(英文)`https://docs.griefdefender.com/ +`文档 (英文)`https://docs.griefdefender.com/ -`文档(中文)`https://docs.griefdefender.com/zh/ +`文档 (中文)`https://docs.griefdefender.com/zh/ ::: diff --git a/docs-java/process/plugin/protection/PlotSquared.md b/docs-java/process/plugin/protection/plotsquared.md similarity index 52% rename from docs-java/process/plugin/protection/PlotSquared.md rename to docs-java/process/plugin/protection/plotsquared.md index dca14728c..190ca7c08 100644 --- a/docs-java/process/plugin/protection/PlotSquared.md +++ b/docs-java/process/plugin/protection/plotsquared.md @@ -7,15 +7,15 @@ sidebar_label: 地皮 - PlotSquared :::info -`Bukkit(旧)` https://dev.bukkit.org/projects/plotsquared +`Bukkit (旧)` https://dev.bukkit.org/projects/plotsquared `SpigotMC` https://www.spigotmc.org/resources/.77506 `GitHub` https://github.com/IntellectualSites/PlotSquared -`文档(英文)`https://intellectualsites.gitbook.io/plotsquared +`文档 (英文)`https://intellectualsites.gitbook.io/plotsquared -`文档(中文)`https://docs.superiormc.cn/v/plotsquared-wiki +`文档 (中文)`https://docs.superiormc.cn/v/plotsquared-wiki `插件百科` https://mineplugin.org/PlotSquared @@ -29,4 +29,4 @@ sidebar_label: 地皮 - PlotSquared ## 前置 -[WorldEdit](../WorldManagement/WorldEdit.md) 或 [FastAsyncWorldEdit](../WorldManagement/FastAsyncWorldEdit.md) +[WorldEdit](../world-management/worldedit.md) 或 [FastAsyncWorldEdit](../world-management/fastasyncworldedit.md) diff --git a/docs-java/process/plugin/protection/Residence.md b/docs-java/process/plugin/protection/residence.md similarity index 91% rename from docs-java/process/plugin/protection/Residence.md rename to docs-java/process/plugin/protection/residence.md index 0c032dd1e..5a4dfb678 100644 --- a/docs-java/process/plugin/protection/Residence.md +++ b/docs-java/process/plugin/protection/residence.md @@ -7,7 +7,7 @@ sidebar_label: 领地 - Residence :::info -`Bukkit(旧)` https://dev.bukkit.org/projects/residence +`Bukkit (旧)` https://dev.bukkit.org/projects/residence `SpigotMC` https://www.spigotmc.org/resources/.11480 @@ -25,7 +25,7 @@ sidebar_label: 领地 - Residence :::warning -为避免漏洞利用，建议不要使用 5.1.4.2 以下版本的Residence +为避免漏洞利用，建议不要使用 5.1.4.2 以下版本的 Residence ::: @@ -48,4 +48,4 @@ Residence 需要 CMIlib 作为前置插件 2. 插件的支持较多，出现插件之间互相不兼容的可能性更少 -3. 支持1.8以上的服务器 +3. 支持 1.8 以上的服务器 diff --git a/docs-java/process/plugin/protection/Towny.md b/docs-java/process/plugin/protection/towny.md similarity index 100% rename from docs-java/process/plugin/protection/Towny.md rename to docs-java/process/plugin/protection/towny.md diff --git a/docs-java/process/plugin/WorldManagement/_images/NoBuildPlus/banner_compat_nobuildplus_zh_CN.png b/docs-java/process/plugin/world-management/_images/NoBuildPlus/banner_compat_nobuildplus_zh_CN.png similarity index 100% rename from docs-java/process/plugin/WorldManagement/_images/NoBuildPlus/banner_compat_nobuildplus_zh_CN.png rename to docs-java/process/plugin/world-management/_images/NoBuildPlus/banner_compat_nobuildplus_zh_CN.png diff --git a/docs-java/process/plugin/WorldManagement/_images/NoBuildPlus/banner_deny_nobuildplus_zh_CN.png b/docs-java/process/plugin/world-management/_images/NoBuildPlus/banner_deny_nobuildplus_zh_CN.png similarity index 100% rename from docs-java/process/plugin/WorldManagement/_images/NoBuildPlus/banner_deny_nobuildplus_zh_CN.png rename to docs-java/process/plugin/world-management/_images/NoBuildPlus/banner_deny_nobuildplus_zh_CN.png diff --git a/docs-java/process/plugin/WorldManagement/_images/NoBuildPlus/banner_nobuildplus_zh_CN.png b/docs-java/process/plugin/world-management/_images/NoBuildPlus/banner_nobuildplus_zh_CN.png similarity index 100% rename from docs-java/process/plugin/WorldManagement/_images/NoBuildPlus/banner_nobuildplus_zh_CN.png rename to docs-java/process/plugin/world-management/_images/NoBuildPlus/banner_nobuildplus_zh_CN.png diff --git a/docs-java/process/plugin/WorldManagement/_images/NoBuildPlus/banner_type_nobuildplus_zh_CN.png b/docs-java/process/plugin/world-management/_images/NoBuildPlus/banner_type_nobuildplus_zh_CN.png similarity index 100% rename from docs-java/process/plugin/WorldManagement/_images/NoBuildPlus/banner_type_nobuildplus_zh_CN.png rename to docs-java/process/plugin/world-management/_images/NoBuildPlus/banner_type_nobuildplus_zh_CN.png diff --git a/docs-java/process/plugin/WorldManagement/_images/worldguard-logo.svg b/docs-java/process/plugin/world-management/_images/worldguard-logo.svg similarity index 100% rename from docs-java/process/plugin/WorldManagement/_images/worldguard-logo.svg rename to docs-java/process/plugin/world-management/_images/worldguard-logo.svg diff --git a/docs-java/process/plugin/WorldManagement/FastAsyncWorldEdit.md b/docs-java/process/plugin/world-management/fastasyncworldedit.md similarity index 55% rename from docs-java/process/plugin/WorldManagement/FastAsyncWorldEdit.md rename to docs-java/process/plugin/world-management/fastasyncworldedit.md index 5f7de3d7b..1bc12f2f8 100644 --- a/docs-java/process/plugin/WorldManagement/FastAsyncWorldEdit.md +++ b/docs-java/process/plugin/world-management/fastasyncworldedit.md @@ -7,17 +7,11 @@ sidebar_label: FAWE - FastAsyncWorldEdit - - Join us on Discord - - - bStats Servers - - - Crowdin - - -> 异步创世神，可以直接无脑把 [WorldEdit](./WorldEdit.md) 替换掉 +[![Discord](https://img.shields.io/discord/268444645527126017.svg?label=&logo=discord&logoColor=ffffff&color=7389D8&labelColor=6A7EC2)](https://discord.gg/intellectualsites) +[![bStats Servers](https://img.shields.io/bstats/servers/1403)](https://bstats.org/plugin/bukkit/FastAsyncWorldEdit/1403) +[![Crowdin](https://badges.crowdin.net/e/4a5819fae3fd88234a8ea13bfbb072bb/localized.svg)](https://intellectualsites.crowdin.com/fastasyncworldedit) + +> 异步创世神，可以直接无脑把 [WorldEdit](worldedit.md) 替换掉 FastAsyncWorldEdit 是 WorldEdit 的异步优化版本 @@ -37,9 +31,9 @@ FastAsyncWorldEdit 是 WorldEdit 的异步优化版本 `GitHub` https://github.com/IntellectualSites/FastAsyncWorldEdit -`文档(英文)` https://intellectualsites.gitbook.io/fastasyncworldedit +`文档 (英文)` https://intellectualsites.gitbook.io/fastasyncworldedit -`文档(中文)` https://izzelaliz.gitbooks.io/fast-async-worldedit-wiki/content +`文档 (中文)` https://izzelaliz.gitbooks.io/fast-async-worldedit-wiki/content `插件百科` https://mineplugin.org/FastAsyncWorldEdit diff --git a/docs-java/process/plugin/WorldManagement/Law.md b/docs-java/process/plugin/world-management/law.md similarity index 81% rename from docs-java/process/plugin/WorldManagement/Law.md rename to docs-java/process/plugin/world-management/law.md index 835e02a81..6636ccf35 100644 --- a/docs-java/process/plugin/WorldManagement/Law.md +++ b/docs-java/process/plugin/world-management/law.md @@ -5,15 +5,9 @@ sidebar_label: 保护 - Law # Law - - Release - - - Code Size - - - License - +[![Release](https://img.shields.io/github/v/release/mouse0w0/law)](https://github.com/mouse0w0/law/releases) +[![Code Size](https://img.shields.io/github/languages/code-size/mouse0w0/law)](https://github.com/mouse0w0/law) +[![License](https://img.shields.io/github/license/mouse0w0/law)](https://github.com/mouse0w0/law/blob/main/LICENSE) 本插件基于 Bukkit API 开发，用于在服务器中控制实体和方块行为，并为不同世界设置不同规则。 diff --git a/docs-java/process/plugin/WorldManagement/lobby/DeluxeHub.md b/docs-java/process/plugin/world-management/lobby/deluxehub.md similarity index 62% rename from docs-java/process/plugin/WorldManagement/lobby/DeluxeHub.md rename to docs-java/process/plugin/world-management/lobby/deluxehub.md index bec19e1ea..102fa0166 100644 --- a/docs-java/process/plugin/WorldManagement/lobby/DeluxeHub.md +++ b/docs-java/process/plugin/world-management/lobby/deluxehub.md @@ -11,12 +11,12 @@ sidebar_position: 2 `GitHub` https://github.com/ItsLewizzz/DeluxeHub -`文档(英文)` https://docs.zithium.net/other-plugins/deluxehub +`文档 (英文)` https://docs.zithium.net/other-plugins/deluxehub -`文档(中文)` https://miao-3.gitbook.io/deluxehub-3-zhong-wen-wiki +`文档 (中文)` https://miao-3.gitbook.io/deluxehub-3-zhong-wen-wiki ::: 避孕套大厅，在我编辑此页时，此插件的最后一次代码提交为 Jun 20, 2023 -个人认为插件作者已经放弃维护此插件，建议使用第三方更新的 [DeluxeHubReloaded](DeluxeHubReloaded.md) +个人认为插件作者已经放弃维护此插件，建议使用第三方更新的 [DeluxeHubReloaded](deluxehubreloaded.md) diff --git a/docs-java/process/plugin/WorldManagement/lobby/DeluxeHubReloaded.md b/docs-java/process/plugin/world-management/lobby/deluxehubreloaded.md similarity index 62% rename from docs-java/process/plugin/WorldManagement/lobby/DeluxeHubReloaded.md rename to docs-java/process/plugin/world-management/lobby/deluxehubreloaded.md index bba275bb8..5fc14ed59 100644 --- a/docs-java/process/plugin/WorldManagement/lobby/DeluxeHubReloaded.md +++ b/docs-java/process/plugin/world-management/lobby/deluxehubreloaded.md @@ -11,8 +11,8 @@ sidebar_position: 3 `GitHub` https://github.com/Strafbefehl/DeluxeHubReloaded -`文档(英文)` https://strafbefehl.github.io/DeluxeHubReloadedDocs +`文档 (英文)` https://strafbefehl.github.io/DeluxeHubReloadedDocs ::: -[DeluxeHub](DeluxeHub.md) 的第三方维护版本 +[DeluxeHub](deluxehub.md) 的第三方维护版本 diff --git a/docs-java/process/plugin/WorldManagement/lobby/lobby.md b/docs-java/process/plugin/world-management/lobby/lobby.md similarity index 100% rename from docs-java/process/plugin/WorldManagement/lobby/lobby.md rename to docs-java/process/plugin/world-management/lobby/lobby.md diff --git a/docs-java/process/plugin/WorldManagement/lobby/SuperLobbyDeluxe.md b/docs-java/process/plugin/world-management/lobby/superlobbydeluxe.md similarity index 100% rename from docs-java/process/plugin/WorldManagement/lobby/SuperLobbyDeluxe.md rename to docs-java/process/plugin/world-management/lobby/superlobbydeluxe.md diff --git a/docs-java/process/plugin/WorldManagement/Multiverse/_images/multiverse2-long.png b/docs-java/process/plugin/world-management/multiverse/_images/multiverse2-long.png similarity index 100% rename from docs-java/process/plugin/WorldManagement/Multiverse/_images/multiverse2-long.png rename to docs-java/process/plugin/world-management/multiverse/_images/multiverse2-long.png diff --git "a/docs-java/process/plugin/WorldManagement/Multiverse/_images/\344\270\255\346\226\207\344\270\226\347\225\214\345\220\215-1.png" "b/docs-java/process/plugin/world-management/multiverse/_images/\344\270\255\346\226\207\344\270\226\347\225\214\345\220\215-1.png" similarity index 100% rename from "docs-java/process/plugin/WorldManagement/Multiverse/_images/\344\270\255\346\226\207\344\270\226\347\225\214\345\220\215-1.png" rename to "docs-java/process/plugin/world-management/multiverse/_images/\344\270\255\346\226\207\344\270\226\347\225\214\345\220\215-1.png" diff --git "a/docs-java/process/plugin/WorldManagement/Multiverse/_images/\344\270\255\346\226\207\344\270\226\347\225\214\345\220\215-2.png" "b/docs-java/process/plugin/world-management/multiverse/_images/\344\270\255\346\226\207\344\270\226\347\225\214\345\220\215-2.png" similarity index 100% rename from "docs-java/process/plugin/WorldManagement/Multiverse/_images/\344\270\255\346\226\207\344\270\226\347\225\214\345\220\215-2.png" rename to "docs-java/process/plugin/world-management/multiverse/_images/\344\270\255\346\226\207\344\270\226\347\225\214\345\220\215-2.png" diff --git "a/docs-java/process/plugin/WorldManagement/Multiverse/_images/\344\270\255\346\226\207\344\270\226\347\225\214\345\220\215\344\271\261\347\240\201.png" "b/docs-java/process/plugin/world-management/multiverse/_images/\344\270\255\346\226\207\344\270\226\347\225\214\345\220\215\344\271\261\347\240\201.png" similarity index 100% rename from "docs-java/process/plugin/WorldManagement/Multiverse/_images/\344\270\255\346\226\207\344\270\226\347\225\214\345\220\215\344\271\261\347\240\201.png" rename to "docs-java/process/plugin/world-management/multiverse/_images/\344\270\255\346\226\207\344\270\226\347\225\214\345\220\215\344\271\261\347\240\201.png" diff --git a/docs-java/process/plugin/WorldManagement/Multiverse/Q&A_1.md b/docs-java/process/plugin/world-management/multiverse/faq1.md similarity index 83% rename from docs-java/process/plugin/WorldManagement/Multiverse/Q&A_1.md rename to docs-java/process/plugin/world-management/multiverse/faq1.md index 68c9a10f9..72fcb2194 100644 --- a/docs-java/process/plugin/WorldManagement/Multiverse/Q&A_1.md +++ b/docs-java/process/plugin/world-management/multiverse/faq1.md @@ -22,12 +22,12 @@ sidebar_label: 常见问题 1 所需插件： - Multiverse-Core -- [PlaceHolderAPI](../../Front-Plugin/PlaceHolderAPI/PlaceHolderAPI.md) -- [聊天插件](../../ManageTool/chat/chat.md) -- [TAB 和计分板插件](../../other/TAB&Scoreboard/Tab&Scoreboard.md) +- [PlaceHolderAPI](../../plugin-dependencies/placeholderapi/placeholderapi.md) +- [聊天插件](../../management-tool/chat/chat.md) +- [TAB 和计分板插件](../../misc/tab-scoreboard/tab-scoreboard.md) - 其他你想展示中文世界名的插件 -- v4：安装 [papi 的 Multiverse 扩展](../../Front-Plugin/PlaceHolderAPI/CommonUsage.md#multiverse) +- v4：安装 [papi 的 Multiverse 扩展](../../plugin-dependencies/placeholderapi/common-usage.md#multiverse) - v5：无需安装，插件自动挂钩 papi ## 设置别名 diff --git a/docs-java/process/plugin/WorldManagement/Multiverse/Q&A_2.md b/docs-java/process/plugin/world-management/multiverse/faq2.md similarity index 100% rename from docs-java/process/plugin/WorldManagement/Multiverse/Q&A_2.md rename to docs-java/process/plugin/world-management/multiverse/faq2.md diff --git a/docs-java/process/plugin/WorldManagement/Multiverse/Multiverse.md b/docs-java/process/plugin/world-management/multiverse/multiverse.md similarity index 63% rename from docs-java/process/plugin/WorldManagement/Multiverse/Multiverse.md rename to docs-java/process/plugin/world-management/multiverse/multiverse.md index 982730e00..47686ff9f 100644 --- a/docs-java/process/plugin/WorldManagement/Multiverse/Multiverse.md +++ b/docs-java/process/plugin/world-management/multiverse/multiverse.md @@ -8,31 +8,14 @@ sidebar_label: 多世界 - Multiverse ![](_images/multiverse2-long.png) - - Modrinth - - - Hangar - - - Bukkit - - - Spigot - - - - Release - - - Discord - - - Support us on Patreon - - - License - +[![Modrinth](https://cdn.jsdmirror.cn/npm/@intergrav/devins-badges@3/assets/cozy/available/modrinth_vector.svg)](https://modrinth.com/plugin/multiverse-core) +[![Hangar](https://cdn.jsdmirror.cn/npm/@intergrav/devins-badges@3/assets/cozy/available/hangar_vector.svg)](https://hangar.papermc.io/Multiverse/Multiverse-Core) +[![Bukkit](https://cdn.jsdmirror.cn/npm/@intergrav/devins-badges@3/assets/cozy/supported/bukkit_vector.svg)](https://dev.bukkit.org/projects/multiverse-core) +[![Spigot](https://cdn.jsdmirror.cn/npm/@intergrav/devins-badges@3/assets/cozy/supported/spigot_vector.svg)](https://www.spigotmc.org/resources/multiverse-core.390) +[![Release](https://img.shields.io/github/v/release/Multiverse/Multiverse-Core)](https://github.com/DecentSoftware-eu/DecentHolograms/releases) +[![Discord](https://img.shields.io/discord/325459248047980545?label=discord&logo=discord)](https://discord.gg/NZtfKky) +[![Support us on Patreon](https://img.shields.io/badge/donate-patreon-white?logo=patreon)](https://patreon.com/dumptruckman) +[![License](https://img.shields.io/github/license/Multiverse/Multiverse-Core?color=blue)](https://github.com/Multiverse/Multiverse-Core/blob/main/LICENSE.md) > 知名老牌多世界插件。可以新建，删除，导入世界（维度）等。 @@ -95,8 +78,7 @@ world-name-format: ## Folia -[Multiverse-Core_Zeta](https://github.com/RenYuan-MC/Multiverse-Core_Zeta) 是 Multiverse-Core 的一个 fork，支持 Folia -,你可以[在这](https://dl.8aka.org/plugins/multiverse-core-4.3.14-zeta_folia-experimental.jar) 下载预编译版本，或自行编译 +[Multiverse-Core_Zeta](https://github.com/RenYuan-MC/Multiverse-Core_Zeta) 是 Multiverse-Core 的一个 fork，支持 Folia，你可以 [在这](https://dl.8aka.org/plugins/multiverse-core-4.3.14-zeta_folia-experimental.jar) 下载预编译版本，或自行编译 ## 崩服漏洞 diff --git a/docs-java/process/plugin/WorldManagement/MyWorld.md b/docs-java/process/plugin/world-management/myworld.md similarity index 97% rename from docs-java/process/plugin/WorldManagement/MyWorld.md rename to docs-java/process/plugin/world-management/myworld.md index 3c7f7df24..e249f4bba 100644 --- a/docs-java/process/plugin/WorldManagement/MyWorld.md +++ b/docs-java/process/plugin/world-management/myworld.md @@ -11,7 +11,7 @@ sidebar_label: 多世界 - MyWorld - 加载、卸载、复制、删除、保存和创建世界（[点击查看命令列表](https://wiki.traincarts.net/p/MyWorlds/Commands)） - 显示世界的信息并列出所有的世界和可用的区块等信息 -- 设置世界游戏模式，难度，时间，天气，自动保存，是否开启PvP等等 +- 设置世界游戏模式，难度，时间，天气，自动保存，是否开启 PvP 等等 - 设置世界生物生成限制 - 清空世界时清除玩家 - 在一定程度上修复受损的世界 diff --git a/docs-java/process/plugin/WorldManagement/NoBuildPlus.md b/docs-java/process/plugin/world-management/nobuildplus.md similarity index 100% rename from docs-java/process/plugin/WorldManagement/NoBuildPlus.md rename to docs-java/process/plugin/world-management/nobuildplus.md diff --git a/docs-java/process/plugin/WorldManagement/Worldmanagement.md b/docs-java/process/plugin/world-management/world-management.md similarity index 100% rename from docs-java/process/plugin/WorldManagement/Worldmanagement.md rename to docs-java/process/plugin/world-management/world-management.md diff --git a/docs-java/process/plugin/WorldManagement/WorldEdit.md b/docs-java/process/plugin/world-management/worldedit.md similarity index 70% rename from docs-java/process/plugin/WorldManagement/WorldEdit.md rename to docs-java/process/plugin/world-management/worldedit.md index 4f383db78..175cf560d 100644 --- a/docs-java/process/plugin/WorldManagement/WorldEdit.md +++ b/docs-java/process/plugin/world-management/worldedit.md @@ -17,9 +17,9 @@ sidebar_label: 创世神 - WorldEdit `GitHub` https://github.com/EngineHub/WorldEdit -`文档(英文)` https://worldedit.enginehub.org/en/latest/index.html +`文档 (英文)` https://worldedit.enginehub.org/en/latest/index.html -`文档(中文)` https://continue-project.netlify.app/WorldEdit +`文档 (中文)` https://continue-project.netlify.app/WorldEdit `插件百科` https://mineplugin.org/WorldEdit @@ -27,4 +27,4 @@ sidebar_label: 创世神 - WorldEdit 这个你肯定多少听说过，没听过创世神总听过小木斧 -建议使用优化版本 [FastAsyncWorldEdit](./FastAsyncWorldEdit.md) +建议使用优化版本 [FastAsyncWorldEdit](./fastasyncworldedit.md) diff --git a/docs-java/process/plugin/WorldManagement/worldgen/_images/terra-1.png b/docs-java/process/plugin/world-management/worldgen/_images/terra-1.png similarity index 100% rename from docs-java/process/plugin/WorldManagement/worldgen/_images/terra-1.png rename to docs-java/process/plugin/world-management/worldgen/_images/terra-1.png diff --git a/docs-java/process/plugin/WorldManagement/worldgen/_images/terra-2.png b/docs-java/process/plugin/world-management/worldgen/_images/terra-2.png similarity index 100% rename from docs-java/process/plugin/WorldManagement/worldgen/_images/terra-2.png rename to docs-java/process/plugin/world-management/worldgen/_images/terra-2.png diff --git a/docs-java/process/plugin/WorldManagement/worldgen/_images/terra-3.png b/docs-java/process/plugin/world-management/worldgen/_images/terra-3.png similarity index 100% rename from docs-java/process/plugin/WorldManagement/worldgen/_images/terra-3.png rename to docs-java/process/plugin/world-management/worldgen/_images/terra-3.png diff --git a/docs-java/process/plugin/WorldManagement/worldgen/_images/terra-4.png b/docs-java/process/plugin/world-management/worldgen/_images/terra-4.png similarity index 100% rename from docs-java/process/plugin/WorldManagement/worldgen/_images/terra-4.png rename to docs-java/process/plugin/world-management/worldgen/_images/terra-4.png diff --git a/docs-java/process/plugin/WorldManagement/worldgen/_images/terra-5.png b/docs-java/process/plugin/world-management/worldgen/_images/terra-5.png similarity index 100% rename from docs-java/process/plugin/WorldManagement/worldgen/_images/terra-5.png rename to docs-java/process/plugin/world-management/worldgen/_images/terra-5.png diff --git a/docs-java/process/plugin/WorldManagement/worldgen/_images/terra-community-1.png b/docs-java/process/plugin/world-management/worldgen/_images/terra-community-1.png similarity index 100% rename from docs-java/process/plugin/WorldManagement/worldgen/_images/terra-community-1.png rename to docs-java/process/plugin/world-management/worldgen/_images/terra-community-1.png diff --git a/docs-java/process/plugin/WorldManagement/worldgen/_images/terra-community-2.png b/docs-java/process/plugin/world-management/worldgen/_images/terra-community-2.png similarity index 100% rename from docs-java/process/plugin/WorldManagement/worldgen/_images/terra-community-2.png rename to docs-java/process/plugin/world-management/worldgen/_images/terra-community-2.png diff --git a/docs-java/process/plugin/WorldManagement/worldgen/_images/terra-community-3.png b/docs-java/process/plugin/world-management/worldgen/_images/terra-community-3.png similarity index 100% rename from docs-java/process/plugin/WorldManagement/worldgen/_images/terra-community-3.png rename to docs-java/process/plugin/world-management/worldgen/_images/terra-community-3.png diff --git a/docs-java/process/plugin/WorldManagement/worldgen/_images/terra-community-4.png b/docs-java/process/plugin/world-management/worldgen/_images/terra-community-4.png similarity index 100% rename from docs-java/process/plugin/WorldManagement/worldgen/_images/terra-community-4.png rename to docs-java/process/plugin/world-management/worldgen/_images/terra-community-4.png diff --git a/docs-java/process/plugin/WorldManagement/worldgen/_images/terra-community-5.png b/docs-java/process/plugin/world-management/worldgen/_images/terra-community-5.png similarity index 100% rename from docs-java/process/plugin/WorldManagement/worldgen/_images/terra-community-5.png rename to docs-java/process/plugin/world-management/worldgen/_images/terra-community-5.png diff --git a/docs-java/process/plugin/WorldManagement/worldgen/_images/terra-community-6.png b/docs-java/process/plugin/world-management/worldgen/_images/terra-community-6.png similarity index 100% rename from docs-java/process/plugin/WorldManagement/worldgen/_images/terra-community-6.png rename to docs-java/process/plugin/world-management/worldgen/_images/terra-community-6.png diff --git a/docs-java/process/plugin/WorldManagement/worldgen/_images/terra-community-7.png b/docs-java/process/plugin/world-management/worldgen/_images/terra-community-7.png similarity index 100% rename from docs-java/process/plugin/WorldManagement/worldgen/_images/terra-community-7.png rename to docs-java/process/plugin/world-management/worldgen/_images/terra-community-7.png diff --git a/docs-java/process/plugin/WorldManagement/worldgen/IrisWorldGen.md b/docs-java/process/plugin/world-management/worldgen/irisworldgen.md similarity index 97% rename from docs-java/process/plugin/WorldManagement/worldgen/IrisWorldGen.md rename to docs-java/process/plugin/world-management/worldgen/irisworldgen.md index 06704550a..97e0196bf 100644 --- a/docs-java/process/plugin/WorldManagement/worldgen/IrisWorldGen.md +++ b/docs-java/process/plugin/world-management/worldgen/irisworldgen.md @@ -163,9 +163,9 @@ Iris 支持自定义维度包开发，你可以创建自己的： `SpigotMC` https://www.spigotmc.org/resources/.84586 -`官方文档(新)` https://docs.volmit.com/en/doc/iris +`官方文档 (新)` https://docs.volmit.com/en/doc/iris -`官方文档(旧)` https://old.docs.volmit.com/iris +`官方文档 (旧)` https://old.docs.volmit.com/iris ::: diff --git a/docs-java/process/plugin/WorldManagement/worldgen/Terra.md b/docs-java/process/plugin/world-management/worldgen/terra.md similarity index 94% rename from docs-java/process/plugin/WorldManagement/worldgen/Terra.md rename to docs-java/process/plugin/world-management/worldgen/terra.md index 1dc0b7e15..da3ac4764 100644 --- a/docs-java/process/plugin/WorldManagement/worldgen/Terra.md +++ b/docs-java/process/plugin/world-management/worldgen/terra.md @@ -47,7 +47,7 @@ sidebar_position: 1 `GitHub` https://github.com/PolyhedralDev/Terra -`文档(英文)` https://terra.polydev.org/install/index.html +`文档 (英文)` https://terra.polydev.org/install/index.html `插件百科` https://mineplugin.org/Terra diff --git a/docs-java/process/plugin/WorldManagement/worldgen/TerraformGenerator.md b/docs-java/process/plugin/world-management/worldgen/terraformgenerator.md similarity index 100% rename from docs-java/process/plugin/WorldManagement/worldgen/TerraformGenerator.md rename to docs-java/process/plugin/world-management/worldgen/terraformgenerator.md diff --git a/docs-java/process/plugin/WorldManagement/worldgen/worldgen.md b/docs-java/process/plugin/world-management/worldgen/worldgen.md similarity index 100% rename from docs-java/process/plugin/WorldManagement/worldgen/worldgen.md rename to docs-java/process/plugin/world-management/worldgen/worldgen.md diff --git a/docs-java/process/plugin/WorldManagement/WorldGuard.md b/docs-java/process/plugin/world-management/worldguard.md similarity index 89% rename from docs-java/process/plugin/WorldManagement/WorldGuard.md rename to docs-java/process/plugin/world-management/worldguard.md index 376fb46ac..30e72b215 100644 --- a/docs-java/process/plugin/WorldManagement/WorldGuard.md +++ b/docs-java/process/plugin/world-management/worldguard.md @@ -38,9 +38,9 @@ WorldGuard 可以保护你的区域或世界，使他们免受破坏，或者调 `GitHub` https://github.com/EngineHub/WorldGuard -`文档(英文)` https://worldguard.enginehub.org/en/latest/index.html +`文档 (英文)` https://worldguard.enginehub.org/en/latest/index.html -`文档(中文)` https://continue-project.netlify.app/WorldGuard +`文档 (中文)` https://continue-project.netlify.app/WorldGuard `插件百科` https://mineplugin.org/Worldguard @@ -52,7 +52,7 @@ WorldGuard 可以保护你的区域或世界，使他们免受破坏，或者调 ## 前置 -[WorldEdit](./WorldEdit.md) 或 [FastAsyncWorldEdit](./FastAsyncWorldEdit.md) +[WorldEdit](./worldedit.md) 或 [FastAsyncWorldEdit](./fastasyncworldedit.md) ## Bstats diff --git a/docs-java/process/redstone/mchprs.md b/docs-java/process/redstone/mchprs.md index 0475b8b14..6c798142c 100644 --- a/docs-java/process/redstone/mchprs.md +++ b/docs-java/process/redstone/mchprs.md @@ -19,7 +19,7 @@ MCHPRS 破坏了很多基于生物/传送装置的红石机器，因此 MCHPRS MCHPRS 的构建需要 Rust 和 Cargo，具体安装教程请自行上网搜索 -```shell +```bash git clone https://github.com/MCHPR/MCHPRS.git cd MCHPRS cargo build --release @@ -29,7 +29,7 @@ cargo build --release 如果你希望基于你的 CPU 进一步优化 (但兼容性会下降),你可以使用这个指令构建： -```shell +```bash RUSTFLAGS="-C target-cpu=native" cargo build --release ``` @@ -43,11 +43,11 @@ RUSTFLAGS="-C target-cpu=native" cargo build --release | ----------------- | ----------------------------------------------------------------------------------------------------------------- | ------------------------------ | | `bind_address` | 绑定地址与端口 | `0.0.0.0:25565` | | `motd` | MOTD | `"Minecraft 高性能红石服务器"` | -| `chat_format` | 聊天消息格式化方式（使用花括号插入`username`和`message`变量） | `<{username}> {message}` | +| `chat_format` | 聊天消息格式化方式（使用花括号插入 `username` 和 `message` 变量） | `<{username}> {message}` | | `max_players` | 最大同时在线玩家数 | `99999` | | `view_distance` | 视距 | `8` | -| `whitelist` | 是否启用白名单（读取`whitelist.json`文件） | `false` | -| `schemati` | 模拟 Open Redstone Engineers 的[Schemati 插件](https://github.com/OpenRedstoneEngineers/Schemati)的验证与目录结构 | `false` | +| `whitelist` | 是否启用白名单（读取 `whitelist.json` 文件） | `false` | +| `schemati` | 模拟 Open Redstone Engineers 的 [Schemati 插件](https://github.com/OpenRedstoneEngineers/Schemati) 的验证与目录结构 | `false` | | `block_in_hitbox` | 允许在玩家碰撞箱内放置方块（简化碰撞检测逻辑） | `true` | | `auto_redpiler` | 自动使用红石编译器 | `false` | diff --git a/docs-java/process/redstone/mod.md b/docs-java/process/redstone/mod.md index 06740d22c..ce47235de 100644 --- a/docs-java/process/redstone/mod.md +++ b/docs-java/process/redstone/mod.md @@ -1,28 +1,28 @@ --- sidebar_position: 3 -title: MOD +title: Mod --- ## Carpet Carpet 是一个适用于原版 Minecraft 的 Mod，它可以开关一些特性，也有服务器假人的功能，并且有游戏监视器的功能。~~（可以说许多插件端的特性修复基本上都来自于它）~~ -使用/carpet 命令可以直接在游戏里开关它的功能，这些功能都可以在[官方中文 Wiki](https://github.com/HeartyYF/fabric-carpet-Wiki-CN/wiki/Current-Available-Settings)里面找到 +使用 `/carpet` 命令可以直接在游戏里开关它的功能，这些功能都可以在 [官方中文 Wiki](https://github.com/HeartyYF/fabric-carpet-Wiki-CN/wiki/Current-Available-Settings) 里面找到 -carpet 还有许多扩展，你可以在下表里下载它们 +Carpet 还有许多扩展，你可以在下表里下载它们 | 名字 | 下载链接 | | ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| Carpet Extra | [Modrinth](https://modrinth.com/mod/carpet-extra) [Curseforge](https://www.curseforge.com/minecraft/mc-mods/carpet-extra) [Github](https://github.com/gnembon/carpet-extra/releases) | -| Carpet TIS Addition | [Modrinth](https://modrinth.com/mod/carpet-tis-addition) [Curseforge](http://curseforge.com/minecraft/mc-mods/carpet-tis-addition) [Github](https://github.com/TISUnion/Carpet-TIS-Addition/releases) | -| Carpet Org Addition | [Modrinth](https://modrinth.com/mod/carpet-org-addition) [Github](https://github.com/fcsailboat/Carpet-Org-Addition/releases) | -| GugleCarpetAddition | [Modrinth](https://modrinth.com/mod/gca) [Curseforge](https://www.curseforge.com/minecraft/mc-mods/guglecarpetaddition) [Github](https://github.com/Gu-ZT/gugle-carpet-addition) | +| Carpet Extra | [Modrinth](https://modrinth.com/mod/carpet-extra) [CurseForge](https://www.curseforge.com/minecraft/mc-mods/carpet-extra) [GitHub](https://github.com/gnembon/carpet-extra/releases) | +| Carpet TIS Addition | [Modrinth](https://modrinth.com/mod/carpet-tis-addition) [CurseForge](http://curseforge.com/minecraft/mc-mods/carpet-tis-addition) [GitHub](https://github.com/TISUnion/Carpet-TIS-Addition/releases) | +| Carpet Org Addition | [Modrinth](https://modrinth.com/mod/carpet-org-addition) [GitHub](https://github.com/fcsailboat/Carpet-Org-Addition/releases) | +| GugleCarpetAddition | [Modrinth](https://modrinth.com/mod/gca) [CurseForge](https://www.curseforge.com/minecraft/mc-mods/guglecarpetaddition) [GitHub](https://github.com/Gu-ZT/gugle-carpet-addition) | -这些拓展的规则和命令基本上都在 Github 里（都有中文） +这些拓展的规则和命令基本上都在 GitHub 里（都有中文） -## 其他 MOD +## 其他 Mod -其他 MOD 基本上都是对生电作用没那么大，所以在下面简单介绍一下 +其他 mod 基本上都是对生电作用没那么大，所以在下面简单介绍一下 AppleSkin（正常在客户端显示饱和度和消耗度） @@ -40,4 +40,4 @@ BBOR（服务器支持才能正常显示结构信息，要不然就只能客户 Syncmatica（服务器安装客户端才能正常使用） -Fuji（像 CMI 一样的多功能 MOD） +Fuji（像 CMI 一样的多功能 mod） diff --git a/docs-java/process/redstone/plugin.md b/docs-java/process/redstone/plugin.md index d8fba4eda..49b4eafec 100644 --- a/docs-java/process/redstone/plugin.md +++ b/docs-java/process/redstone/plugin.md @@ -12,7 +12,7 @@ sidebar_label: 插件端 `遗憾的是，目前在 Paper 中无法获得 100% 的原版体验。` -但插件端广阔的插件生态以及较好的优化也是一些人在**轻度生电**的情况下使用插件端的原因。这篇文档会通过调整服务端配置尽可能在插件端还原原版特性 +但插件端广阔的插件生态以及较好的优化也是一些人在 **轻度生电** 的情况下使用插件端的原因。这篇文档会通过调整服务端配置尽可能在插件端还原原版特性 ## Paper @@ -86,7 +86,7 @@ unsupported-settings: update-equipment-on-player-actions: false # 是否在玩家执行某些动作时更新装备；为 false 时可利用属性切换漏洞 ``` -:::warning `book` 配置 +:::warning[book 配置] 该选项可能会在你的服务器上启用禁人书，开启时请认真考虑 @@ -139,15 +139,15 @@ settings: ### 红石优化 -请查看 [红石优化](/Java/process/maintenance/optimize/go#redstone-implementation) +请查看 [红石优化](../maintenance/optimize/go.mdx#redstone-implementation) -同时 Mojang 在 24w33a 更新了红石的链接机制 (虽然是实验性内容),从代码来看，Mojang 的优化方式与 Alternate Current 非常像 +同时 Mojang 在 24w33a 更新了红石的链接机制 (虽然是实验性内容)，从代码来看，Mojang 的优化方式与 Alternate Current 非常像 可以考虑在服务器中开启 ## Purpur -Purpur 可以还原比 Paper 多的特性 (虽然也就多了两个),但可以获得来自 Pufferfish 的生物优化 +Purpur 可以还原比 Paper 多的特性 (虽然也就多了两个)，但可以获得来自 Pufferfish 的生物优化 ```yaml allow-void-trading: true # 允许虚空交易 @@ -159,7 +159,7 @@ shared-random: true # 允许 RNG 预测 Leaves 是一个专注于生电玩家的 Minecraft 服务端，也是还原原版特性最完全的插件端 -Leaves 会覆盖 Paper 的一些配置，所以不必再去手动更改 paper 的配置文件，只需要关注`leaves.yml` +Leaves 会覆盖 Paper 的一些配置，所以不必再去手动更改 Paper 的配置文件，只需要关注 `leaves.yml` ```yaml # leaves.yml @@ -177,7 +177,7 @@ settings: old-hopper-suck-in-behavior: true # 恢复旧版漏斗吸物行为 fix-fortress-mob-spawn: true # 修复下界堡垒刷怪生成机制 skip-height-check: true # 跳过怪物生成高度限制检查 - string-tripwire-hook-duplicate: true # 修复绊线钩重复连接的 BUG + string-tripwire-hook-duplicate: true # 修复绊线钩重复连接的 bug budding-amethyst-can-push-by-piston: true # 允许活塞推动紫水晶母岩 stackable-shulker-boxes: true # 允许潜影盒堆叠 no-block-update-command: true # 禁用 /blockupdate 命令 @@ -190,7 +190,7 @@ settings: vanilla-hopper: true # 修复原版漏斗的已知问题 ``` -:::warning 漏斗问题 +:::warning[漏斗问题] `vanilla-hopper` 选项开启后会严重降低漏斗性能，非必要最好别开 @@ -208,7 +208,7 @@ Leaf 是一个 Paper 的分支，拥有非常高的性能 (基本是 Paper 系 Luminol 是 Folia 的一个分支，相比于 Folia 有这更好的性能，同时可以还原更多的特性 -:::tip Folia 生电 +:::tip[Folia 生电] Folia 是 Paper 的分支，也就是说 Paper 玩不了的机器 Folia 照样玩不了 diff --git a/docs-java/process/redstone/redstone.md b/docs-java/process/redstone/redstone.md index 03fbbc010..740ad8c9c 100644 --- a/docs-java/process/redstone/redstone.md +++ b/docs-java/process/redstone/redstone.md @@ -7,7 +7,7 @@ title: 生电 生电是 Minecraft 服务器中重要的一环，同时也是吸引玩家的一个重要手段 -这篇文档不是教你如何制作红石机器，而是教你如何在服务端中**还原原版特性**,以及一些专门用于红石的服务端 +这篇文档不是教你如何制作红石机器，而是教你如何在服务端中 **还原原版特性**,以及一些专门用于红石的服务端 ## 「生电」的概念 diff --git "a/docs-java/start/_images/cmd\350\267\257\345\276\204.png" "b/docs-java/start/_images/cmd\350\267\257\345\276\204.png" deleted file mode 100644 index be9141a7d..000000000 Binary files "a/docs-java/start/_images/cmd\350\267\257\345\276\204.png" and /dev/null differ diff --git a/docs-java/start/basic/relationship-between-servers.md b/docs-java/start/basic/relationship-between-servers.md index a830188a1..e6c5b2374 100644 --- a/docs-java/start/basic/relationship-between-servers.md +++ b/docs-java/start/basic/relationship-between-servers.md @@ -39,17 +39,17 @@ Purpur - 是基于 Purfferfish 的一个专注功能性和性能的 Fork； Leaf - 是基于 Purfferfish，Purpur，Gale 等的专注于性能的 Fork。 -## MOD 端 +## Mod 端 -Fabric 和 Forge 作为 Minecraft 中最常用的两个模组加载器，即使有些 Mod 声明他们可用于 Fabric 和 Forge 服务器， +Fabric 和 Forge 作为 Minecraft 中最常用的两个模组加载器，即使有些 mod 声明他们可用于 Fabric 和 Forge 服务器， -一般来说这些 Mod 也会被发布为多个 `.jar` 文件，他们之间通常来说是互不兼容的。 +一般来说这些 mod 也会被发布为多个 `.jar` 文件，他们之间通常来说是互不兼容的。 -所以不要傻傻的把标明给 Forge 的 Mod 加入 Fabric 的服务端，以免出现无法加载。 +所以不要傻傻的把标明给 Forge 的 mod 加入 Fabric 的服务端，以免出现无法加载。 ## Forge / NeoForge -Forge 是较早版本出现的模组加载器，设计上有一些历史包袱导致，有大量的知名 Mod 基于 Forge 开。 +Forge 是较早版本出现的模组加载器，设计上有一些历史包袱导致，有大量的知名 mod 基于 Forge 开。 NeoForge 是 Forge 的 Fork。这个分支是因为原 Forge 团队由于常年不合重新组建了新的团队， @@ -59,9 +59,9 @@ NeoForge 是 Forge 的 Fork。这个分支是因为原 Forge 团队由于常年 ## Fabric -Fabric 是相对新的，在设计上 Fabric 相对更轻量、高效。性能一般会更好，玩法 Mod 目前相对 Forge 更少。 +Fabric 是相对新的，在设计上 Fabric 相对更轻量、高效。性能一般会更好，玩法 mod 目前相对 Forge 更少。 -Fabric 拥有大量的优化效果较好的 Mod，较为出名的有元素周期表钠等。 +Fabric 拥有大量的优化效果较好的 mod，较为出名的有元素周期表钠等。 ## 混合端 @@ -69,4 +69,4 @@ Fabric 拥有大量的优化效果较好的 Mod，较为出名的有元素周期 Bukkit + Forge = Catserver -Paper(部分) + Forge = Mohist +Paper (部分) + Forge = Mohist diff --git a/docs-java/start/basic/server-file-structure.md b/docs-java/start/basic/server-dir-structure.md similarity index 94% rename from docs-java/start/basic/server-file-structure.md rename to docs-java/start/basic/server-dir-structure.md index 65c5b5aaa..4d568766f 100644 --- a/docs-java/start/basic/server-file-structure.md +++ b/docs-java/start/basic/server-dir-structure.md @@ -7,6 +7,7 @@ sidebar_position: 3 我们先来简单看一眼 插件端 的文件夹结构 (以 Purpur 为例)： + ```c ├─assets // 储存 Minecraft 音效贴图等重要文件，不要乱动 ├─cache // 缓存文件夹，一般放置 Minecraft 原版服务器 @@ -56,11 +57,11 @@ sidebar_position: 3 - `banned-ips.json` -以 json 格式存放的被 ban IP 玩家的 UUID 及游戏名称等相关信息，一旦玩家被 banip，此 IP 将无法再进入服务器。 +以 JSON 格式存放的被 ban IP 玩家的 UUID 及游戏名称等相关信息，一旦玩家被 banip，此 IP 将无法再进入服务器。 - `banned-players.json` -以 json 格式存放了被 ban 玩家的 UUID 及游戏名称等相关信息，离线服 ban 玩家后换 ID 即可进入服务器，而正版服无法通过改名重新进入服务器。 +以 JSON 格式存放了被 ban 玩家的 UUID 及游戏名称等相关信息，离线服 ban 玩家后换 ID 即可进入服务器，而正版服无法通过改名重新进入服务器。 - `bukkit.yml` @@ -80,7 +81,7 @@ sidebar_position: 3 - `ops.json` -以 json 格式存放了 OP 玩家的 UUID 及游戏名称等相关信息。 +以 JSON 格式存放了 OP 玩家的 UUID 及游戏名称等相关信息。 - `purpur.jar` diff --git a/docs-java/start/basic/what-is-datapack.md b/docs-java/start/basic/what-is-datapack.md index d94089da9..f976a646b 100644 --- a/docs-java/start/basic/what-is-datapack.md +++ b/docs-java/start/basic/what-is-datapack.md @@ -5,7 +5,7 @@ sidebar_position: 6 # 什么是数据包？ -数据包是从 Minecraft 逻辑结构层面修改我的世界，他可以添加或覆盖游戏中几乎一切的元素。一定程度下可以代替 Mod，但它并不会改变原版的内容。 +数据包是从 Minecraft 逻辑结构层面修改我的世界，他可以添加或覆盖游戏中几乎一切的元素。一定程度下可以代替 mod，但它并不会改变原版的内容。 其功能可用于覆盖或添加新的函数、进度、战利品表、物品修饰器、配方、结构、标签、维度、世界生成等 @@ -43,6 +43,7 @@ sidebar_position: 6 # 数据包结构 + ```c 数据包名 ├─pack.mcmeta // 用于识别数据包及存储数据包信息。 diff --git a/docs-java/start/basic/what-is-caton.md b/docs-java/start/basic/what-is-lag.md similarity index 55% rename from docs-java/start/basic/what-is-caton.md rename to docs-java/start/basic/what-is-lag.md index 470864442..c9048b319 100644 --- a/docs-java/start/basic/what-is-caton.md +++ b/docs-java/start/basic/what-is-lag.md @@ -5,4 +5,4 @@ sidebar_position: 2 # 什么是卡顿？ -请见 [通用 | 什么是卡顿](/start/basic/what-is-caton) +请见 [通用 | 什么是卡顿](/start/basic/what-is-lag) diff --git a/docs-java/start/basic/what-is-mod.md b/docs-java/start/basic/what-is-mod.md index 4d9c50af1..29ddd85fe 100644 --- a/docs-java/start/basic/what-is-mod.md +++ b/docs-java/start/basic/what-is-mod.md @@ -5,11 +5,11 @@ sidebar_position: 5 # 什么是模组？ -模组 ( 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 干了什么， 进而删减或修改内容以实现新的功能。删减或修改内容既可以是服务端，也可以是客户端。因而相较插件只能修改部分服务端的内容要有更大的功能性。 @@ -20,8 +20,8 @@ Minecraft 模组 ( Mod ) 一般来说模组会利用 Forge 或 Fabric 作为前 ## 模组的优点 - 可以更为随心所欲的修改包括客户端和服务端的游戏代码，功能性更多； -- 大多数大型 Mod 是有相对详细的 Wiki 供玩家参考，更方便入手； -- 可以控制客户端使用的 Mod 降低客户端使用作弊端的可能性； +- 大多数大型 mod 是有相对详细的 Wiki 供玩家参考，更方便入手； +- 可以控制客户端使用的 mod 降低客户端使用作弊端的可能性； ## 模组的缺点 diff --git a/docs-java/start/basic/what-is-world.md b/docs-java/start/basic/what-is-world.md index ba847acee..4095ae338 100644 --- a/docs-java/start/basic/what-is-world.md +++ b/docs-java/start/basic/what-is-world.md @@ -7,7 +7,7 @@ sidebar_position: 7 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**)。 @@ -17,7 +17,7 @@ Minecraft 原版目前有三个世界，分别是主世界 **world**(world)， 1. **advancements/** ：储存玩家的成就，每个玩家对应一个 **UUID** ； -2. **data/** ：**idcounts.dat**和**map_xxx.dat** 储存的是玩家合成的地图有关的数据。 +2. **data/** ：**idcounts.dat** 和 **map_xxx.dat** 储存的是玩家合成的地图有关的数据。 3. **datapacks/** ：储存世界所使用的数据包 (一般 Bukkit 系服务器有一个 Bukkit 文件夹)； diff --git a/docs-java/start/config-server.md b/docs-java/start/config-server.md index 96836fe09..4059e8d29 100644 --- a/docs-java/start/config-server.md +++ b/docs-java/start/config-server.md @@ -26,7 +26,7 @@ sidebar_position: 5 ## server.proprites -这一小节配置文件都位于服务端根目录下的`server.proprites`文件。如需修改，请打开该文件并找到对应选项 +这一小节配置文件都位于服务端根目录下的 `server.proprites` 文件。如需修改，请打开该文件并找到对应选项 ### 正版验证 @@ -44,11 +44,11 @@ online-mode=true **不要在服务器投入运营后去改正版验证状态！** 这会造成 UUID 混乱，玩家数据丢失，当然你可以转换 UUID 来解决这个问题 [查看解决方法](https://klpbbs.com/thread-131458-1-1.html) -如果需要更多的验证方式 (如 **皮肤站**/**统一认证** 等)，请在服务器 **公测前** 确定，具体请参考[更多验证方式](../advance/loginchoices.md) +如果需要更多的验证方式 (如 **皮肤站**/**统一认证** 等)，请在服务器 **公测前** 确定，具体请参考 [更多验证方式](../advance/login-choices.md) ::: -注意，在离线模式下，玩家大概率没皮肤，你需要 [SkinsRestorer](../process/plugin/other/SkinsRestorer.md)，根据需求选择 SkinsRestorer 的版本。 +注意，在离线模式下，玩家大概率没皮肤，你需要 [SkinsRestorer](../process/plugin/misc/skinsrestorer.md)，根据需求选择 SkinsRestorer 的版本。 ### 最大玩家数 @@ -65,9 +65,10 @@ level-seed= ``` 这里面就可以填上你想要的种子，不填表示随机种子 + :::note -在服务器生成地图后修改种子是**无效的** +在服务器生成地图后修改种子是 **无效的** 因此，请确保修改种子时，地图未生成 @@ -120,11 +121,11 @@ spawn-protection=16 :::warning -强烈**建议禁用**这一配置，无论你是否需要出生点保护。 +强烈 **建议禁用** 这一配置，无论你是否需要出生点保护。 -这一配置的保护**并不能**防御苦力怕、TNT 等造成的破坏。 +这一配置的保护 **并不能** 防御苦力怕、TNT 等造成的破坏。 -如有保护出生点的需求，可以考虑使用插件 [WorldGuard](../process/plugin/WorldManagement/WorldGuard.md) +如有保护出生点的需求，可以考虑使用插件 [WorldGuard](../process/plugin/world-management/worldguard.md) ::: @@ -203,7 +204,7 @@ allow-flight=true :::tip -请注意，默认情况下 `/gamerule` 所设置的游戏规则**只会**在执行命令的世界生效 +请注意，默认情况下 `/gamerule` 所设置的游戏规则 **只会** 在执行命令的世界生效 [Ultimate Gamerules Manager](https://www.spigotmc.org/resources/ultimate-gamerules-manager-1-13-1-20-3.102215/) 是个不错的插件，适合新手管理 gamerule 时使用 diff --git a/docs-java/start/connect-to-server.md b/docs-java/start/connect-to-server.md index 678f837a9..be01bc9c1 100644 --- a/docs-java/start/connect-to-server.md +++ b/docs-java/start/connect-to-server.md @@ -49,7 +49,7 @@ server-port=25565 :::warning -这里要使用英文的 `:` **不能使用中文**的 `：` ！ +这里要使用英文的 `:` **不能使用中文** 的 `：` ！ ::: @@ -61,7 +61,7 @@ server-port=25565 假设我现在的公网 IP 是 `114.51.14.191`，那么我的连接应该是输入 `114.51.14.191:25565`， -注意冒号后面的**端口号**应该和你设置的 **`server-port`** 一模一样，不然玩家无法连接 +注意冒号后面的 **端口号** 应该和你设置的 **`server-port`** 一模一样，不然玩家无法连接 比如我现在把 **`server-port`** 改成了 **`9180`**，应该这么进入服务器 `114.51.14.191:9180` @@ -105,7 +105,7 @@ server-port=25565 2.检查网络状况 (可以试试 ping 服务器，超时就是网的问题) -3.如果使用 FRP ,检查 frp 的配置文件是否正确 +3.如果使用 frp ,检查 frp 的配置文件是否正确 ### `Invalid characters in username/ 用户名包含无效字符` @@ -151,7 +151,7 @@ server-port=25565 1. 服务器未启动或已崩溃，检查服务器控制台是否正常运行 2. 确认服务器 IP 和端口填写正确（默认端口为 `25565`） -3. 若使用内网穿透（如 FRP/Ngrok），检查穿透服务是否配置正确 +3. 若使用内网穿透（如 frp/Ngrok），检查穿透服务是否配置正确 ### `Internal Exception: java.io.IOException: 远程主机强迫关闭了一个现有的连接` diff --git a/docs-java/start/install-server.md b/docs-java/start/install-server.md index 4b3895b92..db9eaf460 100644 --- a/docs-java/start/install-server.md +++ b/docs-java/start/install-server.md @@ -7,11 +7,11 @@ sidebar_position: 3 :::tip -该教程是为**纯 Mod 服**所编写的，如果你正在使用插件或混合端，那么就不需要安装服务端这一步，直接前往下一篇教程 [开启服务端](launch-server.md) +该教程是为 **纯 mod 服** 所编写的，如果你正在使用插件或混合端，那么就不需要安装服务端这一步，直接前往下一篇教程 [开启服务端](launch-server.md) ::: -全篇以 1.20.4 Mod 服务端安装为例子，如果看不懂可以使用[笨蛋脚本](https://script.8aka.org/mod-installer) **(目前支持 +全篇以 1.20.4 mod 服务端安装为例子，如果看不懂可以使用 [笨蛋脚本](https://script.8aka.org/mod-installer) **(目前支持 Forge/NeoForge/Fabric)** import Tabs from '@theme/Tabs'; @@ -31,7 +31,7 @@ import TabItem from '@theme/TabItem'; ![](_images/install/2.png) -请选择 `Installer` ，左边右边都无所谓，打开后，你会来到一个广告窗口，点击最上面的 `SKIP`(没有出现就等一会，如果网站始终无法正常加载，请换用上文提到的国内下载镜像 **MCSL** ) +请选择 `Installer` ，左边右边都无所谓，打开后，你会来到一个广告窗口，点击最上面的 `SKIP` (没有出现就等一会，如果网站始终无法正常加载，请换用上文提到的国内下载镜像 **MCSL**) ![](_images/install/3.png) @@ -51,7 +51,7 @@ import TabItem from '@theme/TabItem'; ![](_images/install/4.png) -### 从 MOJANG 官方下载 +### 从 Mojang 官方下载 首先前往对应版本的发行页面 @@ -73,20 +73,20 @@ import TabItem from '@theme/TabItem'; ## 执行安装 -接着打开 cmd，不会请查看[开启 cmd](launch-server.md#笨蛋脚本)，输入以下命令 +接着打开 cmd，不会请查看 [开启 cmd](launch-server.md#笨蛋脚本)，输入以下命令 -```shell +```bash java -jar <你下载的安装器的文件名> --installServer ``` -然后静待一会，直到控制台输出 `The server installed successfully` 就完成了！此时你应该会看到当前文件夹中出现了一个名为`forge-游戏版本号-forge版本号.jar`的文件，**这就是你此后开服时需要执行的可执行文件**。 +然后静待一会，直到控制台输出 `The server installed successfully` 就完成了！此时你应该会看到当前文件夹中出现了一个名为 `forge-游戏版本号-forge版本号.jar` 的文件，**这就是你此后开服时需要执行的可执行文件**。 -我们建议你现在将文件`forge-游戏版本号-forge版本号-installer.jar`（安装器文件）和`minecraft_server.游戏版本号.jar`移至其他文件夹或放入回收站，以防在后续准备开服时引发混淆。也不要直接永久删除这两个文件，因为一旦后续需要重新安装时就会用到它们。 +我们建议你现在将文件 `forge-游戏版本号-forge版本号-installer.jar`（安装器文件）和 `minecraft_server.游戏版本号.jar` 移至其他文件夹或放入回收站，以防在后续准备开服时引发混淆。也不要直接永久删除这两个文件，因为一旦后续需要重新安装时就会用到它们。 -与 Forge 差不多，官网换[NeoForge 官网](https://neoforged.net/) +与 Forge 差不多，官网换 [NeoForge 官网](https://neoforged.net/) @@ -119,31 +119,31 @@ java -jar <你下载的安装器的文件名> --installServer ## Fabric API -安装完服务端核心后还需要安装 Fabric API,[在这下载](https://modrinth.com/mod/fabric-api),下载完后放进 `mods` 文件夹即可 +安装完服务端核心后还需要安装 Fabric API，[在这下载](https://modrinth.com/mod/fabric-api)，下载完后放进 `mods` 文件夹即可 与 Fabric 差不多，官网换成这个 [QuiltMC](https://quiltmc.org/en/install/) -安装完后还需要安装 [Quilt Standard Library](https://modrinth.com/mod/qsl),下载完后放进 `mods` 文件夹即可 +安装完后还需要安装 [Quilt Standard Library](https://modrinth.com/mod/qsl)，下载完后放进 `mods` 文件夹即可 -适用于 Paper 的 Mod 框架 (**这不是混合端**),目前在用的主要有 CraftEngine +适用于 Paper 的 mod 框架 (**这不是混合端**)，目前在用的主要有 CraftEngine 首先前往 [GitHub](https://github.com/vectrix-space/ignite/releases) 下载 Ignite，放到服务端根目录 然后更改启动参数，比如： -```shell +```bash java -Xms2G -Xmx2G -jar 核心名.jar ``` 改为 -```shell +```bash java -Xms2G -Xmx2G -Dignite.locator=paper -Dignite.paper.jar=核心名.jar -jar ignite.jar ``` @@ -151,7 +151,7 @@ java -Xms2G -Xmx2G -Dignite.locator=paper -Dignite.paper.jar=核心名.jar -jar :::tip -安装的 Mod 仅限于支持 Ignite 的 Mod,Forge 和 Fabric 等的 mod 不可以加载 +安装的 mod 仅限于支持 Ignite 的 mod、Forge 和 Fabric 等的 mod 不可以加载 ::: diff --git a/docs-java/start/launch-server.md b/docs-java/start/launch-server.md index a09e27993..1b36c46e3 100644 --- a/docs-java/start/launch-server.md +++ b/docs-java/start/launch-server.md @@ -68,7 +68,7 @@ sidebar_position: 4 用你前面下的文本编辑器编辑这个文件，写入以下信息并保存，然后双击 `start.bat` -```shell title="start.bat" +```bash title="start.bat" java -Xms2G -Xmx2G -jar 核心名.jar --nogui ``` @@ -133,7 +133,7 @@ import TabItem from '@theme/TabItem'; @echo off :start java -Xmx4G -Xms1G -jar server.jar nogui -echo 服务器已关闭，5秒后重启... +echo 服务器已关闭，5 秒后重启... timeout /t 5 goto start ``` @@ -145,7 +145,7 @@ goto start #!/bin/bash while true; do java -Xmx4G -Xms1G -jar server.jar nogui - echo "服务器已关闭，5秒后重启..." + echo "服务器已关闭，5 秒后重启..." sleep 5 done ``` @@ -183,7 +183,7 @@ import GlobalContent from '@site/src/components/GlobalContent' -### 我不会在命令行界面 (CMD / 终端 / Powershell) 使用科学上网 +### 我不会在命令行界面 (CMD / 终端 / PowerShell) 使用科学上网 :::tip @@ -199,7 +199,7 @@ import GlobalContent from '@site/src/components/GlobalContent' 在命令行界面 (一般情况下，一个黑 / 蓝框框) 中执行这两条 -```shell +```bash set http_proxy=http://127.0.0.1:7890 set https_proxy=http://127.0.0.1:7890 ``` @@ -221,19 +221,19 @@ export HTTPS_PROXY=http://127.0.0.1:7890 ### 中文乱码 -如果你用的是 Windows，你需要在启动脚本**最前面**加上`chcp 65001` +如果你用的是 Windows，你需要在启动脚本 **最前面** 加上 `chcp 65001` 如上面的方法无效，检查你的系统区域设置是否为中国和中文语言包是否下载。 比如你原来的启动脚本长这样 -```shell +```bash java -Xms2G -Xmx2G -jar server.jar --nogui ``` 你需要改成这样 -```shell +```bash chcp 65001 java -Xms2G -Xmx2G -jar server.jar --nogui ``` @@ -260,13 +260,13 @@ java -Xms2G -Xmx2G -jar server.jar --nogui 内存大小设置长这样 -```shell +```text -Xms1024M -Xmx2048M ``` 不是这样！ -```shell +```text -Xms 1024M -Xmx 2048M ``` @@ -276,7 +276,7 @@ java -Xms2G -Xmx2G -jar server.jar --nogui 使用安装器安装后，你无法在根目录找到 `xxx.jar`，同时会生成一个 bat 脚本。里面大概是这样的 -```shell +```bash @echo off REM Forge requires a configured set of both JVM and program arguments. REM Add custom JVM arguments to the user_jvm_args.txt @@ -296,7 +296,7 @@ pause 此时你会发现有一个 `user_JVM_args.txt` 在你的根目录下，打开他，将原来的 -```shell +```bash java -Xms2G -Xmx2G -jar server.jar --nogui ``` @@ -306,6 +306,6 @@ java -Xms2G -Xmx2G -jar server.jar --nogui 就像这样 -```shell +```bash java @user_jvm_args.txt @libraries/net/minecraftforge/forge/1.18.2-40.1.60/win_args.txt nogui %* ``` diff --git a/docs-java/start/server-core-choose/_images/papermc.svg b/docs-java/start/server-core-choose/_images/papermc.svg deleted file mode 100644 index 6b44eda94..000000000 --- a/docs-java/start/server-core-choose/_images/papermc.svg +++ /dev/null @@ -1 +0,0 @@ - \ No newline at end of file diff --git a/docs-java/start/server-core-choose/folia/folia.md b/docs-java/start/server-core-choose/folia/folia.md index 4752d914e..49699cec0 100644 --- a/docs-java/start/server-core-choose/folia/folia.md +++ b/docs-java/start/server-core-choose/folia/folia.md @@ -42,7 +42,7 @@ Folia 完全破坏了 Bukkit 插件的兼容性，每个 Bukkit 插件都必须 Folia 这么好，但并不是每个服务器都可以体验的，你需要确保你的服务器符合以下条件，这样才可以从 Folia 中受益 -- 16 个**物理**CPU 核心 +- 16 个 **物理** CPU 核心 - 玩家较为分散 (生存多人游戏、无政府、空岛或一些迷你游戏服务器) - 你需要的插件支持 Folia @@ -76,7 +76,7 @@ flowchart TD ### 主要分支 - **[Luminol](luminol.md)** - 性能、稳定性和功能的最佳平衡，包含 Lophine 生电分支 (1.21+) -- **[其他分支](another.md)** - 包含 Molia、DeerFolia、Kaiiju 等 +- **[其他分支](misc.md)** - 包含 Molia、DeerFolia、Kaiiju 等 ### 快速下载 @@ -84,4 +84,4 @@ flowchart TD - [Folia](https://mcres.cn/downloads/folia.html) - [Luminol & Lophine](https://mcres.cn/downloads/luminol.html) -- [更多分支下载](another.md) +- [更多分支下载](misc.md) diff --git a/docs-java/start/server-core-choose/folia/luminol.md b/docs-java/start/server-core-choose/folia/luminol.md index 757cfaee3..8f3156163 100644 --- a/docs-java/start/server-core-choose/folia/luminol.md +++ b/docs-java/start/server-core-choose/folia/luminol.md @@ -107,7 +107,7 @@ Lophine 提供了许多实验性功能，可以在配置文件中开启： bad_omen_infinite = false # 击杀袭击队长时获得不祥之兆效果 give_bad_omen_when_kill_raid_captain = false - # 允许跳过30秒冷却直接触发袭击 + # 允许跳过 30 秒冷却直接触发袭击 allow_skip_cooldown = false [misc.container_expansion] @@ -167,7 +167,7 @@ Lophine 提供了许多实验性功能，可以在配置文件中开启： 这些配置让你可以精确控制服务器的生电特性，满足不同生电需求 -:::tip 配置建议 +:::tip[配置建议] 对于生电服务器，建议开启以下配置： @@ -182,7 +182,7 @@ Lophine 提供了许多实验性功能，可以在配置文件中开启： 如果你在使用 Lophine 时遇到问题，可以加入 LuminolMC 的社区： -- QQ群: [1015048616](http://qm.qq.com/cgi-bin/qm/qr?_wv=1027&k=QML5kIVsniPi1PlZvnjHQT_02EHsZ5Jc&authKey=%2FTCJsZC7JFQ9sxAroPCKuYnlV57Z5fyqp36ewXZk3Sn4iJ9p4MB1JKdc%2FFcX3HOM&noverify=0&group_code=1015048616) -- QQ频道: [点击加入](https://pd.qq.com/s/eq9krf9j) +- QQ 群：[1015048616](http://qm.qq.com/cgi-bin/qm/qr?_wv=1027&k=QML5kIVsniPi1PlZvnjHQT_02EHsZ5Jc&authKey=%2FTCJsZC7JFQ9sxAroPCKuYnlV57Z5fyqp36ewXZk3Sn4iJ9p4MB1JKdc%2FFcX3HOM&noverify=0&group_code=1015048616) +- QQ 频道：[点击加入](https://pd.qq.com/s/eq9krf9j) - Telegram: [点击加入](https://t.me/LuminolMinecraft) - Discord: [点击加入](https://discord.gg/Qd7m3V6eDx) diff --git a/docs-java/start/server-core-choose/folia/another.md b/docs-java/start/server-core-choose/folia/misc.md similarity index 100% rename from docs-java/start/server-core-choose/folia/another.md rename to docs-java/start/server-core-choose/folia/misc.md diff --git a/docs-java/start/server-core-choose/hybrid.md b/docs-java/start/server-core-choose/hybrid.md index 6affa6e62..de8a0268c 100644 --- a/docs-java/start/server-core-choose/hybrid.md +++ b/docs-java/start/server-core-choose/hybrid.md @@ -15,7 +15,7 @@ sidebar_position: 2 ::: -:::danger 混合端注意事项 +:::danger[混合端注意事项] Mod 作者们绝大多数都不会受理与混合端相关的问题，风险自行承担。 @@ -28,19 +28,19 @@ Mod 作者们绝大多数都不会受理与混合端相关的问题，风险自 | 名称 | 介绍 | 推荐与否 | 下载镜像 | 支持版本 | | ------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------- | | [Crucible](https://github.com/CrucibleMC/Crucible) | Thermos 的分支，目前还在积极维护，完全兼容 Thermos | 推荐 | [McRes](https://vip.123pan.cn/1821558579/6492157) | 1.7.10 | -| [CatServer](https://catmc.org/) | (推荐，但我真不喜欢核心内置广告)。既可以加入 Mod 又可以加入插件缺点：部分插件不支持，部分 Mod 不支持；Mod 和插件在一起运行难免出现一些七七八八的 bug。 | 推荐 1.12.2 | [McRes](https://mcres.cn/downloads/catserver.html) [FastMirror](https://www.fastmirror.net/#/download/CatServer) [MCSL](https://sync.mcsl.com.cn/core/CatServer) | 1.12.2/1.16.5/1.18.2/ | -| [Mohist](https://mohistmc.com/software/mohist) | 兼容 Paper 的一些插件支持，兼容 Mod 和插件；缺点：比较多插件不支持，部分 Mod 不支持；Mod 和插件在一起运行难免出现一些七七八八的 bug。 | 推荐高版本 | [McRes](https://mcres.cn/downloads/mohist.html) [FastMirror](https://www.fastmirror.net/#/download/Mohist) [原子云](https://res.nullatom.com/Minecraft/Server/Mohist/) [MCSL](https://sync.mcsl.com.cn/core/Mohist) | 1.12.2/1.16.5/1.18+ | +| [CatServer](https://catmc.org/) | (推荐，但我真不喜欢核心内置广告)。既可以加入 mod 又可以加入插件缺点：部分插件不支持，部分 mod 不支持；mod 和插件在一起运行难免出现一些七七八八的 bug。 | 推荐 1.12.2 | [McRes](https://mcres.cn/downloads/catserver.html) [FastMirror](https://www.fastmirror.net/#/download/CatServer) [MCSL](https://sync.mcsl.com.cn/core/CatServer) | 1.12.2/1.16.5/1.18.2/ | +| [Mohist](https://mohistmc.com/software/mohist) | 兼容 Paper 的一些插件支持，兼容 mod 和插件；缺点：比较多插件不支持，部分 mod 不支持；mod 和插件在一起运行难免出现一些七七八八的 bug。 | 推荐高版本 | [McRes](https://mcres.cn/downloads/mohist.html) [FastMirror](https://www.fastmirror.net/#/download/Mohist) [原子云](https://res.nullatom.com/Minecraft/Server/Mohist/) [MCSL](https://sync.mcsl.com.cn/core/Mohist) | 1.12.2/1.16.5/1.18+ | | [Arclight-Forge](https://github.com/IzzelAliz/Arclight) | - | 推荐高版本 | [FastMirror](https://www.fastmirror.net/#/download/Arclight) [McRes](https://mcres.cn/downloads/arclight.html) [MCSL](https://sync.mcsl.com.cn/core/Arclight) | 1.16.5+ | | [Magma](https://magmafoundation.org/) | - | - | [McRes](https://mcres.cn/downloads/magma.html) | 没用过，不知道 | -| [Sponge](sponge.md) | 可加入 Sponge 插件，支持 Mod，内置小部分优化，非 Sponge 服务端可安装 Mod 获得同等效果。缺点：即使你用了很多办法也很难让 Bukkit 插件稳定运行；Sponge 插件特别少；启动速度特别慢。操作特别难，与前面的完全不相同。 | 不推荐新手使用 | [McRes](https://mcres.cn/downloads/spongeforge.html) [FastMirror](https://www.fastmirror.net/#/download/SpongeForge) [MCSL](https://sync.mcsl.com.cn/core/SpongeForge) | 1.7.10 - 最新 | +| [Sponge](sponge.md) | 可加入 Sponge 插件，支持 mod，内置小部分优化，非 Sponge 服务端可安装 mod 获得同等效果。缺点：即使你用了很多办法也很难让 Bukkit 插件稳定运行；Sponge 插件特别少；启动速度特别慢。操作特别难，与前面的完全不相同。 | 不推荐新手使用 | [McRes](https://mcres.cn/downloads/spongeforge.html) [FastMirror](https://www.fastmirror.net/#/download/SpongeForge) [MCSL](https://sync.mcsl.com.cn/core/SpongeForge) | 1.7.10 - 最新 | -:::tip Mo 与 Arc +:::tip[Mohist 与 Arclight] Mohist 与 Arclight 并没有谁好谁坏，通常来说，两个服务端最好都试一试，留下表现最好的就行 ::: -:::tip 兼容性修复 +:::tip[兼容性修复] 如果你使用的是 1.12.2 的混合端，推荐同时安装 [HybridFix](https://www.mcmod.cn/class/17621.html) 增强兼容性 @@ -48,7 +48,7 @@ Mohist 与 Arclight 并没有谁好谁坏，通常来说，两个服务端最好 ## Fabric -:::tip 使用 Fabric 混合端前的提示 +:::tip[使用 Fabric 混合端前的提示] 目前部分常用的 Bukkit 插件已有 Fabric 平替模组。 @@ -60,7 +60,7 @@ EssentialsX/CMI/HuskHomes -> HuskHomes(Fabric 版) | 名称 | 介绍 | 推荐与否 | 下载镜像 | | -------------------------------------------------------- | -------------------------------------------------------------------- | -------- | -------------------------------------------------------------------------------------------------------------- | -| [Taiyitist](https://github.com/TaiyitistMC/Taiyitist) | 并不是一款端，而是一个 Mod 需要安装在 Fabric，安装后重启即可加载插件 | - | [McRes](https://mcres.cn/downloads/banner.html) [MCSL](https://sync.mcsl.com.cn/core/Banner) | +| [Taiyitist](https://github.com/TaiyitistMC/Taiyitist) | 并不是一款端，而是一个 mod 需要安装在 Fabric，安装后重启即可加载插件 | - | [McRes](https://mcres.cn/downloads/banner.html) [MCSL](https://sync.mcsl.com.cn/core/Banner) | | [Arclight-Fabric](https://github.com/IzzelAliz/Arclight) | 出现时间比 Banner 晚，目前不太稳定 | - | [FastMirror](https://www.fastmirror.net/#/download/Arclight) [McRes](https://mcres.cn/downloads/arclight.html) | | [Cardboard](https://cardboardpowered.org/) | 支持的版本较多，支持 1.16.5-1.20.4 | - | [McRes](https://mcres.cn/downloads/carboard.html) | @@ -68,7 +68,7 @@ EssentialsX/CMI/HuskHomes -> HuskHomes(Fabric 版) :::info -Banner 现在已经不属于 Mohist,同时已经改名为 Taiyitist +Banner 现在已经不属于 Mohist，同时已经改名为 Taiyitist ::: @@ -76,6 +76,6 @@ Banner 现在已经不属于 Mohist,同时已经改名为 Taiyitist | 名称 | 介绍 | 推荐与否 | 下载镜像 | | ------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------- | -------- | -| [Arclight - NeoForge](https://github.com/IzzelAliz/Arclight) | 用Mixin实现的Bukkit API 和Neoforge实现的混合端 | - | - | -| [Youer](https://github.com/MohistMC/Youer/) | 结合了 NeoForge 模组支持和 Paper API 兼容性，能无缝支持 Bukkit/Spigot/Paper 生态系统的插件，并且针对模组环境进行了性能和稳定性优化。其技术栈包含 NeoForge、Bukkit、CraftBukkit、Spigot、Paper、PurPur、Arclight Remapping 等组件，部分组件集成已完成，部分仍在进行中 | - | - | -| [Magma - Neo](https://github.com/magmafoundation/Magma-Neo) | 用Patch实现的Neoforge和Spigot API的混合端 | - | - | +| [Arclight - NeoForge](https://github.com/IzzelAliz/Arclight) | 用 Mixin 实现的 Bukkit API 和 Neoforge 实现的混合端 | - | - | +| [Youer](https://github.com/MohistMC/Youer/) | 结合了 NeoForge 模组支持和 Paper API 兼容性，能无缝支持 Bukkit/Spigot/Paper 生态系统的插件，并且针对模组环境进行了性能和稳定性优化。其技术栈包含 NeoForge、Bukkit、CraftBukkit、Spigot、Paper、Purpur、Arclight Remapping 等组件，部分组件集成已完成，部分仍在进行中 | - | - | +| [Magma - Neo](https://github.com/magmafoundation/Magma-Neo) | 用 Patch 实现的 Neoforge 和 Spigot API 的混合端 | - | - | diff --git a/docs-java/start/server-core-choose/mod.md b/docs-java/start/server-core-choose/mod.md index 32526bd02..a26262e95 100644 --- a/docs-java/start/server-core-choose/mod.md +++ b/docs-java/start/server-core-choose/mod.md @@ -5,7 +5,7 @@ sidebar_position: 3 # Mod 端 -Mod 端的选择一般优先考虑玩法（即主要的玩法 Mod），再考虑性能 +Mod 端的选择一般优先考虑玩法（即主要的玩法 mod），再考虑性能 比方说，我的服务器主要玩法是匠魂，它只支持 Forge，那我就只能选择 Forge @@ -19,9 +19,9 @@ Mod 端的选择一般优先考虑玩法（即主要的玩法 Mod），再考虑 ![](_images/NeoForge.png) -关于 NeoForge 和 Forge 的关系，可以查看[这篇文章](https://www.bilibili.com/opus/827402209530478597) +关于 NeoForge 和 Forge 的关系，可以查看 [这篇文章](https://www.bilibili.com/opus/827402209530478597) -通常来说，1.21 以上**可以**使用 NeoForge +通常来说，1.21 以上 **可以** 使用 NeoForge ### Sinytra Connector @@ -62,7 +62,7 @@ Kilt 可以在 Fabric 上运行 Forge 模组 1.14 以下版本的 Fabric，主要支持 1.3-1.13.2 以及愚人节版本 -[下载地址](https://www.mcmod.cn/class/3391.html)，还需要安装[Legacy Fabric API](https://www.mcmod.cn/class/3398.html) +[下载地址](https://www.mcmod.cn/class/3391.html)，还需要安装 [Legacy Fabric API](https://www.mcmod.cn/class/3398.html) :::warning diff --git a/docs-java/start/server-core-choose/multipaper.md b/docs-java/start/server-core-choose/multipaper.md index 502a3aad5..ec4537635 100644 --- a/docs-java/start/server-core-choose/multipaper.md +++ b/docs-java/start/server-core-choose/multipaper.md @@ -19,4 +19,4 @@ MultiPaper 与 Folia 的目标是相同的：充分利用硬件，承载更多 ::: -由于其过于复杂，并且有写的更好的[文章](https://www.ghostchu.com/archives/minecraft-multipaper)，就不写了 +由于其过于复杂，并且有写的更好的 [文章](https://www.ghostchu.com/archives/minecraft-multipaper)，就不写了 diff --git a/docs-java/start/server-core-choose/plugin.md b/docs-java/start/server-core-choose/plugin.md index 26f03a694..627381336 100644 --- a/docs-java/start/server-core-choose/plugin.md +++ b/docs-java/start/server-core-choose/plugin.md @@ -56,7 +56,7 @@ import TabItem from '@theme/TabItem'; - 性能 - 在高版本逐渐比不过他的分支 - 特性 - 丧失不少原版特性 -总的来说，Paper 核心适合那些追究 _极端的_ 稳定的人 +总的来说，Paper 核心适合那些追究 *极端的* 稳定的人 - 官方英文文档 [点我](https://docs.papermc.io/paper) - 笨蛋汉化文档 [点我](https://paper.8aka.org/paper) @@ -85,7 +85,7 @@ import TabItem from '@theme/TabItem'; **劣势**： - 配置 - 配置文件比较繁杂 -- 支持 - 只有部分 mc 版本的构建 +- 支持 - 只有部分 MC 版本的构建 综上所述，目前 Purpur 是综合最优选择 @@ -116,7 +116,7 @@ import TabItem from '@theme/TabItem'; 专为生电而生的核心。 -leaves 基本完全支持客户端生电 Mod，包括但不限于 Carpet，pca，投影，共享原理图，minihud，bbor，ommc，Xaero 小地图，Jade，appleskin。 +Leaves 基本完全支持客户端生电 mod，包括但不限于 Carpet、PCA、投影、共享原理图、MiniHUD、BBOR、OMMC、Xaero 小地图、Jade、AppleSkin。 [点我](https://docs.leavesmc.org/zh_Hans) 查看 Leaves 官方文档 @@ -128,13 +128,13 @@ leaves 基本完全支持客户端生电 Mod，包括但不限于 Carpet，pca - [Leaves 1.18.2](https://vip.123pan.cn/1821558579/6492009) - + ![](_images/leaf.png) **优势**： -- 性能 - 比 purpur 好的多的性能（在实体方面甚至能达到 50% 以上的提升） +- 性能 - 比 Purpur 好的多的性能（在实体方面甚至能达到 50% 以上的提升） - 支持 - 国人开发的核心 对插件的兼容程度：Paper = Purpur > Leaf /Leaves @@ -163,7 +163,7 @@ leaves 基本完全支持客户端生电 Mod，包括但不限于 Carpet，pca 目前仅有 1.8.8 版本的核心，而没有 1.8.9 -1.8.8 与 1.8.9 区别小到安装 [ViaVersion](../../process/plugin/other/Via/Via.md) 之后感觉不到区别 +1.8.8 与 1.8.9 区别小到安装 [ViaVersion](../../process/plugin/misc/via/via.md) 之后感觉不到区别 ::: diff --git a/docs-java/start/server-core-choose/server-core-choose.md b/docs-java/start/server-core-choose/server-core-choose.md index a5bf48caa..051a01b79 100644 --- a/docs-java/start/server-core-choose/server-core-choose.md +++ b/docs-java/start/server-core-choose/server-core-choose.md @@ -34,7 +34,7 @@ sidebar_position: 2 此类核心的存档结构有些不同 -如果你是从非 Bukkit 系核心或单人存档迁移，请查看[Leaves 的迁移文档](https://docs.leavesmc.org/zh_Hans/leaves/guides/migration)(通用所有 Bukkit 插件端) +如果你是从非 Bukkit 系核心或单人存档迁移，请查看 [Leaves 的迁移文档](https://docs.leavesmc.org/zh_Hans/leaves/guides/migration) (通用所有 Bukkit 插件端) ::: @@ -44,17 +44,17 @@ sidebar_position: 2 :::tip -可以安装插件和 Mod 的服务端 +可以安装插件和 mod 的服务端 ::: :::danger -部分性能不如 Mod 端，游戏性丰富，稳定性和报错非常玄学，建议新手不要尝试 +部分性能不如 mod 端，游戏性丰富，稳定性和报错非常玄学，建议新手不要尝试 ::: -混合端常见的有 Catserver；高版本推荐使用 Mohist 或 Arclight，就目前来看，它们的本身稳定性良好，也比纯 Forge 有所优化 (但 Mod /插件数量多了之后兼容性问题可能会莫名让人头疼) +混合端常见的有 Catserver；高版本推荐使用 Mohist 或 Arclight，就目前来看，它们的本身稳定性良好，也比纯 Forge 有所优化 (但 mod /插件数量多了之后兼容性问题可能会莫名让人头疼) ## Mod 端 @@ -62,13 +62,13 @@ sidebar_position: 2 :::tip -只能安装 Mod 的服务端 +只能安装 mod 的服务端 ::: -性能较差，某些 Mod 就不是想给多人游戏设计的；拓展性强，内存需求较大，游戏性可以做的很丰富，但客户端需要安装相同的 Mod。纯 Mod 服主流只有 Forge 和 Fabric 两种， +性能较差，某些 mod 就不是想给多人游戏设计的；拓展性强，内存需求较大，游戏性可以做的很丰富，但客户端需要安装相同的 mod。纯 mod 服主流只有 Forge 和 Fabric 两种， -高版本一般推荐使用 Fabric，因为 Fabric 优化 Mod 多效果比较好，但是最重要的还是：如果有什么 Mod 只有 Fabric / Forge 版本而你又非玩不可，只能选择相应的核心。 +高版本一般推荐使用 Fabric，因为 Fabric 优化 mod 多效果比较好，但是最重要的还是：如果有什么 mod 只有 Fabric / Forge 版本而你又非玩不可，只能选择相应的核心。 ## 更换核心 diff --git a/docs-java/start/server-core-choose/sponge.md b/docs-java/start/server-core-choose/sponge.md index 15da754f9..48a423f2f 100644 --- a/docs-java/start/server-core-choose/sponge.md +++ b/docs-java/start/server-core-choose/sponge.md @@ -7,12 +7,12 @@ sidebar_position: 6 ![](_images/sponge.png) -Sponge 有 SpongeForge(Forge+Sponge 插件) 和 SpongeVanilla(原版+Sponge 插件) 两种选择。 +Sponge 有 SpongeForge (Forge+Sponge 插件) 和 SpongeVanilla (原版+Sponge 插件) 两种选择。 按照本文档的分类，SpongeForge 属于 [混合端](hybrid.md)，但是 Sponge 与与他们有 **极大的** 不同。 最明显的区别是，Sponge 另起炉灶，是完全独立的插件生态，且从设计之初就考虑到了插件与 mod 的兼容问题， -你不大可能看到插件和 mod 打架的情况，但劣势也在此处，相比 Spigot / Paper，Sponge 插件**十分稀少**。并且 Sponge 插件开发更加困难。 +你不大可能看到插件和 mod 打架的情况，但劣势也在此处，相比 Spigot / Paper，Sponge 插件 **十分稀少**。并且 Sponge 插件开发更加困难。 虽然 Sponge 有着较好的性能和完善的官方文档，但目前仍然不推荐新人使用此核心。 @@ -26,9 +26,9 @@ Sponge 插件与 Bukkit 插件不兼容。 `官网` https://spongepowered.org -`文档(英文)` https://docs.spongepowered.org/stable/en +`文档 (英文)` https://docs.spongepowered.org/stable/en -`文档(中文)` https://docs.spongepowered.org/stable/zh-CN +`文档 (中文)` https://docs.spongepowered.org/stable/zh-CN ::: diff --git a/docs/_images/postyizhan.png b/docs/_images/postyizhan.png deleted file mode 100644 index 9d5437451..000000000 Binary files a/docs/_images/postyizhan.png and /dev/null differ diff --git a/docs/_images/postyizhan_zanzhu.jpg b/docs/_images/postyizhan_zanzhu.jpg deleted file mode 100644 index 253b374c0..000000000 Binary files a/docs/_images/postyizhan_zanzhu.jpg and /dev/null differ diff --git a/docs/_images/qqgroupshield.svg b/docs/_images/qqgroupshield.svg deleted file mode 100644 index b09ef50f7..000000000 --- a/docs/_images/qqgroupshield.svg +++ /dev/null @@ -1 +0,0 @@ -QQ群: 611076407QQ群611076407 \ No newline at end of file diff --git "a/docs/_images/\345\260\221\344\270\234\350\245\277\344\272\206\357\274\237.png" "b/docs/_images/\345\260\221\344\270\234\350\245\277\344\272\206.png" similarity index 100% rename from "docs/_images/\345\260\221\344\270\234\350\245\277\344\272\206\357\274\237.png" rename to "docs/_images/\345\260\221\344\270\234\350\245\277\344\272\206.png" diff --git a/docs/advance/arthas.md b/docs/advance/arthas.md index de0a575e5..244b52952 100644 --- a/docs/advance/arthas.md +++ b/docs/advance/arthas.md @@ -20,7 +20,7 @@ Arthas(中文名：阿尔萨斯) 是一个 Java 诊断工具，在 Minecraft 中 ## 下载 -自行参考[官方文档 - 下载](https://arthas.aliyun.com/doc/install-detail.html) +自行参考 [官方文档 - 下载](https://arthas.aliyun.com/doc/install-detail.html) ### Arthas IDEA @@ -30,9 +30,9 @@ Arthas 的 idea 插件，可以帮助你生成 Arthas 命令 ## 启动 -自行参考[官方文档 - 快速开始](https://arthas.aliyun.com/doc/quick-start.html) +自行参考 [官方文档 - 快速开始](https://arthas.aliyun.com/doc/quick-start.html) -## 开始！ +## 开始 :::tip @@ -42,7 +42,7 @@ Arthas 的 idea 插件，可以帮助你生成 Arthas 命令 ### 哪个插件发送了聊天信息？ -```shell +```bash watch -x 2 net.minecraft.server.network.PlayerConnection * '{params[0],@java.lang.Thread@currentThread().getStackTrace()}' 'params.length==2 && (params[0].class.name == "net.minecraft.network.protocol.game.ClientboundPlayerChatPacket" || params[0].class.name == "net.minecraft.network.protocol.game.ClientboundSystemChatPacket")' ``` @@ -64,7 +64,7 @@ watch -x 2 net.minecraft.server.network.PlayerConnection * '{params[0],@java.lan ### 查看类是哪个插件添加的 -```shell +```bash sc -d com.google.gson.Gson ``` @@ -72,7 +72,7 @@ sc -d com.google.gson.Gson ### 日志是哪个插件打印的 -```shell +```bash watch -x 2 org.apache.logging.log4j.core.config.LoggerConfig processLogEvent '{params[0].message.message,@java.lang.Thread@currentThread().getStackTrace()}' 'params[0].message.message.contains("日志中的一部分内容")' ``` diff --git a/docs/advance/bot/bot.md b/docs/advance/bot/bot.md index c73aabae7..3a2064cc1 100644 --- a/docs/advance/bot/bot.md +++ b/docs/advance/bot/bot.md @@ -6,7 +6,7 @@ sidebar_position: 6 # 群机器人 -搭建机器人能够让你实现群服消息互通、查询服务器状态、通过聊天即可管理服务器等功能，让你的玩家交流群与服务器连接起来。 +搭建机器人能够让你实现群服消息互通、查询服务器状态、通过聊天即可管理服务器等功能，让你的玩家交流群与服务器连接起来。 机器人通常分为两个部分，这两个部分分别负责控制 QQ 和对社交帐号执行程序。 @@ -14,12 +14,12 @@ sidebar_position: 6 当然，部分框架上可以加载扩展，通过这些扩展，你可以实现部分与 MC 本体无关的交互。 -对社交账号执行程序的部分可以被叫做机器人程序。但因为本教程针对 MC 服务器，因此以把以服务器插件或类似形式加载的机器人程序称为 [后端插件](plugin.md) ，把以独立程序运行的称为 [通用机器人](general.md) 。 +对社交账号执行程序的部分可以被叫做机器人程序。但因为本教程针对 MC 服务器，因此以把以服务器插件或类似形式加载的机器人程序称为 [后端插件](plugin.md)，把以独立程序运行的称为 [通用机器人](general.md)。 -连接的方式目前主流的有 HTTP 协议和 Websocket(ws) 协议。每个协议又分为正向和反向，其中正向要求机器人框架本身作为服务器将端口开放给机器人软件进行连接，而反向则要求机器人软件开放端口给框架连接。 +连接的方式目前主流的有 HTTP 协议和 WebSocket (ws) 协议。每个协议又分为正向和反向，其中正向要求机器人框架本身作为服务器将端口开放给机器人软件进行连接，而反向则要求机器人软件开放端口给框架连接。 本篇仅列出常见的实现方法，不对具体实现过程描述，请自行查阅相关文档。 ## OneBot 标准 -[OneBot](https://onebot.dev/) 是**统一的聊天机器人应用接口标准**。它适用于各种各样的即时通讯软件，QQ 是其应用场景之一。如果机器人框架和机器人都支持 OneBot，那它们便可以配合使用。 +[OneBot](https://onebot.dev/) 是 **统一的聊天机器人应用接口标准**。它适用于各种各样的即时通讯软件，QQ 是其应用场景之一。如果机器人框架和机器人都支持 OneBot，那它们便可以配合使用。 diff --git a/docs/advance/bot/framework.md b/docs/advance/bot/framework.md index 533d6e32a..b03694a28 100644 --- a/docs/advance/bot/framework.md +++ b/docs/advance/bot/framework.md @@ -10,25 +10,26 @@ import TabItem from '@theme/TabItem'; ## 第三方机器人框架 + | LLOneBot | ![](https://img.shields.io/badge/状态-积极维护-green?style=for-the-badge) | | -------- | -------------------------------------------------------------------------------------------------------------------------------------------- | -| 相关链接 | [Github 仓库](https://github.com/LLOneBot/LLOneBot) \| [文档站](https://llonebot.github.io/zh-CN/) | +| 相关链接 | [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) 插件市场下载 | +| 下载 | [GitHub](https://github.com/LLOneBot/LLOneBot/releases) 或者 [LiteLoaderQQNT](https://github.com/LiteLoaderQQNT/LiteLoaderQQNT) 插件市场下载 | | NapCatQQ | ![](https://img.shields.io/badge/状态-积极维护-green?style=for-the-badge) | | -------- | ------------------------------------------------------------------------------------------------------------------------------------------- | -| 相关链接 | [Github 仓库](https://github.com/NapNeko/NapCatQQ) \| [文档站](https://napneko.github.io/) | +| 相关链接 | [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) 插件市场下载 | +| 下载 | [GitHub](https://github.com/NapNeko/NapCatQQ/releases) 或者 [LiteLoaderQQNT](https://github.com/LiteLoaderQQNT/LiteLoaderQQNT) 插件市场下载 | @@ -36,80 +37,85 @@ import TabItem from '@theme/TabItem'; | Overflow | ![](https://img.shields.io/badge/状态-积极维护-green?style=for-the-badge) | | -------- | --------------------------------------------------------------------------------------------------------- | -| 相关链接 | [Github 仓库](https://github.com/MrXiaoM/overflow) \| [文档站](https://mirai.mrxiaom.top/docs/UserManual) | +| 相关链接 | [GitHub 仓库](https://github.com/MrXiaoM/overflow) \| [文档站](https://mirai.mrxiaom.top/docs/UserManual) | | 作者 | [MrXiaoM](https://github.com/MrXiaoM) | | 介绍 | Overflow 是 mirai-core-api 的实现，对接 OneBot 11 标准，实现 mirai 的无缝迁移 | | 下载 | [官网下载](https://mirai.mrxiaom.top/) | + ## 接入 QQ 官方接口的机器人框架 + | Gensokyo | ![](https://img.shields.io/badge/状态-积极维护-green?style=for-the-badge) | | -------- | ------------------------------------------------------------------------- | -| 相关链接 | [Github 仓库](https://github.com/Hoshinonyaruko/Gensokyo) | +| 相关链接 | [GitHub 仓库](https://github.com/Hoshinonyaruko/Gensokyo) | | 作者 | [Hoshinonyaruko](https://github.com/Hoshinonyaruko) | | 介绍 | 基于 OneBot QQ 官方机器人 Api Golang 原生实现 | -| 下载 | [Github](https://github.com/Hoshinonyaruko/Gensokyo/releases) | +| 下载 | [GitHub](https://github.com/Hoshinonyaruko/Gensokyo/releases) | + ## 已停止更新的机器人框架 + | Shamrock | ![](https://img.shields.io/badge/状态-停止维护-red?style=for-the-badge) | | -------- | ----------------------------------------------------------------------------------------------------------------- | -| 相关链接 | [Github 仓库](https://github.com/whitechi73/OpenShamrock) \| [文档站](https://whitechi73.github.io/OpenShamrock/) | +| 相关链接 | [GitHub 仓库](https://github.com/whitechi73/OpenShamrock) \| [文档站](https://whitechi73.github.io/OpenShamrock/) | | 作者 | [whitechi73](https://github.com/whitechi73) | | 介绍 | 基于 Lsposed（Non-Riru）实现 Kritor 标准的 QQ 机器人框架 | -| 下载 | [Github](https://github.com/whitechi73/OpenShamrock/releases) | +| 下载 | [GitHub](https://github.com/whitechi73/OpenShamrock/releases) | | chronocat | ![](https://img.shields.io/badge/状态-不再积极维护-yellow?style=for-the-badge) | | --------- | ------------------------------------------------------------------------------ | -| 相关链接 | [Github 仓库](https://github.com/chrononeko/chronocat) | +| 相关链接 | [GitHub 仓库](https://github.com/chrononeko/chronocat) | | 作者 | [chrononeko](https://github.com/chrononeko) | | 介绍 | 模块化的 Satori 框架 | -| 下载 | [Github](https://github.com/chrononeko/chronocat/releases) | +| 下载 | [GitHub](https://github.com/chrononeko/chronocat/releases) | | go-cqhttp | ![](https://img.shields.io/badge/状态-停止维护-red?style=for-the-badge) \| [停更公告地址](https://github.com/Mrs4s/go-cqhttp/issues/2471) | | --------- | ----------------------------------------------------------------------------------------------------------------------------------------- | -| 相关链接 | [Github 仓库](https://github.com/Mrs4s/go-cqhttp) \| [文档站](https://docs.go-cqhttp.org/) | +| 相关链接 | [GitHub 仓库](https://github.com/Mrs4s/go-cqhttp) \| [文档站](https://docs.go-cqhttp.org/) | | 作者 | [Mrs4s](https://github.com/Mrs4s) | | 介绍 | 基于 Mirai 以及 MiraiGo 的 OneBot Golang 原生实现 | -| 下载 | [Github](https://github.com/Mrs4s/go-cqhttp/releases) | +| 下载 | [GitHub](https://github.com/Mrs4s/go-cqhttp/releases) | | Mirai | ![](https://img.shields.io/badge/状态-不再积极维护-yellow?style=for-the-badge) | | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| 相关链接 | [Github 仓库](https://github.com/mamoe/mirai) \| [官方论坛](https://mirai.mamoe.net/) \| [用户手册](https://github.com/mamoe/mirai/blob/dev/docs/UserManual.md) | +| 相关链接 | [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 协议支持的高效率机器人库 | -| 下载 | [Github](https://github.com/iTXTech/mirai-console-loader/releases) | +| 下载 | [GitHub](https://github.com/iTXTech/mirai-console-loader/releases) | | Lagrange.OneBot | ![](https://img.shields.io/badge/状态-停止维护-red?style=for-the-badge) | | --------------- | ------------------------------------------------------------------------------------------------------------------------------------ | -| 相关链接 | [Github 仓库](https://github.com/LagrangeDev/Lagrange.Core) \| [文档站](https://lagrangedev.github.io/Lagrange.Doc/Lagrange.OneBot/) | +| 相关链接 | [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 框架进行通信 | -| 下载 | [Github](https://github.com/LagrangeDev/Lagrange.Core/releases) | +| 下载 | [GitHub](https://github.com/LagrangeDev/Lagrange.Core/releases) | + diff --git a/docs/advance/bot/general.md b/docs/advance/bot/general.md index d4073977a..b97b70992 100644 --- a/docs/advance/bot/general.md +++ b/docs/advance/bot/general.md @@ -12,8 +12,9 @@ import TabItem from '@theme/TabItem'; 部分 QQ 机器人程序会依赖 Minecraft 插件来实现部分无法完成的功能。 -关于机器人框架详情请见 [通用 | 机器人框架](./framework) +关于机器人框架详情请见 [通用 | 机器人框架](framework.md) + @@ -52,18 +53,18 @@ import TabItem from '@theme/TabItem'; | Serein | ![](https://img.shields.io/badge/状态-积极维护-green?style=for-the-badge) | | -------- | ------------------------------------------------------------------------------------------------------------------------- | -| 相关链接 | [Github 仓库](https://github.com/SereinDev/Serein) \| [文档站](https://sereindev.github.io/) | +| 相关链接 | [GitHub 仓库](https://github.com/SereinDev/Serein) \| [文档站](https://sereindev.github.io/) | | 作者 | [SereinDev](https://github.com/SereinDev) | | 支持平台 | Java 版和基岩版 | | 介绍 | 本身是一个服务器管理软件，但支持使用 QQ 机器人，使用 OneBot11 标准接入 QQ，有机器人相关配置并且有平台支持插件进行功能拓展 | -| 下载 | [Github](https://github.com/SereinDev/Serein/releases) | +| 下载 | [GitHub](https://github.com/SereinDev/Serein/releases) | | CirnoBot | ![](https://img.shields.io/badge/状态-不再积极维护-yellow?style=for-the-badge) | | ---------------- | ----------------------------------------------------------------------------------------------------------- | -| 相关链接 | [Github 仓库](https://github.com/summerkirakira/CirnoBot) \| [文档站](https://biaoju.site/cirnobot/) | +| 相关链接 | [GitHub 仓库](https://github.com/summerkirakira/CirnoBot) \| [文档站](https://biaoju.site/cirnobot/) | | 作者 | [summerkirakira](https://github.com/summerkirakira) | | 支持 **Java 版** | Bukkit 及其分支 | | 介绍 | 基于 NoneBot2 开发的机器人平台，可使用 OneBot11 标准接入 QQ，有机器人相关配置并且有平台支持插件进行功能拓展 | @@ -74,7 +75,7 @@ import TabItem from '@theme/TabItem'; | Minecraft_QQBot | ![](https://img.shields.io/badge/状态-积极维护-green?style=for-the-badge) | | ---------------- | --------------------------------------------------------------------------------------------------------------------------------------------- | -| 相关链接 | [Github 仓库](https://github.com/Minecraft-QQBot/BotServer) \| [文档站](https://qqbot.bugjump.xyz/) | +| 相关链接 | [GitHub 仓库](https://github.com/Minecraft-QQBot/BotServer) \| [文档站](https://qqbot.bugjump.xyz/) | | 作者 | [sparkbridge](https://github.com/sparkbridge) | | 支持 **Java 版** | Bukkit 及其分支 | | 介绍 | 一款基于 NoneBot2 用多种方式与 Minecraft 交互的 Python QQ 机器人，可使用 OneBot11 标准接入 QQ，有机器人相关配置并且有平台支持插件进行功能拓展 | @@ -82,3 +83,4 @@ import TabItem from '@theme/TabItem'; + diff --git a/docs/advance/bot/plugin.md b/docs/advance/bot/plugin.md index 3b98902ee..20d1fb65a 100644 --- a/docs/advance/bot/plugin.md +++ b/docs/advance/bot/plugin.md @@ -14,19 +14,20 @@ import TabItem from '@theme/TabItem'; 部分插件模组或者外部独立程序会内置 QQ 机器人框架 -关于机器人框架详情请见 [通用 | 机器人框架](./framework) +关于机器人框架详情请见 [通用 | 机器人框架](framework.md) + | MiraiMC | ![](https://img.shields.io/badge/状态-积极维护-green?style=for-the-badge) | | ---------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| 相关链接 | [Github 仓库](https://github.com/DreamVoid/MiraiMC) \| [文档站](https://docs.miraimc.dreamvoid.me/) | +| 相关链接 | [GitHub 仓库](https://github.com/DreamVoid/MiraiMC) \| [文档站](https://docs.miraimc.dreamvoid.me/) | | 作者 | [DreamVoid](https://github.com/DreamVoid) | | 支持 **Java 版** | Bukkit 及其分支 \| BungeeCord \| Waterfall \| Sponge \| Velocity | | 支持 **基岩版** | NukkitX | | 介绍 | 一个基于 Mirai 的 Minecraft 服务端插件，能够让你在 Minecraft 服务器上使用 Mirai QQ 机器人程序，同时提供一些 API 帮助开发者简单的调用机器人接口为自己的插件实现多样的功能 | -| 下载 | [Github](https://github.com/DreamVoid/MiraiMC/releases) \| [Modrinth](https://modrinth.com/plugin/miraimc) | +| 下载 | [GitHub](https://github.com/DreamVoid/MiraiMC/releases) \| [Modrinth](https://modrinth.com/plugin/miraimc) | | **注意事项** | 由于 Mirai 原生登陆平台已停止更新，并且 MiraiMC 插件自身不支持 Onebot 协议，您需要使用 [这个拓展](https://github.com/DreamVoid/MiraiMCAddon-Overflow) 来给 MiraiMC 添加 Onebot 协议支持 | @@ -34,18 +35,18 @@ import TabItem from '@theme/TabItem'; | SparkBridge | ![](https://img.shields.io/badge/状态-积极维护-green?style=for-the-badge) | | --------------- | ---------------------------------------------------------------------------------------------------------------------------------------- | -| 相关链接 | [Github 仓库](https://github.com/sparkbridge/sparkbridge2) \| [文档站](https://sparkbridge.cn/) | +| 相关链接 | [GitHub 仓库](https://github.com/sparkbridge/sparkbridge2) \| [文档站](https://sparkbridge.cn/) | | 作者 | [sparkbridge](https://github.com/sparkbridge) | | 支持 **基岩版** | LeviLaminaBDS | | 介绍 | 轻量级、模块化和多功能的 Minecraft Bedrock Server BDS 服务器 QQ 机器人适配器，内置群服互通功能，支持插件接入，支持内核分离级别的二次开发 | -| 下载 | [Github](https://github.com/sparkbridge/sparkbridge2/releases) | +| 下载 | [GitHub](https://github.com/sparkbridge/sparkbridge2/releases) | | McBot | ![](https://img.shields.io/badge/状态-积极维护-green?style=for-the-badge) | | ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| 相关链接 | [Github 仓库](https://github.com/Nova-Committee/McBot) \| [Mcmod 文档](https://www.mcmod.cn/class/4903.html) | +| 相关链接 | [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 帮助开发者拓展功能 | @@ -56,29 +57,29 @@ import TabItem from '@theme/TabItem'; | McBot | ![](https://img.shields.io/badge/状态-积极维护-green?style=for-the-badge) | | ---------------- | ---------------------------------------------------------------------------------------------------------------------------- | -| 相关链接 | [Github 仓库](https://github.com/RegadPoleCN/PlumBot) \| [Modrinth 页面](https://modrinth.com/plugin/plumbot) | +| 相关链接 | [GitHub 仓库](https://github.com/RegadPoleCN/PlumBot) \| [Modrinth 页面](https://modrinth.com/plugin/plumbot) | | 作者 | [RegadPoleCN](https://github.com/RegadPoleCN) | | 支持 **Java 版** | Bukkit 及其分支 | -| 介绍 | 一个可以安装在 Bukkit 等服务端上的 QQ 机器人插件，它能将你的 mc 服务器与 QQ 群或 kook 频道联通，支持消息转发，死亡转发等功能 | -| 下载 | [Github](https://github.com/RegadPoleCN/PlumBot/releases) \| [Modrinth](https://modrinth.com/plugin/plumbot) | +| 介绍 | 一个可以安装在 Bukkit 等服务端上的 QQ 机器人插件，它能将你的 MC 服务器与 QQ 群或 KOOK 频道联通，支持消息转发，死亡转发等功能 | +| 下载 | [GitHub](https://github.com/RegadPoleCN/PlumBot/releases) \| [Modrinth](https://modrinth.com/plugin/plumbot) | | AQQBot | ![](https://img.shields.io/badge/状态-积极维护-green?style=for-the-badge) | | ---------------- | ---------------------------------------------------------------------------------------------------------- | -| 相关链接 | [Github 仓库](https://github.com/alazeprt/AQQBot) | +| 相关链接 | [GitHub 仓库](https://github.com/alazeprt/AQQBot) | | 作者 | [alazeprt](https://github.com/alazeprt) | | 支持 **Java 版** | Bukkit 及其分支 | | 介绍 | 一个轻量级、模块化和多功能的 Bukkit 服务器 QQ 机器人插件，内置群服互通功能，允许用户通过 QQ 群实行更多操作 | -| 下载 | [Github](https://github.com/alazeprt/AQQBot/releases) | +| 下载 | [GitHub](https://github.com/alazeprt/AQQBot/releases) | | XinxinBot | ![](https://img.shields.io/badge/状态-积极维护-green?style=for-the-badge) | | ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| 相关链接 | [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) | +| 相关链接 | [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 帮助开发者拓展功能，配置复杂但效果较好 | @@ -86,3 +87,4 @@ import TabItem from '@theme/TabItem'; + diff --git a/docs/advance/docker.md b/docs/advance/docker.md index 2facd8c45..832654c11 100644 --- a/docs/advance/docker.md +++ b/docs/advance/docker.md @@ -5,4 +5,4 @@ sidebar_position: 9 # Docker 开服 -请参考[NitWikit Docker 中文文档](https://docker.8aka.org) +请参考 [NitWikit Docker 中文文档](https://docker.8aka.org) diff --git a/docs/advance/domain-application-and-dns-resolution.md b/docs/advance/domain-and-dns.md similarity index 84% rename from docs/advance/domain-application-and-dns-resolution.md rename to docs/advance/domain-and-dns.md index 9aa76dc98..14618fdd3 100644 --- a/docs/advance/domain-application-and-dns-resolution.md +++ b/docs/advance/domain-and-dns.md @@ -47,7 +47,7 @@ sidebar_position: 5 ## 寻找合适的域名提供商查询域名 -以阿里云的[万网](https://domain.aliyun.com/)为例，打开网站，来到如下页面： +以阿里云的 [万网](https://domain.aliyun.com/) 为例，打开网站，来到如下页面： ![](_images/申请域名/1.png) @@ -61,7 +61,7 @@ sidebar_position: 5 有些域名首年很便宜，但第二年续费要成百上千，将鼠标悬停在价格旁边的倒三角处查看续费价格， -我们推荐.top，第二年价格最低，长期开服绝对推荐。 +我们推荐 .top，第二年价格最低，长期开服绝对推荐。 出于很多原因不推荐使用所谓的免费域名 @@ -91,7 +91,7 @@ sidebar_position: 5 :::warning -**购买域名后，一定要记得续费！！！** 你可以定一个提醒，在域名**快过期**的时候续费， +**购买域名后，一定要记得续费！！！** 你可以定一个提醒，在域名 **快过期** 的时候续费， 如果你预算充足，那就直接把域名续费到比自己服务器能开的时间还要长。 @@ -121,7 +121,7 @@ SRV 记录，使用二级域名记录了端口的信息，使用 SRV 可以隐 ### A 记录 -将域名指向一个 IPV4 地址。 +将域名指向一个 IPv4 地址。 人话就是把数字 IP 地址解析成英文字符的域名。 @@ -137,7 +137,7 @@ SRV 记录，使用二级域名记录了端口的信息，使用 SRV 可以隐 1. 如果只知道域名不知道 IP 就 Win + R 输入 cmd，随后输入 ping + 域名。 -2. 主机记录可以改成如 `play` 等，玩家就可以通过 `play.xxx.top:22222`(但这是不是有点太长了，除非你有明确的需求必须使用这种三级域名，否则不推荐)。 +2. 主机记录可以改成如 `play` 等，玩家就可以通过 `play.xxx.top:22222` (但这是不是有点太长了，除非你有明确的需求必须使用这种三级域名，否则不推荐)。 ::: @@ -145,7 +145,7 @@ SRV 记录，使用二级域名记录了端口的信息，使用 SRV 可以隐 将域名指向另一个域名。 -假如你的网络服务商给的是解析好的域名而不是 IP 地址，比如服务器的连接地址是 play.simpfun.cn:xxxxx，那就需要用这个来指向你自己的域名。 +假如你的网络服务商给的是解析好的域名而不是 IP 地址，比如服务器的连接地址是 `play.simpfun.cn:xxxxx`，那就需要用这个来指向你自己的域名。 记录类型选 CNAME。 @@ -173,7 +173,7 @@ SRV 记录，使用二级域名记录了端口的信息，使用 SRV 可以隐 :::tip -此方法只能用于 Minecraft Java 版服务器，基岩版不支持 srv 记录。 +此方法只能用于 Minecraft Java 版服务器，基岩版不支持 SRV 记录。 所以基岩版玩家进服时必须仍然要正常填写域名和端口，即使服务器为 Java 版的互通服。 @@ -181,7 +181,7 @@ SRV 记录，使用二级域名记录了端口的信息，使用 SRV 可以隐 ### AAAA 记录 -将域名指向一个 IPV6 地址。和 A 记录的不同之处是，AAAA 记录专门用来指向 IPv6 地址，不能指向 IPv4 地址。 +将域名指向一个 IPv6 地址。和 A 记录的不同之处是，AAAA 记录专门用来指向 IPv6 地址，不能指向 IPv4 地址。 同理，A 记录也只能指向 IPv4 地址，不能指向 IPv6 地址，这也意味着你如果要为服务器的 IPv6 地址也绑定一个域名，你就必须要再创建一条 AAAA 记录。 按照 A 记录中的方法找到你的域名点右边蓝色字的解析。点击添加记录，记录类型选择 AAAA 记录。 @@ -202,12 +202,12 @@ SRV 记录，使用二级域名记录了端口的信息，使用 SRV 可以隐 你或许已经知道，很多已经支持 IPv6 的网站虽然在支持 IPv6 的情况下可以通过 IPv6 访问， -但是仅支持 IPv4 的网络也仍然可以访问。这是因为这些网站的域名**既指向了 IPv4 地址，也指向了 IPv6 地址**， +但是仅支持 IPv4 的网络也仍然可以访问。这是因为这些网站的域名 **既指向了 IPv4 地址，也指向了 IPv6 地址**， 它的实现原理是为同一个域名同时添加 A 记录和 AAAA 记录。要实现这个目的，你只需要： 1. 在域名注册商的后台打开服务器 IPv6 地址正使用的 AAAA 记录的编辑页面。 -2. 把主机记录名改为和 A 记录一样的，比如服务器的连接地址是 xxx.top:22222，那么 AAAA 记录的记录名也写 @ ，和 A 记录保持一致，然后保存。 +2. 把主机记录名改为和 A 记录一样的，比如服务器的连接地址是 `xxx.top:22222`，那么 AAAA 记录的记录名也写 `@`，和 A 记录保持一致，然后保存。 3. 你的玩家就可以在支持 IPv6 的网络环境下通过 IPv6 连接到服务器了。不支持 IPv6 的玩家不受影响，他们可以继续正常地通过 IPv4 连接到服务器。 :::warning @@ -234,22 +234,22 @@ A 记录和 AAAA 记录都与 CNAME 记录冲突，如果你的服务器 IPv4
-DDNS 服务必须需要一个域名才能开始搭建。运行 DDNS 服务的软件，目前开服圈子最常用的是[ddns-go](https://github.com/jeessy2/ddns-go)，这个软件开箱即用，只需要简单的几步配置就可以让域名绑定在服务器上，非常方便。 +DDNS 服务必须需要一个域名才能开始搭建。运行 DDNS 服务的软件，目前开服圈子最常用的是 [ddns-go](https://github.com/jeessy2/ddns-go)，这个软件开箱即用，只需要简单的几步配置就可以让域名绑定在服务器上，非常方便。 -由于读者可能使用各种各样的域名注册商，而且限于篇幅，本文仅提供 Windows 系统、腾讯云 DNS(DNSPod) 和 ddns-go 配合使用的教程。其他注册商和操作系统的配置方法大同小异，读者们灵活变通即可，有不懂的地方善用搜索引擎搜索。 +由于读者可能使用各种各样的域名注册商，而且限于篇幅，本文仅提供 Windows 系统、腾讯云 DNS (DNSPod) 和 ddns-go 配合使用的教程。其他注册商和操作系统的配置方法大同小异，读者们灵活变通即可，有不懂的地方善用搜索引擎搜索。 1. 前往 https://github.com/jeessy2/ddns-go/releases 下载最新版的 ddns-go 安装包。 2. 将安装包 (就是下载的那个压缩包) 解压到一个不会被自己误删除的位置 (如果你不知道哪里自己不会误删除，就直接解压到文件管理器左侧的文档那个文件夹)。 -3. 在 `ddns-go.exe` 所在的同级目录[打开 Powershell](https://www.bing.com/search?q=windows%E6%80%8E%E4%B9%88%E5%9C%A8%E6%96%87%E4%BB%B6%E5%A4%B9%E4%B8%AD%E6%89%93%E5%BC%80powershell&qs=n&form=QBRE&sp=-1&lq=0&pq=windows%E6%80%8E%E4%B9%88%E5%9C%A8%E6%96%87%E4%BB%B6%E5%A4%B9%E4%B8%AD%E6%89%93%E5%BC%80powershell&sc=0-26&sk=&cvid=ED4A3EA564234CA2A72F233F64580905&ghsh=0&ghacc=0&ghpl=)。 +3. 在 `ddns-go.exe` 所在的同级目录 [打开 PowerShell](https://www.bing.com/search?q=windows%E6%80%8E%E4%B9%88%E5%9C%A8%E6%96%87%E4%BB%B6%E5%A4%B9%E4%B8%AD%E6%89%93%E5%BC%80powershell&qs=n&form=QBRE&sp=-1&lq=0&pq=windows%E6%80%8E%E4%B9%88%E5%9C%A8%E6%96%87%E4%BB%B6%E5%A4%B9%E4%B8%AD%E6%89%93%E5%BC%80powershell&sc=0-26&sk=&cvid=ED4A3EA564234CA2A72F233F64580905&ghsh=0&ghacc=0&ghpl=)。 4. 执行 `./ddns-go.exe`。 5. 打开浏览器，访问网站 localhost:9876，这是 ddns-go 的管理面板。 6. 提示输入帐号密码，由于这是你首次打开网站，直接点击登录。 -7. DNS 服务商选择 DNSPod(腾讯云)。 +7. DNS 服务商选择 DNSPod (腾讯云)。 8. 进入 DNSPod 官网 dnspod.cn。登录自己的帐号，点击帐号头像，点击 API 密钥，点击 DNSPod Token，点击创建密钥，先将 ID 和 Token 分别复制到 ddns-go 管理面板的 DNS 服务商项中的 ID 和 Token 中，再关闭 DNSPod 控制台中弹出的窗口。 9. 往下翻，根据自己的实际情况启用 IPv4 或 IPv6。获取方式都建议选择通过接口获取。在 `Domains` 中填写要跟踪的解析记录，例如你想让 `mc.arsky.club` 指向这台电脑，那就在里面填写 `mc.arsky.club` 。不要只填写 `mc`，要把整个域名都写上。 -10. 在`其他配置`中，勾选`禁止公网访问`，然后设置 `ddns-go` 的登录用户名和密码。下载登录后台的时候，你就必须要输入自己设置的用户名和密码来登录了。如果实在记不住用户密码就在服务器桌面上创建一个文本文档写里面，当然不推荐这么做，因为这很不安全，除非你认为自己真的记不住用户名和密码。 +10. 在 `其他配置` 中，勾选 `禁止公网访问`，然后设置 `ddns-go` 的登录用户名和密码。下载登录后台的时候，你就必须要输入自己设置的用户名和密码来登录了。如果实在记不住用户密码就在服务器桌面上创建一个文本文档写里面，当然不推荐这么做，因为这很不安全，除非你认为自己真的记不住用户名和密码。 11. 点击最下面的 `Save`。 到这里域名解析就配置成功了。此时控制台翻到顶，右边应该会出现日志，如果有修改域名解析 xxx 成功！或者 IP 未改变，将等待 n 次后与 DNS 服务商进行比对，就是配置成功了。如果失败了，日志会提示错误原因。 diff --git a/docs/advance/frp.md b/docs/advance/frp.md index 1de59ac52..aca9956a3 100644 --- a/docs/advance/frp.md +++ b/docs/advance/frp.md @@ -1,15 +1,15 @@ --- -title: 搭建内网穿透 (Frp) +title: 搭建内网穿透 (frp) sidebar_position: 6 --- -# 搭建内网穿透 (Frp) +# 搭建内网穿透 (frp) ## 使用现成的内网穿透提供商 -笔者无法在这里推荐运营商，因为目前在开服方面还没有受到广泛认可的内网穿透运营商。不同的运营商收费不同，限量不同,节点也不同。上网搜索"内网穿透"就能找到大量内网穿透的运营商，但是在选购的时候非常建议多家对比，找到最适合自己使用的运营商。下面是选择过程中除了价格外尤其需要注意的地方： +笔者无法在这里推荐运营商，因为目前在开服方面还没有受到广泛认可的内网穿透运营商。不同的运营商收费不同，限量不同，节点也不同。上网搜索"内网穿透"就能找到大量内网穿透的运营商，但是在选购的时候非常建议多家对比，找到最适合自己使用的运营商。下面是选择过程中除了价格外尤其需要注意的地方： 1. 正规性：最好能在运营商的官网最下面看到网站备案信息，并且运营商也介绍了自己的公司名称，公司名称上网也能查得到。 2. 流量：小服务器每月只能用掉几 G，但是大服务器每月能用掉几百 G 甚至几 T 的流量。你需要确定对流量的收费是否适合自己。如果不确定多少流量适合自己，你可以先找一家运营商用一个月，看看自己要花掉乐多少流量。 @@ -20,12 +20,12 @@ sidebar_position: 6
如何选择合适的节点？ -根据三角形两边之和大于第三边的定理，节点距离客户端或服务端越近，游戏延迟就越小。然而你无法确定客户端的地理位置，毕竟玩家来自大江南北。那么只有缩短节点与服务器之间的距离，才能保证所有玩家的延迟都最低。例如服务器位于河北，有两个节点分别位于山东枣庄和江苏宿迁，有两个玩家分别位于广东和辽宁，那么当选择离服务器更近的枣庄节点时，假设辽宁玩家到节点为 20ms，广东玩家到节点为 50ms，服务器到节点为 10ms，那么辽宁玩家的游戏延迟就是 20+10=30ms，广东玩家的游戏延迟就是 50ms+10ms=60ms。当选择离服务器更远的宿迁节点时，假设辽宁玩家到节点为 40ms，广东玩家到节点为 30ms，服务器到节点为 30ms，那么辽宁玩家的游戏延迟就是 50+30=70ms，广东玩家的游戏延迟就是 40+30=60ms。选择宿迁节点时虽然广东玩家的延迟不变，但是辽宁玩家连接服务器时，数据从更远的宿迁绕了一圈再回来，延迟高了很多。因此选择运营商时，优先选择拥有离自己近的节点的运营商。 +根据三角形两边之和大于第三边的定理，节点距离客户端或服务端越近，游戏延迟就越小。然而你无法确定客户端的地理位置，毕竟玩家来自大江南北。那么只有缩短节点与服务器之间的距离，才能保证所有玩家的延迟都最低。例如服务器位于河北，有两个节点分别位于山东枣庄和江苏宿迁，有两个玩家分别位于广东和辽宁，那么当选择离服务器更近的枣庄节点时，假设辽宁玩家到节点为 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。选择宿迁节点时虽然广东玩家的延迟不变，但是辽宁玩家连接服务器时，数据从更远的宿迁绕了一圈再回来，延迟高了很多。因此选择运营商时，优先选择拥有离自己近的节点的运营商。
6. 实名认证：为了在意外事故中更好地规划责任，很多内网穿透运营商都要求实名认证才能开始使用，或者部分节点需要实名认证。还有一些实名认证时还要求用户必须成年 (年满 18 岁)。况且实名认证服务提供方收费，内网穿透运营商可能会让你自行承担费用，目前价格通常在 1 元。所以在选择运营商时，如果你未成年，或者没有在线支付的能力，那么在一些运营商处可能会受到限制。 -## 自建 Frp +## 自建 frp 首先你得确保你有一台有公网 IP 的机器作为服务端（节点），最好是 **Linux** 的。 @@ -34,7 +34,7 @@ sidebar_position: 6 import Tabs from '@theme/Tabs'; import TabItem from '@theme/TabItem'; -### 安装 Frp +### 安装 frp #### 服务端（公网服务器） @@ -47,7 +47,7 @@ import TabItem from '@theme/TabItem'; 不同的 Linux 发行版更新方法大同小异 - + ```bash apt-get update && apt-get upgrade -y @@ -168,7 +168,7 @@ paru -Sy frpc # 客户端 -### 配置 Frp +### 配置 frp #### 配置服务端（公网服务器） @@ -204,7 +204,7 @@ vim /etc/frp/frpc.toml 输入以下内容： ```toml -serverAddr = "x.x.x.x" # 你 frps 服务器的 ip 地址 +serverAddr = "x.x.x.x" # 你 frps 服务器的 IP 地址 serverPort = 7000 # 你 frps 服务开在的端口 log.to = "/var/log/frpc.log" # 日志存放路径，一般不用改 @@ -215,15 +215,15 @@ auth.token = "example" # 令牌，与公网服务端保持一致 [[proxies]] name = "mc je" -type = "tcp" # java 版使用 tcp 协议通信，不可更改 +type = "tcp" # Java 版使用 TCP 协议通信，不可更改 localIP = "127.0.0.1" # 默认不用改 -localPort = 25565 # mc 服务端开在哪个端口？ +localPort = 25565 # MC 服务端开在哪个端口？ remotePort = 25565 # 暴露服务的公网入口 # 如果你开了互通，要基岩支持 [[proxies]] name = "mc be" -type = "udp" # 基岩版使用 udp 协议通信，不可更改 +type = "udp" # 基岩版使用 UDP 协议通信，不可更改 localIP = "127.0.0.1" localPort = 19132 remotePort = 19132 @@ -235,7 +235,7 @@ remotePort = 19132 在 frp 解压目录下，编辑 `frpc.toml` 文件（使用记事本或其他文本编辑器）： ```toml -serverAddr = "x.x.x.x" # 你 frps 服务器的 ip 地址 +serverAddr = "x.x.x.x" # 你 frps 服务器的 IP 地址 serverPort = 7000 # 你 frps 服务开在的端口 log.to = "./frpc.log" # 日志存放路径 @@ -246,15 +246,15 @@ auth.token = "example" # 令牌，与公网服务端保持一致 [[proxies]] name = "mc je" -type = "tcp" # java 版使用 tcp 协议通信，不可更改 +type = "tcp" # Java 版使用 TCP 协议通信，不可更改 localIP = "127.0.0.1" # 默认不用改 -localPort = 25565 # mc 服务端开在哪个端口？ +localPort = 25565 # MC 服务端开在哪个端口？ remotePort = 25565 # 暴露服务的公网入口 # 如果你开了互通，要基岩支持 [[proxies]] name = "mc be" -type = "udp" # 基岩版使用 udp 协议通信，不可更改 +type = "udp" # 基岩版使用 UDP 协议通信，不可更改 localIP = "127.0.0.1" localPort = 19132 remotePort = 19132 @@ -263,7 +263,7 @@ remotePort = 19132 -### 开启 Frp +### 开启 frp #### 启动服务端（公网服务器） @@ -274,12 +274,12 @@ remotePort = 19132 2. systemd 省心，有点复杂 - + 确保你的系统上有 `screen` 包，没有的话安装它们： - + ```bash apt-get install screen @@ -306,11 +306,11 @@ pacman -Sy screen ```bash screen -dR frps frps -# 键盘上按Ctrl+A+D退出 +# 键盘上按 Ctrl + A + D 退出 ``` - + 在 Linux 系统下，使用 systemd 可以方便地控制 frps 服务端的启动、停止、配置后台运行以及开机自启动。 @@ -340,13 +340,13 @@ WantedBy = multi-user.target 2. 使用 systemd 命令管理 frps 服务 ```bash -# 启动frp +# 启动 frp sudo systemctl start frps -# 停止frp +# 停止 frp sudo systemctl stop frps -# 重启frp +# 重启 frp sudo systemctl restart frps -# 查看frp状态 +# 查看 frp 状态 sudo systemctl status frps ``` @@ -366,12 +366,12 @@ sudo systemctl enable frps -##### 使用 Screen +##### 使用 screen 确保你的系统上有 `screen` 包： - + ```bash apt-get install screen @@ -398,10 +398,10 @@ pacman -Sy screen ```bash screen -dR frpc frpc -# 键盘上按Ctrl+A+D退出 +# 键盘上按 Ctrl + A + D 退出 ``` -##### 使用 Systemd +##### 使用 systemd @@ -429,13 +429,13 @@ WantedBy = multi-user.target 2. 使用 systemd 命令管理 frpc 服务 ```bash -# 启动frp +# 启动 frp sudo systemctl start frpc -# 停止frp +# 停止 frp sudo systemctl stop frpc -# 重启frp +# 重启 frp sudo systemctl restart frpc -# 查看frp状态 +# 查看 frp 状态 sudo systemctl status frpc ``` @@ -455,18 +455,20 @@ sudo systemctl enable frpc 1. 打开命令提示符（CMD）或 PowerShell 2. 切换到 frp 解压目录： - ```cmd + ```bash cd C:\frp ``` 3. 运行 frpc： - ```cmd + ```bash frpc.exe -c frpc.toml ``` :::tip + 此方法会占用一个命令行窗口，关闭窗口后 frpc 会停止运行。 + ::: ##### 方法二：使用 NSSM 设置为 Windows 服务（推荐） @@ -478,19 +480,19 @@ sudo systemctl enable frpc 3. 以管理员身份运行命令提示符 4. 安装服务： - ```cmd + ```bash nssm install frpc "C:\frp\frpc.exe" "-c C:\frp\frpc.toml" ``` 5. 启动服务： - ```cmd + ```bash nssm start frpc ``` 6. 其他常用命令： - ```cmd + ```bash # 停止服务 nssm stop frpc @@ -513,8 +515,8 @@ sudo systemctl enable frpc ```xml frpc - Frp Client - Frp 内网穿透客户端 + frp Client + frp 内网穿透客户端 C:\frp\frpc.exe -c C:\frp\frpc.toml rotate @@ -523,14 +525,14 @@ sudo systemctl enable frpc 4. 以管理员身份运行命令提示符，安装服务： - ```cmd + ```bash cd C:\frp frpc-service.exe install ``` 5. 启动服务： - ```cmd + ```bash frpc-service.exe start ``` @@ -539,10 +541,10 @@ sudo systemctl enable frpc -### 配置 proxy protocol +### 配置 PROXY protocol -如果你使用的是现成的内网穿透运营商提供的内网穿透，**一定要根据运营商提供的教程操作**。以下是两个最有名的内网穿透运营商的 proxy protocol 开启方法。 -[SakuraFrp](https://doc.natfrp.com/bestpractice/realip.html#proxy-protocol) +如果你使用的是现成的内网穿透运营商提供的内网穿透，**一定要根据运营商提供的教程操作**。以下是两个最有名的内网穿透运营商的 PROXY protocol 开启方法。 +[SakuraFrp](https://doc.natfrp.com/bestpractice/realip.html#proxy-protocol) [OpenFrp](https://openfrp.wiki/use/proxy-protocol.html#%E8%8E%B7%E5%8F%96%E8%AE%BF%E9%97%AE%E8%80%85%E7%9A%84%E7%9C%9F%E5%AE%9E-ip) 如果是自建内网穿透，那么如果是 ini 配置文件，就在 frpc 隧道对应的配置 (位于 frpc.ini 中) 中加入一行 `proxy_protocol_version =`，如果是协议 v1 就写等于 v1，v2 就写等于 v2。例如： @@ -551,7 +553,7 @@ sudo systemctl enable frpc [mc] type = tcp local_port = 25565 -# 目前支持 v1 和 v2 两个版本的 proxy protocol 协议。 +# 目前支持 v1 和 v2 两个版本的 PROXY protocol 协议。 proxy_protocol_version = v2 ``` @@ -567,9 +569,9 @@ transport.proxyProtocolVersion = "v2" **frps 的 frps.ini 或 frps.toml 不用动。** -至于如何选择 v1 和 v2，你需要根据对应服务器对 proxy protocol 的支持情况进行选择。例如 Paper 服务端目前只支持 v2。 +至于如何选择 v1 和 v2，你需要根据对应服务器对 PROXY protocol 的支持情况进行选择。例如 Paper 服务端目前只支持 v2。 -在配置完 Frp 后，记得将 Paper 配置文件中的协议支持打开： +在配置完 frp 后，记得将 Paper 配置文件中的协议支持打开： ```yaml # config/paper-global.yaml @@ -577,8 +579,8 @@ proxies: proxy-protocol: true # 从 false 改为 true ``` -这样配置会使你的服务器仅接受来自 Frp 的连接。 +这样配置会使你的服务器仅接受来自 frp 的连接。 -如果你有特殊需求，需要同时支持直连和 Proxy Protocol 的话，请安装 [HAProxyDetector](https://github.com/andylizi/haproxy-detector) 插件来解决。 +如果你有特殊需求，需要同时支持直连和 PROXY protocol 的话，请安装 [HAProxyDetector](https://github.com/andylizi/haproxy-detector) 插件来解决。 对于较高的版本，请使用 [HaHaWTH 的 fork 版本](https://github.com/HaHaWTH/HAProxy-Detector)。 diff --git "a/docs/advance/Linux/_images/Linux\345\274\200\346\234\215/\345\274\200\346\234\215/1.png" "b/docs/advance/linux/_images/Linux\345\274\200\346\234\215/\345\274\200\346\234\215/1.png" similarity index 100% rename from "docs/advance/Linux/_images/Linux\345\274\200\346\234\215/\345\274\200\346\234\215/1.png" rename to "docs/advance/linux/_images/Linux\345\274\200\346\234\215/\345\274\200\346\234\215/1.png" diff --git "a/docs/advance/Linux/_images/Linux\345\274\200\346\234\215/\345\274\200\346\234\215/2.png" "b/docs/advance/linux/_images/Linux\345\274\200\346\234\215/\345\274\200\346\234\215/2.png" similarity index 100% rename from "docs/advance/Linux/_images/Linux\345\274\200\346\234\215/\345\274\200\346\234\215/2.png" rename to "docs/advance/linux/_images/Linux\345\274\200\346\234\215/\345\274\200\346\234\215/2.png" diff --git "a/docs/advance/Linux/_images/Linux\345\274\200\346\234\215/\345\274\200\346\234\215/3.png" "b/docs/advance/linux/_images/Linux\345\274\200\346\234\215/\345\274\200\346\234\215/3.png" similarity index 100% rename from "docs/advance/Linux/_images/Linux\345\274\200\346\234\215/\345\274\200\346\234\215/3.png" rename to "docs/advance/linux/_images/Linux\345\274\200\346\234\215/\345\274\200\346\234\215/3.png" diff --git "a/docs/advance/Linux/_images/Linux\345\274\200\346\234\215/\345\274\200\346\234\215/4.png" "b/docs/advance/linux/_images/Linux\345\274\200\346\234\215/\345\274\200\346\234\215/4.png" similarity index 100% rename from "docs/advance/Linux/_images/Linux\345\274\200\346\234\215/\345\274\200\346\234\215/4.png" rename to "docs/advance/linux/_images/Linux\345\274\200\346\234\215/\345\274\200\346\234\215/4.png" diff --git "a/docs/advance/Linux/_images/Linux\345\274\200\346\234\215/\345\274\200\346\234\215/5.png" "b/docs/advance/linux/_images/Linux\345\274\200\346\234\215/\345\274\200\346\234\215/5.png" similarity index 100% rename from "docs/advance/Linux/_images/Linux\345\274\200\346\234\215/\345\274\200\346\234\215/5.png" rename to "docs/advance/linux/_images/Linux\345\274\200\346\234\215/\345\274\200\346\234\215/5.png" diff --git "a/docs/advance/Linux/_images/Linux\345\274\200\346\234\215/\345\274\200\346\234\215/6.png" "b/docs/advance/linux/_images/Linux\345\274\200\346\234\215/\345\274\200\346\234\215/6.png" similarity index 100% rename from "docs/advance/Linux/_images/Linux\345\274\200\346\234\215/\345\274\200\346\234\215/6.png" rename to "docs/advance/linux/_images/Linux\345\274\200\346\234\215/\345\274\200\346\234\215/6.png" diff --git "a/docs/advance/Linux/_images/Linux\345\274\200\346\234\215/\345\274\200\346\234\215/7.png" "b/docs/advance/linux/_images/Linux\345\274\200\346\234\215/\345\274\200\346\234\215/7.png" similarity index 100% rename from "docs/advance/Linux/_images/Linux\345\274\200\346\234\215/\345\274\200\346\234\215/7.png" rename to "docs/advance/linux/_images/Linux\345\274\200\346\234\215/\345\274\200\346\234\215/7.png" diff --git "a/docs/advance/Linux/_images/Linux\345\274\200\346\234\215/\345\274\200\346\234\215/8.png" "b/docs/advance/linux/_images/Linux\345\274\200\346\234\215/\345\274\200\346\234\215/8.png" similarity index 100% rename from "docs/advance/Linux/_images/Linux\345\274\200\346\234\215/\345\274\200\346\234\215/8.png" rename to "docs/advance/linux/_images/Linux\345\274\200\346\234\215/\345\274\200\346\234\215/8.png" diff --git "a/docs/advance/Linux/_images/Linux\345\274\200\346\234\215/\346\220\255\345\273\272\345\206\205\347\275\221\347\251\277\351\200\217/1.png" "b/docs/advance/linux/_images/Linux\345\274\200\346\234\215/\346\220\255\345\273\272\345\206\205\347\275\221\347\251\277\351\200\217/1.png" similarity index 100% rename from "docs/advance/Linux/_images/Linux\345\274\200\346\234\215/\346\220\255\345\273\272\345\206\205\347\275\221\347\251\277\351\200\217/1.png" rename to "docs/advance/linux/_images/Linux\345\274\200\346\234\215/\346\220\255\345\273\272\345\206\205\347\275\221\347\251\277\351\200\217/1.png" diff --git "a/docs/advance/Linux/_images/Linux\345\274\200\346\234\215/\346\220\255\345\273\272\345\206\205\347\275\221\347\251\277\351\200\217/2.png" "b/docs/advance/linux/_images/Linux\345\274\200\346\234\215/\346\220\255\345\273\272\345\206\205\347\275\221\347\251\277\351\200\217/2.png" similarity index 100% rename from "docs/advance/Linux/_images/Linux\345\274\200\346\234\215/\346\220\255\345\273\272\345\206\205\347\275\221\347\251\277\351\200\217/2.png" rename to "docs/advance/linux/_images/Linux\345\274\200\346\234\215/\346\220\255\345\273\272\345\206\205\347\275\221\347\251\277\351\200\217/2.png" diff --git "a/docs/advance/Linux/_images/Linux\345\274\200\346\234\215/\346\220\255\345\273\272\345\206\205\347\275\221\347\251\277\351\200\217/3.png" "b/docs/advance/linux/_images/Linux\345\274\200\346\234\215/\346\220\255\345\273\272\345\206\205\347\275\221\347\251\277\351\200\217/3.png" similarity index 100% rename from "docs/advance/Linux/_images/Linux\345\274\200\346\234\215/\346\220\255\345\273\272\345\206\205\347\275\221\347\251\277\351\200\217/3.png" rename to "docs/advance/linux/_images/Linux\345\274\200\346\234\215/\346\220\255\345\273\272\345\206\205\347\275\221\347\251\277\351\200\217/3.png" diff --git "a/docs/advance/Linux/_images/Linux\345\274\200\346\234\215/\346\220\255\345\273\272\345\206\205\347\275\221\347\251\277\351\200\217/4.png" "b/docs/advance/linux/_images/Linux\345\274\200\346\234\215/\346\220\255\345\273\272\345\206\205\347\275\221\347\251\277\351\200\217/4.png" similarity index 100% rename from "docs/advance/Linux/_images/Linux\345\274\200\346\234\215/\346\220\255\345\273\272\345\206\205\347\275\221\347\251\277\351\200\217/4.png" rename to "docs/advance/linux/_images/Linux\345\274\200\346\234\215/\346\220\255\345\273\272\345\206\205\347\275\221\347\251\277\351\200\217/4.png" diff --git "a/docs/advance/Linux/_images/Linux\345\274\200\346\234\215/\346\225\260\346\215\256\345\272\223\345\256\211\350\243\205/1.png" "b/docs/advance/linux/_images/Linux\345\274\200\346\234\215/\346\225\260\346\215\256\345\272\223\345\256\211\350\243\205/1.png" similarity index 100% rename from "docs/advance/Linux/_images/Linux\345\274\200\346\234\215/\346\225\260\346\215\256\345\272\223\345\256\211\350\243\205/1.png" rename to "docs/advance/linux/_images/Linux\345\274\200\346\234\215/\346\225\260\346\215\256\345\272\223\345\256\211\350\243\205/1.png" diff --git "a/docs/advance/Linux/_images/Linux\345\274\200\346\234\215/\346\225\260\346\215\256\345\272\223\345\256\211\350\243\205/2.png" "b/docs/advance/linux/_images/Linux\345\274\200\346\234\215/\346\225\260\346\215\256\345\272\223\345\256\211\350\243\205/2.png" similarity index 100% rename from "docs/advance/Linux/_images/Linux\345\274\200\346\234\215/\346\225\260\346\215\256\345\272\223\345\256\211\350\243\205/2.png" rename to "docs/advance/linux/_images/Linux\345\274\200\346\234\215/\346\225\260\346\215\256\345\272\223\345\256\211\350\243\205/2.png" diff --git "a/docs/advance/Linux/_images/Linux\345\274\200\346\234\215/\346\225\260\346\215\256\345\272\223\345\256\211\350\243\205/3.png" "b/docs/advance/linux/_images/Linux\345\274\200\346\234\215/\346\225\260\346\215\256\345\272\223\345\256\211\350\243\205/3.png" similarity index 100% rename from "docs/advance/Linux/_images/Linux\345\274\200\346\234\215/\346\225\260\346\215\256\345\272\223\345\256\211\350\243\205/3.png" rename to "docs/advance/linux/_images/Linux\345\274\200\346\234\215/\346\225\260\346\215\256\345\272\223\345\256\211\350\243\205/3.png" diff --git "a/docs/advance/Linux/_images/Linux\345\274\200\346\234\215/\346\225\260\346\215\256\345\272\223\345\256\211\350\243\205/4.png" "b/docs/advance/linux/_images/Linux\345\274\200\346\234\215/\346\225\260\346\215\256\345\272\223\345\256\211\350\243\205/4.png" similarity index 100% rename from "docs/advance/Linux/_images/Linux\345\274\200\346\234\215/\346\225\260\346\215\256\345\272\223\345\256\211\350\243\205/4.png" rename to "docs/advance/linux/_images/Linux\345\274\200\346\234\215/\346\225\260\346\215\256\345\272\223\345\256\211\350\243\205/4.png" diff --git "a/docs/advance/Linux/_images/Linux\345\274\200\346\234\215/\346\225\260\346\215\256\345\272\223\345\256\211\350\243\205/5.png" "b/docs/advance/linux/_images/Linux\345\274\200\346\234\215/\346\225\260\346\215\256\345\272\223\345\256\211\350\243\205/5.png" similarity index 100% rename from "docs/advance/Linux/_images/Linux\345\274\200\346\234\215/\346\225\260\346\215\256\345\272\223\345\256\211\350\243\205/5.png" rename to "docs/advance/linux/_images/Linux\345\274\200\346\234\215/\346\225\260\346\215\256\345\272\223\345\256\211\350\243\205/5.png" diff --git "a/docs/advance/Linux/_images/Linux\345\274\200\346\234\215/\346\225\260\346\215\256\345\272\223\345\256\211\350\243\205/6.png" "b/docs/advance/linux/_images/Linux\345\274\200\346\234\215/\346\225\260\346\215\256\345\272\223\345\256\211\350\243\205/6.png" similarity index 100% rename from "docs/advance/Linux/_images/Linux\345\274\200\346\234\215/\346\225\260\346\215\256\345\272\223\345\256\211\350\243\205/6.png" rename to "docs/advance/linux/_images/Linux\345\274\200\346\234\215/\346\225\260\346\215\256\345\272\223\345\256\211\350\243\205/6.png" diff --git "a/docs/advance/Linux/_images/Linux\345\274\200\346\234\215/\346\225\260\346\215\256\345\272\223\345\256\211\350\243\205/7.png" "b/docs/advance/linux/_images/Linux\345\274\200\346\234\215/\346\225\260\346\215\256\345\272\223\345\256\211\350\243\205/7.png" similarity index 100% rename from "docs/advance/Linux/_images/Linux\345\274\200\346\234\215/\346\225\260\346\215\256\345\272\223\345\256\211\350\243\205/7.png" rename to "docs/advance/linux/_images/Linux\345\274\200\346\234\215/\346\225\260\346\215\256\345\272\223\345\256\211\350\243\205/7.png" diff --git "a/docs/advance/Linux/_images/Linux\345\274\200\346\234\215/\350\277\236\346\216\245\346\234\215\345\212\241\345\231\250/1.png" "b/docs/advance/linux/_images/Linux\345\274\200\346\234\215/\350\277\236\346\216\245\346\234\215\345\212\241\345\231\250/1.png" similarity index 100% rename from "docs/advance/Linux/_images/Linux\345\274\200\346\234\215/\350\277\236\346\216\245\346\234\215\345\212\241\345\231\250/1.png" rename to "docs/advance/linux/_images/Linux\345\274\200\346\234\215/\350\277\236\346\216\245\346\234\215\345\212\241\345\231\250/1.png" diff --git "a/docs/advance/Linux/_images/Linux\345\274\200\346\234\215/\350\277\236\346\216\245\346\234\215\345\212\241\345\231\250/2.png" "b/docs/advance/linux/_images/Linux\345\274\200\346\234\215/\350\277\236\346\216\245\346\234\215\345\212\241\345\231\250/2.png" similarity index 100% rename from "docs/advance/Linux/_images/Linux\345\274\200\346\234\215/\350\277\236\346\216\245\346\234\215\345\212\241\345\231\250/2.png" rename to "docs/advance/linux/_images/Linux\345\274\200\346\234\215/\350\277\236\346\216\245\346\234\215\345\212\241\345\231\250/2.png" diff --git "a/docs/advance/Linux/_images/Linux\345\274\200\346\234\215/\350\277\236\346\216\245\346\234\215\345\212\241\345\231\250/WindTerm.png" "b/docs/advance/linux/_images/Linux\345\274\200\346\234\215/\350\277\236\346\216\245\346\234\215\345\212\241\345\231\250/WindTerm.png" similarity index 100% rename from "docs/advance/Linux/_images/Linux\345\274\200\346\234\215/\350\277\236\346\216\245\346\234\215\345\212\241\345\231\250/WindTerm.png" rename to "docs/advance/linux/_images/Linux\345\274\200\346\234\215/\350\277\236\346\216\245\346\234\215\345\212\241\345\231\250/WindTerm.png" diff --git "a/docs/advance/Linux/_images/Linux\345\274\200\346\234\215/\350\277\236\346\216\245\346\234\215\345\212\241\345\231\250/macOS_terminal.png" "b/docs/advance/linux/_images/Linux\345\274\200\346\234\215/\350\277\236\346\216\245\346\234\215\345\212\241\345\231\250/macOS_terminal.png" similarity index 100% rename from "docs/advance/Linux/_images/Linux\345\274\200\346\234\215/\350\277\236\346\216\245\346\234\215\345\212\241\345\231\250/macOS_terminal.png" rename to "docs/advance/linux/_images/Linux\345\274\200\346\234\215/\350\277\236\346\216\245\346\234\215\345\212\241\345\231\250/macOS_terminal.png" diff --git "a/docs/advance/Linux/_images/Linux\345\274\200\346\234\215/\350\277\236\346\216\245\346\234\215\345\212\241\345\231\250/termux_screenshot.jpg" "b/docs/advance/linux/_images/Linux\345\274\200\346\234\215/\350\277\236\346\216\245\346\234\215\345\212\241\345\231\250/termux_screenshot.jpg" similarity index 100% rename from "docs/advance/Linux/_images/Linux\345\274\200\346\234\215/\350\277\236\346\216\245\346\234\215\345\212\241\345\231\250/termux_screenshot.jpg" rename to "docs/advance/linux/_images/Linux\345\274\200\346\234\215/\350\277\236\346\216\245\346\234\215\345\212\241\345\231\250/termux_screenshot.jpg" diff --git a/docs/advance/Linux/backup.md b/docs/advance/linux/backup.md similarity index 92% rename from docs/advance/Linux/backup.md rename to docs/advance/linux/backup.md index 828481555..b4c7a8044 100644 --- a/docs/advance/Linux/backup.md +++ b/docs/advance/linux/backup.md @@ -3,7 +3,9 @@ title: 自动备份存档 sidebar_position: 8 --- -# 编写备份脚本 +# 自动备份存档 + +## 编写备份脚本 在你的服务器上创建一个备份脚本： @@ -19,9 +21,9 @@ sudo vim /root/backup.sh usage() { echo "用法: $0 --server-dir <存档路径> --backup-dir <备份文件保存目录> [--max-backups <最大备份文件数>]" echo "参数:" - echo " --server-dir, -s: 服务器目录(绝对路径)" - echo " --backup-dir, -b: 备份文件保存目录(绝对路径)" - echo " --max-backups, -m: 最大备份文件数,选填(默认: 5)" + echo " --server-dir, -s: 服务器目录 (绝对路径)" + echo " --backup-dir, -b: 备份文件保存目录 (绝对路径)" + echo " --max-backups, -m: 最大备份文件数，选填 (默认: 5)" exit 1 } @@ -99,7 +101,7 @@ fi 按 `Esc` 键，切换到英文输入法输入 `:wq` 保存并退出。 -# 将备份脚本添加到定时任务 +## 将备份脚本添加到定时任务 编辑定时任务： @@ -145,8 +147,10 @@ crontab -e -> 如果你恢复存档后启动服务器报错： +> 如果你恢复存档后启动服务器出现以下报错： +> > `[main/FATAL]: Failed to start the minecraft server net.minecraft.util.SessionLock$ExceptionWorldConfict: /home/minecraft/lobby/./world/session.lock: already locked (possibly by other Minecraft instance?)` +> > 请检查 `world` 存档下是否存在 `session.lock` 文件，如果存在请删除，然后重启服务器。 diff --git a/docs/advance/Linux/Connect-to-server.md b/docs/advance/linux/connect-to-server.md similarity index 53% rename from docs/advance/Linux/Connect-to-server.md rename to docs/advance/linux/connect-to-server.md index 7e1565304..d66aa0271 100644 --- a/docs/advance/Linux/Connect-to-server.md +++ b/docs/advance/linux/connect-to-server.md @@ -5,56 +5,56 @@ sidebar_position: 2 # 连接服务器 -Linux 系统上有一个工具被业界广泛使用，它就是 `ssh`。它虽然不能远程控制桌面，但是可以远程登录服务器的命令行，并让服务器执行一些命令。由于 `ssh` 非常常用，现在很多 Linux 发行版都已经默认集成了这个命令。 +Linux 系统上有一个工具被业界广泛使用，它就是 **SSH**。它虽然不能远程控制桌面，但是可以远程登录服务器的命令行，并让服务器执行一些命令。由于 `ssh` 命令非常常用，现在很多 Linux 发行版都已经默认集成了这个命令。 目前使用最广的提供 ssh 命令的软件是 **OpenSSH**。 -## 开启 ssh 服务 +## 开启 SSH 服务 -为了让客户能顺利连接服务器，云服务器的 sshd 服务一般默认开启。如果你使用的是家里云，或者云服务器的 sshd 服务确实没有开启 (比如你是只能通过服务商提供的 VNC 或者第三方远控软件连接的服务器，无法使用 ssh)，那么你可能需要先开启 sshd 服务才能连接到服务器。 -在主流的使用 Systemd 的 Linux 发行版中，执行`systemctl enable --now sshd`命令即可开启 sshd 服务，如果这些命令都报错，证明 sshd 服务存在问题，你可以把报错复制粘贴到搜索引擎上查询怎么修复这个问题。 +为了让客户能顺利连接服务器，云服务器的 sshd 服务一般默认开启。如果你使用的是家里云，或者云服务器的 sshd 服务确实没有开启 (比如你是只能通过服务商提供的 VNC 或者第三方远控软件连接的服务器，无法使用 SSH)，那么你可能需要先开启 sshd 服务才能连接到服务器。 +在主流的使用 systemd 的 Linux 发行版中，执行 `systemctl enable --now sshd` 命令即可开启 sshd 服务，如果这些命令都报错，证明 sshd 服务存在问题，你可以把报错复制粘贴到搜索引擎上查询怎么修复这个问题。 开启 sshd 服务后，你就可以连接到这台服务器了。 -成功开启 ssh 服务后，如果要从公网连接，你还需要把 ssh 服务的端口`22`开放到公网。开放的方法与开放 Windows 的远程桌面端口的方式完全相同，但是协议只需要 TCP 即可。 +成功开启 SSH 服务后，如果要从公网连接，你还需要把 SSH 服务的端口 `22` 开放到公网。开放的方法与开放 Windows 的远程桌面端口的方式完全相同，但是协议只需要 TCP 即可。 -::: warn +:::warning -为了安全请不要在服务器上允许 root 用户登录 ssh！如果 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) ::: :::danger -配置直接在公网使用 22 端口连接服务器 ssh**会导致严重的安全性问题**，详见[如何抵御网络攻击](../../process/maintenance/how-to-defend-against-cyber-attacks.md)。 +配置直接在公网使用 22 端口连接服务器 SSH **会导致严重的安全性问题**，详见 [如何抵御网络攻击](../../process/maintenance/how-to-defend-against-cyber-attacks.md)。 -另外除非有明确需求，不要随意配置 UDP 协议端口映射，包括上文中提到的**不需要 UDP 协议**的 ssh，否则可能导致你的服务器被 DDoS！详见[如何抵御网络攻击](../../process/maintenance/how-to-defend-against-cyber-attacks.md)。 +另外除非有明确需求，不要随意配置 UDP 协议端口映射，包括上文中提到的 **不需要 UDP 协议** 的 SSH，否则可能导致你的服务器被 DDoS！详见 [如何抵御网络攻击](../../process/maintenance/how-to-defend-against-cyber-attacks.md)。 ::: -## 连接 ssh 服务 +## 连接 SSH 服务 ### Linux 的 ssh 命令 -就像 Windows 不用安装任何软件就能连接 Windows 的远程桌面一样，Linux 也内置了连接 ssh 的方式，直接执行 ssh 命令即可连接。它的语法如下： +就像 Windows 不用安装任何软件就能连接 Windows 的远程桌面一样，Linux 也内置了连接 SSH 的方式，直接执行 ssh 命令即可连接。它的语法如下： -```shell +```bash ssh @
[-p port] ``` -如何要指定端口，你需要指定端口参数。在一些操作系统上这个参数是`-p`，例如`ssh root@8aka.org -p 48291`，有一些工具上则是直接在后面输入端口。 -例如 Xshell 是`ssh root@8aka.org 48291`。 -你需要根据不同的工具的使用方式来确定 ssh 的命令格式。比如，你可以仅执行 `ssh` 命令 (等价于 `ssh --help`)，然后让 ssh 工具提示你如何使用当前工具的这个命令，如果需要更详细的说明可以输入命令 `man ssh` +如何要指定端口，你需要指定端口参数。在一些操作系统上这个参数是 `-p`，例如`ssh root@8aka.org -p 48291`，有一些工具上则是直接在后面输入端口。 +例如 Xshell 是 `ssh root@8aka.org 48291`。 +你需要根据不同的工具的使用方式来确定 ssh 的命令格式。比如，你可以仅执行 `ssh` 命令 (等价于 `ssh --help`)，然后让 SSH 工具提示你如何使用当前工具的这个命令，如果需要更详细的说明可以输入命令 `man ssh` 在输入完这行命令后，服务器通常会要求你输入该用户的密码。 -如果你不想手动输密码，可以使用**密钥登录**，这种方法更安全且通常更难以被破解，其步骤为： +如果你不想手动输密码，可以使用 **密钥登录** ，这种方法更安全且通常更难以被破解，其步骤为： -1. 使用 `ssh-keygen` 命令生成你的 ssh 密钥。 +1. 使用 `ssh-keygen` 命令生成你的 SSH 密钥。 -2. 使用如 `cat .ssh/id_xxxx.pub` 命令来获取你生成的 ssh 公钥 (此命令中`xxxx`的值通常取决于你生成密钥对时选择的算法) +2. 使用如 `cat .ssh/id_xxxx.pub` 命令来获取你生成的 SSH 公钥 (此命令中 `xxxx` 的值通常取决于你生成密钥对时选择的算法) 3. 在服务器对应用户的家目录下创建 `./ssh/authorized_keys`，编辑它，将你的公钥粘贴进去，每个公钥独占一行 @@ -68,13 +68,13 @@ import Tabs from '@theme/Tabs'; import TabItem from '@theme/TabItem'; - + ![](_images/Linux开服/连接服务器/1.png) -Windows 系统自带的 Powershell +Windows 系统自带的 PowerShell -按下 `Win + R` 输入 `powershell` 即可 (如果安装了新版的 Powershell 那么你应该输入`pwsh`) +按下 `Win + R` 输入 `powershell` 即可 (如果安装了新版的 PowerShell 那么你应该输入 `pwsh`) 随后在其中输入 `ssh -p @` 即可连接 Linux 服务器。 @@ -82,7 +82,7 @@ Windows 系统自带的 Powershell :::tip -port 输入服务器的 ssh 端口 +port 输入服务器的 SSH 端口 username 为登录服务器的用户名 @@ -95,48 +95,48 @@ hostname 为服务器的域名或者 IP ![WindTerm](_images/Linux开服/连接服务器/WindTerm.png) -一个开源的 SSH/Telnet/Serial/Shell/Sftp 客户端工具 +一个开源的 SSH/Telnet/Serial/Shell/SFTP 客户端工具 https://github.com/kingToolbox/WindTerm -![finalshell 终端](_images/Linux开服/连接服务器/2.png) +![FinalShell 终端](_images/Linux开服/连接服务器/2.png) -FinalShell 是一体化的的服务器，网络管理软件，不仅是 ssh 客户端，还是功能强大的开发，运维工具，充分满足开发，运维需求。 +FinalShell 是一体化的的服务器，网络管理软件，不仅是 SSH 客户端，还是功能强大的开发，运维工具，充分满足开发，运维需求。 -![xshell 终端](https://www.xshell.com/wp-content/uploads/2020/10/p-xshell7-top-zh.png) +![Xshell 终端](https://www.xshell.com/wp-content/uploads/2020/10/p-xshell7-top-zh.png) 他称自己是 业界最强大的 SSH 客户机 - + -你需要安装 termux 这个软件。你可以去 Google Play 下载，也可以去[它的开源地址](https://github.com/termux/termux-app)下载。 +你需要安装 Termux 这个软件。你可以去 Google Play 下载，也可以去 [它的开源地址](https://github.com/termux/termux-app) 下载。 安装好之后，打开软件就是命令行，随后直接使用 ssh 命令即可连接。 -![termux 终端](_images/Linux开服/连接服务器/termux_screenshot.jpg) +![Termux 终端](_images/Linux开服/连接服务器/termux_screenshot.jpg) - + -macOS 内置 ssh 命令，我们可以用终端来执行它。要打开 macos 上的终端，可以使用以下方式： +macOS 内置 ssh 命令，我们可以用终端来执行它。要打开 macOS 上的终端，可以使用以下方式： - (如果终端 app 没有被移动过) 打开启动台，打开第一页的其他文件夹，点击终端。或者你也可以在应用文件夹 (入口默认固定在访达侧边栏上) 里找到它。 - 按下 command+ 空格或键盘上的搜索键唤起 spotlight，输入“终端”，然后它就会显示在下面。 -![macos 终端](_images/Linux开服/连接服务器/macOS_terminal.png) +![macOS 终端](_images/Linux开服/连接服务器/macOS_terminal.png) 打开终端后，使用上文中提到的 ssh 命令即可连接到服务器。 -除了用 ssh 连接服务器之外，还有可以使用远程桌面。比如 VNC 和 RDP。服务器上一般不配备桌面环境和远程桌面环境，除非是非常需要，否则不建议在服务器上使用远程桌面。 +除了用 SSH 连接服务器之外，还有可以使用远程桌面。比如 VNC 和 RDP。服务器上一般不配备桌面环境和远程桌面环境，除非是非常需要，否则不建议在服务器上使用远程桌面。 关于桌面环境和远程桌面服务器的搭建，本文档不给予详细阐释，需要者可自行上网搜索相关内容。 diff --git a/docs/advance/Linux/Database-installation.MD b/docs/advance/linux/database-installation.md similarity index 79% rename from docs/advance/Linux/Database-installation.MD rename to docs/advance/linux/database-installation.md index 149254a6f..e47d93a09 100644 --- a/docs/advance/Linux/Database-installation.MD +++ b/docs/advance/linux/database-installation.md @@ -11,13 +11,13 @@ sidebar_position: 5 ### 安装 -在[官方网站](https://dev.mysql.com/downloads/repo/apt/)页面下载 `mysql-apt-config_0.8.301_all.deb` +在 [官方网站](https://dev.mysql.com/downloads/repo/apt/) 页面下载 `mysql-apt-config_0.8.301_all.deb` -这个包是一个配置APT 的 MySQL 仓库。安装 mysql-apt-config 后，用户可以选择想要安装的 MySQL 版本。 +这个包是一个配置 APT 的 MySQL 仓库。安装 `mysql-apt-config` 后，用户可以选择想要安装的 MySQL 版本。 将文件传入服务器 `/opt` 目录下，输入以下指令安装： -``` +```bash dpkg -i mysql-apt-config_0.8.30-1_all.deb ``` @@ -25,13 +25,13 @@ dpkg -i mysql-apt-config_0.8.30-1_all.deb 安装完成后使用以下指令更新软件包列表： -``` +```bash sudo apt update ``` -随后进行 MySQL server (即 MySQL 服务)的安装，输入以下指令安装 MySQL： +随后进行 MySQL Server (即 MySQL 服务) 的安装，输入以下指令安装 MySQL： -``` +```bash apt install mysql-community-server -y ``` @@ -39,22 +39,22 @@ apt install mysql-community-server -y MySQL 默认会自带随机密码，所以等待安装完成后需输入以下指令查看初始密码： -``` +```bash mysqld --initialize –console ``` ![](_images/Linux开服/数据库安装/3.png) -红框部分就是初始密码，安装已经完毕，接下来启动并 将 MySQL设为开机自启动，分别输入 +红框部分就是初始密码，安装已经完毕，接下来启动并 将 MySQL 设为开机自启动，分别输入 -``` +```bash systemctl start mysql systemctl enable mysql ``` 启动 MySQL 服务后，输入以下指令进入 MySQL 指令行： -``` +```bash mysql -uroot -p ``` @@ -64,13 +64,13 @@ mysql -uroot -p 输入修改密码指令： -``` +```sql ALTER user 'root'@'localhost' IDENTIFIED BY 'NewPassword'; ``` 将 NewPassword 修改为你自己设置的密码 -**至此，MySQL 安装已经完成** +**至此，MySQL 安装已经完成。** ### 创建表 @@ -80,7 +80,7 @@ ALTER user 'root'@'localhost' IDENTIFIED BY 'NewPassword'; ::: -``` +```sql CREATE DATABASE IF NOT EXISTS XXX DEFAULT CHARACTER SET utf8mb4; ``` @@ -88,13 +88,13 @@ CREATE DATABASE IF NOT EXISTS XXX DEFAULT CHARACTER SET utf8mb4; ### 创建用户 -``` +```sql CREATE USER 'UserName'@'%' IDENTIFIED BY 'Password'; ``` ### 用户授权 -``` +```sql GRANT ALL PRIVILEGES ON 数据库名称.* TO 'UserName'@'%'; ``` @@ -104,7 +104,7 @@ UserName 填写用户名， `%` 代表所有 IP 地址，如果 Minecraft 服务端和数据库处于同一个服务器，建议改成 localhost 以增加安全性， -Password 填写用户的密码(由于安全性设置，密码必须有大小写长度8位以上，并且默认关闭远程访问) +Password 填写用户的密码 (由于安全性设置，密码必须有大小写长度 8 位以上，并且默认关闭远程访问) 如果需要设置密码强度为低，开启远程访问等不安全的操作请自行百度，对于修改安全设置之后的数据库安全问题，本站概不负责 @@ -114,7 +114,7 @@ Password 填写用户的密码(由于安全性设置，密码必须有大小写 依次在终端输入以下指令，分别操作为安装依赖、下载 Redis、将安装包放在安装路径。更新软件包，安装下载好的 Redis -``` +```bash apt install lsb-release curl gpg curl -fsSL https://packages.redis.io/gpg | sudo gpg --dearmor -o /usr/share/keyrings/redis-archive-keyring.gpg echo "deb [signed-by=/usr/share/keyrings/redis-archive-keyring.gpg] https://packages.redis.io/deb $(lsb_release -cs) main" | sudo tee /etc/apt/sources.list.d/redis.list @@ -132,7 +132,7 @@ apt install redis -y :::tip -使用 systemctl enable redis-server 使 Redis 开机自启 +使用 `systemctl enable redis-server` 使 Redis 开机自启 ![](_images/Linux开服/数据库安装/7.png) diff --git a/docs/advance/Linux/keep-running.md b/docs/advance/linux/keep-running.md similarity index 70% rename from docs/advance/Linux/keep-running.md rename to docs/advance/linux/keep-running.md index 3d7c17894..e4eb91631 100644 --- a/docs/advance/Linux/keep-running.md +++ b/docs/advance/linux/keep-running.md @@ -8,16 +8,16 @@ import TabItem from '@theme/TabItem'; # 如何保持服务器在 Linux 服务器中后台运行 -由于 Linux 的会话机制，在 ssh 断开连接之后手动启动的服务端会停止运行，而我们需要服务端保持后台运行。 +由于 Linux 的会话机制，在 SSH 断开连接之后手动启动的服务端会停止运行，而我们需要服务端保持后台运行。 -## 方法一 screen(推荐) +## 方法一 screen (推荐) 使用 screen 创建一个虚拟的窗口运行服务端，首先安装 screen，在终端输入： -确保你的系统上有`screen`包，没有的话安装它们： +确保你的系统上有 `screen` 包，没有的话安装它们： - + ```bash apt-get install screen ``` @@ -36,7 +36,7 @@ import TabItem from '@theme/TabItem'; screen 的基础指令： -```shell +```bash screen -ls # 列出所有的 screen screen -S xxx # 创建一个名叫 xxx 的虚拟窗口 (推荐以每个子服务器命名) screen -r xxx # 进入 xxx 虚拟窗口 (只能进入已创建且无人使用的 screen) @@ -45,27 +45,31 @@ screen -S xxx -X quit # 删除 xxx 窗口 (在 screen 中输入 exit 也可以 ``` :::info -重新连接到 screen 时可以使用 `screen -Dr xxx`指令，意为踢出正在使用 xxx 窗口的用户并回到 xxx 窗口 + +重新连接到 screen 时可以使用 `screen -Dr xxx` 指令，意为踢出正在使用 xxx 窗口的用户并回到 xxx 窗口 + ::: 在 screen 中启动服务端，在 screen 中时，按快捷键 `Ctrl + A + D` 即可返回原窗口。 -:::tip 滚动查看日志 +:::tip[滚动查看日志] + 如果你想在 screen 中向上滚动查看历史日志： - 按 `Ctrl + A + [` 进入复制模式（此时可以使用方向键或 Page Up/Down 键滚动） - 按 `ESC` 退出复制模式 - ::: + +::: 推荐原因：后台运行的同时还可以在服务端控制台中查看日志，打指令 ## 方法二 面板 (推荐) -例如 mcsm，简单无脑可视化 +例如 MCSManager 等面板，简单无脑可视化 -## 方法三 Systemd +## 方法三 systemd -使用 vim 命令创建 mc.service 单元文件 +使用 `vim` 命令创建 `mc.service` 单元文件 ```bash vim ~/.config/systemd/user/mc.service @@ -101,25 +105,25 @@ systemctl --user start mc.service systemctl --user enable mc.service ``` -_可以通过`systemctl --user status mc.service`查看服务运行状态。_ +_可以通过 `systemctl --user status mc.service` 查看服务运行状态。_ [详细设置说明](https://blog.csdn.net/WHQ78164/article/details/132956725) -[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) +[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 和& +## 方法四 nohup 和 & -&：在启动时后面加一个& +&：在启动时后面加一个 `&` -例如：./start.sh & +例如：`./start.sh &` nohup：在启动时前面加上这个 -例如：nohup ./start.sh > run.log 2>&1 & +例如：`nohup ./start.sh > run.log 2>&1 &` 详细参数： @@ -131,12 +135,12 @@ Start.sh: 你需要后台运行的程序 run.log: 运行的日志，或你的文件的输出内容 -& 是一个描述符，如果 1 或 2 前不加&，会被当成一个普通文件。 +& 是一个描述符，如果 1 或 2 前不加 &，会被当成一个普通文件。 -1>&2 意思是把标准输出重定向到标准错误。 +`1>&2` 意思是把标准输出重定向到标准错误。 -2>&1 意思是把标准错误输出重定向到标准输出。 +`2>&1` 意思是把标准错误输出重定向到标准输出。 -&>filename 意思是把标准输出和标准错误输出都重定向到文件 filename 中 +`&>filename` 意思是把标准输出和标准错误输出都重定向到文件 `filename` 中 ::: diff --git a/docs/advance/Linux/Linux.md b/docs/advance/linux/linux.md similarity index 78% rename from docs/advance/Linux/Linux.md rename to docs/advance/linux/linux.md index 529b4033c..5b19b5a57 100644 --- a/docs/advance/Linux/Linux.md +++ b/docs/advance/linux/linux.md @@ -8,8 +8,8 @@ sidebar_position: 1 ## 为什么选择 Linux 开服 -1. 更快的发包速度和接收速度，接入服务器速度将提升数十毫秒起，当面对假人攻击/ DDOS 攻击时会更加稳定； -2. 更好的性能，根据测试 TPS 能提升 8-15 %； +1. 更快的发包速度和接收速度，接入服务器速度将提升数十毫秒起，当面对假人攻击/ DDoS 攻击时会更加稳定； +2. 更好的性能，根据测试 TPS 能提升 8-15%； 3. 更低的内存占用，对于 Windows 服务器一般开机会占用 1-2 GB 内存，而一般的 Linux 系统开机后占用往往不到 0.5 GB； 4. Linux 的稳定性是 Windows 无论如何也无法比拟的； 5. Linux 安全性更高，开源系统，有社区的支持； @@ -17,10 +17,10 @@ sidebar_position: 1 :::info -可能会有小伙伴说：" Linux 太难操作了，根本不会用。" 其实大多数开 Linux 服务器的服主也不是纯纯使用 Linux 编辑插件配置，那么好，我们为小白推荐三个面板辅助我们开服。 +可能会有小伙伴说："Linux 太难操作了，根本不会用。" 其实大多数开 Linux 服务器的服主也不是纯纯使用 Linux 编辑插件配置，那么好，我们为小白推荐三个面板辅助我们开服。 1. [MCSM](https://docs.mcsmanager.com/zh_cn/) 全名 MCSManager 是一款开源，分布式，一键部署，支持 Minecraft 和 Steam 游戏服务器 的控制面板。 -2. [1Panel](https://1panel.cn/) 是新一代的 Linux 服务器运维管理面板，支持 Web 图形界面管理、快速建站、应用商店、安全可靠、一键备份等功能。 +2. [1Panel](https://1panel.cn/) 是新一代的 Linux 服务器运维管理面板，支持 web 图形界面管理、快速建站、应用商店、安全可靠、一键备份等功能。 3. [宝塔面板](https://www.bt.cn/) 是一款支持 Linux 和 Windows 系统的服务器运维管理工具，提供资源监控、文件管理、软件安装等功能。 ::: diff --git a/docs/advance/Linux/start.md b/docs/advance/linux/start.md similarity index 86% rename from docs/advance/Linux/start.md rename to docs/advance/linux/start.md index 29f641622..3d38ee697 100644 --- a/docs/advance/Linux/start.md +++ b/docs/advance/linux/start.md @@ -10,7 +10,7 @@ import TabItem from '@theme/TabItem'; 开服之前，请检查服务器是否安装了 Java，在终端输入 -`java -ver` +`java -version` 如果你看到类似以下的输出，那么服务器中已经安装了 Java @@ -53,7 +53,7 @@ OpenJDK 64-Bit Server VM Zulu21.32+17-CA (build 21.0.2+13-LTS, mixed mode, shari #### SFTP 文件传输 -不熟悉 wget 时，先使用 Windows 前往 [zulu 下载](https://www.azul.com/downloads/?package=jdk#zulu)，下载再使用 SFTP 软件上传到服务器 `/opt` 目录下。 +不熟悉 wget 时，先使用 Windows 前往 [Zulu 下载](https://www.azul.com/downloads/?package=jdk#zulu)，下载再使用 SFTP 软件上传到服务器 `/opt` 目录下。 ![](\_images/Linux 开服/开服/1.png) @@ -83,7 +83,7 @@ OpenJDK 64-Bit Server VM Zulu21.32+17-CA (build 21.0.2+13-LTS, mixed mode, shari 方法很多，这里举出两种 -## 方法一 +### 方法一 update-alternatives --config java @@ -93,15 +93,15 @@ OpenJDK 64-Bit Server VM Zulu21.32+17-CA (build 21.0.2+13-LTS, mixed mode, shari 然后选择你想使用的 Java，接着 `java -version` 验证版本 -## 方法二 +### 方法二 设置别名 -确定你所使用的终端，此处以 `bash` 和 `zulu Java` 为例 +确定你所使用的终端，此处以 `bash` 和 `Azul Zulu` 为例 `vim ~/.bashrc` 在这个文件末尾追加 -```shell +```bash # java alias java8='/usr/lib/jvm/zulu-8/bin/java' alias java17='/usr/lib/jvm/zulu-17/bin/java' @@ -111,13 +111,13 @@ alias java17='/usr/lib/jvm/zulu-17/bin/java' - 使用 Java8 开服： -```shell +```bash java8 -jar example.jar ``` - 使用 Java17 开服： -```shell +```bash java17 -jar example.jar ``` @@ -129,24 +129,24 @@ TODO - 完善和排版 ::: -在/opt 目录中使用 mkdir 创建一个目录用于开服 +在 `/opt` 目录中使用 `mkdir` 命令创建一个目录用于开服 ![](_images/Linux开服/开服/5.png) 将核心放入服务器内，并编写简单的开服脚本 -使用 chmod 命令给脚本增加运行权限 +使用 `chmod` 命令给脚本增加运行权限 -```shell +```bash chmod +x example.sh ``` ![](_images/Linux开服/开服/6.png) -输入./start.sh 或者输入 bash start.sh 即可启动 +输入 `./start.sh` 或者输入 `bash start.sh` 即可启动 ![](_images/Linux开服/开服/7.png) -使用 vim 修改 eula 为 true 就可以开服了 +使用 `vim` 命令修改 eula 为 `true` 就可以开服了 ![](_images/Linux开服/开服/8.png) diff --git a/docs/advance/management/management.md b/docs/advance/management/management.md index 9701a0132..8b4246cd0 100644 --- a/docs/advance/management/management.md +++ b/docs/advance/management/management.md @@ -6,21 +6,31 @@ sidebar_position: 6 # 前言 -学习了开服的理论知识之后，各位服主还需要意识到一件事：开服不仅是一个技术活，它还需要自己的悉心管理和照料。mc 服务器就像一个网游，你不仅是游戏的后台管理员，还是游戏的美术、策划师、运营、项目经理等，或者你也可以选择招募团队，将不同的职位分配给不同的人。 +学习了开服的理论知识之后，各位服主还需要意识到一件事：开服不仅是一个技术活，它还需要自己的悉心管理和照料。MC 服务器就像一个网游，你不仅是游戏的后台管理员，还是游戏的美术、策划师、运营、项目经理等，或者你也可以选择招募团队，将不同的职位分配给不同的人。 -随着相关软件生态的繁荣，有越来越多的新人进入 mc 服务器这个领域。有的人心怀远大理想，有的人觉得开服只是图一乐。至于抱有理想的人可以分为两类：一种是觉得现有服务器不能让自己满意的，一种是想在众人面前展示自己强大能力的。不过有一个事实：虽然开服对于一个已经对游戏已经有一定了解的人来说非常容易，但是对于很多计算机小白来说仍然是非常困难的，他们需要学会文件管理、使用正确的代码编辑器，能看懂英语或者会使用翻译软件，才能勉强运行服务器软件，更别说部署一个服务器了。这个事实导致大部分经验较少的人陷入了一个误区：因为有计算机知识的人和没什么计算机知识的人相比更了解计算机，这使得能顺利运行服务端的人产生了一种错觉：他们已经“高人一等”了，并认为这样就能把一个服务器逐渐开大。然而这样的想法是非常错误的，因为事实上 mc 服务器不止是保持一个软件开启这么简单，它的本质其实是一个网游，涉及到大量更深层次的计算机知识和营销手段，并不是一个人就能完全运营好的。在 b 站开服教程相关的地方我看到有人说：“如果想开一个大服务器，那么建议同时间至少有两到三个管理高强度在线”。 +随着相关软件生态的繁荣，有越来越多的新人进入 MC 服务器这个领域。有的人心怀远大理想，有的人觉得开服只是图一乐。至于抱有理想的人可以分为两类：一种是觉得现有服务器不能让自己满意的，一种是想在众人面前展示自己强大能力的。 -在服务器圈子待了这么长时间，我已经见过了无数服务器由于各种经营不善，长期没人在线甚至删库跑路的事。很多人疑惑不解，他们不知道为什么自己都已经开了服务器，也招了人，但是玩家就不来他们服务器，就去其他的服务器。他们根本不知道从哪里下手解决这个问题。于是服主们的远大理想纷纷泡汤，带着遗憾离开了。这也是 mc 服务器圈子一批一批的服主无视前人的警告前赴后继地跑来开服，遭受打击后又去继续警告后人，然后后人又不听劝的原因。大家对于开服开不起来的原因的认知多数都停留在“我不适合开服”，却不知道为什么自己开不好服。 +不过有一个事实：虽然开服对于一个已经对游戏已经有一定了解的人来说非常容易，但是对于很多计算机小白来说仍然是非常困难的，他们需要学会文件管理、使用正确的代码编辑器，能看懂英语或者会使用翻译软件，才能勉强运行服务器软件，更别说部署一个服务器了。这个事实导致大部分经验较少的人陷入了一个误区：因为有计算机知识的人和没什么计算机知识的人相比更了解计算机，这使得能顺利运行服务端的人产生了一种错觉：他们已经“高人一等”了，并认为这样就能把一个服务器逐渐开大。 + +然而这样的想法是非常错误的，因为事实上 MC 服务器不止是保持一个软件开启这么简单，它的本质其实是一个网游，涉及到大量更深层次的计算机知识和营销手段，并不是一个人就能完全运营好的。在 B 站开服教程相关的地方我看到有人说：“如果想开一个大服务器，那么建议同时间至少有两到三个管理高强度在线”。 + +在服务器圈子待了这么长时间，我已经见过了无数服务器由于各种经营不善，长期没人在线甚至删库跑路的事。很多人疑惑不解，他们不知道为什么自己都已经开了服务器，也招了人，但是玩家就不来他们服务器，就去其他的服务器。他们根本不知道从哪里下手解决这个问题。于是服主们的远大理想纷纷泡汤，带着遗憾离开了。 + +这也是 MC 服务器圈子一批一批的服主无视前人的警告前赴后继地跑来开服，遭受打击后又去继续警告后人，然后后人又不听劝的原因。 +大家对于开服开不起来的原因的认知多数都停留在“我不适合开服”，却不知道为什么自己开不好服。 :::tip -很多时候服务器开不好，都是因为服主**太善良**、**太天真**、**目标太不切实际**。 +很多时候服务器开不好，都是因为服主 **太善良**、**太天真**、**目标太不切实际**。 ::: ## 要学习的内容 -这一章你将不再学习工科方面的各软件操作方式，我们将进入文科和商科的领域，介绍各种经商之道、为人处事的方式。服务器在游戏中被称为“多人模式”，这证明必须要有其他人参与，你的服务器才能兴旺起来。与玩家和同行们更好地相处，并合理地安排服务器的花销，是你继续扩大服务器规模的关键。 +这一章你将不再学习工科方面的各软件操作方式，我们将进入文科和商科的领域，介绍各种经商之道、为人处事的方式。 +服务器在游戏中被称为“多人模式”，这证明必须要有其他人参与，你的服务器才能兴旺起来。 + +与玩家和同行们更好地相处，并合理地安排服务器的花销，是你继续扩大服务器规模的关键。 本章包括以下内容： @@ -30,7 +40,9 @@ sidebar_position: 6 ### 团队管理 -很多时候，光凭你自己是无法胜任一个服务器的所有工作的。你需要招募团队，让大家各自负责擅长的领域，才能让服务器高效地运转起来。你需要学习如何作为一名合格的管理者，合理安排服务器工作人员，并让他们和谐相处，提高他们的工作效率。 +- 很多时候，光凭你自己是无法胜任一个服务器的所有工作的。 +- 你需要招募团队，让大家各自负责擅长的领域，才能让服务器高效地运转起来。 +- 你需要学习如何作为一名合格的管理者，合理安排服务器工作人员，并让他们和谐相处，提高他们的工作效率。 ### 宣传 @@ -42,7 +54,7 @@ sidebar_position: 6 ### 营销 -对于一个优秀的 mc 服务器来说，营销是一大重点内容。你需要知道如何与玩家处理好关系才能提高玩家对你服务器的好感。你还需要知道如何才能在各个服务器的竞争中胜出。 +对于一个优秀的 MC 服务器来说，营销是一大重点内容。你需要知道如何与玩家处理好关系才能提高玩家对你服务器的好感。你还需要知道如何才能在各个服务器的竞争中胜出。 ### 资金管理 @@ -59,7 +71,9 @@ sidebar_position: 6 ### 资金 -资金对于开一个成规模的服务器来说是必不可少的，无论是维持服务器设备、软件和网络资源的运转，还是购买一些服务器需要的工具，钱都是最基本的，至于要用到多少钱，你可以用很少的钱巧妙地支撑起一个规模不小的服务器，也可以豪掷数万元直接开一个精美的大型服务器，但总之完全没有钱是不行的 +资金对于开一个成规模的服务器来说是必不可少的，无论是维持服务器设备、软件和网络资源的运转，还是购买一些服务器需要的工具，钱都是最基本的。 + +至于要用到多少钱，你可以用很少的钱巧妙地支撑起一个规模不小的服务器，也可以豪掷数万元直接开一个精美的大型服务器，但总之完全没有钱是不行的 ### 脑子 @@ -67,7 +81,17 @@ sidebar_position: 6 ### 时间 -你有时间开服吗？很多人都希望开服其实就是把服务器开起来就可以放在那不管了，其实服务器运营所需要的时间比你想象的要多得多，并不是一个服务器的问题只需要几分钟就能解决，一些问题你可能从来没见过，你需要一点一点地搜索资料，排查问题，而这样一排查就是好几个小时，况且服务器一次可能不止出现一个问题，而且一个问题修完了就又出现另一个问题，这样一来就会耽误你大量的时间维护服务器，而且你不止需要处理服务器的技术问题，你还需要费心思给服务器进行宣传，对玩家进行管理，这些又要消耗大量的时间，而如果你不处理这些东西，服务器的情况就会急转直下，玩家需求得不到解决，玩家冲突没有人调解，服务器 bug 没有人修复，游戏体验最终烂成一坨，玩家纷纷离开。而如果你花费大量的时间来维护服务器，那么你的日常生活就会受到影响。对于一名初高中生来说，时间只会分为极其充裕和极其紧张两种：时间紧张的学生，时间安排都在学习或者未来事业相关，可能正在为中高考或者将来的职业努力，如果被 mc 服务器分散了时间，就很可能会对自己的前途造成影响，得不偿失；而时间充裕的学生当然可以给自己找点事干，来开 mc 服务器也没什么。对于一名大学生研究生来说，平时的课业是无论如何都要重视的 (如果你完全不担心毕业和工作那另说)，此外一些人可能因为自己的职业原因，比如必须要考英语四六级、计算机二级、考公、考驾照、考会计证、考教资这些，如果因为 mc 服务器耽误了时间，那么也是会对自己的前途造成很大影响，也是得不偿失。而对于已经工作的人来说，如果工作不忙那当然可以来开服，如果工作很忙，那开服一样地会耽误工作。很多时候你认为 mc 服务器是你自己的一个爱好，但是这个爱好是需要条件的，你需要投入大量的时间和精力到里面，你需要考虑 mc 服务器和自己生活是否冲突，并不是说开就开的。时间还和资金不一样，用不太多的钱一样可以开好服务器，**但是没有大把的时间是一定开不出好服务器的。** +你有时间开服吗？很多人都希望开服其实就是把服务器开起来就可以放在那不管了，其实服务器运营所需要的时间比你想象的要多得多，并不是一个服务器的问题只需要几分钟就能解决。一些问题你可能从来没见过，你需要一点一点地搜索资料，排查问题，而这样一排查就是好几个小时，况且服务器一次可能不止出现一个问题，而且一个问题修完了就又出现另一个问题，这样一来就会耽误你大量的时间维护服务器。 + +而且你不止需要处理服务器的技术问题，你还需要费心思给服务器进行宣传，对玩家进行管理，这些又要消耗大量的时间，而如果你不处理这些东西，服务器的情况就会急转直下，玩家需求得不到解决，玩家冲突没有人调解，服务器 bug 没有人修复，游戏体验最终烂成一坨，玩家纷纷离开。 +而如果你花费大量的时间来维护服务器，那么你的日常生活就会受到影响。 + +对于一名初高中生来说，时间只会分为极其充裕和极其紧张两种：时间紧张的学生，时间安排都在学习或者未来事业相关，可能正在为中高考或者将来的职业努力，如果被 MC 服务器分散了时间，就很可能会对自己的前途造成影响，得不偿失；而时间充裕的学生当然可以给自己找点事干，来开 MC 服务器也没什么。 +对于一名大学生研究生来说，平时的课业是无论如何都要重视的 (如果你完全不担心毕业和工作那另说)，此外一些人可能因为自己的职业原因，比如必须要考英语四六级、计算机二级、考公、考驾照、考会计证、考教资这些，如果因为 MC 服务器耽误了时间，那么也是会对自己的前途造成很大影响，也是得不偿失。 +而对于已经工作的人来说，如果工作不忙那当然可以来开服，如果工作很忙，那开服一样地会耽误工作。 + +很多时候你认为 MC 服务器是你自己的一个爱好，但是这个爱好是需要条件的，你需要投入大量的时间和精力到里面，你需要考虑 MC 服务器和自己生活是否冲突，并不是说开就开的。 +时间还和资金不一样，用不太多的钱一样可以开好服务器，**但是没有大把的时间是一定开不出好服务器的。** ### 游戏经验 @@ -76,14 +100,21 @@ sidebar_position: 6 ### 计算资源 你需要一台电脑来运行服务器软件，这台电脑可以是你自己的电脑，也可以是你购买的云服务器。对于一个没有人的服务器，只需要少量计算资源就可以维持运行，而对于一个有一定规模、经常有很多人在线的服务器，你需要大量的计算资源才能维持服务器运转，因为服务器要处理的玩家数据非常多。 -计算资源这方面东西会在后面细讲，但是你知道需要有一定的计算资源。如果你要用自己的电脑，你需要保证你自己的电脑 24 小时开机，还需要保证它不会受停电或断网影响，也需要保证它不会影响你的日常生活，比如不能放在你自己卧室导致噪音造成你自己睡眠质量下降。至于云服务器则是虽然配置灵活但是想要一台又快又稳定的服务器也是价格不菲。如果你想要花很少的钱租云服务器，那么你的服务器一定会有经常宕机，甚至服务商跑路的风险。之前我就从别人手里低价接手了一年的一台海外服务器，结果才两个月服务商突然告诉我机房寄了，数据全丢，我去找他们要个说法，结果服务商直接重组，高层换人，根本没处说理去。 + +计算资源这方面东西会在后面细讲，但是你知道需要有一定的计算资源。如果你要用自己的电脑，你需要保证你自己的电脑 24 小时开机，还需要保证它不会受停电或断网影响，也需要保证它不会影响你的日常生活，比如不能放在你自己卧室导致噪音造成你自己睡眠质量下降。 + +至于云服务器则是虽然配置灵活但是想要一台又快又稳定的服务器也是价格不菲。如果你想要花很少的钱租云服务器，那么你的服务器一定会有经常宕机，甚至服务商跑路的风险。之前我就从别人手里低价接手了一年的一台海外服务器，结果才两个月服务商突然告诉我机房寄了，数据全丢，我去找他们要个说法，结果服务商直接重组，高层换人，根本没处说理去。 ### 网络资源 很多服主刚入坑的时候还没有意识到一个严重的问题：由于 IPv4 公网地址稀缺，IPv6 又迟迟没有普及，在家用自己的电脑开服务器是很困难的。有的地区可以免费要到公网 IPv4 地址，有的地区要收费，有的地区完全不给。 + 公网 IPv4 可以说是开服必须的配置，如果家里没有公网，那么只能要么转向云服务器要么内网穿透。然而内网穿透也并不是很稳定，主流内网穿透运营商往往走低价路线，虽然价格实惠但是质量可能较差，而自己搭穿透节点往往需要找到符合自己需求的服务器，比云服务器和主流内网穿透的方案都要复杂。 + 解决了 IPv4 的问题之后，你还需要考虑服务器的域名，购买什么样的域名最好，是否要花更多的钱买更好的域名，都是需要考虑的。 ### 耐心 -需要耐心一共体现在两个方面：维护服务器和处理玩家反馈。维护服务器上文已经提到，你需要耗费好几个小时去找一个不一定能被找到而且找到了也不一定能修的 bug。至于玩家反馈，你需要耐心地解答玩家问题，即使是给他们发模板化的消息，也不要破防了对玩家们大喊大叫，那样只会把所有玩家都吓跑。 +需要耐心一共体现在两个方面：维护服务器和处理玩家反馈。维护服务器上文已经提到，你需要耗费好几个小时去找一个不一定能被找到而且找到了也不一定能修的 bug。 + +至于玩家反馈，你需要耐心地解答玩家问题，即使是给他们发模板化的消息，也不要破防了对玩家们大喊大叫，那样只会把所有玩家都吓跑。 diff --git a/docs/advance/management/money-management/investment_psychology.md b/docs/advance/management/money-management/investment-psychology.md similarity index 94% rename from docs/advance/management/money-management/investment_psychology.md rename to docs/advance/management/money-management/investment-psychology.md index ab8d56761..491cd7d76 100644 --- a/docs/advance/management/money-management/investment_psychology.md +++ b/docs/advance/management/money-management/investment-psychology.md @@ -6,12 +6,13 @@ sidebar_position: 2 # 投资心理学 -> “我已经花了 XX 元了，不能就这么停下。” -> “别的服务器都投几千了，我是不是也要冲一波？” -> “我再买几个插件，玩家肯定就会多了。” +> “我已经花了 XX 元了，不能就这么停下。”
+> “别的服务器都投几千了，我是不是也要冲一波？”
+> “我再买几个插件，玩家肯定就会多了。”
> “这波活动/宣传砸下去，肯定能火起来！” -**如果你曾有类似念头，那么恭喜你，你已经走进了投资心理的灰色地带。** +**如果你曾有类似念头，那么恭喜你，你已经走进了投资心理的灰色地带。** + 掌握投资心理学，不是为了让你吝啬每一分钱，而是帮助你在关键时刻保持冷静、做出清醒判断。 ## 常见误区 diff --git a/docs/advance/management/money-management/sustainable-development.md b/docs/advance/management/money-management/sustainable-development.md new file mode 100644 index 000000000..f2ad408e6 --- /dev/null +++ b/docs/advance/management/money-management/sustainable-development.md @@ -0,0 +1,93 @@ +--- +title: 可持续性发展 +slug: /Sundry/Advance/management/money-management/sustainable_development +sidebar_position: 1 +--- + +# 可持续性发展 + +很多新手服务器之所以短命，不是因为技术差或没有人气，而是因为无法在资金、精力、社区建设等方面维持长期的健康运转。 + +可持续发展的目标是：服务器能以稳定、合理的节奏运作下去，无需不断砸钱或依赖短期爆发。 + +## 核心原则 + +### 1. 按能力规划，而非按理想设计 + +> 总想一步到位做出“顶级服务器”，堆砌大量复杂功能、定制内容，远超个人或小团队的维护能力。 + +- **明智做法：** + - 起点简单：从纯净原版或少数几个核心、成熟的轻量插件/模组开始。确保核心玩法稳定、流畅。 + - 渐进式发展：根据实际活跃玩家数量、团队精力、稳定运营时长、资金结余来规划下一步更新。每次只增加 1-2 个能消化的新内容。 + - 质量 > 噱头：玩家更珍视一个稳定、流畅、bug 少的服务器体验。一个完成度高、运行平稳的“小”服，远胜于一个充满半成品和崩溃的“大”服。 +- **关键问题：** + - 这个新功能、模组、活动，我一个人/小团队能长期维护好吗？它真的能提升核心体验吗？还是仅仅看起来很帅？ + +--- + +### 2. 降低依赖性，提高自治力 + +> 过度依赖某个技术大佬、付费外包或朋友临时帮忙，一旦对方没空或离开，服务器立即陷入瘫痪或无法更新。 + +- **明智做法：** + - 自学基础：强制自己学习核心技能，基础服务端操作、核心插件配置、日志查看、玩家数据管理等。网上教程资源极其丰富。 + - 文档是生命线：建立清晰、更新的文档。即使你暂时离开，其他人也能接手。 + - 标准化与模块化：尽量使用标准化的配置方式。插件/模组选择成熟、维护良好的，避免过多深度魔改。 +- **关键问题：** + - 如果明天唯一懂技术的人消失了，服务器能维持基本运转多久？核心信息是否记录在案？ + +--- + +### 3. 靠持续运营，而非短期爆发 + +> 开服初期热情高涨，爆肝几天几夜配置、宣传；热度稍降或遇到问题后迅速倦怠，更新停滞，服务器逐渐凉凉。 + +- **明智做法：** + - 建立节奏感：设定可持续的维护与更新周期。例如每周固定某晚进行小维护、每 2-4 周推出一个小型更新/活动。 + - 留有余力：永远不要把自己/团队逼到极限。预留时间和精力处理突发问题。 + - 关注长期指标：关注玩家留存率、平均在线时长、社区活跃度（如群聊/论坛），而非仅看开服初期的峰值人数。 +- **关键问题：** + - 我当前设定的维护和更新计划，在 3 个月、6 个月后，我还能轻松坚持吗？ + +## 运营建议 + +- **版本选择** + - 优先选择稳定版本，避免过于前沿的测试或实验性构建。 + +- **管理团队** + - 小而精 > 大而散，2-3 个可靠、互补、有共同目标的核心管理员比 10 个挂名 OP 强百倍。 + +- **内容更新** + - 控制节奏，保证质量。例如：每 2-4 周一个主题活动/小游戏/新区域；每 1-2 月一个中型玩法更新。更新后务必预留观察期处理 bug。 + +- **玩家反馈** + - 定期收集建议，用数据判断优先级，而非“谁声音大听谁的”。 + +- **功能设计** + - 能用 > 炫酷，每个新增功能、插件、模组都要问：它解决什么核心问题？维护成本多高？是否与其他系统冲突？警惕功能蔓延带来的维护灾难。 + +- **资金管理** + - 明确主要开销（服务器租金、域名、必要插件/资源）。设定可持续的众筹/赞助模式。记录收支，避免无计划投入。 + +- **风险预案** + - 自动化每日备份，并定期测试恢复。关键配置文件单独备份。制定应对常见危机（炸服、严重 bug、玩家冲突）的流程。 + +## 避坑提示 + +- **警惕“氪金玩家”绑架** + - 不要因为个别玩家投入多就无底线满足其定制需求或破坏服务器平衡。 + +- **避免“用爱发电”耗尽热情** + - 开服是长跑，合理分配精力，该休息时休息，寻找同好分担。 + +- **抵制“盲目跟风”** + - 不要看到某个玩法/模组在其他服火就硬塞进自己的服，需评估是否契合自身定位和承载能力。 + +- **避免“完美主义”** + - 追求“完美”往往导致拖延和无法上线。先推出“够用”的版本，再迭代优化。 + +## 总结 + +可持续性发展不是让你把服务器“做小”，而是让你把它“做稳”。从能力出发、科学规划、留有余力，才能在一次次挑战与成长中积累出真正属于你的服务器与社区核心。 + +哪怕你只有一个人，只要能稳步走下去，依然能成为别人坚持不下去时的“那个例外”。 diff --git a/docs/advance/management/money-management/sustainable_development.md b/docs/advance/management/money-management/sustainable_development.md deleted file mode 100644 index 7c1f4887e..000000000 --- a/docs/advance/management/money-management/sustainable_development.md +++ /dev/null @@ -1,91 +0,0 @@ ---- -title: 可持续性发展 -slug: /Sundry/Advance/management/money-management/sustainable_development -sidebar_position: 1 ---- - -# 可持续性发展 - -很多新手服务器之所以短命，不是因为技术差或没有人气，而是因为无法在资金、精力、社区建设等方面维持长期的健康运转。 -可持续发展的目标是：服务器能以稳定、合理的节奏运作下去，无需不断砸钱或依赖短期爆发。 - -## 核心原则 - -### 1. 按能力规划，而非按理想设计 - -> 总想一步到位做出“顶级服务器”，堆砌大量复杂功能、定制内容，远超个人或小团队的维护能力。 - -- **明智做法：** - - 起点简单：从纯净原版或少数几个核心、成熟的轻量插件/模组开始。确保核心玩法稳定、流畅。 - - 渐进式发展：根据实际活跃玩家数量、团队精力、稳定运营时长、资金结余来规划下一步更新。每次只增加 1-2 个能消化的新内容。 - - 质量 > 噱头：玩家更珍视一个稳定、流畅、BUG 少的服务器体验。一个完成度高、运行平稳的“小”服，远胜于一个充满半成品和崩溃的“大”服。 -- **关键问题：** - - 这个新功能、模组、活动，我一个人/小团队能长期维护好吗？它真的能提升核心体验吗？还是仅仅看起来很帅？ - ---- - -### 2. 降低依赖性，提高自治力 - -> 过度依赖某个技术大佬、付费外包或朋友临时帮忙，一旦对方没空或离开，服务器立即陷入瘫痪或无法更新。 - -- **明智做法：** - - 自学基础：强制自己学习核心技能，基础服务端操作、核心插件配置、日志查看、玩家数据管理等。网上教程资源极其丰富。 - - 文档是生命线：建立清晰、更新的文档。即使你暂时离开，其他人也能接手。 - - 标准化与模块化：尽量使用标准化的配置方式。插件/模组选择成熟、维护良好的，避免过多深度魔改。 -- **关键问题：** - - 如果明天唯一懂技术的人消失了，服务器能维持基本运转多久？核心信息是否记录在案？ - ---- - -### 3. 靠持续运营，而非短期爆发 - -> 开服初期热情高涨，爆肝几天几夜配置、宣传；热度稍降或遇到问题后迅速倦怠，更新停滞，服务器逐渐凉凉。 - -- **明智做法：** - - 建立节奏感：设定可持续的维护与更新周期。例如每周固定某晚进行小维护、每 2-4 周推出一个小型更新/活动。 - - 留有余力：永远不要把自己/团队逼到极限。预留时间和精力处理突发问题。 - - 关注长期指标：关注玩家留存率、平均在线时长、社区活跃度（如群聊/论坛），而非仅看开服初期的峰值人数。 -- **关键问题：** - - 我当前设定的维护和更新计划，在3个月、6个月后，我还能轻松坚持吗？ - -## 运营建议 - -- **版本选择** - - 优先选择稳定版本，避免过于前沿的测试或实验性构建。 - -- **管理团队** - - 小而精 > 大而散，2-3 个可靠、互补、有共同目标的核心管理员比 10 个挂名 OP 强百倍。 - -- **内容更新** - - 控制节奏，保证质量。例如：每 2-4 周一个主题活动/小游戏/新区域；每 1-2 月一个中型玩法更新。更新后务必预留观察期处理 BUG。 - -- **玩家反馈** - - 定期收集建议，用数据判断优先级，而非“谁声音大听谁的”。 - -- **功能设计** - - 能用 > 炫酷，每个新增功能、插件、模组都要问：它解决什么核心问题？维护成本多高？是否与其他系统冲突？警惕功能蔓延带来的维护灾难。 - -- **资金管理** - - 明确主要开销（服务器租金、域名、必要插件/资源）。设定可持续的众筹/赞助模式。记录收支，避免无计划投入。 - -- **风险预案** - - 自动化每日备份，并定期测试恢复。关键配置文件单独备份。制定应对常见危机（炸服、严重BUG、玩家冲突）的流程。 - -## 避坑提示 - -- **警惕“氪金玩家”绑架** - - 不要因为个别玩家投入多就无底线满足其定制需求或破坏服务器平衡。 - -- **避免“用爱发电”耗尽热情** - - 开服是长跑，合理分配精力，该休息时休息，寻找同好分担。 - -- **抵制“盲目跟风”** - - 不要看到某个玩法/模组在其他服火就硬塞进自己的服，需评估是否契合自身定位和承载能力。 - -- **避免“完美主义”** - - 追求“完美”往往导致拖延和无法上线。先推出“够用”的版本，再迭代优化。 - -## 总结 - -可持续性发展不是让你把服务器“做小”，而是让你把它“做稳”。从能力出发、科学规划、留有余力，才能在一次次挑战与成长中积累出真正属于你的服务器与社区核心。 -哪怕你只有一个人，只要能稳步走下去，依然能成为别人坚持不下去时的“那个例外”。 diff --git a/docs/advance/management/player-management/announcement.md b/docs/advance/management/player-management/announcement.md index dc02a679c..dd5225f62 100644 --- a/docs/advance/management/player-management/announcement.md +++ b/docs/advance/management/player-management/announcement.md @@ -6,92 +6,107 @@ sidebar_position: 7 # 服务器公告 -
- 在学习正确发布服务器公告前，请停止这些行为 - -1. **在服务器内发布无意义公告。** - 例如艾特全体成员说“我要玩原神”。除非你和玩家关系很好，玩家们知道你发的不是公告。 -2. **频繁发布公告，尤其是通过机器人频繁地定时艾特全体。** - 例如每天早上艾特全体“早上起床就要来玩服务器！”，上午艾特全体“闲下来就玩服务器！”，中午艾特全体“吃完饭就来玩服务器！”，下午艾特全体“没有事了就来玩服务器！”，晚上艾特全体“睡觉之前来玩服务器！”。这样导致大量的信息充斥在玩家的手机中，影响到他们的日常生活。 -3. **发布公告却在公告中不写明任何公告的摘要。** - 例如先发了一条艾特全体成员但什么都不写 (直接写@全体成员)，然后在下一条消息说公告的具体内容，或者是“@全体成员 看公告”这种。这会导致玩家在手机上收到消息时，不知道这条消息对于自己是否重要，就像新闻标题党给新闻起名《科学家发现惊人秘密！你每天都在做的事情可能致命！》、《震惊！某明星竟然在公共场合做出这种事！》，玩家不知道到底该看还是不该看。 -4. **发布公告但信息不全或含糊其辞。** - 例如发布“有能力可以赞助服务器”却不写明赞助方式和赞助对象、发布“每天晚上进服务器语音频道”却不写明服务器语音频道是什么，怎么进入。 -5. **发布的公告冗长啰嗦。** - 例如发布“众所周知因为我今天下午去我奶家了，然后家里那个服务器不知道因为什么原因就关机了，然后我回去发现是中间停电了，所以下午那阵你们就进不去服务器了”，其实应该写“今天下午服务器因突发停电而关机，现已恢复”。 - -
+## 在学习正确发布服务器公告前，请停止这些行为 + +1. **在服务器内发布无意义公告。** + + 例如艾特全体成员说“我要玩原神”。除非你和玩家关系很好，玩家们知道你发的不是公告。 + +2. **频繁发布公告，尤其是通过机器人频繁地定时艾特全体。** + + 例如每天早上艾特全体“早上起床就要来玩服务器！”，上午艾特全体“闲下来就玩服务器！”，中午艾特全体“吃完饭就来玩服务器！”，下午艾特全体“没有事了就来玩服务器！”，晚上艾特全体“睡觉之前来玩服务器！”。 + + 这样导致大量的信息充斥在玩家的手机中，影响到他们的日常生活。 + +3. **发布公告却在公告中不写明任何公告的摘要。** + + 例如先发了一条艾特全体成员但什么都不写 (直接写@全体成员)，然后在下一条消息说公告的具体内容，或者是“@全体成员 看公告”这种。这会导致玩家在手机上收到消息时，不知道这条消息对于自己是否重要，就像新闻标题党给新闻起名《科学家发现惊人秘密！你每天都在做的事情可能致命！》、《震惊！某明星竟然在公共场合做出这种事！》，玩家不知道到底该看还是不该看。 + +4. **发布公告但信息不全或含糊其辞。** + + 例如发布“有能力可以赞助服务器”却不写明赞助方式和赞助对象、发布“每天晚上进服务器语音频道”却不写明服务器语音频道是什么，怎么进入。 + +5. **发布的公告冗长啰嗦。** + + 例如发布“众所周知因为我今天下午去我奶家了，然后家里那个服务器不知道因为什么原因就关机了，然后我回去发现是中间停电了，所以下午那阵你们就进不去服务器了”，其实应该写“今天下午服务器因突发停电而关机，现已恢复”。 ## 要点 一个好的服务器公告是玩家快速了解服务器重要通知的前提。**要想发布一条简练易懂的公告，你需要掌握以下要点：** -
- 1. 只叙述玩家关心的内容，不需要包含大量技术细节。 +1. **只叙述玩家关心的内容，不需要包含大量技术细节** -例如说“服务器已安装领地插件 Residence，通过/res 指令即可使用”即可 -不需要说“服务器已安装 Residence，这是一款强大的付费插件，拥有强大的权限组功能，目前已经为很多服务器广泛采用”。 + 例如：“服务器已安装领地插件 Residence，通过 `/res` 指令即可使用”即可
+ 不需要：“服务器已安装 Residence，这是一款强大的付费插件，拥有强大的权限组功能，目前已经为很多服务器广泛采用”。 -
+2. **群公告可以幽默，但不能与重要无关的成分占比过高，或过于靠后** -
- 2. 群公告可以幽默，但不能与重要无关的成分占比过高，或过于靠后。 + 例如可以说“服务器逆天玩家太多了，这次安装了 CoreProtect，支持局部回档，发现建筑被熊的不要过于担心，找管理说明情况即可，管理会尽力帮你恢复。爱搞事情的小鬼都给我收着点，以后发现一个 ban 一个”。 -例如可以说“服务器逆天玩家太多了，这次安装了 CoreProtect，支持局部回档，发现建筑被熊的不要过于担心，找管理说明情况即可，管理会尽力帮你恢复。爱搞事情的小鬼都给我收着点，以后发现一个 ban 一个”。 -而不是说“米米世界玩家入侵我们服务器了？服务器逆天玩家太多，把别人的家全都掀飞了。你们米米玩家不知道米米抄袭我们 mc？简直太猖狂了，我要把你们通通制裁！现在我还可以发动服主之力，把你们被毁的家恢复原样，太神奇了！”。 -如果你希望通过幽默和玩家保持良好关系，建议尽可能在聊天中展现，而不是让服务器到处都充满“逆天”发言，导致玩家无法正常地接收服务器的信息。 + 而不是说“米米世界玩家入侵我们服务器了？服务器逆天玩家太多，把别人的家全都掀飞了。你们米米玩家不知道米米抄袭我们 MC？简直太猖狂了，我要把你们通通制裁！现在我还可以发动服主之力，把你们被毁的家恢复原样，太神奇了！” -
+ 如果你希望通过幽默和玩家保持良好关系，建议尽可能在聊天中展现，而不是让服务器到处都充满“逆天”发言，导致玩家无法正常地接收服务器的信息。 -
- 3. 尽可能少发公告，避免浪费玩家时间。 +3. **尽可能少发公告，避免浪费玩家时间** -只要不涉及需要立即发布的公告，就最好挑选合适的时间，将过去几条要发布的公告合并发布。例如你的服务器上午安装了一个插件，中午新增了一条规定，你可以在中午新增规定后再发布“服务器中新增功能 xxx，使用文档 xxx。 -另外服务器中新增了规定 xxx，也就是说你必须 xxx，否则会受到 xxx 处罚。” -而不是上午艾特全体成员说服务器新装了插件，下午又艾特全体成员说服务器有了新规定。 -只有当公告需要立即通知玩家时再将公告单独发布，例如“服务器末地将于明天晚上 8 点重置，请各位玩家及时拿走存放在末地的贵重物品”。 + 只要不涉及需要立即发布的公告，就最好挑选合适的时间，将过去几条要发布的公告合并发布。例如你的服务器上午安装了一个插件，中午新增了一条规定，你可以在中午新增规定后再发布“服务器中新增功能 xxx，使用文档 xxx。 -
+ 另外服务器中新增了规定 xxx，也就是说你必须 xxx，否则会受到 xxx 处罚。” -
- 4. 公告中不要带有不友好的语言。 + 而不是上午艾特全体成员说服务器新装了插件，下午又艾特全体成员说服务器有了新规定。 -比如你不能说“@全体成员 哪个＊＊养村民没完了？服务器都卡出史了，你养你＊呢？”。 + 只有当公告需要立即通知玩家时再将公告单独发布，例如“服务器末地将于明天晚上 8 点重置，请各位玩家及时拿走存放在末地的贵重物品”。 -
+4. **公告中不要带有不友好的语言** + + 比如你不能说“@全体成员 哪个＊＊养村民没完了？服务器都卡出史了，你养你＊呢？”。 ## 形式 公告发布有以下两种方式可以选择： -1. **将公告立即推送至所有人** ，如 QQ 的艾特全体成员，或者服务器的`/title`指令。 - 由于这可能打扰到玩家的日常生活，所以只推荐公告需要及时通知到玩家时使用。例如通知玩家服务器的资源世界将会重置。 -2. **在公告板上发布公告** ，如服务器中的弹窗公告、QQ 群的群公告功能或服务器官网。 - 此公告独立于聊天消息，玩家可以随时查阅，适合发布系统的说明时使用。例如发布服务器 tpa 功能的使用教程。 +1. **将公告立即推送至所有人**，如 QQ 的艾特全体成员，或者服务器的 `/title` 指令。 + + 由于这可能打扰到玩家的日常生活，所以只推荐公告需要及时通知到玩家时使用。例如通知玩家服务器的资源世界将会重置。 + +2. **在公告板上发布公告**，如服务器中的弹窗公告、QQ 群的群公告功能或服务器官网。 + + 此公告独立于聊天消息，玩家可以随时查阅，适合发布系统的说明时使用。例如发布服务器 tpa 功能的使用教程。 这两种方式并非必须二选一，你可以根据公告的性质决定是否要通过其中某种方式发布。有时候你有必要同时通过多种方式发布服务器公告。 ## 示例 ---- +下面三个例子分别展示了不同风格的公告内容，每个示例前都先说明背景和写作重点，帮助你判断何时采用类似语气。 + +### 例：机器人聊天功能恢复 -> 通过新的技术，我们成功恢复了机器人功能。但是出于本群性质，以及机器人帐号安全性的考虑，服务器内向群内发送聊天的功能引入了网易的屏蔽词列表。 -> 如果从服务器内向群内发送消息时未在群内显示，并且可排除机器人自身故障，证明你发送的消息中存在敏感或违规内容，不便在群内展示。 -> 从服务器向群内发送消息在消息前加上英文减号 (-) 即可，例如发送“-我挖到钻石了”。 -> 感谢你的支持与理解。今后也请多多支持《xxx 服务器》。 +- **背景**：通过机器人向群内转发消息，因屏蔽词策略可能无法正常显示。 +- **写法重点**：交代原因、排查方式、补救步骤，并以感谢语气收尾，保持信任感。 + +> 通过新的技术，我们成功恢复了机器人功能。但是出于本群性质，以及机器人帐号安全性的考虑，服务器内向群内发送聊天的功能引入了网易的屏蔽词列表。
+> 如果从服务器内向群内发送消息时未在群内显示，并且可排除机器人自身故障，证明你发送的消息中存在敏感或违规内容，不便在群内展示。
+> 从服务器向群内发送消息在消息前加上英文减号 (-) 即可，例如发送“-我挖到钻石了”。
+> 感谢你的支持与理解。今后也请多多支持《xxx 服务器》。
> (改编自某玩家群) ---- +### 例：捐助与角色分工说明 + +- **背景**：强调捐助为成年人自愿行为，介绍服主和服务器提供者的分工。 +- **写法重点**：先点明是否自愿，再用有序结构说明各自职责，让玩家清楚目标。 -> 🔞全凭自愿！ -> 如果你有能力且为成年人，并且想要捐赠💴我们，那么我们将不胜感激。 -> 请注意，服主与服务器提供者是不同的个体，但他们都致力于公益。以下是他们的分工： -> Qingwmc：负责策划、处理玩家反馈、搭建维护服务器软件等 -> jpjl8845：负责为服务器赞助和维护硬件 -> (收款码图片) +> 🔞 全凭自愿！
+> 如果你有能力且为成年人，并且想要捐赠 💴 我们，那么我们将不胜感激。
+> 请注意，服主与服务器提供者是不同的个体，但他们都致力于公益。以下是他们的分工：
+> Qingwmc：负责策划、处理玩家反馈、搭建维护服务器软件等
+> jpjl8845：负责为服务器赞助和维护硬件
+> (收款码图片)
> (改编自某玩家群) ---- +### 例：惩戒与提醒 + +- **背景**：使用处罚公告加强规则执行，告诉大家不再容忍破坏行为。 +- **写法重点**：用事实佐证处罚并附以劝导语，避免情绪化发言。 > heibao114514 因为四处破坏信标被永久封禁，望各位不要违反服务器规定 > (改编自某玩家群) diff --git a/docs/advance/management/player-management/auditing.md b/docs/advance/management/player-management/auditing.md index 633fe327c..34482068f 100644 --- a/docs/advance/management/player-management/auditing.md +++ b/docs/advance/management/player-management/auditing.md @@ -8,21 +8,25 @@ sidebar_position: 8 对于一个服务器来说，维持良好的玩家社区是非常有必要的。社区的秩序不仅要由管理员监督，也要玩家共同来维护。然而玩家之间素质参差不齐，有些玩家就可以做到和其他人在服务器中合作，但是有些玩家就以破坏为乐，素质极差。为了筛选这些玩家，我们必须要知道以下种类的玩家会不利于玩家社区的发展： -1. **喜欢骂人，甚至以骂人为乐的玩家。** +1. **喜欢骂人，甚至以骂人为乐的玩家** + 虽然有些玩家说话不文明，说话时嘴边总带点脏字，但是如果他不存在不尊重他人的情况，大多数玩家还是可以接受的。多数玩家无法接受的喜欢骂人的玩家通常会自私地维护他自己的观点，与别人观点发生分歧时首先辱骂他人而不是关注谁对谁错。有些玩家还喜欢无缘无故地给侮辱他人，比如给服务器内其他玩家起不恰当的外号、觉得某个玩家的建筑皮肤等不好看就对那个玩家进行羞辱等。 -2. **熊孩子。** + +2. **熊孩子，喜欢搞破坏的玩家** + 熊孩子通常是以在服务器中搞破坏为乐的人。他们喜欢拆家、偷盗、恶作剧等，这些行为严重影响了其他玩家的正常游戏。 -3. **不明事理，不会为他人着想的人。** + +3. **不明事理，不会为他人着想的人** + 在日常生活中，为他人着想、换位思考是我们与他人互相尊重的非常重要的人格品质。在服务器中，有些玩家不知道如何尊重他人，在明知道自己错了却又强行辩解，“像个傻子一样”，让所有人都很尴尬。有时他们也会把随意拿走别人的东西、占有别人的家、借东西不还等行为看作理所应当，在其他人指出他错误时拒不道歉。这样的人非常讨厌，在服务器中也是一样。这些玩家还可能不尊重别人的劳动成果，别人一旦答应他使用某设施，或者同意给他游戏物资帮助他，他不但不说一声谢谢，还从此从别人那里索取，这就是典型的“伸手党”。 ## 审核方式的分类 虽然我们常说小孩子才不懂事，但是现实生活中，这种乳臭未干的成年人也随处可见。如果你希望维护一个纯净、团结的社区，就得尽可能避免这些人进入服务器。进服审核是最有效、最通用的办法。玩家进服审核时通常有以下流程： -1. 玩家联系到审核通道。审核通道可以是一个群聊、一个人的联系方式、一个 mc 服务器或一个网站。 +1. 玩家联系到审核通道。审核通道可以是一个群聊、一个人的联系方式、一个 MC 服务器或一个网站。 2. 玩家通过自助或人工的方式进行审核。 -3. 如果程序或人工判定玩家审核通过，就将玩家的游戏名加入到服务器白名单，如果有玩家交流平台，那么就可以允许玩家加入交流平台。 - 这也意味着有进服审核机制的服务器必须开启白名单。否则玩家不经过审核也可以进入服务器，审核可能失去意义。 +3. 如果程序或人工判定玩家审核通过，就将玩家的游戏名加入到服务器白名单，如果有玩家交流平台，那么就可以允许玩家加入交流平台。这也意味着有进服审核机制的服务器必须开启白名单。否则玩家不经过审核也可以进入服务器，审核可能失去意义。 ## 审核的形式 @@ -35,12 +39,12 @@ sidebar_position: 8 给玩家出的问题可以与你对玩家的要求相关。例如： - **如果你希望玩家素质更高**，就可以出服务器内行为相关的题目，比如： - - 当听说自己的好友偷了其他玩家的物品被抓时，你应该怎么做 - - 你正在使用的刷铁机的主人突然因为某些原因而禁止你使用他的刷铁机，你应该怎么做 + - 当听说自己的好友偷了其他玩家的物品被抓时，你应该怎么做 + - 你正在使用的刷铁机的主人突然因为某些原因而禁止你使用他的刷铁机，你应该怎么做 - **如果你希望玩家的游戏水平更高**，你也可以出游戏知识相关的题目，比如： - - 以下哪个红石电路可以实现 RS 锁存器的功能 - - 当一个不属于任何村庄的村民在距离附近的村庄至少多远处认领床时，才会创建新的村庄而不是加入那个附近的村庄 + - 以下哪个红石电路可以实现 RS 锁存器的功能 + - 当一个不属于任何村庄的村民在距离附近的村庄至少多远处认领床时，才会创建新的村庄而不是加入那个附近的村庄 题目尽量不要过难，例如： diff --git a/docs/advance/management/player-management/chunkbase.md b/docs/advance/management/player-management/chunkbase.md index c7b7178b7..52e3975f7 100644 --- a/docs/advance/management/player-management/chunkbase.md +++ b/docs/advance/management/player-management/chunkbase.md @@ -6,14 +6,14 @@ sidebar_position: 2 # Chunkbase -Chunkbase 是 mc 玩家经常用的快速探索世界的网站，它提供一个工具，可以在已知世界种子的情况下快速定位到自己想要找的各种自然生成的建筑或者特殊区域，比如要塞、海底神殿、村庄、古城、下界要塞、猪灵堡垒、末地城等。 +Chunkbase 是 MC 玩家经常用的快速探索世界的网站，它提供一个工具，可以在已知世界种子的情况下快速定位到自己想要找的各种自然生成的建筑或者特殊区域，比如要塞、海底神殿、村庄、古城、下界要塞、猪灵堡垒、末地城等。 -**Chunkbase**的网站是 chunkbase.com。 +**Chunkbase** 的网站是 [www.chunkbase.com](https://www.chunkbase.com/)。 ## 开始使用 要使用 Chunkbase 查找这些结构、生物群系等，你可以进入 Apps，会显示各种各样的工具。找到自己要查找的东西对应的工具，点击进入，输入种子并选择服务器核心的版本，然后就可以看到要找的东西的位置了。 -要想缩放地图，可以在地图上转动滚轮，或拖动底部的滑块。在地图上拖动鼠标可以移动地图。如果要达到指定地点，可以在底部输入 x 和 z 坐标，然后点击**Go!**。 +要想缩放地图，可以在地图上转动滚轮，或拖动底部的滑块。在地图上拖动鼠标可以移动地图。如果要达到指定地点，可以在底部输入 x 和 z 坐标，然后点击 **Go!**。 ## Chunkbase 的利弊 @@ -23,7 +23,7 @@ Chunkbase 是一个非常好的工具，玩家可以用它快速地找到战利 你需要从一开服就对使用 Chunkbase 的玩家做好准备。你首先需要决定好是否为玩家提供使用 Chunkbase 的条件。你需要根据自己服务器的类型或玩家社区的个性来决定，通常来说有以下判断方式： -1. **玩家爱好** ：如果主要的玩家社区以生电为主，那么你很可能需要为他们提供 Chunkbase，如果玩家主要以战争、pvp 和探索为主，在提供 Chunkbase 时一定要谨慎。 +1. **玩家爱好** ：如果主要的玩家社区以生电为主，那么你很可能需要为他们提供 Chunkbase，如果玩家主要以战争、PVP 和探索为主，在提供 Chunkbase 时一定要谨慎。 2. **服务器配置** ：如果玩家有了 Chunkbase，他们就不再会不远万里地寻找特定的战利品，这会为你的服务器节省大量的 CPU、网络和硬盘。 如果你的服务器限制地图范围，那么提供 Chunkbase 将无关紧要，因为服务器内的资源本就有限，玩家跑图也跑不了太多，建议直接给玩家提供 Chunkbase，这样更方便了生电玩家。 3. **玩家数量** ：如果服务器的玩家较多，比如日常有十人在线，那么决定提供 Chunkbase 时一定要谨慎。如果你的服务器不限制跑图，那么服务器出生点附近的战利品将会被肝帝洗劫一空，后来的玩家就需要跑很远才能找到战利品。 diff --git a/docs/advance/management/player-management/client-distribution.md b/docs/advance/management/player-management/client-distribution.md index 681db035a..0cd2d1853 100644 --- a/docs/advance/management/player-management/client-distribution.md +++ b/docs/advance/management/player-management/client-distribution.md @@ -8,17 +8,17 @@ sidebar_position: 6 当你的服务器要求玩家使用特定版本客户端或安装特定模组时，你需要主动为玩家提供客户端的获取方式，方便新玩家们更方便地玩上你的服务器。 -## Java版 +## Java 版 ### JRE 的提供方式 :::tip -如果你不清楚此处提到的 JRE 是什么，请阅读 [选择、下载和安装 Java](/preparation/java/choose-and-download-and-install-java) +如果你不清楚此处提到的 JRE 是什么，请阅读 [选择、下载和安装 Java](../../../preparation//java/choose-and-download-and-install-java.md) ::: -虽然本教程的其他文档已经详细解释了 JRE 在 Minecraft Java 版游戏中的重要之处，但是各位服主的玩家并不都是对计算机有了解的玩家，他们可能并不清楚自己电脑上 Minecraft 是如何运行起来的。其中一些玩家可能在朋友或收费商家的远控下完成了 Java 环境的安装，甚至有些玩家一直在使用整合包提供的 JRE 。因此，对于一些服务器来说，提供一个傻瓜式的 JRE 安装向导或环境是很有必要的。 +虽然本教程的其他文档已经详细解释了 JRE 在 Minecraft Java 版游戏中的重要之处，但是各位服主的玩家并不都是对计算机有了解的玩家，他们可能并不清楚自己电脑上 Minecraft 是如何运行起来的。其中一些玩家可能在朋友或收费商家的远控下完成了 Java 环境的安装，甚至有些玩家一直在使用整合包提供的 JRE。因此，对于一些服务器来说，提供一个傻瓜式的 JRE 安装向导或环境是很有必要的。 #### 在整合包中集成 @@ -27,9 +27,9 @@ sidebar_position: 6 下面将以 HMCL 为例，分别说明如何在 Windows 版本的整合包中集成 JRE，同时也会介绍适用于其他启动器的通用方案。 1. **下载适合 Windows 的 JRE：** - 如果整合包对 JRE 没有特殊要求，你可以从 [Adoptium Temurin](https://adoptium.net/temurin/releases) 或 [Azul Zulu](https://www.azul.com/downloads/zulu/) 下载适合 `x64` 架构的压缩版（网站可能以“zip版”提供）JDK，因为这些 JDK 的体积较小，非常适合用于整合包使用。 + 如果整合包对 JRE 没有特殊要求，你可以从 [Adoptium Temurin](https://adoptium.net/temurin/releases) 或 [Azul Zulu](https://www.azul.com/downloads/zulu/) 下载适合 `x64` 架构的压缩版（网站可能以“zip 版”提供）JDK，因为这些 JDK 的体积较小，非常适合用于整合包使用。 - 如果你如果你的整合包对 JRE 要求严格（例如必须使用Oracle JDK），你也可以通过以下通用方式找到压缩版发行包： + 如果你如果你的整合包对 JRE 要求严格（例如必须使用 Oracle JDK），你也可以通过以下通用方式找到压缩版发行包： - 打开该 JDK 厂商的官方网站； - 寻找与“Downloads”、“Releases”或“Archives”相关的页面； - 在下载页面中，选择平台为 `Windows`，架构为 `x64`（或 `amd64`），并查找文件名后缀为 `.zip`、`.7z` 或 `.tar.gz` 的版本； @@ -50,7 +50,7 @@ sidebar_position: 6 ``` 3. **调整启动器设置：** - 以 HMCL 为例，前往 **版本管理** ，确保启用了 **启用版本特定游戏设置（不影响其他游戏版本）** ，**游戏Java** 选择 **指定Java版本** ，在此选项同一行的右侧输入框中填写以下内容： + 以 HMCL 为例，前往 **版本管理** ，确保启用了 **启用版本特定游戏设置（不影响其他游戏版本）** ，**游戏 Java** 选择 **指定 Java 版本** ，在此选项同一行的右侧输入框中填写以下内容： ```bash ./java/bin/javaw.exe @@ -133,7 +133,7 @@ sidebar_position: 6 #### 第三方制作的整合包 -为避免侵权纠纷，强烈推荐向玩家提供该整合包官方的下载方式（如原作者提供的 Curseforge、Github、网盘等）。如果普通玩家从官方渠道下载整合包大概率遇到困难（例如 Github 难以访问或某网盘对免费用户限速），请通过群文件等私下分享的形式分发整合包。 +为避免侵权纠纷，强烈推荐向玩家提供该整合包官方的下载方式（如原作者提供的 CurseForge、GitHub、网盘等）。如果普通玩家从官方渠道下载整合包大概率遇到困难（例如 GitHub 难以访问或某网盘对免费用户限速），请通过群文件等私下分享的形式分发整合包。 如果通过可能被视为再分发行为的方式提供（尤其是原作者已经提供网盘下载，而你又用自己的网盘帐号分享一遍，有时甚至不标明原作者），就可能给自己带来不必要的麻烦。如果必须通过此类方式提供，请先联系原作者取得授权。 @@ -149,7 +149,7 @@ sidebar_position: 6 ##### 服务器官网下载（自制整合包） -搭建方式同[服务器官网下载](#服务器官网下载) +搭建方式同 [服务器官网下载](#服务器官网下载) 请注意，由于整合包体积非常大，建议只在网站服务器有无限流量、带宽较高、国内直连快速且稳定，或者已经配置了流量足够的 CDN 的前提下考虑。 @@ -169,8 +169,8 @@ sidebar_position: 6 目前以下网站可以被作为下载站直接提供给玩家： -- **MCBEDL**：https://mcbedl.com ，原为 mc.minebbs.com，MineBBS论坛提供的公益安装包下载站。 -- **苦力怕论坛**：https://mcapks.net ，目前玩家群体中使用最多的下载站 +- **MCBEDL**：https://mcbedl.com，原为 mc.minebbs.com，MineBBS 论坛提供的公益安装包下载站。 +- **苦力怕论坛**：https://mcapks.net，目前玩家群体中使用最多的下载站 请注意，务必提醒玩家 **“复制到浏览器打开”**。部分小白玩家可能会直接在 QQ 微信等软件中直接打开链接，导致无法下载文件，甚至网站无法正常显示。 @@ -182,7 +182,7 @@ sidebar_position: 6 如果你的服务器未支持最新基岩版客户端，那么玩家们使用从 Microsoft Store 中新下载的客户端将无法进入你的服务器。这种情况下，你需要为 Windows 玩家提供用于降级客户端的旧版安装包。与安卓和 iOS 不同的是，Windows 的 UWP 应用安装包 Appx 可以覆盖安装旧版，因此你只需要放心地指导玩家双击安装包并直接覆盖即可，他们的所有数据都会被妥善保留。 -Windows 版本的安装包可以从 [MCBEDL](https://mcbedl.com) 或 [MCAPPX版本库](https://www.mcappx.com/) 下载。你自己下载完成后，可以通过与分发安卓安装包相同的方式将其分发给玩家。 +Windows 版本的安装包可以从 [MCBEDL](https://mcbedl.com) 或 [MCAPPX 版本库](https://www.mcappx.com/) 下载。你自己下载完成后，可以通过与分发安卓安装包相同的方式将其分发给玩家。 #### iOS @@ -224,7 +224,7 @@ iOS 的基岩版存在限制，如果使用砸壳 ipa 自签安装，会导致 ::: -首先通过抓包降级的方式获取带有你自己 Apple ID 签名的 ipa，教程可以看 [Minecraft iOS基岩版怎么完美降级？（下）| 我的世界基岩版版本切换教学](https://b23.tv/BV1MN411k7p5)。此安装包可以直接在所有登录了你自己 Apple ID 的设备上安装，不会过期，无需签名，且安装好之后可以正常登录帐号，但目前尚不清楚直接在陌生人的设备上安装会有什么样的限制。 +首先通过抓包降级的方式获取带有你自己 Apple ID 签名的 ipa，教程可以看 [Minecraft iOS 基岩版怎么完美降级？（下）| 我的世界基岩版版本切换教学](https://b23.tv/BV1MN411k7p5)。此安装包可以直接在所有登录了你自己 Apple ID 的设备上安装，不会过期，无需签名，且安装好之后可以正常登录帐号，但目前尚不清楚直接在陌生人的设备上安装会有什么样的限制。 根据网友分享，随后将 ipa 通过爱思助手等软件直接执行签名操作，然后就可以安装在登录有对应帐号的设备上了。目前尚不知将这些安装包重新签名后是否会再次出现登录微软帐号时的“溺尸”错误。 diff --git a/docs/advance/management/player-management/feedback.md b/docs/advance/management/player-management/feedback.md index 5deffb226..ebfbb7e50 100644 --- a/docs/advance/management/player-management/feedback.md +++ b/docs/advance/management/player-management/feedback.md @@ -35,7 +35,7 @@ sidebar_position: 10 在统计投票内容时，注意投票数据要尽可能与玩家在游戏内的活跃度相关联。在游戏内越活跃的玩家，对游戏内容改变的感知越大。 -你可以将玩家在服务器内的活跃数据转换为权重，也就是将玩家的话语权量化，然后利用统计学方法计算出每个选项对于玩家社区真正的影响力。 +你可以将玩家在服务器内的活跃数据转换为权重，也就是将玩家的话语权量化，然后利用统计学方法计算出每个选项对于玩家社区真正的影响力。 ### 设定截止日期 diff --git a/docs/advance/management/player-management/platform.md b/docs/advance/management/player-management/platform.md index 8400c134d..96ffe5d8f 100644 --- a/docs/advance/management/player-management/platform.md +++ b/docs/advance/management/player-management/platform.md @@ -12,7 +12,7 @@ sidebar_position: 5 2. 拥有保存聊天记录的功能，玩家们可以在即时通信软件上随时翻看自己和其他人的聊天记录，了解自己不在线时服务器中发生的事。 3. 即时通信软件可以随时向玩家发出提醒，让玩家与服务器社区保持紧密联系 -目前使用最多的即时软件是 QQ，当然也有微信、Kook、Discord等软件可以选择。 +目前使用最多的即时软件是 QQ，当然也有微信、KOOK、Discord 软件可以选择。 ## QQ @@ -22,7 +22,7 @@ sidebar_position: 5 群头像尽可能设置为服务器相关的图片。并且尽可能美观。 -最推荐的是使用服务器的 logo 作为服务器群头像。如果你暂时不打算制作服务器 logo，也可以使用服务器中的照片作为群头像。在有条件的前提下，尽可能使用光影拍摄。 +最推荐的是使用服务器的 logo 作为服务器群头像 。如果你暂时不打算制作服务器 logo，也可以使用服务器中的照片作为群头像。在有条件的前提下，尽可能使用光影拍摄。 如果实在是没有可以作为服务器群头像的图片，你也可以找一张二次元的图片。 @@ -59,14 +59,14 @@ sidebar_position: 5 连接地址并没有直接写可复制粘贴到游戏内的格式，容易误导玩家。如果上述服务器支持互通，那么他并没有写上服务器支持互通。 -> 服务器支持基岩版，不支持 Java 版 -> 连接地址：8aka.org +> 服务器支持基岩版，不支持 Java 版
+> 连接地址：8aka.org
> 端口：33825 没有写明支持的游戏版本，如果此服务器不支持最新版，那么将导致大量新玩家无法立即进服，因为大部分玩家下载的基岩版都是保持最新版。 -> Java 版连接地址：8aka.org:33825，版本 1.8-1.21 -> 基岩版连接地址：8aka.org，端口 33825，版本 1.21.20-21 +> Java 版连接地址：8aka.org:33825，版本 1.8-1.21
+> 基岩版连接地址：8aka.org，端口 33825，版本 1.21.20-21
> 别管我问这问那的，几把爱进不进，进不去从自己身上找问题 群公告包含不友善的用词。 @@ -76,51 +76,51 @@ sidebar_position: 5
合格的公告示例 -> 服务器仅支持基岩版 -> 连接地址 8aka.org 端口 33825 -> 版本支持 1.21.20-21 +> 服务器仅支持基岩版
+> 连接地址 8aka.org 端口 33825
+> 版本支持 1.21.20-21
> 如果进不去服务器请看其他置顶群公告，有解决方式，实在看不懂可以问群主 --- -> 欢迎来到起源之地服务器！ -> ⚠️进服前请详细阅读本公告！⚠️ -> Java 版进服地址：8aka.org:33825 -> 版本支持：1.8-1.21.1 -> 基岩版进服地址：8aka.org 端口：33825 -> 版本支持：1.21.0-1.21.21 +> 欢迎来到起源之地服务器！
+> ⚠️ 进服前请详细阅读本公告！ ⚠️
+> Java 版进服地址：8aka.org:33825
+> 版本支持：1.8-1.21.1
+> 基岩版进服地址：8aka.org 端口：33825
+> 版本支持：1.21.0-1.21.21
> 进入服务器前，请阅读服规：8aka.org/landoforigin --- -> ⚠️服务器连接要求： -> Java 版 1.21 -> 💻服务器 IP 地址： -> mc.8aka.org -> ⚠️注意事项： +> ⚠️ 服务器连接要求：
+> Java 版 1.21
+> 💻 服务器 IP 地址：
+> mc.8aka.org
+> ⚠️ 注意事项： > > 1. 服务器有多世界系统，玩家们可以通过主菜单中的维度传送服菜单进行维度传送；一般情况下，主世界维度和第二世界维度可用于给玩家们建造生存，且没有特殊情况不会换挡；资源世界维度用于给玩家们获得资源，每隔一段时间会重置一次，并且该维度所附属的地狱和末地与主世界维度不相通 > 2. 服务器安装有拓展玩法，需要在添加服务器时请将服务器资源包改为启用 -> 3. 建议玩家们在加入服务器前安装 JEI(用于查看物品配方)、钠和锂 (优化客户端) 模组，也可以考虑添加部分玩家们在群文件中分享的一些适用于玩家们使用的模组整合包 +> 3. 建议玩家们在加入服务器前安装 JEI (用于查看物品配方)、钠和锂 (优化客户端) 模组，也可以考虑添加部分玩家们在群文件中分享的一些适用于玩家们使用的模组整合包
> (改编自“天空之城”玩家群) --- -> 暑假服已开启！ -> 插件生存服 (手机可进服，连接地址见基岩版) -> 连接地址暂定为： -> java 版 mc.8aka.org:19934 -> 基岩版 mc.8aka.org 端口 19934 -> 版本：游戏内容截至荒野更新 (1.19)，java 版推荐使用 1.19 及以上版本，最低支持 1.8，基岩版支持 1.21.0-2 和最新版 -> 即使使用基岩版 (手机版) 进服，游戏特性也和 java 版相同 -> 根据投票的结果，服务器暑假服的玩法定为插件生存服 -> 考虑到原版生存和生电玩法的票数同样很高，后续我们会积极准备这两种玩法，并在后续开设新服务器时考虑 -> 目前由于服务器刚刚起步，插件很少，各位玩家可以先开荒，插件将会陆续添加 -> 雾中人整合包模组服 (仅支持 windows，手机和 macos 无法运行整合包) -> 连接地址 mc.8aka.org:38204 -> 模组整合包可在群文件的“国际服安装包”中找到 -> 雾中人是一款模组，主要以恐怖为主题，这个整合包还添加了一些其他的怪物和装备来丰富游戏内容 -> 由于此服务器消耗大量计算资源且热度较低，有时可能进入休眠，不会随时开放，如果无法连接服务器，暂时请主动提醒管理员开服，后续我们会开发相关软件让你能够在聊天群中自助唤醒服务器 +> 暑假服已开启！
+> 插件生存服 (手机可进服，连接地址见基岩版)
+> 连接地址暂定为：
+> Java 版 mc.8aka.org:19934
+> 基岩版 mc.8aka.org 端口 19934
+> 版本：游戏内容截至荒野更新 (1.19)，Java 版推荐使用 1.19 及以上版本，最低支持 1.8，基岩版支持 1.21.0-2 和最新版
+> 即使使用基岩版 (手机版) 进服，游戏特性也和 Java 版相同
+> 根据投票的结果，服务器暑假服的玩法定为插件生存服
+> 考虑到原版生存和生电玩法的票数同样很高，后续我们会积极准备这两种玩法，并在后续开设新服务器时考虑
+> 目前由于服务器刚刚起步，插件很少，各位玩家可以先开荒，插件将会陆续添加
+> 雾中人整合包模组服 (仅支持 Windows，手机和 macOS 无法运行整合包)
+> 连接地址 mc.8aka.org:38204
+> 模组整合包可在群文件的“国际服安装包”中找到
+> 雾中人是一款模组，主要以恐怖为主题，这个整合包还添加了一些其他的怪物和装备来丰富游戏内容
+> 由于此服务器消耗大量计算资源且热度较低，有时可能进入休眠，不会随时开放，如果无法连接服务器，暂时请主动提醒管理员开服，后续我们会开发相关软件让你能够在聊天群中自助唤醒服务器
> (改编自“新月国际服”玩家群) --- @@ -141,7 +141,7 @@ sidebar_position: 5 > 11. 赞助者特权：尊重赞助者，他们为服务器提供了支持。 > 12. 维护通知：关注服务器维护和更新通知，以免影响游戏。 > 违反规则将受到警告或封禁处理。我们期待与你共同营造一个和谐、有趣的游戏环境。 -> 感谢你的理解与合作。 +> 感谢你的理解与合作。
> (改编自“天空之城”玩家群) --- @@ -155,9 +155,9 @@ sidebar_position: 5 > 5. 严禁以任何行为恐吓、侮辱、排挤其他群员，禁止在群内透露他人个人隐私，如有发现直接按照群最高处罚制度处理 > 6. 开玩笑应当适度，若因小玩笑发生争吵，应当道歉或者私下以更好的方式解决 > 7. 头衔 (称号) 可以在群里艾特群主或者私信群主索要，每个艾特群主都会看到，但不一定会回复 -> 8. 禁止任何形式的宣传，包括但不限于广告和宣群 -> 本群处罚制度：1 次十分钟，2 次一小时，3 次十二小时，4 次一天，5 次移出本群 (行为较严重的按\*3 起步) -> 本规则即日起效，以往一概不论 +> 8. 禁止任何形式的宣传，包括但不限于广告和宣群
+> 本群处罚制度：1 次十分钟，2 次一小时，3 次十二小时，4 次一天，5 次移出本群 (行为较严重的按\*3 起步)
+> 本规则即日起效，以往一概不论
> 以上规则解释权归群主所有 --- @@ -170,7 +170,7 @@ sidebar_position: 5 ### 将群设置为公开 - + ## 微信群 @@ -192,12 +192,12 @@ sidebar_position: 5 ### [在群公告中发布服务器的连接地址和规则](#在群公告中发布服务器的连接地址和规则) - +## 论坛网站 --> 建好服务器交流群之后，你就可以拉人进群了。随后，你可以和玩家们直接在群里聊天，也可以随时通过艾特全体成员、发群公告的方式发布通知。 diff --git a/docs/advance/management/player-management/rules.md b/docs/advance/management/player-management/rules.md index 0206943fb..907233207 100644 --- a/docs/advance/management/player-management/rules.md +++ b/docs/advance/management/player-management/rules.md @@ -6,15 +6,15 @@ sidebar_position: 3 # 服务器规则 -服务器中已经有了一定的 mc 自带的游戏规则，比如生存不能开飞行，不能挖基岩等。但是这些远远不够，游戏规则中存在大量的漏洞，而且也没有对玩家的道德层面行为进行约束。为了规范玩家的行为，你必须为服务器额外制定游戏规则，这些游戏规则就是服务器规则。一旦玩家违反了你设定的规则，你就要按规定对玩家进行处罚，来让这名玩家和其他玩家更加严格地遵守规则。 +服务器中已经有了一定的 MC 自带的游戏规则，比如生存不能开飞行，不能挖基岩等。但是这些远远不够，游戏规则中存在大量的漏洞，而且也没有对玩家的道德层面行为进行约束。为了规范玩家的行为，你必须为服务器额外制定游戏规则，这些游戏规则就是服务器规则。一旦玩家违反了你设定的规则，你就要按规定对玩家进行处罚，来让这名玩家和其他玩家更加严格地遵守规则。 ## 最基本的规则 -你可以制定很少的规则，但是有些规则是**必须要有**的。如果不制定这些规则，玩家就会在你的服务器中无限制地进行各种不法行为，导致你的服务器完全无法供其他人进行游戏。这些规则包括： +你可以制定很少的规则，但是有些规则是 **必须要有** 的。如果不制定这些规则，玩家就会在你的服务器中无限制地进行各种不法行为，导致你的服务器完全无法供其他人进行游戏。这些规则包括： 1. **你必须禁止玩家对你的服务器进行网络攻击**。网络一章中已经介绍过网络攻击，它的危害极大，会导致玩家无法在服务器中正常游戏。虽然服务器规则防君子不防小人，但是你还是要制定这条规则，毕竟能防君子。 2. **你必须禁止玩家在游戏中作弊**。上一章已经介绍过如何为服务器配置反作弊，但是你必须设定这条规定，来对已经发生作弊行为的玩家进行合理的处罚。同时这条规定也是防君子不防小人，至少防了君子，给你省去了不少麻烦。 -3. **你必须禁止玩家在服务器聊天中讨论违法或敏感内容**。例如你必须禁止玩家在服务器内键政、讨论黄赌毒等违法内容。这是因为一旦玩家讨论了这些内容，你的服务器将涉嫌违法，你自己将可能连带着一起被卷入各种案件之中，甚至会导致你自己**面临牢狱之灾**。 +3. **你必须禁止玩家在服务器聊天中讨论违法或敏感内容**。例如你必须禁止玩家在服务器内键政、讨论黄赌毒等违法内容。这是因为一旦玩家讨论了这些内容，你的服务器将涉嫌违法，你自己将可能连带着一起被卷入各种案件之中，甚至会导致你自己 **面临牢狱之灾**。
这些规则的一种表述方式 @@ -30,7 +30,7 @@ sidebar_position: 3 在此之上，玩家还可能会进行一些违反道德的行为，除非你的服务器是无规则服务器，否则你必须对他们的这些行为进行限制，否则，玩家们将会在没有道德约束服务器中乱成一团，服务器就成“自由城”。这些规则包括： 1. **禁止偷盗**。你必须禁止玩家偷走其他玩家的物品，否则服务器会出现惊天大盗偷走玩家家里大量的钻石、模板、下界之星等贵重物品，搞得服务器人心惶惶，谁也不敢上线。 -2. **禁止抢劫**。在有死亡掉落的服务器里，除非是战争，否则你必须禁止玩家 pvp 杀死其他玩家来抢走他身上的物品。否则玩家们将会互相 pvp，把不是战争服的服务器变成战争服。 +2. **禁止抢劫**。在有死亡掉落的服务器里，除非是战争，否则你必须禁止玩家 PVP 杀死其他玩家来抢走他身上的物品。否则玩家们将会互相 PVP，把不是战争服的服务器变成战争服。 3. **禁止毁坏建筑**。玩家对其他人的的建筑倒水，放火，爆破，拆除等会导致其他人的心血毁于一旦，这样建筑的主人玩服务器的兴致就全没了。在生电服里，毁坏生电机器会导致机器所属组织的生产效率下降甚至停滞，严重影响他们的经济发展。 4. **禁止发布广告**，尤其是宣传其他服务器。你开了一家饭店，突然有个其他饭店的人天天来你家店门口宣传他家饭店，把顾客都招走了，你会愿意吗？ 5. **禁止通过服务器相关功能抢占领地**。例如服务器有领地插件，有玩家通过领地把要塞、末地主岛等据为己有，导致其他玩家无法使用这些设施，游戏体验大量缺失。 @@ -57,14 +57,14 @@ sidebar_position: 3 除此之外，你可能还需要一些规定，来避免玩家之间产生纠纷： -1. **禁止在服务器内繁殖大量生物**。大量的生物会导致服务器 mspt 变高，造成服务器卡顿。 +1. **禁止在服务器内繁殖大量生物**。大量的生物会导致服务器 MSPT 变高，造成服务器卡顿。 2. **禁止骚扰其他玩家**。你也不想打游戏的时候突然有个人不断地给你发消息或者拦在你前面非要你干什么吧。 3. **禁止恶意曲解服务器规定**。新人本身没完全理解规定，结果有人突然告诉他规定是那个意思，他理解的完全跑偏了，你服务器规定全白写了。
这些规则的一种表述方式 -1. 禁止在服务器内繁殖大量生物，尤其是建造巨大的村民交易所。大量的生物会导致服务器 mspt 变高，造成服务器卡顿，一经发现立即拆除，不予补偿。 +1. 禁止在服务器内繁殖大量生物，尤其是建造巨大的村民交易所。大量的生物会导致服务器 MSPT 变高，造成服务器卡顿，一经发现立即拆除，不予补偿。 2. 禁止骚扰其他玩家，包括向某玩家发出令他不适的言论或做出令他不适的行为，或未经其他玩家允许强行闯入其领地内。 3. 禁止向他人恶意曲解服务器规定，尤其是向新玩家以不当的方式解释服务器规定导致他理解错误甚至违反规定。 除了以上通用规定，各种具体类型的服务器也需要具体的规定。 diff --git a/docs/advance/management/player-management/whitelist.md b/docs/advance/management/player-management/whitelist.md index 7383e6128..9bde83b19 100644 --- a/docs/advance/management/player-management/whitelist.md +++ b/docs/advance/management/player-management/whitelist.md @@ -15,12 +15,13 @@ sidebar_position: 4 :::warning -开启白名单的服务器将面临更大的管理压力，包括但不限于你需要长期在线来随时给新玩家添加白名单，并为离开服务器的玩家解绑白名单。 +开启白名单的服务器将面临更大的管理压力，包括但不限于你需要长期在线来随时给新玩家添加白名单，并为离开服务器的玩家解绑白名单。 + 如果你选择让玩家自助申请白名单，你或你的技术人员还需要学习、部署、配置和维护相关软件。 ::: - + ## 机器人绑定白名单 @@ -54,9 +55,9 @@ sidebar_position: 4 ### 操作方法 1. **所有负责添加白名单的人都必须拥有使用 `whitelist` 指令的权限。** 你可以通过以下几种方式： - - 为服务器机器人配置特定响应机制，机器人响应指定管理员的指定命令来执行`whitelist`命令 + - 为服务器机器人配置特定响应机制，机器人响应指定管理员的指定命令来执行 `whitelist` 命令 - 在授予这些管理员游戏内管理员，这样他们就可以在游戏内使用 `whitelist` 指令了。BDS 服务器不支持在游戏内使用该命令，你可以为服务器安装插件或模组等来实现。注意这种方式可能需要管理员们启动游戏并进入服务器才能添加白名单，需要在游戏的启动和服务器连接过程上耗费大量时间。 - - 在支持多用户的[面板](../../../process/deploy/optional-mode.md#面板)上为这些管理员授予控制台的操作权限 + - 在支持多用户的 [面板](../../../process/deploy/optional-methods.md#面板) 上为这些管理员授予控制台的操作权限 - 将服务器的后台交给这些管理员 (**不推荐** ，这会导致部分管理员获得其不需要的权限并产生安全隐患) 2. **为负责相关工作的管理团队培训** 。 @@ -65,7 +66,7 @@ sidebar_position: 4 3. 得知玩家游戏 ID 后，立刻在服务器上进行添加白名单操作。添加完成后，立刻通知玩家。最后才在白名单文档上记录玩家身份和 ID 的对应关系。 4. 监控玩家退群、注销论坛等表明其离开玩家社区的操作，并立即移除玩家对应的白名单，并在玩家白名单文档上进行标记或删除操作。 -:::warning 不要过于相信玩家！ +:::warning[不要过于相信玩家！] **不要因为要求玩家在玩家交流平台上使用游戏 ID 作为昵称就不记录玩家身份与游戏 ID 的对应关系** 。一些玩家会趁管理员不注意将自己的昵称修改为他人的或无效的游戏 ID 来在事故追责中隐藏身份逃脱处罚。 diff --git a/docs/advance/management/player-management/wiki.md b/docs/advance/management/player-management/wiki.md index 726acdafb..5da429020 100644 --- a/docs/advance/management/player-management/wiki.md +++ b/docs/advance/management/player-management/wiki.md @@ -6,13 +6,14 @@ sidebar_position: 1 # Minecraft Wiki -为了让玩家们能够更好地了解我的世界中各种游戏机制和历史，mc 社区创建了一个百科网站，叫 Minecraft Wiki，它的地址是 zh.minecraft.wiki。无论是服主还是玩家，都可以来这个网站上查找各种资料。 +为了让玩家们能够更好地了解我的世界中各种游戏机制和历史，MC 社区创建了一个百科网站，叫 Minecraft Wiki，它的地址是 [zh.minecraft.wiki](https://zh.minecraft.wiki/)。无论是服主还是玩家，都可以来这个网站上查找各种资料。 ## Wiki 是什么？ -本教程就是以 Wiki 的形式呈现的。Wiki(维基) 是一种可以由任何人编辑的网站，类似于一个任何人都可以编辑其他人帖子的教程网站。也就是说，你也可以参与到我的世界 Wiki 的编写中，就像我们也邀请你与我们一同完善笨蛋开服教程一样。 -当然这同时也意味着，我的世界 Wiki 是由社区共同编写的，其中的内容几乎没有 MOJANG 的参与，准确性也没有 100% 的保证。 -但是都已经是社区大佬编写的了，你是选择相信愿意分享经验的大佬，还是那个对游戏社区的管理不尽人意的 MOJANG？ +本教程就是以 Wiki 的形式呈现的。Wiki (维基) 是一种可以由任何人编辑的网站，类似于一个任何人都可以编辑其他人帖子的教程网站。也就是说，你也可以参与到我的世界 Wiki 的编写中，就像我们也邀请你与我们一同完善笨蛋开服教程一样。 + +当然这同时也意味着，我的世界 Wiki 是由社区共同编写的，其中的内容几乎没有 Mojang 的参与，准确性也没有 100% 的保证。 +但是都已经是社区大佬编写的了，你是选择相信愿意分享经验的大佬，还是那个对游戏社区的管理不尽人意的 Mojang？ ## 条目 @@ -20,4 +21,4 @@ Wiki 中的一篇篇百科文章就叫条目。 ## 搜索 -进入 wiki 后，在右上角就可以搜索你要查找的内容，提高搜索成功率的方法与使用搜索引擎一样，只是不能用那些搜索引擎的代码。如果你搜索到了消歧义页面，证明这个页面对应的名称并不是一个标准的名字，你需要在消歧义页面中找到自己真正要找的那个条目。 +进入 Wiki 后，在右上角就可以搜索你要查找的内容，提高搜索成功率的方法与使用搜索引擎一样，只是不能用那些搜索引擎的代码。如果你搜索到了消歧义页面，证明这个页面对应的名称并不是一个标准的名字，你需要在消歧义页面中找到自己真正要找的那个条目。 diff --git a/docs/advance/ViaProxy/_image/img.png b/docs/advance/viaproxy/_image/img.png similarity index 100% rename from docs/advance/ViaProxy/_image/img.png rename to docs/advance/viaproxy/_image/img.png diff --git a/docs/advance/ViaProxy/_image/img_1.png b/docs/advance/viaproxy/_image/img_1.png similarity index 100% rename from docs/advance/ViaProxy/_image/img_1.png rename to docs/advance/viaproxy/_image/img_1.png diff --git a/docs/advance/ViaProxy/configuration.md b/docs/advance/viaproxy/configuration.md similarity index 97% rename from docs/advance/ViaProxy/configuration.md rename to docs/advance/viaproxy/configuration.md index c23cc5111..3587df728 100644 --- a/docs/advance/ViaProxy/configuration.md +++ b/docs/advance/viaproxy/configuration.md @@ -60,7 +60,7 @@ betacraft-auth: false ### 代理和高级功能 ```yaml -# 后端代理设置（SOCKS/HTTP代理） +# 后端代理设置（SOCKS/HTTP 代理） backend-proxy-url: "" # 格式：type://address:port # HAProxy 协议支持 @@ -140,7 +140,7 @@ map-display-entities: true # 显示实体映射为盔甲架 ### ViaRewind 配置 (ViaLoader/viarewind.yml) ```yaml -# 冷却指示器：TITLE（标题）、ACTION_BAR（动作栏）、BOSS_BAR（Boss栏）、DISABLED +# 冷却指示器：TITLE（标题）、ACTION_BAR（动作栏）、BOSS_BAR（Boss 栏）、DISABLED cooldown-indicator: TITLE # 兼容性设置 @@ -188,7 +188,7 @@ pack-cache: disk # 资源包缓存：disabled, memory, disk # 资源包转换 translate-resource-packs: true # 启用资源包转换 resource-pack-host: 127.0.0.1 # 资源包 HTTP 服务器地址 -resource-pack-port: 0 # 资源包服务器端口（0=随机） +resource-pack-port: 0 # 资源包服务器端口（0 = 随机） # 其他设置 disable-server-blacklist: false # 禁用服务器黑名单 diff --git a/docs/advance/ViaProxy/index.md b/docs/advance/viaproxy/index.md similarity index 95% rename from docs/advance/ViaProxy/index.md rename to docs/advance/viaproxy/index.md index 47734e3f8..13c72650b 100644 --- a/docs/advance/ViaProxy/index.md +++ b/docs/advance/viaproxy/index.md @@ -11,7 +11,7 @@ sidebar_position: 10 `下载` https://github.com/ViaVersion/ViaProxy/releases -`Jenkins` https://ci.viaversion.com/view/All/job/ViaProxy/ +`Jenkins` https://ci.viaversion.com/view/all/job/ViaProxy/ `Docker` https://github.com/ViaVersion/ViaProxy/pkgs/container/viaproxy @@ -44,7 +44,7 @@ ViaProxy 是独立程序，不是服务器插件。它运行在客户端和服 - Release (1.7.2 - 1.21.8) - Beta 1.7.3 (需要 [ViaProxyBeta2Release](https://github.com/ViaVersionAddons/ViaProxyBeta2Release)) -- 基岩版 (需要 [Geyser](/Java/Geyser) 插件) +- 基岩版 (需要 [Geyser](/java/Geyser) 插件) - Classic/Alpha/Beta/1.0-1.6.4 (仅透传模式) - EaglerCraft (需要 [ViaProxyEaglerCraft](https://github.com/Oryxel/ViaProxyEaglerCraft) 插件) @@ -52,7 +52,7 @@ ViaProxy 是独立程序，不是服务器插件。它运行在客户端和服 官方发布页面：[GitHub Release](https://github.com/ViaVersion/ViaProxy/releases) -Jenkins 构建：[ViaVersion Jenkins](https://ci.viaversion.com/view/All/job/ViaProxy/) +Jenkins 构建：[ViaVersion Jenkins](https://ci.viaversion.com/view/all/job/ViaProxy/) Docker 镜像：[GitHub Packages](https://github.com/ViaVersion/ViaProxy/pkgs/container/viaproxy) diff --git a/docs/advance/ViaProxy/installation.md b/docs/advance/viaproxy/installation.md similarity index 84% rename from docs/advance/ViaProxy/installation.md rename to docs/advance/viaproxy/installation.md index dbdb409d5..a9d581405 100644 --- a/docs/advance/ViaProxy/installation.md +++ b/docs/advance/viaproxy/installation.md @@ -17,7 +17,7 @@ sidebar_position: 2 ### 开发版本 -从 [ViaVersion Jenkins](https://ci.viaversion.com/view/All/job/ViaProxy/) 下载最新的开发版本。 +从 [ViaVersion Jenkins](https://ci.viaversion.com/view/all/job/ViaProxy/) 下载最新的开发版本。 ### Docker 镜像 @@ -73,20 +73,20 @@ java -jar ViaProxy-3.4.4.jar cli \ ##### 基础连接参数 -- `--bind-address <地址:端口>` - 监听地址和端口 (默认: 0.0.0.0:25568) -- `--target-address <地址:端口>` - 目标服务器地址 (默认: 127.0.0.1:25565) -- `--target-version <版本>` - 目标服务器版本 (默认: 自动检测) +- `--bind-address <地址:端口>` - 监听地址和端口 (默认：0.0.0.0:25568) +- `--target-address <地址:端口>` - 目标服务器地址 (默认：127.0.0.1:25565) +- `--target-version <版本>` - 目标服务器版本 (默认：自动检测) ##### 认证配置 -- `--auth-method <方式>` - 认证方式 (默认: NONE) -- `--proxy-online-mode ` - 代理正版模式 (默认: false) +- `--auth-method <方式>` - 认证方式 (默认：NONE) +- `--proxy-online-mode ` - 代理正版模式 (默认：false) - `--minecraft-account-index <索引>` - 使用的 Minecraft 账户索引 ##### 高级功能 -- `--chat-signing ` - 聊天签名支持 (默认: true) -- `--simple-voice-chat-support ` - 简单语音聊天支持 (默认: false) +- `--chat-signing ` - 聊天签名支持 (默认：true) +- `--simple-voice-chat-support ` - 简单语音聊天支持 (默认：false) - `--resource-pack-url ` - 自定义资源包地址 ### 配置文件模式（推荐自动化部署） diff --git a/docs/advance/ViaProxy/plugins/auth.md b/docs/advance/viaproxy/plugins/auth.md similarity index 98% rename from docs/advance/ViaProxy/plugins/auth.md rename to docs/advance/viaproxy/plugins/auth.md index 98d8f9c7c..7afa472f8 100644 --- a/docs/advance/ViaProxy/plugins/auth.md +++ b/docs/advance/viaproxy/plugins/auth.md @@ -70,6 +70,7 @@ ViaProxyAuthHook 允许 ViaProxy 客户端加入需要正版验证的服务器 3. **配置密钥** 启动服务器后，编辑生成的配置文件： + ```yaml secret-key: "从ViaProxy配置中复制的密钥" viaproxy-url: "http://localhost:25568" # ViaProxy地址 @@ -81,7 +82,7 @@ ViaProxyAuthHook 允许 ViaProxy 客户端加入需要正版验证的服务器 1. 在 ViaProxy 中添加 Minecraft 账户 2. 启用 "Proxy Online Mode" -3. 设置认证模式为 "AUTH_HOOK" +3. 设置认证模式为 `AUTH_HOOK` 4. 连接到目标服务器 #### CLI 模式 diff --git a/docs/advance/ViaProxy/plugins/compatibility.md b/docs/advance/viaproxy/plugins/compatibility.md similarity index 92% rename from docs/advance/ViaProxy/plugins/compatibility.md rename to docs/advance/viaproxy/plugins/compatibility.md index 7cb5f77c3..82620fbc4 100644 --- a/docs/advance/ViaProxy/plugins/compatibility.md +++ b/docs/advance/viaproxy/plugins/compatibility.md @@ -19,7 +19,7 @@ sidebar_position: 4 ViaProxyBeta2Release 实现了 [Beta2Release](https://github.com/DirtPowered/Beta2Release) 代理功能，允许 Beta 1.7.3 客户端连接到现代服务器。 -:::warning 重要提醒 +:::warning[重要提醒] 此插件需要 **Java 21 或更高版本** @@ -87,7 +87,7 @@ BungeeViaProxy 通过确保正确的主机名转发和避免重复服务器错 客户端 -> BungeeCord -> ViaProxy -> 后端服务器 ``` -:::warning 重要配置要求 +:::warning[重要配置要求] 使用此设置时，ViaProxy 必须放置在 BungeeCord 和后端服务器之间，并且需要以下配置： @@ -118,15 +118,14 @@ BungeeViaProxy 通过确保正确的主机名转发和避免重复服务器错 ``` 2. **重启 BungeeCord 服务器** - ```bash - # 无需额外配置，插件会自动处理 .f2.viaproxy. 地址 - ``` + + 无需额外配置，插件会自动处理 .f2.viaproxy. 地址 ### 配置示例 假设以下服务器设置： -| 服务器 | IP:端口 | Minecraft 版本 | +| 服务器 | IP：端口 | Minecraft 版本 | | ------------ | --------------- | -------------- | | BungeeCord | 127.0.0.1:25565 | N/A | | ViaProxy | 127.0.0.1:25566 | N/A | @@ -136,11 +135,12 @@ BungeeViaProxy 通过确保正确的主机名转发和避免重复服务器错 #### BungeeCord 配置 (config.yml) + ```yaml online_mode: true servers: server1: - # ViaProxy 地址格式: address.<后端IP>.port.<后端端口>.version.<版本>.f2.viaproxy..nip.io: + # ViaProxy 地址格式: address.<后端 IP>.port.<后端端口>.version.<版本>.f2.viaproxy..nip.io: address: address.127.0.0.1.port.3001.version.1.20.4.f2.viaproxy.127.0.0.1.nip.io:25566 motd: "&1示例服务器 1" restricted: false @@ -158,6 +158,7 @@ listeners: prevent_proxy_connections: false ip_forward: true ``` + #### ViaProxy 配置 (config.yml) @@ -194,7 +195,7 @@ settings: bungeecord: true ``` -:::tip 重要提示 +:::tip[重要提示] - 后端服务器无需安装 ViaVersion 插件（版本转换由 ViaProxy 处理） - 不要使用 ViaProxyAuthHook，因为 ViaProxy 位于 BungeeCord 和后端服务器之间 @@ -208,7 +209,7 @@ settings: ViaProxy 的 `wildcard-domain-handling` 功能允许单个实例处理多个后端服务器的连接，使用特定的地址格式： ```text -address.<后端IP>.port.<后端端口>.version.<版本>.f2.viaproxy..nip.io: +address.<后端 IP>.port.<后端端口>.version.<版本>.f2.viaproxy..nip.io: ``` 这些地址可以在 BungeeCord 的 `config.yml` 中列出，通过单个 ViaProxy 实例实现无缝连接管理。 @@ -225,7 +226,7 @@ address.<后端IP>.port.<后端端口>.version.<版本>.f2.viaproxy. ```bash - curl -L "https://github.com/NamelessMC/Nameless/releases/latest/download/nameless-deps-dist.tar.xz" | tar --xz --extract --directory=/var/www/html --file - wget -O - "https://github.com/NamelessMC/Nameless/releases/latest/download/nameless-deps-dist.tar.xz" | tar --xz --extract --directory=/var/www/html --file - - ``` -如果你是 Windows,直接下载解压到网站目录即可(Apache 通常是 `htdocs`) +如果你是 Windows，直接下载解压到网站目录即可 (Apache 通常是 `htdocs`) -不推荐这么干,容易爆炸 +不推荐这么干，容易爆炸 ```bash # 克隆最新版本 @@ -39,14 +37,14 @@ git clone --branch v2 https://github.com/NamelessMC/Nameless.git /var/www/html/n ```bash -# 通过Composer安装 +# 通过 Composer 安装 composer create-project namelessmc/nameless /var/www/html/namelessmc ``` -1. **安装Docker Compose** (Debian/Ubuntu): +1. **安装 Docker Compose** (Debian/Ubuntu): ```bash sudo apt install docker-compose-plugin @@ -55,7 +53,7 @@ composer create-project namelessmc/nameless /var/www/html/namelessmc 2. **下载配置文件** ```bash - # 下载docker-compose.yaml文件 + # 下载 docker-compose.yaml 文件 wget https://github.com/NamelessMC/Nameless-Docker/blob/master/docker-compose.yaml ``` @@ -75,10 +73,10 @@ composer create-project namelessmc/nameless /var/www/html/namelessmc 5. **完成安装** - 访问 http://localhost:80 - - 数据库地址填写: `db` - - 数据库用户名、密码、数据库名都填写: `nameless` + - 数据库地址填写：`db` + - 数据库用户名、密码、数据库名都填写：`nameless` -### 推荐Docker标签 +### 推荐 Docker 标签 - `v2.2`: 最新稳定版 (PHP 8.3) - `v2.1`: 上一稳定版 (PHP 8.2) @@ -114,7 +112,7 @@ sudo chmod -R 777 /var/www/html/namelessmc/uploads # 设置所有者 sudo chown -R nginx:nginx /var/www/html/namelessmc -# 设置SELinux上下文 (如果启用SELinux) +# 设置 SELinux 上下文 (如果启用 SELinux) sudo restorecon -R /var/www/html/namelessmc sudo setsebool -P httpd_can_network_connect 1 sudo setsebool -P httpd_can_network_connect_db 1 @@ -129,8 +127,8 @@ sudo chmod -R 777 /var/www/html/namelessmc/uploads -```bash -# 通过FTP客户端或文件管理器设置权限 +```text +# 通过 FTP 客户端或文件管理器设置权限 # 文件权限：644 # 目录权限：755 # 特殊目录权限：777 @@ -138,12 +136,12 @@ sudo chmod -R 777 /var/www/html/namelessmc/uploads # - uploads/ ``` -**注意**：某些共享主机可能不允许777权限，请尝试755或按主机商要求设置。 +**注意**：某些共享主机可能不允许 777 权限，请尝试 755 或按主机商要求设置。 -### Web安装向导 +### Web 安装向导 1. **访问安装页面** - 打开浏览器访问：`http://your-domain.com/install` @@ -152,6 +150,7 @@ sudo chmod -R 777 /var/www/html/namelessmc/uploads ![img.png](_images/img-2.png) 1. **数据库配置** + ```text 数据库类型：MySQL 主机地址：localhost (或你的数据库主机) @@ -168,17 +167,19 @@ sudo chmod -R 777 /var/www/html/namelessmc/uploads ```text 站点名称：你的服务器名称 - 站点URL：完整的域名地址 - 友好URL：启用 (推荐) + 站点 URL：完整的域名地址 + 友好 URL：启用 (推荐) ``` 1. **管理员账户** + ```text 用户名：admin (可自定义) 邮箱：admin@yourdomain.com 密码：强密码 确认密码：重复输入 ``` + ![img.png](_images/img-.png) 然后就安装好了 diff --git a/docs/advance/website/plugins.md b/docs/advance/website/plugins.md index f966f1f6e..ab1ed001f 100644 --- a/docs/advance/website/plugins.md +++ b/docs/advance/website/plugins.md @@ -9,7 +9,7 @@ sidebar_position: 4 首先在这里下载 [SpigotMC](https://www.spigotmc.org/resources/nameless-plugin-for-v2.59032/) -解压后根据你的服务器版本选择对应的插件,通常选择 `Paper` 即可 +解压后根据你的服务器版本选择对应的插件，通常选择 `Paper` 即可 ![](_images/img_3.png) @@ -26,57 +26,57 @@ api: key: "" ``` -然后打开配置文件 `main.yml` 进行配置,填完后执行 `/nlpl reload` +然后打开配置文件 `main.yml` 进行配置，填完后执行 `/nlpl reload` ![](_images/img_5.png) -然后接下来需要创建一个服务器,创建好后,复制服务器的 ID,填入配置文件中的`server-id` 即可(记得重新加载) +然后接下来需要创建一个服务器，创建好后，复制服务器的 ID，填入配置文件中的`server-id` 即可 (记得重新加载) ![](_images/img_6.png) ## 插件配置文件 ```yaml -# Nameless插件配置 +# Nameless 插件配置 # 插件运行异常？请参考故障排除指南：https://docs.namelessmc.com/en/集成/plugin-troubleshooting # 使用命令 /nlpl reload 重载插件 api: - # 启用API并在 核心 > 配置 > API 获取API网址和API密钥 + # 启用 API 并在 核心 > 配置 > API 获取 API 网址和 API 密钥 url: "http://localhost/index.php?route=/api/v2" key: "FZX3YAdR8nFfaHXSqUBvwXdrhJdOCERCKZ6AonUWlXk" - # 在 核心 > 集成 > Minecraft > Minecraft 服务器 查找您的服务器ID + # 在 核心 > 集成 > Minecraft > Minecraft 服务器 查找您的服务器 ID server-id: 1 # 输出网站请求与响应的详细信息 debug: false - # 等待网站响应的最大时间，推荐值为3到15秒 + # 等待网站响应的最大时间，推荐值为 3 到 15 秒 # 语法参考：https://en.wikipedia.org/wiki/ISO_8601#Durations timeout: "PT10S" - # 若启用，插件将忽略服务器的UUID，而根据玩家用户名生成离线模式UUID以进行API请求。 - # 网站也需配置为使用离线模式UUID。 + # 若启用，插件将忽略服务器的 UUID，而根据玩家用户名生成离线模式 UUID 以进行 API 请求。 + # 网站也需配置为使用离线模式 UUID。 # 此功能为实验性质，有助于基岩版（Floodgate/Geyser）兼容性。 offline-uuids: false # 数据发送取决于使用的平台：https://docs.namelessmc.com/en/集成/plugin-data-sender # 此功能会周期性地向网站发送服务器数据，用于群组同步、用户名同步和占位符等功能。 -# 当前网站并未使用此插件提供服务器状态与玩家列表，需在网站单独配置服务器Ping功能。 +# 当前网站并未使用此插件提供服务器状态与玩家列表，需在网站单独配置服务器 Ping 功能。 server-data-sender: enabled: false # 数据发送的时间间隔：https://en.wikipedia.org/wiki/ISO_8601#Durations interval: "PT30S" - # 发送PlaceholderAPI占位符数据，供NamelessMC（排行榜、个人主页）或其他模块使用。 - # 仅支持 oldbukkit、spigot 和 paper 平台。 + # 发送 PlaceholderAPI 占位符数据，供 NamelessMC（排行榜、个人主页）或其他模块使用。 + # 仅支持 OldBukkit、Spigot 和 Paper 平台。 placeholders: enabled: false - # 全局占位符（网站目前未使用），填写占位符名称，不包括%% + # 全局占位符（网站目前未使用），填写占位符名称，不包括 %% global: [] - # 玩家特定的占位符，填写占位符名称，不包括%% + # 玩家特定的占位符，填写占位符名称，不包括 %% player: [] -# 若启用，将把Minecraft群组同步至网站。 +# 若启用，将把 Minecraft 群组同步至网站。 # > 在 核心 > 集成 > Minecraft > Minecraft 服务器 选择群组同步服务器 # > 在 核心 > 配置 > API > 权限组同步 中配置群组。 -# 此选项仅适用于NamelessMC v2.1.0+版本，旧版本通过server-data-sender同步群组。 +# 此选项仅适用于 NamelessMC v2.1.0+ 版本，旧版本通过 server-data-sender 同步群组。 group-sync: enabled: false # 群组同步间隔：https://en.wikipedia.org/wiki/ISO_8601#Durations @@ -86,7 +86,7 @@ logging: # 在日志中显示更多详细信息 verbose: false -# 玩家加入时，若未注册NamelessMC账号，向其发送消息提醒 +# 玩家加入时，若未注册 NamelessMC 账号，向其发送消息提醒 not-registered-join-message: false # 玩家加入时，在聊天框显示网站通知（如有） @@ -101,12 +101,12 @@ datetime-format: "yyyy-MM-dd HH:mm:ss" # 周期性在聊天框发送网站公告消息 announcements: enabled: false - # 每个间隔，从公告中随机选择一条发送给玩家 + # 每个 间隔，从公告中随机选择一条发送给玩家 interval: "PT10M" # 若设定，仅发送指定页面的公告 # display: Forums -# 允许玩家在注册时使用非Minecraft用户名作为账号名 +# 允许玩家在注册时使用非 Minecraft 用户名作为账号名 register-custom-username: true # ------------------ 以下选项仅支持 Bukkit 平台 ------------------ # @@ -114,13 +114,13 @@ register-custom-username: true # 当玩家被封禁时，同时封禁其网站账号（事件触发，仅新封禁有效） sync-ban-to-website: false -# 用户同步功能仅支持 oldbukkit、spigot 和 paper 平台 +# 用户同步功能仅支持 OldBukkit、Spigot 和 Paper 平台。 user-sync: enabled: false # 同步间隔（秒） poll-interval: "PT30S" - # 排除的UUID列表（这些用户不会被加入或移出白名单或封禁列表） - # UUID需带横线格式，如启用api-usernames选项，请填写用户名。 + # 排除的 UUID 列表（这些用户不会被加入或移出白名单或封禁列表） + # UUID 需带横线格式，如启用 api-usernames 选项，请填写用户名。 exclude: [] # 自动将已注册的玩家加入白名单 @@ -131,17 +131,17 @@ user-sync: enabled: false # 仅允许通过验证的用户加入白名单 verified-only: false - # 若仅允许特定群组的用户加入白名单，请填写群组ID + # 若仅允许特定群组的用户加入白名单，请填写群组 ID only-with-group: -1 # 网站封禁用户自动同步至服务器，被解除封禁用户也自动同步 bans: enabled: false -# 从NamelessMC获取用户信息供PlaceholderAPI使用。 +# 从 NamelessMC 获取用户信息供 PlaceholderAPI 使用。 # 此功能与上述发送占位符至网站不同。 # 参考：https://github.com/PlaceholderAPI/PlaceholderAPI/wiki/Placeholders#nameless-plugin -# 仅支持 oldbukkit、spigot 和 paper 平台。 +# 仅支持 OldBukkit、Spigot 和 Paper 平台。 retrieve-placeholders: enabled: false # 占位符检索间隔：https://en.wikipedia.org/wiki/ISO_8601#Durations @@ -150,6 +150,6 @@ retrieve-placeholders: :::tip -有些功能的启动需要安装对应插件! +有些功能的启动需要安装对应插件！ ::: diff --git a/docs/advance/website/prepare.md b/docs/advance/website/prepare.md index 053b6f4d0..f9b49b351 100644 --- a/docs/advance/website/prepare.md +++ b/docs/advance/website/prepare.md @@ -8,27 +8,27 @@ import TabItem from '@theme/TabItem'; # 准备 -在开始前,你需要准备一些软件 +在开始前，你需要准备一些软件 # 环境准备 -## Ubuntu/Debian系统准备 +## Ubuntu/Debian 系统准备 ### 安装必需软件包 ```bash -# 安装PHP和扩展 +# 安装 PHP 和扩展 sudo apt install -y php8.1 php8.1-fpm php8.1-mysql php8.1-gd php8.1-mbstring php8.1-xml php8.1-curl php8.1-zip -# 安装MySQL/MariaDB +# 安装 MySQL/MariaDB sudo apt install -y mysql-server -# 或安装MariaDB +# 或安装 MariaDB # sudo apt install -y mariadb-server -# 安装Web服务器 (选择其一) +# 安装 Web 服务器 (选择其一) sudo apt install -y nginx # sudo apt install -y apache2 ``` @@ -36,36 +36,36 @@ sudo apt install -y nginx -## CentOS/Rocky Linux系统准备 +## CentOS/Rocky Linux 系统准备 -### 安装EPEL和Remi仓库 +### 安装 EPEL 和 Remi 仓库 ```bash -# EPEL仓库 +# EPEL 仓库 sudo dnf install -y epel-release -# Remi仓库 +# Remi 仓库 sudo dnf install -y https://rpms.remirepo.net/enterprise/remi-release-8.rpm # 国内服务器推荐使用这一条 sudo dnf install -y https://mirrors.tuna.tsinghua.edu.cn/remi/enterprise/remi-release-8.rpm ``` -#### 安装PHP和相关软件包 +#### 安装 PHP 和相关软件包 ```bash -# 启用PHP 8.1模块 +# 启用 PHP 8.1 模块 sudo dnf module enable php:remi-8.1 -y -# 安装PHP和扩展 +# 安装 PHP 和扩展 sudo dnf install -y php php-fpm php-mysqlnd php-gd php-mbstring php-xml php-curl php-zip -# 安装MySQL/MariaDB +# 安装 MySQL/MariaDB sudo dnf install -y mysql-server -# 或安装MariaDB +# 或安装 MariaDB # sudo dnf install -y mariadb-server -# 安装Web服务器 +# 安装 Web 服务器 sudo dnf install -y nginx ``` @@ -80,26 +80,27 @@ sudo firewall-cmd --reload -## Windows系统准备 +## Windows 系统准备 -### 使用XAMPP (推荐) +### 使用 XAMPP (推荐) -1. **下载XAMPP** +1. **下载 XAMPP** - 访问 https://www.apachefriends.org/ - - 下载最新版本 (包含PHP 8.1) + - 下载最新版本 (包含 PHP 8.1) -2. **安装XAMPP** +2. **安装 XAMPP** - 运行安装程序 - - 选择Apache、MySQL、PHP组件 + - 选择 Apache、MySQL、PHP 组件 - 安装到默认路径 `C:\xampp` 3. **启动服务** - - 打开XAMPP控制面板 - - 启动Apache和MySQL服务 + - 打开 XAMPP 控制面板 + - 启动 Apache 和 MySQL 服务 -4. **配置PHP** +4. **配置 PHP** - 编辑 `C:\xampp\php\php.ini` - 取消注释并启用必需扩展： + ```ini extension=gd extension=mbstring @@ -111,18 +112,18 @@ sudo firewall-cmd --reload ### 手动安装 -1. **安装PHP** - - 下载PHP 8.1 from https://windows.php.net/ +1. **安装 PHP** + - 下载 PHP 8.1 from https://windows.php.net/ - 解压到 `C:\php` - 配置环境变量 -2. **安装MySQL** - - 下载MySQL Community Server +2. **安装 MySQL** + - 下载 MySQL Community Server - 按向导安装配置 -3. **安装Web服务器** - - IIS：通过Windows功能启用 - - 或下载Apache for Windows +3. **安装 Web 服务器** + - IIS：通过 Windows 功能启用 + - 或下载 Apache for Windows @@ -133,10 +134,10 @@ sudo firewall-cmd --reload - PHP 7.4+ (推荐 8.1) - MySQL 5.7+ 或 MariaDB 10.2+ -- 至少 100MB 存储空间 -- 支持 .htaccess (Apache) 或 URL重写 +- 至少 100 MB 存储空间 +- 支持 .htaccess (Apache) 或 URL 重写 -### 检查PHP扩展 +### 检查 PHP 扩展 创建 `phpinfo.php` 文件检查： @@ -163,17 +164,17 @@ sudo systemctl enable --now mysql sudo systemctl enable --now nginx ``` -## 配置SELinux (如果启用) +## 配置 SELinux (如果启用) ```bash -# 允许Web服务器连接数据库 +# 允许 Web 服务器连接数据库 sudo setsebool -P httpd_can_network_connect_db 1 -# 允许Web服务器连接网络 +# 允许 Web 服务器连接网络 sudo setsebool -P httpd_can_network_connect 1 ``` -当然你可以选择直接关闭(推荐) +当然你可以选择直接关闭 (推荐) ```bash sed -i "s#=enforcing#=disabled#g" /etc/selinux/config @@ -182,7 +183,7 @@ sed -i "s#=enforcing#=disabled#g" /etc/selinux/config ## 配置数据库 ```bash -# 安全配置MySQL +# 安全配置 MySQL sudo mysql_secure_installation # 创建数据库和用户 @@ -199,9 +200,9 @@ FLUSH PRIVILEGES; EXIT; ``` -## 配置PHP +## 配置 PHP -打开 `php.ini`,重要配置项： +打开 `php.ini`，重要配置项： ```ini max_execution_time = 300 diff --git a/docs/advance/website/server_config.md b/docs/advance/website/server-config.md similarity index 92% rename from docs/advance/website/server_config.md rename to docs/advance/website/server-config.md index 849f51e20..8e2fb99d9 100644 --- a/docs/advance/website/server_config.md +++ b/docs/advance/website/server-config.md @@ -28,7 +28,7 @@ server { index index.php index.html; # 允许更大的文件上传 - # 允许客户端请求体的最大大小为 100MB，这对于文件上传功能很重要。 + # 允许客户端请求体的最大大小为 100 MB，这对于文件上传功能很重要。 client_max_body_size 100m; # 添加安全相关的 HTTP 响应头 @@ -75,7 +75,7 @@ server { location ~ \.php$ { # 将请求通过 FastCGI 协议传递给 PHP-FPM (PHP FastCGI Process Manager) 进行处理。 # 这里使用的是 Unix socket，它是一种在同一台机器上进行进程间通信的文件。 - # 它的路径可能需要根据你的系统配置进行修改 (例如，在不同PHP版本下可能是 php8.1-fpm.sock)。 + # 它的路径可能需要根据你的系统配置进行修改 (例如，在不同 PHP 版本下可能是 php8.1-fpm.sock)。 fastcgi_pass unix:/run/php/php-fpm.sock; # 可能需要编辑此行 # 定义 FastCGI 的默认索引文件 @@ -111,7 +111,7 @@ server { index index.php index.html; # 允许更大的文件上传 - # 允许客户端请求体的最大大小为 100MB，这对于文件上传功能很重要。 + # 允许客户端请求体的最大大小为 100 MB，这对于文件上传功能很重要。 client_max_body_size 100m; # 这是一个基础的 TLS 配置示例，没有 OCSP Stapling，使用默认加密套件，也没有 HSTS。 @@ -195,9 +195,9 @@ server { AllowEncodedSlashes NoDecode # 这两个是 PHP 的配置项，通过 Apache 的 mod_php 模块来设置。 - # 设置允许上传的单个文件的最大大小为 100MB。 + # 设置允许上传的单个文件的最大大小为 100 MB。 php_value upload_max_filesize 100M - # 设置 POST 请求体数据的最大大小为 100MB。 + # 设置 POST 请求体数据的最大大小为 100 MB。 # 这个值必须大于或等于 upload_max_filesize 才能成功上传大文件。 php_value post_max_size 100M @@ -232,9 +232,9 @@ server { # 允许 URL 中包含编码后的斜杠 (%2F) 并且不进行解码。 AllowEncodedSlashes NoDecode - # 通过 mod_php 设置 PHP 的上传文件大小限制为 100MB。 + # 通过 mod_php 设置 PHP 的上传文件大小限制为 100 MB。 php_value upload_max_filesize 100M - # 设置 POST 请求体数据的最大大小为 100MB。 + # 设置 POST 请求体数据的最大大小为 100 MB。 php_value post_max_size 100M # 定义针对网站根目录的特定配置。 @@ -264,7 +264,7 @@ server { ## Cloudflare -如果你不想自己配置 SSL 证书,你可以通过使用 Cloudflare 的免费 SSL 服务来提供 HTTPS 功能。 +如果你不想自己配置 SSL 证书，你可以通过使用 Cloudflare 的免费 SSL 服务来提供 HTTPS 功能。 Cloudflare 的免费 SSL 服务可以为你的网站提供免费的 SSL 证书，无需任何额外的配置。 ![](_images/img.png) @@ -273,7 +273,7 @@ Cloudflare 的免费 SSL 服务可以为你的网站提供免费的 SSL 证书 ![img.png](_images/img——1.png) -你也可以把`始终使用 HTTPS` 和 `HTTP 严格传输安全 (HSTS)` 打开 +你也可以把 `始终使用 HTTPS` 和 `HTTP 严格传输安全 (HSTS)` 打开 ### 源服务器加密 @@ -281,15 +281,15 @@ Cloudflare 的免费 SSL 服务可以为你的网站提供免费的 SSL 证书 如果你希望提高 Cloudflare 到源服务器的安全性，可以使用源服务器加密来实现。 -创建证书后,按照服务器配置配置证书,开启`经过身份验证的源服务器拉取` 即可 +创建证书后，按照服务器配置配置证书，开启 `经过身份验证的源服务器拉取` 即可 ### 代理配置 通过代理连接会导致两个问题： -- NamelessMC 会看到你的代理地址而不是你的用户地址。这会破坏 IP 封锁和速率限制。这可以通过从代理向后端 Web 服务器发送 Forwarded 、 X-Forwarded-For 或 X-Real-IP （不推荐）标头来解决。 +- NamelessMC 会看到你的代理地址而不是你的用户地址。这会破坏 IP 封锁和速率限制。这可以通过从代理向后端 Web 服务器发送 Forwarded、X-Forwarded-For 或 X-Real-IP（不推荐）标头来解决。 -在你的 Nginx 配置文件中添加如下几行: +在你的 Nginx 配置文件中添加如下几行： ```nginx proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; diff --git a/docs/advance/website/server-plugins.md b/docs/advance/website/server-plugins.md index 0725a9bcb..7905a7bf1 100644 --- a/docs/advance/website/server-plugins.md +++ b/docs/advance/website/server-plugins.md @@ -5,11 +5,11 @@ sidebar_position: 6 # 论坛插件 -NamelessMC 有这非常多的插件,你可以在 [这里](https://namelessmc.com/resources/) 查看 +NamelessMC 有这非常多的插件，你可以在 [这里](https://namelessmc.com/resources/) 查看 以这个插件为例子 [FAQ](https://namelessmc.com/resources/resource/184-frequently-asked-questions/) -下载后解压,你会得到以下文件: +下载后解压，你会得到以下文件： ![](_images/img_8.png) @@ -17,6 +17,6 @@ NamelessMC 有这非常多的插件,你可以在 [这里](https://namelessmc.com ![img.png](_images/img_9.png) -点击安装即可，如果你安装的是样式模板,你应该在这里安装 +点击安装即可，如果你安装的是样式模板，你应该在这里安装 ![img.png](_images/img_10.png) diff --git a/docs/advance/website/website.md b/docs/advance/website/website.md index 5a055464d..6ed701a79 100644 --- a/docs/advance/website/website.md +++ b/docs/advance/website/website.md @@ -6,14 +6,14 @@ sidebar_position: 7 # 建设服务器 -本部分的章节将会教你如何搭建一个功能完善的 MC 服务器官网,本部分全部基于 NamelessMC 框架 +本部分的章节将会教你如何搭建一个功能完善的 MC 服务器官网，本部分全部基于 NamelessMC 框架 ## NamelessMC -**NamelessMC**是一个免费、开源的Minecraft服务器网站软件，专为Minecraft服务器社区设计。它提供了完整的论坛系统、用户管理功能和丰富的Minecraft服务器集成选项。 +**NamelessMC** 是一个免费、开源的 Minecraft 服务器网站软件，专为 Minecraft 服务器社区设计。它提供了完整的论坛系统、用户管理功能和丰富的 Minecraft 服务器集成选项。 [详细功能可以查看 Wiki](https://docs.namelessmc.com/en/home) ![](_images/img_7.png) -相比于 Xenforo,NamelessMC 提供更多与 MC 集成的功能,比如黑/白名单同步等功能 +相比于 Xenforo、NamelessMC 提供更多与 MC 集成的功能，比如黑/白名单同步等功能 diff --git a/docs/contribution/contribution.md b/docs/contribution/contribution.md index 189f6507d..a2572d7e9 100644 --- a/docs/contribution/contribution.md +++ b/docs/contribution/contribution.md @@ -12,4 +12,4 @@ import DocCardList from '@theme/DocCardList'; -如果有一些文档完全没有涉及到的内容，请进入 [GitHub](https://github.com/postyizhan/NitWikit/issues) 提出 Issue。或者直接加入 [企鹅群🐧611076407](https://qm.qq.com/q/lEnfzgzxjq)。 +如果有一些文档完全没有涉及到的内容，请进入 [GitHub Issues](https://github.com/Cubic-Project/NitWikit/issues) 提出 Issue。或者直接加入 [企鹅群🐧1074062482](https://qm.qq.com/q/UyurWW3zyI)。 diff --git a/docs/contribution/image.md b/docs/contribution/image.md index 7266dea04..be21f9be2 100644 --- a/docs/contribution/image.md +++ b/docs/contribution/image.md @@ -19,4 +19,4 @@ pip install pillow pillow-avif-plugin tqdm pillow-jxl-plugin python convert.py . --threads 10 --delete-backup --format avif ``` -你不需要更改 markdown 文件，直接运行即可 +你不需要更改 Markdown 文件，直接运行即可 diff --git a/docs/contribution/todos.md b/docs/contribution/todos.md index 56fcd7c6f..42ae0b401 100644 --- a/docs/contribution/todos.md +++ b/docs/contribution/todos.md @@ -51,7 +51,7 @@ sidebar_position: 100 - [x] Skript 简单教程 - [x] papi list 扩展：插件自己挂钩 自己下载扩展 不需要插件的扩展 - [x] 全息图 (浮空字) 插件 -- [x] AskyBlock BentoBox(BskyBlock) +- [x] AskyBlock BentoBox (BskyBlock) - [x] 替换 ess 方案 huskhomes + XConomy - [x] 资源包插件 ia oraxen 介绍 - [x] 龙核/萌芽 介绍 @@ -93,7 +93,7 @@ sidebar_position: 100 - [ ] git 管理服务端？ - [x] 二分法和控制变量法排查问题 - [x] Q 机器人教程？ -- [x] 搭建 Frp +- [x] 搭建 frp - [x] MiniMessage 简单讲解 - [x] 怎么支持中文名的玩家 - [x] 编码问题以及如何解决 @@ -149,3 +149,23 @@ sidebar_position: 100 - [x] 代办事项 - [x] 编写规范 + +# 杂项 TODOs (待分类) + +- [ ] `/advance/bot.md` 内 TODO +- [ ] 更新 Gensokyo 的 GitHub 链接到 https://github.com/Hoshinonyaruko/Gensokyo-MCP +- [ ] 搜索所有 包含 Ubuntu / Redhat 的 tabs，规范顺序 +- [ ] 搜索并检查所有括号 () 和 并列顿号的使用 (是否用成逗号了) +- [ ] 搜索并列出所有文档内 TODO (搜索 ``) +- [ ] 是否需要去除所有文档开头的 # 标题，因为已经在 title 内定义，不确定是否要去除这个以减少冗余 +- [ ] 更新 Cloudflare 高防信息，400 多 Tbps 了 +- [ ] 可能仍存在部分货币格式不规范 +- [ ] 把文档文件名和包名都改为 `kebab-case` 并更新所有 .md 文档内引用 (使用 `pnpm build` 进行检查) +- [ ] 迁移 TODOs 到 Projects +- [ ] 是否要规范 ` ## 链接之间增加空格 正确： @@ -51,11 +52,11 @@ sidebar_position: 6 错误： ```text -怎样解决苦难？ -只要活着，我们每一个人，都会面临苦难。 +怎样解决苦难？ +只要活着，我们每一个人，都会面临苦难。 ``` -可以在 VSCode `查看 > 外观 > 显示空格` 处启用空格高亮的功能。 +可以在 VS Code `查看 > 外观 > 显示空格` 处启用空格高亮的功能。 ## 空行 @@ -64,3 +65,4 @@ sidebar_position: 6 - 文件末尾空一行 强烈建议文件末尾空一行，大多数格式检查工具都会检查文件末尾的空行。文件末尾增加空行的可能原因是为了方便进行文件拼接处理。 - 标题前后各空一行 + diff --git a/docs/contribution/writing-specification/code-examples.md b/docs/contribution/writing-specification/code-examples.md index d55cdd4d2..a1c9afe00 100644 --- a/docs/contribution/writing-specification/code-examples.md +++ b/docs/contribution/writing-specification/code-examples.md @@ -116,7 +116,7 @@ NitWikit 支持多种编程语言的语法高亮，包括但不限于： - SQL/JSON/YAML/TOML - Shell 脚本/Bash - Docker/Nginx/Apache -- 更多语言请查看[Prism.js 支持的语言列表](https://prismjs.com/#supported-languages) +- 更多语言请查看 [Prism.js 支持的语言列表](https://prismjs.com/#supported-languages) ## 使用示例 diff --git a/docs/contribution/writing-specification/documentation-system.md b/docs/contribution/writing-specification/documentation-system.md index 5093854ed..eeabd780a 100644 --- a/docs/contribution/writing-specification/documentation-system.md +++ b/docs/contribution/writing-specification/documentation-system.md @@ -9,30 +9,30 @@ sidebar_position: 7 软件手册是一部完整的书，建议采用下面的结构。 -- **简介**(Introduction)：[必备] [文件] 提供对产品和文档本身的总体的、扼要的说明 -- **快速上手**(Getting Started)：[可选] [文件] 如何最快速地使用产品 -- **入门篇**(Basics)：[必备] [目录] 又称“使用篇”，提供初级的使用教程 - - **环境准备**(Prerequisite)：[必备] [文件] 软件使用需要满足的前置条件 - - **安装**(Installation)：[可选] [文件] 软件的安装方法 - - **设置**(Configuration)：[必备] [文件] 软件的设置 -- **进阶篇**(Advanced)：[可选] [目录] 又称“开发篇”，提供中高级的开发教程 -- **API**(Reference)：[可选] [目录 | 文件] 软件 API 的逐一介绍 +- **简介** (Introduction)：[必备] [文件] 提供对产品和文档本身的总体的、扼要的说明 +- **快速上手** (Getting Started)：[可选] [文件] 如何最快速地使用产品 +- **入门篇** (Basics)：[必备] [目录] 又称“使用篇”，提供初级的使用教程 + - **环境准备** (Prerequisite)：[必备] [文件] 软件使用需要满足的前置条件 + - **安装** (Installation)：[可选] [文件] 软件的安装方法 + - **设置** (Configuration)：[必备] [文件] 软件的设置 +- **进阶篇** (Advanced)：[可选] [目录] 又称“开发篇”，提供中高级的开发教程 +- **API** (Reference)：[可选] [目录 | 文件] 软件 API 的逐一介绍 - **FAQ**：[可选] [文件] 常见问题解答 -- **附录**(Appendix)：[可选] [目录] 不属于教程本身、但对阅读教程有帮助的内容 - - **Glossary**：[可选] [文件] 名词解释 - - **Recipes**：[可选] [文件] 最佳实践 - - **Troubleshooting**：[可选] [文件] 故障处理 - - **ChangeLog**：[可选] [文件] 版本说明 - - **Feedback**：[可选] [文件] 反馈方式 +- **附录** (Appendix)：[可选] [目录] 不属于教程本身、但对阅读教程有帮助的内容 + - **Glossary**：[可选] [文件] 名词解释 + - **Recipes**：[可选] [文件] 最佳实践 + - **Troubleshooting**：[可选] [文件] 故障处理 + - **ChangeLog**：[可选] [文件] 版本说明 + - **Feedback**：[可选] [文件] 反馈方式 下面是两个真实范例，可参考。 - [Redux 手册](https://redux.js.org/introduction/getting-started) - [Atom 手册](http://flight-manual.atom.io/) -## 文件名 +## 文件名和包名 -文档的文件名不得含有空格。 +文档的文件名和包名不得含有空格和特殊符号，并且需要使用 [烤串命名法 (kebab-case)](https://developer.mozilla.org/zh-CN/docs/Glossary/Kebab_case) @@ -42,7 +42,7 @@ sidebar_position: 7 正确：名词解释.md ``` -文件名建议只使用小写字母，不使用大写字母。 +文件名需使用小写字母，不使用大写字母。 ```text 错误：TroubleShooting.md @@ -50,12 +50,12 @@ sidebar_position: 7 正确：troubleshooting.md ``` -为了醒目，某些说明文件的文件名，可以使用大写字母，比如`README`、`LICENSE`。 +为了醒目，某些说明文件的文件名，可以使用大写字母，比如 `README`、`LICENSE`。 -文件名包含多个单词时，单词之间建议使用半角的连词线 (`-`) 分隔。 +文件名包含多个单词时，单词之间使用半角的连词线 (`-`) 分隔。 ```text -不佳：advanced_usage.md +错误：advanced_usage.md 正确：advanced-usage.md ``` diff --git a/docs/contribution/writing-specification/numerical-value.md b/docs/contribution/writing-specification/numerical-value.md index 9a0b7299e..da227f5d7 100644 --- a/docs/contribution/writing-specification/numerical-value.md +++ b/docs/contribution/writing-specification/numerical-value.md @@ -23,7 +23,7 @@ sidebar_position: 4 XXX 公司的实收资本为 ￥1,258,000 人民币。 ``` -对于 4 位的数值，千分号是选用的，比如`1000`和`1,000`都可以接受。对于 4 位以上的数值，应添加千分号。 +对于 4 位的数值，千分号是选用的，比如 `1000` 和 `1,000` 都可以接受。对于 4 位以上的数值，应添加千分号。 ## 货币 diff --git a/docs/contribution/writing-specification/paragraph.md b/docs/contribution/writing-specification/paragraph.md index a6055845a..08281decc 100644 --- a/docs/contribution/writing-specification/paragraph.md +++ b/docs/contribution/writing-specification/paragraph.md @@ -54,9 +54,9 @@ One man’s constant is another man’s variable. — Alan Perlis `GitHub` https://github.com -`文档(英文)` https://xxx +`文档 (英文)` https://xxx -`文档(中文)` https://xxx +`文档 (中文)` https://xxx `插件百科` https://mineplugin.org @@ -66,4 +66,4 @@ One man’s constant is another man’s variable. — Alan Perlis 如果文档只有一个，不需要标注是中文还是英文 -明确**大小写**，完全按照此页中的大小写样式 +明确 **大小写**，完全按照此页中的大小写样式 diff --git a/docs/contribution/writing-specification/reference.md b/docs/contribution/writing-specification/reference.md index 0e255ff80..13c54ccff 100644 --- a/docs/contribution/writing-specification/reference.md +++ b/docs/contribution/writing-specification/reference.md @@ -7,3 +7,4 @@ sidebar_position: 8 - [document-style-guide](https://github.com/ruanyf/document-style-guide) - [基于 Markdown 的中文文档排版规范](https://zhuanlan.zhihu.com/p/144446995) +- [Markdown 中文教程](https://www.markdownlang.com/zh/) diff --git a/docs/contribution/writing-specification/text.md b/docs/contribution/writing-specification/text.md index 42118bc6d..0051561c6 100644 --- a/docs/contribution/writing-specification/text.md +++ b/docs/contribution/writing-specification/text.md @@ -215,7 +215,7 @@ IOC(International Olympic Committee，国际奥林匹克委员会)。这样定 我们的客户有 g ｲんĤЦ8、ｷ ouЯƧqu ﾑгє、๓เςг๏ร๏Ŧt ς๏гק๏гคtเ๏ภn、900913、ƒ4 ᄃëв๏๏к，IПᄃ.。 ``` -注意：当网页中需要配合整体视觉风格而出现全部大写／小写的情形，HTML 中请使用标淮的大小写规范进行书写；并通过 text-transform: uppercase;／text-transform: lowercase; 对表现形式进行定义。 +注意：当网页中需要配合整体视觉风格而出现全部大写／小写的情形，HTML 中请使用标淮的大小写规范进行书写；并通过 `text-transform: uppercase;／text-transform: lowercase;` 对表现形式进行定义。 ### 不要使用不地道的缩写 diff --git a/docs/contribution/writing-specification/title.md b/docs/contribution/writing-specification/title.md index 20723d09c..1baddd767 100644 --- a/docs/contribution/writing-specification/title.md +++ b/docs/contribution/writing-specification/title.md @@ -40,7 +40,7 @@ sidebar_position: 1 (2) 标题要避免孤立编号 (即同级标题只有一个)。 -示例：下面的文章结构，`二级标题 A`只包含一个三级标题，完全可以省略`三级标题 A`。 +示例：下面的文章结构，`二级标题 A` 只包含一个三级标题，完全可以省略 `三级标题 A`。 ```markdown ## 二级标题 A @@ -62,7 +62,7 @@ sidebar_position: 1 (4) 谨慎使用四级标题，尽量避免出现，保持层级的简单，防止出现过于复杂的章节。 -如果三级标题下有并列性的内容，建议只使用项目列表 (Item list)。 +如果三级标题下有并列性的内容，建议只使用项目列表 (Item List)。 示例：下面的结构二要好于结构一。结构一适用的场景，主要是较长篇幅的内容。 diff --git a/docs/contribution/writing-specification/writing-specification.md b/docs/contribution/writing-specification/writing-specification.md index f90790a8f..f531ea094 100644 --- a/docs/contribution/writing-specification/writing-specification.md +++ b/docs/contribution/writing-specification/writing-specification.md @@ -9,7 +9,7 @@ slug: /contribution/writing :::tip[提示~] -若格式不规范但不会或不想排版时请在 PR 时提出**文档需排版**) +若格式不规范但不会或不想排版时请在 PR 时提出 **文档需排版**) ::: diff --git a/docs/intro.md b/docs/intro.md index 7a9993c7f..428c2aa8b 100644 --- a/docs/intro.md +++ b/docs/intro.md @@ -9,14 +9,14 @@ sidebar_position: 1 👋 欢迎来到笨蛋开服教程！ -笨蛋开服教程是一篇主要针对 **高版本 Java 版** 和 **基岩版**服务器的开服指南，而非**远古核心**。 +笨蛋开服教程是一篇主要针对 **高版本 Java 版** 和 **基岩版** 服务器的开服指南，而非 **远古核心**。 在开始前，请确认你拥有以下基础： -- 具备**基础**的计算机操作技能 - 如解压、新建文件夹、打开文件、安装软件等； -- 具备使用**搜索引擎**搜索关键词的能力； -- 拥有一台能够**正常游玩 Minecraft** 的电脑。 -- 具有一定的**英语基础** +- 具备 **基础** 的计算机操作技能 - 如解压、新建文件夹、打开文件、安装软件等； +- 具备使用 **搜索引擎** 搜索关键词的能力； +- 拥有一台能够 **正常游玩 Minecraft** 的电脑。 +- 具有一定的 **英语基础** ## 教程适合的群体 @@ -38,7 +38,7 @@ sidebar_position: 1 ## 更多 -对于文档中的错误请进入 [GitHub](https://github.com/Cubic-Project/NitWikit) 提出 Issue 或提交 Pr。 +对于文档中的错误请进入 [GitHub](https://github.com/Cubic-Project/NitWikit) 提出 Issue 或提交 PR。 ## 本节视频教程 diff --git a/docs/loss-thing.md b/docs/loss-thing.md index e384a7b5e..7c45f73ce 100644 --- a/docs/loss-thing.md +++ b/docs/loss-thing.md @@ -7,4 +7,4 @@ sidebar_position: 102 请检查一下，你是不是应该看 Java 或 Bedrock 板块而不是这个 通用 板块 -![](_images/少东西了？.png) +![](_images/少东西了.png) diff --git a/docs/preparation/_images/instruction-web-of-lagecy-versions.png b/docs/preparation/_images/instruction-web-of-lagecy-versions.png deleted file mode 100644 index 2022d5498..000000000 Binary files a/docs/preparation/_images/instruction-web-of-lagecy-versions.png and /dev/null differ diff --git a/docs/preparation/_images/instruction-website-of-python.png b/docs/preparation/_images/instruction-website-of-python.png deleted file mode 100644 index 7e8d77b75..000000000 Binary files a/docs/preparation/_images/instruction-website-of-python.png and /dev/null differ diff --git "a/docs/preparation/_images/\346\234\272\345\231\250\344\272\272\345\221\275\344\273\244/lezi_wiki.png" "b/docs/preparation/_images/\346\234\272\345\231\250\344\272\272\345\221\275\344\273\244/lezi_wiki.png" deleted file mode 100644 index f731c93fe..000000000 Binary files "a/docs/preparation/_images/\346\234\272\345\231\250\344\272\272\345\221\275\344\273\244/lezi_wiki.png" and /dev/null differ diff --git "a/docs/preparation/_images/\346\234\272\345\231\250\344\272\272\345\221\275\344\273\244/mcping.png" "b/docs/preparation/_images/\346\234\272\345\231\250\344\272\272\345\221\275\344\273\244/mcping.png" deleted file mode 100644 index 985bb28c2..000000000 Binary files "a/docs/preparation/_images/\346\234\272\345\231\250\344\272\272\345\221\275\344\273\244/mcping.png" and /dev/null differ diff --git a/docs/preparation/dumb-script-using.md b/docs/preparation/dumb-script-usage.md similarity index 79% rename from docs/preparation/dumb-script-using.md rename to docs/preparation/dumb-script-usage.md index d2e9d8981..4fd35021b 100644 --- a/docs/preparation/dumb-script-using.md +++ b/docs/preparation/dumb-script-usage.md @@ -5,7 +5,7 @@ sidebar_position: 4 # 笨蛋脚本使用 -笨蛋脚本是由本 wiki 的作者之一 lilingfeng 编写的，专门为笨蛋设计的，你只需要双击启动，回答几个问题就能帮你自动完成。 +笨蛋脚本是由本 Wiki 的作者之一 lilingfeng 编写的，专门为笨蛋设计的，你只需要双击启动，回答几个问题就能帮你自动完成。 ## 下载 @@ -48,13 +48,13 @@ sidebar_position: 4 我们提供其他操作系统的二进制分发文件 (注意：二进制分发仅可以在 64 位操作系统上运行，Windows 只支持 Win10 以上) -[Linux](https://github.com/lilingfengdev/NitWiki-Script/releases/tag/ubuntu-latest) +[Linux](https://github.com/Cubic-Project/NitWiki-Script/releases/tag/ubuntu-latest) -[MacOS (真的有人会用 Mac 开服吗？)](https://github.com/lilingfengdev/NitWiki-Script/releases/tag/macos-latest) +[macOS (真的有人会用 Mac 开服吗？)](https://github.com/Cubic-Project/NitWiki-Script/releases/tag/macos-latest) 32 位操作系统或 Win7 需要自己安装 Python，并安装以下依赖 (一大堆) -```shell +```bash pip install pyyaml install-jdk tqdm psutil requests rtoml ``` @@ -62,15 +62,15 @@ pip install pyyaml install-jdk tqdm psutil requests rtoml 考虑到国内 GitHub 的牛逼访问速度，我们为笨蛋脚本提供了下载镜像 -比如我拿到的 GitHub 链接是`https://github.com/lilingfengdev/NitWiki-Script/releases/download/ubuntu-latest/auto-antiseedcracker.bin` +比如我拿到的 GitHub 链接是 `https://github.com/Cubic-Project/NitWiki-Script/releases/download/ubuntu-latest/auto-antiseedcracker.bin` -替换`https://github.com/lilingfengdev/NitWiki-Script/releases/download`为`https://dl.8aka.org`就可以体验极速下载 +替换 `https://github.com/Cubic-Project/NitWiki-Script/releases/download` 为 `https://dl.8aka.org` 就可以体验极速下载 ## 了解 在启动这个脚本之前，你应该 **明白你正在干什么，会导致什么后果**，以优化脚本举例，你应该明白，执行这个脚本之后，村民的 AI 会受到限制，变得有点傻 (当然不止这个，还有其他后果，此处不详谈)。 -我们拒绝回答一切在启动笨蛋脚本之前不看文档导致的问题~~(除非打钱)~~。 +我们拒绝回答一切在启动笨蛋脚本之前不看文档导致的问题 ~~(除非打钱)~~。 ## 宗旨 diff --git a/docs/preparation/java/_images/Zulu-1.png b/docs/preparation/java/_images/Zulu-1.png deleted file mode 100644 index cc66b279a..000000000 Binary files a/docs/preparation/java/_images/Zulu-1.png and /dev/null differ diff --git a/docs/preparation/java/_images/Zulu-2.png b/docs/preparation/java/_images/Zulu-2.png deleted file mode 100644 index b5e204478..000000000 Binary files a/docs/preparation/java/_images/Zulu-2.png and /dev/null differ diff --git a/docs/preparation/java/_images/Zulu-3.png b/docs/preparation/java/_images/Zulu-3.png deleted file mode 100644 index d42847443..000000000 Binary files a/docs/preparation/java/_images/Zulu-3.png and /dev/null differ diff --git a/docs/preparation/java/choose-and-download-and-install-java.md b/docs/preparation/java/choose-and-download-and-install-java.md index 18e1916bd..12d1ecaad 100644 --- a/docs/preparation/java/choose-and-download-and-install-java.md +++ b/docs/preparation/java/choose-and-download-and-install-java.md @@ -8,9 +8,9 @@ sidebar_position: 1 ## 选择版本 :::warning -部分服务端有在项目的 README 中标注最低版本和推荐版本，例如 [Beast](https://github.com/HomoMC/Beast)，最低版本为 Java -8，推荐版本为 Java 21 -MOD 服务端 + +部分服务端有在项目的 README 中标注最低版本和推荐版本，例如 [Beast](https://github.com/HomoMC/Beast)，最低版本为 Java 8，推荐版本为 Java 21 mod 服务端 + ::: ### 常见插件端 (Paper 等) @@ -65,9 +65,9 @@ MOD 服务端 | --------- | ------------------------------------------------------------------------------------------------- | | Java 8 | [Dragonwell](https://dragonwell-jdk.io/) | | Java 11 | [Dragonwell](https://dragonwell-jdk.io/) | -| Java 17 | [Zulu](https://d10.injdk.cn/openjdk/zulu/17/) | -| Java 21 | [GraalVM](https://d10.injdk.cn/openjdk/graalvm/21/) [Zulu](https://d10.injdk.cn/openjdk/zulu/21/) | -| Java 24 | [GraalVM](https://d10.injdk.cn/openjdk/graalvm/24/) [Zulu](https://d10.injdk.cn/openjdk/zulu/24/) | +| Java 17 | [Azul Zulu](https://d10.injdk.cn/openjdk/zulu/17/) | +| Java 21 | [GraalVM](https://d10.injdk.cn/openjdk/graalvm/21/) / [Azul Zulu](https://d10.injdk.cn/openjdk/zulu/21/) | +| Java 24 | [GraalVM](https://d10.injdk.cn/openjdk/graalvm/24/) / [Azul Zulu](https://d10.injdk.cn/openjdk/zulu/24/) | @@ -111,7 +111,7 @@ https://www.java.com/zh-CN/download/
-如果你想进行 JVM 优化，请看 [JVM 优化](/Java/optimize/jvm) +如果你想进行 JVM 优化，请看 [JVM 优化](/java/optimize/jvm) ## 验证 Java 安装 @@ -123,7 +123,7 @@ https://www.java.com/zh-CN/download/ 输入： -```shell +```bash java -version ``` @@ -151,4 +151,4 @@ java -version ## 本节视频教程 -[**点此前往 B 站**: 笨蛋级 MC 开服教程 - 第三集 P1:实机演示安装 JAVA](https://www.bilibili.com/video/BV1eT42167iZ/) +[**点此前往 B 站**: 笨蛋级 MC 开服教程 - 第三集 P1:实机演示安装 Java](https://www.bilibili.com/video/BV1eT42167iZ/) diff --git a/docs/preparation/java/environment.md b/docs/preparation/java/environment.md index e4c60d5d7..59ada3721 100644 --- a/docs/preparation/java/environment.md +++ b/docs/preparation/java/environment.md @@ -71,7 +71,7 @@ TODO ::: -点击“**新建**”，在 2 处输入你的 Java 路径，接着回车，可以看到像 3 一样写入了。 +点击“**新建**”，在 `2` 处输入你的 Java 路径，接着回车，可以看到像 `3` 一样写入了。 ![](./_images/environment-new-1.png) @@ -89,9 +89,9 @@ TODO ## 优先级 -可以看到，在名为“**编辑环境变量**”的界面中，我安装包安装的两个 Java（zulu 8 和 zulu 21）都有环境变量（红框部分）。 +可以看到，在名为“**编辑环境变量**”的界面中，我安装包安装的两个 Java（Zulu 8 和 Zulu 21）都有环境变量（红框部分）。 -选中 zulu 8 并 点击“**上移**”。（绿色箭头） +选中 Zulu 8 并 点击“**上移**”。（绿色箭头） 接着点击下方“**确定**”关闭“**编辑环境变量**”界面，接着点击“**环境变量**”面板的“**确定**”。 diff --git a/docs/preparation/java/FAQ.md b/docs/preparation/java/faq.md similarity index 100% rename from docs/preparation/java/FAQ.md rename to docs/preparation/java/faq.md diff --git a/docs/preparation/java/java.md b/docs/preparation/java/java.md index 0794666f0..d61401481 100644 --- a/docs/preparation/java/java.md +++ b/docs/preparation/java/java.md @@ -25,7 +25,7 @@ JDK (Java Development Kit) 又称 J2SDK (Java2 Software Development Kit)，是 J 运行环境 (JRE)，一堆 Java 工具 tools.jar 和 Java 标准类库 (rt.jar) -总结：**开服最好选择 JDK**，这样不会因为一些插件/Mod 使用类似 ByteBuddy 等黑魔法导致报错，也可以轻松使用 Arthas 等分析工具 +总结：**开服最好选择 JDK**，这样不会因为一些插件/mod 使用类似 ByteBuddy 等黑魔法导致报错，也可以轻松使用 Arthas 等分析工具 并且像 Pufferfish 之类的端可以使用 JDK 中的 SIMD 进行优化 diff --git a/docs/preparation/java/path.md b/docs/preparation/java/path.md index 693431be2..ab5e722c8 100644 --- a/docs/preparation/java/path.md +++ b/docs/preparation/java/path.md @@ -15,15 +15,15 @@ sidebar_position: 3 实际上，严格的相对路径写法应为 `.\system32\cmd.exe`。 -其中，.表示当前路径，在通道情况下可以省略，只有在特殊的情况下不能省略。 +其中，"`.\`" 表示当前路径，在特定情况下可以省略，只有在特殊的情况下不能省略。 ## 绝对路径 -例如，当你机器上安装了多个 Java（假设为 zulu 8 和 zulu 21）。 +例如，当你机器上安装了多个 Java（假设为 Zulu 8 和 Zulu 21）。 -你想在启动 服务器 A 时使用 zulu 8，启动 服务器 B 时使用 zulu 21。 +你想在启动 服务器 A 时使用 Zulu 8，启动 服务器 B 时使用 Zulu 21。 -那么最简单直接的办法就是 `"Java路径" -jar server.jar`。 +那么最简单直接的办法就是直接指定 Java 路径，`"Java路径" -jar server.jar`。 比如： @@ -49,10 +49,10 @@ sidebar_position: 3 .\zulu-21\bin\java.exe -jar server.jar ``` -就会使用这个目录下 zulu-21。这样就将 Java“打包”进服务端了。 +就会使用这个目录下的 zulu-21。这样就将 Java“打包”进服务端了。 -其中，.表示当前路径，在通道情况下可以省略，只有在特殊的情况下不能省略。 +其中，"`.\`" 表示当前路径，在通道情况下可以省略，只有在特殊的情况下不能省略。 -另外，可以用 ".." 表示当前所处的文件夹上一级文件夹的绝对路径。 +另外，可以用 "`..\`" 表示当前所处的文件夹上一级文件夹的绝对路径。 但是我很少见到在 Minecraft 服务器的启动脚本中使用它，有需要可以自行研究。 diff --git a/docs/preparation/java/sdkman.md b/docs/preparation/java/sdkman.md index cbf13b1cd..4f7dc34e1 100644 --- a/docs/preparation/java/sdkman.md +++ b/docs/preparation/java/sdkman.md @@ -1,15 +1,17 @@ --- -title: SDKMAN +title: SDKMAN! sidebar_position: 4 --- -# SDKMAN + -SDKMAN 是一个用于管理多个软件开发工具包版本的工具，特别适合需要在不同 Java 版本之间切换的开发者和服务器管理员。 +# SDKMAN! -## 什么是 SDKMAN +SDKMAN! 是一个用于管理多个软件开发工具包版本的工具，特别适合需要在不同 Java 版本之间切换的开发者和服务器管理员。 -SDKMAN (Software Development Kit Manager) 可以让你： +## 什么是 SDKMAN! + +SDKMAN! (Software Development Kit Manager) 可以让你： - 安装多个 Java 版本 - 在不同版本间快速切换 @@ -18,11 +20,11 @@ SDKMAN (Software Development Kit Manager) 可以让你： :::tip -SDKMAN 特别适合需要管理多个 Minecraft 服务器的用户，不同版本的服务器可能需要不同的 Java 版本。 +SDKMAN! 特别适合需要管理多个 Minecraft 服务器的用户，不同版本的服务器可能需要不同的 Java 版本。 ::: -## 安装 SDKMAN +## 安装 SDKMAN! ### Linux / macOS / WSL @@ -40,7 +42,7 @@ source "$HOME/.sdkman/bin/sdkman-init.sh" ### Windows -SDKMAN 原生不支持 Windows，但可以通过以下方式使用： +SDKMAN! 原生不支持 Windows，但可以通过以下方式使用： 1. **WSL (推荐)**: 在 Windows Subsystem for Linux 中安装 2. **Git Bash**: 在 Git Bash 中安装 (可能不稳定) @@ -107,7 +109,7 @@ Available Java Versions for Linux 64bit # 安装 Java 21 (Temurin) sdk install java 21.0.1-tem -# 安装 Java 17 (Zulu) +# 安装 Java 17 (Azul Zulu) sdk install java 17.0.9-zulu # 安装 Java 11 (Dragonwell) @@ -211,13 +213,13 @@ java -Xmx4G -Xms4G -jar server.jar nogui :::warning 1. 使用 `sdk use` 命令只在当前终端会话中生效 -2. 如果需要在启动脚本中使用，必须先初始化 SDKMAN 环境 +2. 如果需要在启动脚本中使用，必须先初始化 SDKMAN! 环境 ::: :::danger -不要在使用 SDKMAN 管理 Java 的同时手动修改 `JAVA_HOME` 环境变量，这可能导致冲突。 +不要在使用 SDKMAN! 管理 Java 的同时手动修改 `JAVA_HOME` 环境变量，这可能导致冲突。 ::: diff --git a/docs/preparation/services.md b/docs/preparation/services.md index c63b920f8..d0151db92 100644 --- a/docs/preparation/services.md +++ b/docs/preparation/services.md @@ -8,7 +8,7 @@ import GlobalContent from '@site/src/components/GlobalContent' # 笨蛋服务 -这些服务由赛博菩萨 cloudflare 和 lilingfeng 搭建，完全免费提供！ +这些服务由赛博菩萨 Cloudflare 和 lilingfeng 搭建，完全免费提供！ 目前包括 @@ -25,7 +25,7 @@ import GlobalContent from '@site/src/components/GlobalContent' **不要滥用，不要上传违法文件!!!!!** -图床最大上传 20MB 的图片或视频 +图床最大上传 20 MB 的图片或视频 ## 免费域名 @@ -37,4 +37,4 @@ import GlobalContent from '@site/src/components/GlobalContent' 对于文档中一些下载慢的资源可以申请提供下载镜像，如果已有镜像，在经过安全性评估后会在文档中提供，如果没有，会提供笨蛋文档维护的镜像 -官方下载镜像域名`dl.8aka.org` +官方下载镜像域名 `dl.8aka.org` diff --git a/docs/preparation/text-editor.md b/docs/preparation/text-editor.md index 1d1b74826..ccfd735cc 100644 --- a/docs/preparation/text-editor.md +++ b/docs/preparation/text-editor.md @@ -5,7 +5,7 @@ sidebar_position: 2 # 文本编辑器 -一个好用的文本编辑器是**相当**重要的，本文将介绍几个开服常用的文本编辑器。 +一个好用的文本编辑器是 **相当** 重要的，本文将介绍几个开服常用的文本编辑器。 :::warning @@ -37,11 +37,11 @@ sidebar_position: 2 ![](_images/白点.png) -VSCode 会在未保存的文件后标记一个白点，提示你这个文件编辑了但是没有保存 (其他文本编辑器类似)。 +VS Code 会在未保存的文件后标记一个白点，提示你这个文件编辑了但是没有保存 (其他文本编辑器类似)。 -![](_images/vscode保存和自动保存.png) +![](_images/vscode保存和自动保存.png) -保存按钮 (红色箭头)，也可以用快捷键来保存 Ctrl + S。 +保存按钮 (红色箭头)，也可以用快捷键来保存 `Ctrl + S`。 开启自动保存 (绿色箭头)。 @@ -51,7 +51,7 @@ VSCode 会在未保存的文件后标记一个白点，提示你这个文件编 [下载龟速怎么办](https://cn.bing.com/search?q=vscode%E4%B8%8B%E8%BD%BD%E9%BE%9F%E9%80%9F%E6%80%8E%E4%B9%88%E5%8A%9E) -[VSCode 视频安装教程](https://www.bilibili.com/video/BV1nM4m117Fv/?share_source=copy_web) +[VS Code 视频安装教程](https://www.bilibili.com/video/BV1nM4m117Fv/?share_source=copy_web)
@@ -60,7 +60,7 @@ VSCode 会在未保存的文件后标记一个白点，提示你这个文件编
点击展开 -![Sublime Text](_images/sublime展示.png) +![Sublime Text](_images/sublime展示.png) 我不太喜欢的一点是保存文件时，对非激活的用户有一定概率弹出个窗口，提示你去付费支持 (可以选择不支持)。但这依旧是一个非常优秀的文本编辑器。 @@ -103,7 +103,7 @@ GitHub: https://github.com/rizonesoft/Notepad3
点击展开 -![NPPesu](_images/Npp展示.png) +![NPPesu](_images/Npp展示.png) 可用，相关功能也较为完善。 @@ -111,7 +111,7 @@ GitHub: https://github.com/rizonesoft/Notepad3 作者政治立场可能引起众怒，但请理性看待： -[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)。 @@ -126,7 +126,7 @@ dizhi 08 年奥运会 声称 (仅声明，但还是挺过分的) 不同意它的
点击展开 -![Notepad--](_images/N减减展示.png) +![Notepad--](_images/N减减展示.png) 国内作者维护的 Notepad++ 的替代品。 @@ -140,7 +140,7 @@ dizhi 08 年奥运会 声称 (仅声明，但还是挺过分的) 不同意它的
点击展开 -![HbuilderX](_images/HbuilderX展示.png) +![HbuilderX](_images/HbuilderX展示.png) 官网链接：https://dcloud.io/hbuilderx.html @@ -154,7 +154,7 @@ dizhi 08 年奥运会 声称 (仅声明，但还是挺过分的) 不同意它的 ### 关联右键菜单？ -可以在工具→设置 (Ctrl+Alt+，) 打开设置，找到“常用配置”手动选中【关联右键菜单】。 +可以在工具→设置 (Ctrl + Alt + ，) 打开设置，找到“常用配置”手动选中【关联右键菜单】。
diff --git "a/docs/process/_images/\345\215\225\344\270\252\346\226\271\345\235\227\345\205\203\347\264\240vs\345\244\232\345\205\203\347\264\240\347\273\204\345\220\210.jpg" "b/docs/process/_images/\345\215\225\344\270\252\346\226\271\345\235\227\345\205\203\347\264\240vs\345\244\232\345\205\203\347\264\240\347\273\204\345\220\210.jpg" deleted file mode 100644 index 5bc6a239a..000000000 Binary files "a/docs/process/_images/\345\215\225\344\270\252\346\226\271\345\235\227\345\205\203\347\264\240vs\345\244\232\345\205\203\347\264\240\347\273\204\345\220\210.jpg" and /dev/null differ diff --git a/docs/process/create-art-assets.md b/docs/process/create-art-assets.md index 348f926f7..60847d8ed 100644 --- a/docs/process/create-art-assets.md +++ b/docs/process/create-art-assets.md @@ -61,7 +61,7 @@ Blockbench 中提供了自动 UV 功能 ### 混素 (Mixels) -如果说“像素”(pixel) 是图片元素 (pix + el)，混素 (mixel) 就是混合了多种分辨率的元素，无论 2D 还是 3D 都混在了一起。 +如果说“像素” (pixel) 是图片元素 (pix + el)，混素 (mixel) 就是混合了多种分辨率的元素，无论 2D 还是 3D 都混在了一起。 大多数低规格的艺术完全避免混素，一般来说，MC 艺术不允许混素 (某些模型上略微膨胀的元素除外)，模型上的混素表现为两种：小于 1px 的元素 (或 Blockbench 中的 1 个比例单位)、过度膨胀的元素。 均衡的细节分布 vs 失衡的细节分布 @@ -90,9 +90,9 @@ MC 中方块的尺寸是 16x16x16 像素，对应 1 立方米，单个像素长 色相 (Hue) 是由波长决定的色系 (例：棕色变成红色或橙色，海蓝宝石色变成蓝色)，它可以视作是色环中的一个点，范围是 0-360 度 (环状)。 -饱和度 (Saturation) 是指颜色的强度，对于指定的色相，饱和度越高、色相越强，它的范围是 0-100(水平轴)。 +饱和度 (Saturation) 是指颜色的强度，对于指定的色相，饱和度越高、色相越强，它的范围是 0-100 (水平轴)。 -明度 (Value) 是颜色的亮度，值越高颜色越亮，范围是 0-100(垂直轴)。 +明度 (Value) 是颜色的亮度，值越高颜色越亮，范围是 0-100 (垂直轴)。 常见的 HSV 调节面板 @@ -104,7 +104,7 @@ MC 中方块的尺寸是 16x16x16 像素，对应 1 立方米，单个像素长 改变阴影颜色 HSV 的行为称作偏移 (色相偏移、饱和度偏移、明度偏移)，保持多个颜色间的跨度平衡很重要。 -当我们说“线性渐变”(Straight Ramp) 时，指的是一系列渐变色只做了明度的差异化。线性渐变做起来容易，但外观上过于沉闷、用到的地方不多，它们可以适用于某些材料和颜色。在下图中，左侧是线性渐变，右侧是色相偏移渐变。 +当我们说“线性渐变” (Straight Ramp) 时，指的是一系列渐变色只做了明度的差异化。线性渐变做起来容易，但外观上过于沉闷、用到的地方不多，它们可以适用于某些材料和颜色。在下图中，左侧是线性渐变，右侧是色相偏移渐变。 沉闷的蜜脾 vs 鲜艳诱人的蜜脾 diff --git a/docs/process/database/_images/43.png b/docs/process/database/_images/43.png deleted file mode 100644 index 56a218a60..000000000 Binary files a/docs/process/database/_images/43.png and /dev/null differ diff --git a/docs/process/database/backup.md b/docs/process/database/backup.md index ea35f5292..c5c0fa622 100644 --- a/docs/process/database/backup.md +++ b/docs/process/database/backup.md @@ -14,19 +14,19 @@ sidebar_position: 4 2. 使用以下命令格式进行备份： - ```shell + ```bash mysqldump -u [用户名] -p [数据库名] > [备份文件名].sql ``` 例如： - ```shell + ```bash mysqldump -u root -p mydb > mydb_backup.sql ``` 3. 输入密码后，系统会开始备份过程。 -4. 备份完成后，你会在当前目录下看到生成的 .sql 文件。 +4. 备份完成后，你会在当前目录下看到生成的 `.sql` 文件。 注意事项： @@ -36,13 +36,13 @@ sidebar_position: 4 要还原备份，可以使用以下命令： -```shell +```bash mysql -u [用户名] -p [数据库名] < [备份文件名].sql ``` 例如： -```shell +```bash mysql -u root -p mydb < mydb_backup.sql ``` diff --git a/docs/process/database/configure.md b/docs/process/database/configure.md index 0eb092571..3ef8232b2 100644 --- a/docs/process/database/configure.md +++ b/docs/process/database/configure.md @@ -32,11 +32,11 @@ port = 3306 socket = /tmp/mysql.sock -#设置 mysql 的安装目录，别动 +#设置 MySQL 的安装目录，别动 basedir=F:\\Hzq Soft\\MySql Server 51GA -#设置 mysql 数据库的数据的存放目录，如果你觉得原来存放数据库的地方不够用了可以迁到其他地方去 +#设置 MySQL 数据库的数据的存放目录，如果你觉得原来存放数据库的地方不够用了可以迁到其他地方去 #但是要注意把原来的存放目录里面的东西迁移到那个地方去 @@ -46,7 +46,7 @@ datadir=F:\\Hzq Soft\\MySql Server 51GA\\data #innodb_log_group_home_dir 默认 datadir -#设置 mysql 服务器的字符集，默认编码 +#设置 MySQL 服务器的字符集，默认编码 default-character-set=utf8 @@ -92,7 +92,7 @@ join_buffer_size = 32M thread_cache_size = 8 -#并发线程数量，默认为 8，可适当增加到 2 倍以内。如果有多个 CPU 可以乘 上 CPU 的数量。双核 CPU 可以乘 上当前最核数再乘 上 70%-85% +#并发线程数量，默认为 8，可适当增加到 2 倍以内。如果有多个 CPU 可以乘 上 CPU 的数量。双核 CPU 可以乘 上当前最核数再乘 上 70%～85% thread_concurrency = 16 @@ -112,7 +112,7 @@ query_cache_limit = 2M default-storage-engine = InnoDB -#线程堆栈大小，mysql 说它自己用的堆栈大小不超过 64K。这个值可适当设高一点 (在 RCA 的项目中都是共用同一个数据库连接的)，默认 192K +#线程堆栈大小，MySQL 说它自己用的堆栈大小不超过 64K。这个值可适当设高一点 (在 RCA 的项目中都是共用同一个数据库连接的)，默认 192K thread_stack = 800K @@ -164,7 +164,7 @@ bulk_insert_buffer_size = 64M myisam_max_sort_file_size = 12G -#如果一个 myisam 表有一个以上的索引，MyISAM 可以使用一个以上线程来排序并行它们。较耗硬件资源，如果你的环境不错，可以增加此值。 +#如果一个 MyISAM 表有一个以上的索引，MyISAM 可以使用一个以上线程来排序并行它们。较耗硬件资源，如果你的环境不错，可以增加此值。 myisam_repair_threads = 2 @@ -172,9 +172,9 @@ myisam_repair_threads = 2 myisam_recover -# *** INNODB Specific options *** +# *** InnoDB specific options *** -#开启下条将会禁用 INNODB +#开启下条将会禁用 InnoDB #skip-innodb @@ -182,7 +182,7 @@ myisam_recover innodb_additional_mem_pool_size = 16M -#innodb 整体缓冲池大小，不宜过大，设为本地内存的 50%-75% 比较合适，在本机开发过程中可以设得较小一点如 64M，256M +#InnoDB 整体缓冲池大小，不宜过大，设为本地内存的 50%～75% 比较合适，在本机开发过程中可以设得较小一点如 64M，256M innodb_buffer_pool_size = 256M diff --git a/docs/process/database/database.md b/docs/process/database/database.md index 47a0fc7eb..97af8819c 100644 --- a/docs/process/database/database.md +++ b/docs/process/database/database.md @@ -18,13 +18,13 @@ sidebar_position: 3 1. 数据库的备份维护等所占用的时间远比将整个服务器停止后打包压缩备份快得多; -2. 同样的数据量，MySQL 比 yml/txt/sqlite 等占用也小得多。特别是对于数据量大的插件 (30Gb 的 dynmap 文件使用 MySQL 后整个数据库将压缩到 15Gb); +2. 同样的数据量，MySQL 比 YAML/txt/SQLite 等占用也小得多。特别是对于数据量大的插件 (30 GB 的 dynmap 文件使用 MySQL 后整个数据库将压缩到 15 GB); -3. 读取速度快，某些插件使用 yml 储存数据时启动一个插件甚至需要 10s+，换用 mysql 后服务器启动速度快; +3. 读取速度快，某些插件使用 YAML 储存数据时启动一个插件甚至需要 10 s 以上，换用 MySQL 后服务器启动速度变快; 4. Redis/MySQL 等数据库配合可轻松完成玩家数据同步等; -5. 在数据量较大时候相较 sqlite 有更好的性能，查询时需要的时间短，特别是某些经济插件付款时避免卡顿。 +5. 在数据量较大时候相较 SQLite 有更好的性能，查询时需要的时间短，特别是某些经济插件付款时避免卡顿。 ::: diff --git a/docs/process/database/install.md b/docs/process/database/install.md index 02d8ff28f..2e725c7a7 100644 --- a/docs/process/database/install.md +++ b/docs/process/database/install.md @@ -8,11 +8,11 @@ sidebar_position: 1 ### 直接安装 -你可以选择直接下载安装包来安装，如果觉得麻烦，请看下面的**使用工具安装** +你可以选择直接下载安装包来安装，如果觉得麻烦，请看下面的 **使用工具安装** :::tip -[sohu MySQL 镜像源](http://mirrors.sohu.com/mysql/MySQL-8.0/) +[搜狐 MySQL 镜像源](http://mirrors.sohu.com/mysql/MySQL-8.0/) [阿里 MySQL 镜像源](https://mirrors.aliyun.com/mysql/) @@ -22,7 +22,7 @@ sidebar_position: 1 对于 MySQL 安装，请看这篇文章：[2024 年 MySQL 8.0 安装 配置 教程 最简易 (保姆级)](https://blog.csdn.net/m0_52559040/article/details/121843945) -而标着 `ubuntu` 或 `debian` 是 linux 版本的安装包，linux 用户请下载这个 +而标着 `ubuntu` 或 `debian` 是 Linux 版本的安装包，Linux 用户请下载这个 在下载的时候请务必注意自己的系统、架构等是否与安装包上标的匹配 @@ -73,7 +73,7 @@ MySQL5 版本太低了，很多插件需要更高版本的，装 MySQL8 就够 不要设置过于简单的密码！ -尤其是你打算把数据库开到公网，**绝对不要**设置过于简单的密码！ +尤其是你打算把数据库开到公网，**绝对不要** 设置过于简单的密码！ **这真的很严重** diff --git a/docs/process/database/uninstall.md b/docs/process/database/uninstall.md index 6779da6b8..df61ec21d 100644 --- a/docs/process/database/uninstall.md +++ b/docs/process/database/uninstall.md @@ -18,11 +18,11 @@ https://www.bt.cn/new/btcode.html ### 小皮数据库 -### Windows 平台： +### Windows 平台 -首先，通过 PHPStudy 的控制面板，找到 Mysql 服务，并点击“暂停”按钮 +首先，通过 PHPStudy 的控制面板，找到 MySQL 服务，并点击“暂停”按钮 -之后，找到 PHPStudy 的安装目录，找到 Mysql 的安装文件夹 +之后，找到 PHPStudy 的安装目录，找到 MySQL 的安装文件夹 注：通常命名为：MySQL 或者 mysqlXX（XX 为版本号） @@ -32,7 +32,7 @@ https://www.bt.cn/new/btcode.html 最后，我们重新启动 PHPStudy -### Linux 平台： +### Linux 平台 首先，点击左侧面板的数据库，进入数据库列表管理页面 diff --git a/docs/process/database/use.md b/docs/process/database/use.md index 8105b04c4..2865019c2 100644 --- a/docs/process/database/use.md +++ b/docs/process/database/use.md @@ -36,7 +36,7 @@ sidebar_position: 2 - 界面美观 -- premium 版本支持多种数据库的管理，如 MySQL、MangoDB 等 +- Premium 版本支持多种数据库的管理，如 MySQL、MangoDB 等 #### 劣势 @@ -51,15 +51,15 @@ sidebar_position: 2 ![](_images/25.png) -然后分别填写: +然后分别填写： - 连接名：你想让他在 Navicat 中显示的名字，方便你辨认 -- 主机：填写主机 ip 地址，如果数据库就在本地，那就填写 localhost +- 主机：填写主机 IP 地址，如果数据库就在本地，那就填写 `localhost` -- 端口：数据库使用的远程端口，默认是 3306 +- 端口：数据库使用的远程端口，默认是 `3306` -- 用户名：使用某个用户登录数据库，默认是 root +- 用户名：使用某个用户登录数据库，默认是 `root` - 密码：即登录数据库的密码，你在安装数据库的时候就已经设置过了，自己要记好！ @@ -73,7 +73,7 @@ sidebar_position: 2 否则他会报错 -一般有这几种情况导致连接不上: +一般有这几种情况导致连接不上： - 数据库主机、端口填写错误 @@ -94,7 +94,7 @@ sidebar_position: 2 ![](_images/28.png) -然后分别填写: +然后分别填写： - 数据库名：你自己想一个，之后要给插件认的，同时也方便你辨别 @@ -193,12 +193,12 @@ TODO 我们来一一介绍他们的用途 -- enabled: 是否启用 MySQL 存储数据？如果是请填 true，否则填 false，默认是 false，而且有些插件是直接让你填写数据库类型的，默认是 SQLite。 +- enabled: 是否启用 MySQL 存储数据？如果是请填 `true`，否则填 `false`，默认是 `false`，而且有些插件是直接让你填写数据库类型的，默认是 SQLite。 对于这种配置文件，请把 SQLite 改成 MySQL 或者其他你使用的数据库名。 -- host: 也就是主机地址，如果数据库在本地，请填 localhost +- host: 也就是主机地址，如果数据库在本地，请填 `localhost` -- port: 数据库端口，默认是 3306 +- port: 数据库端口，默认是 `3306` - database: 数据库名，也就是你在数据库下创建的数据库你为他设置的名字 diff --git a/docs/process/deploy/apply-for-public-ip-address.md b/docs/process/deploy/apply-for-public-ip-address.md index 6e5c21352..cb8422cdb 100644 --- a/docs/process/deploy/apply-for-public-ip-address.md +++ b/docs/process/deploy/apply-for-public-ip-address.md @@ -52,14 +52,14 @@ NAT 的网关就给局域网中的所有电脑都分配局域网 IP，然后让 ## 开通 IPv6 -通常来说国内手机流量 (移动数据) 的网络环境在绝大部分地区已经支持 IPv6。然而由于设备老旧或配置不当等原因，很多宽带 (例如家里办的宽带，网吧、酒店、饭店等公共场所的免费 Wi-Fi ) 都仍然不支持 IPv6。 +通常来说国内手机流量 (移动数据) 的网络环境在绝大部分地区已经支持 IPv6。然而由于设备老旧或配置不当等原因，很多宽带 (例如家里办的宽带，网吧、酒店、饭店等公共场所的免费 Wi-Fi) 都仍然不支持 IPv6。 如果你想知道自己正在使用的网络是否支持 IPv6，可以访问这两个网站：`ipw.cn` 和 `testipv6.cn`，它们会告诉你你现在的网络对 IPv6 的支持情况。如果你的网络还不支持 IPv6，你可能需要自行操作来开启。 由于开通 IPv6 仅仅是一个开关，但是接触到这个开关的途径每个运营商、厂商和路由器品牌的方式都不同。下面仅给出 2024 年一种可能的方式，如果其中有步骤失效，可以上网搜索其他实现该步骤的方法，或者直接上网搜索其他方法操作。 1. 检查是否已经有 IPv6 :如果是 Windows 系统，先打开任务管理器，点击性能选项卡，侧边栏找到以太网点击，下面的信息如果有显示 IPv6 地址，而且前缀不是 `fe80`，那基本就证明是已经有 IPv6 了。 国内绝大多数都是 `2408` `2409` `240e` 开头，如果是其他的你也可以百度一下这个开头，没有说是内网地址或者虚拟机就行 -2. 检查宽带是否有开通 IPv6 的条件，如果还不支持 IPv6 那么无法开通，只能换家运营商或者等运营商方面升级。有的时候宽带已经支持 IPv6，但是路由器并没有开启。路由器开启 IPv6，可以百度搜索`路由器品牌 + 怎么开 IPv6`。这里给出常见的华为路由器和 tplink 路由器的开启方法 - 华为路由器：登录后台之后，点击顶部更多功能，侧边栏找到网络设置点击展开，选择 IPv6，打开开关，下面所有选项全选择自动配置，点击保存。 - 切换到侧边栏里面的路由器信息页面，如果 IPv6 那一段显示出来的地址里面有不是 `fe80` 这种的 IPv6 地址 (可能也会有 fe80 开头的，别全都是就行)，那就是成功开启了 IPv6。- tplink 路由器：登录后台后点击底部路由设置，侧边栏找到 IPv6 设置点击，IPv6 功能调整为开启，WAN 口连接类型选择自动获取 IP 地址，点击保存。 +2. 检查宽带是否有开通 IPv6 的条件，如果还不支持 IPv6 那么无法开通，只能换家运营商或者等运营商方面升级。有的时候宽带已经支持 IPv6，但是路由器并没有开启。路由器开启 IPv6，可以百度搜索`路由器品牌 + 怎么开 IPv6`。这里给出常见的华为路由器和 TP-Link 路由器的开启方法 - 华为路由器：登录后台之后，点击顶部更多功能，侧边栏找到网络设置点击展开，选择 IPv6，打开开关，下面所有选项全选择自动配置，点击保存。 + 切换到侧边栏里面的路由器信息页面，如果 IPv6 那一段显示出来的地址里面有不是 `fe80` 这种的 IPv6 地址 (可能也会有 `fe80` 开头的，别全都是就行)，那就是成功开启了 IPv6。- TP-Link 路由器：登录后台后点击底部路由设置，侧边栏找到 IPv6 设置点击，IPv6 功能调整为开启，WAN 口连接类型选择自动获取 IP 地址，点击保存。 找到 IPv6 地址之后，跟上段华为路由器要求的效果一样就行。 如果按照上面的方法设置之后路由器里也显示 fe80 的地址，证明你的光猫也需要配置，或者宽带不支持 IPv6。现在仍然有一些小运营商和一些地区不支持 IPv6，因为网络铺设的成本在那，IPv6 的普及还需要时间。 3. 检查路由器的上网方式：此时先打开路由器的后台，查看路由器的上网方式。不会操作可以百度路由器品牌 + 怎么设置拨号上网。华为路由器点击顶部“我要上网”就可以看到上网方式，TP-Link 路由器点击底部路由设置，侧边栏找到上网设置，就可以看到上网方式。 @@ -92,15 +92,15 @@ NAT 的网关就给局域网中的所有电脑都分配局域网 IP，然后让 #### 进入路由器后台 -为了知道究竟哪个是最上游的 NAT 网关，你必须要进入其中一个设备的后台。网关的后台是一个只能由它下面的设备访问的网站。这个网站可以通过路由器的局域网 IP 地址访问，使用任何一个连接到家里 Wi-Fi 的设备都可以查看这个 IP 地址，而由于不同品牌和系统的设备查看的方法不一样，可以上网搜索“路由器的 ip 地址怎么看”，可以找到大量相关教程。 +为了知道究竟哪个是最上游的 NAT 网关，你必须要进入其中一个设备的后台。网关的后台是一个只能由它下面的设备访问的网站。这个网站可以通过路由器的局域网 IP 地址访问，使用任何一个连接到家里 Wi-Fi 的设备都可以查看这个 IP 地址，而由于不同品牌和系统的设备查看的方法不一样，可以上网搜索“路由器的 IP 地址怎么看”，可以找到大量相关教程。
- 点击展开 Windows，MacOS，Linux，iOS 和原生安卓的操作教程 + 点击展开 Windows，macOS，Linux，iOS 和原生安卓的操作教程 -- Windows：打开控制面板 (不知道怎么打开就按 Win+R 然后输入 Ctrl 回车)，点击网络和共享中心，查看活动网络下面会有一个网络几 (可能也叫别的名，反正就会显示一个网络)，点击右边那趟连接右边的蓝字，会弹出窗口“xxx 状态”， +- Windows：打开控制面板 (不知道怎么打开就按 `Win+R` 然后输入 `Ctrl + 回车`)，点击网络和共享中心，查看活动网络下面会有一个网络几 (可能也叫别的名，反正就会显示一个网络)，点击右边那趟连接右边的蓝字，会弹出窗口“xxx 状态”， 点击详细信息再弹出一个窗口，里面的 IPv4 默认网关就是路由器的 IP 地址。 -- MacOS：打开设置 (不知道的就点击菜单栏上苹果菜单展开点系统设置，旧版系统叫系统偏好设置)，点击网络，然后里面哪个绿灯了就点哪个，点进去之后点击右边有一个叫详细信息的按钮，点击会弹窗，左边选择 TCP/IP，右边显示的路由器那个地址就是自己的路由器地址。 -- Linux：执行`ip route`命令，第一行输出就是路由器 IP 地址。 +- macOS：打开设置 (不知道的就点击菜单栏上苹果菜单展开点系统设置，旧版系统叫系统偏好设置)，点击网络，然后里面哪个绿灯了就点哪个，点进去之后点击右边有一个叫详细信息的按钮，点击会弹窗，左边选择 TCP/IP，右边显示的路由器那个地址就是自己的路由器地址。 +- Linux：执行 `ip route` 命令，第一行输出就是路由器 IP 地址。 - iOS：进入设置，进入 WLAN，自己已经连接的 Wi-Fi 右侧会有一个蓝色的 i，往下翻，路由器那行的 IP 地址就是路由器地址。 - 原生安卓：进入设置，进入网络和互联网，旧版系统进入 WLAN，新版系统进入互联网，点击连接的那个 Wi-Fi 右边的齿轮，往下翻会有一个网关 (如果没有但是有个高级就把那个高级展开)，网关显示的就是路由器的地址。 @@ -147,9 +147,9 @@ NAT 的网关就给局域网中的所有电脑都分配局域网 IP，然后让 ### 主动向运营商申请公网 IPv4 -但是如果是 10 或 100 开头，就没有办法进行端口映射了吗？其实还是有一丝希望，但是**这需要你大量的努力**，因为你可以通过和运营商交涉让他们给你把 IP 变成真正的公网 IP，这一步就是主动向运营商申请公网 IP。 +但是如果是 10 或 100 开头，就没有办法进行端口映射了吗？其实还是有一丝希望，但是 **这需要你大量的努力**，因为你可以通过和运营商交涉让他们给你把 IP 变成真正的公网 IP，这一步就是主动向运营商申请公网 IP。 -首先如果你的宽带必须是**联通或电信**运营商，因为目前只有这两个运营商有相对充足的公网 IPv4 地址分配给家用宽带，其他运营商无论如何都不会给你改成真正的公网 IP。 +首先如果你的宽带必须是 **联通或电信** 运营商，因为目前只有这两个运营商有相对充足的公网 IPv4 地址分配给家用宽带，其他运营商无论如何都不会给你改成真正的公网 IP。 而联通和电信也分地区，现在尤其南方的一些省份由于人口稠密，宽带办理非常多，当地的 IPv4 地址也已经枯竭，所以当地的联通和电信有的对公网 IP 额外收费，有的则是直接不再提供，说什么也不行。 要想和这些运营商申请公网 IP，你可以打电话直接要公网，或者一些省份的电信有自助开通公网 IPv4 的渠道。 @@ -161,14 +161,14 @@ NAT 的网关就给局域网中的所有电脑都分配局域网 IP，然后让 - **运营商要求你进行报备**。有的时候不需要你自己跑去营业厅办手续签字什么的，运营商那边自己给你登记一下就行了。 - **运营商要求带宽达到某个速度以上或资费达到某个标准以上才能给公网 IP。** - **运营商要求公网要额外收费**。 -- 运营商告诉你虽然没有公网，但是他们的**上级 NAT 网关的种类是 NAT1**。 +- 运营商告诉你虽然没有公网，但是他们的 **上级 NAT 网关的种类是 NAT1**。 - **运营商打死也不给公网。** 如果联系运营商也解决不了，就没有办法进行端口映射了。可是如果不能进行端口映射，就不能在自己家开服务器了吗？办法总比困难多，下面继续介绍一种特殊但确实有效的办法。 ## 商用宽带 -上文提到，运营商不愿意推广 IPv6 有可能是因为想让用户给他们交更多的钱买商用宽带。没错，平时我们办理的都是家用宽带，而还有一种宽带可以用于商用，这种宽带一定有公网 IPv4 地址，而且很多宽带都拥有不止一个公网 IP。这种宽带一般用于公司、营业场所、专业服务器机房等。由于是商业用途，这种宽带要**比普通宽带贵得多，而且要求严格，并不是所有人都能办得了**。 +上文提到，运营商不愿意推广 IPv6 有可能是因为想让用户给他们交更多的钱买商用宽带。没错，平时我们办理的都是家用宽带，而还有一种宽带可以用于商用，这种宽带一定有公网 IPv4 地址，而且很多宽带都拥有不止一个公网 IP。这种宽带一般用于公司、营业场所、专业服务器机房等。由于是商业用途，这种宽带要 **比普通宽带贵得多，而且要求严格，并不是所有人都能办得了**。 要办这种宽带，你必须至少满足以下两个条件： diff --git a/docs/process/deploy/connect-to-the-cloud.md b/docs/process/deploy/connect-to-the-cloud.md index 3c4573bef..d9c276c85 100644 --- a/docs/process/deploy/connect-to-the-cloud.md +++ b/docs/process/deploy/connect-to-the-cloud.md @@ -11,66 +11,66 @@ sidebar_position: 4 去骚扰卖你面板的人 -## vps +## VPS
Windows 远程桌面连接 ### Windows -按下 `win 键` + `R 键` +按下 `Win + R` 键 ![](_images/连接服务器/1.png) 在弹出的窗口中输入 `mstsc` -把卖你 vps 的人给你的信息照着填进去就可以连接到你的 vps 了。 +把卖你 VPS 的人给你的信息照着填进去就可以连接到你的 VPS 了。 -你也可以在 vps 安装 [ToDesk](https://www.todesk.com/download.html) 或 [向日葵远程控制](https://sunlogin.oray.com/) 等软件 +你也可以在 VPS 安装 [ToDesk](https://www.todesk.com/download.html) 或 [向日葵远程控制](https://sunlogin.oray.com/) 等软件 #### 映射驱动器 -可以在 vps 中点击 `此电脑` 看到本地的 **驱动器**(c 盘 d 盘的，这下听懂了吧) +可以在 VPS 中点击 `此电脑` 看到本地的 **驱动器** (C 盘 D 盘的，这下听懂了吧) 方便你传输文件 -或者，你也可以 `Ctrl c` + `Ctrl v` 来传文件 +或者，你也可以 `Ctrl + C` 和 `Ctrl + V` 来传文件 ![](_images/连接服务器/2.png) ![](_images/连接服务器/3.png) -### MacOS 和手机 +### macOS 和手机 在 iOS 和 macOS 上，需要在 App Store 登录海外的 Apple ID，然后搜索 Microsoft Remote Desktop，就可以找到这个应用。 -在安卓手机上需要在 Google play 上搜索 Microsoft Remote Desktop 就可以找到这个应用，如果手机无法使用 Google play，也可以在网上搜索安装包下载。 +在安卓手机上需要在 Google Play 上搜索 Microsoft Remote Desktop 就可以找到这个应用，如果手机无法使用 Google Play，也可以在网上搜索安装包下载。 打开应用后，点击加号，点击 **Add PC** ，选择或输入那台电脑上的那串代码，然后点击添加或保存。随后点击或双击添加的那台电脑，然后输入帐号和密码，就可以连接到那台电脑。
-[Linux ssh](/advance/Linux/Connect-to-server) +[Linux SSH](../../advance/linux/connect-to-server.md) #### 放行端口 -然后你需要在防火墙放行你 mc 服务端使用的端口，可参考教程：https://blog.csdn.net/aa1213366512/article/details/119964839。 +然后你需要在防火墙放行你 MC 服务端使用的端口，可参考教程：https://blog.csdn.net/aa1213366512/article/details/119964839。 如果你使用的是家宽公网，你需要在路由器里后台放行远程桌面使用的端口，协议同时选择 TCP 和 UDP。远程桌面使用的端口为 3389，所以你需要把服务器的 **3389** 端口映射到外网。 :::danger -配置直接在公网使用 3389 端口连接服务器远程桌面**会导致严重的安全性问题**，详见 [如何抵御网络攻击](../maintenance/how-to-defend-against-cyber-attacks.md)。 +配置直接在公网使用 3389 端口连接服务器远程桌面 **会导致严重的安全性问题**，详见 [如何抵御网络攻击](../maintenance/how-to-defend-against-cyber-attacks.md)。 ::: -接着用外网地址连接你的服务器。注意，除非你直接在外网使用 3389 端口，否则连接服务器时需要使用外网端口连接，比如服务器 IP 是 8aka.org，外网使用的是 41982 端口，你就需要连接 `8aka.org:41982`，而不是`8aka.org`。 +接着用外网地址连接你的服务器。注意，除非你直接在外网使用 3389 端口，否则连接服务器时需要使用外网端口连接，比如服务器 IP 是 8aka.org，外网使用的是 41982 端口，你就需要连接 `8aka.org:41982`，而不是 `8aka.org`。 **举例，不一定正确：** 你远程桌面连接用的是 `8aka.org:12345` -你的服务商告诉你，除了`12345`，你可以使用 `12346` 端口 +你的服务商告诉你，除了 `12345`，你可以使用 `12346` 端口 -那你就把你服务端的 [端口](/Java/start/connect-to-server#端口) 设置为 `12346` ，记得 [放行端口](#放行端口) +那你就把你服务端的 [端口](/java/start/connect-to-server#端口) 设置为 `12346` ，记得 [放行端口](#放行端口) 然后在你的游戏客户端里添加服务器，填地址为 `8aka.org:12346` @@ -88,11 +88,11 @@ sidebar_position: 4 [申请公网 ip](apply-for-public-ip-address.md) -如果申请不到，那么为了在没有公网 IP 的情况下连接到你的内外机器，你需要 **内网穿透 (Frp)** +如果申请不到，那么为了在没有公网 IP 的情况下连接到你的内外机器，你需要 **内网穿透 (frp)** [内网穿透](intranet-penetration.md) -[搭建内网穿透 (Frp)](/advance/frp) +[搭建内网穿透 (frp)](../../advance/frp.md)
diff --git a/docs/process/deploy/deploy.md b/docs/process/deploy/deploy.md index d9de04380..aee8c145e 100644 --- a/docs/process/deploy/deploy.md +++ b/docs/process/deploy/deploy.md @@ -22,9 +22,9 @@ sidebar_position: 1 ## 有何建议？ -个人建议使用 vps，你会在 [可选方式#vps](optional-mode.md#vps) 了解到相关内容 +个人建议使用 VPS [可选方式#VPS](optional-methods.md#vps) 了解到相关内容 -如果是新手刚起步，那就不要买东西瞎费钱了，自己电脑上做就可，做成之后可以考虑 vps 了 +如果是新手刚起步，那就不要买东西瞎费钱了，自己电脑上做就可，做成之后可以考虑 VPS 了 import DocCardList from '@theme/DocCardList'; diff --git a/docs/process/deploy/intranet-penetration.md b/docs/process/deploy/intranet-penetration.md index 7149ed712..d545340b9 100644 --- a/docs/process/deploy/intranet-penetration.md +++ b/docs/process/deploy/intranet-penetration.md @@ -11,11 +11,11 @@ sidebar_position: 5 **来几个？** -内网穿透一抓一大把，比如[樱花内网穿透](https://www.natfrp.com/)和[OpenFrp](https://www.openfrp.net/) +内网穿透一抓一大把，比如 [樱花内网穿透](https://www.natfrp.com/) 和 [OpenFrp](https://www.openfrp.net/) -Cloudflare 有内网穿透 Tunnel (无需注册！),MineKube 也有内网穿透 Connect(同样无需注册)，还有 Geyser 官方推荐的 Playit.gg +Cloudflare 有内网穿透 Tunnel (无需注册！)，Minekube 也有内网穿透 Connect (同样无需注册)，还有 Geyser 官方推荐的 playit.gg -自建 frp 参见[此页面](/advance/frp#配置-proxy-protocol) +自建 frp 参见 [此页面](../../advance/frp.md#配置-proxy-protocol) ## Cloudflare Tunnel @@ -26,29 +26,29 @@ Cloudflare Tunnel 是 CF 下的免费内网穿透 优点： - 免费，无需注册 -- 自带 n TB 高防 +- 自带 N TB 高防 - 不限流 -- 支持 TCP,UDP,RDP,SSH,HTTP +- 支持 TCP, UDP, RDP, SSH, HTTP - SSH 提供 WebSSH，还可以通过 Access 管理 缺点： - 延迟较大 (不可以优选） -- 客户端需安装 mod 才能进入 (仅限 TCP,UDP) +- 客户端需安装 mod 才能进入 (仅限 TCP, UDP) ### 安装 -在[Github](https://github.com/cloudflare/cloudflared/releases) 找到适合的版本并安装 +在 [GitHub](https://github.com/cloudflare/cloudflared/releases) 找到适合的版本并安装 ### 使用 打开 cmd，运行以下命令 -```shell +```bash cloudflared tunnel --url tcp://localhost:服务器端口 ``` -`tcp`可以换成其他你需要的协议，比如`http` +`tcp` 可以换成其他你需要的协议，比如 `http` 很快你就能看到 @@ -69,7 +69,7 @@ INF +--------------------------------------------------------------------------- ### 客户端 -需要安装[Modflared](https://modrinth.com/mod/modflared) +需要安装 [Modflared](https://modrinth.com/mod/modflared) :::tip @@ -88,8 +88,8 @@ Minekube 的免费内网穿透，这个组织还有另一个有名作品 Gate - 免费，无需注册 - 自带高防 - 不限流 -- 会提供一个免费域名和 1 个 AnyCast 独立 IPV4 -- 有 Dashboard，可以进行网络分流，管理，黑名单等操作 +- 会提供一个免费域名和 1 个 Anycast 独立 IPv4 +- 有管理面板，可以进行网络分流，管理，黑名单等操作 缺点： @@ -97,16 +97,16 @@ Minekube 的免费内网穿透，这个组织还有另一个有名作品 Gate [官网](https://connect.minekube.com/) -## Playit.gg +## playit.gg -Playit 的免费内网穿透，需要登录 +playit 的免费内网穿透，需要登录 优点： - 提供免费版本 - 无限流量 - 提供防火墙功能 -- 提供**亚太地区节点**（测试时候路由到了日本） +- 提供 **亚太地区节点**（测试时候路由到了日本） - 自带高防 - 支持 Geyser - 支持任意 TCP、UDP 应用 @@ -126,7 +126,7 @@ Premium 版本一个月 3 刀 (约合人民币 27 元)，一年 30 刀 #### 玩家注册 -支持 IP 限制注册账号的登录插件 (如 Authme、CMI ) 会出问题 +支持 IP 限制注册账号的登录插件 (如 Authme、CMI) 会出问题 如果内网穿透的话，他们的 IP 地址都是回环地址，所以他们不能注册账号了 @@ -144,29 +144,28 @@ Premium 版本一个月 3 刀 (约合人民币 27 元)，一年 30 刀 因为他们的 IP 都是回环地址 -### ban-ip ban 掉所有人 +### /ban-ip ban 掉所有人 因为你们的地址都是回环地址 -所以你 ban-ip 会 ban 掉所有人，包括你自己...... +所以你 /ban-ip 会 ban 掉所有人，包括你自己...... ### 反假人插件 这会导致反假人插件几乎不能使用，因为无论是封禁 IP 还是 IP 白名单都会因为所有玩家 IP 相同而失效。 -### 解决以上无法显示 IP 地址的办法：proxy protocol +### 解决以上无法显示 IP 地址的办法：PROXY protocol 正是因为 frp 在转发玩家请求时重写了请求头部，导致了以上情况的发生。frp 虽然不能不重写这个请求头部，但是他可以通过一种方式还原请求头部，让服务器正常显示出连接 IP。 -Proxy Protocol 是由 HAProxy 开发者 Willy 提出的一种反向代理协议，可以参考 -[HAProxy 文档](http://www.haproxy.org/download/1.8/doc/proxy-protocol.txt) -获取更多信息。frp 内置的 proxy protocol 要求被其穿透的服务器也支持 proxy protocol，否则会造成对应的服务无法使用，所以并不是随便拿一个服务就能用 proxy protocol。 -frp 启用 proxy protocol 的方式参考[自建 frp](/advance/frp#配置-proxy-protocol)。 +PROXY protocol 是由 HAProxy 开发者 Willy 提出的一种反向代理协议，可以参考 [HAProxy 文档](http://www.haproxy.org/download/1.8/doc/proxy-protocol.txt) +获取更多信息。frp 内置的 PROXY protocol 要求被其穿透的服务器也支持 PROXY protocol，否则会造成对应的服务无法使用，所以并不是随便拿一个服务就能用 PROXY protocol。 +frp 启用 PROXY protocol 的方式参考 [自建 frp](../../advance/frp.md#配置-proxy-protocol)。 -对于 mc 服务器来说，支持 proxy protocol 的软件有： +对于 MC 服务器来说，支持 PROXY protocol 的软件有： -- bungeecord 系 -- paper 分支 (1.18.2)(仅支持 v2) -- [Geyser](/Java/process/mobile-player/Geyser/introduction/FAQ#frp-搭建内网穿透想显示真实-ip-怎么办) +- BungeeCord 系 +- Paper 分支 (1.18.2)(仅支持 v2) +- [Geyser](/java/process/mobile-player/geyser/introduction/faq#frp-搭建内网穿透想显示真实-ip-怎么办) - Spigot 端插件 [HAProxyDetector](https://github.com/andylizi/haproxy-detector) 等。BDS 服务器目前不支持此协议。 diff --git a/docs/process/deploy/optional-mode.md b/docs/process/deploy/optional-methods.md similarity index 82% rename from docs/process/deploy/optional-mode.md rename to docs/process/deploy/optional-methods.md index 101a3fc5f..889e97197 100644 --- a/docs/process/deploy/optional-mode.md +++ b/docs/process/deploy/optional-methods.md @@ -24,7 +24,7 @@ MCSManager: ![](_images/mcsm.png) -翼龙: +翼龙： ![](_images/翼龙面板.png) @@ -32,7 +32,7 @@ MCSManager: :::tip -不是说面板一定不好，你甚至能在自己机器上安装面板来用，只是咱**不推荐**你购置服务器的时候买面板来用 +不是说面板一定不好，你甚至能在自己机器上安装面板来用，只是咱 **不推荐** 你购置服务器的时候买面板来用 ::: @@ -45,7 +45,7 @@ MCSManager: :::info -大厂 (指腾讯云，阿里云等) 那些服务器不是不能买，但是贵，而且大厂不是专搞 mc 服务器的 +大厂 (指腾讯云，阿里云等) 那些服务器不是不能买，但是贵，而且大厂不是专搞 MC 服务器的 你去一些技术群里找人买一般能有更低的价格，以及一些附赠服务 (如提供付费插件，一些服务端，服务器技术咨询等) @@ -64,13 +64,13 @@ MCSManager: 但是家里云也有明显的缺点： -1. 初期成本可能较高。举个例子，一台 e3 CPU 的服务器完全自行购买需要数百元，而性能非常强的服务器至少要数千元，甚至一些情况下需要万元以上，到这已经是必须财力雄厚才能负担得起的级别了。另外如果你使用的是笔记本这样的电脑开服 (包括拿旧手机开服)，长期满电和高温会导致电池损坏，最后电脑变成一台带 UPS 的台式机。 +1. 初期成本可能较高。举个例子，一台 E3 CPU 的服务器完全自行购买需要数百元，而性能非常强的服务器至少要数千元，甚至一些情况下需要万元以上，到这已经是必须财力雄厚才能负担得起的级别了。另外如果你使用的是笔记本这样的电脑开服 (包括拿旧手机开服)，长期满电和高温会导致电池损坏，最后电脑变成一台带 UPS 的台式机。 2. 不适合短期开服。尤其是想尝鲜的极客们，如果一台电脑买来后开服两天半就腻了不开了，你得想办法处理这台电脑。是转手卖掉还是继续玩一些其他的计算机软件？如果你没法处理这台电脑，那买电脑的几百上千块钱就血本无归。 3. 可能占用自己大量的时间。一旦服务器硬件需要维护，你就必须亲自回家操作，任何其他管理都帮不了你。 4. 可能需要一定的运气。首先一旦运营商出了问题 (业务升级、施工队挖断光纤等) 要断网，就会导致你的服务器断网。而且一旦停电 (比如下大雨发水把小区电线泡了，或者施工队把电线挖断了)，就会导致你的服务器跟着家里停电而宕机。 此外你还要有能搞到公网 IPv4 的运气，否则被迫用内网穿透，延迟爆炸。 -建议所有人在使用家里云方案之前都去给自己家宽带申请公网 v4，能改桥接的改桥接，用移动的换成联通电信，不要等最后开上家里云了发现服务器人多用内网穿透带不动，自己又申请不了公网 v4，努力全白费了。确定条件符合后，你就可以开始选购服务器硬件了。 +建议所有人在使用家里云方案之前都去给自己家宽带申请公网 IPv4，能改桥接的改桥接，用移动的换成联通电信，不要等最后开上家里云了发现服务器人多用内网穿透带不动，自己又申请不了公网 IPv4，努力全白费了。确定条件符合后，你就可以开始选购服务器硬件了。 ## 独立机 @@ -91,6 +91,6 @@ MCSManager: 一种常被人取笑的开服方式。 -因为使用开服器这件事本身就有点**rz**，使用开服器几乎不需要任何计算机相关知识，这就使得使用开服器的服主看起来“不愿意学习计算机知识”、“伸手党”、“懒惰”。虽然经验非常丰富的服主也有选择使用开服器节省时间的权利，但是不建议任何服主依赖开服器，这可能导致你被开服器**娇生惯养、变得不思进取**，最终沦为开服圈子的笑柄。 +因为使用开服器这件事本身就有点 **rz**，使用开服器几乎不需要任何计算机相关知识，这就使得使用开服器的服主看起来“不愿意学习计算机知识”、“伸手党”、“懒惰”。虽然经验非常丰富的服主也有选择使用开服器节省时间的权利，但是不建议任何服主依赖开服器，这可能导致你被开服器 **娇生惯养、变得不思进取**，最终沦为开服圈子的笑柄。 -而且开服器用户多数有**极为严重**的开服常识匮乏。 +而且开服器用户多数有 **极为严重** 的开服常识匮乏。 diff --git a/docs/process/deploy/purchase-server.md b/docs/process/deploy/purchase-server.md index 752418ebb..d4053e607 100644 --- a/docs/process/deploy/purchase-server.md +++ b/docs/process/deploy/purchase-server.md @@ -25,7 +25,7 @@ sidebar_position: 2 -由于 Minecraft 的 [Tick-loop](/start/basic/what-is-caton) 逻辑是单线程的。更多核心只能用于生成区块、插件任务等非主线程任务，不建议超过 8 核心的服务器继续增加核心提升流畅度。 +由于 Minecraft 的 [Tick-loop](../../start/basic/what-is-lag.md) 逻辑是单线程的。更多核心只能用于生成区块、插件任务等非主线程任务，不建议超过 8 核心的服务器继续增加核心提升流畅度。 @@ -43,7 +43,7 @@ sidebar_position: 2 一般的，当你搭建是纯净的、不含模组的服务器时，对单核性能的要求较低；当你搭建是含模组的服务器时，对单核性能的要求较高。 -CPU 总占用不算高时，Minecraft 的服务器性能与 CPU 单核性能几乎为线性关系，单核性能翻倍几乎就可以多带一倍**甚至更多**的人。 +CPU 总占用不算高时，Minecraft 的服务器性能与 CPU 单核性能几乎为线性关系，单核性能翻倍几乎就可以多带一倍 **甚至更多** 的人。 尽量选择不超开的云 (如上图，图中 50% 的性能差就在于低价云超开导致性能下降，不要贪图便宜，服务器到手后要自己跑分) @@ -59,11 +59,11 @@ CPU 总占用不算高时，Minecraft 的服务器性能与 CPU 单核性能几 ::: -一般来说，mod 服比插件服占用高，高版本比低版本略高。尽量选择核心数与内存比例在 1:2 以上的套餐 (推荐 1:2 - 1:4 )。 +一般来说，mod 服比插件服占用高，高版本比低版本略高。尽量选择核心数与内存比例在 1:2 以上的套餐 (推荐 1:2 - 1:4)。 一方面，核心多内存少必然面临性能下降。另一方面，核心多内存少基本为超开，性能会比正常情况下差很多。 -大厅服分配 1G - 2G 内存，普通生存服务器或空岛服务器建议分配 8G - 12G，单端人数较多建议使用 12G - 24G 内存。 +大厅服分配 1 G - 2 G 内存，普通生存服务器或空岛服务器建议分配 8 G - 12 G，单端人数较多建议使用 12 G - 24 G 内存。 :::warning @@ -73,13 +73,13 @@ CPU 总占用不算高时，Minecraft 的服务器性能与 CPU 单核性能几 ### 带宽 -根据玩家数量及视野情况分配。一般情况低版本全默认情况下平均每个玩家会使用 0.25 - 0.4 Mbps 的上行带宽。 +根据玩家数量及视野情况分配。一般情况低版本全默认情况下平均每个玩家会使用 0.25 Mbps - 0.4 Mbps 的上行带宽。 -1.18 以上服务器平均每人使用 0.3-0.5 Mbps 上行带宽 (一群跑图佬另说) 也就是说一般提供的 10M 带宽够带 15-20 人。 +1.18 以上服务器平均每人使用 0.3 Mbps - 0.5 Mbps 上行带宽 (一群跑图佬另说) 也就是说一般提供的 10 M 带宽够带 15 - 20 人。 同样的有的服务商会提供所谓“共享上行”，有时会出现其他用户传文件，VPS 所在宿主机所有用户都变卡的情况，建议无论如何搞到一个独享带宽保底。 -需要注意的是，想要家庭带宽开服要考虑到吃 DDOS 和部分运营商不提供公网或者公网上行速度非常慢的情况，只建议基友服使用，或者配合 FRP 等流量转发方式使用。 +需要注意的是，想要家庭带宽开服要考虑到吃 DDoS 和部分运营商不提供公网或者公网上行速度非常慢的情况，只建议基友服使用，或者配合 frp 等流量转发方式使用。 ### 系统 @@ -97,13 +97,13 @@ 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，就不建议把这张显卡放到服务器上使用，这种显卡待机情况下功耗更高，导致你家电表转得更快。 +由于 MC 服务器所有渲染图像的工作都由玩家的设备自行完成，所以服务器不需要任何显卡的性能，你的显卡只需要保证能够进行视频输出即可，也就是“亮机卡”。如果你手里已经有现成的低性能的显卡，你可以直接购买不带核显的 CPU，比如带 F 的英特尔 CPU。 +如果没有低性能的 CPU，比如你手里有一张闲置的 2070 ~~(谁会手里有了 2070 还闲置啊)~~，那么除非你有特殊的需求，比如除了开服还用服务器跑 AI，就不建议把这张显卡放到服务器上使用，这种显卡待机情况下功耗更高，导致你家电表转得更快。 :::warning @@ -115,17 +115,17 @@ Linux 系统常见的有 Ubuntu、CentOS 和 Debian。我们日常很少接触 L ### 主板 -虽然 mc 服务器对主板没什么要求，但是 CPU 对主板的要求还是很高的。在选择主板时你需要注意以下几点： +虽然 MC 服务器对主板没什么要求，但是 CPU 对主板的要求还是很高的。在选择主板时你需要注意以下几点： -1. 板型。常见的主板从小到大分为 ITX、mATX、ATX、EATX 这几个标准。小的主板尺寸可以装进更小的机箱，大的主板尺寸可以提供更多硬件功能。通常情况下，购买最便宜的 mATX 或 ATX 板型的主板即可，因为你的服务器不需要便携。但是一定要注意**不能大于机箱尺寸，否则机箱装不下**。 +1. 板型。常见的主板从小到大分为 ITX、mATX、ATX、EATX 这几个标准。小的主板尺寸可以装进更小的机箱，大的主板尺寸可以提供更多硬件功能。通常情况下，购买最便宜的 mATX 或 ATX 板型的主板即可，因为你的服务器不需要便携。但是一定要注意 **不能大于机箱尺寸，否则机箱装不下**。 2. 主芯片组。主芯片组必须要和 CPU 品牌对应，才能和 CPU 兼容。英特尔有中端的 B 系列和高端的 Z 系列，AMD 有中端的 B 系列和高端的 X 系列。通常不需要考虑主芯片组要选哪个，毕竟你也不需要给服务器主板插一大堆三件。 但是不建议 i9 和 R9 处理器选用中端芯片组，除非你问过确实“能带动”，否则会出现主板供电不足等问题，这是因为中端芯片组的供电模块性能较低。 ### 内存 -虽然是服务器，但是毕竟游戏服务器，需要的内存也是非常高的。通常不推荐购买“刚好够用”的内存容量，因为你的需求会随着服务器规模的扩大逐渐提高，导致后期你可能需要对内存进行升级或更换。如果不是预算非常紧张，建议先购买 CPU 所支持的最大内存容量的一半，数量为主板内存插槽数量的一半，后期需要扩容时，直接购买**同品牌、同系列、同参数**的内存加装。 +虽然是服务器，但是毕竟游戏服务器，需要的内存也是非常高的。通常不推荐购买“刚好够用”的内存容量，因为你的需求会随着服务器规模的扩大逐渐提高，导致后期你可能需要对内存进行升级或更换。如果不是预算非常紧张，建议先购买 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。 由于各内存颗粒工厂的产量 (~~失火频率~~) 不同，内存的价格会随时间出现变化。如果你时间充足，可以多关注数码资讯，选择最合适的时机抢购内存。 @@ -144,5 +144,5 @@ mc 服务器对内存的频率和时序几乎没有任何要求 (https://www.min 选购机械硬盘时，需要注意以下事项： -1. 机械硬盘的 IO 速度 远低于固态硬盘，不要只因为机械硬盘便宜，就去选购机械硬盘！ +1. 机械硬盘的 I/O 速度 远低于固态硬盘，不要只因为机械硬盘便宜，就去选购机械硬盘！ 2. 不要去选择二手机械硬盘，如有购买，建议多备份或组 RAID 使用（RAID 0 除外）！ diff --git a/docs/process/maintenance/how-to-defend-against-cyber-attacks.md b/docs/process/maintenance/how-to-defend-against-cyber-attacks.md index 09f8201e7..4efbc1d51 100644 --- a/docs/process/maintenance/how-to-defend-against-cyber-attacks.md +++ b/docs/process/maintenance/how-to-defend-against-cyber-attacks.md @@ -13,7 +13,7 @@ sidebar_position: 6 下面将列出几种常见的 Minecraft 服务器容易遭受的攻击类型。 -### 应用层 (也称为 L7 ) +### 应用层 (也称为 L7) 在服务器上运行并绑定了指定地址和端口的应用程序，可以在这一层接受连接。 @@ -24,7 +24,9 @@ sidebar_position: 6 #### 假人攻击 :::info + 本处仅讨论关于 Minecraft 服务器网络安全的概念，不涉及关于“生电”中假人的相关概念。 + ::: 假人攻击（Fake Player Attack），是指攻击者利用技术手段，模拟正常玩家的行为并向 Minecraft 服务器发起非正常请求，进而使得 Minecraft 服务器因各种原因而瘫痪崩溃或被渗透的一种攻击方式。 @@ -65,18 +67,18 @@ Minecraft 后端服务器一般是不会对 Ping 进行过滤和记录的，这 #### Minecraft 漏洞攻击 -通过利用 Minecraft 游戏本身的漏洞，向服务器发送 (可能是大量的) 不合法的数据包，造成服务器卡顿甚至**崩溃**，例如攻击者可以向 BDS 服务器发送大量空数据包使其不断打印日志而不再正常处理游戏内容。 +通过利用 Minecraft 游戏本身的漏洞，向服务器发送 (可能是大量的) 不合法的数据包，造成服务器卡顿甚至 **崩溃**，例如攻击者可以向 BDS 服务器发送大量空数据包使其不断打印日志而不再正常处理游戏内容。 #### 远程桌面 / SSH 爆破 众所周知，只要足够有耐心，就一定能赢得猜数游戏。远程桌面或 SSH 也是如此。由于其并没有针对用户的复杂的验证机制，这导致任何人都可以无限制地试错。 -所以攻击者可以通过编写脚本等方式制作软件，不断地假设密码登录服务器远控服务，这就是**爆破攻击**，或者叫暴力破解密码。最终当登录成功时，攻击即成功，攻击者将**获得你服务器完全的控制权**。 +所以攻击者可以通过编写脚本等方式制作软件，不断地假设密码登录服务器远控服务，这就是 **爆破攻击**，或者叫暴力破解密码。最终当登录成功时，攻击即成功，攻击者将 **获得你服务器完全的控制权**。 注意由于该服务在电脑上非常常见，所以世界各处经常有攻击者通过扫描 IPv4 地址 (扫段攻击，通过对某个 IP 段的所有 IP 逐个检测来找出可以攻击的目标)， 并通过扫描端口 (扫端口，通过对某个 IP 上的所有端口进行检测来找出可以攻击的目标)，来找到你的服务器的远控地址， 而不需要事先对你的服务器或你本人有任何了解。也就是说，如果你遭遇了这种攻击，不要一味地反思自己是否激怒过他人或和小人有了过节，而是要专注于防范你所遭受的攻击本身。 -### 网络层 (也称为 L3 ) +### 网络层 (也称为 L3) 网络层攻击是 DDoS 攻击的一种形式，它针对于网络基础架构进行攻击。 @@ -86,9 +88,9 @@ Minecraft 后端服务器一般是不会对 Ping 进行过滤和记录的，这 这里列出了一些可行的方法 [网络层与传输层攻击防御](#网络层与传输层攻击防御) -### 传输层 (也称为 L4 ) +### 传输层 (也称为 L4) -Minecraft JAVA 服务端采用 TCP 作为通信协议，所以你可能会遭受到如 TCP Flood (如 SYN Flood、ACK Flood) 等攻击方式。 +Minecraft Java 服务端采用 TCP 作为通信协议，所以你可能会遭受到如 TCP Flood (如 SYN Flood、ACK Flood) 等攻击方式。 同上，这里列出了一些可行的方法 [网络层与传输层攻击防御](#网络层与传输层攻击防御) @@ -105,13 +107,14 @@ Minecraft JAVA 服务端采用 TCP 作为通信协议，所以你可能会遭受 你可以在这类玩家违反规定后视其影响对其适当采取宽容态度 (睁一只眼闭一只眼)，并在他们和其他玩家起冲突时以协调为主，尽可能不对其进行处罚。 3. 千万不要在其他服务器玩家交流平台 (比如服务器群) 里宣传自己的服务器。如果你的服务器非常缺人，这时突然来人宣传把你的玩家全抢走了，你怎么想？ 在其他服务器交流平台上宣传自己的服务器往往会被对方的玩家或管理团队视为不正当竞争，这将激怒他们，并导致他们对你的服务器发起攻击。 -4. 不要招惹任何人，包括任何从事或爱好计算机行业的人和所有 mc 玩家。 +4. 不要招惹任何人，包括任何从事或爱好计算机行业的人和所有 MC 玩家。 请注意，很多人嘴上不说自己喜欢攻击他人，但是他们会在愤怒的情况下想尽一切方法搞砸你的服务器，就像他们和其他人闹矛盾时会起肢体冲突一样。 ### 开启防火墙 在笔者与其他服主交流的过程中，发现有一些服主会完全关闭服务器的防火墙，其中一些甚至不在操作系统中运行任何安全软件来替代被关闭的防火墙。 -我们常说“安全系统最薄弱的地方在于人”，但是这句话并不是说只要保持高度的警惕和拥有丰富的经验就能防范所有的恶意攻击。 +我们常说“安全系统最薄弱的地方在于人”，但是这句话并不是说只要保持高度的警惕和拥有丰富的经验就能防范所有的恶意攻击。 + 你的服务器上可能存在着大量会自行开启服务的软件。在你没有意识到的情况下，它们很可能被黑客利用，导致你的服务器被攻击。
@@ -122,7 +125,7 @@ Minecraft JAVA 服务端采用 TCP 作为通信协议，所以你可能会遭受 那么玩家就可以直接从公网连接子服并开始游戏而无需登录。由于没有登录步骤验证身份，玩家甚至可以直接登录管理员帐号，从而炸服。 而一旦开启了防火墙阻止公网连接子服，玩家就只能通过代理端连接登录服完成登录步骤，从而避免了这一威胁。 - 部分插件或软件的远程管理功能： - 有一些软件或服务器插件会默认开启远程管理功能，允许管理员通过网页、ssh 等方式管理它，或者你或其他管理员手动开启了它来方便从服务器后台管理服务器。 + 有一些软件或服务器插件会默认开启远程管理功能，允许管理员通过网页、SSH 等方式管理它，或者你或其他管理员手动开启了它来方便从服务器后台管理服务器。 然而在没有防火墙的情况下，黑客也可以从公网连接这些远程管理服务。如果它们的密码强度不高，甚至是默认密码或无身份认证，黑客就可以通过操控这些软件来攻击服务器 - MySQL 等通过网络连接的数据库： 如果你的 MySQL 等数据库不需要来自其他服务器的连接（也就是说你的数据库和服务端都在同一服务器上），而你又没有为 MySQL 设置高安全系数的身份验证， @@ -135,7 +138,7 @@ Minecraft JAVA 服务端采用 TCP 作为通信协议，所以你可能会遭受 #### 如何开启 -- Windows：- 打开 Windows Defender 防火墙（Win + R 输入 `Firewall.cpl`）- 点击侧边栏中的 启用或关闭 Windows Defender 防火墙 - 把专用网络设置和公用网络设置都调成“启用 Windows Defender 防火墙”， +- Windows：- 打开 Windows Defender 防火墙（`Win + R` 输入 `Firewall.cpl`）- 点击侧边栏中的 启用或关闭 Windows Defender 防火墙 - 把专用网络设置和公用网络设置都调成“启用 Windows Defender 防火墙”， 去掉“阻止所有传入连接，包括位于允许列表中的应用”的勾， 勾上如果“Windows Defender 防火墙阻止新应用时通知我”。- 点击下面的确定 - Linux：执行命令 `service iptables start` 开启防火墙 @@ -168,7 +171,7 @@ connection_throttle_limit: 3 ### 在代理端安装反假人插件 -你可以在代理端安装假人过滤插件，同样的，由于代理端相较后端服务器在面对大量连接时更加高效，请务必在**代理端**安装插件。 +你可以在代理端安装假人过滤插件，同样的，由于代理端相较后端服务器在面对大量连接时更加高效，请务必在 **代理端** 安装插件。 以下是推荐的反机器人插件列表 @@ -196,7 +199,7 @@ connection_throttle_limit: 3 ### 付费防御核心 -如果你非常有钱，你可以打开跨服端[核心选择](/Java/process/cross-server/server-core-choose)，选择那些付费的跨服端核心， +如果你非常有钱，你可以打开跨服端 [核心选择](/java/process/cross-server/server-core-choose)，选择那些付费的跨服端核心， NullCordX 是一个较好的选择。 但在没有想好的情况下，**不建议为反假人付费**。 @@ -205,7 +208,7 @@ NullCordX 是一个较好的选择。 #### 改掉默认端口 -修改默认端口为其他端口。尽可能使用**高位端口**，例如`5000`和`55555`端口尽可能不要使用，`8371`不推荐使用，`36752`推荐使用。 +修改默认端口为其他端口。尽可能使用 **高位端口**，例如 `5000` 和 `55555` 端口尽可能不要使用，`8371` 不推荐使用，`36752` 推荐使用。 ##### [修改 Windows 默认远程桌面端口](https://learn.microsoft.com/zh-cn/windows-server/remote/remote-desktop-services/clients/change-listening-port) @@ -217,23 +220,23 @@ NullCordX 是一个较好的选择。 - 大小写英文 - 数字 -- 特殊符号，如`!@#$*_.` +- 特殊符号，如 `!@#$*_.` 例如不要使用以下密码： -- `123456`(又短又简单，黑客的最爱) -- `114514`(极常见词汇，114514 是互联网上常见的梗) -- `#sI3wA@!`(虽然复杂但是由于较短仍然容易被暴力破解) -- `skyworkserver`(服务器名) -- `yizhan`(人名、物品名、地名等) -- `111111111111111111111111111`(虽然很长，但是不复杂，仍然容易被破解) -- `minimouse4820030611`(包含生日等个人信息) +- `123456` (又短又简单，黑客的最爱) +- `114514` (极常见词汇，114514 是互联网上常见的梗) +- `#sI3wA@!` (虽然复杂但是由于较短仍然容易被暴力破解) +- `skyworkserver` (服务器名) +- `yizhan` (人名、物品名、地名等) +- `111111111111111111111111111` (虽然很长，但是不复杂，仍然容易被破解) +- `minimouse4820030611` (包含生日等个人信息) 并尽可能不使用以下密码： -- `yizhan114514`(由常见词汇组成) -- `shuodedaoli`(汉语拼音而且对应的汉语为常见词汇，本密码对应的汉语词汇为常见的梗“说的道理”) -- `#tianjifuwuqi`(除了寥寥几位强密码以外其他都是弱密码) +- `yizhan114514` (由常见词汇组成) +- `shuodedaoli` (汉语拼音而且对应的汉语为常见词汇，本密码对应的汉语词汇为常见的梗“说的道理”) +- `#tianjifuwuqi` (除了寥寥几位强密码以外其他都是弱密码) #### 在操作系统中安装防御软件 @@ -243,29 +246,29 @@ NullCordX 是一个较好的选择。 ##### Linux -有雷池 waf、1P 等面板可供选择 +有雷池 WAF、1Panel 等面板可供选择 ### 网络层与传输层攻击防御 #### 将服务器托管到高防机房/购买高防 VPS -对于大多数 MC 服务器，150G 的防御是足够的，性价比较高。 +对于大多数 MC 服务器，150 G 的防御是足够的，性价比较高。 一般托管一个月大概 800 RMB，速率为 50 Mbps。 -建议最多升级到 300G 防御 (再多就放弃吧这是想让你倒闭的)。 +建议最多升级到 300 G 防御 (再多就放弃吧这是想让你倒闭的)。 如果是 VPS，建议向 VPS 提供商咨询防御服务。 #### 使用 Minecraft 代理 -例如 TCPShield，Cloudflare 和 MineKube +例如 TCPShield，Cloudflare 和 Minekube 包含专门针对于缓解 Minecraft 攻击的负载均衡代理，且能够有效隐藏服务器 IP 地址。 缺点是似乎还没有任何一家这样的代理拥有国内服务器 (延迟高)，且需要花费一点时间设置 -那些在 CF 上 A(或 AAAA，CNAME) 过去到源站 (可能配上 SRV) 就是**自欺欺人，完全没用**，CF 压根不会代理这些端口和协议的流量，开小黄云也一样 +那些在 CF 上 A (或 AAAA，CNAME) 过去到源站 (可能配上 SRV) 就是 **自欺欺人，完全没用**，CF 压根不会代理这些端口和协议的流量，开小黄云也一样 import Tabs from '@theme/Tabs'; import TabItem from '@theme/TabItem'; @@ -292,13 +295,13 @@ Cloudflare 的内网穿透 Tunnel，当高防也是疯了 -Cloudflare 用于 TCP，UDP 协议的防御，可惜价格太贵了 (1$/GB 抢钱) +Cloudflare 用于 TCP，UDP 协议的防御，可惜价格太贵了 (1 $/GB 抢钱) -优点: +优点： - 296 Tbps 高防，298 位置 - 支持 TCP，UDP，RDP，SSH，HTTP -- 提供 1 个 AnyCast 独立 IPV4 +- 提供 1 个 Anycast 独立 IPv4 - SSH 提供 WebSSH，还可以通过 Access 管理 缺点： @@ -308,14 +311,14 @@ Cloudflare 用于 TCP，UDP 协议的防御，可惜价格太贵了 (1$/GB 抢 价格多贵？ -Cloudflare Pro 25$/月 (约合人民币 178 元，免费流量**5GB**)，此后 1$/**GB** +Cloudflare Pro 25 $/月 (约合人民币 178 元，免费流量 **5GB**)，此后 1 $/**GB** -也就是说，1 TB 流量价格为 1044$，约合人民币 7443 元，还不算 CF Pro 订阅费用，真需要可以考虑 Papyrus +也就是说，1 TB 流量价格为 $1044，约合人民币 7443 元，还不算 CF Pro 订阅费用，真需要可以考虑 Papyrus - + -MineKube 的免费保护，这个组织还有另一个有名作品 Gate +Minekube 的免费保护，这个组织还有另一个有名作品 Gate 个人感觉比 Cloudflare Tunnel 强很多 (比 Cloudflare Spectrum 体验都好) @@ -324,7 +327,7 @@ MineKube 的免费保护，这个组织还有另一个有名作品 Gate - 免费，无需注册 - 自带高防 - 不限流 -- 会提供一个免费域名和 1 个 AnyCast 独立 IPV4 +- 会提供一个免费域名和 1 个 Anycast 独立 IPv4 - 有 Dashboard，可以进行网络分流，管理，黑名单等操作 - 自带内网穿透 @@ -342,19 +345,19 @@ TCPShield 专业的 Minecraft 网络保护 优点： -- 提供免费套餐 (1TB 免费流量) +- 提供免费套餐 (1 TB 免费流量) - **L7 层保护 (会校验流量合法性)** - 提供面板管理流量 - 价格便宜 -缺点: +缺点： - 延迟较大 (启动 Asia Network 后会好很多) -Asia Network(亚洲网络): +Asia Network (亚洲网络): - 提供新加坡和东京网络 -- 价格:0.01 $/GB(与其他流量分开计费，没有免费流量)(约合人民币 7 分) +- 价格：0.01 $/GB (与其他流量分开计费，没有免费流量)(约合人民币 7 分) Geyser 支持需要 Premium 计划 (100 $/月，堪比抢钱) @@ -366,11 +369,11 @@ Pro 计划 (25$ 每月)(约合人民币 178 元): [官网](https://tcpshield.com/) - + -性价比非常高，虽说~~正式用途是朋友联机~~ +性价比非常高，虽说 ~~正式用途是朋友联机~~ -优点: +优点： - 不限流量 - 支持任意 TCP，UDP 代理 @@ -379,15 +382,15 @@ Pro 计划 (25$ 每月)(约合人民币 178 元): - 自带内网穿透 - 提供防火墙 -缺点: +缺点： - 没有分析面板 - 绑定自己的域名需要 Premium - 没有 L7 过滤 -Premium 价格:**3 美元**/月 (约合 20 人民币)(非常便宜!) +Premium 价格：**3 美元**/月 (约合 20 人民币)(非常便宜!) -可以购买独立 IPV4 IP 和 IPV6 IP +可以购买独立 IPv4 IP 和 IPv6 IP @@ -399,7 +402,7 @@ VIP 套餐 (25 $ 每月，约合人民币 177 元): - 支持 Geyser - L7 过滤 -流量状况: +流量状况： - 无限流量：仅提供纽约，法兰克福节点 - Cloudflare Spectrum 流量：流量数未知，但不是无限 @@ -470,9 +473,9 @@ Cloudflare Spectrum 目前是没中国节点的 -#### 狂套 Frp +#### 狂套 frp -这个方法比较缺德，我们只需要疯狂 Frp，一个 Frp 被打死了，我们就换另一个 Frp，通知玩家重新连接就可以。 +这个方法比较缺德，我们只需要疯狂 frp，一个 frp 被打死了，我们就换另一个 frp，通知玩家重新连接就可以。 :::danger @@ -496,7 +499,7 @@ Cloudflare Spectrum 目前是没中国节点的 :::danger -如果你使用的是腾讯云之类的大厂 VPS，永远不要尝试硬扛 DDOS，服务器受攻击流量超过其机房黑洞阈值时，VPS 会屏蔽服务器的外网访问，直接断网并且恢复时间未知。 +如果你使用的是腾讯云之类的大厂 VPS，永远不要尝试硬扛 DDoS，服务器受攻击流量超过其机房黑洞阈值时，VPS 会屏蔽服务器的外网访问，直接断网并且恢复时间未知。 ::: @@ -510,7 +513,8 @@ IPv4 地址的数量是极其有限的，不管是租赁还是托管，服务商 依此，我们定义源服务器为「源站」，用于反向代理的低价服务器为「节点」。 -这些「节点」由此变为「源站」的挡箭牌，替服务器阻挡攻击流量，只要攻击者没有找到源站的 IP，你的服务器就是相对安全的。 +这些「节点」由此变为「源站」的挡箭牌，替服务器阻挡攻击流量，只要攻击者没有找到源站的 IP，你的服务器就是相对安全的。 + 作为替代，你的节点会承受攻击，达到阈值依然会导致玩家无法进服，此方法仅可让你在攻击下可快速恢复访问，而无需等待黑洞封禁时间结束。 使用这个方法，需要你能找到满足以下特点的云服务器来作为节点，条件可能较为苛刻，没有高防服务器那么烧钱但价格也不太便宜。 @@ -520,5 +524,6 @@ IPv4 地址的数量是极其有限的，不管是租赁还是托管，服务商 - 相对便宜 - 带宽相对较高 -可用于制作反向代理的软件有 `hopper-rs`、`nginx`、`haproxy` 等等，配置正确的情况下，反向代理会进行 IP 地址转发，不会导致服务器显示的玩家 IP 全部为同一个 IP 地址。 +可用于制作反向代理的软件有 `hopper-rs`、`nginx`、`haproxy` 等等，配置正确的情况下，反向代理会进行 IP 地址转发，不会导致服务器显示的玩家 IP 全部为同一个 IP 地址。 + 有条件最好自行制作一个快捷安装脚本，以便在节点因攻击被断网时，可快速地再租一台节点服务器部署反向代理。 diff --git a/docs/process/maintenance/maintenance.md b/docs/process/maintenance/maintenance.md index 29d83c138..067ea4644 100644 --- a/docs/process/maintenance/maintenance.md +++ b/docs/process/maintenance/maintenance.md @@ -14,20 +14,20 @@ sidebar_position: 2 如果遇到熊孩子恶意毁坏，可以使用插件回溯功能单独回溯熊孩子的操作。 -即使在区块出现损坏的情况下，这些插件也能在一定程度上减少区块损坏所造成的影响。见 [防熊插件](/Java/AntiGrief)。 +即使在区块出现损坏的情况下，这些插件也能在一定程度上减少区块损坏所造成的影响。见 [防熊插件](/java/AntiGrief)。 ## 检查日志 -[日志](/docs/start/basic/basic.md)中包含了大量的玩家、插件、服务器行为。 +[日志](../../start/basic/basic.md)中包含了大量的玩家、插件、服务器行为。 每次维护服务器时请务必查看服务器近期的日志。 -对于 ERROR 等级的报错请立即处理，自行在网络查询或咨询其他人。 +对于 `ERROR` 等级的报错请立即处理，自行在网络查询或咨询其他人。 -对于 WARN 等级的报错，请尝试通过翻译等手段了解 warn 的内容，自行在网络查询或咨询其他人。 +对于 `WARN` 等级的报错，请尝试通过翻译等手段了解 `WARN` 的内容，自行在网络查询或咨询其他人。 :::warning -注意！咨询其他人时请先查看 [如何向大佬求助](/docs/start/ask-for-help.md) +注意！咨询其他人时请先查看 [如何向大佬求助](../../start/ask-for-help.md) ::: diff --git a/docs/process/maintenance/how-to-troubleshoot-problematic-plugins.md b/docs/process/maintenance/plugin-troubleshooting.md similarity index 79% rename from docs/process/maintenance/how-to-troubleshoot-problematic-plugins.md rename to docs/process/maintenance/plugin-troubleshooting.md index 5b9ad818c..3cdb5d32a 100644 --- a/docs/process/maintenance/how-to-troubleshoot-problematic-plugins.md +++ b/docs/process/maintenance/plugin-troubleshooting.md @@ -9,11 +9,11 @@ sidebar_position: 7 ## log 定位 -对于 ERROR 和 WARN 类型的 log 进行分析，查看堆栈报错中是否有某个插件名或者插件的 `.jar` 文件。 +对于 `ERROR` 和 `WARN` 类型的 log 进行分析，查看堆栈报错中是否有某个插件名或者插件的 `.jar` 文件。 将报错先翻译一遍，确定其中是否提示了错误的类型 (如缺少前置，缺少类，插件需要更新等)。 -然后你可以尝试按照[如何向大佬求助](/Java/start/ask-for-help)中提到的方法，增加问题解决的可能性。 +然后你可以尝试按照 [如何向大佬求助](/java/start/ask-for-help) 中提到的方法，增加问题解决的可能性。 ## 二分法 @@ -21,7 +21,7 @@ sidebar_position: 7 具体操作方面： -1. 保留所有的前置插件，如 Protocolib、Luckperms、Xconomy 等。 +1. 保留所有的前置插件，如 Protocolib、LuckPerms、XConomy 等。 2. 将其他插件复制到新文件夹中，删除 `/plugins/` 中非前置插件的 `.jar` 文件。 @@ -58,4 +58,4 @@ sidebar_position: 7 ## Arthas -使用 Arthas 对报错进行分析，[文档](/arthas)，需要拥有较强的技术力 +使用 Arthas 对报错进行分析，[文档](../../advance/arthas.md)，需要拥有较强的技术力 diff --git a/docs/process/map/_images/dd2a534b4008c1087f7ba90553b1dd6a95dde0f9.png b/docs/process/map/_images/dd2a534b4008c1087f7ba90553b1dd6a95dde0f9.png deleted file mode 100644 index 1029f96a0..000000000 Binary files a/docs/process/map/_images/dd2a534b4008c1087f7ba90553b1dd6a95dde0f9.png and /dev/null differ diff --git a/docs/process/map/_images/ffbfc024b6842a0d9c7bb6caa61cc9041eafacc6.png b/docs/process/map/_images/ffbfc024b6842a0d9c7bb6caa61cc9041eafacc6.png deleted file mode 100644 index 22eb1d699..000000000 Binary files a/docs/process/map/_images/ffbfc024b6842a0d9c7bb6caa61cc9041eafacc6.png and /dev/null differ diff --git a/docs/process/map/convert.md b/docs/process/map/convert.md index 362027377..a9e2b2d7b 100644 --- a/docs/process/map/convert.md +++ b/docs/process/map/convert.md @@ -25,23 +25,23 @@ sidebar_position: 2 ::: -你只需要在启动参数最后加上`--forceUpgrade`就行了，像这样 +你只需要在启动参数最后加上 `--forceUpgrade` 就行了，像这样 -```shell +```bash java -Xms2G -Xmx2G -jar server.jar --nogui ``` 改成这样 -```shell +```bash java -Xms2G -Xmx2G -jar server.jar --nogui --forceUpgrade ``` -然后启动服务端，等待转换完成，**不要进入服务器或操作服务器**，这是非常危险的，可能会**直接废档** +然后启动服务端，等待转换完成，**不要进入服务器或操作服务器**，这是非常危险的，可能会 **直接废档** 转换完后，删掉 `--forceUpgrade` 再启动就可以了 -## Chunker.app +## Chunker :::info @@ -53,7 +53,7 @@ java -Xms2G -Xmx2G -jar server.jar --nogui --forceUpgrade ::: -Chunker.app 是一个多功能的转换工具，支持基岩版和 Java 之间的转换，在转换大版本的时候也推荐使用 +Chunker 是一个多功能的转换工具，支持基岩版和 Java 之间的转换，在转换大版本的时候也推荐使用 目前不支持实体和玩家背包 @@ -75,9 +75,9 @@ Chunker.app 是一个多功能的转换工具，支持基岩版和 Java 之间 Amulet 可用于高版本地图转低版本，但在地图转换后可能出现光源问题 -使用 [FastAsyncWorldEdit](/Java/process/plugin/WorldManagement/FastAsyncWorldEdit) +使用 [FastAsyncWorldEdit](/java/process/plugin/world-management/fastasyncworldedit) -选择光源异常区域，先 //removelight 再 //fixlighting +选择光源异常区域，先 `//removelight` 再 `//fixlighting` ::: @@ -115,7 +115,7 @@ Amulet 可用于高版本地图转低版本，但在地图转换后可能出现 #### BDS 局部导入 -在 JAVA 版做完建筑，使用 [Chunker](https://chunker.app/) 转换存档 +在 Java 版做完建筑，使用 [Chunker](https://chunker.app/) 转换存档 将建筑存档与服务端存档导入本地基岩版客户端 @@ -125,7 +125,7 @@ Amulet 可用于高版本地图转低版本，但在地图转换后可能出现 具体使用方法请看官方文档，这里不过多赘述 -[WE-Addon 结构的使用](https://worldedit-be-docs.readthedocs.io/en/stable/usage/structures/) +[WorldEdit-Addon 结构的使用](https://worldedit-be-docs.readthedocs.io/en/stable/usage/structures/) :::info @@ -145,9 +145,9 @@ Amulet 可用于高版本地图转低版本，但在地图转换后可能出现 #### NKX 局部导入 -在 JAVA 版做完建筑，使用 [WE](https://modrinth.com/plugin/worldedit) / [FAWE](https://modrinth.com/plugin/fastasyncworldedit) 选区导出 .schematic 文件 +在 Java 版做完建筑，使用 [WorldEdit](https://modrinth.com/plugin/worldedit) / [FAWE](https://modrinth.com/plugin/fastasyncworldedit) 选区导出 `.schematic` 文件 -于 NKX 服务端内使用 [FastAsyncWorldEdit-Nukkit](https://cloudburstmc.org/resources/fastasyncworldedit.30/) 导入 .schematic 文件粘贴到指定位置 +于 NKX 服务端内使用 [FastAsyncWorldEdit-Nukkit](https://cloudburstmc.org/resources/fastasyncworldedit.30/) 导入 `.schematic` 文件粘贴到指定位置 :::warning @@ -159,4 +159,4 @@ schematic 导入粘贴可能会出现方块状态不正确的情况，例如楼 #### NKX 存档导入 -NukkitX 通用 JAVA 版 1.12.2 的世界，可直接替换进去 +NukkitX 通用 Java 版 1.12.2 的世界，可直接替换进去 diff --git a/docs/process/map/map.md b/docs/process/map/map.md index fa4c33519..883ec2c2c 100644 --- a/docs/process/map/map.md +++ b/docs/process/map/map.md @@ -240,9 +240,9 @@ sidebar_position: 7 :::warning -由于基岩版生态的问题，为了保证效率和质量，你应该在 JAVA 版完成建筑再将其转移到基岩版，而不是使用有限的工具折磨自己 +由于基岩版生态的问题，为了保证效率和质量，你应该在 Java 版完成建筑再将其转移到基岩版，而不是使用有限的工具折磨自己 -若你无法使用 Minecraft JE，尝试使用 **[Geyser](https://geysermc.org/)** 来进入为自己搭建的 JAVA 版工程服 +若你无法使用 Minecraft JE，尝试使用 **[Geyser](https://geysermc.org/)** 来进入为自己搭建的 Java 版工程服 [点击转跳到 `将地图转移到基岩版`](./convert.md#将地图转移到基岩版) @@ -294,14 +294,14 @@ sidebar_position: 7 ### 关于世界规则 -大量使用树叶，又不想关闭随机刻？请使用 persistent=true 的树叶 +大量使用树叶，又不想关闭随机刻？请使用 `persistent=true` 的树叶 使用浮空植物？请关闭随机刻放置方块更新 :::info -以上问题可使用 **[WorldGuard](https://modrinth.com/plugin/worldguard/)** 插件的 /stoplag 指令停止物理事件 +以上问题可使用 **[WorldGuard](https://modrinth.com/plugin/worldguard/)** 插件的 `/stoplag` 指令停止物理事件 -基岩版的不腐烂树叶是 persistent_bit=true +基岩版的不腐烂树叶是 `persistent_bit=true` ::: diff --git a/docs/process/map/plugin.md b/docs/process/map/plugin.md index e98038750..9fa029a15 100644 --- a/docs/process/map/plugin.md +++ b/docs/process/map/plugin.md @@ -9,7 +9,7 @@ sidebar_position: 1 ## 城市生成 -### Ouranos(付费) +### Ouranos (付费) Ouranos 是一个 Java 版的城市生成插件，可以用来无限的城市地形，生成的城市偏向中世纪风格 @@ -19,7 +19,7 @@ Ouranos 是一个 Java 版的城市生成插件，可以用来无限的城市地 ![](_images/825a21073ee817018bffff06e55d12da55b2a5b0.png) -### Arnis(免费) +### Arnis (免费) Arnis 是一个通过 OpenStreetMap 将现实世界的城市转换到 Minecraft 中的软件，可以自己选择转换的坐标 @@ -35,13 +35,13 @@ Arnis 是一个通过 OpenStreetMap 将现实世界的城市转换到 Minecraft ::: -### DungeonMMO(付费) +### DungeonMMO (付费) DungeonMMO 是一个 Java 版的地下城生成插件，自带一些模版，每次运行后，每个地下城都将被更新，所以你将永远不会看到相同的地下城 [购买地址](https://www.spigotmc.org/resources/106150/) -### MythicDungeons(付费) +### MythicDungeons (付费) 同样的地下城生成插件，但是没有模版 @@ -49,7 +49,7 @@ DungeonMMO 是一个 Java 版的地下城生成插件，自带一些模版，每 ## 迷宫生成 -### Tangled Maze Plus(付费) +### Tangled Maze Plus (付费) 一个迷宫生成插件，可以生成复杂的迷宫和奖励箱 @@ -63,7 +63,7 @@ DungeonMMO 是一个 Java 版的地下城生成插件，自带一些模版，每 地形生成可以生成更加好看的地形，由于这类插件较多，就不单独介绍了，以下是还在更新的 -- Terra(免费) [下载地址](https://modrinth.com/plugin/terra) +- Terra (免费) [下载地址](https://modrinth.com/plugin/terra) ![](_images/356845062-1de0bbf4-7d26-4beb-b010-2f4d88efdba4.png) @@ -73,13 +73,13 @@ DungeonMMO 是一个 Java 版的地下城生成插件，自带一些模版，每 ![](_images/iris.png) -- TerraformGenerator(付费/免费) [购买地址](https://www.spigotmc.org/resources/98309/) +- TerraformGenerator (付费/免费) [购买地址](https://www.spigotmc.org/resources/98309/) ![](_images/erra.jpg) ![](_images/terra2.png) -- Stratos(付费) [购买地址](https://www.spigotmc.org/resources/80313/) +- Stratos (付费) [购买地址](https://www.spigotmc.org/resources/80313/) ![](_images/st.png) diff --git a/docs/process/map/money.md b/docs/process/map/purchase.md similarity index 97% rename from docs/process/map/money.md rename to docs/process/map/purchase.md index 932e735ae..b3609bab1 100644 --- a/docs/process/map/money.md +++ b/docs/process/map/purchase.md @@ -69,7 +69,7 @@ sidebar_position: 3 ## 地图购买/白嫖 -[BreadBuilds](https://www.breadbuilds.com/) 是最大的地图网站，里面有很多优质的**免费/付费**地图 +[BreadBuilds](https://www.breadbuilds.com/) 是最大的地图网站，里面有很多优质的 **免费/付费** 地图 ![](_images/bb.png) diff --git a/docs/process/map/steal.md b/docs/process/map/steal.md index 90908a4bf..43774b198 100644 --- a/docs/process/map/steal.md +++ b/docs/process/map/steal.md @@ -17,12 +17,12 @@ NitWikit 不会教授偷取地图的方法 :::warning -目前没有**纯服务端**的解决方案，无论是 ClientDetectorPlus 还是其他的都无法检测到 WorldTools +目前没有 **纯服务端** 的解决方案，无论是 ClientDetectorPlus 还是其他的都无法检测到 WorldTools ::: -目前唯一的技术手段就是安装类似次元反作弊等**客户端模组**来屏蔽 WorldTools 等不信任的 mod +目前唯一的技术手段就是安装类似次元反作弊等 **客户端模组** 来屏蔽 WorldTools 等不信任的 mod -其他的手段就是为你的地图**申请著作权**，具体可以参考[这篇文章](https://www.bilibili.com/opus/847071725209255958) +其他的手段就是为你的地图 **申请著作权**，具体可以参考 [这篇文章](https://www.bilibili.com/opus/847071725209255958) 但是，这种方法非常耗费时间，并且需要 100 ~ 150 元，~~都快接近定制费了~~，所以需要理性考虑 diff --git a/docs/process/map/web.md b/docs/process/map/web.md index 1472056de..c7de24884 100644 --- a/docs/process/map/web.md +++ b/docs/process/map/web.md @@ -5,7 +5,7 @@ sidebar_position: 5 # 卫星地图 -通过此类功能的 Mod/Plugin 可以生成一个与服务端存档相对应的即时网页地图，通常以俯视、斜视或 3D 模型的形式呈现。 +通过此类功能的 mod/plugin 可以生成一个与服务端存档相对应的即时网页地图，通常以俯视、斜视或 3D 模型的形式呈现。 ## BlueMap @@ -21,7 +21,7 @@ sidebar_position: 5 ::: -一款非常简单好用的 Mod，将服务器地图以 3D 的方式在 Web 浏览器中进行查看，支持 2D 俯视角、第一人称、第三人称的多种地图查看方式。另外支持查看玩家的实时位置，以及玩家可以在卫星地图中添加自定义标记。 +一款非常简单好用的 mod，将服务器地图以 3D 的方式在 Web 浏览器中进行查看，支持 2D 俯视角、第一人称、第三人称的多种地图查看方式。另外支持查看玩家的实时位置，以及玩家可以在卫星地图中添加自定义标记。 ![](_images/bluemap-demo.png) @@ -37,7 +37,7 @@ sidebar_position: 5 ::: -一款历史悠久的卫星地图 Mod，支持用户在浏览器上查看服务器内的地图、玩家信息和其它一些附属功能，例如出生点、当前时间、是否下雨等，支持 2D 俯视角视图和 3D 俯视角视图查看。 +一款历史悠久的卫星地图 mod，支持用户在浏览器上查看服务器内的地图、玩家信息和其它一些附属功能，例如出生点、当前时间、是否下雨等，支持 2D 俯视角视图和 3D 俯视角视图查看。 ![](_images/dynmap-demo.png) diff --git a/docs/process/dashboard.md b/docs/process/panel.md similarity index 79% rename from docs/process/dashboard.md rename to docs/process/panel.md index d5d615177..604c9a535 100644 --- a/docs/process/dashboard.md +++ b/docs/process/panel.md @@ -21,15 +21,15 @@ MCSManager 是一款免费，易用，现代化的游戏服务器管理面板， #### Windows -首先，点击[此链接](https://cdn.imlazy.ink:233/files/mcsmanager_windows_release.zip) 一键下载到本地后解压 +首先，点击 [此链接](https://cdn.imlazy.ink:233/files/mcsmanager_windows_release.zip) 一键下载到本地后解压 解压之后，你就可以看到 `start.bat`，打开就可以启动 (就是这么简单) -关闭面板只需分别进入两个终端执行 `Ctrl+C` 即可。 +关闭面板只需分别进入两个终端执行 `Ctrl + C` 即可。 若需要设置开机自启动，可采用这种方法： -1. 在[微软官方网站](https://learn.microsoft.com/zh-cn/sysinternals/downloads/autologon)上下载 Autologon 程序并按照页面介绍配置好开机自动登录。 +1. 在 [微软官方网站](https://learn.microsoft.com/zh-cn/sysinternals/downloads/autologon) 上下载 Autologon 程序并按照页面介绍配置好开机自动登录。 2. 为上文所述的 `start.bat` 创建一个快捷方式，并将这个快捷方式移动至 `C:\ProgramData\Microsoft\Windows\Start Menu\Programs\StartUp`。 3. 重新启动并验证效果（可选），然后在面板的实例设置中启用实例的自动启动功能。 @@ -39,7 +39,7 @@ MCSManager 是一款免费，易用，现代化的游戏服务器管理面板， 在控制台输入 -```shell +```bash sudo su -c "wget -qO- https://script.mcsmanager.com/setup_cn.sh | bash" ``` @@ -47,7 +47,7 @@ sudo su -c "wget -qO- https://script.mcsmanager.com/setup_cn.sh | bash" 启动方式： -```shell +```bash # 先启动面板守护进程。 # 这是用于进程控制，终端管理的服务进程。 systemctl start mcsm-daemon.service @@ -75,15 +75,15 @@ systemctl stop mcsm-daemon.service ##### 手动安装 -```shell +```bash # 切换到安装目录，你也可以换成其他的目录。 cd /opt/ -# 下载 NodeJS 运行时环境，如果你已经安装了 NodeJS，请忽略此步骤。 +# 下载 Node.js 运行时环境，如果你已经安装了 Node.js，请忽略此步骤。 wget https://nodejs.org/dist/v20.11.0/node-v20.11.0-linux-x64.tar.xz tar -xvf node-v20.11.0-linux-x64.tar.xz -# 添加 NodeJS 到系统环境变量 +# 添加 Node.js 到系统环境变量 ln -s /opt/node-v20.11.0-linux-x64/bin/node /usr/bin/node ln -s /opt/node-v20.11.0-linux-x64/bin/npm /usr/bin/npm @@ -91,7 +91,7 @@ ln -s /opt/node-v20.11.0-linux-x64/bin/npm /usr/bin/npm mkdir /opt/mcsmanager/ cd /opt/mcsmanager/ -# 下载 MCSManager(如果无法下载可以先科学上网下载再上传到服务器) +# 下载 MCSManager (如果无法下载可以先科学上网下载再上传到服务器) wget https://github.com/MCSManager/MCSManager/releases/latest/download/mcsmanager_linux_release.tar.gz # 解压到安装目录 @@ -100,17 +100,17 @@ tar -zxf mcsmanager_linux_release.tar.gz 启动方式 -:::tip Screen +:::tip[screen] -关于 Screen 的教程，你可以看[这个](https://blog.csdn.net/u012964600/article/details/136968398) +关于 screen 的教程，你可以看 [这个](https://blog.csdn.net/u012964600/article/details/136968398) ::: -```shell +```bash # 安装依赖库 ./install.sh -# 请使用 Screen 程序打开两个终端窗口 (或者其他接管程序) +# 请使用 screen 程序打开两个终端窗口 (或者其他接管程序) # 先启动节点程序 ./start-daemon.sh diff --git a/docs/process/whitelist.md b/docs/process/whitelist.md index 082788767..52fcfac2e 100644 --- a/docs/process/whitelist.md +++ b/docs/process/whitelist.md @@ -23,7 +23,7 @@ import TabItem from '@theme/TabItem'; -包括所有 Java 服务端 +包括所有 Java 版服务端 在 `server.properties` 中打开 `white-list` @@ -86,7 +86,7 @@ allow-list=on ## 扩展插件 -### BistroWhitelist(Java 版) +### BistroWhitelist (Java 版) :::info @@ -94,7 +94,7 @@ allow-list=on `Gitee` https://gitee.com/myKasa/BistroWhitelist -`文档(中文)` https://wiki.mcxjg.cn/wiki/BistroWhitelist/%E7%AE%80%E4%BB%8B/ +`文档 (中文)` https://wiki.mcxjg.cn/wiki/BistroWhitelist/%E7%AE%80%E4%BB%8B/ `MineBBS` https://www.minebbs.com/resources/bistrowhitelist-bistrobot-qq.9058/ diff --git a/docs/reading-guide.md b/docs/reading-guide.md index cad5194db..e8a671653 100644 --- a/docs/reading-guide.md +++ b/docs/reading-guide.md @@ -11,7 +11,7 @@ sidebar_position: 2 :::tip -通常与下面的 Bedrock(基岩) 二选一 +通常与下面的 Bedrock (基岩) 二选一 ::: @@ -19,7 +19,7 @@ sidebar_position: 2 然后按照那里的目录顺序从上到下阅读 -## 我想开 Bedrock(基岩) 版服务器 +## 我想开 Bedrock (基岩) 版服务器 :::tip @@ -33,6 +33,6 @@ sidebar_position: 2 ## 跳转 -例如在 **"Java"** 的 [选择、下载和安装 Java](/Java/preparation/choose-and-download-and-install-java) 只贴了一行链接跳转到了通用 +例如在 **"Java"** 的 [选择、下载和安装 Java](/java/preparation/choose-and-download-and-install-java) 只贴了一行链接跳转到了通用 这是因为此部分内容 **“Java”** 与 **“Bedrock”** 相同。阅读完成那节回来即可 diff --git "a/docs/start/_images/\351\227\256\351\227\256\351\242\230\347\232\204\346\212\200\345\267\247/\345\246\202\344\275\225\344\275\277\347\224\250Mclogs-1.png" "b/docs/start/_images/\351\227\256\351\227\256\351\242\230\347\232\204\346\212\200\345\267\247/\345\246\202\344\275\225\344\275\277\347\224\250Mclogs-1.png" deleted file mode 100644 index 88b93cd14..000000000 Binary files "a/docs/start/_images/\351\227\256\351\227\256\351\242\230\347\232\204\346\212\200\345\267\247/\345\246\202\344\275\225\344\275\277\347\224\250Mclogs-1.png" and /dev/null differ diff --git "a/docs/start/_images/\351\227\256\351\227\256\351\242\230\347\232\204\346\212\200\345\267\247/\345\246\202\344\275\225\344\275\277\347\224\250Mclogs-2.png" "b/docs/start/_images/\351\227\256\351\227\256\351\242\230\347\232\204\346\212\200\345\267\247/\345\246\202\344\275\225\344\275\277\347\224\250Mclogs-2.png" deleted file mode 100644 index 56050c1e8..000000000 Binary files "a/docs/start/_images/\351\227\256\351\227\256\351\242\230\347\232\204\346\212\200\345\267\247/\345\246\202\344\275\225\344\275\277\347\224\250Mclogs-2.png" and /dev/null differ diff --git a/docs/start/ask-for-help.md b/docs/start/ask-for-help.md index b5929e3a1..9ce3c3674 100644 --- a/docs/start/ask-for-help.md +++ b/docs/start/ask-for-help.md @@ -15,7 +15,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) ::: @@ -25,11 +25,11 @@ sidebar_position: 7 **`怎么开基岩版互通`** -- 太直白了，请别人帮忙之前最好稍微带一些**态度**。 +- 太直白了，请别人帮忙之前最好稍微带一些 **态度**。 -**`什么是 pojav？插件的 wiki 在哪里？`** +**`什么是 pojav？插件的 Wiki 在哪里？`** -- **不要把群和人当做搜索引擎**(除非打钱了)。 +- **不要把群和人当做搜索引擎** (除非打钱了)。 **`我玩家进不来服务器怎么办`** @@ -44,7 +44,7 @@ sidebar_position: 7 - 以下这些情况，应该去天桥的老大爷找你算算命，因为没有有效的 log 没人能知道你遇到的问题。 - 在 **服务器** 问题中提供 **客户端** log。 - **不完整** 的 log，甚至 **不提供** log。 -- 错误的将**客户端**收到的报错当做**服务端**报错。 +- 错误的将 **客户端** 收到的报错当做 **服务端** 报错。 - **直接将成百上千行的 log 发到交流群** :::warning @@ -59,7 +59,7 @@ sidebar_position: 7 为避免无效问题，问问题最好需要符合以下几个基础原则： -1. 先查 wiki 或搜索 - [详细说明](#看完-wiki-再问) +1. 先查 Wiki 或搜索 - [详细说明](#看完-wiki-再问) 2. 礼貌用语 @@ -76,11 +76,11 @@ sidebar_position: 7 -3. 明确遇到的问题，到**对应群**里问 +3. 明确遇到的问题，到 **对应群** 里问 例如，你应该： -- 某插件出现不适配问题后在名为“我的世界服主交流群”的开服综合交流群里提问 `请问在升级 paper1.20.4 之后遇到 xxx 插件不适配应该怎么办？` +- 某插件出现不适配问题后在名为“我的世界服主交流群”的开服综合交流群里提问 `请问在升级 Paper1.20.4 之后遇到 xxx 插件不适配应该怎么办？` - 某小众插件与 Leaves 核心出现兼容性问题后在该插件官方交流群里提问 `作者大大，你的 xxx 插件和 leaves 核心是不是有兼容性问题呢？` 而不能： @@ -94,7 +94,7 @@ sidebar_position: 7 例如，你应该： - `大佬们我是 1.16.5 catserver 服务器，遇到了 xxx 问题` -- `最近我升级到了 1.21 paper 核心，玩家反应 xxx 有人有类似的问题吗？` +- `最近我升级到了 1.21 Paper 核心，玩家反应 xxx 有人有类似的问题吗？` 而不能： @@ -107,7 +107,7 @@ sidebar_position: 7 ### 看完 Wiki 再问 -Wiki 就是让你解决常见问题的，不看这玩意儿就在那瞎问只会获得 `滚过去看 wiki` 回复。 +Wiki 就是让你解决常见问题的，不看这玩意儿就在那瞎问只会获得 `滚过去看 Wiki` 回复。 几乎所有的软件都会附上 Wiki，它们一般位于： @@ -125,7 +125,7 @@ Wiki 就是让你解决常见问题的，不看这玩意儿就在那瞎问只会 对于不是网站形式的 Wiki 来说，也有许多种办法来搜索： -#### docx(Word 文档) +#### docx (Word 文档) 按下 `Ctrl + F` (Windows) 或 `Command + F` (macOS) 即可启动 Microsoft Word 或 WPS 的搜索功能，搜索当前文档。 @@ -139,7 +139,7 @@ Wiki 就是让你解决常见问题的，不看这玩意儿就在那瞎问只会 #### 笨蛋脚本 -使用此[脚本](https://script.8aka.org/update-log)， +使用此 [脚本](https://script.8aka.org/update-log)， 会将日志自动上传到 `https://mclo.gs` (默认上传的日志是 `logs/latest.log`) #### 如何上传 @@ -163,7 +163,7 @@ Wiki 就是让你解决常见问题的，不看这玩意儿就在那瞎问只会 ![](_images/屏幕截图%202025-02-07%20182759.png) -服务器 log 文件在服务端根目录的 logs 文件夹，一般上传 latest.log (服务端最新的日志) 即可 +服务器 log 文件在服务端根目录的 logs 文件夹，一般上传 `latest.log` (服务端最新的日志) 即可 ![](_images/屏幕截图%202025-02-07%20182930.png) @@ -176,7 +176,7 @@ Wiki 就是让你解决常见问题的，不看这玩意儿就在那瞎问只会 ![](\_images/问问题的技巧/如何使用 Mclogs-1.png) -服务器 log 文件在服务端根目录的 logs 文件夹，一般上传 latest.log (服务端最新的日志) 即可 +服务器 log 文件在服务端根目录的 logs 文件夹，一般上传 `latest.log` (服务端最新的日志) 即可 ![](\_images/问问题的技巧/如何使用 Mclogs-2.png) @@ -218,16 +218,12 @@ Wiki 就是让你解决常见问题的，不看这玩意儿就在那瞎问只会 :::warning -不遵守以上规则，可能会导致你被写入**乐子文档** +不遵守以上规则，可能会导致你被写入 **乐子文档** ::: **经典如何提问：https://settingdust.gitbook.io/stop-ask-questions-the-stupid-ways/** - - QQ 群 - - ### 经典老图 ![](_images/问问题的技巧/经典老图-1.jpg) diff --git a/docs/start/basic/what-is-caton.md b/docs/start/basic/what-is-lag.md similarity index 78% rename from docs/start/basic/what-is-caton.md rename to docs/start/basic/what-is-lag.md index a3adace3e..9e6ebe6b5 100644 --- a/docs/start/basic/what-is-caton.md +++ b/docs/start/basic/what-is-lag.md @@ -21,15 +21,15 @@ sidebar_position: 2 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 都小于 50ms，为了保证 Minecraft 以 20 Tick 每秒的速度运行，服务器将选择等待下一个 Tick； +**正常情况下**，每个 Tick 都小于 50 ms，为了保证 Minecraft 以 20 Tick 每秒的速度运行，服务器将选择等待下一个 Tick； ![](https://spark.lucko.me/docs/assets/images/ticks-with-sleeping-3b944bf10f5a21b16d1454f2d7fee434.png) -**服务器滞后时**，当服务器某个 Tick 无法在 50ms 内完成时，服务器将产生滞后，一旦滞后，每个 Tick 将会顺延，每秒钟发生的 Tick 将会减少。 +**服务器滞后时**，当服务器某个 Tick 无法在 50 ms 内完成时，服务器将产生滞后，一旦滞后，每个 Tick 将会顺延，每秒钟发生的 Tick 将会减少。 ![](https://spark.lucko.me/docs/assets/images/ticks-lagging-0bec1e4f565281af7a643f94222df521.png) @@ -41,7 +41,7 @@ Minecraft 服务器卡顿的底层逻辑是什么？ ### TPS -TPS(Ticks Per Second)(每秒 Tick 数) 正常应为 20，即服务器每秒钟进行 20 次更新，确保红石、生物 AI 等按照正常工作。 +TPS (Ticks Per Second)(每秒 Tick 数) 正常应为 20，即服务器每秒钟进行 20 次更新，确保红石、生物 AI 等按照正常工作。 :::warning @@ -52,7 +52,7 @@ TPS 只是最基础的量化卡顿程度。并不是 TPS 高，玩家就感受 ### MSPT -MSPT(Milliseconds Per Tick)(就是每进行一次 Tick 所花费的毫秒数) +MSPT (Milliseconds Per Tick)(就是每进行一次 Tick 所花费的毫秒数) 如果 MSPT 数值较低，说明服务器可以迅速快速进行每次 Tick，游戏运行更为流畅。 @@ -62,11 +62,11 @@ MSPT(Milliseconds Per Tick)(就是每进行一次 Tick 所花费的毫秒数) ### 查看 TPS 和 MSPT -1. 如果为 purpur fork 服务器可以输入 /tpsbar 查看 MSPT 和 TPS； +1. 如果为 Purpur fork 服务器可以输入 `/tpsbar` 查看 MSPT 和 TPS； -2. 如果为 paper 服务器可输入 /mspt 查看 MSPT，输入 /tps 查看 TPS； +2. 如果为 Paper 服务器可输入 `/mspt` 查看 MSPT，输入 `/tps` 查看 TPS； -3. 安装 [TpsBar](https://hangar.papermc.io/jmp/TabTPS) ，显示更好看。 +3. 安装 [TabTPS](https://hangar.papermc.io/jmp/TabTPS) 插件，显示更好看。 ## 网络延迟 diff --git a/docs/start/basic/what-is-log.md b/docs/start/basic/what-is-log.md index e16624dd4..dd4c616a5 100644 --- a/docs/start/basic/what-is-log.md +++ b/docs/start/basic/what-is-log.md @@ -5,9 +5,9 @@ sidebar_position: 6 # 什么是日志？ -**日志**记录了服务器的运行信息，运行时产生的错误和警告，同时也是大佬们用来分析为什么功能不正常或不能用的必要途径。 +**日志** 记录了服务器的运行信息，运行时产生的错误和警告，同时也是大佬们用来分析为什么功能不正常或不能用的必要途径。 -正常情况下，服务器的最新日志保存在 `服务器根目录/logs/latest.log` ，是**同步控制台输出**的。 +正常情况下，服务器的最新日志保存在 `服务器根目录/logs/latest.log` ，是 **同步控制台输出** 的。 每天凌晨 00:00 时服务器将会将最新的日志 **latest.log** 压缩为以时间命名的 gz 压缩文件。用压缩软件解压对应时间的压缩文件即可进行阅读。 @@ -35,7 +35,7 @@ sidebar_position: 6 ### 线程 -一般为 **Server thread** 即主线程，很多插件会调用 Craft Scheduler Thread 线程，或者为了优化主线程开销开启单独线程 (如 Luckperm )。 +一般为 **Server thread** 即主线程，很多插件会调用 Craft Scheduler Thread 线程，或者为了优化主线程开销开启单独线程 (如 LuckPerms)。 **Craft Scheduler Thread** 一般为插件使用 Bukkit 计划任务时自动开启的线程。 @@ -55,7 +55,7 @@ sidebar_position: 6 | WARN | 警告 | 对于一些潜在的风险进行警告，有可能发展为报错 | | ERROR | 错误 | 服务器出现错误后输出的信息 | -总的来说，当服务器出现异常时请立刻检查日志中是否出现了 WARN 或 ERROR 级别的报错，建议先搜索查看是否有人遇到类似情况，再结合翻译结果尝试修复。如果搞不定可以请教其他人，但是切记一定要先读一读 [如何提问](/docs/start/ask-for-help.md) +总的来说，当服务器出现异常时请立刻检查日志中是否出现了 `WARN` 或 `ERROR` 级别的报错，建议先搜索查看是否有人遇到类似情况，再结合翻译结果尝试修复。如果搞不定可以请教其他人，但是切记一定要先读一读 [如何提问](../ask-for-help.md) #### INFO @@ -82,7 +82,7 @@ sidebar_position: 6 [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/docs/start/basic/what-is-messy-code.md b/docs/start/basic/what-is-messy-code.md index 3681cc94c..da1d3a086 100644 --- a/docs/start/basic/what-is-messy-code.md +++ b/docs/start/basic/what-is-messy-code.md @@ -6,7 +6,7 @@ sidebar_position: 7 ## 什么是乱码？ 有时候，你会发现你的文本文件中的中文都莫名其妙变成了一些奇奇怪怪的符号，看起来乱糟糟的，毫无逻辑可言。 -这就是**乱码**。 +这就是 **乱码**。 ## 为什么会出现乱码？ @@ -16,7 +16,7 @@ sidebar_position: 7 ## 什么是编码？ -编码，也叫**字符编码**。通俗的讲，就是计算机的"字典"。你的文本文件在计算机中并不是以明文存在的，而是以一串二进制数表示的。比如： +编码，也叫 **字符编码**。通俗的讲，就是计算机的"字典"。你的文本文件在计算机中并不是以明文存在的，而是以一串二进制数表示的。比如： 如果你让计算机使用 A 编码，然后你输入了一个"人"字。那么在你输入后，计算机就会将"人"字转换为 A 编码中"人"字对应的二进制数。比如这个二进制数是 0010011。 @@ -41,18 +41,18 @@ sidebar_position: 7 ## 如何设置编码、转码 -这里以 VScode 为例： +这里以 VS Code 为例： ![](https://img.fastmirror.net/s/2024/07/19/6699cc78da4ab.png) 发现这是典型的口字码 -我们看到 VScode 右下角 +我们看到 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) diff --git a/docs/start/basic/what-is-permission.md b/docs/start/basic/what-is-permission.md index 63ebfbad2..373763533 100644 --- a/docs/start/basic/what-is-permission.md +++ b/docs/start/basic/what-is-permission.md @@ -25,15 +25,15 @@ sidebar_position: 5 ## 权限的设置 -我们有且只推荐 LuckPerms 作为权限插件，具体的使用方法请参考 [LuckPerms 使用方法](/Java/permission) +我们有且只推荐 LuckPerms 作为权限插件，具体的使用方法请参考 [LuckPerms 使用方法](/java/permission) 以下举例了一些常见的权限组分类： | 组名 | 说明 | | :------------- | :-------------------------------------------------------------------------------------------- | -| Newbie(新人) | Newbie 用户组包括最基础的权限节点，应该给予所有新加入玩家在注册时保证安全的权限 | -| Player(玩家) | Player 用户组包括了所有玩家可以使用的权限。一般包含经济、基础传送，和其他的基础指令 | -| Helper(协管员) | 一般允许拥有踢出玩家、监禁玩家、封禁玩家 IP 等权限。 | -| Admin(管理员) | 一般允许使用所有权限，且通常是唯一一个拥有控制插件、规定用户组、关闭/重启服务器命令的用户组。 | +| Newbie (新人) | Newbie 用户组包括最基础的权限节点，应该给予所有新加入玩家在注册时保证安全的权限 | +| Player (玩家) | Player 用户组包括了所有玩家可以使用的权限。一般包含经济、基础传送，和其他的基础指令 | +| Helper (协管员) | 一般允许拥有踢出玩家、监禁玩家、封禁玩家 IP 等权限。 | +| Admin (管理员) | 一般允许使用所有权限，且通常是唯一一个拥有控制插件、规定用户组、关闭/重启服务器命令的用户组。 | 当然你也可以自定义一个例如 VIP1、VIP2 的权限组，拥有比普通用户更多的权限。 diff --git a/docs/start/basic/what-is-plugin.md b/docs/start/basic/what-is-plugin.md index 00394b1e6..40c9c63c4 100644 --- a/docs/start/basic/what-is-plugin.md +++ b/docs/start/basic/what-is-plugin.md @@ -5,13 +5,13 @@ sidebar_position: 3 # 什么是插件？ -如果你玩过整合包你一定对 `Mod` (即模组) 这个概念相当了解，但如果你是第一次开服，你可能不知道什么是 `Plugin`(插件)，本文章会详细为你介绍。 +如果你玩过整合包你一定对 `Mod` (即模组) 这个概念相当了解，但如果你是第一次开服，你可能不知道什么是 `Plugin` (插件)，本文章会详细为你介绍。 ## 工作形式 不同于大部分模组需要同时安装在客户端和服务端，插件安装在 **服务端**， -玩家只需使用原版客户端即可进入服务器，大多数情况下不需要专门安装 Mod。 +玩家只需使用原版客户端即可进入服务器，大多数情况下不需要专门安装 mod。 插件为什么叫插件 (Plugins)，是因为它相对于模组 (Mods) 有更高的即时性， @@ -31,7 +31,7 @@ sidebar_position: 3 > > 服务器运行时不要轻易这么做，绝大多数插件本身不支持热加载，这么做会导致不可预料的后果。 > -> 如果你一定要逆天而行，查看 [插件管理](/Java/PluginMagagement) 页面。 +> 如果你一定要逆天而行，查看 [插件管理](/java/PluginMagagement) 页面。 :::warning @@ -59,7 +59,7 @@ SpigotMC 的插件版本支持除了 1.20.6 只会显示大版本号 (如 1.20) 虽然插件不能像模组那样直接更改游戏源代码，但是依然可以利用游戏本身的内容做出一些超乎寻常的事情 -这里是一些`超乎寻常`的插件 (对新手来说) +这里是一些 `超乎寻常` 的插件 (对新手来说) - Slimefun 在插件中实现模组的功能 - ItemsAdder/Oraxen 自定义方块物品 HUD 家具 (还有更多) @@ -68,4 +68,4 @@ SpigotMC 的插件版本支持除了 1.20.6 只会显示大版本号 (如 1.20) 插件服目前已经可以使用自定义，物品，方块，HUD，家具，Emoij，生物实体，农作物，树叶，Tooltip，附魔... -所以说不要轻易地认为插件在最终效果上不如 MOD，很多时候实际上不需要像模组那样修改源代码即可达到相同的效果，不是么？ +所以说不要轻易地认为插件在最终效果上不如 mod，很多时候实际上不需要像模组那样修改源代码即可达到相同的效果，不是么？ diff --git a/docs/start/basic/what-is-server.md b/docs/start/basic/what-is-server.md index 787a19c36..1845076d4 100644 --- a/docs/start/basic/what-is-server.md +++ b/docs/start/basic/what-is-server.md @@ -7,7 +7,7 @@ sidebar_position: 1 > 服务端是一种有针对性的服务程序。服务端是为客户端服务的，服务的内容诸如向客户端提供资源，保存客户端数据。 -简单来说，我们通常通过 _Minecraft_ **启动器**玩的游戏属于 **客户端**。 +简单来说，我们通常通过 _Minecraft_ **启动器** 玩的游戏属于 **客户端**。 当我们进行 _多人游戏_ 联机时，我们需要连接到一个服务器，当玩家们在同一个服务器环境下，我们才能实现联机。 @@ -34,7 +34,7 @@ _Minecraft_ 提供了让玩家可以进行 _多人游戏_ 的服务端，称为 由于原版 **Minecraft Server** 拓展性及性能不足，社区衍生出了多种提供 _多人游戏_ 的 **服务端**， 这些提供 _多人游戏_ 服务的 **程序/软件** 常被人称为 **核心**，大致可分为 -**[Mod](/Java/start/basic/what-is-mod)** 服务端和 **[插件](what-is-plugin.md)** 服务端。 +**[Mod](/java/start/basic/what-is-mod)** 服务端和 **[插件](what-is-plugin.md)** 服务端。 常见的 **Mod** 服务端有 **Forge** 和 **Fabric** 等。 diff --git a/docs/start/basic/what-is-startup-script.md b/docs/start/basic/what-is-startup-script.md index bd0ee7ef9..66ee8311d 100644 --- a/docs/start/basic/what-is-startup-script.md +++ b/docs/start/basic/what-is-startup-script.md @@ -11,17 +11,17 @@ _对于 Windows 服务器来说，启动脚本是 `.bat` 后缀的文件，对 L `sh` 和 `bat` 是两种不同操作系统环境下用于执行脚本的文件扩展名，它们的主要区别在于运行环境、语法的不同： -### SH (Shell Script)(Linux) +### sh (Shell Script)(Linux) -- 语法：SH 脚本使用 Shell 命令和控制结构，支持条件判断、循环、函数定义等高级编程特性。 +- 语法：sh 脚本使用 Shell 命令和控制结构，支持条件判断、循环、函数定义等高级编程特性。 - 执行方式：在终端通过 `./script.sh` 或 `sh script.sh` 来执行 (确保脚本具有执行权限)。 -### BAT (Batch File)(Windows) +### bat (Batch File)(Windows) -- 语法：BAT 脚本包含一系列 DOS 命令和批处理命令，支持简单的条件判断和循环，但相比 SH 脚本，其功能和灵活性较低。 +- 语法：bat 脚本包含一系列 DOS 命令和批处理命令，支持简单的条件判断和循环，但相比 sh 脚本，其功能和灵活性较低。 - 执行方式：双击文件或者在命令提示符下输入 `script.bat` 来执行。 -注意:Windows 和 Linux 的启动脚本不能通用，不是改一下后缀名就可以 +注意：Windows 和 Linux 的启动脚本不能通用，不是改一下后缀名就可以 ## 什么是启动参数 @@ -29,7 +29,7 @@ _对于 Windows 服务器来说，启动脚本是 `.bat` 后缀的文件，对 L - 标准参数 (-)：所有的 JVM 实现都必须实现这些参数的功能，而且向后兼容； - 非标准参数 (-X)：默认 JVM 实现这些参数的功能，但是并不保证所有 JVM 实现都满足，且不保证向后兼容； -- 非 Stable 参数 (-XX)：此类参数各个 JVM 实现会有所不同，将来可能会随时取消，需要慎重使用； +- 非 stable 参数 (-XX)：此类参数各个 JVM 实现会有所不同，将来可能会随时取消，需要慎重使用； ### 基础 @@ -65,9 +65,9 @@ java -Xms12G -Xmx12G -jar 核心名.jar nogui :::info -1. 无论什么时候，分配内存时一定要多预留 15% 左右内存，如服务器还剩余 10G 内存，不要将 -Xms 设置到大于 9G 的内存，否则会很危险。 +1. 无论什么时候，分配内存时一定要多预留 15% 左右内存，如服务器还剩余 10 G 内存，不要将 -Xms 设置到大于 9 G 的内存，否则会很危险。 2. 在 G1GC 模式下，尽量保证 Xmx = Xms 因为如果二者不同 JVM 需要更多的内存时候，JVM 需要申请更多内存，这个过程的耗时会导致顿卡。 -3. 更多的参数讲解，请前往 [JVM 参数优化](/Java/optimize/jvm) +3. 更多的参数讲解，请前往 [JVM 参数优化](/java/optimize/jvm) ::: @@ -88,6 +88,6 @@ goto start while [ true ]; do java ..... -jar 核心名.jar --nogui echo 服务器自动重启中 - echo 同时按下 CTRL + C 关服. + echo 同时按下 Ctrl + C 关服. done ``` diff --git a/docusaurus.config.ts b/docusaurus.config.ts index dfb4242ed..58eaa0faf 100644 --- a/docusaurus.config.ts +++ b/docusaurus.config.ts @@ -22,7 +22,7 @@ const config: Config = { start: "快速开始 🥵", // 标题颜色 titleColor: "white", - // 自定义swizzle配置 + // 自定义 swizzle 配置 swizzleConfig: { enabled: true, components: { @@ -107,7 +107,7 @@ const config: Config = { { id: "docs-java", path: "docs-java", - routeBasePath: "Java", + routeBasePath: "java", editUrl: "https://github.com/Cubic-Project/NitWikit/tree/main", sidebarPath: require.resolve("./sidebars.js"), editCurrentVersion: true, @@ -142,7 +142,7 @@ const config: Config = { { id: "docs-bedrock", path: "docs-bedrock", - routeBasePath: "Bedrock", + routeBasePath: "bedrock", editUrl: "https://github.com/Cubic-Project/NitWikit/tree/main", sidebarPath: require.resolve("./sidebars.js"), editCurrentVersion: true, @@ -226,7 +226,7 @@ const config: Config = { } }, image: "img/docusaurus-social-card.jpg", - metadata: [{ name: "keywords", content: "Minecraft, 开服教程, MC, 开服, 插件, 联机, 我的世界" }], + metadata: [{ name: "keywords", content: "Minecraft, 开服教程，MC, 开服，插件，联机，我的世界" }], navbar: { title: "Cubic Wiki", logo: { diff --git a/src/theme/DocItem/Footer/LastUpdated/index.js b/src/theme/DocItem/Footer/LastUpdated/index.js index e8455fa03..83550aec7 100644 --- a/src/theme/DocItem/Footer/LastUpdated/index.js +++ b/src/theme/DocItem/Footer/LastUpdated/index.js @@ -11,11 +11,11 @@ import { execSync } from "child_process"; function getContributors(filePath) { try { if (typeof window !== "undefined") { - // 浏览器环境下无法执行git命令 + // 浏览器环境下无法执行 git 命令 return []; } - // 使用git log获取所有提交者 + // 使用 git log 获取所有提交者 const command = `git log --format='%aN' -- "${filePath}" | sort | uniq`; const output = execSync(command, { encoding: "utf-8" }); @@ -24,12 +24,12 @@ function getContributors(filePath) { .filter(Boolean) .map((line) => line.replace(/'/g, "").trim()); } catch (error) { - console.error("获取文件贡献者失败:", error); + console.error("获取文件贡献者失败：", error); return []; } } -// 重写的LastUpdated组件 +// 重写的 LastUpdated 组件 export default function LastUpdated({ lastUpdatedAt, formattedLastUpdatedAt }) { const { metadata } = useDoc(); const [contributors, setContributors] = useState([]); diff --git a/static/img/back-top.svg b/static/img/back-top.svg deleted file mode 100644 index 7898f4a1a..000000000 --- a/static/img/back-top.svg +++ /dev/null @@ -1 +0,0 @@ - \ No newline at end of file diff --git a/static/img/crafting-table.svg b/static/img/crafting-table.svg deleted file mode 100644 index bd85350bc..000000000 --- a/static/img/crafting-table.svg +++ /dev/null @@ -1 +0,0 @@ - \ No newline at end of file diff --git a/static/img/docusaurus.png b/static/img/docusaurus.png deleted file mode 100644 index 4200afec5..000000000 Binary files a/static/img/docusaurus.png and /dev/null differ diff --git a/static/img/furnace.svg b/static/img/furnace.svg deleted file mode 100644 index 6f887d83c..000000000 --- a/static/img/furnace.svg +++ /dev/null @@ -1 +0,0 @@ - \ No newline at end of file diff --git a/static/img/grass.svg b/static/img/grass.svg deleted file mode 100644 index 1d5abddd8..000000000 --- a/static/img/grass.svg +++ /dev/null @@ -1 +0,0 @@ - \ No newline at end of file diff --git a/static/img/smooth-nitwikit-banner.png b/static/img/smooth-nitwikit-banner.png deleted file mode 100644 index 450a8d10c..000000000 Binary files a/static/img/smooth-nitwikit-banner.png and /dev/null differ