Merge branch 'CFPAOrg:main' into main-aether-colon

Author: ChuijkYahus

.github/boring-cyborg.yml

@@ -19,19 +19,27 @@ labelPRBasedOnFilePath:
     1.20.x:
         - "projects/1.20/**"
         - "projects/1.20-fabric/**"
+
+    1.21.x:
+        - "projects/1.21/**"
+        - "projects/1.21-fabric/**"
 
     Forge:
         - "projects/1.12.2/**"
         - "projects/1.16/**"
         - "projects/1.18/**"
         - "projects/1.19/**"
+
+    (Neo)Forge:
         - "projects/1.20/**"
+        - "projects/1.21/**"
 
     Fabric:
         - "projects/1.16-fabric/**"
         - "projects/1.18-fabric/**"
       # - "projects/1.19-fabric/**"
         - "projects/1.20-fabric/**"
+        - "projects/1.21-fabric/**"
 
     Patchouli:
         - "projects/**/patchouli_books/**"
@@ -81,8 +89,9 @@ labelerFlags:
 firstPRWelcomeComment: |
     你好贡献者，欢迎贡献本项目。请阅读 CLA Assistant 给出的《贡献者许可协议》并决定是否签署，若不签署，我们将无法接收你的贡献。
     你已成功发送你在 CFPA 仓库的第一个 Pull Request！请在几分钟之后观察 CFPA-Bot 给出的内容，看是否存在报错。
-    **请注意！**如果存在错误，**不要**关闭 Pull Request，几乎所有可能出现的错误都能在不关闭 Pull Request 的情况下解决。如果频繁新建/关闭 Pull Request，你可能遭到封禁。
+    **请注意！** 如果存在错误，**不要**关闭 Pull Request，几乎所有可能出现的错误都能在不关闭 Pull Request 的情况下解决。如果频繁新建/关闭 Pull Request，你可能遭到封禁。
     确认无误后请耐心等待审阅，并在审阅人提出意见给出答复或修改内容。
+    若要提交多个模组，请新建一个基于 upstream/main 的分支，再向新分支提交其他模组的翻译，并发送 Pull Request。
     如需快速联系，请[加 QQ 群](http://qm.qq.com/cgi-bin/qm/qr?_wv=1027&k=b1iBq79z3h1OtJpEl8gstrhlu_oYlyl6&authKey=LgDPZAJSg2uFKjiMylQkkef9tAfTja8W4rBd5KkN6aSsYKpWKFbSqrM9GY7AoHJ7&noverify=0&group_code=630943368)：630943368
 
 # Comment to be posted to congratulate user on their first merged PR

.github/workflows/packer.yml

@@ -99,7 +99,7 @@ jobs:
       matrix:
         # 版本列表。将对这里的每个版本判断，按需打包。
         # 如需添加新版本，在这里添加即可。
-        version: [ "1.12.2", "1.16", "1.16-fabric", "1.18", "1.18-fabric", "1.19", "1.20", "1.20-fabric" ]
+        version: [ "1.12.2", "1.16", "1.16-fabric", "1.18", "1.18-fabric", "1.19", "1.20", "1.20-fabric", "1.21", "1.21-fabric" ]
     runs-on: windows-latest
     steps:
       - uses: actions/checkout@v2
@@ -136,7 +136,7 @@ jobs:
 
       # Artifact 上传内容：每个版本一个压缩包，包含了资源包和md5校验文件
       - name: Upload Artifact for ${{ matrix.version }}
-        uses: actions/upload-artifact@v3.0.0
+        uses: actions/upload-artifact@v4
         with:
           name: Minecraft-Mod-Language-Package-${{ matrix.version }}
           path: |
@@ -175,9 +175,9 @@ jobs:
 
       # 还原artifact（资源包）
       - name: Restore Artifacts
-        uses: actions/download-artifact@v3
+        uses: actions/download-artifact@v4
         with:
           path: artifacts/
 
       - name: Run Uploader
-        run: .\Uploader --host="${{ secrets.SSH_IP }}" --name="${{ secrets.SSH_USER }}" --password="${{ secrets.SSH_PWD }}"
+        run: .\Uploader --host="${{ secrets.SSH_IP }}" --name="${{ secrets.SSH_USER }}" --password="${{ secrets.SSH_PWD }}"

.github/workflows/pr-packer.yml

@@ -50,7 +50,7 @@ jobs:
       matrix:
         # 支持版本列表。将对这里的每个版本判断，按需打包。
         # 如需添加新版本，在这里添加即可。
-        version: ["1.12.2", "1.16", "1.16-fabric", "1.18", "1.18-fabric", "1.19", "1.20", "1.20-fabric"]
+        version: ["1.12.2", "1.16", "1.16-fabric", "1.18", "1.18-fabric", "1.19", "1.20", "1.20-fabric", "1.21", "1.21-fabric"]
     runs-on: windows-latest
     steps:
       - uses: actions/checkout@v2
@@ -106,4 +106,4 @@ jobs:
         with:
           name: Minecraft-Mod-Language-Package-${{ matrix.version }}
           path: Minecraft-Mod-Language-Package-${{ matrix.version }}/*
-        if: steps.check-changes.outputs.changed == 'true' ||  github.event_name == 'workflow_dispatch'
+        if: steps.check-changes.outputs.changed == 'true' ||  github.event_name == 'workflow_dispatch'

.github/workflows/stale.yml

@@ -15,7 +15,7 @@ jobs:
         with:
           days-before-issue-stale: -1
           days-before-issue-close: -1
-          stale-pr-message: "请注意回应审查人的审查意见，若 24 小时内不回应，该 PR 即将被关闭。相关规则见[贡献方针](https://github.com/CFPAOrg/Minecraft-Mod-Language-Package/blob/main/CONTRIBUTING.md#搁置规则)。"
+          stale-pr-message: "请注意回应审阅人的审阅意见，若 24 小时内不回应，该 PR 即将被关闭。相关规则见[贡献方针](https://github.com/CFPAOrg/Minecraft-Mod-Language-Package/blob/main/CONTRIBUTING.md#搁置规则)。"
           close-pr-message: "因你的回应时间超过时限，该 PR 已因搁置而被关闭。如需再次提交可重新打开（Reopen）该 PR，感谢贡献:heart:。相关规则见[贡献方针](https://github.com/CFPAOrg/Minecraft-Mod-Language-Package/blob/main/CONTRIBUTING.md#搁置规则)。"
           days-before-pr-stale: 7
           days-before-pr-close: 1

CONTRIBUTING.md

@@ -17,6 +17,7 @@
       - [审查人](#审查人)
       - [PR 作者](#pr-作者)
     - [搁置规则](#搁置规则)
+    - [公示规则](#公示规则)
     - [提示](#提示)
   - [代码贡献指南](#代码贡献指南)
   - [配置更改指南](#配置更改指南)
@@ -31,23 +32,25 @@ Minecraft-Mod-Language-Package
   ├─config ---------------- // 配置文件
   │ └─packer -------------- // 打包器配置文件
   ├─projects -------------- // 翻译文件
-  │ └─(Minecraft 版本) ---- // 不带 fabric 字样的是用于 Forge 的
+  │ └─(Minecraft 版本) ---- // 不带 fabric 字样的是用于 Forge 和 NeoForge 模组的
   │   └─assets
   │     ├─(CurseForge 项目名称) ---- // 见下
   │     │ └─(命名空间) ------------- // 见下
   │     │   └─lang ----------------- // 语言文件文件夹
   │     │     ├─en_us.json --------- // English (United States) 语言文件
   │     │     └─zh_cn.json --------- // 中文 (简体) 语言文件
+  │     ├─(Modrinth 项目名称)------- // 见下
+  │     │ └─(命名空间) ------------- // 见下
+  │     │   └─lang ----------------- // 语言文件文件夹
+  │     │     ├─en_us.json --------- // English (United States) 语言文件
+  │     │     └─zh_cn.json --------- // 中文 (简体) 语言文件
   │     ├─minecraft
   │     │ └─minecraft -------------- // Minecraft 原版使用的命名空间
   │     │   ├─font
   │     │   │ └─glyph_sizes.bin ---- // 全角标点修复文件
   │     │   └─textures
   │     │     └─font --------------- // 全角标点修复文件
-  │     ├─1UNKNOWN ----------------- // 存放不在 CurseForge 和 Modrinth 上发布的模组
-  │     │   └─(命名空间)
-  │     │     └─lang
-  │     └─0-modrinth-mod ----------- // 存放仅发布在 Modrinth 上的模组
+  │     └─1UNKNOWN ----------------- // 存放不在 CurseForge 和 Modrinth 上发布的模组
   │         └─(命名空间)
   │           └─lang
   └─src --------------- // 各种自动化工具的源码
@@ -62,35 +65,41 @@ Minecraft-Mod-Language-Package
 
 **命名空间（Namespace）**：以匠魂为例，用压缩软件打开模组文件（JAR 格式），它的 en_us.json 的路径为 `assets/tconstruct/lang/en_us.json`，则 `{命名空间}` 为 `assets/` 和 `/lang` 之间的内容，即 `tconstruct`。一个模组可能有多个命名空间。命名空间介绍见 [Minecraft Wiki](https://zh.minecraft.wiki/w/%E5%91%BD%E5%90%8D%E7%A9%BA%E9%97%B4ID?variant=zh-cn#%E5%91%BD%E5%90%8D%E7%A9%BA%E9%97%B4)。
 
+**Modrinth 项目名称**：以 Modrinth 独占模组 Clean F3 为例，它的 Modrinth 页面地址是 `https://modrinth.com/mod/clean-f3`，则在 `mod/` 后的内容 `clean-f3` 为 `{Modrinth 项目名称}` 的**主体**部分，而为了与 Curseforge 上发布的模组作以区分，所有仅在 Modrinth 上发布的模组，在其之前需要添加 `modrinth-` 作为区分。综上，它的 `{Modrinth 项目名称}` 为 `modrinth-clean-f3`。
+
 仓库中“命名空间”文件夹下的目录结构与[资源包](https://zh.minecraft.wiki/w/%E8%B5%84%E6%BA%90%E5%8C%85)的相应结构相同，其他可用资源包加载的本地化文件亦可接收。
 
 projects 文件夹下只标出模组所属的大版本号，其中的模组翻译文件应满足以下优先级：
 
-1. 模组活跃更新的 Minecraft 版本优先。若所有小版本都活跃更新，则
-2. Minecraft 版本高者优先。
+1. 模组活跃更新的 Minecraft 版本优先。
+2. 若所有小版本都活跃更新，则 Minecraft 版本高者优先。
+
 
 * 例：Minecraft 版本 1.19.2 与 1.19.4 均属同一大版本号 1.19 下的子版本。  
 若某一模组在两个版本上的开发均活跃，由于 1.19.4 的版本号更高，因此优先考虑该模组在 1.19.4 下的译名标准化情况与适配情况。  
 这一优先级不会影响到模组在其他大版本下（如 1.18、1.12 等）的分支。
 
 ## 翻译用语共识
 
-1. “材料+质/制+中心词”的翻译，如“铁质涡轮”“铁制涡轮”，二者皆合理。只需单模组内统一。
-2. 关于“木制品名称”的翻译，可参考 <https://github.com/CFPAOrg/Minecraft-Mod-Language-Package/pull/2715#discussion_r1056901664> 中的解决方法。
+1. “材料 + 质/制 + 中心词”的翻译，如“铁质涡轮”或“铁制涡轮”，二者皆合理。只需单模组内统一。
+2. 关于“木制品名称”的翻译，可参考 [#4525](https://github.com/CFPAOrg/Minecraft-Mod-Language-Package/issues/4525) 的解决方法。
+
 
 ## 翻译贡献方针
 
-以下内容只针对对 [projects](./projects) 文件夹下的贡献。
+以下内容只针对 [projects](./projects) 文件夹下的贡献。
 
 ### 总则
 
 - 翻译**必须**符合 [Minecraft 模组简体中文翻译规范与指南](https://cfpa.site/TransRules/)的规定。
-- **拒绝**接收机器翻译（含生成式AI）、生硬翻译。
-- 翻译**必须**在审查后才能进入仓库。
+- **拒绝**接收机器翻译（含生成式 AI）、生硬翻译。
+  - 若直接提交此类翻译，该 PR 将被打上“生硬翻译”标签。
+  - 若作者不及时进行有效修改，PR 可能会依照本仓库的[搁置规则](#搁置规则)处理。
+- 翻译**必须**在审校后才能进入仓库。
 
 ### Pull Request 相关规定
 
-可查看[视频教程](https://www.bilibili.com/video/BV1Ph4y1R7M8/)（已过时）或[文字教程](https://github.com/CFPAOrg/Minecraft-Mod-Language-Package/wiki/%E4%BD%BF%E7%94%A8-GitHub-%E6%8F%90%E4%BA%A4%E7%BF%BB%E8%AF%91)来学习。注意，视频或文字教程都只介绍了 Pull Request 的使用方法，贡献方针仍需阅读。
+可查看[视频教程](https://www.bilibili.com/video/BV1yqgge9EVK/)或[文字教程](https://github.com/CFPAOrg/Minecraft-Mod-Language-Package/wiki/%E4%BD%BF%E7%94%A8-GitHub-%E6%8F%90%E4%BA%A4%E7%BF%BB%E8%AF%91)来学习。注意，视频或文字教程都只介绍了 Pull Request 的使用方法，贡献方针仍需阅读。同时，我们默认翻译贡献者已拥有一定的 Github 基础知识。
 
 视频或文字教程中与翻译贡献方针不同的地方，以本方针为准。
 
@@ -134,9 +143,9 @@ projects 文件夹下只标出模组所属的大版本号，其中的模组翻
 #### 审查人
 
 - 任何人都能利用 GitHub 提供的[相关功能](https://docs.github.com/zh/pull-requests/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/commenting-on-a-pull-request)来审查 PR 中翻译。所有参与审查的用户即为审查人。
-- [CFPA团队](https://github.com/CFPAOrg)的成员（Member）和[仓库](https://github.com/CFPAOrg/Minecraft-Mod-Language-Package)的协作者（Collaborator）是具有团队官方性质的审查人。
+- [CFPA团队](https://github.com/CFPAOrg) 的成员（Member）和[仓库](https://github.com/CFPAOrg/Minecraft-Mod-Language-Package)的协作者（Collaborator）是具有团队官方性质的审查人。
 - 至少一位具有官方身份的审查人对 PR 给出批准（Approval）审查后，PR 才能合并。
-- 审查人在给出批准审查后**应**给 PR 加上“即将合并”标签，此后需等待大于 24 小时，若等待期间没有新动态则可以合并 PR。
+- 审查人在给出批准审查后**应**给 PR 加上“即将合并”标签，此后需至少等待 24 小时，若等待期间没有新动态则可以合并 PR。
   - “动态”包括但不限于 PR 作者发送提交（Commit）、审查人提出意见。
 
 #### PR 作者
@@ -149,21 +158,30 @@ projects 文件夹下只标出模组所属的大版本号，其中的模组翻
 
 ### 搁置规则
 
-搁置规则的目的是解决由于 PR 作者迟迟不出面响应审查要求而导致的 PR 积压问题。
+搁置规则用于解决由于 PR 作者迟迟不出面响应审查要求而导致的 PR 积压问题。
 
 1. 若 PR 中存在未作者未响应的审查超过 7 天，审查人有权提及（@）PR 作者，提醒其相应审查意见，然后加上“即将被搁置”标签。
 2. 若“即将被搁置”标签存在超过 7 天，PR 作者将被视为无法回应。此时
-   2.1 若存在要求 PR 作者参与的审查意见，PR 将被加上“即将拒收”标签。1 天后 PR 将被关闭。
-   2.2 若审查意见都无需 PR 作者参与，PR 将被加上“即将拒收”标签。1 天缓冲期内官方审查人**可以**直接采纳审查意见，并终止计时，转入合并流程。
+   - 2.1 若存在要求 PR 作者参与的审查意见，PR 将被加上“即将拒收”标签。1 天后 PR 将被关闭。
+   - 2.2 若审查意见都无需 PR 作者参与，PR 将被加上“即将拒收”标签。1 天缓冲期内官方审查人**可以**直接采纳审查意见，并终止计时，转入合并流程。
 3. 在 1、2 所述过程中，若 PR 作者做出了回应，标签将被清除，计时重新从 1 开始。
 
 因搁置而关闭的 PR，PR 作者若想继续更新，可重新打开（Reopen）PR。
 
+### 公示规则
+
+公示规则是为了传播 PR 中某个（些）模组译名或词条的重大更改而设立的，包括但不限于：远古译名的更改，错误译名的更正。
+
+1. 该规则适用于与官方翻译或社区流传度较广的翻译存在**重大差异**，且存在译名或词条更改的 PR。
+2. 纯文档或代码贡献 PR **不应**进入公示流程（存在停止支持或重新支持某模组翻译的除外）（例：[#4327](https://github.com/CFPAOrg/Minecraft-Mod-Language-Package/pull/4327)，[#4215](https://github.com/CFPAOrg/Minecraft-Mod-Language-Package/pull/4215)）
+3. 若 PR 在**审查通过后**符合上述规则，则视为该 PR 进入公示流程，同时加上“需要公示”标签，并择日通过如 Bilibili、QQ 群、MC 百科社群等平台发布公示，至发布之日 14 天止视为公示流程结束。此时清除标签并加上“即将合并”标签，转入合并流程。
+   - 公示时，应当附带：PR 链接、原文、更改内容、更改缘由等，选择性附带图片。
+
 ### 提示
 
-- 如果上传的文件中包含**非文本文件**（如`.ttf`，`.jpg`等），**有可能需要修改 [Packer 配置](config/packer.json)**，否则它们会被打包器排除，不会进入用户使用的资源包。
-  - 如果这些文件放置在`font`或`textures`中，一般不用修改配置；默认已经对这两处进行了特殊处理。
-- 不同版本的同一模组可通过[自定义文件检索策略](./Packer-Index-Doc.md)同步翻译。
+- 如果文件路径不包含语言标记 `zh_cn`，一般需要**修改全局或局域的 Packer 配置**，否则它们会被打包器排除，不会进入用户使用的资源包。具体操作参见[文档](Packer-Doc.md#添加无语言标识的文件)。
+  - 如果这些文件放置在 `font` 或 `textures` 中，无需修改配置；默认已经对这两处进行了特殊处理。
+- 不同版本的同一模组可通过[自定义文件检索策略](./Packer-Doc.md#检索策略)同步翻译。
 
 ## 代码贡献指南
 
@@ -196,7 +214,7 @@ projects 文件夹下只标出模组所属的大版本号，其中的模组翻
 
 ### Packer
 
-路径：`./config/packer/[version].json`（如1.12的文件在[1.12.2.json](./config/packer/1.12.2.json)）
+路径：`./config/packer/[version].json`（如 1.12 的文件在 [1.12.2.json](./config/packer/1.12.2.json)）
 
 该文件内放置了**所有**正在维护的版本的打包配置。
 不要随意*删去*内容，除非你知道它为什么弃用。
@@ -207,18 +225,15 @@ projects 文件夹下只标出模组所属的大版本号，其中的模组翻
 主要的更改场景：
 
 - 增加新翻译版本
-  - 需要将所有项填写一遍，同时需要更新`.github/workflows/packer.yml`、`.github/workflows/pr-packer.yml`、`.github\boring-cyborg.yml`，以及 [CFPABot](https://github.com/Cyl18/CFPABot) 等相关服务。没有规划最好不要乱动。
+  - 需要将所有项填写一遍，同时需要更新 `.github/workflows/packer.yml`、`.github/workflows/pr-packer.yml`、`.github\boring-cyborg.yml`，以及 [CFPABot](https://github.com/Cyl18/CFPABot) 等相关服务。没有规划最好不要乱动。
 - 更改字符替换表
-  - 修改`replacementMap`，格式与已有文本一致。Unicode*基础多语种平面（BMP）*以外的字符需要使用**UTF-16代理对**输入，否则可能无法识别。
+  - 修改`characterReplacement`，格式与已有文本一致。对于**基础多语种平面（BMP）**以外的字符，最好用 **UTF-16 代理对**书写。
   - 同时可能需要修改字体文件。
 - 处理非文本文件
-  1. 如果该文件所在的文件夹与`lang`文件夹同级，且对**任何模组都**不会有文本文件（如font\），将该文件夹加入对应版本的`noProcessNamespace`中。
-  2. 否则，将该模组的`CurseForge 项目名称`或`命名空间`中的一个（具体选哪一个看具体情况）加入`modNameBlackList`或`domainBlackList`，并将**所有**受影响的文件的相对位置加入`additionalContents`。
-- 添加非标准位置（在`assets/`以外）的文件 
-  - 直接加入`additionalContents`
+  - 参考 [Packer-Doc](Packer-Doc.md) 对其的描述。
 - 停止对某模组的支持
-  - 把该模组的`CurseForge 项目名称`或`命名空间`中的加入相应的`modNameBlackList`或`domainBlackList`（二者取其一）。
+  - 把该模组的 `CurseForge 项目名称`或`命名空间`中的加入相应的 `exclusionMods` 或 `exclusionDomains`（二者取其一）。
 
 ## 联系我们
 
-若有不明白的地方，可[前往 QQ 群](https://jq.qq.com/?_wv=1027&k=5geO1T21)（630943368，**较为活跃**）或 [Discord](https://discord.com/invite/SGve5Fn) 提问。
+若有不明白的地方，可[前往 QQ 群](https://jq.qq.com/?_wv=1027&k=5geO1T21)（630943368）。