Update zh translations by Ace06-suzhou

docs/zh/FAQ/Defender-exclusions.md

@@ -0,0 +1,52 @@
+# 如何在Windows Defender防火墙和防病毒软件中创建白名单？
+
+!!! info
+
+```
+在修改防火墙之前，请确保将windows网络设置中的网络设置为专用（假设您在私有网络中）。
+
+!！! 免责声明："
+
+**防火墙/防御器关闭具有风险**。
+
+通过创建排除条款，您了解允许在PC上运行程序并向公众开放家庭网络端口的风险，从而使BeamMP对可能发生在您或您的家庭中的任何和所有损害负责的权利无效。
+
+我们对任何外部链接服务或网站上的任何内容不承担任何责任。
+```
+
+## 为 BeamMP-Launcher 添加 Windows Defender 防火墙例外规则
+
+1. 打开带有高级设置的`Windows Defender防火墙。`
+2. 在窗口中，单击`入站`以打开入站规则选项卡。
+3. 点击 `新建规则` 在右上方创建一个新的规则。
+4. 选择`程序`以创建特定于程序的规则。
+5. 请输入 `BeamMP-Launcher.exe` 的完整限定路径。<br>默认路径为 `%appdata%\BeamMP-Launcher\BeamMP-Launcher.exe`（请勿包含引号）。
+6. 确保允许连接
+7. 给排除项起一个名字(例如：“BeamMP-Launcher”)并保存它。
+8. 重启电脑
+
+## 1.1 为 BeamMP-Launcher 添加 Windows Defender 防火墙例外规则
+
+1. 打开 `Windows Defender高级防火墙设置`.
+2. 在窗口中，点击 `入站` 以打开入站规则选项卡。
+3. 在右上角点击 `新建规则` 以创建一条新的规则。
+4. 选择 `端口` 以创建针对特定程序的规则。
+5. 输入与 ServerConfig.toml 中配置的相同的端口号。
+6. 请输入 `BeamMP-Server.exe` 的完整限定路径。<br>该文件位于你下载后自行放置的位置。
+7. 确保允许连接
+8. 为该排除规则命名（例如 “BeamMP-Server”），然后保存规则。
+9. 重启电脑
+
+## 2. BeamMP-Launcher 与 BeamMP-Server 的 Windows Defender 病毒防护排除设置
+
+1. 打开 `Windows 安全中心` 应用.
+2. 单击第一个项目`病毒和威胁防护`。
+3. 单击“病毒和威胁防护设置”下方的`管理设置`。
+4. 向下滚动以导航到`排除项`选项卡。
+5. 在那里，单击“添加排除项”并选择`进程`。
+6. 在字段中输入 `BeamMP-Launcher.exe` 或 `BeamMP-Server.exe`，然后保存。
+7. 重启电脑。
+
+## 还有问题吗？
+
+在[论坛](https://forum.beammp.com)或我们的[Discord服务器](https://discord.gg/beammp) `#support`频道中打开一个频道。

docs/zh/beamng/dev/modding/lua-mods.md

@@ -0,0 +1,3 @@
+# lua-mods.md
+
+此页面需要创建。

docs/zh/community/rules.md

@@ -0,0 +1,53 @@
+---
+hide:
+  - 导航
+---
+
+# BeamMP 社区规则
+
+！！！BeamMP员工不受这些规则的严格约束，可以自行决定操作。除这些规则外，Discord的[社区指南](https://discord.com/guidelines/)和[服务条款](https://discord.com/terms/)也适用并强制执行。
+
+## BeamMP通用规则（适用于Discord、论坛和游戏内）
+
+1. 禁止歧视（如性别歧视、种族主义等）：material-information-outline:{title=“这包括直接或有意使用种族/性侮辱或其他词汇来针对个人或群体。”}
+2. 禁止欺凌或骚扰：material-information-outline:{title=“这包括使用不必要的行为、未经请求的DM或使用信息、图像或口头交流针对个人。”}
+3. 无NSFW、冒犯性或恶意内容：material-information-outline:{title=“这包括包含恶意链接、裸露、色情、过度亵渎或其他冒犯性、恶意和/或不适合在公共场所出现的内容。”}
+4. 禁止发送垃圾邮件文本/语音渠道或帖子：material-information-outline:{title=“这包括生成多个帖子或线程，发送相同或类似的消息，滥用语音通信渠道或其他行为，包括加入/离开垃圾邮件。”}
+5. 请说英语：material-information-outline:{title=“在可能的情况下，BeamMP内部的所有通信都应使用英语，除非另有指定的特定区域。”}
+6. 禁止不适当的个人资料：material-information-outline:{title=“这包括个人资料名称，照片，bios或其他不符合BeamMP/BeamNG/Discord规则和ToS的用户控制内容。”}
+7. material-information-outline:{title=“禁止发布个人信息（” doxing "）（包括但不限于真实姓名、地址、电子邮件、密码、银行账户和信用卡信息等）。}
+8. material-information-outline:{title=“这包括讨论BeamMP/BeamNG或整个游戏之外的过去或当前世界事件。有一些地方可以对这些话题进行有效的讨论，但BeamMP不是其中之一。”}
+9. 非BeamMP/BeamNG内容：material-information-outline:{title="这包括非BeamMP社区、社交媒体渠道或其他外部链接。这适用于在BeamMP社区内发帖，以及以个人广告为目的主动向用户发送DM。”}
+10. 禁止冒充工作人员：material-information-outline:{title="这包括声称自己是BeamMP的工作人员，或声称拥有与工作人员相关的能力。这也包括模仿工作人员。”}
+11. 禁止利用：material-information-outline:{title=“这包括利用任何漏洞或疏忽来谋取个人利益或对他人的体验产生负面影响。”}
+12. 禁止分享 Authkey，禁止用小号刷免费密钥数量，违者永久封禁。
+13. 遵循所有给定的TOS:material-information-outline:{title=“这很重要，因为使用我们的Discord服务器也必须遵循诸如Discord年龄限制（13+）之类的限制。”}
+14. 尊重每个人：material-information-outline:{title=“有些话不该说出口，你需要尊重你周围的每个人，并相应地行动。”}
+15. 关注类别或频道的主题。：material-information-outline:{title="这应该不说出来，但要保持你的内容在你发布的区域的主题上。例如，支持应该帮助人们或在寻求支持时使用。”}
+16. 不要使用过多的大写锁定或表情符号：material-information-outline:{title=“用户应该避免使用过多的大写符号或表情符号/表情符号，以免混淆手头的重点。”}
+17. 在支持区域发布之前，请检查[BeamMP FAQ](../../support/player-faq.md) & [BeamMP社区FAQ](https://forum.beammp.com/c/faq/35)。
+
+## Discord 规则
+
+1. 以上规则适用于这里：material-information-outline:{title=“本文档中提到的所有规则适用于语音聊天。”}
+2. 遵循Discord的使用条款和指南：material-information-outline:{title=“遵循Discord在其使用条款和指南中列出的所有规则”}
+3. 禁止NSFW音频/流：material-information-outline:{title=“玩家不应该流任何违反BeamMP规则和Discord TOS的内容。”}
+4. 上述规则包括赌博服务/网站。
+5. material-information-outline:{title=“禁止过度使用响板、大声播放音乐或使用其他音频通道故意煽动或针对他人。”}
+6. 禁止加入/离开滥用：material-information-outline:{title=“大多数用户可能启用声音效果，不要快速加入和离开语音聊天。”}
+7. 不要纠缠他人（`@'ing`）：material-information-outline:{title=“这包括在被忽视或拒绝后反复要求他人回应。”}
+8. 将bot命令保存在特定于命令的通道中。
+9. 禁止角色扮演：material-information-outline:{title=“这是为了防止由于缺少上下文或防止用户规避某些规则而引起的问题。”}
+10. 请勿要求用户通过私信（DM）向你寻求帮助。所有与支持相关的话题均应在 BeamMP Discord 服务器的指定支持频道中进行讨论。
+11. 严禁发送任何可疑的、潜在恶意或具有破坏性的文件及附件（包括但不限于可疑扩展名）。
+12. 不要教/发链接教别人怎么盗版、破解软件、骇入账号、破解付费mod。
+13. 不要发布非BeamNG /BeamMP内容。只允许在专用的[媒体通道](https://discord.com/channels/601558901657305098/705427325646274680)中发送您自己通道的媒体。
+14. 听从工作人员的指示。如果你认为某位员工滥用职权，直接通知他们的领导或项目管理人员。
+
+## 如何对您被实施的封禁进行申诉：
+
+### 封禁上诉可在<a href="https://docs.google.com/forms/d/1MaTPKM-MHQU5lUtxeOKz3C7OoI6Xbu5RX5AJdX-UOz4" class="inline-onebox">封禁上诉- BeamMP</a>提交。
+
+所有禁令申诉都经过彻底调查，涉及至少两(2)名与本案无关的工作人员/审核小组成员。发出申诉的工作人员将被允许发表评论，但不会以其他方式参与申诉决定。这些上诉结果是最终的。BeamMP保留根据BeamMP社区规则（如上所述）、[Discord ToS](https://discord.com/terms)和其他因素允许或不允许成员的权利。
+
+!！! 如果对您采取行动，您将被禁止创建新的Discord或BeamMP帐户来规避禁令。

docs/zh/game/getting-started.md

@@ -1,39 +1,147 @@
 # 入门
 
----
-
-## **开始之前**
+## **1. 兼容性**
 
-BeamMP仅与Steam正版的游戏版本兼容。不支持”盗版“版本。
+BeamMP与Windows和Linux完全兼容，与MacOS的兼容性正在研究中。然而，Linux和MacOS都是次要平台，这意味着bug在所难免。
 
----
+!!!警告
 
-## **安装**
+```
+BeamMP将无法与盗版或过时版本的BeamNG.drive一起工作。
+BeamMP支持团队不提供盗版/过期副本问题的支持。
+```
 
-BeamMP目前仅与Windows系统原生兼容。
+## **2. 安装**
 
-### **Windows安装**
+### **2a. Windows 安装**
 
 1. 访问[beammp.com](https://beammp.com/)并点击“Download Client”按钮。
 2. 解压`BeamMP_Installer.zip`。
 3. 运行`BeamMP_Installer.exe`并按照说明进行操作。
 4. BeamMP启动器图标应将出现在您的桌​​面上。如果没有，只需在Windows搜索栏中搜索“BeamMP”即可。
 5. 启动器运行后，您应该会看到一个终端窗口，随即 BeamNG.drive将自动运行。**请勿**关闭终端窗口。
-6. BeamNG启动后，在主菜单中点击`联机模式`即可开始多人游戏。
-7. 系统将提示您登录或以访客身份游玩（并非所有服务器都允许访客）。您可以在我们的[论坛](https://forum.beammp.com)上创建一个帐户，然后使用相同的凭据登录BeamMP。
-8. 选择您感兴趣的任何服务器，然后点击`连接` 。尽情享受吧！
+6. BeamNG启动后，在主菜单中点击`Repository`按钮，确保`multiplayerbeammp`是**唯一启用**的mod。
+7. 返回主菜单，点击“More..”和“多人模式”按钮开始多人模式。
+8. 系统将提示您登录或以访客身份游玩（并非所有服务器都允许访客）。您可以在我们的[论坛](https://forum.beammp.com)上创建一个帐户，然后使用相同的凭据登录BeamMP。
+9. 选择您感兴趣的任何服务器，然后点击`连接` 。尽情享受吧！
+
+!!!注意
+
+```
+当你加载到一个有多个车辆的地图时，它可能需要比预期更长的时间才能加入。
+```
+
+### **2b. Linux 安装**
+
+目前您需要自己编译Launcher。为了做到这一点，您需要对如何编译应用程序有一个基本的了解。
+
+确保你已经安装了基本的开发工具，通常可以在包中找到，例如：
+
+- Debian/Ubuntu: `sudo apt install build-essential`
+- Fedora: `sudo dnf install cmake gcc gcc-c++ make perl perl-IPC-Cmd perl-FindBin perl-File-Compare perl-File-Copy kernel-headers kernel-devel`
+- Arch: `sudo pacman -S base-devel`
+- openSUSE: `zypper in -t pattern devel-basis`
+- SteamOS (Arch): `sudo pacman -S base-devel linux-api-headers glibc libconfig` (You also need to do `sudo steamos-readonly disable` but make sure to enable it again after installing the packages)
+
+克隆 `vcpkg` 仓库，执行引导脚本并加入系统路径
+
+1.
+
+```bash
+git clone https://github.com/microsoft/vcpkg.git
+```
+
+1.
+
+```bash
+./vcpkg/bootstrap-vcpkg.sh
+```
+
+1.
+
+```bash
+export VCPKG_ROOT="$(pwd)/vcpkg"
+export PATH=$VCPKG_ROOT:$PATH
+```
+
+使用`git`将BeamMP-Launcher仓库克隆至本地，操作示例如下：`git clone https://github.com/BeamMP/BeamMP-Launcher.git`。[查看GitHub仓库克隆操作完整指南](https://docs.github.com/en/repositories/creating-and-managing-repositories/cloning-a-repository)
+
+检出[最新发布版本](https://github.com/BeamMP/BeamMP-Launcher/releases/latest)所使用的标签。例如，若最新版本使用`v2.6.4`，则执行`git checkout v2.6.4`
+
+如果你使用了我们提供的示例克隆命令，你可以使用以下命令进入项目的根目录：  <br>`cd BeamMP-Launcher`
+
+在项目的根目录中，
+
+1.
+
+```cmake
+cmake . -B bin -DCMAKE_TOOLCHAIN_FILE=$VCPKG_ROOT/scripts/buildsystems/vcpkg.cmake -DVCPKG_TARGET_TRIPLET=x64-linux
+```
+
+1.
+
+```cmake
+cmake --build bin --parallel
+```
+
+!!!注意 ""
+
+```
+如果在编译时内存耗尽，可以提交——parallel指令，由于只在一个CPU线程上编译，它将使用更少的RAM。
+```
+
+!!!注意 ""
+
+```
+通过不指定‘ -DCMAKE_BUILD_TYPE=Release ’，您正在编译一个调试版本，该版本的文件大小较大，但不包含launcher-can-only-connect-to- server-once错误
+```
+
+!!!注意 "Fedora 用户" 如果 vcpkg 在编译 OpenSSL 时因内核头文件（kernel headers）错误而失败，请确保已安装所有依赖项: `bash sudo dnf install kernel-headers kernel-devel gcc gcc-c++ make perl ` 然后清理 vcpkg 缓存：`bash rm -rf $VCPKG_ROOT/buildtrees/openssl `最后重新运行 cmake 配置命令。
+
+将已编译完成的应用程序从`/bin`移出，放到它自己的文件夹中，然后从该文件夹运行它：
+
+```bash
+mkdir -p ~/beammp-launcher
+cp bin/BeamMP-Launcher ~/beammp-launcher/
+cd ~/beammp-launcher
+./BeamMP-Launcher
+```
+
+原生的 Linux 版 BeamMP 启动器将会启动，并使用原生的 Linux 版 BeamNG.drive。
+
+### **2c. 在Proton兼容层上游玩BeamNG.drive**
+
+若您需要在Proton环境运行BeamNG.drive时同步使用原生Linux版BeamMP启动器，可通过以下方案实现：
+
+使用`--no-launch`参数运行BeamMP-Launcher（此参数将阻止启动器唤起原生Linux版BeamNG.drive）。更多启动器参数详解请参阅[开发环境配置指南](../guides/beammp-dev/beammp-dev.md)
+
+将Proton-BeamNG.drive的用户文件夹路径指向Linux-BeamNG.drive的位置（因原生Linux版BeamMP-Launcher当前仅支持向Linux-BeamNG.drive用户文件夹写入数据）
+
+例如，您可以通过创建符号链接实现该配置
+
+- 记录Linux-BeamNG.drive用户文件夹路径（通常位于`~/.local/share/BeamNG.drive`），并将其重命名为类似`BeamNG.drive_old`的名称
+- 记录Proton-BeamNG.drive用户文件夹路径（通常位于`~/.local/share/Steam/steamapps/compatdata/284160/pfx/drive_c/users/steamuser/AppData/Local/BeamNG.drive`）
+- 建立双端用户文件夹的符号链接桥接 `ln -s ~/.local/share/Steam/steamapps/compatdata/284160/pfx/drive_c/users/steamuser/AppData/Local/BeamNG.drive ~/.local/share`
+
+当用户文件夹间符号链接就绪且启动器完成编译后，可通过调整Steam启动参数实现：既让Steam通过Proton运行游戏，又能自动触发启动器执行。请前往Steam库中该游戏的属性设置界面，替换原版游戏启动参数为下方配置模板：
+
+- `~/BeamMP/BeamMP-Launcher --no-launch & %command% ; killall BeamMP-Launcher`
 
-注意：*当您加载到已有多辆载具的地图时，加入可能需要比预期更长的时间。*
+请注意：此配置默认假设您已将编译完成的启动器二进制文件存放于`/home/user/BeamMP/`。请根据实际二进制文件存放路径调整配置，且每次启动器版本更新时需切换至官方Git仓库对应分支重新执行编译流程。
 
-### **Linux安装**
+!!! 提示 "安装表情符号字体实现文本内嵌表情"
 
-请参考[英语文档](https://docs.beammp.com/game/getting-started/#2b-linux-installation)
+```
+若需在服务器列表（作为服务器自定义名称组成部分）或游戏内聊天中显示表情符号，您需部署包含表情符号的字形库。例如，可通过安装Windows Segoe UI 表情符号字体的 Linux 移植版实现。
+```
 
 ---
 
-## **已知问题**
+## **3. 已知的问题**
 
-- 如果您未看到”联机模式“按钮。确保BeamMP模组已在“模组管理器”中激活，然后尝试按下CTRL+L。
-- 另外，请确保BeamMP是“模组管理器”中**唯一**激活的模组，否则可能会导致问题。
+- 当前原生Linux版BeamMP启动器存在单会话限制：成功连接服务器并断开后需重启启动器。可通过热重载方案实现不关闭游戏进程的快速重启
+- 若未显示多人游戏按钮，请确认以下操作：<br>检查BeamMP模组是否已安装并在模组管理器中启用<br>尝试执行热重载快捷键 Ctrl + L
+- 任何类型的vpn都可能导致连接问题。
+- 如果启动器报告任何错误，请阅读[FAQ](https://forum.beammp.com/c/faq/35)。
 
-如果您需要更多安装帮助，欢迎您在我们的[论坛](https://forum.beammp.com)上发帖或在我们的[Discord服务器](https://discord.gg/beammp)上提问（仅英文）。
+如果启动器报告任何错误，请阅读[FAQ](https://forum.beammp.com)。