22 | >
23 | >在`extinguish.blockentites.ExtinguisherBracketBuiltinEntity.calculateDisguiseModel()`查看使用例。
24 | >
25 | > `BakedQuad bake()`
26 | >
27 | > 需要的操作完成后导出BakedQuad。
28 |
29 | 当你需要渲染导出的BakedQuad时，一般情况下建议使用`ModelBlockRenderer.tesselateWithAO(...)`。其他方法可能会导致不正确的光照或阴影。
30 |
31 | > - 显然，如果需要修改的BakedQuad并不是通常的样式，那么就自然地会产生奇奇怪怪的错乱。已知的例子有基岩、带釉陶瓦。
32 | >
33 | > - 对半透明面的处理不正确，目前尚未知晓解决方法。
34 | >
35 | > - 在TeaCon 2022期间，产生的错乱意外而短暂地得到了修复，目前不清楚是哪个mod的什么功能造成了此效果。
--------------------------------------------------------------------------------
/LICENSE:
--------------------------------------------------------------------------------
1 | The MIT License (MIT)
2 | Copyright © 2023 USS_Shenzhou
3 |
4 | Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
5 |
6 | The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
7 |
8 | THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
--------------------------------------------------------------------------------
/docs/r6ms/反作弊.md:
--------------------------------------------------------------------------------
1 | ---
2 | id: anti_cheat
3 | title: 反作弊
4 | hide_table_of_contents: false
5 |
6 | ---
7 |
8 | # 反作弊
9 |
10 | R6MS提供了一些专门的反作弊功能。这些功能仅在启用了正版验证的服务器上可用。
11 |
12 | ---
13 |
14 | ## 跨服务器作弊标记
15 |
16 | 此功能仅在启用了*Voyager*的服务器上可用。
17 |
18 | 如果玩家有作弊行为，服务器管理员对玩家进行封禁时，可以选择一并对玩家的同步系统账号进行标记：在`/ban`其之前先执行`/r6ms cheat-ban [玩家名]`。
19 |
20 | 服务器名称、所在服务器的ip地址、当前时间和管理员的UUID会被一并记录。如果有相应的截图等，请管理员自行保存。
21 |
22 | 在被标记超过一次后，如果玩家认为遇到了恶意封禁，可以在我们的KOOK服务器内进行申诉。
23 |
24 | 除非玩家发起申诉且被通过，其作弊记录不会被抹消。暂不接受管理员的撤回请求。
25 |
26 | 如果一个服务器短时间被多名玩家申诉且通过，服务器可能会被取消访问CSSS的权限。
27 |
28 | :::caution 注意
29 |
30 | - 被不同服务器标记超过一次的账号名称将会在对战中显示为粉色。
31 | - 被不同服务器标记超过三次的账号将会被禁止进入对战。
32 |
33 | :::
34 |
35 | ---
36 |
37 | ## 管理员监视
38 |
39 | 服务器管理员在其认为有必要时可以向玩家发起游戏监视。
40 |
41 | 在进入旁观对战并选中玩家后，管理员会有一个额外的“获取画面”按钮。如果管理员对某位玩家的行为有疑问，可以尝试使用此功能来获取其游戏内的一帧画面。玩家游戏中的画面将会被截取一帧图像并转发至管理员客户端。在此过程中玩家不会得到通知。
42 |
43 | 如果玩家设置了`管理员监视：拒绝`，或者出现了其他异常情况，你会获得相应的提示。
44 |
45 | 在获得画面后，如果管理员认为有必要，可以选择`保存`。图像将会被保存到管理员客户端的`游戏根目录/screenshot/r6ms-spy/`。
46 |
47 | **此功能默认启用。玩家可以在R6MS设置界面选择`管理员监视：拒绝`来禁用此功能。**当然——拒绝管理员监视可能会引起极大的怀疑。
--------------------------------------------------------------------------------
/docs/r6ms/voyager_home.md:
--------------------------------------------------------------------------------
1 | ---
2 | id: voyager_home
3 | title: Voyager
4 | hide_table_of_contents: false
5 | ---
6 |
7 | # 云上跨服务器数据同步服务
8 |
9 | 云上跨服务器数据同步服务，代号Voyager，能够把你拥有的武器涂装、对战场次记录、作弊情况等数据在不同的Minecraft多人游戏服务器之间同步。
10 |
11 | **如果要使用Voyager，请阅读[最终用户许可协议](voyager_eula)和[个人与统计信息收集政策](data_collect)，并在初次进入连接了Voyager的Minecraft多人游戏服务器时进行确认。** 有关个人信息跨境转移的内容也需要您同时确认。
12 |
13 | ## 工作原理
14 |
15 | 在你进入多人游戏服务器时，服务器会尝试从Voyager获取你的武器涂装和作弊次数。武器涂装数据随后会被转发至你的客户端以备选取。
16 |
17 | 如果你在Voyager中还没有任何记录，则会在你确认后自动地为你创建一条记录。
18 |
19 | 在你完成一场对战时，你的胜败和击杀信息会被上传至Voyager，这场对战的干员选取信息也会被上传至Voyager。
20 |
21 | ## 使用条件
22 |
23 | Voyager并不是在所有服务器默认可用。需要服务器管理员主动进行接入。有关更详细的说明，请查看[服务器管理员指南](op#voyager)。
24 |
25 | - 当你所在的服务器未接入同步时，你会在主菜单看到提示。如果你希望某个服务器接入同步，你可以联系服务器拥有者或管理员。
26 |
27 | 对于第三方验证登录的账号而言，Voyager是否适用的唯一决定因素是您当前的UUID是否与微软根据您用户名提供的UUID一致。
28 |
29 | - 如果服务器使用了*authlib-injector*，则Voyager可能不适用。
30 | - 如果服务器使用了*MultiLogin*，则Voyager仅向在Mojang验证服务器上拥有对应用户名和UUID的玩家提供。
31 |
32 | Voyager仅向拥有并使用正版账号的玩家提供。**Voyager仅向使用未经修改的R6MS jar的玩家和服务器提供。**
33 |
34 | 有关更详细的说明，请查看[最终用户许可协议](voyager_eula)。
35 |
36 | ## 问题追踪、意见或建议
37 |
38 | Voyager致力于让你在不同服务器之间实现平滑过渡。如果有任何问题，你可以通过页面下方的KOOK链接联系我们。
39 |
40 |
--------------------------------------------------------------------------------
/src/css/custom.css:
--------------------------------------------------------------------------------
1 | /**
2 | * Any CSS included here will be global. The classic template
3 | * bundles Infima by default. Infima is a CSS framework designed to
4 | * work well for content-centric websites.
5 | */
6 |
7 | /* You can override the default Infima variables here. */
8 | :root {
9 | --ifm-color-primary: #2583ff;
10 | --ifm-color-primary-dark: #226fd4;
11 | --ifm-color-primary-darker: #0450b3;
12 | --ifm-color-primary-darkest: #003a86;
13 | --ifm-color-primary-light: #1398e6;
14 | --ifm-color-primary-lighter: #0a9bf0;
15 | --ifm-color-primary-lightest: #2facf5;
16 | --ifm-code-font-size: 95%;
17 | --docusaurus-highlighted-code-line-bg: rgba(0, 0, 0, 0.1);
18 | }
19 |
20 | /* For readability concerns, you should choose a lighter palette in dark mode. */
21 | [data-theme='dark'] {
22 | --ifm-color-primary: #3c91ff;
23 | --ifm-color-primary-dark: #2d7feb;
24 | --ifm-color-primary-darker: #0963d8;
25 | --ifm-color-primary-darkest: #0050b9;
26 | --ifm-color-primary-light: #53c0ff;
27 | --ifm-color-primary-lighter: #51bfff;
28 | --ifm-color-primary-lightest: #79ceff;
29 | --docusaurus-highlighted-code-line-bg: rgba(0, 0, 0, 0.3);
30 | }
31 |
--------------------------------------------------------------------------------
/src/css/custom.css.backup:
--------------------------------------------------------------------------------
1 | /**
2 | * Any CSS included here will be global. The classic template
3 | * bundles Infima by default. Infima is a CSS framework designed to
4 | * work well for content-centric websites.
5 | */
6 |
7 | /* You can override the default Infima variables here. */
8 | :root {
9 | --ifm-color-primary: #2e8555;
10 | --ifm-color-primary-dark: #29784c;
11 | --ifm-color-primary-darker: #277148;
12 | --ifm-color-primary-darkest: #205d3b;
13 | --ifm-color-primary-light: #33925d;
14 | --ifm-color-primary-lighter: #359962;
15 | --ifm-color-primary-lightest: #3cad6e;
16 | --ifm-code-font-size: 95%;
17 | --docusaurus-highlighted-code-line-bg: rgba(0, 0, 0, 0.1);
18 | }
19 |
20 | /* For readability concerns, you should choose a lighter palette in dark mode. */
21 | [data-theme='dark'] {
22 | --ifm-color-primary: #25c2a0;
23 | --ifm-color-primary-dark: #21af90;
24 | --ifm-color-primary-darker: #1fa588;
25 | --ifm-color-primary-darkest: #1a8870;
26 | --ifm-color-primary-light: #29d5b0;
27 | --ifm-color-primary-lighter: #32d8b4;
28 | --ifm-color-primary-lightest: #4fddbf;
29 | --docusaurus-highlighted-code-line-bg: rgba(0, 0, 0, 0.3);
30 | }
31 |
--------------------------------------------------------------------------------
/docs/holojaneway/-6 Minecraft版本变化.md:
--------------------------------------------------------------------------------
1 | ---
2 | id: -6
3 | title: -6 Minecraft版本变化
4 | description: -6 Minecraft版本变化
5 | hide_table_of_contents: false
6 | sidebar_position: 40
7 |
8 | ---
9 |
10 | # Minecraft版本变化
11 |
12 | 这一章将会记录在MC版本更新之后需要做出、但又不方便以补丁形式写在其他章节中的改动。善用右侧目录和`ctrl+F`。
13 |
14 | 显然不可能完全记录所有可能需要的改动，作者也没有精力去搜集更多的信息——所以下列只是记录遇到的。
15 |
16 | ---
17 |
18 | ## 1.18.2→1.19.4
19 |
20 | - 这是一些第三方参考：
21 | - 1.19.2-1.19.3 https://gist.github.com/ChampionAsh5357/c21724bafbc630da2ed8899fe0c1d226
22 | - 1.19.3-1.19.4 https://gist.github.com/ChampionAsh5357/163a75e87599d19ee6b4b879821953e8
23 |
24 | - `RegistryEvent`→`RegisterEvent`。在泛型中指定注册类型→在参数中指定注册类型。可选的注册类型在`ForgeRegistries.Keys`内。
25 |
26 | - `setRegistryName`被取消。在`DeferredRegister.register`或`RegisterEvent.register`中指定。
27 |
28 | - `object.getRegistryName`→`ForgeRegistries.[注册类型].getKey(object)`。
29 |
30 | - `Component`（GUI）的各种子类被取消。`Component`现在提供对应的静态工厂方法。
31 |
32 | ## 1.19.4→1.20
33 |
34 | - 这是一些第三方参考：
35 | - https://gist.github.com/ChampionAsh5357/cf818acc53ffea6f4387fe28c2977d56
36 |
37 | - `PoseStack`（GUI）包装为 → `GuiGraphics`。
38 |
39 | - `GuiComponent`被取消。包含的方法并入`GuiGraphics`。
--------------------------------------------------------------------------------
/i18n/en/docusaurus-theme-classic/navbar.json:
--------------------------------------------------------------------------------
1 | {
2 | "title": {
3 | "message": "HoloJaneway",
4 | "description": "The title in the navbar"
5 | },
6 | "logo.alt": {
7 | "message": "My Site Logo",
8 | "description": "The alt text of navbar logo"
9 | },
10 | "item.label.Mod开发": {
11 | "message": "Mod Dev",
12 | "description": "Navbar item with label Mod开发"
13 | },
14 | "item.label.MadParticle": {
15 | "message": "MadParticle",
16 | "description": "Navbar item with label MadParticle"
17 | },
18 | "item.label.R6MS": {
19 | "message": "R6MS",
20 | "description": "Navbar item with label R6MS"
21 | },
22 | "item.label.GitHub": {
23 | "message": "GitHub",
24 | "description": "Navbar item with label GitHub"
25 | },
26 | "item.label.Mod开发教程": {
27 | "message": "Mod Development Tutorial",
28 | "description": "Navbar item with label Mod开发教程"
29 | },
30 | "item.label.Mod使用指南": {
31 | "message": "Mod Usage Guide",
32 | "description": "Navbar item with label Mod使用指南"
33 | },
34 | "item.label.点个Star吧！": {
35 | "message": "Give me a Star!",
36 | "description": "Navbar item with label 点个Star吧！"
37 | }
38 | }
39 |
--------------------------------------------------------------------------------
/docs/madparticle/Home.md:
--------------------------------------------------------------------------------
1 | ---
2 | id: home
3 | title: MadParticle 主页
4 | hide_table_of_contents: false
5 | sidebar_position: 100
6 | slug: /madparticle
7 | ---
8 |
9 | # MadParticle 指南
10 |
11 | .default})
12 |
13 | 欢迎来到MadParticle指南!
14 |
15 | ---
16 |
17 | 疯狂粒子受[Extinguish](https://www.curseforge.com/minecraft/mc-mods/extinguish-by-uss_shenzhou)在[Teacon 2022](https://www.teacon.cn/2022/index)中的表现启发，是一个主要适用于多人游戏和数据包的模组。依靠粒子贴图的再利用而不是新增加，有几乎无穷多的粒子可供您营造各种场景。
18 |
19 | MadParticle的设计哲学基于以下几条原则：
20 |
21 | - 最大化利用原版指令系统，以尽可能实现跨版本或平台兼容、持久化、便捷转移；
22 | - 不主动引入新的美术资源，除非是出于跨平台的需要；
23 | - 尽可能采用偏向Minecraft原版的美术风格。
24 |
25 | `/madparticle`命令是这个模组中最重要的部分。作为最基础的内容，你应该先完整阅读`/madparticle 命令指南`，随后在`Designer GUI指南`中学习对辅助设计工具的使用，并阅读剩下的章节。
26 |
27 | :::tip
28 |
29 | 请注意，MadParticle的主要设计功能是如上所述为游戏增加更多粒子，其优化功能仅为附带。
30 |
31 | :::
32 |
33 | :::info
34 |
35 | [杂项](madparticle/misc)一章包含许多有用的内容：
36 |
37 | - 完全自定义粒子
38 | - 在Fabric中使用MadParticle
39 | - 在服务器中使用MadParticle
40 | - 在ReplayMod中使用MadParticle
41 | - 在光影包中使用MadParticle
42 |
43 | :::
44 |
45 | **指南内容随着模组规划与开发而更新，故请注意其中可能含有未发布的模组内容。**
46 |
47 | :::info
48 |
49 | 如果有任何疑问或建议，您可以在页面最下方找到我们的KOOK服务器地址。
50 |
51 | :::
52 |
--------------------------------------------------------------------------------
/package.json:
--------------------------------------------------------------------------------
1 | {
2 | "name": "holo-janeway",
3 | "version": "0.0.0",
4 | "private": true,
5 | "scripts": {
6 | "docusaurus": "docusaurus",
7 | "start": "docusaurus start",
8 | "build": "docusaurus build",
9 | "swizzle": "docusaurus swizzle",
10 | "deploy": "docusaurus deploy",
11 | "clear": "docusaurus clear",
12 | "serve": "docusaurus serve",
13 | "write-translations": "docusaurus write-translations",
14 | "write-heading-ids": "docusaurus write-heading-ids"
15 | },
16 | "dependencies": {
17 | "@docusaurus/core": "^3.9.2",
18 | "@docusaurus/preset-classic": "^3.9.2",
19 | "@docusaurus/theme-mermaid": "^3.9.2",
20 | "@mdx-js/react": "^3.0.0",
21 | "clsx": "^1.2.1",
22 | "docusaurus": "^1.14.7",
23 | "prism-react-renderer": "^2.1.0",
24 | "react": "^18.2.0",
25 | "react-dom": "^18.2.0"
26 | },
27 | "devDependencies": {
28 | "@docusaurus/module-type-aliases": "^3.9.2",
29 | "@docusaurus/types": "^3.9.2"
30 | },
31 | "browserslist": {
32 | "production": [
33 | ">0.5%",
34 | "not dead",
35 | "not op_mini all"
36 | ],
37 | "development": [
38 | "last 1 chrome version",
39 | "last 1 firefox version",
40 | "last 1 safari version"
41 | ]
42 | },
43 | "engines": {
44 | "node": ">=18.0"
45 | }
46 | }
47 |
--------------------------------------------------------------------------------
/docs/r6ms/服务器管理员指南.md:
--------------------------------------------------------------------------------
1 | ---
2 | id: op
3 | title: 服务器管理员指南
4 | hide_table_of_contents: false
5 | ---
6 |
7 | # 服务器管理员指南
8 |
9 | 作为服务器管理员或拥有者，你需要了解以下所有内容。关于跨服务器同步服务，请查看[这里](cross_server#云跨服务器数据同步服务器拥有者和管理员)。
10 |
11 | ---
12 |
13 | ## 游戏内设置
14 |
15 | 如果你拥有4级权限，在打开R6MS设置时你会发现一个额外的`管理员`类别，其中包含一些特殊的选项。
16 |
17 | :::caution
18 |
19 | - 不建议在有其他玩家正在对战时进行更改，这是未定义行为。
20 | - 进行的更改可能不会立即生效。推荐你在完成更改后立即重启服务器。
21 |
22 | :::
23 |
24 | :::info
25 |
26 | **未定义行为**：指没有没明确地被规范的行为。通常不会导致游戏崩溃这样严重的错误，而是有可能产生一些奇怪的不符合预期的现象，也有可能不会有任何问题。
27 |
28 | :::
29 |
30 | ### 旁观对战：
31 |
32 | 限制哪些人可以进入旁观对战。
33 |
34 | 可被设为`允许`或`仅管理员`。默认为`允许`。
35 |
36 | ### 对战中光影：
37 |
38 | 在进入对战后是否可以使用自定义光影。
39 |
40 | 可被设为`自由`或`禁止`。默认为`自由`。
41 |
42 | ### 暂停对战在：
43 |
44 | 是否在服务器持续掉刻超过10秒时强制暂停对战。被暂停的玩家可以一直等待或在30秒后选择退出。
45 |
46 | 可被设为`TPS小于20时`，`TPS小于15时`，`TPS小于10时`或`从不`。默认为`TPS小于15时`。
47 |
48 | ---
49 |
50 | ## Voyager
51 |
52 | ### 获取接入权限
53 |
54 | 默认状况下，*Voyager*不可用。服务器上的玩家只能使用默认皮肤进行游戏。
55 |
56 | 如果你希望你的服务器接入*Voyager*，请按页面下方的链接加入KOOK服务器，进行相应的申请。
57 |
58 | 目前，使用*Voyager*是免费的。
59 |
60 | ### 设置配置文件
61 |
62 | 在你的申请通过后，你将收到访问*Voyager*所必要的数据。TODO
63 |
64 | ---
65 |
66 | ## 在服务器中售卖皮肤
67 |
68 |
69 |
70 | ---
71 |
72 | ## 控制台警告和错误
73 |
74 | 如果在服务器运行过程中出现警告和错误，你可以尝试在[错误与警告排除](faq#错误与警告排除)一节中寻找对应的解释和解决办法。
75 |
76 |
77 |
78 |
--------------------------------------------------------------------------------
/src/pages/index.module.css:
--------------------------------------------------------------------------------
1 | /**
2 | * CSS files with the .module.css suffix will be treated as CSS modules
3 | * and scoped locally.
4 | */
5 |
6 | .heroBanner {
7 | padding: 5rem 0;
8 | text-align: center;
9 | position: relative;
10 | overflow: hidden;
11 | }
12 |
13 | .buttons {
14 | display: flex;
15 | align-items: center;
16 | justify-content: center;
17 | }
18 |
19 | .uss_shenzhou_info {
20 | width: 100%;
21 | display: flex;
22 | align-items: center;
23 | justify-content: center;
24 | column-gap: 1rem;
25 | row-gap: 1rem;
26 | }
27 |
28 | .uss_shenzhou_info img {
29 | border-radius: 1rem;
30 | scale: 0.5;
31 | }
32 |
33 | .infoBox {
34 | padding: 2rem;
35 | width: 100%;
36 | display: flex;
37 | flex-direction: column;
38 | align-items: center;
39 | justify-content: center;
40 | text-align-all: center;
41 | }
42 |
43 | .text {
44 | width: 50%;
45 | font-size: 1.5rem;
46 | }
47 |
48 | @media screen and (max-width: 996px) {
49 | .heroBanner {
50 | padding: 2rem 0.5rem;
51 | }
52 |
53 | .uss_shenzhou_info {
54 | flex-direction: column;
55 | }
56 |
57 | .uss_shenzhou_info img {
58 | border-radius: 1rem;
59 | scale: 0.4;
60 | }
61 |
62 | .text {
63 | width: 80%;
64 | font-size: 1.2rem;
65 | }
66 | }
--------------------------------------------------------------------------------
/src/pages/index.js.old:
--------------------------------------------------------------------------------
1 | import React from 'react';
2 | import clsx from 'clsx';
3 | import Link from '@docusaurus/Link';
4 | import useDocusaurusContext from '@docusaurus/useDocusaurusContext';
5 | import Layout from '@theme/Layout';
6 | import HomepageFeatures from '@site/src/components/HomepageFeatures';
7 |
8 | import styles from './index.module.css';
9 |
10 | function HomepageHeader() {
11 | const {siteConfig} = useDocusaurusContext();
12 | return (
13 | {siteConfig.tagline}
17 |.default})
14 |
15 | 欢迎登上USS Vancouver！
16 |
17 | T88的名称源于《星际迷航：下层甲板》中提到的一种先进的手持探测工具，在这里是一个库模组，用于存放可以在一些mod之间共享的类，而无需重复编写。
18 |
19 | 此文档适用于T88最新版本。
20 |
21 | ---
22 |
23 | T88的主要设计目的/原则是便于我个人复用代码，并在版本更新时作为抽象层**尽量**减少上层需要的更改。
24 |
25 | T88包含以下几个功能：
26 |
27 | 1. `analyzer`：分析器，允许在游戏内方便地录制和查看开发时指定变量的图表，而不需要在日志中逐次打印再观测。
28 | 2. `config`：配置文件部分，提供一些工具以简化配置文件有关编写。基于GSON，故配置文件是json格式的。
29 | 3. `gui`：GUI部分，对原版GUI进行偏向Swing代码风格的简单抽象和封装。
30 | 4. `network`：网络包部分，提供一系列注解以简化网络包编写。
31 | 5. `networkanalyzer`：网络分析器，监视客户端/服务器上下行网络包流量。
32 | 6. `render`：渲染部分
33 | 1. 提供`RawQuad`以操作`BakedQuad`。
34 | 2. 提供`IFixedModelBlockEntity`以提高固定式BER的渲染效率。
35 | 7. `task`：一个简单的延时任务执行器。
36 | 8. `util`：其他一些杂项工具类。
37 |
38 | ## 启动选项
39 |
40 | T88有一些JVM选项可用：
41 |
42 | | 示例 | 说明 |
43 | | :---------------------------------------------------------- | :----------------------------------------------------------- |
44 | | `-Dt88.test_screen_override=org.example.yourmod.YourScreen` | 覆盖按下T88 GUI测试键（默认为`ALT+T`）时要启动的界面。.default})
28 |
29 | 在通常的语境中，我们极易把`Item`与`ItemStack`相混淆：你所见的这一个一个小格子是`ItemStack`，其中装着某个`Item`。
30 |
31 | 请注意，装有**相同**`Item`的**不同**`ItemStack`中的`Item`是**相同**对象！也就是说，这一个草方块和一组草方块两个`ItemStack`，其共同含有一个草方块实例。这意味着，你不能在你的`Item`中保存独有的对象。比如，你不应该这样写：
32 |
33 | ```java
34 | public abstract class WrongItem extends Item {
35 | private int id;
36 | ...
37 | ```
38 |
39 | 你如果在`inventoryTick(ItemStack pStack,...)`中尝试输出`id`和`pStack`，就会发现`pStack`不同而`id`相同。
40 |
41 | 如果你需要为某种`Item`保存独有的数据，你的首选是使用tag。当然也可以使用mixin，甚至可以自己造一个用于保存这个数据的轮子。
42 |
43 | ### 物品的耐久消耗
44 |
45 | 当你以某些方法修改（一般是减少）物品耐久时，请考虑在修改之前先判定物品是否能被损坏：
46 |
47 | ```java
48 | // 自然而直接地，你可能会这样写
49 | public void damage(ItemStack stack){
50 | stack.setDamageValue(stack.getDamageValue() + 1);
51 | }
52 |
53 | // 但是我更推荐这样做
54 | public void damage(ItemStack stack){
55 | if (stack.isDamageableItem()){
56 | stack.setDamageValue(stack.getDamageValue() + 1);
57 | }
58 | }
59 | ```
60 |
61 | 这样做的目的是支持`Unbreakable`标签。好处是，不但使玩家在创造模式下能够按需获得无限耐久的物品，也可以让玩家在生存模式下的某些特殊情况也能按需获得无限耐久的物品。
62 |
63 |
--------------------------------------------------------------------------------
/i18n/en/docusaurus-plugin-content-docs/current.json:
--------------------------------------------------------------------------------
1 | {
2 | "version.label": {
3 | "message": "Next",
4 | "description": "The label for version current"
5 | },
6 | "sidebar.r6ms.category.更新日志": {
7 | "message": "Update Logs",
8 | "description": "The label for category 更新日志 in sidebar r6ms"
9 | },
10 | "sidebar.madparticle.category./madparticle 命令指南": {
11 | "message": "Command Guide",
12 | "description": "The label for category Command Guideline in sidebar madparticle"
13 | },
14 | "sidebar.madparticle.category.Mad Particle指南": {
15 | "message": "MadParticle Guide",
16 | "description": "The label for category Mad Particle指南 in sidebar madparticle"
17 | },
18 | "sidebar.madparticle.category.Rawinbow6 Minesiege指南": {
19 | "message": "Rawinbow6 Minesiege Guide",
20 | "description": "The label for category Rawinbow6 Minesiege指南 in sidebar madparticle"
21 | },
22 | "sidebar.madparticle.category.玩家游玩指南": {
23 | "message": "Player Gameplay Guide",
24 | "description": "The label for category 玩家游玩指南 in sidebar madparticle"
25 | },
26 | "sidebar.madparticle.category.Voyager": {
27 | "message": "Voyager",
28 | "description": "The label for category Voyager in sidebar madparticle"
29 | },
30 | "sidebar.madparticle.category.更新日志": {
31 | "message": "Update Logs",
32 | "description": "The label for category 更新日志 in sidebar madparticle"
33 | },
34 | "sidebar.madparticle.category.Tell Me Where指南": {
35 | "message": "Guide Me To Guide",
36 | "description": "The label for category Tell Me Where指南 in sidebar madparticle"
37 | }
38 | }
39 |
--------------------------------------------------------------------------------
/src/components/HomepageFeatures/index.js:
--------------------------------------------------------------------------------
1 | import React from 'react';
2 | import clsx from 'clsx';
3 | import styles from './styles.module.css';
4 |
5 | const FeatureList = [
6 | {
7 | title: 'Easy to Use',
8 | Svg: require('@site/static/img/undraw_docusaurus_mountain.svg').default,
9 | description: (
10 | <>
11 | Docusaurus was designed from the ground up to be easily installed and
12 | used to get your website up and running quickly.
13 |
14 | ),
15 | },
16 | {
17 | title: 'Focus on What Matters',
18 | Svg: require('@site/static/img/undraw_docusaurus_tree.svg').default,
19 | description: (
20 | <>
21 | Docusaurus lets you focus on your docs, and we'll do the chores. Go
22 | ahead and move your docs into the docs directory.
23 |
24 | ),
25 | },
26 | {
27 | title: 'Powered by React',
28 | Svg: require('@site/static/img/undraw_docusaurus_react.svg').default,
29 | description: (
30 | <>
31 | Extend or customize your website layout by reusing React. Docusaurus can
32 | be extended while reusing the same header and footer.
33 |
34 | ),
35 | },
36 | ];
37 |
38 | function Feature({Svg, title, description}) {
39 | return (
40 | {description}
47 |
19 |
24 | English translations may not cover all pages. 25 |
26 |![USS_Shenzhou head]({require("@site/static/img/head.png").default})
43 |
44 |
18 |
19 | Welcome to the MadParticle Guide!
20 |
21 | ---
22 |
23 | Inspired by [Extinguish](https://www.curseforge.com/minecraft/mc-mods/extinguish-by-uss_shenzhou)'s showcase at [Teacon 2022](https://www.teacon.cn/2022/index), MadParticle is a mod primarily intended for multiplayer games and data packs. By creatively reusing existing particle textures rather than adding new ones, it provides nearly unlimited possibilities for particle effects in various scenarios.
24 |
25 | MadParticle's design philosophy is based on the following principles:
26 |
27 | - Maximizing the utilization of Minecraft's native command system for compatibility across versions or platforms, persistence, and ease of transfer.
28 | - Avoiding the introduction of new artistic assets unless required for cross-platform needs.
29 | - Maintaining a visual style that closely aligns with vanilla Minecraft.
30 |
31 | The `/madparticle` command is the most essential feature of this mod. As foundational content, you should first thoroughly read the `/madparticle Command Guide`, then explore the use of the auxiliary design tools in the `Designer GUI Guide`, and finally review the remaining chapters.
32 |
33 | :::tip
34 |
35 | Please note that MadParticle's primary purpose is to enhance particle effects in the game, with optimization features included as supplementary benefits.
36 |
37 | :::
38 |
39 | :::info
40 |
41 | The [Misc](madparticle/misc) section contains several useful topics:
42 |
43 | - Fully custom particles
44 | - Using MadParticle in Fabric
45 | - Using MadParticle on servers
46 | - Using MadParticle with ReplayMod
47 | - Using MadParticle with shader packs
48 |
49 | :::
50 |
51 | **This guide is updated alongside the planning and development of the mod, so be aware that it might include unreleased mod content.**
52 |
53 | :::info
54 |
55 | If you have any questions or suggestions, you can find our KOOK server address at the bottom of this page.
56 |
57 | :::
58 |
--------------------------------------------------------------------------------
/i18n/en/docusaurus-theme-classic/footer.json:
--------------------------------------------------------------------------------
1 | {
2 | "link.item.label.KOOK": {
3 | "message": "KOOK",
4 | "description": "The label of footer link with label=KOOK linking to https://kook.top/Bu1WLb"
5 | },
6 | "link.item.label.Bilibili": {
7 | "message": "Bilibili",
8 | "description": "The label of footer link with label=Bilibili linking to https://space.bilibili.com/266675750"
9 | },
10 | "link.item.label.GitHub": {
11 | "message": "GitHub",
12 | "description": "The label of footer link with label=GitHub linking to https://github.com/USS-Shenzhou"
13 | },
14 | "copyright": {
15 | "message": "\n Copyleft 2025 HoloJaneway, USS_Shenzhou. Built with Docusaurus.\n ![](\"https://beian.mps.gov.cn/web/assets/logo01.6189a29f.png\"){kind=logo}
川公网安备51112302000191号\n | 蜀ICP备2023001090号-1\n HoloJaneway网站使用MIT许可证。\n | The HoloJaneway website is licensed under MIT License.\n 《HoloJaneway Mod开发教程》使用CC BY-NC 4.0，BSD-3-Clause和GPLv3许可证。\n | The HoloJaneway Mod Developing Tutorial is licensed under CC BY-NC 4.0，BSD-3-Clause and GPLv3 License.\n USS_Shenzhou 对《Mod使用指南》中的所有内容保留所有权利。\n | All rights reserved for the Mod Usage Guidelines.\n \n ",
16 | "description": "The footer copyright"
17 | },
18 | "link.item.label.CurseForge": {
19 | "message": "CurseForge",
20 | "description": "The label of footer link with label=CurseForge linking to https://legacy.curseforge.com/members/uss_shenzhou/projects"
21 | },
22 | "link.item.label.Modrinth": {
23 | "message": "Modrinth",
24 | "description": "The label of footer link with label=Modrinth linking to https://modrinth.com/user/USS-Shenzhou"
25 | },
26 | "link.item.label.Discord": {
27 | "message": "Discord",
28 | "description": "The label of footer link with label=Discord linking to https://discord.gg/kNbGdDXpSA"
29 | }
30 | }
31 |
--------------------------------------------------------------------------------
/i18n/en/docusaurus-plugin-content-docs/current/madparticle/常见问题解答.md:
--------------------------------------------------------------------------------
1 | ---
2 | id: faq
3 | title: 常见问题解答
4 | hide_table_of_contents: false
5 | toc_max_heading_level: 4
6 | ---
7 |
8 | # 常见问题解答
9 |
10 | ---
11 |
12 | export const Box = ({children}) => (
13 | .default})
27 | .default})
28 | .default})
37 | .default})
98 |
99 | 80个循环型命令方块工作引起的额外mspt消耗约为13ms，平均每个循环型命令方块的mspt消耗为0.1625ms。
100 |
101 | ### /mp性能测试
102 |
103 | `/mp`使用经过简化的指令执行步骤，跳过了常规的指令解析工作。
104 |
105 | 使用同样的命令，80个循环型命令方块工作引起的额外mspt消耗约为4.5ms，平均每个循环型命令方块的mspt消耗为0.05625ms，是`/madparticle`消耗的约三分之一。
106 |
107 | :::caution
108 |
109 | 以上性能测试数据仅供参考。使用的服务端为开发环境下的Forge原生服务端。CPU为AMD Ryzen 7 5800X，频率4.65GHz，内存频率3200MHz。在不同的服务器环境下，具体的mspt消耗可能有所不同。
110 |
111 | :::
112 |
113 | :::info
114 |
115 | 不论是`/mp`还是`/madparticle`，解析时消耗的内存可能较大。我们未来会进行优化。
116 |
117 | :::
118 |
119 | ### 减少mspt消耗
120 |
121 | 最简单的办法是让服务器玩家使用红石时钟控制的脉冲型命令方块，在不必要时减少命令的执行。
122 |
123 | 如果您使用的是Forge版本的MadParticle，我推荐一同使用由TeaCon组委会制作的[PowerTool](https://github.com/teaconmc/PowerTool)，其中的`周期循环命令方块儿`能够比红石时钟更加方便地控制命令循环。
124 |
125 | :::info
126 |
127 | 众所周知，短时间内执行大量指令可能会对网络线程造成极大挑战；不过单指令内的粒子数量值大小则不会对服务器产生影响。
128 |
129 | :::
130 |
131 | ---
132 |
133 | ## 在ReplayMod中使用MadParticle
134 |
135 | 由于ReplayMod的录制原理是记录所有发生的事情并将其重复，即不会记录粒子的位置而是重新生成，故你可能需要特别注意：
136 |
137 | - 如果存在大量的运动粒子，你可能需要在渲染前提高码率。
138 | - 在录制时为正片素材留下足够的预备时间，这个时间的长度一般由你的粒子具体作用、生成频率、存活时间、运动距离决定。
139 | - 在渲染前，关闭快速模式，从预留时间处开始播放至接近第一个时间关键帧，然后启动渲染。其目的是避免重新生成世界导致已经出现的粒子消失。
140 | - 如果你的指令中有随机因素（比如生成坐标误差不为0），replay中的粒子对应的因素会与录制时不同，每次重新replay也不同。
141 |
142 | ---
143 |
144 | ## 在光影包中使用MadParticle
145 |
146 | 由于粒子在视觉效果占比的增加，一些问题需要额外注意：
147 |
148 | - 光影包对半透明粒子的处理很有可能不正确或不符合预期。
149 | - 尤其是在即时录制时：如果你的游戏帧率不太高，建议关闭TAA。TAA在低帧率下导致的拖影会在粒子这种与背景区别较大的物体上尤其明显。这是由TAA的原理决定的。
150 |
--------------------------------------------------------------------------------
/docs/madparticle/杂项.md:
--------------------------------------------------------------------------------
1 | ---
2 | id: misc
3 | title: 杂项
4 | hide_table_of_contents: false
5 | ---
6 |
7 | # 杂项
8 |
9 | 以下进行一些简短的讲解。
10 |
11 | ---
12 |
13 | ## 完全自定义粒子
14 |
15 | MadParticle提供另一个非常强大的功能，允许你自由且非常方便地为游戏添加新粒子。
16 |
17 | :::info 注意
18 |
19 | 添加的新粒子应该仅用于`/mp`或`/madparticle`指令的参数，而**不应该**将其用于`/particle`等处。将其用于其他地方是未定义行为。
20 |
21 | :::
22 |
23 | 如果游戏内的各种粒子贴图无法满足你的需求，你可以通过这个功能添加你自己的粒子。
24 |
25 | 你只需要准备好粒子贴图，然后把它们放进游戏根目录的`customparticle`文件夹内，并遵循如下的命名规则：
26 |
27 | - 如果这个粒子只有一张贴图（即不随着年龄变化，或是在生成时没有随机变化）：
28 | - 你只需要将其命名为`<粒子名称>.png`。例如`leaves.png`。
29 | - 如果这个粒子有多张贴图：
30 | - 你需要从0开始，依次将其命名为`<粒子名称>#<序号>.png`，例如`smoke#0.png`，`smoke#1.png`。
31 | - 生成的粒子默认命名空间为`madparticle`。如果你想自定义命名空间：
32 | - 请在文件名前面加上`<命名空间>~`，例如`nocaet~leaves.png`，`test~smoke#1.png`。
33 |
34 | :::danger 注意
35 |
36 | 请严格按照命名规则填写文件名。
37 |
38 | :::
39 |
40 | 如果你的命名有误，日志中可能会有相应的提醒，以便于找到具体对应的文件。
41 |
42 | 启动游戏，你应该就能看到新粒子了！
43 |
44 | :::caution
45 |
46 | - 过多的`.png`文件可能会导致游戏加载缓慢。懒得优化，只有等。
47 | - 目前暂时没有与服务端同步图片的功能。在多人游戏中使用自定义粒子是未定义行为。
48 |
49 | :::
50 |
51 | ---
52 |
53 | ## 在Fabric中使用MadParticle
54 |
55 | MadParticle提供Fabric版本，但有且只有核心功能：解析命令并生成粒子，不提供GUI辅助工具。
56 |
57 | 当然，我并不推荐在Fabric版本中徒手编写如此长的命令，所以在一般情况下有几种方案：
58 |
59 | - 你可以先使用Forge版本完成地图有关MP部分的制作，再将其复制到Fabric版本中。
60 | - 作为一个变通，你也可以用WorldEdit的schme来转移编写好的命令方块。
61 | - 当然，你可以同时打开Forge和Fabric客户端，在Forge版本的Designer GUI中编写好命令，复制到Fabric版本中。
62 |
63 | :::tip
64 |
65 | 请关注Fabric/Forge两端版本更新可能导致的命令参数变化。
66 |
67 | :::
68 |
69 | 很有可能你需要用到的某个粒子由某个Mod提供，而这个Mod仅在Forge端提供——这正是发明完全自定义粒子的初衷。
70 |
71 | :::caution
72 |
73 | 在复制某个mod的资产时，请注意其许可证是否允许你这样做。
74 |
75 | :::
76 |
77 | 你只需要在拷贝存档前，将需要的粒子图片文件复制到Fabric端的`customparticle`文件夹内，并按上述的规则指定命名空间即可。
78 |
79 | ---
80 |
81 | ## 在服务器中使用MadParticle
82 |
83 | 我了解您作为服主或管理员对服务器性能的担忧。
84 |
85 | 在MadParticle Forge 0.2.0（Fabric 0.1.0）版本之后，对`/madparticle`和`/mp`命令的解析均以异步方式执行，这在多数情况下减少了对主线程的干扰。但如果您的服务器只有1个核心，那可能会存在一些极其轻微的负面影响。
86 |
87 | ### /madparticle性能测试
88 |
89 | 在接下来的性能测试中，我们使用这条命令作为测试例。其含有2个子粒子，适合用来代表一般情况：
90 |
91 | ```
92 | madparticle minecraft:crit RANDOM 30 FALSE 1 ~ ~1 ~ 0.0 0.0 0.0 0.0 0.45 0.0 0.05 0.05 0.05 FALSE 0 0 0 0.97 0.97 0.15 0.15 0 0 0 0 0.0 TRUE 0 0 PARTICLE_SHEET_TRANSLUCENT 0.996 0.801 0.318 1.0 1.0 1 LINEAR 1 1 LINEAR @a expireThen minecraft:cloud RANDOM 40 FALSE 1 = = = 0.0 0.0 0.0 0.0 0.0 0.0 0.08 0.0 0.08 FALSE 0 0 0 0.97 0.97 0.0 0.0 0 0 0 0 0.0 TRUE 0 0 PARTICLE_SHEET_TRANSLUCENT 0.996 0.733 0.216 1.0 1 0.6 LINEAR 1 1 LINEAR @a expireThen minecraft:cloud RANDOM 20 FALSE 1 = = = 0.0 0.0 0.0 = = = 0.0 0.0 0.0 FALSE 0 0 0 0.96 0.96 0.0 0.0 0 0 0 0 0.0 TRUE 0 0 PARTICLE_SHEET_TRANSLUCENT 0.996 0.860 0.725 1.0 1.0 1 LINEAR 1 1 LINEAR @a
93 | ```
94 |
95 | 其效果如下图：
96 |
97 |
98 |
99 | 80个循环型命令方块工作引起的额外mspt消耗约为13ms，平均每个循环型命令方块的mspt消耗为0.1625ms。
100 |
101 | ### /mp性能测试
102 |
103 | `/mp`使用经过简化的指令执行步骤，跳过了常规的指令解析工作。
104 |
105 | 使用同样的命令，80个循环型命令方块工作引起的额外mspt消耗约为4.5ms，平均每个循环型命令方块的mspt消耗为0.05625ms，是`/madparticle`消耗的约三分之一。
106 |
107 | :::caution
108 |
109 | 以上性能测试数据仅供参考。使用的服务端为开发环境下的Forge原生服务端。CPU为AMD Ryzen 7 5800X，频率4.65GHz，内存频率3200MHz。在不同的服务器环境下，具体的mspt消耗可能有所不同。
110 |
111 | :::
112 |
113 | :::info
114 |
115 | 不论是`/mp`还是`/madparticle`，解析时消耗的内存可能较大。我们未来会进行优化。
116 |
117 | :::
118 |
119 | ### 减少mspt消耗
120 |
121 | 最简单的办法是让服务器玩家使用红石时钟控制的脉冲型命令方块，在不必要时减少命令的执行。
122 |
123 | 如果您使用的是Forge版本的MadParticle，我推荐一同使用由TeaCon组委会制作的[PowerTool](https://github.com/teaconmc/PowerTool)，其中的`周期循环命令方块儿`能够比红石时钟更加方便地控制命令循环。
124 |
125 | :::info
126 |
127 | 众所周知，短时间内执行大量指令可能会对网络线程造成极大挑战；不过单指令内的粒子数量值大小则不会对服务器产生影响。
128 |
129 | :::
130 |
131 | ---
132 |
133 | ## 在ReplayMod中使用MadParticle
134 |
135 | 由于ReplayMod的录制原理是记录所有发生的事情并将其重复，即不会记录粒子的位置而是重新生成，故你可能需要特别注意：
136 |
137 | - 如果存在大量的运动粒子，你可能需要在渲染前提高码率。
138 | - 在录制时为正片素材留下足够的预备时间，这个时间的长度一般由你的粒子具体作用、生成频率、存活时间、运动距离决定。
139 | - 在渲染前，关闭快速模式，从预留时间处开始播放至接近第一个时间关键帧，然后启动渲染。其目的是避免重新生成世界导致已经出现的粒子消失。
140 | - 如果你的指令中有随机因素（比如生成坐标误差不为0），replay中的粒子对应的因素会与录制时不同，每次重新replay也不同。
141 |
142 | ---
143 |
144 | ## 在光影包中使用MadParticle
145 |
146 | 由于粒子在视觉效果占比的增加，一些问题需要额外注意：
147 |
148 | - 光影包对半透明粒子的处理很有可能不正确或不符合预期。
149 | - 尤其是在即时录制时：如果你的游戏帧率不太高，建议关闭TAA。TAA在低帧率下导致的拖影会在粒子这种与背景区别较大的物体上尤其明显。这是由TAA的原理决定的。
150 |
--------------------------------------------------------------------------------
/docs/tellmewhere/signblock.md:
--------------------------------------------------------------------------------
1 | ---
2 | id: signblock
3 | title: 指示牌方块
4 | description: 指示牌方块
5 | hide_table_of_contents: false
6 |
7 |
8 | ---
9 |
10 |
11 |
12 | # 指示牌方块
13 |
14 | :::tip
15 |
16 | 只有指示牌中的纯文字部分使用动态渲染（BER），其余图片、背景、壳体均采用`ChunkBuffer`进行高效渲染。你可以想放多少指示牌就放多少。
17 |
18 | :::
19 |
20 | ## 使用
21 |
22 | :::info
23 |
24 | 我们事先约定，将指示牌放置于世界中，面向放置者、有黑色背景的一面为**正面**。东西方向（或是南北方向）是**平行**的。
25 |
26 | :::
27 |
28 | 放下指示牌后，右键单击指示牌正面即可打开指示牌编辑界面。
29 |
30 | :::info
31 |
32 | ### 指示牌编辑界面
33 |
34 | 右侧为标志选取区域，左上侧为主编辑区，左下侧为国际化编辑区。
35 |
36 | 单击你想要的标志，即可在光标所在处插入图像代码，同时在上方显示预览。
37 |
38 | **编辑完成后，别忘了点击*完成* ！**
39 |
40 | :::
41 |
42 | 手持完整方块（对应的物品）右击指示牌侧面或背面可以为指示牌设置外观。应用外观时会使用手持方块的默认`BlockState`。
43 |
44 | 在现有指示牌的侧面放下平行的同一种指示牌，显示区域会自动连接。在这情况下，显示的内容由最左侧（面向显示区域）的指示牌决定。当正面右击这一排指示牌中的任意一个时，总是会打开最左侧指示牌的编辑界面。
45 |
46 | :::tip
47 |
48 | 你可以在放下一排指示牌后，绕到后方重新放置最左侧的指示牌，这样就可以有一个双面指示牌了！
49 |
50 | :::
51 |
52 | ## 选取
53 |
54 | GMT提供形态各异的各种指示牌变体。
55 |
56 | 最基础的指示牌是`挂式 薄`指示牌，拥有8像素（在x16材质下）的屏幕宽度，适用于各种场合。
57 |
58 | 如果你想提高指示牌的可用距离，或是显示一些特别重要的内容，你可以选择`宽`变体，拥有14像素的屏幕宽度，或许不够美观但足够醒目。
59 |
60 | `窄`变体只有4像素的屏幕宽度，建议仅作为导流带，或是狭小空间近距离指示用。
61 |
62 | ## 内容
63 |
64 | ### 排列
65 |
66 | 需要时在同一块指示牌上表表示不同方向的内容时，内容排列应遵循以下原则：
67 |
68 | 1. 指示方向的标志应当放置在实际方向的对应处。以左侧为例，各方向的优先级为：
69 |
70 | .default})
85 | .default})
86 | .default})
87 | .default})
88 | .default})
89 | .default})
90 | .default})
91 | .default})
92 |
115 | .default})
116 | .default})
122 | .default})
124 | 
川公网安备51112302000191号
181 | | 蜀ICP备2023001090号-1
182 | HoloJaneway网站使用MIT许可证。
183 | | The HoloJaneway website is licensed under MIT License.
184 | 《HoloJaneway Mod开发教程》使用CC BY-NC 4.0，BSD-3-Clause和GPLv3许可证。
185 | | The HoloJaneway Mod Developing Tutorial is licensed under CC BY-NC 4.0，BSD-3-Clause and GPLv3 License.
186 | USS_Shenzhou 对《Mod使用指南》中的所有内容保留所有权利。
187 | | All rights reserved for the Mod Usage Guidelines.
188 |
189 | `,
190 | },
191 | prism: {
192 | theme: lightTheme,
193 | darkTheme: darkTheme,
194 | additionalLanguages: ['java','toml','gradle','json','cmake','powershell'],
195 | },
196 | }),
197 | markdown:{
198 | mermaid:true,
199 | },
200 | themes:['@docusaurus/theme-mermaid'],
201 | };
202 |
203 | module.exports = config;
204 |
--------------------------------------------------------------------------------
/docs/holojaneway/0.2 服务端和客户端.md:
--------------------------------------------------------------------------------
1 | ---
2 | id: 0.2
3 | title: 0.2 服务端和客户端
4 | description: 服务端和客户端
5 | hide_table_of_contents: false
6 | sidebar_position: 102
7 | ---
8 |
9 | # 服务端和客户端
10 |
11 | 有关服务端和客户端的内容十分重要，值得我们在绪论之后单独开一节来讲。
12 |
13 | ---
14 |
15 | 如果你曾经自己开过服务器来玩，你应该就知道服务端和客户端是不同的。多人游戏时，物理服务端和物理客户端运行在不同的物理主机上，通过网络传输信息。而即使在单人游戏中，MC也存在一个逻辑服务端和一个逻辑客户端。
16 |
17 | 显然，有些数据需要在正确的一端进行运算，并同步至另外一端（幽灵方块就是个典型的反面例子）；有些数据只在一端存在（比如粒子效果）。单人游戏时两端在不同线程上运行，多人游戏时两端在不同设备上运行，显然这需要数据同步、更新才能保证程序的准确运行。
18 |
19 | ## 你是哪端的？
20 |
21 | 有一些方法在两端都会被执行，而一些时候我们希望在不同侧执行不同的逻辑，这就需要分辨。而通常参数中都会有`Level`：
22 |
23 | ```java
24 | public void bothSideMethod(Level level){
25 | if (level.isClientSide){
26 | //客户端逻辑
27 | } else {
28 | //服务端逻辑
29 | }
30 | }
31 | ```
32 |
33 | 借助`level.isClientSide`，我们可以判断传入的参数是对应逻辑服务端还是逻辑客户端。
34 |
35 | ## 获取服务端和客户端
36 |
37 | 在多数时候，方法的形参带有`level`，我们可以直接使用上面的方法来实现想要的逻辑。但偶尔我们需要“凭空”获取两端。
38 |
39 | 在客户端，要想获取客户端十分简单：
40 |
41 | ```java
42 | Minecraft minecraft = Minecraft.getInstance();
43 | //如果你还想要Level
44 | ClientLevel clientLevel = minecraft.level;
45 | ```
46 |
47 | 在服务端，你需要借助`LogicalSidedProvider`：
48 |
49 | ```java
50 | MinecraftServer minecraftServer = (MinecraftServer) LogicalSidedProvider.WORKQUEUE.get(LogicalSide.SERVER);
51 | //如果你还想要Level，由于有多个Level存在，你需要提前通过其他方法获取ResourceKey
18 |
19 | 本教程的**文字部分**，在没有特别标明的情况下，采用知识共享署名-非商业性使用 4.0 国际许可协议进行许可。
20 |
21 | 本教程的**代码部分**，在没有特别标明的情况下，采用BSD-3-Clause协议（The 3-Clause BSD License）进行许可；在有标明的情况下，该片段以标明的许可证进行许可。部分代码可能来源于`0 绪论 > 前言`中提到的mod，为了尽可能地减少学习和使用障碍，只有在涉及mod核心功能的情况下，才会被明确标为原本的协议（通常是有附加条款的GPLv3），未明确标明的按BSD-3授权。
22 |
23 | 许可证全文见`-1 附件`。
24 |
25 | ### 省流
26 |
27 | :::caution 注意
28 |
29 | 以下内容不是一个许可证，仅为便于理解而只强调一些关键点，没有法律价值。请以上文提到的许可证内容为准。
30 |
31 | :::
32 |
33 | 对于**文字部分**：
34 |
35 | > 你可以对这些内容自由地复制、分发、修改、再创作，并将演绎后的作品以其他许可证发布。但是你必须提供适当的署名，包括但不限于指向本教程的链接、本教程的许可声明、作者名称、作者网站等。供参考的署名内容见**附件**。你不可以将此部分及演绎作品用于商业用途。
36 |
37 | 对于**代码部分**，**没有专门标明许可证**，**即使用BSD-3-Clause协议**的部分：
38 |
39 | > 你可以对这些内容自由地复制、分发、修改、再创作，并将演绎后的作品以其他许可证发布。你可以将此部分及演绎作品用于商业用途。你同样也必须提供如上所述的适当署名内容。你不可以以本教程或作者的名义来推广你的演绎作品。
40 |
41 | 对于**代码部分**，**标明为GPLv3许可证**的部分：
42 |
43 | > 你可以对这些内容自由地复制、分发、修改、再创作，但必须将演绎后的作品继续以GPL许可证开源发布。你可以将此部分及演绎作品用于商业用途。你同样也必须提供如上所述的适当署名内容。除此之外，你还需要提供对这些部分的修改说明。
44 |
45 | ---
46 |
47 | :::danger 注意
48 |
49 | 以下内容不是正式的法律建议，您可能需要咨询专业的法律工作者。
50 |
51 | 以下内容不代表Mojang的官方态度，只是个人理解或引用。
52 |
53 | :::
54 |
55 | ## 刚刚上面这一坨都是啥？
56 |
57 | ### 开源和开源许可证
58 |
59 | 开源即指将你的mod的源代码以某种形式公开（通常是利用GitHub）。借由此，社区成员容易地检查你的代码，及时填补漏洞，帮助你发现和改进问题，增加兼容性，乃至于为你的mod开发附属mod。
60 |
61 | :::info
62 |
63 | **社区**：在这里所说的社区，自然是指Minecraft玩家与开发者的总和。
64 |
65 | **开源（软件）**：不同的组织对开源可能有不同的定义，而由于一些历史和翻译问题，这些定义从“开源就指的是自由软件”到“开源只需要开放源代码”不一而足。我们在这里采用最宽松的定义——只要你通过某种公开途径开放源代码即可。
66 |
67 | **自由（软件）**：与开源不同，自由软件有着明确且严格的定义。自由软件基金会对其定义如下：
68 |
69 | > - 自由度0：无论用户出于何种目的，必须可以按照用户意愿，自由地运行该软件。
70 | > - 自由度1：用户可以自由地学习并修改该软件，以此来帮助用户完成用户自己的计算。作为前提，用户必须可以访问到该软件的源代码。
71 | > - 自由度2：用户可以自由地分发该软件的拷贝，这样就可以助人。
72 | > - 自由度3：用户可以自由地分发该软件修改后的拷贝。借此，用户可以把改进后的软件分享给整个社区令他人也从中受益。作为前提，用户必须可以访问到该软件的源代码。
73 | >
74 | > 一个软件只有提供了以上所有的自由给它的用户，才可以被成为自由软件。
75 |
76 | 由这里你可以看出：大多数mod都是开源的（我们也提倡和鼓励这样）；但其中一部分mod可能有禁止商业使用的条款（例如CC BY-NC许可证），这使得这部分mod不是自由的。
77 |
78 | :::
79 |
80 | 你自然地拥有对你原创mod的著作权和版权。在一些时候，你需要向别人授予一些权利：
81 |
82 | - 其他开发者想要帮助你改进模组，即使你开放了源代码的获取，他们也需要复制和修改的权利；
83 | - 其他开发者想要将你的mod移植到Fabric，这需要复制、修改和再发行的权利；
84 | - 玩家希望将mod文件转载到其他平台，这需要复制和分发的权利。
85 |
86 | 而随着时间与项目的积累，作者对作品著作权的放宽或限制，逐渐有了某种常用而公认的集合，这就是开源协议，也叫开源许可证。
87 |
88 | 成文的开源协议方便地规范了使用者的行为，从最紧到最宽松，大概有这几种分类：
89 |
90 | - 保留所有权利（在作者没有写明开源协议时的默认选项，这不是一个自由许可证）
91 | - 著左权许可证（Copyleft，限制较为严格的开源协议种类）
92 | - 宽松许可证（限制较为宽松的开源协议种类）
93 | - 公有领域许可证（限制最宽松的开源协议种类）
94 |
95 | ### 有哪些许可证可供我选择？
96 |
97 | 这里列举出一些常见开源许可证，大体由严格到宽松，仅供参考。在做出选择前，你应该查看它们的详细内容：
98 |
99 | - "**All rights reserved**"，即“保留所有权利”，简称ARR：这意味着你可以对mod的分发、修改等制定任何你想要的（在法律范围内）的限制。
100 | - 非正式许可证：开发者在ARR基础上自行规定的许可证。当然，对普通人而言，很难写出在法律意义上与自己期望相符的、全面而有效的条款。不同国家的法律对非正式许可证可能有着不同的认可程度，在中国，据我所知目前没有与非正式许可证有关的判例或规定。
101 |
102 | - [GNU General Public License v3.0](https://www.gnu.org/licenses/gpl-3.0.zh-cn.html)，简称GPLv3：特点是让对你mod进行的修改也要开源。如果你有“我想看看你们都干了什么好事”的想法，那GPLv3很合适。
103 |
104 | :::caution 注意
105 |
106 | 这里有一个小问题：你的mod符合GNU对“组合程序”的说明，而Minecraft并不是一个自由软件。这使得你不能直接使用GPL许可证。你可以选择借助GPLv3的第七节，参考**[这个说明](https://www.gnu.org/licenses/gpl-faq.html#GPLIncompatibleLibs)**，为MC添加一个例外。
107 |
108 | 更多信息可以在**[这个说明及其链接问题](https://www.gnu.org/licenses/gpl-faq.html#GPLPlugins)**里找到。
109 |
110 | 为了规避这个问题，你可以选择**[LGPLv3](https://www.gnu.org/licenses/lgpl-3.0.html)**。不过它更多地适用于库模组而不是普通模组。
111 |
112 | :::
113 |
114 | - [APACHE LICENSE, VERSION 2.0](https://www.apache.org/licenses/LICENSE-2.0.html)，简称Apache 2.0：特点是在修改你的mod是必须保留你的版权信息。没什么特别的。
115 | - [The 3-Clause BSD License](https://opensource.org/licenses/BSD-3-Clause)，简称BSD3：特点是不允许其他人修改后的mod借你的名义宣传。除此之外很宽松。
116 | - [The MIT License](https://mit-license.org/)，简称MIT：只要别人修改时保留你原来的许可就行。
117 |
118 | :::tip
119 |
120 | 你可能发现MIT与上面的Apache 2.0有些相似——其实有很多许可证不同的重点在于专利、商标、纠纷等方面。对于一个简单的Minecraft模组而言，它们确实不会有很大区别。
121 |
122 | :::
123 |
124 | - [CC0](https://creativecommons.org/share-your-work/public-domain/cc0/)：与第一个相反，即“放弃所有权利”。使用CC0许可的作品即被视为公有领域作品。
125 |
126 | :::info
127 |
128 | 各式各样的CC协议通常不被用于程序或代码。对于CC0，你可以选择下面这个许可协议作为替代。
129 |
130 | :::
131 |
132 | - [Do What The Fuck You Want To Public License](http://www.wtfpl.net/about/)，简称WTFPL：与CC0相似，“放弃所有权利”。
133 |
134 | ### 如何选择开源许可证？
135 |
136 | :::caution 注意
137 |
138 | 选择不正确的许可证可能会使您受到不必要的损失。您可能需要咨询专业的法律工作者。
139 |
140 | :::
141 |
142 | 以下是一些可能有用的链接。
143 |
144 | - [帮助你选择你的许可证](https://choosealicense.com/ )。适合新手入门了解各主流许可证。英文。
145 | - [《各类许可证及其评论》](https://www.gnu.org/licenses/license-list.html#GPLCompatibleLicenses )。覆盖面相当广。有中文翻译页面。
146 | - [*Beginner's Guide to Licensing your Mods*](https://blog.modrinth.com/licensing-guide/ )。同样适合新手入门了解各种许可方式。英文。
147 |
148 | 以下问题可能也可以帮助你选择：
149 |
150 | - 如果你觉得没什么好保留的，欢迎任何人游玩、分发，其他开发者也可以在你的基础上制作自己的版本，随便怎么折腾都行：你可以选择MIT许可证。
151 |
152 |
153 |
154 | - 如果你想知道别人的衍生版本里面都有些啥：你可以选择GPLv3许可证。不过要记得上面提到的注意事项。
155 |
156 |
157 |
158 | - 如果你不想让别人的衍生版本借你的名义宣传：你可以给GPLv3许可证增加附加条款（其第7节允许你这样做）；或是使用BSD-3许可证。
159 |
160 |
161 |
162 | - 如果你不想让别人在商业服务器里使用你的模组，或是不想允许别人修改你的模组，或是不想允许别人转发你的模组：这将使你的模组不是自由软件。你几乎只能使用非正式许可证来声明这些限制，或是，尽管不推荐，使用CC协议的各个版本来偷懒。
163 |
164 |
165 |
166 | ### 为什么我们提倡把mod开源？
167 |
168 | > 开源（Open Source）是人类在互联网发展进程中探索出的一种面向全球的大规模协作生产方式，它以开放共享、合作共赢为宗旨，有效地推进了全球化进程。
169 | >
170 | > 开源许可证是对开源软件的使用、复制、修改和分发等行为进行规范和约束的一种具有法律效力的格式合同，是开源运动的基石。
171 | >
172 | >