New VitePress and design look + little work on update to work with.

2026-07-19 13:23:57 +00:00 · 2026-06-16 12:31:19 +01:00
parent 0ed2597186
commit 97a7aaf643
141 changed files with 4356 additions and 539 deletions
@@ -2,7 +2,7 @@

 在BeamMP中，您决定连接的服务器提供了必要的模块。这些会在连接时被下载并自动启用。安装本地模组并启用通常会导致BeamMP不能正常工作，即使您除了BeamMP之外只有一个额外的模组。

-!!! 警告
+::: warning

 ```
 移除你安装在BeamNG.Drive\content\或子文件夹的任何模组。这个位置不是用来安装mod的，可能会导致位于同一目录下的“DO_NOT_INSTALL_MODS_HERE.txt”文件中所述的问题。
@@ -34,7 +34,7 @@

 要从BeamMP目录中清除缓存的模组，请转到BeamMP- launcher的安装位置。默认情况下，路径为“C:\Users\AppData\BeamMP-Launcher”。在那里，你会发现一个“Resources”文件夹。删除这个文件夹来删除所有缓存的mod。如果您需要更多磁盘空间或想要删除过时的BeamNG模组，这将非常有用。

-!!! 问题 "我的设置和配置文件都不见了！ 我怎样才能恢复呢？"
+::: question "我的设置和配置文件都不见了！ 我怎样才能恢复呢？"

 ```
 如果你重命名了用户文件夹，你就会让游戏创建一个新的、干净的用户文件夹。你可以从你重命名的文件夹中复制“settings”和“vehicles”文件夹。‘ current_old ’)到它创建的新文件夹。
@@ -1,6 +1,6 @@
 # 如何在Windows Defender防火墙和防病毒软件中创建白名单？

-!!! info
+::: info

 ```
 在修改防火墙之前，请确保将windows网络设置中的网络设置为专用（假设您在私有网络中）。
@@ -16,7 +16,7 @@

 打开命令提示符，运行`tracert -4 beammp.com`。这将输出一系列网络跳数。等待操作完成（可能需要30跳）。检查路由器/调制解调器/网关IP后的前几个IP地址。如果有多个IP地址在`100.64.x.x`—`100.127.x。X `或`10.xx.xx。xx`出现在第一跳之后，您很可能在CGNAT后面。

-!!! 注意
+::: note

 ```
 第一跳将是你的路由器/调制解调器/网关，不同的设备不同。
@@ -31,7 +31,7 @@

 请致电互联网服务提供商寻求帮助。根据您的ISP，他们可能不提供专用的*动态* IP地址。请记住，静态IP不是必需的。

-!!! 警告
+::: warning

 ```
 互联网服务提供商可能只提供专用IP地址作为**付费选项**。
@@ -2,7 +2,7 @@

 在BeamMP中，您决定连接的服务器提供了必要的模块。这些会在连接时被下载并自动启用。安装本地模组并启用通常会导致BeamMP不能正常工作，即使您除了BeamMP之外只有一个额外的模组。

-!!! 警告
+::: warning

 ```
 移除你安装在BeamNG.Drive\content\或子文件夹的任何模组。这个位置不是用来安装mod的，可能会导致位于同一目录下的“DO_NOT_INSTALL_MODS_HERE.txt”文件中所述的问题。
@@ -34,7 +34,7 @@

 要从BeamMP目录中清除缓存的模组，请转到BeamMP- launcher的安装位置。默认情况下，路径为“C:\Users\AppData\BeamMP-Launcher”。在那里，你会发现一个“Resources”文件夹。删除这个文件夹来删除所有缓存的mod。如果您需要更多磁盘空间或想要删除过时的BeamNG模组，这将非常有用。

-!!! 问题 "我的设置和配置文件都不见了！ 我怎样才能恢复呢？"
+::: question "我的设置和配置文件都不见了！ 我怎样才能恢复呢？"

 ```
 如果你重命名了用户文件夹，你就会让游戏创建一个新的、干净的用户文件夹。你可以从你重命名的文件夹中复制“settings”和“vehicles”文件夹。‘ current_old ’)到它创建的新文件夹。
@@ -2,7 +2,7 @@

 启动器无法更新或显示空白屏幕？这个快速指南解释了如何手动更新启动器。

-!!! 注意
+::: note

 ```
 请确保您已通过官网（https://beammp.com）提供的安装程序完成BeamMP的安装及运行，然后再继续后续操作。
@@ -7,7 +7,7 @@
 === 我需要帮助！我的 BeamMP 启动器无法运行！<br>请尝试重新安装 BeamMP 启动器。具体操作步骤如下：<br><br>1. 访问 [beammp.com](https://beammp.com/)<br>2. 点击 *Download Now（立即下载）*<br>3. 运行安装程序并按照提示进行操作

 ```
-!!! 注意
+::: 注意

 截至 2026 年 4 月 1 日，Windows Defender SmartScreen 会将该 MSI 安装程序识别为“未知应用”。

@@ -16,10 +16,11 @@

 === 我需要帮助！我的授权密钥 (authkey) 失效了！<br><br>截至 2026 年 4 月 1 日，Keymaster 和认证系统处于离线状态。这意味着您的 authkeys 将无法正常工作。若要解决此问题，请按照以下步骤操作：<br><br>1. 打开您的 ``ServerConfig.toml`` 文件，或任何存放服务器配置的地方。<br>2. 将 ``Private`` 设置为 ``true``。设置后应如下所示：``Private = true``。<br>3. 这应该能解决 authkey 的失效问题。

-```
-!!! 注意
+::: note

 截至 2026 年 4 月 1 日，BeamMP 的认证系统处于离线状态。目前仅支持游客账号（Guest accounts）登录。

 请确保您的服务器已开启游客访问权限。
+
+:::
 ```
@@ -1,4 +1,4 @@
-!!! warning "本页面正在建设中！"
+::: warning "本页面正在建设中！"

 ```
 本站点目前正处于积极开发与维护阶段。
@@ -1,4 +1,4 @@
-!!! warning "本页面正在建设中！"
+::: warning "本页面正在建设中！"

 ```
 本站点目前正处于积极开发与维护阶段。
@@ -1,4 +1,4 @@
-!!!警告“此网站正在建设中!”
+:::警告“此网站正在建设中!”

 ```
 这个网站正在积极建设中。
@@ -1,4 +1,4 @@
-!!! warning "本页面正在建设中!"
+::: warning "本页面正在建设中!"

 ```
 本站点目前正处于积极开发与维护阶段。
@@ -1,4 +1,4 @@
-!!! warning "本页面正在建设中！"
+::: warning "本页面正在建设中！"

 ```
 本站点目前正处于积极开发与维护阶段。
@@ -1,4 +1,4 @@
-!!! warning "本页面正在建设中！"
+::: warning "本页面正在建设中！"

 ```
 本站点目前正处于积极开发与维护阶段。
@@ -199,13 +199,13 @@ guihooks.trigger("ConfirmationDialogClose", "示例标题")

 可以同时显示多个，并将按顺序排列显示。

-!!! bug
+::: bug

 ```
 如果不提供任何按钮，玩家将无法在不使用控制台的情况下关闭或退出该对话框。
 ```

-!!! bug
+::: bug

 ```
 当 ConfirmationDialog（确认对话框）处于活动状态时，迷你地图UI应用的 SDF 部分仍然保持可见。
@@ -243,7 +243,7 @@ guihooks.trigger("introPopupClose")
 - `noButtons`
    - 不提供任何按钮

-!!! 警告
+::: warning

 ```
 如果在页面中使用noButtons类型，且页面内容中没有提供额外的 JavaScript 来关闭该弹出窗口，则会导致游戏出现Softlock。在此类型下，多个页面不会合并到同一个弹出窗口中。因此，不建议使用此类型。
@@ -287,7 +287,7 @@ guihooks.trigger("introPopupClose")

 如果提供了多个页面，或者该Hook被多次触发，这些页面将被合并到同一个弹出窗口中。<br>如果在一个introPopup处于活动状态时触发了该钩子，或者已经触发了另一种不同类型的introPopup，那么它将在当前窗口关闭后，通过一个独立的弹出窗口进行显示。

-!!! bug
+::: bug

 ```
 背景模糊具有最小高度限制，这会导致内容较少的弹出窗口在其窗口下方出现多余的模糊区域。目前主要有两种解决方法：
@@ -332,7 +332,7 @@ guihooks.trigger("introPopupClose")

 如果提供了多个页面，或者该Hook被多次触发，这些页面将合并到同一个弹出窗口中。<br>如果在一个introPopup处于活动状态时触发了该钩子，或者已经触发了另一种不同类型的 introPopup，则它会在当前窗口关闭后，通过一个独立的弹出窗口进行显示。

-!!! bug
+::: bug

 ```
 背景模糊具有最小高度限制，这会导致内容较少的弹出窗口在其窗口下方出现多余的模糊区域。目前主要有两种解决方法：
@@ -1,4 +1,4 @@
-!!!警告“该网站正在建设当中！“
+::: warning "该网站正在建设当中！"

 ```
 该网站仍在积极开发中。
@@ -8,6 +8,8 @@
 这也可以在任何页面上完成。
 ```

+:::
+
 # BeamNG.drive 代码的片段

 ## Lua代码片段
@@ -197,13 +199,13 @@ guihooks.trigger("ConfirmationDialogClose", "Example Title")

 可以同时显示多个，并将按顺序依次呈现。

-!!! bug
+::: bug

 ```
 不提供任何按钮会导致玩家在不使用控制台的情况下无法退出该对话框。
 ```

-!!! bug
+::: bug

 ```
 当 **ConfirmationDialog**（确认对话框）处于活动状态时，小地图 (Minimap) UI 插件的 **SDF 部分** 依然保持可见。
@@ -241,7 +243,7 @@ Flavours控制显示的按钮类型。共有四种预设模式：
 - `noButtons`
    - Provides no buttons

-!!! 警告
+::: warning

 ```
 当页面使用noButtons模式时，如果页面内容中未提供用于关闭弹出窗口的额外 JavaScript 代码，则会导致软锁定。在这种模式下，多个页面不会合并到同一个弹出窗口中。因此，不建议使用该模式。
@@ -285,7 +287,7 @@ guihooks.trigger("introPopupClose")

 如果提供了多个页面，或者该hook被多次触发，这些页面将合并到同一个弹出窗口中。<br>如果在introPopup处于活动状态时触发了hook，或者已经触发了另一种类型的introPopup，则新内容将在当前弹出窗口关闭后，以独立的弹出窗口形式显示。

-!!! bug
+::: bug

 ```
 背景模糊具有最小高度限制，这会导致内容较短的弹出窗口下方出现多余的模糊区域。目前主要有两种规避方案：
@@ -330,7 +332,7 @@ guihooks.trigger("introPopupClose")

 如果提供了多个页面，或者该hook被多次触发，这些页面将合并到同一个弹出窗口中。<br>如果在introPopup处于活动状态时触发了hook，或者已经触发了另一种类型的introPopup，则新内容将在当前弹出窗口关闭后，以独立的弹出窗口形式显示。

-!!! bug
+::: bug

 ```
 背景模糊具有最小高度限制，这会导致内容较短的弹出窗口在其窗口下方出现多余的模糊区域。目前主要有两种规避方案：
@@ -366,7 +368,7 @@ ui_missionInfo.closeDialogue()

 同时只能显示一个Dialogue。任何现有的Dialogue都会被直接覆盖。

-!!! info
+::: info

 ```
 `#!lua ui_missionInfo.closeDialogue()` 必须使用该函数来关闭对话框。
@@ -9,37 +9,37 @@ hide:

 ## 我们的社交媒体链接

-!!!failure ""
+:::failure ""

 ```
 BeamMP Forum - [https://forum.beammp.com](https://forum.beammp.com)
 ```

-!!!quote ""
+:::quote ""

 ```
 X (Twitter) - [https://x.com/BeamMPOfficial](https://x.com/BeamMPOfficial)
 ```

-!!!danger ""
+:::danger ""

 ```
 YouTube - [https://www.youtube.com/@BeamMPOfficial](https://www.youtube.com/@BeamMPOfficial)
 ```

-!!!warning ""
+:::warning ""

 ```
 Patreon - [https://www.patreon.com/c/BeamMP](https://www.patreon.com/c/BeamMP)
 ```

-!!!note ""
+:::note ""

 ```
 Discord - [https://discord.com/invite/beammp](https://discord.com/invite/beammp)
 ```

-!!!info ""
+:::info ""

 ```
 BlueSky - [https://bsky.app/profile/beammpofficial.bsky.social](https://bsky.app/profile/beammpofficial.bsky.social)
@@ -4,9 +4,8 @@

 BeamMP与Windows和Linux完全兼容，与MacOS的兼容性正在研究中。然而，Linux和MacOS都是次要平台，这意味着bug在所难免。

-!!!警告
+::: warning

-```
 BeamMP将无法与盗版或过时版本的BeamNG.drive一起工作。
 BeamMP支持团队不提供盗版/过期副本问题的支持。
 ```
@@ -17,9 +16,8 @@ BeamMP支持团队不提供盗版/过期副本问题的支持。

 ### **2a. Windows 安装**

-!!!注意
+::: note

-```
 截至 2026 年 4 月 1 日，Windows Defender SmartScreen 会将该 MSI 安装程序识别为“未知应用”。

 若要跳过此警告，请点击“更多信息”，然后点击“仍要运行”。
@@ -29,9 +27,8 @@ BeamMP支持团队不提供盗版/过期副本问题的支持。
 2. 运行 `BeamMP_Installer.msi`安装程序并按照提示进行操作。
 3. BeamMP启动器的图标应该会出现在您的桌面上。如果没有出现，只需在 Windows 搜索栏中搜索“BeamMP”即可。

-!!!注意
+::: note

-```
 当你加载到一个有多个车辆的地图时，它可能需要比预期更长的时间才能加入。
 ```

@@ -88,19 +85,17 @@ cmake . -B bin -DCMAKE_TOOLCHAIN_FILE=$VCPKG_ROOT/scripts/buildsystems/vcpkg.cma
 cmake --build bin --parallel
 ```

-!!!注意 ""
+::: note

-```
 如果在编译时内存耗尽，可以提交——parallel指令，由于只在一个CPU线程上编译，它将使用更少的RAM。
 ```

-!!!注意 ""
+::: note

-```
 通过不指定‘ -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 配置命令。
+:::注意 "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`移出，放到它自己的文件夹中，然后从该文件夹运行它：

@@ -133,7 +128,7 @@ cd ~/beammp-launcher

 请注意：此配置默认假设您已将编译完成的启动器二进制文件存放于`/home/user/BeamMP/`。请根据实际二进制文件存放路径调整配置，且每次启动器版本更新时需切换至官方Git仓库对应分支重新执行编译流程。

-!!! 提示 "安装表情符号字体实现文本内嵌表情"
+::: 提示 "安装表情符号字体实现文本内嵌表情"

 ```
 若需在服务器列表（作为服务器自定义名称组成部分）或游戏内聊天中显示表情符号，您需部署包含表情符号的字形库。例如，可通过安装Windows Segoe UI 表情符号字体的 Linux 移植版实现。
@@ -25,10 +25,11 @@

 如果禁用，物理不稳定性将导致游戏暂停

-!!! 注意 ""
+::: note

 建议设置为禁用，因为反复的不稳定会导致游戏崩溃
-```
+
+:::

 ??? 设置 “可用时使用简化车辆”

@@ -45,10 +46,11 @@

 如果禁用，游戏内聊天将显示在UI应用程序中

-!!! 注意 ""
+::: note

 将IMGUI窗口拖出主游戏窗口可能会导致性能问题，还会诱使屏幕录制软件录制聊天窗口而不是主游戏窗口
-```
+
+:::

 ??? 设置 “启用车辆位置平滑”

@@ -97,10 +99,11 @@

 如果禁用，其他车辆将保持完全可见，无论距离

-!!! 注意 ""
+::: note

-这只会影响车辆的可见3d网格，而不会影响其物理节点-光束网格。为了禁用物理，你需要在游戏设置中启用“简化碰撞物理”
-```
+这只会影响车辆的可见3d网格，而不会影响其物理节点-光束网格。为了禁用物理，你需要在游戏设置中启用"简化碰撞物理"
+
+:::

 ???  设置 “显示玩家ID”

@@ -241,13 +244,13 @@
 ??? 设置 "淡出距离/反转标签淡出方向"

 ```
-!!! 设置 "淡出"
+::: info "淡出"

    玩家离得越远，标签就越不显眼

 '渐变距离'定义了标签在最小不透明度下绘制的距离

-!!! 设置 "淡入"
+::: info "淡入"

    玩家离得越远，标签就越显眼

@@ -294,23 +297,23 @@
 如果启用，则将在控制台中显示beamMP网络活动

 如果禁用，则控制台中不会显示进一步的网络活动
-!!! 风险 ""
+::: danger

   要小心这个设置，因为所有控制台输出也会写入日志文件

 启用此设置后，它们可以在几分钟内增长数百MB
-```
+
+:::

 ??? 设置 "启动器端口"

-```
 此设定值定义用于与启动器通信的端口

 只有标准端口4444不能使用时才需要更改吗

-不要忘记在启动器侧修改它，通过修改‘ launcher.cfg ’
+不要忘记在启动器侧修改它，通过修改' launcher.cfg '

-!!! 提示 ""
+::: info

    指定的端口只是两个中的第一个，第二个正在使用的端口紧随其后，设置port + 1

@@ -4,7 +4,7 @@ description: 这组页面为BeamMP提供了一些基本指南
 status: 新的
 ---

-!!! 警告"这个网站正在建设中！"
+::: warning "这个网站正在建设中！"

 ```
 This site is being actively worked on.
@@ -27,7 +27,7 @@ Server目录需创建多个子文件夹存放各服务端模组。推荐只在

 Client目录专门存放将发送给客户端的ZIP格式模组包，当客户端接收后会自动以模组形式加载。该目录若存在其他类型文件会导致服务器启动时报错（但不会阻断服务运行），不过这些无关文件仅会被服务端忽略。核心配置脚本modScript.lua由BeamNG游戏引擎解析，用于指引游戏加载指定插件模块。

-!!!范例 "" [Download the examplePlugin.zip](../../../../assets/content/ResourcesForExamplePlugin.zip)
+:::范例 "" [Download the examplePlugin.zip](../../../../assets/content/ResourcesForExamplePlugin.zip)

 ## 服务器端 lua

@@ -1,24 +1,48 @@
 ---
-hide:
-  - 导航
+layout: home
+
+hero:
+  name: BeamMP 文档
+  text: 你需要知道的一切
+  tagline: 为玩家、服务器所有者和开发者提供的完整指南
+  image:
+    src: /assets/core/beammp_dark.png
+    alt: BeamMP
+  actions:
+    - theme: brand
+      text: 开始
+      link: /zh/game/getting-started
+    - theme: alt
+      text: 在 GitHub 上查看
+      link: https://github.com/beammp/docs
+
+features:
+  - icon: 🎮
+    title: 对于玩家
+    details: 了解如何安装 BeamMP、连接到服务器并充分享受您的多人游戏体验
+    link: /zh/game/getting-started
+  - icon: 🖥️
+    title: 对于服务器所有者
+    details: 通过我们全面的指南和故障排除资源来设置和管理您自己的 BeamMP 服务器
+    link: /zh/server/create-a-server
+  - icon: 💻
+    title: 对于开发者
+    details: 使用详细的 API 文档和代码示例创建 mod、资源和 UI 应用
+    link: /zh/guides/index
+  - icon: ❓
+    title: 常见问题
+    details: 找到关于设置、故障排除和最佳实践的常见问题的快速答案
+    link: /zh/FAQ/player-faq
+  - icon: 📋
+    title: 社区规则
+    details: 了解我们的社区指南以及如何报告问题或上诉决定
+    link: /zh/community/rules
+  - icon: 🔗
+    title: 社区
+    details: 加入我们的 Discord、在社交媒体上关注我们并与其他 BeamMP 玩家和开发者连接
+    link: /zh/community/index
 ---

-!!!警告“该网站正在建设当中！“
-
-```
-这个网站正在积极建设中。
-
-觉得你能帮上忙吗？请用铅笔在右侧点击页面！
-
-这也可以在任何页面上完成。
-```
-
-# 欢迎来到BeamMP文档！:tada:
-
-欢迎来到全新改进的BeamMP文档中心！无论您是玩家，服主，还是开发者，我们都能为您提供增强BeamNG.drive多人游戏体验所需的资源。
-
-## 对于玩家
-
 首次体验BeamMP联机模组？请访问我们的[新手启航指南](../game/getting-started.md)，助您迅速完成配置部署，畅享多人模式下的高拟真驾驶盛宴。若遇基础性问题，建议优先查阅[玩家常见问题解答](../FAQ/player-faq.md)中的故障排查方案

 ## 对于服主
@@ -0,0 +1,57 @@
+{
+  "Home": "首页",
+  "Support": "支持",
+  "Playing BeamMP": "游玩 BeamMP",
+  "Installing BeamMP": "安装 BeamMP",
+  "Error Codes": "错误代码",
+  "Multiplayer Settings": "多人模式设置",
+  "Running a BeamMP-Server": "运行服务器",
+  "Server Installation": "服务器端的安装",
+  "Port Forwarding": "端口转发",
+  "Server Maintenance": "服务器维护",
+  "Server Manual": "服务器手册",
+  "Mod & Resource Creation": "模组与资源制作",
+  "Client Side": "客户端",
+  "Server Side": "服务器端",
+  "FAQ": "常见问题解答",
+  "How to check for CGNAT?": "如何检查CGNAT?",
+  "Where can I find my IP address?": "我怎样才能找到我服务器的IP？",
+  "How to remove mods?": "如何删除模组？",
+  "Manually updating the Launcher": "手动更新启动器",
+  "Changing the Launcher port": "更改启动器端口",
+  "Creating Exclusions (Defender)": "创建 Defender 排除项",
+  "Player FAQ": "面向玩家的疑难解答",
+  "Game FAQ": "游戏常见问题",
+  "Server FAQ": "服务器常见问题",
+  "Development Guides": "开发指南",
+  "Development Environment Setup": "开发环境设置",
+  "Mod Creation": "模组制作",
+  "Resource Creation": "资源制作",
+  "Client Scripting Reference": "客户端脚本参考",
+  "Server Resources": "服务器资源",
+  "BeamNG Documentation": "BeamNG.drive 文档",
+  "Content Development": "内容开发",
+  "Introduction": "介绍",
+  "Programming": "编程",
+  "UI Apps (HTML)": "图形界面应用程序（HTML）",
+  "ImGui Window Tutorial": "ImGui 窗口教程",
+  "Lua Mods (Scripts)": "Lua 模组（脚本）",
+  "Content": "内容",
+  "Maps": "地图",
+  "Props": "道具",
+  "Vehicles": "车辆",
+  "Lua Code Snippets": "Lua 代码片段",
+  "CSS Code Snippets": "CSS 代码片段",
+  "ImGui Code Snippets": "ImGui 代码片段",
+  "CEF Code Snippets": "CEF 代码片段",
+  "Scripting Reference": "脚本参考",
+  "Mod (In-Game)": "游戏内模组",
+  "Server": "服务器",
+  "Version 3.X (Latest)": "版本 3.X（最新）",
+  "Version 2.X (Deprecated)": "版本 2.X（已弃用）",
+  "Contributing": "参与贡献",
+  "Getting Started": "快速开始",
+  "Community": "社区",
+  "General Information": "一般信息",
+  "Rules": "规则"
+}
@@ -1,4 +1,4 @@
-!!! 警告 "这个网站正在建设中！"
+::: warning "这个网站正在建设中！"

 ```
 这个网站正在积极建设中。
@@ -1,4 +1,4 @@
-!!! 警告 "这个网站正在建设中！"
+::: warning "这个网站正在建设中！"

 ```
 这个网站正在积极建设中。
@@ -1,4 +1,4 @@
-!!! 警告 "这个网站正在建设中！"
+::: warning "这个网站正在建设中！"

 ```
 这个网站正在积极建设中。
@@ -12,7 +12,7 @@

 ## 服务器端版本 2.X

-!!! 警告
+::: warning

 ```
 BeamMP 服务器版本 2.X 已不再提供支持。
@@ -26,13 +26,13 @@

 ### **1. 端口转发**

-!!! info
+::: info

 ```
 如果你使用的是 VPS（虚拟专用服务器）、Rootserver，或者计划在本地托管服务器（与家里其他玩家在同一屋檐下），可以跳过此步骤。
 如果你希望家外的人加入你本地托管的服务器（即在本地网络之外），则必须执行此步骤。

-!!! danger ":material-scale-balance: 免责声明："
+::: danger ":material-scale-balance: 免责声明："

    **端口转发存在风险**.

@@ -74,11 +74,11 @@

 ‘认证密钥’，通常称为 ‘AuthKey’，是使 **公共** 服务器可以通过服务器列表访问所必需的。虽然也建议将 AuthKey 添加到私人服务器。你拥有的密钥数量有限。一个密钥一次只能用于一台服务器，因此不能用同一个密钥同时启动两台服务器。通过支持该项目可以获得更多密钥。更多信息请参阅 [这篇文章](https://docs.beammp.com/support/player-faq/)。

-!!! 警告
+::: warning

-```
 千万不要把密钥给别人看，把它当作密码！
-```
+
+:::

 此步骤需要一个 [Discord](https://discord.com) 账号。此举是为了防止垃圾信息。

@@ -181,7 +181,7 @@ Description = "Total Random Beam MP Server"
 ResourceFolder = "Resources"
 ```

-!!! info
+::: info

 ```
 这是您的配置文件。它采用了一种名为 TOML的格式。有关该文件及其变量的更多信息，请参考 [Server Maintenance（服务器维护）](server-maintenance.md) 章节。
@@ -211,7 +211,7 @@ AuthKey = '3173a2e-6az0-4542-a3p0-ddqq5ff95558'

 车辆模组和地图模组的安装方式不同，但都需要将它们放入服务器的 (`Resources/Client`) 文件夹中。只需将你想添加的模组放入该文件夹即可。

-!!! 警告
+::: 警告

 ```
 如果在添加模组后尝试加入服务器时收到“done”或“start”消息，很可能是因为你向服务器添加了不兼容或损坏的模组。
@@ -275,12 +275,12 @@ Map = '/levels/myawesomedriftmap2021/info.json'
  <input type="submit" value="CheckBeamMP">
 </form>

-!!! warning "我想使用 RadminVPN、Hamachi 或类似的 VPN。"
+::: warning "我想使用 RadminVPN、Hamachi 或类似的 VPN。"

 ```
 BeamMP 不支持这些 VPN，因为它们经常引发问题。其中一个问题是 UDP 流量无法转发。要解决此问题，请参考第 1 节。

-!!! question "那为什么以前可以用？"
+::: question "那为什么以前可以用？"

    这是因为这些应用程序的开发者更新了软件并实施了 BeamMP 无法控制的更改。
 是否支持像 BeamMP-Server 这样的特定使用场景，由这些应用程序的开发者决定。
@@ -17,4 +17,4 @@
 10064 | 主机宕机 | 罕见错误，但表示主机已宕机，可能是因为主机已关闭或端口被关闭。
 10065 | 无法访问主机 | 无网络或端口转发错误，请参考 [指南步骤](create-a-server.md#1-port-forwarding)。

-!!! note “对于本列表中未包含的任何其他错误代码，如果你对网络/套接字有一定了解，可以参考 [https://learn.microsoft.com/en-us/windows/win32/winsock/windows-sockets-error-codes-2](https://learn.microsoft.com/en-us/windows/win32/winsock/windows-sockets-error-codes-2)。
+::: note “对于本列表中未包含的任何其他错误代码，如果你对网络/套接字有一定了解，可以参考 [https://learn.microsoft.com/en-us/windows/win32/winsock/windows-sockets-error-codes-2](https://learn.microsoft.com/en-us/windows/win32/winsock/windows-sockets-error-codes-2)。
@@ -1,6 +1,6 @@
 # 端口转发

-!!! 风险 ":material-scale-balance: 免责声明："
+::: danger ":material-scale-balance: 免责声明："

 ```
 “端口转发存在风险”。
@@ -12,7 +12,7 @@
 <u>如果你不理解本指南，请考虑使用我们的合作伙伴提供的服务。</u>
 ```

-!!! 警告
+::: warning

 ```
 请确保你的路由器不是仅支持 4G/5G 的设备。如果是混合设备，请在本指南第 3 节中选择有线连接的适配器！
@@ -104,7 +104,11 @@ ipconfig /all

 子网掩码（常见取值为255.255.255.0）  <br>默认路由地址（典型配置为192.168.0.1或192.168.1.1）

-!!! info "请注意" BeamMP 目前不支持使用 IPv6 协议托管服务器。
+::: info "请注意"
+
+BeamMP 目前不支持使用 IPv6 协议托管服务器.
+
+:::

 #### 1.2. 修改适配器设置

@@ -181,7 +185,11 @@ admin | password

 BeamMP 需要同时开放 UDP 和 TCP 协议的 30814 端口（除非您已在 [ServerConfig.toml](create-a-server.md#4-configuration) 配置文件中修改过此端口）。

-!!! info "注意"  <br>虽然默认端口为 **30814**，您也可以选择1024至65535之间的其他端口号（若使用非默认端口需自行记录）。需要同时转发 **TCP** 和 **UDP** 协议。  <br>建议保持使用默认端口，因此端口被本机其他服务占用的可能性极低。若需在同一台机器上部署多个服务器，则每个服务器需使用不同端口（例如：服务器1使用30814，服务器2使用30815）。
+::: info "注意"
+
+虫然默认端口为 **30814**，您也可以选择1024至20敓5之间的其他端口号（若使用非默认端口需自行记录）。需要同时转发 **TCP** 和 **UDP** 协议。建议保持使用默认端口，因此端口被本机其他服务占用的可能性极低。若需在同一台机器上部署多个服务器，则每个服务器需使用不同端口（例如：服务器ᴄ1使用30814，服务器ᴄ2使用30815）.
+
+:::

 在某些路由器中，您可能需要创建两条规则（一条用于UDP，另一条用于TCP），而有些路由器则更便捷，允许您通过单条规则同时设置两种协议！

@@ -205,13 +213,13 @@ BeamMP 需要同时开放 UDP 和 TCP 协议的 30814 端口（除非您已在 [

 访问以下链接，并将“IP”替换为您的实际IPv4地址，“Port”替换为您的服务器端口。请确保不留空格。https://check.beammp.com/api/v2/beammp/ip/port

-!!! 成功 "status: ok"
+::: success "status: ok"

 ```
 若获得上述输出结果，即可加入您的服务器！ 有两种连接方式：既可通过在端口转发工具中配置的详细信息直接连接，也可在服务器设置为"公开"状态下通过服务器列表加入。 由于您采用的是本地托管服务器，若服务器与游戏运行在同一台电脑上，请使用 127.0.0.1（本地主机）；若服务器运行在局域网内的其他机器上，则使用该服务器的局域网IPv4地址。
 ```

-!!! 失败 "status: error"
+::: failure "status: error"

 ```