From 6afab23be10ef37f16da0db50fec473beffede6f Mon Sep 17 00:00:00 2001
From: Ace06_10010 <tanxuan1144@163.com>
Date: Mon, 20 Oct 2025 05:47:41 +0000
Subject: [PATCH 01/18] Translate vehicles.md via GitLocalize

---
 docs/zh/beamng/dev/content/vehicles.md | 21 +++++++++++++++++++++
 1 file changed, 21 insertions(+)
 create mode 100644 docs/zh/beamng/dev/content/vehicles.md

diff --git a/docs/zh/beamng/dev/content/vehicles.md b/docs/zh/beamng/dev/content/vehicles.md
new file mode 100644
index 000000000..b86ed3136
--- /dev/null
+++ b/docs/zh/beamng/dev/content/vehicles.md
@@ -0,0 +1,21 @@
+!!!警告“此网站正在建设中!”
+
+```
+这个网站正在积极建设中。
+
+觉得你能帮忙吗？请用右边的铅笔点击页面！
+
+这也可以在任何页面上完成。
+```
+
+# 车祸模拟器 创建车辆
+
+。。。
+
+## 介绍
+
+。。。
+
+## 开始进行
+
+。。。

From aa3062f2bf0181e42c5e7d65a283ef5d192c2192 Mon Sep 17 00:00:00 2001
From: Ace06_10010 <tanxuan1144@163.com>
Date: Mon, 20 Oct 2025 05:47:43 +0000
Subject: [PATCH 02/18] Translate ui-apps.md via GitLocalize

---
 docs/zh/beamng/dev/modding/ui-apps.md | 273 ++++++++++++++++++++++++++
 1 file changed, 273 insertions(+)
 create mode 100644 docs/zh/beamng/dev/modding/ui-apps.md

diff --git a/docs/zh/beamng/dev/modding/ui-apps.md b/docs/zh/beamng/dev/modding/ui-apps.md
new file mode 100644
index 000000000..d620d2743
--- /dev/null
+++ b/docs/zh/beamng/dev/modding/ui-apps.md
@@ -0,0 +1,273 @@
+# 图形界面-应用程序 创建
+
+为了制作一个图形界面应用程序，你需要一些AngularJS框架的知识，主要的文档可以在这里找到: [AngularJS docs](https://docs.angularjs.org/guide)
+
+## 文件结构
+
+一个图形界面应用程序需要四个重要的文件才能工作：
+
+- app.js | 包含图形界面应用程序使用的主要代码 [Javascript docs](https://developer.mozilla.org/en-US/docs/Web/JavaScript)
+- app.html | 显示应用程序的代码 [Html docs](https://developer.mozilla.org/fr/docs/Web/HTML)
+- app.json | 包含图形界面应用程序的信息
+- app.png | 显示在应用程序选择器中的图像文件
+
+### 图形界面应用程序 样式
+
+我们建议使用 `<style>` 标签来设置应用的样式, a .css 文件会工作，但您将无法实时看到更改。
+
+## 范例
+
+这个例子来自DanielW，感谢他
+
+ui\modules\apps\ExampleApp\app.html
+
+```html
+<div style="width: 100%; height: 100%;" class="bngApp">
+    <link type="text/css" rel="stylesheet" href="/ui/modules/apps/ExampleApp/app.css" />
+
+    <div id="exampleAppContainer">
+        <span>Gear: <span>{{ gearName }}</span></span>
+
+        <div layout="row" layout-align="center center">
+            <md-input-container flex>
+                <label>Input</label>
+                <input ng-model="message" ng-keydown="sendMessage($event)">
+            </md-input-container>
+
+            <md-button md-no-ink class="md-warn" ng-disabled="!message" ng-click="sendMessage()">Send</md-button>
+        </div>
+
+        <span style="display: block">Messages:</span>
+
+        <!-- Scroll Area -->
+        <ul bng-nav-scroll style="margin: 0; padding: 0; overflow-y: auto; width: 100%; height: 100%; background-color: #37373740;">
+
+            <!-- Iterate over the messages and display them -->
+            <li ng-repeat="message in messages track by $index" style="display: flex; align-items: center; height: 35px;">
+                <span style="padding: 0 0.2em; width: 100%;">{{ message }}</span>
+        
+                <!-- Button to delete the message, this calls the `deleteMessage` function in `app.js` -->
+                <md-button md-no-ink class="md-icon-button md-warn" ng-click="deleteMessage($index)">
+                    <md-icon class="material-icons">delete</md-icon>
+                </md-button>
+            </li>
+        </ul>
+    </div>
+</div>
+```
+
+在这里, 你可以看到一个 `<span>` 显示车辆挡位的标签, 用于将消息发送给 `sendMessage()`函数和一个重复的`<li>`标签（在Javascript中的`messages`变量上使用<b>ng-repeat</b>）
+
+ui\modules\apps\ExampleApp\app.js
+
+```js
+angular.module('beamng.apps')
+.directive('exampleApp', [function() {
+    return {
+        templateUrl: '/ui/modules/apps/ExampleApp/app.html',
+        replace: true,
+        restrict: 'EA',
+        scope: true,
+
+        controller: ['$scope', function($scope) {
+            $scope.gearName = '0'
+            $scope.message  = ''
+            $scope.messages = []
+
+            // Setup the streams we want. For now, we only want the engine information. You can add more, you'll just have to look around to find the different streams
+            let steamList = ['engineInfo']
+            StreamsManager.add(steamList)
+
+            $scope.$on('destroy', function() {
+                StreamsManager.remove(steamList)
+            })
+
+            // Do I even need to put this comment here explaining what this function does?
+            // Well, I have done it for a lot of other things when they weren't needed. I'll leave this one be...
+            $scope.$on('streamsUpdate', function(event, streams) {
+                if (!streams.engineInfo) // Early return... You probably noticed that without this useless comment though
+                    return;
+
+                // `lua/vehicle/controller/vehicleController.lua:538` (or use console.log)
+                let gear = streams.engineInfo[5]
+
+                // Update the gear name in HTML if needed
+                if ($scope.gearName !== gear)
+                    $scope.gearName = gear
+            })
+
+            $scope.sendMessage = function(event) {
+                if (event && event.key !== 'Enter')
+                    return
+
+                if ($scope.message == '')
+                    return
+
+                // Forward the message to the Lua extension to modify it
+                bngApi.engineLua('extensions.exampleMod.modifyMessage("' + $scope.message + '")')
+                $scope.message = ''
+            }
+
+            $scope.deleteMessage = function(idx) {
+                $scope.messages.splice(idx, 1)
+            }
+
+            // The `modifyMessage` function will call this hook with the modified data
+            $scope.$on('MessageReady', function(_, modifiedMessage) {
+                $scope.messages.push(modifiedMessage)
+            });
+        }]
+    }
+}])
+```
+
+注意<b>$scope{/b0}的用法。这是非常重要的，因为你需要在{b1}$作用域</b>中定义变量和函数，以便能够从<b>ng-*</b>标签中的<b>Html</b>中访问它。所以在这个例子中，在<b>Html</b>中执行`sendMessage()`函数后，它将把它发送到mod的extensions目录中的lua文件中，并在这个lua文件中执行`modifyMessage()`函数。
+
+下面是lua的一个例子：
+
+```lua
+local function modifyMessage(message)
+    message = message .. " [Modified!]"
+    guihooks.trigger('MessageReady', message)
+end
+```
+
+^这是lua的一个简化版本，只是为了展示函数
+
+这里主要关注的是<b>基钩子的使用。触发器</b>触发一个用`$scope.$on()`定义的AngularJS事件。正如您在Javascript文件的最底部看到的那样，该事件被命名为MessageReady，并将由<b>guihook执行。用消息有效负载触发</b>函数，然后将被推入`$范围。在<b data-md-type="raw_html">Html</b>文件中使用<b data-md-type="raw_html">ng-repeat</b>来显示li标签中的messages`变量
+
+完整的lua文件就在下面
+
+lua\ge\extensions\exampleMod.lua
+
+```lua
+local M = {}
+
+--[[
+    This is the entry point of our extension, this is what the game loads from our `modScript.lua`.
+    In the modScript file, you can load more extensions and put them in the same directory as this file.
+
+    In this file, we will communicate with the following:
+      1. Our vehicle extension. That extension tells this extension when to send it data, and we send it. Take a look at `vehicle/extensions/auto/exampleVehicleExtension.lua`
+      2. Input. Take a look at `core/input/actions/myActions.json`. When the bounded key is pressed, it will call `onActionKeyDown` (a function we export below)
+]]
+
+-- Game Function Hooks
+--------------------------------------------
+local function onExtensionLoaded()
+    log('D', "onExtensionLoaded", "Called")
+end
+
+local function onExtensionUnloaded()
+    log('D', "onExtensionUnloaded", "Called")
+end
+
+-- Custom Functions
+--------------------------------------------
+local function onActionKeyDown()
+    log('D', "onActionKeyDown", "Pressed!")
+end
+
+local function onVehicleExtensionLoaded(vehID)
+    log('D', "onVehicleExtensionLoaded", "Sending some data to the vehicle")
+
+    local veh = be:getObjectByID(vehID) -- If you don't have the ID, you can also use `be:getPlayerVehicle(0)` to get the current vehicle.
+    if not veh then return end -- The usual error checking
+
+    local data = {
+        ["name"] = "Daniel W"
+    }
+
+    veh:queueLuaCommand("extensions.exampleVehicleExtension.onDataReceived('" .. jsonEncode(data) .. "')")
+end
+
+local function modifyMessage(message)
+    message = message .. " [Modified!]"
+    guihooks.trigger('MessageReady', message)
+end
+
+-- Export Interface
+--------------------------------------------
+M.onExtensionLoaded        = onExtensionLoaded
+M.onExtensionUnloaded      = onExtensionUnloaded
+
+M.onActionKeyDown          = onActionKeyDown
+M.onVehicleExtensionLoaded = onVehicleExtensionLoaded
+M.modifyMessage            = modifyMessage
+
+--[[ Other functions could include:
+      - onPreRender(dtReal, dtSim, dtRaw)
+      - onUpdate(dtReal, dtSim, dtRaw)
+      - onClientPreStartMission(levelPath)
+      - onClientPostStartMission(levelPath)
+
+    To find all of these, search the following in `BeamNG.Drive/lua`: `extensions.hook(`
+--]]
+
+return M
+```
+
+请注意，返回包含所需函数的M（模块）变量非常重要！例如，如果没有`M。modifyMessage = modifyMessage`行，`bngApi.engineLua(‘extensions.exampleMod. ’modifyMessage（' + $scope. '）message + ' ') ')`函数将无法找到modifyMessage（）函数
+
+ui\modules\apps\ExampleApp\app.css
+
+```css
+#exampleAppContainer {
+    width: 100%;
+    height: 100%;
+
+    display: flex;
+    flex-direction: column;
+    align-items: center;
+    align-content: center;
+}
+
+#exampleAppContainer > * {
+    margin: 0;
+    padding: 0;
+}
+```
+
+ui\modules\apps\ExampleApp\app.json
+
+```json
+{
+  "domElement": "<example-app></example-app>",
+  "name": "Example App",
+  "types": [
+    "ui.apps.categories.debug"
+  ],
+  "description": "example-app",
+  "css": {
+    "left": "0px",
+    "height": "auto",
+    "width": "270px",
+    "min-width": "200px",
+    "min-height": "90px",
+    "top": "0px"
+  },
+  "author": "Daniel W",
+  "version": "0.1",
+  "directive": "exampleApp"
+}
+```
+
+该指令需要与<b>Javascript</b>文件中的指令相同
+
+# 车祸模拟器为图形界面应用程序提供的Javascript函数
+
+```js
+bngApi.engineLua("lua_path.function()")
+```
+
+用于运行带或不带参数的lua函数
+
+# 车祸模拟器为图形界面应用程序提供的Lua函数
+
+```lua
+guihooks.trigger("EventName", Payload)
+```
+
+有效载荷可以是任何类型，但最好将其保留为数组/对象或字符串，以免丢失。
+
+<b>IMPORTANT</b>：有时候，你使用的事件名称可能已经在内部被其他东西使用了，从而导致问题，因此，如果你的应用名为Nickel，那么最好将你的每个Angular事件命名为NKEventName，而不是EventName

From 14e2a7eed467864c8b729285f7d8de24084636f1 Mon Sep 17 00:00:00 2001
From: Ace06_10010 <tanxuan1144@163.com>
Date: Mon, 20 Oct 2025 05:47:47 +0000
Subject: [PATCH 03/18] Translate index.md via GitLocalize

---
 docs/zh/beamng/index.md | 11 +++++++++++
 1 file changed, 11 insertions(+)
 create mode 100644 docs/zh/beamng/index.md

diff --git a/docs/zh/beamng/index.md b/docs/zh/beamng/index.md
new file mode 100644
index 000000000..eaf724461
--- /dev/null
+++ b/docs/zh/beamng/index.md
@@ -0,0 +1,11 @@
+# 欢迎来到 车祸模拟器 文档
+
+本文档是非官方的，由车祸模拟器模组团队和车祸模拟器社区制作。
+
+## 了解文件结构
+
+...
+
+## 片段
+
+可以在这里找到有用的代码片段：[代码片段](snippets.md)

From 0cd6afa4886eef63757562bd20ebcc8203b319b3 Mon Sep 17 00:00:00 2001
From: Ace06_10010 <tanxuan1144@163.com>
Date: Mon, 20 Oct 2025 05:47:49 +0000
Subject: [PATCH 04/18] Translate index.md via GitLocalize

---
 docs/zh/community/index.md | 50 ++++++++++++++++++++++++++++++++++++++
 1 file changed, 50 insertions(+)
 create mode 100644 docs/zh/community/index.md

diff --git a/docs/zh/community/index.md b/docs/zh/community/index.md
new file mode 100644
index 000000000..c77d26991
--- /dev/null
+++ b/docs/zh/community/index.md
@@ -0,0 +1,50 @@
+---
+hide:
+  - 导航
+---
+
+# 欢迎来到BeamMP社区！
+
+![BeamMP Multicolor-White](../../assets/content/BeamMP-Multi-WhtLtr-crop.png#only-dark){width="450"} ![BeamMP Multicolor-Black](../../assets/content/BeamMP-Multi-BlkLtr-crop.png#only-light){width="450"}
+
+## 我们的社交媒体链接
+
+!!!failure ""
+
+```
+BeamMP Forum - [https://forum.beammp.com](https://forum.beammp.com)
+```
+
+!!!quote ""
+
+```
+X (Twitter) - [https://x.com/BeamMPOfficial](https://x.com/BeamMPOfficial)
+```
+
+!!!danger ""
+
+```
+YouTube - [https://www.youtube.com/@BeamMPOfficial](https://www.youtube.com/@BeamMPOfficial)
+```
+
+!!!warning ""
+
+```
+Patreon - [https://www.patreon.com/c/BeamMP](https://www.patreon.com/c/BeamMP)
+```
+
+!!!note ""
+
+```
+Discord - [https://discord.com/invite/beammp](https://discord.com/invite/beammp)
+```
+
+!!!info ""
+
+```
+BlueSky - [https://bsky.app/profile/beammpofficial.bsky.social](https://bsky.app/profile/beammpofficial.bsky.social)
+```
+
+## 我们的规则
+
+你可以找到我们的规则 [这里](rules.md)

From 67c2a80d253aed49814d96dd0a9cbadeb3432629 Mon Sep 17 00:00:00 2001
From: Ace06_10010 <tanxuan1144@163.com>
Date: Mon, 20 Oct 2025 05:47:53 +0000
Subject: [PATCH 05/18] Translate Change-launcher-port.md via GitLocalize

---
 docs/zh/FAQ/Change-launcher-port.md | 25 +++++++++++++++++++++++++
 1 file changed, 25 insertions(+)
 create mode 100644 docs/zh/FAQ/Change-launcher-port.md

diff --git a/docs/zh/FAQ/Change-launcher-port.md b/docs/zh/FAQ/Change-launcher-port.md
new file mode 100644
index 000000000..7e2a9a8dd
--- /dev/null
+++ b/docs/zh/FAQ/Change-launcher-port.md
@@ -0,0 +1,25 @@
+# 问题
+
+启动器没有连接到游戏。这个快速指南解释了如何手动更改启动器端口。
+
+# 手动修改端口
+
+1. 启动 BeamNG
+2. 在主菜单, 打开设置, 然后找到 “Multiplayer”
+3. 在 “multiplayer” 设置, 启用 `显示高级选项`
+4. 向下滚动
+5. 在`启动端口号`中，将端口号更改为其他内容，例如4567
+6. 关闭 BeamNG
+7. 右键单击BeamMP-launcher快捷方式，并在上下文菜单中选择`“Open file location”`
+8. 用文本编辑器打开`launcher.cfg`文件
+9. 将`“port”：4444，`的编号更改为与之前在游戏内选项中使用的相同，在本例中为4567
+10. 保存设置并关闭文本编辑器
+11. 启动 BeamMP-launcher
+
+如果仍然没有连接，用另一个端口再试一次。在~2000到65535之间的任何数字都是有效的端口
+
+## 还面临问题吗？
+
+在我们的[Discord服务器](https://discord.gg/BeamMP)上创建一个支持票。
+
+标签: Launcher, Connection Failed, Port Number

From ec021996282ac56f7b5e3129aa183daf5d9b6586 Mon Sep 17 00:00:00 2001
From: mt-gitlocalize <mt@gitlocalize.com>
Date: Mon, 20 Oct 2025 05:47:58 +0000
Subject: [PATCH 06/18] Translate game-faq.md via GitLocalize

---
 docs/zh/FAQ/game-faq.md | 64 +++++++++++++++++++++++++++++++++++++++++
 1 file changed, 64 insertions(+)
 create mode 100644 docs/zh/FAQ/game-faq.md

diff --git a/docs/zh/FAQ/game-faq.md b/docs/zh/FAQ/game-faq.md
new file mode 100644
index 000000000..6a343b856
--- /dev/null
+++ b/docs/zh/FAQ/game-faq.md
@@ -0,0 +1,64 @@
+# F.A.Q.
+
+List of commonly asked questions.
+
+---
+
+## **客户端**
+
+---
+
+### **如何安装 BeamMP？**
+
+There is a full guide on how to install BeamMP on Windows, you can find it [here](https://docs.beammp.com/game/getting-started/).
+
+---
+
+### **BeamMP可以在BeamNG的破解版上运行吗？**
+
+BeamMP will not work with pirated or outdated versions of BeamNG.drive. The BeamMP support team does not offer support for issues with pirated / outdated copies.
+
+---
+
+### **BeamMP 可以在 Linux 上运行吗？**
+
+The Client is not officially supported on Linux. However, you can follow our [guide on how to use BeamMP on Linux](../game/getting-started/#2b-linux-installation)
+
+---
+
+### **为什么启动器被我的杀毒软件或Windows Defender标记**
+
+Some antivirus programs may flag BeamMP as a threat, due to it interacting with the network and other stuff. There are **no viruses** in any of the code. The code for the launcher, server, and lua client can be found on our [GitHub](https://github.com/BeamMP).
+
+---
+
+### **I have poor gameplay performance, what should I do?**
+
+We are working hard to make the Multiplayer experience as stable as possible. If you have already lowered your graphic settings and your performance is still poor, consider playing on a server with less players. The game is mainly CPU bound when you play with lots of people, so older CPUs (even quadcores) will suffer with more than a handful of people. (General Rule of Thumb: 1 car per CPU Thread)
+
+---
+
+## **各种各样的**
+
+---
+
+### **我在哪里可以找到代码？**
+
+All the source code can be found on our [GitHub](https://github.com/BeamMP). Before making any changes, keep in mind that the code is subject to our [Terms of Use](https://forum.beammp.com/t/terms-of-use-v1-0/43) and licenses:
+
+Code | License
+--- | :-:
+Server | [LICENSE](https://github.com/BeamMP/BeamMP-Server/blob/master/LICENSE)
+Launcher | [LICENSE](https://github.com/BeamMP/BeamMP-Launcher/blob/master/LICENSE)
+Client Lua | [LICENSE](https://github.com/BeamMP/BeamMP/blob/development/LICENSE)
+
+---
+
+### **我发现了错误或漏洞，我该怎么办？**
+
+If the issue is code related and you know how to use Github, open a new "Issue" in the appropriate repository on our [GitHub](https://github.com/BeamMP). We use an issue-based workflow so even if you already have a fix for the bug, consider opening a new "Issue", then open a "Pull Request" with the solutions for the issue. More info on contributing can be found [here](https://github.com/BeamMP/BeamMP/blob/development/CONTRIBUTING.md).
+
+If you don't have a GitHub account or you don't know how to use GitHub or have any other questions, you can get in touch with us in the following ways:
+
+- 如果不是敏感内容，您可以在我们的[BeamMP 论坛](https://forum.beammp.com)上创建帖子，或者您可以在我们[的官方 Discord](https://discord.gg/beammp)上报告此问题。
+- 如果信息敏感，您可以直接向我们的[Discord](https://discord.gg/beammp)上的工作人员报告问题。

From 95fd8608a95ca7de65f4c958c169fc5af966b2d3 Mon Sep 17 00:00:00 2001
From: Ace06_10010 <tanxuan1144@163.com>
Date: Mon, 20 Oct 2025 05:48:00 +0000
Subject: [PATCH 07/18] Translate game-faq.md via GitLocalize

---
 docs/zh/FAQ/game-faq.md | 30 +++++++++++++++---------------
 1 file changed, 15 insertions(+), 15 deletions(-)

diff --git a/docs/zh/FAQ/game-faq.md b/docs/zh/FAQ/game-faq.md
index 6a343b856..ae4488532 100644
--- a/docs/zh/FAQ/game-faq.md
+++ b/docs/zh/FAQ/game-faq.md
@@ -1,6 +1,6 @@
-# F.A.Q.
+# 常见问题解答
 
-List of commonly asked questions.
+常见问题列表。
 
 ---
 
@@ -10,31 +10,31 @@ List of commonly asked questions.
 
 ### **如何安装 BeamMP？**
 
-There is a full guide on how to install BeamMP on Windows, you can find it [here](https://docs.beammp.com/game/getting-started/).
+有一个关于如何在Windows上安装BeamMP的完整指南，您可以在这里找到它。
 
 ---
 
 ### **BeamMP可以在BeamNG的破解版上运行吗？**
 
-BeamMP will not work with pirated or outdated versions of BeamNG.drive. The BeamMP support team does not offer support for issues with pirated / outdated copies.
+BeamMP将无法与盗版或过时版本的BeamNG.drive一起工作。BeamMP支持团队不提供盗版/过期副本问题的支持。
 
 ---
 
 ### **BeamMP 可以在 Linux 上运行吗？**
 
-The Client is not officially supported on Linux. However, you can follow our [guide on how to use BeamMP on Linux](../game/getting-started/#2b-linux-installation)
+Client在Linux上不被官方支持。但是，您可以遵循我们的[指南，了解如何在Linux](../game/getting-started/#2b-linux-installation)上使用BeamMP。
 
 ---
 
 ### **为什么启动器被我的杀毒软件或Windows Defender标记**
 
-Some antivirus programs may flag BeamMP as a threat, due to it interacting with the network and other stuff. There are **no viruses** in any of the code. The code for the launcher, server, and lua client can be found on our [GitHub](https://github.com/BeamMP).
+由于它与网络和其他东西交互，一些防病毒程序可能会将BeamMP标记为威胁。在任何代码中都没有**病毒**。启动器、服务器和lua客户端的代码可以在[GitHub](https://github.com/BeamMP)上找到。
 
 ---
 
-### **I have poor gameplay performance, what should I do?**
+### **我的游戏性能很差，我该怎么办？**
 
-We are working hard to make the Multiplayer experience as stable as possible. If you have already lowered your graphic settings and your performance is still poor, consider playing on a server with less players. The game is mainly CPU bound when you play with lots of people, so older CPUs (even quadcores) will suffer with more than a handful of people. (General Rule of Thumb: 1 car per CPU Thread)
+我们正在努力使多人游戏体验尽可能稳定。如果您已经降低了图形设置，但性能仍然很差，请考虑在玩家较少的服务器上进行游戏。当你和很多人一起玩游戏时，游戏主要是CPU受限的，所以旧的CPU（甚至是四核）在多人的情况下会受到影响。（一般经验法则：每个CPU线程1辆车）
 
 ---
 
@@ -44,21 +44,21 @@ We are working hard to make the Multiplayer experience as stable as possible. If
 
 ### **我在哪里可以找到代码？**
 
-All the source code can be found on our [GitHub](https://github.com/BeamMP). Before making any changes, keep in mind that the code is subject to our [Terms of Use](https://forum.beammp.com/t/terms-of-use-v1-0/43) and licenses:
+所有源代码都可以在我们的[GitHub](https://github.com/BeamMP)上找到。在进行任何更改之前，请记住代码受我们的[使用条款](https://forum.beammp.com/t/terms-of-use-v1-0/43)和许可的约束：
 
-Code | License
+代码 | 许可证
 --- | :-:
-Server | [LICENSE](https://github.com/BeamMP/BeamMP-Server/blob/master/LICENSE)
-Launcher | [LICENSE](https://github.com/BeamMP/BeamMP-Launcher/blob/master/LICENSE)
-Client Lua | [LICENSE](https://github.com/BeamMP/BeamMP/blob/development/LICENSE)
+服务器 | [许可证](https://github.com/BeamMP/BeamMP-Server/blob/master/LICENSE)
+启动器 | [许可证](https://github.com/BeamMP/BeamMP-Launcher/blob/master/LICENSE)
+客户端 Lua | [许可证](https://github.com/BeamMP/BeamMP/blob/development/LICENSE)
 
 ---
 
 ### **我发现了错误或漏洞，我该怎么办？**
 
-If the issue is code related and you know how to use Github, open a new "Issue" in the appropriate repository on our [GitHub](https://github.com/BeamMP). We use an issue-based workflow so even if you already have a fix for the bug, consider opening a new "Issue", then open a "Pull Request" with the solutions for the issue. More info on contributing can be found [here](https://github.com/BeamMP/BeamMP/blob/development/CONTRIBUTING.md).
+如果问题与代码相关，并且您知道如何使用Github，请在[ Github ](https://github.com/BeamMP)上的相应存储库中打开一个新的“issue”。我们使用基于问题的工作流程，所以即使你已经修复了bug，也要考虑打开一个新的“Issue”，然后打开一个包含问题解决方案的“Pull Request”。更多关于贡献的信息可以在[中找到](https://github.com/BeamMP/BeamMP/blob/development/CONTRIBUTING.md)。
 
-If you don't have a GitHub account or you don't know how to use GitHub or have any other questions, you can get in touch with us in the following ways:
+如果您没有GitHub帐户，或者您不知道如何使用GitHub，或者您有任何其他问题，您可以通过以下方式与我们联系：
 
 - 如果不是敏感内容，您可以在我们的[BeamMP 论坛](https://forum.beammp.com)上创建帖子，或者您可以在我们[的官方 Discord](https://discord.gg/beammp)上报告此问题。
 - 如果信息敏感，您可以直接向我们的[Discord](https://discord.gg/beammp)上的工作人员报告问题。

From d508bb6bed1c388ef11a3d4ac4efbf6efa2eaa0a Mon Sep 17 00:00:00 2001
From: Ace06_10010 <tanxuan1144@163.com>
Date: Mon, 20 Oct 2025 05:48:04 +0000
Subject: [PATCH 08/18] Translate How-to-deactivate-mods.md via GitLocalize

---
 docs/zh/FAQ/How-to-deactivate-mods.md | 42 +++++++++++++++++++++++++++
 1 file changed, 42 insertions(+)
 create mode 100644 docs/zh/FAQ/How-to-deactivate-mods.md

diff --git a/docs/zh/FAQ/How-to-deactivate-mods.md b/docs/zh/FAQ/How-to-deactivate-mods.md
new file mode 100644
index 000000000..74378f702
--- /dev/null
+++ b/docs/zh/FAQ/How-to-deactivate-mods.md
@@ -0,0 +1,42 @@
+## 为什么我需要停用我的模组 ？
+
+在BeamMP中，您决定连接的服务器提供了必要的模块。这些会在连接时被下载并自动启用。安装本地模组并启用通常会导致BeamMP不能正常工作，即使您除了BeamMP之外只有一个额外的模组。
+
+!!! 警告
+
+```
+移除你安装在BeamNG.Drive\content\或子文件夹的任何模组。这个位置不是用来安装mod的，可能会导致位于同一目录下的“DO_NOT_INSTALL_MODS_HERE.txt”文件中所述的问题。
+
+！！! 引用“DO_NOT_INSTALL_MODS_HERE.txt”
+
+不要复制mod到这个文件夹：它会导致损坏的mod，更新的安装速度变慢，损坏的mod管理器，损坏的安全模式和其他。
+```
+
+## 我如何停用/删除我的模组 ？
+
+在使用BeamMP时，有3个选项可以解决可能出现的问题。
+
+### 1. 禁用模组
+
+在加入任何服务器之前，请确保除了启用“multiplayerbeammp”之外没有其他mod。如果游戏死机或者你仍然有问题，请参考下一个选项
+
+### 2. 创建一个新的用户文件夹
+
+打开BeamNG.Drive的用户文件夹，并将`current`文件夹重命名为例如`current_old`。在重命名之前记得关闭BeamNG。![image](../../assets/content/new-userfolder.png)
+
+### 3. 从内容文件夹中删除模组。
+
+访问BeamNG.Drive\content\文件夹并删除文件夹中的任何模组，打开安装位置的BeamNG.Drive。右键单击`content`文件夹并删除它。继续通过Steam或Epic Games验证游戏文件。这将再次下载文件。
+
+完成后，通过BeamMP- launcher启动BeamNG，您应该将“multiplayerbeammp”作为模组管理器中唯一启用的mod，然后点击主菜单上的按钮进入BeamMP。如果你在加入mod服务器时仍然有问题，他们可能提供了损坏/未更新的mod。
+
+### 4. 清理BeamMP-Launcher缓存
+
+要从BeamMP目录中清除缓存的模组，请转到BeamMP- launcher的安装位置。默认情况下，路径为“C:\Users\AppData\BeamMP-Launcher”。在那里，你会发现一个“Resources”文件夹。删除这个文件夹来删除所有缓存的mod。如果您需要更多磁盘空间或想要删除过时的BeamNG模组，这将非常有用。
+
+!!! 问题 "我的设置和配置文件都不见了！ 我怎样才能恢复呢？"
+
+```
+如果你重命名了用户文件夹，你就会让游戏创建一个新的、干净的用户文件夹。你可以从你重命名的文件夹中复制“settings”和“vehicles”文件夹。‘ current_old ’)到它创建的新文件夹。
+确保BeamNG已关闭，并替换要复制文件夹到的位置中的所有要素。现在，您应该就会有与以前一样的所有配置和设置。
+```

From 58d4115a572fc89830efec1ab9fe582ea8b09ece Mon Sep 17 00:00:00 2001
From: Ace06_10010 <tanxuan1144@163.com>
Date: Mon, 20 Oct 2025 05:48:06 +0000
Subject: [PATCH 09/18] Translate player-faq.md via GitLocalize

---
 docs/zh/FAQ/player-faq.md | 22 ++++++++++++++++++++++
 1 file changed, 22 insertions(+)
 create mode 100644 docs/zh/FAQ/player-faq.md

diff --git a/docs/zh/FAQ/player-faq.md b/docs/zh/FAQ/player-faq.md
new file mode 100644
index 000000000..92b18cc05
--- /dev/null
+++ b/docs/zh/FAQ/player-faq.md
@@ -0,0 +1,22 @@
+# 面向玩家的疑难解答
+
+## 我如何链接我的Discord帐户？
+
+连接你的Discord和BeamMP帐户是BeamMP的一个新功能。为此，您需要发送`!link`作为消息到[BeamMP Accounts](https://discordapp.com/channels/@me/1201234743568634026/) bot。机器人会回复一个链接，让你登录到你的BeamMP账户。只需登录你的BeamMP帐户，一旦完成，你会收到第二条消息，说它已经成功地链接了你的帐户。 🎉
+
+## 我如何获得抢先体验资格？
+
+提前体验权限（包含紫色名牌及其他福利）可通过以下方式获取：在[Patreon](https://patreon.com/BeamMP)平台购买相应套餐、进行捐赠，或助力我们的Discord服务器。
+
+## 我已订阅Patreon会员，如何领取专属福利？
+
+请确保您完成以下操作以自动获得您的福利：
+
+1. 在Patreon上链接您的Discord帐户，以获得Discord服务器中的角色和访问权限。
+2. 请确保您在Patreon上使用的电子邮件地址与您在[论坛](https://forum.beammp.com/)上使用的BeamMP帐户的电子邮件地址相同。
+
+请耐心等待，系统同步可能需要几个小时，有时长达12个小时。如果您在完成上述步骤12小时后仍未收到专属福利，请联系BeamMP支持。
+
+## 我有更多的问题！
+
+如果您的提问或问题与游戏本体或游玩有关，请参阅[游戏常见问题解答](game-faq.md)。如果您的问题与运行服务器有关，请参阅[服务器常见问题解答](server-faq.md)。否则，请查看[论坛](https://forum.beammp.com/c/faq/35)，在那里社区可以提出问题并获得答案。

From 5db1daf65c48075d22d8eadf36e76f4ae8058903 Mon Sep 17 00:00:00 2001
From: Ace06_10010 <tanxuan1144@163.com>
Date: Mon, 20 Oct 2025 05:48:08 +0000
Subject: [PATCH 10/18] Translate server-faq.md via GitLocalize

---
 docs/zh/FAQ/server-faq.md | 89 +++++++++++++++++++++++++++++++++++++++
 1 file changed, 89 insertions(+)
 create mode 100644 docs/zh/FAQ/server-faq.md

diff --git a/docs/zh/FAQ/server-faq.md b/docs/zh/FAQ/server-faq.md
new file mode 100644
index 000000000..32dd2b387
--- /dev/null
+++ b/docs/zh/FAQ/server-faq.md
@@ -0,0 +1,89 @@
+# 常见问题和已知问题
+
+常见问题和已知bug列表。
+
+---
+
+## **服务器**
+
+---
+
+### **我怎么设置自己的服务器**
+
+设置您自己的服务器的所有信息可以在[中找到](https://docs.beammp.com/server/create-a-server/)。
+
+---
+
+### **服务器端兼容LINUX吗？**
+
+我们在这里提供了许多Linux发行版的二进制文件[。如果您的操作系统/发行版没有二进制文件，您可以通过在](https://github.com/BeamMP/BeamMP-Server/releases/latest)[GitHub](https://github.com/BeamMP/BeamMP-Server)上下载源代码来自己编译它，教程可以在中找到[。](https://github.com/BeamMP/BeamMP-Server#build-instructions)
+
+---
+
+### **运行BeamMP服务器的最低系统要求是什么？**
+
+- 内存: 50+ MiB可用（不计算操作系统开销）
+- CPU: &gt;1GHz, 最好是多核
+- 操作系统： Windows、Linux（理论上兼容所有POSIX系统）
+- GPU: 不需要
+- 硬盘：10 MiB + 模组/插件
+- 带宽：上传5 ~ 10m /s
+
+---
+
+## **局域网外的玩家无法加入我的自托管服务器**
+
+请查阅[此处](https://docs.beammp.com/server/port-forwarding/)提供的端口转发指南，下文为其关键步骤摘要。若其他玩家通过BeamMP启动器连接您的服务器时出现错误代码10060、10061或10038，请按以下流程排查：
+
+- 转发端口30814（或在ServerConfig.toml中配置的其他端口），需同时开放TCP与UDP协议。
+- 请在Windows防火墙中为BeamMP放行入站与出站连接，直接关闭防火墙通常无法解决问题。
+- 确认你现在没有在使用VPN (这可能是问题的原因).
+- 确保服务器确实在运行，没有任何错误或警告。
+
+您可以在服务器运行时使用CheckBeamMP检查您是否成功地进行了端口转发。
+
+<form action="https://check.beammp.com/api/v2/beammp" method="get" target="_blank">
+  <label for="ip">IP地址:</label>
+  <input type="text" id="ip" name="ip"><br>
+  <label for="port">端口:</label>
+  <input type="text" id="port" name="port"><br>
+  <input type="submit" value="CheckBeamMP">
+</form>
+
+注意:
+
+- 一些互联网提供商不为您的连接（CGNAT）提供专用的IPv4地址，因此端口转发可能不成功，尽管它在路由器中是可以的。
+- 如果你使用的是移动（4G/5G）互联网连接，端口转发是不可能的。
+
+---
+
+### **我可以在服务器列表中看到我的自托管服务器，但我不能自己加入它**
+
+若服务器与游戏运行于同一台设备，您需通过在直接连接中输入IP地址 127.0.0.1 和服务器端口来加入。若要通过服务器列表加入自托管服务器，您的路由器需支持NAT环回功能，但多数家用路由器未提供此功能。
+
+---
+
+## **其他**
+
+---
+
+### **我在哪里可以找到源码？**
+
+所有源代码都可以在我们的[GitHub](https://github.com/BeamMP)上找到。在做任何事情之前，请记住代码受我们的[使用条款](https://forum.beammp.com/t/terms-of-use-v1-0/43)和许可的约束：
+
+代码 | 许可证
+--- | :-:
+服务器 | [许可证](https://github.com/BeamMP/BeamMP-Server/blob/master/LICENSE)
+启动器 | [许可证](https://github.com/BeamMP/BeamMP-Launcher/blob/master/README.md)
+客户端 Lua | [许可证](https://github.com/BeamMP/BeamMP/blob/development/LICENSE.md)
+
+---
+
+### **我发现了一个bug或漏洞，我应该怎么做？**
+
+如果问题与代码相关，并且您知道如何使用Github，请在[ Github ](https://github.com/BeamMP)上的适当存储库中创建一个新的“issue”。我们使用基于问题的工作流程，所以即使你已经修复了bug，也可以考虑打开一个新的“Issue”，然后请求一个“Pull Request”来解决你的“问题”。更多关于贡献的信息可以在[中找到](https://github.com/BeamMP/BeamMP/blob/development/CONTRIBUTING.md)。
+
+如果您没有GitHub帐户或者您不知道如何使用GitHub，您可以通过以下方式与我们联系：
+
+- 如果问题不涉及隐私或安全，您可以在我们的[BeamMP论坛](https://forum.beammp.com)发帖反馈，或前往[官方Discord服务器](https://discord.gg/beammp)提交报告。
+- 如果信息敏感，您可以直接向我们的[Discord](https://discord.gg/beammp)上的工作人员报告问题。

From 80fe2cbfda6c4d74049b4c8066fffba8a913687f Mon Sep 17 00:00:00 2001
From: Ace06_10010 <tanxuan1144@163.com>
Date: Mon, 20 Oct 2025 05:48:10 +0000
Subject: [PATCH 11/18] Translate Update-launcher.md via GitLocalize

---
 docs/zh/FAQ/Update-launcher.md | 20 ++++++++++++++++++++
 1 file changed, 20 insertions(+)
 create mode 100644 docs/zh/FAQ/Update-launcher.md

diff --git a/docs/zh/FAQ/Update-launcher.md b/docs/zh/FAQ/Update-launcher.md
new file mode 100644
index 000000000..8fc0ce26f
--- /dev/null
+++ b/docs/zh/FAQ/Update-launcher.md
@@ -0,0 +1,20 @@
+# 问题
+
+启动器无法更新或显示空白屏幕？这个快速指南解释了如何手动更新启动器。
+
+!!! 注意
+
+```
+请确保您已通过官网（https://beammp.com）提供的安装程序完成BeamMP的安装及运行，然后再继续后续操作。
+```
+
+# 下载并安装一个新的启动器
+
+1. 直接从[GitHub仓库](https://github.com/BeamMP/BeamMP-Launcher/releases/latest/download/BeamMP-Launcher.exe)下载最新版启动器
+2. 定位至BeamMP-Launcher.exe所在目录：默认安装路径：`C:\Users\<用户名>\AppData\Roaming\`（将 &lt;用户名&gt; 替换为您的Windows账户名称）<br>自定义安装路径：若您此前将BeamMP安装至其他位置（例如 `D:\BeamMP-Launcher`），请将新启动器文件放入对应文件夹
+3. 在BeamMP-Launcher文件夹内，使用新启动器覆盖替换旧版本（如存在）
+4. 按常规方式启动BeamMP-Launcher以验证运行状态
+
+## 还面临问题？
+
+请于我们的[Discord服务器](https://discord.gg/BeamMP)创建技术支持工单，标签标注：Launcher, download

From 4a406eb480823fb745c9e1096c3c51a7d6231f60 Mon Sep 17 00:00:00 2001
From: Ace06_10010 <tanxuan1144@163.com>
Date: Mon, 20 Oct 2025 05:48:12 +0000
Subject: [PATCH 12/18] Translate where-to-find-my-IP.md via GitLocalize

---
 docs/zh/FAQ/where-to-find-my-IP.md | 25 +++++++++++++++++++++++++
 1 file changed, 25 insertions(+)
 create mode 100644 docs/zh/FAQ/where-to-find-my-IP.md

diff --git a/docs/zh/FAQ/where-to-find-my-IP.md b/docs/zh/FAQ/where-to-find-my-IP.md
new file mode 100644
index 000000000..68027b9da
--- /dev/null
+++ b/docs/zh/FAQ/where-to-find-my-IP.md
@@ -0,0 +1,25 @@
+# 我怎样才能找到我服务器的IP ？
+
+## 对于VPS托管服务器
+
+如果您使用的我们的合作托管服务之一的托管服务器，其IP地址将显示在对应服务商的服务器管理界面中。您还可以在[Keymaster](https://keymaster.beammp.com/login)网站上找到服务器的IP。
+
+## 对于家庭托管服务器
+
+对于家庭自托管服务器，请在浏览器中访问[whatsmyip.org](https://whatsmyip.org)，该网站将显示互联网访问您时所使用的公网IPv4地址。
+
+注意，127.0.0.1是本地主机地址，如果服务器托管在同一台计算机上，则只能由您自己使用。如果您与家庭托管服务器的连接仍然有问题，请检查[端口转发](https://docs.beammp.com/server/port-forwarding/)以及使用CheckBeamMP
+
+<form action="https://check.beammp.com/api/v2/beammp" method="get" target="_blank">
+  <label for="ip">IP地址:</label>
+  <input type="text" id="ip" name="ip"><br>
+  <label for="port">端口:</label>
+  <input type="text" id="port" name="port"><br>
+  <input type="submit" value="CheckBeamMP">
+</form>
+
+## 怎么检查CGNAT?
+
+请查看[这个页面](https://docs.beammp.com/FAQ/How-to-check-for-CGNAT/)，以确定您是否可以在家中托管服务器。
+
+标签: IP, Server, Connection Failed, 10060/10061

From 754dcd2e9edea020b3fbbbb16a050d5fc4c20f65 Mon Sep 17 00:00:00 2001
From: Ace06_10010 <tanxuan1144@163.com>
Date: Mon, 20 Oct 2025 05:48:14 +0000
Subject: [PATCH 13/18] Translate error-codes.md via GitLocalize

---
 docs/zh/game/error-codes.md | 24 ++++++++++++++++++++++++
 1 file changed, 24 insertions(+)
 create mode 100644 docs/zh/game/error-codes.md

diff --git a/docs/zh/game/error-codes.md b/docs/zh/game/error-codes.md
new file mode 100644
index 000000000..6a99d7bcf
--- /dev/null
+++ b/docs/zh/game/error-codes.md
@@ -0,0 +1,24 @@
+# 错误代码
+
+此页包含启动程序可能显示的所有错误代码。
+
+---
+
+代码 | 描述 | 可能的解决方案
+--- | --- | ---
+10048 | 其他东西占用了启动器端口 | 确保只运行了一个BeamMP-Launcher程序。或尝试重新启动电脑。
+10038 / 10060 / 10061 | 在此指定的IP和/或端口上没有服务器应答 | 若您为服务器所有者，请前往[BeamMP-Server](https://docs.beammp.com/server/create-a-server)核验端口转发规则及防火墙策略；若非所有者，请尝试切换其他服务器或联系已知管理员协同排障。
+10054 | 对方/服务器突然断开了连接 | 您正在连接的服务器已离线。
+Failed to find the game please launch it. Report this if the issue persists code 3. | 启动器无法在注册表项中找到游戏信息（游戏目录，配置文件目录，版本等） | 至少运行一次游戏，以便创建注册表值。
+Failed to find the game please launch it. Report this if the issue persists code 4. | 启动器无法从注册表项中读取游戏信息（游戏目录、配置文件目录、版本等） | 此错误最有可能出现在**盗版**游戏的用户中。如果你已经购买了游戏，至少运行一次，这样注册表值就会被创建。
+Failed to Launch the game! launcher closing soon | 启动器无法找到游戏的可执行文件 | 在再次运行启动器之前，至少运行一次游戏。
+Game Closed! launcher closing soon | 游戏关闭了 | 此消息将在游戏结束或游戏启动失败时出现。
+Launcher Update failed! | 启动器未能下载新版本 | 检查您的互联网连接和防火墙/防病毒规则，让启动器没有被阻止。
+Logger file init failed | 启动器缺乏文件创建权限 | 使用管理员身份运行启动器
+Please close the game and try again | 游戏已经打开，启动器无法清除`multiplayer/mod `文件夹 | 关闭游戏并重试
+Please launch the game at least once | 启动器尝试修改游戏目录但是失败了 | 在再次运行启动器之前，至少运行一次游戏。
+Primary Servers Offline! Sorry for the inconvenience! | 启动器未能检查更新 | 检查你的互联网连接和防火墙规则。如果您没有问题，请查看我们Discord上的[BeamMP更新频道](https://discord.com/channels/601558901657305098/697596153943949352)。
+Sorry Backend System Outage! Don't worry it will back on soon! | BeamMP后端没有响应 | 检查你的互联网连接和防火墙规则。如果您没有问题，请查看我们Discord上的[BeamMP更新频道](https://discord.com/channels/601558901657305098/697596153943949352)。
+Stuck on updating | 启动器卡在更新上，不会继续下一步 | 以管理员身份运行启动器并检查反病毒规则，以确保启动器未被阻止。
+
+如果启动器迅速“闪退”了，请检查安装BeamMP的文件夹中的` launcher .log`文件。

From f535659c89c7afa11cabb49a525ea659d954a690 Mon Sep 17 00:00:00 2001
From: Ace06_10010 <tanxuan1144@163.com>
Date: Mon, 20 Oct 2025 05:48:16 +0000
Subject: [PATCH 14/18] Translate getting-started.md via GitLocalize

---
 docs/zh/game/getting-started.md | 133 +++++++++++++++++++++++++++-----
 1 file changed, 115 insertions(+), 18 deletions(-)

diff --git a/docs/zh/game/getting-started.md b/docs/zh/game/getting-started.md
index 113cc5759..f189e2dcd 100644
--- a/docs/zh/game/getting-started.md
+++ b/docs/zh/game/getting-started.md
@@ -1,39 +1,136 @@
 # 入门
 
----
-
-## **开始之前**
+## **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: `sudo apt install build-essential`
+- Fedora: `sudo dnf install cmake gcc-c++ perl-IPC-Cmd perl-FindBin perl-File-Compare perl-File-Copy`
+- 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`
+
+在项目的根目录中，
+
+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错误
+```
+
+将完成的应用程序从`/bin`文件夹移到它自己的文件夹中，并从那里运行它
+
+本机linux BeamMP-Launcher将启动并使用本机linux beammp .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)。

From 38b068ff0e55d42c5928d15c7c05ee5b363972f9 Mon Sep 17 00:00:00 2001
From: Ace06_10010 <tanxuan1144@163.com>
Date: Mon, 20 Oct 2025 05:48:18 +0000
Subject: [PATCH 15/18] Translate multiplayer-settings.md via GitLocalize

---
 docs/zh/game/multiplayer-settings.md | 318 +++++++++++++++++++++++++++
 1 file changed, 318 insertions(+)
 create mode 100644 docs/zh/game/multiplayer-settings.md

diff --git a/docs/zh/game/multiplayer-settings.md b/docs/zh/game/multiplayer-settings.md
new file mode 100644
index 000000000..cd768c851
--- /dev/null
+++ b/docs/zh/game/multiplayer-settings.md
@@ -0,0 +1,318 @@
+# 多人模式设置
+
+## **1. 一般设置**
+
+??? 设置 “显示高级选项”
+
+```
+如果启用，您将看到所有多人游戏设置
+
+如果禁用，您将只看到基本的多人游戏设置
+```
+
+??? 设置 “启用克隆保护”
+
+```
+如果启用，你生成的车辆配置将不会被其他玩家保存
+
+如果禁用，你的衍生车辆配置可以被其他玩家保存
+```
+
+??? 设置 “禁用因不稳定导致的暂停”
+
+```
+如果启用，物理不稳定性将不会导致游戏暂停
+
+如果禁用，物理不稳定性将导致游戏暂停
+
+!!! 注意 ""
+
+建议设置为禁用，因为反复的不稳定会导致游戏崩溃
+```
+
+??? 设置 “可用时使用简化车辆”
+
+```
+如果启用，游戏将会替换其他玩家的简化版车辆（来自AI流量）
+
+如果禁用，游戏将使用预定的车辆模型
+```
+
+??? 设置 “新聊天菜单”
+
+```
+如果启用，游戏内聊天将显示在[IMGUI]（https://github.com/ocornut/imgui）窗口中，例如可以从游戏中拖出到另一个显示器上
+
+如果禁用，游戏内聊天将显示在UI应用程序中
+
+!!! 注意 ""
+
+将IMGUI窗口拖出主游戏窗口可能会导致性能问题，还会诱使屏幕录制软件录制聊天窗口而不是主游戏窗口
+```
+
+??? 设置 “启用车辆位置平滑”
+
+```
+如果启用，beamMP将使用算法平滑车辆位置更新到定期间隔。在ping值高的玩家之间，或者当一个连接经历了高包掉落率时，这会优化移动平滑性
+
+如果禁用，beamMP将在接收到车辆位置时更新
+```
+
+??? 设置 “跳过模组安全警告提示框”
+
+```
+如果启用，当试图用模组连接到服务器时，将不会显示模组安全弹出框
+
+如果禁用，当你连接到一个带有模组的服务器时，就会显示模组安全弹出框
+```
+
+??? 设置 “启用玩家车辆更新/编辑排队”
+
+```
+如果启用，其他玩家的车辆刷出和编辑将被放入队列。参见第2节。事件队列'获取更多详细信息
+
+如果禁用，其他玩家的车辆刷出和编辑将立即被游戏加载
+```
+
+??? 设置 “启用零件自动同步”
+
+```
+如果启用，你的车辆部件将在几秒钟后自动同步到其他玩家
+
+如果禁用，您需要单击部件选择器中的部件同步按钮，以便将同步发送给其他播放器
+```
+
+??? 设置 “禁止切换到其他玩家的车辆”
+
+```
+如果启用，点击车辆将跳过其他玩家的车辆
+
+如果不启用，将会在每一个衍生的车辆上循环
+```
+
+??? 设置 “车辆靠近时淡出”
+
+```
+如果启用，其他车辆会在靠近时淡出
+
+如果禁用，其他车辆将保持完全可见，无论距离
+
+!!! 注意 ""
+
+这只会影响车辆的可见3d网格，而不会影响其物理节点-光束网格。为了禁用物理，你需要在游戏设置中启用“简化碰撞物理”
+```
+
+???  设置 “显示玩家ID”
+
+```
+如果启用，游戏内的玩家列表将增加一行，显示每个玩家的 ID。这对于开发或管理很有用。
+
+如果禁用，游戏内的玩家列表将仅显示玩家名称和延迟这两列。
+```
+
+??? 设置 “允许游戏内服务器列表刷新”
+
+```
+若启用此功能，游戏过程中服务器列表将按固定时间间隔自动更新。此操作可能导致游戏卡顿现象发生。
+
+若禁用此功能，服务器列表仅会在打开主菜单界面时更新一次。
+```
+
+## **2. 事件队列**
+
+??? 设置 “高亮显示队列玩家”
+
+```
+如果启用，具有队列事件的玩家将在游戏玩家列表中突出显示
+
+如果禁用，玩家将不会单独突出显示
+```
+
+??? 设置 "应用车辆更改"
+
+```
+如果设置为“鼠标左键”，使用鼠标左键点击玩家列表中的玩家名字将加载队列事件。用鼠标右键点击将观看该玩家
+
+如果设置为“鼠标右键”，使用鼠标右键点击玩家列表中的玩家名字将加载队列事件。用鼠标左键点击将观看该玩家
+```
+
+??? 设置 “自动应用队列车辆变更”
+
+```
+如果启用了该功能，那么一旦低于设定为超时的速度阈值，就会自动加载队列的事件
+
+如果禁用，队列事件将只能手动加载，通过点击屏幕顶部的“事件”按钮或玩家列表中的玩家名称
+```
+
+??? 设置 “队列应用速度阈值”
+
+```
+本设定值定义了自动加载事件队列的速度阈值。为使队列事件成功加载，车辆必须持续低于该设定时速且超过"队列应用超时"的持续时长
+```
+
+??? 设置 “队列应用超时”
+
+```
+此设定值定义自动事件队列加载的时间延迟。为了加载排队的事件，您的车辆必须比“队列应用速度阈值”慢
+```
+
+??? 设置 “观看他人时跳过队列”
+
+```
+如果启用，如果您正在观看其他玩家，则会立即加载事件
+
+如果被禁用，一个事件将被排队，就像它在你自己的车辆上一样
+```
+
+??? 设置 “不要排队独轮车（Snowmen/Beamlings）”
+
+```
+如果启用，有关Snowmen/Beamlings的事件将立即加载
+
+如果禁用，Snowmen/Beamlings将像其他车辆一样排队
+```
+
+## **3. 设置默认Unicyle**
+
+??? 设置 "默认 Unicycle 配置文件"
+
+```
+该配置项用于定义默认加载的独轮车类型。您既可以选择预设配置，若已保存自定义独轮车配置，也可选用自有配置。
+```
+
+??? 设置“自动保存上次使用的Unicyle”
+
+```
+启用状态最近使用的独轮车配置将被自动保存，并在下次生成时直接加载
+禁用状态始终使用默认配置生成独轮车
+```
+
+## **4. 物理节点**
+
+??? 设置 "启用未生成载具的物理节点"
+
+```
+启用时，未生成载具显示定位球体
+禁用时完全隐藏
+```
+
+??? 设置 "调整颜色"
+
+```
+??? 设置 "可见"
+
+    如果启用，将绘制一个节点，使用下面的颜色
+    如果禁用，则不会为指定的函数绘制节点
+??? 设置 "RGB HEX 值"
+
+    队列车辆：当车辆队列等待刷出时，斑点将使用的颜色。标准值#FF6400
+
+    非法车辆：如果车辆是非法的，例如通过侧面加载的mod， blob将使用的颜色。标准值#000000
+
+    已删除的车辆：如果用户删除了车辆，blob将使用的颜色。标准值#333333
+```
+
+## **5. 昵称标签**
+
+??? 设置 "隐藏玩家昵称标签"
+
+```
+如果启用，将不会绘制玩家的昵称标签
+
+如果禁用，玩家的名字将根据他们车辆的相对位置绘制
+```
+
+??? 设置 "显示与其他玩家的距离"
+
+```
+如果启用，将在昵称标签前面加上到相应车辆的距离
+
+如果禁用，则不会在标签中显示额外的距离
+```
+
+??? 设置 "淡入/淡出昵称标签"
+
+```
+如果启用，标签将根据“淡出距离”和“反转标签淡出方向”淡出。
+
+如果禁用，则无论与相应车辆的距离如何，都将以标准不透明度绘制图像
+```
+
+??? 设置 "淡出距离/反转标签淡出方向"
+
+```
+!!! 设置 "淡出"
+
+    玩家离得越远，标签就越不显眼
+
+'渐变距离'定义了标签在最小不透明度下绘制的距离
+
+!!! 设置 "淡入"
+
+    玩家离得越远，标签就越显眼
+
+'渐变距离'定义了标签在最大不透明度下绘制的距离
+```
+
+??? 设置 "不要完全隐藏姓名标签"
+
+```
+如果启用，一个标签不能完全不可见，它将保留一个最小的不透明度，无论距离
+
+如果禁用，昵称标签可以完全不可见
+```
+
+??? 设置 "缩短昵称标签和角色标签"
+
+```
+如果启用，‘ Nametag length limit ’将截断昵称标签和角色到设置的字符限制
+
+如果禁用，名称标签和角色标签将以完整的长度显示
+```
+
+??? 设置 "在车辆标签下显示观众的标签"
+
+```
+如果启用，观众的名字将被添加到玩家的姓名标签下面
+
+如果禁用，没有观众的名字会被添加到标签
+```
+
+??? 设置 "观众昵称标签颜色相同"
+
+```
+如果启用，观众的名字将始终被灰色背景包围
+
+如果禁用，观众的名字将被彩色背景包围，以突出观众的角色
+```
+
+## **6. 其他**
+
+??? 设置 "在控制台中显示网络活动"
+
+```
+如果启用，则将在控制台中显示beamMP网络活动
+
+如果禁用，则控制台中不会显示进一步的网络活动
+!!! 风险 ""
+
+   要小心这个设置，因为所有控制台输出也会写入日志文件
+
+启用此设置后，它们可以在几分钟内增长数百MB
+```
+
+??? 设置 "启动器端口"
+
+```
+此设定值定义用于与启动器通信的端口
+
+只有标准端口4444不能使用时才需要更改吗
+
+不要忘记在启动器侧修改它，通过修改‘ launcher.cfg ’
+
+!!! 提示 ""
+
+    指定的端口只是两个中的第一个，第二个正在使用的端口紧随其后，设置port + 1
+
+第一个端口携带核心网络数据包，第二个端口携带游戏网络数据包，两者都通过TCP传输
+```

From 3ddad4141622d438c8c8a4806dc948d141f72160 Mon Sep 17 00:00:00 2001
From: mt-gitlocalize <mt@gitlocalize.com>
Date: Mon, 20 Oct 2025 05:48:20 +0000
Subject: [PATCH 16/18] Translate index.md via GitLocalize

---
 docs/zh/index.md | 36 ++++++++++++++++++++++++++++++++++++
 1 file changed, 36 insertions(+)
 create mode 100644 docs/zh/index.md

diff --git a/docs/zh/index.md b/docs/zh/index.md
new file mode 100644
index 000000000..bc835cd39
--- /dev/null
+++ b/docs/zh/index.md
@@ -0,0 +1,36 @@
+---
+hide:
+  - 导航
+---
+
+!!! warning "This site is under construction!"
+
+```
+This site is being actively worked on.
+
+Feel you could help? Please do by clicking on the page with a pencil on the right!
+
+This can be done on any page, too.
+```
+
+# Welcome to BeamMP Docs! :tada:
+
+Welcome to the new and improved documentation hub for BeamMP! Whether you're a player, server owner, or developer, we have the resources you need to enhance your BeamNG.drive multiplayer experience.
+
+## 对于玩家
+
+New to BeamMP? Check out our [Getting Started](../game/getting-started.md) page to help you hit the road running and make the most out of your multiplayer adventures. For general questions and issues please check out the [Players FAQ](../FAQ/player-faq.md).
+
+## For Server Owners
+
+Thinking about creating your own BeamMP server? Our comprehensive guide [here](../server/create-a-server.md) will walk you through the process, ensuring you have all the tools and knowledge to set up your server efficiently.
+
+## For Developers
+
+Discover the ins and outs of creating resources for the BeamMP Server in our [Resource Development Guide](../guides/mod-creation/server/getting-started.md).
+
+Exciting updates are on the horizon, including a brand-new homepage designed to enhance your browsing experience. Stay tuned for more! :slight_smile:
+
+## Community Rules
+
+Read through the BeamMP [Community rules](https://docs.beammp.com/community/rules/) and how to appeal bans.

From a75cdf151449709e993d3042221ed44732d2eb3b Mon Sep 17 00:00:00 2001
From: Please-Pick-a-Name <xmx526@gmail.com>
Date: Mon, 20 Oct 2025 05:48:22 +0000
Subject: [PATCH 17/18] Translate index.md via GitLocalize

---
 docs/zh/index.md | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/docs/zh/index.md b/docs/zh/index.md
index bc835cd39..89f9eb74b 100644
--- a/docs/zh/index.md
+++ b/docs/zh/index.md
@@ -3,7 +3,7 @@ hide:
   - 导航
 ---
 
-!!! warning "This site is under construction!"
+!!!警告“该网站正在建设当中！“
 
 ```
 This site is being actively worked on.
@@ -13,23 +13,23 @@ Feel you could help? Please do by clicking on the page with a pencil on the righ
 This can be done on any page, too.
 ```
 
-# Welcome to BeamMP Docs! :tada:
+# 欢迎来到BeamMP文档！:tada:
 
-Welcome to the new and improved documentation hub for BeamMP! Whether you're a player, server owner, or developer, we have the resources you need to enhance your BeamNG.drive multiplayer experience.
+欢迎来到全新改进的BeamMP文档中心！无论您是玩家，服主，还是开发者，我们都能为您提供增强BeamNG.drive多人游戏体验所需的资源。
 
 ## 对于玩家
 
 New to BeamMP? Check out our [Getting Started](../game/getting-started.md) page to help you hit the road running and make the most out of your multiplayer adventures. For general questions and issues please check out the [Players FAQ](../FAQ/player-faq.md).
 
-## For Server Owners
+## 对于服主
 
 Thinking about creating your own BeamMP server? Our comprehensive guide [here](../server/create-a-server.md) will walk you through the process, ensuring you have all the tools and knowledge to set up your server efficiently.
 
-## For Developers
+## 对于开发者
 
 Discover the ins and outs of creating resources for the BeamMP Server in our [Resource Development Guide](../guides/mod-creation/server/getting-started.md).
 
-Exciting updates are on the horizon, including a brand-new homepage designed to enhance your browsing experience. Stay tuned for more! :slight_smile:
+令人兴奋的更新即将推出，包括旨在增强您的浏览体验的全新主页。请继续关注！:slight_smile:
 
 ## Community Rules
 

From 5bb503814eb80e92d97059e428d96997840b3a49 Mon Sep 17 00:00:00 2001
From: Ace06_10010 <tanxuan1144@163.com>
Date: Mon, 20 Oct 2025 05:48:23 +0000
Subject: [PATCH 18/18] Translate index.md via GitLocalize

---
 docs/zh/index.md | 16 ++++++++--------
 1 file changed, 8 insertions(+), 8 deletions(-)

diff --git a/docs/zh/index.md b/docs/zh/index.md
index 89f9eb74b..88e230979 100644
--- a/docs/zh/index.md
+++ b/docs/zh/index.md
@@ -6,11 +6,11 @@ hide:
 !!!警告“该网站正在建设当中！“
 
 ```
-This site is being actively worked on.
+这个网站正在积极建设中。
 
-Feel you could help? Please do by clicking on the page with a pencil on the right!
+觉得你能帮上忙吗？请用铅笔在右侧点击页面！
 
-This can be done on any page, too.
+这也可以在任何页面上完成。
 ```
 
 # 欢迎来到BeamMP文档！:tada:
@@ -19,18 +19,18 @@ This can be done on any page, too.
 
 ## 对于玩家
 
-New to BeamMP? Check out our [Getting Started](../game/getting-started.md) page to help you hit the road running and make the most out of your multiplayer adventures. For general questions and issues please check out the [Players FAQ](../FAQ/player-faq.md).
+首次体验BeamMP联机模组？请访问我们的[新手启航指南](../game/getting-started.md)，助您迅速完成配置部署，畅享多人模式下的高拟真驾驶盛宴。若遇基础性问题，建议优先查阅[玩家常见问题解答](../FAQ/player-faq.md)中的故障排查方案
 
 ## 对于服主
 
-Thinking about creating your own BeamMP server? Our comprehensive guide [here](../server/create-a-server.md) will walk you through the process, ensuring you have all the tools and knowledge to set up your server efficiently.
+考虑创建专属BeamMP服务器？我们的[完整指南](../server/create-a-server.md)将逐步指导您完成整个流程，确保您掌握所需工具和知识，助您高效搭建服务器
 
 ## 对于开发者
 
-Discover the ins and outs of creating resources for the BeamMP Server in our [Resource Development Guide](../guides/mod-creation/server/getting-started.md).
+想要了解如何为BeamMP服务器创建资源？请查看我们的[资源开发指南](../guides/mod-creation/server/getting-started.md)，获取完整的功能实现指引。
 
 令人兴奋的更新即将推出，包括旨在增强您的浏览体验的全新主页。请继续关注！:slight_smile:
 
-## Community Rules
+## 社会规则
 
-Read through the BeamMP [Community rules](https://docs.beammp.com/community/rules/) and how to appeal bans.
+请仔细查阅BeamMP [社区守则](https://docs.beammp.com/community/rules/)及封禁申诉流程说明。