diff --git a/docs/de/community/index.md b/docs/de/community/index.md
new file mode 100644
index 00000000..41789747
--- /dev/null
+++ b/docs/de/community/index.md
@@ -0,0 +1,50 @@
+---
+hide:
+  - navigation
+---
+
+# Willkommen im BeamMP Gemeinschafts-Bereich!
+
+![BeamMP mehrfarbig-weiß](../../assets/content/BeamMP-Multi-WhtLtr-crop.png#only-dark){width="450"} ![BeamMP mehrfarbig-schwarz](../../assets/content/BeamMP-Multi-BlkLtr-crop.png#only-light){width="450"}
+
+## Unsere Social Media-Links
+
+!!!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)
+```
+
+## Regeln
+
+Unsere Regeln findest du [hier](rules.md)
diff --git a/docs/de/game/getting-started.md b/docs/de/game/getting-started.md
index 5632550e..820c51b0 100644
--- a/docs/de/game/getting-started.md
+++ b/docs/de/game/getting-started.md
@@ -29,21 +29,43 @@ BeamMP ist vollständig kompatibel mit Windows und Linux, an der Kompatibilität
 
 ### **2b. Linux Installation**
 
-Derzeit musst du den Launcher selbst erstellen. Dazu benötigst du grundlegende Kenntnisse zum Erstellen einer Anwendung.
+Derzeit musst du den Launcher selbst kompilieren (erstellen). Dazu benötigst du grundlegende Kenntnisse über den Prozess der Erstellung einer Anwendung (Kompilierung).
 
-Stelle sicher, dass [`vcpkg`](https://learn.microsoft.com/en-us/vcpkg/get_started/get-started?pivots=shell-bash#1---set-up-vcpkg) sowie grundlegende Entwicklungstools installiert sind, welche oft in Paketen enthalten sind, zum Beispiel:
+Stelle sicher, dass grundlegende Entwicklungstools (Build-Tools) installiert sind, die oft in folgenden Paketen enthalten sind:
 
 - Debian: `sudo apt install build-essential`
-- Fedora: `sudo dnf install cmake gcc-c++ perl-IPC-Cmd perl-FindBin perl-File-Compare perl-File-Copy`
+- 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` (Du musst auch `sudo steamos-readonly disable` ausführen, schalte es jedoch nach der Installation wieder ein)
 
-Klone das BeamMP-Launcher-Repository mit `git` auf dein System, zum Beispiel: `git clone https://github.com/BeamMP/BeamMP-Launcher.git` [Weitere Informationen zum Klonen eines GitHub-Repos](https://docs.github.com/en/repositories/creating-and-managing-repositories/cloning-a-repository)
 
-Lade das "Tag", das für die [neueste Version](https://github.com/BeamMP/BeamMP-Launcher/releases/latest) verwendet wurde. Wenn beispielsweise `v2.3.2` in der neuesten Version verwendet wird, führe `git checkout v2.3.2` aus.
+Klone vcpkg, initialisiere es und füge es zur PATH-Umgebungsvariable hinzu.
 
-Im Stammverzeichnis des Projekts, führe aus:
+1.
+```bash
+git clone https://github.com/microsoft/vcpkg.git
+```
+
+2.
+```bash
+./vcpkg/bootstrap-vcpkg.sh
+```
+
+3.
+```bash
+export VCPKG_ROOT="$(pwd)/vcpkg"
+export PATH=$VCPKG_ROOT:$PATH
+```
+
+
+Klone das BeamMP-Launcher-Repository mit `git` auf dein System, zum Beispiel:
+`git clone https://github.com/BeamMP/BeamMP-Launcher.git`
+[Weitere Informationen zum Klonen eines GitHub-Repos](https://docs.github.com/en/repositories/creating-and-managing-repositories/cloning-a-repository)
+
+Wechsle zum neuesten "Tag" (Versionsstand). Lade das "Tag" herunter, das für die neueste Version verwendet wurde. Wenn beispielsweise v2.3.2 in der neuesten Version verwendet wird, führe im Repository-Ordner `git checkout v2.3.2` aus.
+
+Führe im Stammverzeichnis des Projekts folgende Schritte aus:
 
 1.
 ```cmake
@@ -61,9 +83,26 @@ cmake --build bin --parallel
 
 !!!note ""
 
-    Wenn du -DCMAKE_BUILD_TYPE=Release nicht spezifizierst, erstellst du eine Debug-Version, die zwar eine größere Dateigröße hat, aber nicht den Fehler „Launcher kann sich nur einmal mit einem Server verbinden“ enthält.
+    Wenn du -DCMAKE_BUILD_TYPE=Release nicht spezifizierst, erstellst du eine Debug-Version, die zwar eine größere Dateigröße hat, aber nicht den Fehler „Launcher kann sich nur einmal mit einem Server verbinden" enthält.
 
-Verschiebe die fertige Anwendung aus dem `/bin` Ordner in einen eigenen Ordner und führe sie von dort aus aus.
+!!!note "Fedora Benutzer"
+    Wenn vcpkg während der OpenSSL-Kompilierung aufgrund von Kernel-Header-Fehlern fehlschlägt, stelle sicher, dass alle Abhängigkeiten installiert sind:
+    ```bash
+    sudo dnf install kernel-headers kernel-devel gcc gcc-c++ make perl
+    ```
+    Bereinige dann den vcpkg-Cache:
+    ```bash
+    rm -rf $VCPKG_ROOT/buildtrees/openssl
+    ```
+    Und wiederhole den cmake-Konfigurationsbefehl (Schritt 1).
+
+Verschiebe die fertige Anwendung aus dem `/bin` Ordner in einen eigenen Ordner und führe sie von dort aus aus:
+```bash
+mkdir -p ~/beammp-launcher
+cp bin/BeamMP-Launcher ~/beammp-launcher/
+cd ~/beammp-launcher
+./BeamMP-Launcher
+```
 
 Der native Linux BeamMP-Launcher wird gestartet und verwendet das native Linux BeamNG.drive
 
@@ -98,7 +137,7 @@ Beachte, dass hierbei davon ausgegangen wird, dass die Binärdatei des Launchers
 ## **3. Bekannte Probleme**
 
 - Der native Linux BeamMP-Launcher kann sich derzeit nur einmal mit einem Server verbinden, nach dem Trennen der Verbindung muss der Launcher neu gestartet werden. Dies ist möglich, ohne das Spiel zwischendurch schließen zu müssen.
-- Wenn die Schaltfläche „Multiplayer“ nicht angezeigt wird, stelle sicher, dass der BeamMP-Mod im „Mod Manager“ vorhanden und aktiviert ist, und drücke dann STRG + L.
+- Wenn die Schaltfläche „Multiplayer" nicht angezeigt wird, stelle sicher, dass der BeamMP-Mod im „Mod Manager" vorhanden und aktiviert ist, und drücke dann STRG + L.
 - VPNs jeglicher Art können Verbindungsprobleme verursachen.
 - Wenn der Launcher Fehler meldet, lies die [FAQ](https://forum.beammp.com/c/faq/35) .
 
diff --git a/docs/en/FAQ/player-faq.md b/docs/en/FAQ/player-faq.md
index d87bb19e..94659e0c 100644
--- a/docs/en/FAQ/player-faq.md
+++ b/docs/en/FAQ/player-faq.md
@@ -1,8 +1,7 @@
 # Players FAQ
 
 ## How do I link my Discord account?
-Linking your Discord and BeamMP account is a new feature to BeamMP. To do this you will need send `!link` as a message to the [BeamMP Accounts](https://discordapp.com/channels/@me/1201234743568634026/) bot.
-The bot will respond with a link for you to sign into your BeamMP account. Simply sign in with your BeamMP account, once done you will receive a second message saying that it has successfully linked your accounts. 🎉
+Linking your Discord and BeamMP account is a new feature to BeamMP. To do this go to your [Forum Account Preferences](https://forum.beammp.com/my/preferences/account) and connect your Discord account under "Associated Accounts" (this is only visible when 2FA for the forum is disabled).
 
 ## How do I get early access?
 
@@ -14,7 +13,7 @@ Boosting gives you +4 Server keys in addition to EA benefits.
 
 Please ensure you do the following to automatically receive your perks:
 
-1. Link your Discord account on Patreon to receive the Roles and Access in the Discord server.
+1. Link your Discord account on [Patreon](https://www.patreon.com/settings/apps/discord) to receive the Roles and Access in the Discord server.
 2. Please ensure you use the same email address on Patreon as you do for your BeamMP account on the [Forum](https://forum.beammp.com/).
 
 Please be patient, it can take a few hours, sometimes up to 12, for the system to sync. If you have not received your perks after 12 hours and have completed the above steps please contact BeamMP support.
diff --git a/docs/en/game/getting-started.md b/docs/en/game/getting-started.md
index db5a480b..0d6d9360 100644
--- a/docs/en/game/getting-started.md
+++ b/docs/en/game/getting-started.md
@@ -34,8 +34,8 @@ In order to do this, you need a basic understanding of how to build an applicati
 
 Make sure you have basic development tools installed, often found in packages, for example:
 
-- Debian: `sudo apt install build-essential`
-- Fedora: `sudo dnf install cmake gcc-c++ perl-IPC-Cmd perl-FindBin perl-File-Compare perl-File-Copy`
+- 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)
@@ -66,6 +66,9 @@ Clone the BeamMP-Launcher Repository to your system using `git`, for example:
 
 Checkout the tag that was used for the [latest release](https://github.com/BeamMP/BeamMP-Launcher/releases/latest). For example, if `v2.6.4` is used in the latest release, then do `git checkout v2.6.4`
 
+
+If you've used the example clone command we provided, you can use `cd BeamMP-Launcher` to go to the project's root directory.
+
 In the root directory of the project,
 
 1. 
@@ -86,9 +89,26 @@ cmake --build bin --parallel
 
       By not specifying `-DCMAKE_BUILD_TYPE=Release` you are building a debug version, which is larger in filesize but does not contain the launcher-can-only-connect-to-a-server-once bug
 
-Move the finished application out of the `/bin` folder into its own folder and run it from there
+!!!note "Fedora Users"
+    If vcpkg fails during OpenSSL compilation with kernel headers errors, ensure all dependencies are installed:
+    ```bash
+    sudo dnf install kernel-headers kernel-devel gcc gcc-c++ make perl
+    ```
+    Then clean the vcpkg cache:
+    ```bash
+    rm -rf $VCPKG_ROOT/buildtrees/openssl
+    ```
+    And retry the cmake configuration command.
 
-The native linux BeamMP-Launcher will start and use native linux BeamNG.drive
+Move the finished application out of the `/bin` folder into its own folder and run it from there:
+```bash
+mkdir -p ~/beammp-launcher
+cp bin/BeamMP-Launcher ~/beammp-launcher/
+cd ~/beammp-launcher
+./BeamMP-Launcher
+```
+
+The native Linux BeamMP-Launcher will start and use native Linux BeamNG.drive
 
 ### **2c. Using beamNG.drive with Proton**
 
diff --git a/docs/en/server/create-a-server.md b/docs/en/server/create-a-server.md
index ad3facec..b15dd337 100644
--- a/docs/en/server/create-a-server.md
+++ b/docs/en/server/create-a-server.md
@@ -47,7 +47,7 @@ The setup consists of the following steps, you should follow all of them.
 * [RackGenius](https://rackgeni.us/beammp-plans)
 * [Connect Hosting](https://connecthosting.net/beammp)
 * [Assetto Hosting](https://assettohosting.com/en/games/beamng)
-* [Zap Hosting](https://zap-hosting.com/en/beammp-server-hosting/)
+* [ZAP-Hosting](https://zap-hosting.com/itsbeammp)
 * [HostHavoc](https://hosthavoc.com/)
 * [PedalHost](https://pedal.host/)
 * [Vyper Hosting](https://vyperhosting.com/r/beammp)
@@ -55,6 +55,8 @@ The setup consists of the following steps, you should follow all of them.
 * [Four Seasons Hosting](https://fourseasonshosting.com)
 * [Vertuo Hosting](https://vertuohosting.com)
 * [Winheberg](https://winheberg.fr/offres/gaming/beammp?lang=en)
+* [Wabbanode](https://wabbanode.com/partner/beammp)
+* [Iceline Hosting](https://iceline-hosting.com/games/beammp)
 
 
 #### 1.1 Firewall
diff --git a/docs/ru/FAQ/Defender-exclusions.md b/docs/ru/FAQ/Defender-exclusions.md
new file mode 100644
index 00000000..db381662
--- /dev/null
+++ b/docs/ru/FAQ/Defender-exclusions.md
@@ -0,0 +1,40 @@
+# Как создать исключения в брандмауэре и антивирусе Защитника Windows?
+
+!!! информация
+
+```
+Before tampering with the firewall, make sure that your network within the windows networking settings is set to private (assuming you are in a private network).
+
+!!! danger ":material-scale-balance: DISCLAIMER:"
+
+    **Firewall / Defender exclsuions are a risk**.
+
+    By creating exclsuions, you understand the risks of allowing programs on your PC and opening up ports on your home network to the public and therefore void the right to hold BeamMP accountable for **any and all** damages that may happen to you or your household.
+
+    We take no responsibility for any content on any externally linked services or websites.
+```
+
+## 1. Исключение брандмауэра для BeamMP-Launcher.
+
+1. Откройте `Windows Defender Firewall with advanced setting` .
+2. В окне нажмите `Inbound` , чтобы открыть вкладку исключений для входящих подключений.
+3. Нажмите `Create new rule` в правом верхнем углу, чтобы создать новое исключение.
+4. Выберите `Program` , чтобы создать исключение для конкретной программы.
+5. Введите полный путь к `BeamMP-Launcher.exe` . По умолчанию это будет `%appdata%\BeamMP-Launcher\BeamMP-Launcher.exe` без кавычек.
+6. Обязательно разрешите подключение
+7. Дайте исключению имя (например, «BeamMP-Launcher») и сохраните его.
+8. Перезагрузите компьютер.
+
+## 2. Исключение антивируса для BeamMP-Launcher.
+
+1. Откройте приложение `Windows Security` .
+2. Нажмите на первый пункт `virus and threat protection` .
+3. Нажмите `Manage settings` в разделе «Параметры защиты от вирусов и угроз».
+4. Прокрутите страницу вниз, чтобы перейти на вкладку `Exclusions` .
+5. Там нажмите «Добавить исключение» и выберите `process` .
+6. Введите `BeamMP-Launcher.exe` в поле и сохраните его.
+7. Перезагрузите компьютер.
+
+## Все еще сталкиваетесь с проблемами?
+
+Откройте тему на [форуме](https://forum.beammp.com) или на нашем [сервере Discord](https://discord.gg/beammp) в канале `#support` .
diff --git a/docs/ru/FAQ/How-to-check-for-CGNAT.md b/docs/ru/FAQ/How-to-check-for-CGNAT.md
new file mode 100644
index 00000000..51eaaf48
--- /dev/null
+++ b/docs/ru/FAQ/How-to-check-for-CGNAT.md
@@ -0,0 +1,45 @@
+Как проверить наличие CGNAT?
+
+## Проблема
+
+Все исключения брандмауэра и правила переадресации портов настроены правильно, но никто не может подключиться к вашему домашнему серверу?
+
+Если у вас проблемы с подключением и вы используете Hosting-Service, обратитесь к ним за помощью. Если вы хотите использовать VPS или не можете разместить сервер дома, взгляните на наш [список партнерских хостинговых услуг](../../server/create-a-server/#partnered-hosting-services-paid) (Документация по настройке сервера).
+
+# Что такое CGNAT?
+
+Подробное объяснение того, что такое CGNAT и почему это может стать проблемой при попытке размещения сервера дома, можно найти на [этой странице](https://en.wikipedia.org/wiki/Carrier-grade_NAT) .
+
+# Как проверить наличие CGNAT?
+
+## Метод 1:
+
+Откройте командную строку, запустите `tracert -4 beammp.com` . Это выведет серию сетевых переходов. Дождитесь завершения операции (может занять до 30 переходов). Проверьте первые несколько IP-адресов после IP вашего маршрутизатора/модема/шлюза. Если после первого перехода появляется несколько IP-адресов в диапазоне `100.64.xx` - `100.127.xx` или `10.xx.xx.xx` , скорее всего, вы находитесь за CGNAT.
+
+!!!примечание
+
+```
+The first hop will be your Router/Modem/Gateway and differs between Devices.
+The official ranges for local networks are as follows: ``10.0.0.xxx`` - ``192.168.xxx.xxx`` - ```172.16.xxx.xxx``
+```
+
+## Метод 2:
+
+Узнайте WAN IP на вашем маршрутизаторе, посмотрев его на его интерфейсе. Сравните его с IP, опубликованным, например, на https://whatsmyip.org. Если они НЕ совпадают, вы находитесь за CGNAT.
+
+## Метод 3/Решение:
+
+Обратитесь за помощью к своему интернет-провайдеру. В зависимости от вашего интернет-провайдера, они могут не предлагать выделенные *динамические* IP-адреса. Помните, что статический IP-адрес не является обязательным.
+
+!!! предупреждение
+
+```
+Internet Service Providers may only offer dedicated IP addresses as a **paid option**.
+Please check the prices of our partnered hosting services as they could be cheaper than this fee!
+```
+
+Пример сети, не являющейся CGNAT:
+
+![изображение](https://github.com/user-attachments/assets/fee21a50-cbb0-4322-9c26-d9f04f88ae37)
+
+Теги: Сервер, 10060 10061, CGNAT, Сбой подключения, Переадресация портов, Брандмауэр
diff --git a/docs/ru/FAQ/Update-launcher.md b/docs/ru/FAQ/Update-launcher.md
new file mode 100644
index 00000000..19929aad
--- /dev/null
+++ b/docs/ru/FAQ/Update-launcher.md
@@ -0,0 +1,20 @@
+# Проблема
+
+Launcher не может обновиться или показывает пустой экран? Это краткое руководство объясняет, как вручную обновить Launcher.
+
+!!! примечание
+
+```
+You should have already used or installed BeamMP using the installer provided by [our website](https://beammp.com) before continuing.
+```
+
+# Загрузка и установка нового лаунчера
+
+1. Загрузите последнюю версию Launcher напрямую с [GitHub](https://github.com/BeamMP/BeamMP-Launcher/releases/latest/download/BeamMP-Launcher.exe) .
+2.  Перейдите в каталог BeamMP-Launcher.exe. По умолчанию эта папка находится в `C:\Users\<username>\AppData\Roaming\` . Заменить<username> с именем пользователя вашего Windows. Если вы установили BeamMP в другом месте, например <code>D:\BeamMP-Launcher</code> , то поместите Launcher в соответствующую папку BeamMP-Launcher.</username>
+3.  Если применимо, замените существующий Launcher новым в папке BeamMP-Launcher.
+4.  Запустите BeamMP-Launcher как обычно, чтобы проверить его работу.
+
+## Проблема все еще не решена?
+
+Создайте тикет поддержки на нашем [сервере Discord](https://discord.gg/BeamMP) . Теги: Launcher, скачать,
diff --git a/docs/ru/FAQ/game-faq.md b/docs/ru/FAQ/game-faq.md
new file mode 100644
index 00000000..aecbcd39
--- /dev/null
+++ b/docs/ru/FAQ/game-faq.md
@@ -0,0 +1,64 @@
+# Часто задаваемые вопросы
+
+Список часто задаваемых вопросов.
+
+---
+
+## **Клиент**
+
+---
+
+### **Как установить BeamMP?**
+
+Полное руководство по установке BeamMP на Windows можно найти [здесь](https://docs.beammp.com/game/getting-started/) .
+
+---
+
+### **Работает ли BeamMP на взломанной версии BeamNG?**
+
+BeamMP не будет работать с пиратскими или устаревшими версиями BeamNG.drive. Команда поддержки BeamMP не предлагает поддержку по проблемам с пиратскими / устаревшими копиями.
+
+---
+
+### **Работает ли BeamMP на Linux?**
+
+Клиент официально не поддерживается в Linux. Однако вы можете следовать нашему [руководству по использованию BeamMP в Linux](../game/getting-started/#2b-linux-installation)
+
+---
+
+### **Почему мой антивирус или Защитник Windows помечает лаунчер?**
+
+Некоторые антивирусные программы могут помечать BeamMP как угрозу из-за его взаимодействия с сетью и другими вещами. В коде **нет вирусов** . Код для лаунчера, сервера и клиента lua можно найти на нашем [GitHub](https://github.com/BeamMP) .
+
+---
+
+### **У меня плохая производительность игрового процесса. Что мне делать?**
+
+Мы прилагаем все усилия, чтобы сделать многопользовательский режим максимально стабильным. Если вы уже снизили графические настройки, а производительность все еще низкая, рассмотрите возможность игры на сервере с меньшим количеством игроков. Игра в основном зависит от CPU, когда вы играете с большим количеством людей, поэтому старые CPU (даже четырехъядерные) будут страдать, если людей больше, чем горстка. (Общее практическое правило: 1 машина на поток CPU)
+
+---
+
+## **Разнообразный**
+
+---
+
+### **Где я могу найти код?**
+
+Весь исходный код можно найти на нашем [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/LICENSE)
+Клиент Луа | [ЛИЦЕНЗИЯ](https://github.com/BeamMP/BeamMP/blob/development/LICENSE)
+
+---
+
+### **Я нашел ошибку или эксплойт, что мне делать?**
+
+Если проблема связана с кодом, и вы знаете, как использовать Github, откройте новую «Проблему» в соответствующем репозитории на нашем [GitHub](https://github.com/BeamMP) . Мы используем рабочий процесс, основанный на проблемах, поэтому даже если у вас уже есть исправление ошибки, рассмотрите возможность открытия новой «Проблемы», а затем откройте «Запрос на извлечение» с решениями для проблемы. Более подробную информацию о содействии можно найти [здесь](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) .
diff --git a/docs/ru/FAQ/player-faq.md b/docs/ru/FAQ/player-faq.md
new file mode 100644
index 00000000..d81deb42
--- /dev/null
+++ b/docs/ru/FAQ/player-faq.md
@@ -0,0 +1,22 @@
+# Часто задаваемые вопросы игроков
+
+## Как привязать свой аккаунт Discord?
+
+Связывание аккаунтов Discord и BeamMP — это новая функция BeamMP. Для этого вам нужно отправить `!link` в виде сообщения боту [BeamMP Accounts](https://discordapp.com/channels/@me/1201234743568634026/) . Бот ответит ссылкой для входа в ваш аккаунт BeamMP. Просто войдите в свой аккаунт BeamMP, после этого вы получите второе сообщение о том, что он успешно связал ваши аккаунты. 🎉
+
+## Как получить ранний доступ?
+
+Ранний доступ (включая фиолетовую метку и другие преимущества) можно получить, поддержав нас финансово на [Patreon](https://patreon.com/BeamMP) , купив уровень, сделав пожертвование или ускорив сервер Discord. Пожертвование **x** суммы в долларах США = **x** дополнительных ключей сервера, включая преимущества EA. Ускорение дает вам +4 ключа сервера в дополнение к преимуществам EA.
+
+## Я подписался на Patreon. Как мне получить свои привилегии?
+
+Чтобы автоматически получать бонусы, обязательно выполните следующие действия:
+
+1. Привяжите свой аккаунт Discord к Patreon, чтобы получить роли и доступ на сервере Discord.
+2. Пожалуйста, убедитесь, что вы используете тот же адрес электронной почты на Patreon, что и для вашей учетной записи BeamMP на [форуме](https://forum.beammp.com/) .
+
+Пожалуйста, будьте терпеливы, синхронизация системы может занять несколько часов, иногда до 12. Если вы не получили свои бонусы в течение 12 часов и выполнили вышеуказанные шаги, обратитесь в службу поддержки BeamMP.
+
+## У меня есть еще вопросы!
+
+Если ваш вопрос или проблема связаны с Игрой или процессом, пожалуйста, обратитесь к разделу [FAQ по Играм](game-faq.md) . Если ваш вопрос или проблема связаны с запуском Сервера, пожалуйста, обратитесь к разделу [FAQ по Серверу](server-faq.md) . В противном случае, пожалуйста, посетите [форумы](https://forum.beammp.com/c/faq/35) , где сообщество может задавать вопросы и получать ответы.
diff --git a/docs/ru/beamng/dev/content/maps.md b/docs/ru/beamng/dev/content/maps.md
new file mode 100644
index 00000000..89f21a6e
--- /dev/null
+++ b/docs/ru/beamng/dev/content/maps.md
@@ -0,0 +1,21 @@
+!!! внимание "Этот сайт находится в стадии разработки!"
+
+```
+Над этим сайтом ведется активная работа.
+
+Чувствуете, что можете помочь? Пожалуйста, сделайте это, нажав на страницу с карандашом справа!
+
+Это можно сделать на любой странице.
+```
+
+# Создание карты для BeamNG.drive
+
+...
+
+## Введение
+
+...
+
+## Начало работы
+
+...
diff --git a/docs/ru/beamng/dev/content/props.md b/docs/ru/beamng/dev/content/props.md
new file mode 100644
index 00000000..8e7d4816
--- /dev/null
+++ b/docs/ru/beamng/dev/content/props.md
@@ -0,0 +1,21 @@
+!!! внимание "Этот сайт находится в стадии разработки!"
+
+```
+Над этим сайтом ведется активная работа.
+
+Чувствуете, что можете помочь? Пожалуйста, сделайте это, нажав на страницу с карандашом справа!
+
+Это можно сделать на любой странице.
+```
+
+# Создание пропсов для BeamNG.drive
+
+...
+
+## Введение
+
+...
+
+## Начало работы
+
+...
diff --git a/docs/ru/beamng/dev/content/vehicles.md b/docs/ru/beamng/dev/content/vehicles.md
new file mode 100644
index 00000000..e5eeac0f
--- /dev/null
+++ b/docs/ru/beamng/dev/content/vehicles.md
@@ -0,0 +1,21 @@
+!!! внимание "Этот сайт находится в стадии разработки!"
+
+```
+Над этим сайтом ведется активная работа.
+
+Чувствуете, что можете помочь? Пожалуйста, сделайте это, нажав на страницу с карандашом справа!
+
+Это можно сделать на любой странице.
+```
+
+# Создание автомобиля для BeamNG.drive
+
+...
+
+## Введение
+
+...
+
+## Начало работы
+
+...
diff --git a/docs/ru/beamng/dev/index.md b/docs/ru/beamng/dev/index.md
new file mode 100644
index 00000000..e19e72af
--- /dev/null
+++ b/docs/ru/beamng/dev/index.md
@@ -0,0 +1,11 @@
+!!! внимание "Этот сайт находится в стадии разработки!"
+
+```
+Над этим сайтом ведется активная работа.
+
+Чувствуете, что можете помочь? Пожалуйста, сделайте это, нажав на страницу с карандашом справа!
+
+Это можно сделать на любой странице.
+```
+
+# Введение в разработку BeamNG.drive
diff --git a/docs/ru/beamng/dev/modding/imgui-windows.md b/docs/ru/beamng/dev/modding/imgui-windows.md
new file mode 100644
index 00000000..1d5ae042
--- /dev/null
+++ b/docs/ru/beamng/dev/modding/imgui-windows.md
@@ -0,0 +1,3 @@
+# imgui-windows.md
+
+Эту страницу нужно заполнить
diff --git a/docs/ru/beamng/dev/modding/lua-mods.md b/docs/ru/beamng/dev/modding/lua-mods.md
new file mode 100644
index 00000000..8f9416cc
--- /dev/null
+++ b/docs/ru/beamng/dev/modding/lua-mods.md
@@ -0,0 +1,3 @@
+# lua-mods.md
+
+Эту страницу нужно заполнить
diff --git a/docs/ru/beamng/dev/modding/ui-apps.md b/docs/ru/beamng/dev/modding/ui-apps.md
new file mode 100644
index 00000000..36a932d3
--- /dev/null
+++ b/docs/ru/beamng/dev/modding/ui-apps.md
@@ -0,0 +1,273 @@
+# Создание UI-приложения
+
+Для создания UI-приложения вам понадобятся некоторые знания фреймворка AngularJS, основную документацию можно найти здесь: [AngularJS docs](https://docs.angularjs.org/guide)
+
+## Структура файла
+
+Для работы UI-приложения необходимы четыре важных файла:
+
+- app.js | Содержит основной код, используемый [документацией UI-приложения Javascript](https://developer.mozilla.org/en-US/docs/Web/JavaScript)
+- app.html | Код, который отображает [HTML-документы](https://developer.mozilla.org/fr/docs/Web/HTML) вашего приложения
+- app.json | Содержит информацию о UI-приложении
+- app.png | Файл изображения, отображаемый в селекторе приложений
+
+### Стиль UI-приложения
+
+Мы рекомендуем использовать тег `<style>` для стилизации вашего приложения. Файл .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()` в Javascript, и повторяющийся тег `<li>` использующий <b>ng-repeat</b> для переменной `messages` , расположенной в Javascript.
+
+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}$scope</b> , чтобы иметь возможность доступа к ним из <b>Html</b> внутри любого тега <b>ng-*</b> . Таким образом, в этом примере после выполнения функции `sendMessage()` из <b>Html</b> она отправит его в файл lua, расположенный в каталоге расширений мода, и выполнит функцию `modifyMessage()` внутри этого файла lua.
+
+Пример того, как может выглядеть сторона lua:
+
+```lua
+local function modifyMessage(message)
+    message = message .. " [Modified!]"
+    guihooks.trigger('MessageReady', message)
+end
+```
+
+^ Это упрощенная версия lua, просто показывающая функцию.
+
+Основное внимание здесь уделяется использованию <b>guihooks.trigger</b> , который запускает событие AngularJS, определенное с помощью `$scope.$on()` . Как вы можете видеть в самом низу файла Javascript, событие называется MessageReady и будет выполнено функцией <b>guihooks.trigger</b> с полезной нагрузкой сообщения, а затем будет помещено в переменную `$scope.messages` для отображения тегом li с помощью <b>ng-repeat</b> в файле <b>Html.</b>
+
+Полный файл 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, предоставляемые BeamNG для UI-приложений
+
+```js
+bngApi.engineLua("lua_path.function()")
+```
+
+Полезно для запуска функции lua с аргументами или без них.
+
+# Функции Lua, предоставляемые BeamNG для UI-приложений
+
+```lua
+guihooks.trigger("EventName", Payload)
+```
+
+Полезная нагрузка может быть любого типа, но лучше хранить ее в виде массива/объекта или строки, чтобы она не потерялась.
+
+<b>ВАЖНО</b> : Иногда может случиться так, что имя события, которое вы используете, уже используется внутри чего-то другого, и это вызовет проблемы, поэтому, например, если ваше приложение называется Nickel, хорошей практикой будет называть каждое событие Angular как NKEventName вместо EventName.
diff --git a/docs/ru/contributing.md b/docs/ru/contributing.md
new file mode 100644
index 00000000..c9bc8edb
--- /dev/null
+++ b/docs/ru/contributing.md
@@ -0,0 +1,43 @@
+# Участие в разработке BeamMP Docs
+
+BeamMP использует [Material for MkDocs](https://squidfunk.github.io/mkdocs-material) в качестве своей темы. Это тема для [MkDocs](https://www.mkdocs.org) . Полную документацию можно найти на их соответствующих сайтах.
+
+## Начало работы
+
+Чтобы внести свой вклад в эти документы, вы можете воспользоваться одним из двух подходов, изложенных ниже:
+
+### 1. Редактировать необработанные файлы разметки
+
+Редактирование необработанных файлов markdown — самый быстрый подход, который лучше всего подходит для быстрых правок, таких как орфография, грамматика или новые фрагменты контента. Однако этот подход требует предварительного знания markdown, поскольку вам нужно будет понимать, что даст ваш вклад.
+
+Если вы предпочитаете именно этот подход, выполните следующие действия:
+
+1. Нажмите «Изменить» на странице, которую вы хотите отредактировать.
+2. Создайте форк проекта в своей учетной записи GitHub.
+3. Внесите необходимые изменения.
+4. Сохраните изменения в своем форке.
+5. Подайте запрос на включение изменений в наш репозиторий [здесь](https://github.com/BeamMP/Docs).
+
+После того, как вы создали свой pull request, один из руководителей BeamMP Mod Team рассмотрит ваш pull request и либо одобрит его, либо запросит некоторые изменения. Если изменения были запрошены и вы их выполнили, мы повторно рассмотрим ваш pull request. Затем ваши изменения будут объединены в репозиторий и автоматически развернуты в рамках нашей непрерывной интеграции.
+
+### 2. Вносите изменения с предварительным просмотром в реальном времени
+
+Редактирование наших документов таким способом по-прежнему будет осуществляться по тому же принципу, что и в варианте 1, однако вы сможете предварительно просмотреть свои изменения.
+
+1. Нажмите «Изменить» на странице, которую вы хотите отредактировать.
+2. Создайте форк проекта в своей учетной записи GitHub.
+3. Клонируйте проект локально.
+4. Настройка материалов для MkDocs в соответствии с их руководством [здесь](https://squidfunk.github.io/mkdocs-material/getting-started/).
+5. Запустите `mkdocs serve` , чтобы запустить сервер документации с функцией перезагрузки в реальном времени, на который вы клонировали форк.
+6. Внесите изменения, которые считаете нужными.
+7. Сохраните изменения в своем форке.
+8. Подайте запрос на включение изменений в наш репозиторий [здесь](https://github.com/BeamMP/Docs).
+
+## Макет проекта
+
+```
+mkdocs.yml    # The configuration file.
+docs/
+    index.md  # The documentation homepage.
+    ...       # Other markdown pages, images and other files.
+```
diff --git a/docs/ru/game/error-codes.md b/docs/ru/game/error-codes.md
new file mode 100644
index 00000000..f80ae712
--- /dev/null
+++ b/docs/ru/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 | Сброс соединения пиром | Сервер, к которому вы подключаетесь, отключился.
+Не удалось найти игру, пожалуйста, запустите ее. Сообщите об этом, если проблема сохранится код 3. | Лаунчеру не удалось найти информацию об игре (каталог игры, каталог профиля, версию и т. д.) в записи реестра. | Запустите игру хотя бы один раз, чтобы создать значения реестра.
+Не удалось найти игру, пожалуйста, запустите ее. Сообщите об этом, если проблема сохранится код 4. | Программа запуска не смогла прочитать информацию об игре (каталог игры, каталог профиля, версию и т. д.) в записи реестра. | Эта ошибка чаще всего появляется у пользователей с **пиратскими копиями** игры. Если вы купили игру, запустите ее хотя бы один раз, чтобы были созданы значения реестра.
+Не удалось запустить игру! Лаунчер скоро закроется | Лаунчеру не удалось найти исполняемый файл игры. | Запустите игру хотя бы один раз, прежде чем снова запускать лаунчер.
+Игра закрыта! Лаунчер скоро закроется | Игра была закрыта. | Это сообщение появится при закрытии игры или если игра не запустится.
+Обновление лаунчера не удалось! | Лаунчеру не удалось загрузить новую версию | Проверьте подключение к Интернету и правила брандмауэра/антивируса, чтобы лаунчер не был заблокирован.
+Ошибка инициализации файла регистратора | Лаунчер не имеет возможности создавать файлы | Запустите лаунчер от имени администратора.
+Пожалуйста, закройте игру и попробуйте еще раз. | Игра уже открыта и лаунчер не может очистить папку `multiplayer/mods` | Закройте игру и повторите попытку.
+Пожалуйста, запустите игру хотя бы один раз. | Программа запуска пыталась, но не смогла изменить каталог игры. | Запустите игру хотя бы один раз, прежде чем снова запускать лаунчер.
+Основные серверы офлайн! Извините за неудобства! | Лаунчеру не удалось проверить наличие обновления | Проверьте подключение к интернету и правила брандмауэра. Если с вашей стороны проблем нет, проверьте [канал обновлений BeamMP](https://discord.com/channels/601558901657305098/697596153943949352) на нашем Discord.
+Извините, произошел сбой в работе системы бэкэнда! Не волнуйтесь, скоро все заработает! | Бэкэнд BeamMP не ответил | Проверьте подключение к интернету и правила брандмауэра. Если с вашей стороны проблем нет, проверьте [канал обновлений BeamMP](https://discord.com/channels/601558901657305098/697596153943949352) на нашем Discord.
+Застрял при обновлении | Лаунчер завис на этапе обновления и не переходит к следующему шагу. | Запустите лаунчер от имени администратора и проверьте правила антивируса, чтобы лаунчер не блокировался.
+
+Если лаунчер сразу закрывается, проверьте файл `Launcher.log` в папке, куда вы установили BeamMP.
diff --git a/docs/ru/guides/mod-creation/server/getting-started.md b/docs/ru/guides/mod-creation/server/getting-started.md
new file mode 100644
index 00000000..952afa91
--- /dev/null
+++ b/docs/ru/guides/mod-creation/server/getting-started.md
@@ -0,0 +1,101 @@
+# Создание многопользовательских модов
+
+## Структура папок и основы файлов
+
+Базовая структура папок и файлов должна выглядеть следующим образом:
+
+```
+Resources/
+├─ Client/
+│  └─ examplePlugin.zip/
+│     ├─ scripts/
+│     │  └─ modScript.lua
+│     └─ lua/
+│        └─ ge/
+│           └─ extensions/
+│              └─ examplePlugin.lua
+└─ Server/
+   └─ examplePlugin/
+      ├─ examplePlugin.lua
+      └─ further_lua/
+         └─ further.lua
+```
+
+Серверный lua — это необходимый минимум, если вы хотите добавлять пользовательские события, вам также понадобится как минимум клиентский lua, а также modscript.lua.
+
+Папка Server должна содержать подпапки, по одной для каждого серверного мода. Хорошей практикой является наличие только одного основного файла lua и добавление дополнительных файлов lua в подпапки. Однако вам не обязательно это делать, сервер загрузит файлы lua в алфавитном порядке, если их несколько.
+
+Папка Client содержит zip-файлы, которые отправляются клиенту, который затем загружает их как мод. Любые другие файлы в папке Client вызовут ошибку при запуске сервера, но за исключением этого будут игнорироваться сервером. ModScript.lua будет прочитан BeamNG и укажет игре, какой плагин загружать.
+
+!!!example "" [Загрузите examplePlugin.zip](../../../../assets/content/ResourcesForExamplePlugin.zip)
+
+## Серверный lua
+
+В examplePlugin есть и другие примеры, но вот самый простой, выводящий идентификаторы игроков:
+
+```lua
+function onInit() --runs when plugin is loaded
+
+	MP.RegisterEvent("onPlayerAuth", "onPlayerAuth") --Provided by BeamMP
+
+	print("examplePlugin loaded")
+end
+
+--A player has authenticated and is requesting to join
+--The player's name (string), forum role (string), guest account (bool), identifiers (table -> ip, beammp)
+function onPlayerAuth(player_name, role, isGuest, identifiers)
+	local ip = identifiers.ip
+	local beammp = identifiers.beammp or "N/A"
+	print("onPlayerAuth: player_name: " .. player_name .. " | role: " .. role .. " | isGuest: " .. tostring(isGuest) .. " | identifiers: ip: " .. ip .. " - beammp: " .. beammp)
+end
+```
+
+`onPlayerAuth` срабатывает, как только игрок хочет присоединиться, см. также [onPlayerAuth в справочнике по скриптам](../../../scripting/server/latest-server-reference/#onplayerauth)
+
+Еще один пример использования onPlayerAuth, но он запретит гостям присоединяться к серверу, отправив клиенту ответное сообщение, которое затем будет показано игроку:
+
+```lua
+function onPlayerAuth(playerName, playerRole, isGuest, identifiers)
+  if isGuest then
+    return "No guests allowed, please use a BeamMP account"
+  end
+end
+```
+
+Дополнительную информацию о серверных функциях, предоставляемых BeamMP, можно найти в [последнем справочнике по серверу.](../../../scripting/server/latest-server-reference.md)
+
+## Клиентская часть lua
+
+Это в значительной степени соответствует [расширениям BeamNG.](https://documentation.beamng.com/modding/programming/extensions/)
+
+```lua
+local M = {}
+
+if extensions.isExtensionLoaded("examplePlugin") then
+  log("E", "examplePlugin", "examplePlugin loaded on client side")
+  return
+end
+
+return M
+```
+
+Выводит на консоль информацию о том, что examplePlugin был загружен
+
+Более подробную информацию см. в [документации beamNG по отладочным распечаткам.](https://documentation.beamng.com/modding/programming/debugging/#a-add-a-log)
+
+## modScript.lua
+
+Обычно содержит только две строки
+
+```lua
+load('examplePlugin')
+setExtensionUnloadMode('examplePlugin', 'manual')
+```
+
+Вы можете добавить вывод журнала, если хотите видеть в журналах, когда ваш modScript обрабатывается BeamNG.
+
+```lua
+load('examplePlugin')
+setExtensionUnloadMode('examplePlugin', 'manual')
+log('I', 'modScript', "examplePlugin loaded")
+```
diff --git a/docs/ru/scripting/mod-reference.md b/docs/ru/scripting/mod-reference.md
new file mode 100644
index 00000000..ea6b7639
--- /dev/null
+++ b/docs/ru/scripting/mod-reference.md
@@ -0,0 +1,45 @@
+!!! предупреждение "Этот сайт находится в стадии разработки!"
+
+```
+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 any page too.
+```
+
+# Справочник по модам/внутриигровым скриптам
+
+BeamMP также позволяет вам создавать собственные плагины на стороне клиента. Мы предоставили несколько функций, которые вы можете использовать для связи с другими многопользовательскими модами и другими игроками через сервер.
+
+# Функции
+
+Список доступных функций для написания скриптов:
+
+Функция | Примечания
+--- | ---
+`TriggerServerEvent("eventName", "data")` | Запускает событие в серверной среде lua, оба параметра являются строками.
+`TriggerClientEvent("eventName", "data")` | Запускает событие в локальной среде lua, оба параметра — строки. Хорошо подходит для связи между плагинами.
+`AddEventHandler("eventName", Function)` | Добавляет 2-й параметр в таблицу, который будет вызываться при получении `eventName` (локально или с сервера). `Function` получит 1 параметр — строку, содержащую данные события.
+
+# Фрагменты кода
+
+Например, для анализа чата используйте включенное событие `ChatMessageIncluded` следующим образом:
+
+```lua
+local function chatReceived(msg) -- Receive event with parameters
+    print("chat received: "..msg)
+    local i = string.find(s, ":") -- Find where our first ':' is, used to separate the sender and message
+    if i == nil then
+        print("error parsing message: separator could not be found!")
+        return -- Could not find separator, cancel function
+    end
+    print("index of separator: "..tostring(i))
+    local sender = string.sub(msg, 1, i-1) -- Substring our input to separate its 2 parts
+    local message = string.sub(msg, i+1, -1)  -- Do whatever you want to with the message
+    print("sender: " .. sender)
+    print("message: ".. message)
+end
+
+AddEventHandler("ChatMessageReceived", chatReceived) -- Add our event handler to the list managed by BeamMP
+```
diff --git a/docs/ru/scripting/server/latest-server-reference.md b/docs/ru/scripting/server/latest-server-reference.md
new file mode 100644
index 00000000..fb8aa95a
--- /dev/null
+++ b/docs/ru/scripting/server/latest-server-reference.md
@@ -0,0 +1,1319 @@
+!!! предупреждение "Этот сайт находится в стадии разработки!"
+
+```
+Над этим сайтом ведется активная работа.
+
+Чувствуете, что можете помочь? Пожалуйста, сделайте это, нажав на страницу с карандашом справа!
+
+Это можно сделать на любой странице.
+```
+
+# Справочник по серверным скриптам
+
+## Версия сервера 3.X
+
+### Введение
+
+Выпуск BeamMP-Server v3.0.0 вносит радикальные изменения в работу системы плагинов Lua. Нет возможности использовать старый lua с новым сервером, поэтому вам придется мигрировать.
+
+Система плагинов сервера использует [Lua 5.3](https://www.lua.org/manual/5.3/) . В этом разделе подробно описывается, как начать писать плагины, изучаются некоторые базовые концепции и начинается работа с вашим первым плагином. **Рекомендуется прочитать этот раздел, даже если вы знакомы с системой до версии 3.0.0, так как некоторые вещи кардинально изменились** .
+
+Руководство по миграции с lua до версии 3.0.0 см. в разделе [«Миграция со старой версии Lua»](#migrating-from-old-lua) .
+
+### Структура каталога
+
+Серверные плагины, в отличие от модов, располагаются (по умолчанию) в `Resources/Server` , тогда как моды, которые пишутся для BeamNG.drive и отправляются клиентам, находятся в `Resources/Client` . Каждый плагин должен иметь свою собственную подпапку в `Resources/Server` , например, для плагина с именем "MyPlugin" структура будет следующей:
+
+```
+Resources
+└── Server
+    ├── MyPlugin
+    │   └── main.lua
+    └── SomeOtherPlugin
+        └── ...
+```
+
+Здесь мы также отображаем другой плагин под названием "SomeOtherPlugin", чтобы проиллюстрировать, как ваша папка `Resources/Server` может иметь несколько различных папок плагинов. Мы продолжим использовать эту структуру каталогов в качестве примера на протяжении всего этого руководства.
+
+Вы также заметите `main.lua` . У вас может быть столько файлов Lua `.lua` , сколько вам нужно. Все файлы Lua в главном каталоге вашего плагина загружаются в *алфавитном порядке* (поэтому `aaa.lua` запускается перед `bbb.lua` ).
+
+### Файлы Lua
+
+Каждый файл Lua `.lua` в папке плагина загружается при запуске сервера. Это означает, что операторы вне функций оцениваются («запускаются») немедленно.
+
+Файлы Lua в подпапках игнорируются, но могут быть `require()` .
+
+Например, наш `main.lua` выглядит так:
+
+```lua
+function PrintMyName()
+	print("I'm 'My Plugin'!")
+end
+
+print("What's up!")
+```
+
+Когда сервер запустится и загрузится `main.lua` , он *немедленно* запустит `print("What's up!")` , но пока **НЕ** *вызовет* функцию `PrintMyName` (потому что она не была вызвана)!
+
+### События
+
+Событие — это что-то вроде «игрок присоединяется», «игрок отправил сообщение в чате», «игрок создал транспортное средство».
+
+Вы можете отменить события (если они отменяемы), вернув `1` из обработчика.
+
+В Lua вы обычно хотите реагировать на некоторые из них. Для этого вы можете зарегистрировать "Handler". Это функция, которая вызывается, когда происходит событие, и получает некоторые аргументы.
+
+Пример:
+
+```lua
+function MyChatMessageHandler(sender_id, sender_name, message)
+	-- censoring only the exact message 'darn'
+	if message == "darn" then
+		-- cancel the event by returning 1
+		return 1
+	else
+		return 0
+	end
+end
+
+MP.RegisterEvent("onChatMessage", "MyChatMessageHandler")
+```
+
+Это фактически гарантирует, что любое сообщение, которое в точности равно "darn", не будет отправлено и не будет показано в чате (обратите внимание, что для настоящего фильтра ненормативной лексики вам нужно будет проверить, *содержит* ли сообщение "darn", а не *является* ли оно "darn"). Отмена события приводит к тому, что оно не происходит, например, сообщение чата не будет показано никому другому, транспортное средство не будет создано и т. д.
+
+### Пользовательские события
+
+Вы можете зарегистрироваться на любое понравившееся вам мероприятие, например:
+
+```lua
+MP.RegisterEvent("MyCoolCustomEvent", "MyHandler")
+```
+
+Затем вы можете инициировать эти пользовательские события:
+
+```lua
+-- call all event handlers to this in ALL plugins
+MP.TriggerGlobalEvent("MyCoolCustomEvent")
+-- call all event handlers to this in THIS plugin
+MP.TriggerLocalEvent("MyCoolCustomEvent")
+```
+
+С событиями можно делать гораздо больше, но эти возможности будут подробно рассмотрены ниже в справочнике по API.
+
+### Таймеры событий («Потоки»)
+
+До версии 3.0.0 Lua имела концепцию "потоков", которые запускались X раз в секунду. Такое наименование было немного обманчивым, поскольку они были синхронными.
+
+v3.0.0 Lua вместо этого имеет "Таймеры событий". Это таймеры, которые работают внутри сервера, и как только они заканчиваются, они запускают событие (глобально). Это также синхронно. Пожалуйста, имейте в виду, что второй аргумент - это интервал в миллисекундах.
+
+Пример:
+
+```lua
+local seconds = 0
+
+function CountSeconds()
+	seconds = seconds + 1
+end
+
+-- create a custom event called 'EverySecond'
+-- and register the handler function 'CountSeconds' to it
+MP.RegisterEvent("EverySecond", "CountSeconds")
+
+-- create a timer for this event, which will fire every 1000ms (1s)
+MP.CreateEventTimer("EverySecond", 1000)
+```
+
+Это приведет к тому, что "CountSeconds" будет вызываться каждую секунду. Вы также можете отменить таймеры событий с помощью `MP.CancelEventTimer` (см. справочник API).
+
+С консоли сервера вы можете запустить `status` , чтобы увидеть, сколько таймеров событий запущено в данный момент, а также информацию об ожидающих обработчиках событий. Эта команда покажет больше информации в будущем.
+
+### Отладка
+
+Lua трудно отлаживать. К сожалению, для встроенного Lua не существует отладчика промышленного уровня, такого как `gdb` .
+
+В общем случае вы, конечно, можете в любое время просто `print()` значения, которые хотите проверить.
+
+В версии 3.0.0 сервер предоставляет вам возможность внедрить интерпретатор в плагин и впоследствии запустить Lua внутри него в реальном времени. Это самое близкое, что у нас есть к отладчику.
+
+Предположим, у вас есть плагин, который мы назвали `MyPlugin` , вы можете войти в его состояние Lua следующим образом:
+
+```
+> lua MyPlugin
+```
+
+Здесь важны заглавные буквы, поэтому будьте внимательны, чтобы они были введены правильно. Вывод будет примерно таким:
+
+```
+lua @MyPlugin>
+```
+
+Как видите, мы перешли в состояние Lua для `MyPlugin` . С этого момента и до тех пор, пока мы не войдем в `exit()` (с версии 3.1.0 `:exit` ), мы будем в `MyPlugin` и сможем выполнить Lua там.
+
+Например, если у нас есть глобальный объект с именем `MyValue` , мы можем вывести это значение следующим образом:
+
+```
+lua @MyPlugin> print(MyValue)
+```
+
+Здесь вы можете вызывать функции и делать все, что вам нужно.
+
+Начиная с версии 3.1.0: Вы можете нажать клавишу TAB для автодополнения функций и переменных.
+
+ВНИМАНИЕ: К сожалению, если состояние Lua в данный момент занято выполнением другого кода (например, цикла `while` ), это может полностью повесить консоль до тех пор, пока она не завершит эту работу, поэтому будьте очень осторожны, переключаясь на состояния, которые могут ожидать чего-то.
+
+Кроме того, вы можете запустить `status` в обычной консоли ( `>` ), которая покажет вам, среди прочего, некоторую статистику о Lua.
+
+### Пользовательские команды
+
+Для реализации пользовательских команд для консоли сервера можно использовать событие `onConsoleInput` . Это может быть полезно, когда вы хотите добавить способ для владельца сервера подать сигнал на ваш плагин или отобразить внутреннее состояние пользовательским способом.
+
+Вот пример:
+
+```lua
+function handleConsoleInput(cmd)
+    local delim = cmd:find(' ')
+    if delim then
+        local message = cmd:sub(delim+1)
+        if cmd:sub(1, delim-1) == "print" then
+            return message
+        end
+    end
+end
+
+MP.RegisterEvent("onConsoleInput", "handleConsoleInput")
+```
+
+Это позволит вам выполнять следующие действия в консоли сервера:
+
+```
+> print hello, world
+hello, world
+```
+
+Мы реализовали собственную `print` . В качестве упражнения попробуйте создать функцию, подобную `say` , которая отправляет сообщение чата всем игрокам или даже конкретному игроку (с помощью `MP.SendChatMessage` ).
+
+**Внимание:** для ваших собственных плагинов обычно рекомендуется "пространство имен". Наш пример `print` в плагине с именем `mystuff` может называться `mystuff.print` или `ms.print` или что-то подобное.
+
+### Ссылка на API
+
+Формат документации: `function_name(arg_name: arg_type, arg_name: arg_type) -> return_types`
+
+### Встроенные функции
+
+#### `print(...)` , `printRaw(...)`
+
+Выводит сообщение на консоль сервера с префиксом `[DATE TIME] [LUA]` . Если вам не нужен этот префикс, вы можете использовать `printRaw(...)` .
+
+Пример:
+
+```lua
+local name = "John Doe"
+print("Hello, I'm", name, "and I'm", 32)
+```
+
+Он может принимать столько аргументов произвольных типов, сколько вам нужно. Он также с радостью выгрузит таблицы!
+
+Это похоже на `print` интерпретатора lua, поэтому она будет вставлять символы табуляции между аргументами.
+
+#### `exit()`
+
+Корректно завершает работу сервера. Вызывает срабатывание события `onShutdown` .
+
+### Функции МП
+
+#### `MP.CreateTimer() -> Timer`
+
+Создает объект таймера, который можно использовать для отслеживания того, сколько времени заняло что-то / сколько времени прошло. Он запускается после создания и может быть сброшен/перезапущен с помощью `mytimer:Start()` .
+
+Текущее прошедшее время в секундах можно получить с помощью `mytimer:GetCurrent()` .
+
+Пример:
+
+```lua
+local mytimer = MP.CreateTimer()
+-- do stuff here that needs to be timed
+print(mytimer:GetCurrent()) -- print how much time elapsed
+```
+
+Таймеры не нужно останавливать (и их невозможно остановить), они не создают накладных расходов.
+
+#### `MP.GetOSName() -> string`
+
+Возвращает имя текущей ОС: `Windows` , `Linux` или `Other` .
+
+#### `MP.GetServerVersion() -> number,number,number`
+
+Возвращает текущую версию сервера в формате major, minor, patch. Например, версия v3.0.0 вернет `3, 0, 0` .
+
+Пример:
+
+```lua
+local major, minor, patch = MP.GetServerVersion()
+print(major, minor, patch)
+```
+
+Выход:
+
+```
+2	4	0
+```
+
+#### `MP.RegisterEvent(event_name: string, function_name: string)`
+
+Запоминает функцию с именем Имя `Function Name` как обработчик события с именем `Event Name` .
+
+Вы можете зарегистрировать столько обработчиков события, сколько захотите.
+
+Список событий, предоставляемых сервером, можно посмотреть [здесь](#events-1) .
+
+Если событие с таким именем не существует, оно создается, и, таким образом, RegisterEvent не может завершиться неудачей. Это можно использовать для создания пользовательских событий. Подробнее см. в разделах [Пользовательские события](#custom-events) и [События](#events) .
+
+Пример:
+
+```lua
+function ChatHandler(player_id, player_name, msg)
+    if msg == "hello" then
+        print("Hello World!")
+        return 0
+    end
+end
+
+MP.RegisterEvent("onChatMessage", "ChatHandler")
+```
+
+#### `MP.CreateEventTimer(event_name: string, interval_ms: number, [strategy: number (since v3.0.2)])`
+
+Запускает таймер внутри сервера, который запускает событие `event_name` каждые `interval_ms` миллисекунд.
+
+Таймеры событий можно отменить с помощью `MP.CancelEventTimer` .
+
+Интервалы &lt;25 мс не рекомендуются, так как несколько таких интервалов, скорее всего, не будут обслуживаться вовремя надежно. Хотя несколько таймеров могут быть запущены для одного и того же события, рекомендуется создавать как можно меньше таймеров событий. Например, если вам нужно одно событие, которое запускается каждые полсекунды, и одно, которое запускается каждую секунду, рассмотрите возможность создания просто события каждые полсекунды и запуска триггера every-second-functiosecond.
+
+Вы также можете использовать `MP.CreateTimer` для создания таймера и измерения времени, прошедшего с момента последнего вызова события, чтобы минимизировать таймеры событий, хотя это не обязательно рекомендуется, поскольку это значительно увеличивает сложность кода.
+
+**Начиная с версии 3.0.2:**
+
+Необязательный `CallStrategy` может быть указан в качестве третьего аргумента. Это может быть:
+
+- `MP.CallStrategy.BestEffort` (по умолчанию): попытается запустить событие с указанным интервалом, но откажется ставить обработчики в очередь, если выполнение обработчика займет слишком много времени.
+- `MP.CallStrategy.Precise` : будет ставить обработчики событий в очередь с точным указанным интервалом. Может привести к заполнению очереди, если обработчику требуется больше времени, чем интервал. Используйте только если вам НУЖЕН точный интервал.
+
+#### `MP.CancelEventTimer(event_name: string)`
+
+Отменяет все таймеры для события с именем `event_name` В некоторых случаях таймер может сработать еще один раз, прежде чем будет отменен, из-за особенностей асинхронного программирования.
+
+#### `MP.TriggerLocalEvent(event_name: string, ...) -> table`
+
+Синхронный триггер событий локального плагина.
+
+Запускает локальное событие, которое приводит к вызову всех обработчиков этого события *в текущем состоянии lua* (обычно в текущем плагине, если состояние не было передано через PluginConfig.toml).
+
+Вы можете передать этой функции аргументы ( `...` ), которые копируются и отправляются всем обработчикам как аргументы функции.
+
+Этот вызов является синхронным и вернет управление после завершения всех обработчиков событий.
+
+Возвращаемое значение — это таблица всех результатов. Если обработчик вернул значение, оно будет в этой таблице, неаннотированное и неименованное. Это можно использовать для «сбора» вещей или регистрации подобработчиков для событий, которые можно отменить. Это практически массив.
+
+Пример:
+
+```lua
+local Results = MP.TriggerLocalEvent("MyEvent")
+print(Results)
+```
+
+#### `MP.TriggerGlobalEvent(event_name: string, ...) -> table`
+
+Глобальный асинхронный триггер событий.
+
+Запускает глобальное событие, которое приводит к вызову всех обработчиков этого события *во всех плагинах* (включая *этот* плагин).
+
+Вы можете передать этой функции аргументы ( `...` ), которые копируются и отправляются всем обработчикам как аргументы функции.
+
+Этот вызов асинхронный и возвращает объект, подобный будущему. Локальные обработчики (обработчики в том же плагине, что и вызывающий) запускаются синхронно и немедленно.
+
+Возвращаемая таблица имеет две функции:
+
+- `IsDone() -> boolean` сообщает, все ли обработчики завершились. Вы можете подождать, пока это не станет правдой, проверив это и `MP.Sleep` -ing на некоторое время в цикле.
+- `GetResults() -> table` возвращает неаннотированную неименованную таблицу со всеми возвращаемыми значениями всех обработчиков. Это практически массив.
+
+Обязательно вызывайте их с помощью синтаксиса `Obj:Function()` ( `:` , NOT `.` ).
+
+Пример:
+
+```lua
+local Future = MP.TriggerGlobalEvent("MyEvent")
+-- wait until handlers finished
+while not Future:IsDone() do
+	MP.Sleep(100) -- sleep 100 ms
+end
+local Results = Future:GetResults()
+print(Results)
+```
+
+Имейте в виду, что обработчик, регистрирующийся здесь в "MyEvent" и никогда не возвращающийся, может заблокировать ваш плагин. Вероятно, вы захотите отслеживать, как долго вы ждали, и прекратить ожидание через несколько секунд.
+
+#### `MP.Sleep(time_ms: number)`
+
+Ожидает в течение указанного в миллисекундах времени.
+
+Это не приведет к выполнению состояния lua, и в состоянии сна ничего не будет выполнено.
+
+ВНИМАНИЕ: НЕ засыпайте более чем на 500 мс, если у вас зарегистрированы обработчики событий, если вы *точно* не знаете, что делаете. Это предназначено для использования в режиме сна на 1-100 мс, чтобы дождаться результатов или чего-то подобного. Заблокированное (спящее) состояние lua может существенно замедлить работу всего сервера, если не соблюдать осторожность.
+
+#### `MP.SendChatMessage(player_id: number, message: string)`
+
+Отправляет сообщение чата, которое может видеть только указанный игрок (или все, если идентификатор `-1` ). В игре это не будет отображаться как направленное сообщение.
+
+Вы можете использовать это, например, чтобы сообщить игроку *, почему* вы отменили появление его транспортного средства, отправить сообщение в чате или что-то подобное, или чтобы отобразить некоторую информацию о вашем сервере.
+
+Пример:
+
+```lua
+function ChatHandler(player_id, player_name, msg)
+    if string.match(msg, "darn") then
+        MP.SendChatMessage(player_id, "Please do not use profanity.") -- If the player sends a message containing "darn", notify the player and cancel the message
+        return 1
+    else
+        return 0
+    end
+end
+
+MP.RegisterEvent("onChatMessage", "ChatHandler")
+```
+
+Пример 2:
+
+```lua
+function ChatHandler(player_id, player_name, msg)
+    if msg == "hello" then
+        MP.SendChatMessage(-1, "Hello World!") -- If the player sends the exact message "hello", announce to the entire server "Hello World!"
+        return 0
+    end
+end
+```
+
+#### `MP.TriggerClientEvent(player_id: number, event_name: string, data: string) -> boolean`
+
+*до версии 3.1.0*
+
+#### `MP.TriggerClientEvent(player_id: number, event_name: string, data: string) -> boolean,string`
+
+*начиная с версии 3.1.0*
+
+#### `MP.TriggerClientEventJson(player_id: number, event_name: string, data: table) -> boolean,string`
+
+*начиная с версии 3.1.0*
+
+Вызовет указанное событие с указанными данными на указанном клиенте (-1 для трансляции). Это событие затем может быть обработано в клиентском lua mod, см. документацию "Client Scripting" для этого.
+
+Вернет `true` если сообщение удалось отправить (для `id = -1` , поэтому для трансляций это всегда `true` ), и `false` если игрок с таким идентификатором не существует или отключен, но у него все еще есть идентификатор (это известная проблема).
+
+Если возвращается `false` , нет смысла повторять это событие, и не следует ожидать ответа (если таковой ожидался).
+
+Начиная с версии 3.1.0, второе возвращаемое значение содержит сообщение об ошибке, если функция не удалась. Также, начиная с этой версии, версия функции `*Json` принимает таблицу в качестве аргумента данных и преобразует ее в json. Это просто сокращение для `MP.TriggerClientEvent(..., Util.JsonEncode(mytable))` .
+
+#### `MP.GetPlayerCount() -> number`
+
+Возвращает количество игроков, находящихся в данный момент на сервере.
+
+#### `MP.GetPositionRaw(pid: number, vid: number) -> table,string`
+
+Возвращает текущую позицию транспортного средства `vid` (идентификатор транспортного средства) игрока `pid` (идентификатор игрока) и строку ошибки, если произошла ошибка.
+
+Таблица декодируется из пакета позиции, поэтому она содержит разнообразные данные, включая позицию и поворот (именно поэтому эта функция имеет постфикс «Raw»).
+
+Пример:
+
+```lua
+local player_id = 4
+local vehicle_id = 0
+
+local raw_pos, error = MP.GetPositionRaw(player_id, vehicle_id)
+
+if error == "" then
+    print(raw_pos)
+else
+    print(error)
+end
+```
+
+Выход:
+
+```json
+ {
+    tim: 49.824, // Time since spawn
+    rvel: { // Rotational velocity
+            1: -1.33564e-05,
+            2: -9.16553e-06,
+            3: 8.33364e-07,
+    },
+    vel: { // Velocity
+            1: -4.29755e-06,
+            2: -5.79335e-06,
+            3: 4.95236e-06,
+    },
+    pos: { // Position
+            1: 269.979,
+            2: -759.068,
+            3: 46.554,
+    },
+    ping: 0.0125, // Vehicle latency
+    rot: { // Rotation
+            1: -0.00559953,
+            2: 0.00894832,
+            3: 0.772266,
+            4: 0.635212,
+    },
+}
+```
+
+Пример 2:
+
+```lua
+local player_id = 4
+local vehicle_id = 0
+
+local raw_pos, error = MP.GetPositionRaw(player_id, vehicle_id)
+if error = "" then
+    local x, y, z = table.unpack(raw_pos["pos"])
+
+    print("X:", x)
+    print("Y:", y)
+    print("Z:", z)
+else
+    print(error)
+end
+```
+
+Выход:
+
+```
+X: -603.459
+Y: -175.078
+Z: 26.9505
+```
+
+#### `MP.IsPlayerConnected(player_id: number) -> boolean`
+
+Подключен ли игрок и получил ли сервер от него UDP-пакет.
+
+Пример:
+
+```lua
+local player_id = 8
+print(MP.IsPlayerConnected(player_id)) -- Check if player with ID 8 is properly connected.
+```
+
+Выход:
+
+```lua
+true
+```
+
+#### `MP.GetPlayerName(player_id: number) -> string`
+
+Получает отображаемое имя игрока.
+
+Пример:
+
+```lua
+local player_id = 4
+print(MP.GetPlayerName(player_id)) -- Get the name of the player with ID 4
+```
+
+Выход:
+
+```
+ilovebeammp2004
+```
+
+#### `MP.RemoveVehicle(player_id: number, vehicle_id: number)`
+
+Удаляет указанное транспортное средство для указанного игрока.
+
+Пример:
+
+```lua
+local player_id = 3
+local player_vehicles = MP.GetPlayerVehicles(player_id)
+
+-- Loop over all of player 3's vehicles and delete them
+for vehicle_id, vehicle_data in pairs(player_vehicles) do
+      MP.RemoveVehicle(player_id, vehicle_id)
+end
+```
+
+#### `MP.GetPlayerVehicles(player_id: number) -> table`
+
+Возвращает таблицу всех транспортных средств, которые в данный момент есть у игрока. Каждая запись в таблице представляет собой сопоставление идентификатора транспортного средства с данными о транспортном средстве (которые в настоящее время являются необработанной строкой json).
+
+Пример:
+
+```lua
+local player_id = 3
+local player_vehicles = MP.GetPlayerVehicles(player_id)
+
+for vehicle_id, vehicle_data in pairs(player_vehicles) do
+    local start = string.find(vehicle_data, "{")
+    local formattedVehicleData = string.sub(vehicle_data, start, -1)
+    print(Util.JsonDecode(formattedVehicleData))
+end
+```
+
+Выход:
+
+```json
+{
+    pid: 0,
+    pro: "0",
+    rot: {
+            1: 0,
+             2: 0,
+            3: 0.776866,
+            4: 0.629665,
+    },
+    jbm: "miramar",
+    vcf: {
+            parts: {
+                    miramar_exhaust: "miramar_exhaust",
+                    miramar_shock_R: "miramar_shock_R",
+                    miramar_taillight: "miramar_taillight",
+                    miramar_door_RL: "miramar_door_RL"
+                    // ... continue
+            },
+            paints: {
+                    1: {
+                            roughness: 1,
+                            metallic: 0,
+                            clearcoat: 1,
+                            baseColor: {
+                                    1: 0.85,
+                                    2: 0.84,
+                                    3: 0.8,
+                                    4: 1.2,
+                            },
+                            clearcoatRoughness: 0.09,
+                    } // ... continue
+            },
+            partConfigFilename: "vehicles/miramar/base_M.pc",
+            vars: {},
+            mainPartName: "miramar",
+    },
+    pos: {
+            1: 283.669,
+            2: -754.332,
+            3: 48.2151,
+    },
+    vid: 64822,
+    ign: 0,
+}
+```
+
+#### `MP.GetPlayers() -> table`
+
+Возвращает таблицу всех подключенных игроков. Эта таблица сопоставляет идентификаторы с именами, например:
+
+```json
+{
+	0: "LionKor",
+	1: "JohnDoe"
+}
+```
+
+#### `MP.IsPlayerGuest(player_id: number) -> boolean`
+
+Является ли игрок гостем. Гость — это тот, кто не вошел в систему, а вместо этого решил играть как гость. Обычно его имя — `guest` за которым следует длинный номер.
+
+Поскольку гости анонимны, вы можете запретить им присоединяться. В этом случае рекомендуется использовать аргумент [`onPlayerAuth`](#onplayerauth) `is_guest` .
+
+#### `MP.DropPlayer(player_id: number, [reason: string])`
+
+Выгоняет игрока с указанным ID. Параметр причины необязателен.
+
+```lua
+function ChatHandler(player_id, player_name, message)
+    if string.match(message, "darn") then
+        MP.DropPlayer(player_id, "Profanity is not allowed")
+        return 1
+    else
+        return 0
+    end
+end
+```
+
+#### `MP.GetStateMemoryUsage() -> number`
+
+Возвращает использование памяти текущим состоянием Lua в байтах.
+
+#### `MP.GetLuaMemoryUsage() -> number`
+
+Возвращает использование памяти всеми состояниями lua в байтах.
+
+#### `MP.GetPlayerIdentifiers(player_id: number) -> table`
+
+Возвращает таблицу с информацией об игроке, такой как идентификатор форума BeamMP, IP-адрес и идентификатор учетной записи Discord. Discord ID будет возвращен только в том случае, если пользователь связал его со своей учетной записью форума.
+
+Вы можете найти идентификатор форума пользователя, перейдя по адресу `https://forum.beammp.com/u/USERNAME.json` и выполнив поиск по запросу `"user": {"id": 123456}` . Идентификатор BeamMP уникален для проигрывателя и не может быть изменен в отличие от имени пользователя.
+
+Пример:
+
+```lua
+local player_id = 5
+print(MP.GetPlayerIdentifiers(player_id))
+```
+
+Выход:
+
+```json
+{
+    ip: "127.0.0.1",
+    discord: "12345678987654321",
+    beammp: "1234567",
+}
+```
+
+*До версии 3.1.0 поле `ip` было неверным и не работало как задумано. Исправлено в версии 3.1.0.*
+
+#### `MP.Set(setting: number, ...)`
+
+Временно устанавливает параметр ServerConfig. Для этого полезна таблица `MP.Settings` .
+
+Пример:
+
+```lua
+MP.Set(MP.Settings.Debug, true) -- Turns on debug mode
+```
+
+#### `MP.Settings -> table`
+
+Таблица карты настройки идентификаторов для имени. Используется с `MP.Set` для изменения настроек ServerConfig.
+
+Пример:
+
+```lua
+print(MP.Settings)
+```
+
+Выход:
+
+```json
+{
+    MaxPlayers: 3,
+    Debug: 0,
+    Name: 5,
+    Description: 6,
+    MaxCars: 2,
+    Private: 1,
+    Map: 4,
+}
+```
+
+### Утилитарные функции
+
+#### `Util.Json*`
+
+Начиная с BeamMP-Server `v3.1.0` .
+
+Это встроенная библиотека JSON, которая обычно намного быстрее любой библиотеки Lua JSON. За кулисами используется библиотека C++ `nlohmann::json` , которая совместима с JSON, полностью протестирована и постоянно подвергается фаззингу.
+
+#### `Util.JsonEncode(table: table) -> string`
+
+Кодирует таблицу Lua в строку JSON, рекурсивно (таблицы внутри таблиц внутри таблиц ... работают как и ожидалось). Все примитивные типы учитываются, функции, пользовательские данные и т. п. игнорируются.
+
+Полученный JSON минимизируется и может быть красиво выведен с помощью `Util.JsonPrettify` для его наглядности.
+
+Пример:
+
+```lua
+local player = {
+	name = "Lion",
+	age = 69,
+	skills = { "skill A", "skill B" }
+}
+local json = Util.JsonEncode(player)
+```
+
+Результаты в:
+
+```json
+{"name":"Lion","age":69,"skills":["skill A","skill B"]}
+```
+
+#### `Util.JsonDecode(json: string) -> table`
+
+Декодирует JSON в таблицу Lua. Возвращает `nil` если это не удалось, и выводит ошибку.
+
+Пример:
+
+```lua
+local json = "{\"message\":\"OK\",\"code\":200}"
+local tbl = Util.JsonDecode(json)
+```
+
+Результаты в:
+
+```lua
+{
+	message = "OK",
+	code = 200,
+}
+```
+
+#### `Util.JsonPrettify(json: string) -> string`
+
+Добавьте отступы и новые строки в JSON, чтобы сделать его более читабельным для людей.
+
+Пример:
+
+```
+local myjson = Util.JsonEncode({ name="Lion", age = 69, skills = { "skill A", "skill B" } })
+
+print(Util.JsonPrettify(myjson))
+```
+
+Результаты в:
+
+```json
+{
+    "age": 69.0,
+    "name": "Lion",
+    "skills": [
+        "skill A",
+        "skill B"
+    ]
+}
+```
+
+#### `Util.JsonMinify(json: string) -> string`
+
+Удаляет отступы, переносы строк и любые другие пробелы. Не обязательно, если вы не вызвали `Util.JsonPrettify` , так как весь вывод из `Util.Json*` уже минифицирован.
+
+Пример:
+
+```lua
+local pretty = Util.JsonPrettify(Util.JsonEncode({ name="Lion", age = 69, skills = { "skill A", "skill B" } }))
+
+print(Util.JsonMinify(pretty))
+```
+
+Результаты в:
+
+```json
+{"age":69.0,"name":"Lion","skills":["skill A","skill B"]}
+```
+
+#### `Util.JsonFlatten(json: string) -> string`
+
+Создает объект JSON, ключи которого сводятся к указателям JSON в соответствии с RFC 6901. Вы можете восстановить оригинал с помощью `Util.JsonUnflatten()` . Чтобы это работало, все значения должны быть примитивами.
+
+Пример:
+
+```lua
+local json = Util.JsonEncode({ name="Lion", age = 69, skills = { "skill A", "skill B" } })
+print("normal: " ..json)
+print("flattened: " .. Util.JsonFlatten(json))
+print("flattened pretty: " .. Util.JsonPrettify(Util.JsonFlatten(json)))
+
+```
+
+Результаты в:
+
+```json
+normal: {"age":69.0,"name":"Lion","skills":["skill A","skill B"]}
+flattened: {"/age":69.0,"/name":"Lion","/skills/0":"skill A","/skills/1":"skill B"}
+flattened pretty: {
+    "/age": 69.0,
+    "/name": "Lion",
+    "/skills/0": "skill A",
+    "/skills/1": "skill B"
+}
+```
+
+#### `Util.JsonUnflatten(json: string) -> string`
+
+Восстанавливает произвольную вложенность значения JSON, которое было сглажено перед использованием функции `Util.JsonFlatten()` .
+
+#### `Util.JsonDiff(a: string, b: string) -> string`
+
+Создает разницу JSON в соответствии с RFC 6902 (http://jsonpatch.com/). Затем эту разницу можно применить как патч через `Util.JsonDiffApply()` . Возвращает разницу.
+
+#### `Util.JsonDiffApply(base: string, diff: string) -> string`
+
+Применяет JSON `diff` к `base` как JSON patch (RFC 6902, http://jsonpatch.com/). Возвращает результат.
+
+### `Util.Random*`
+
+Начиная с BeamMP-Server `v3.1.0` .
+
+#### `Util.Random() -> float`
+
+Возвращает число с плавающей точкой от 0 до 1.
+
+Пример:
+
+```lua
+local rand = Util.Random()
+print("rand: " .. rand)
+```
+
+Результаты в:
+
+```lua
+rand: 0.135477
+```
+
+#### `Util.RandomIntRange(min: int, max: int) -> int`
+
+Возвращает целое число от минимума до максимума.
+
+Пример:
+
+```lua
+local randInt = Util.RandomIntRange(1, 100)
+print("randInt: " .. randInt)
+```
+
+Результаты в:
+
+```lua
+randInt:  69
+```
+
+#### `Util.RandomRange(min: number, max: number) -> float`
+
+Возвращает число с плавающей точкой между минимумом и максимумом.
+
+Пример:
+
+```lua
+local randFloat = Util.RandomRange(1, 1000)
+print("randFloat: " .. randFloat)
+```
+
+Результаты в:
+
+```lua
+randFloat: 420.6969
+```
+
+#### `Util.LogInfo(params: ...)` и др. (начиная с версии 3.3.0)
+
+```lua
+Util.LogInfo("Hello, World!")
+Util.LogWarn("Cool warning")
+Util.LogError("Oh no!")
+Util.LogDebug("hi")
+```
+
+производит
+
+```
+[19/04/24 11:06:50.142] [Test] [INFO] Hello, World!
+[19/04/24 11:06:50.142] [Test] [WARN] Cool warning
+[19/04/24 11:06:50.142] [Test] [ERROR] Oh no!
+[19/04/24 11:06:50.142] [Test] [DEBUG] hi
+```
+
+Поддерживает ту же самую печать/сброс данных, что и `print()` .
+
+#### `Util.DebugExecutionTime() -> table`
+
+Когда код Lua выполняется на сервере, выполнение каждого обработчика событий хронометрируется. Минимальное, максимальное, среднее (среднее) и стандартное отклонение этих времен выполнения вычисляются и возвращаются в таблице этой функцией. Расчет происходит пошагово, поэтому каждый раз, когда запускается обработчик событий, минимальное, максимальное, среднее и стандартное отклонение обновляются. Таким образом, `Util.DebugExecutionTime()` обычно не занимает значительного времени для выполнения (менее 0,25 мс).
+
+Возвращает таблицу следующего вида:
+
+```lua
+[[table: 0x7af6d400aca0]]: {
+	printStuff: [[table: 0x7af6d400be60]]: {
+		mean: 0.250433,
+		n: 76,
+		max: 0.074475,
+		stdev: 0.109405,
+		min: 0.449274,
+	},
+	onInit: [[table: 0x7af6d400b130]]: {
+		mean: 0.033095,
+		n: 1,
+		max: 0.033095,
+		stdev: 0,
+		min: 0.033095,
+	},
+}
+```
+
+Для каждого *обработчика* событий возвращаются следующие данные:
+
+- `n` : Количество раз, когда событие срабатывало и был вызван обработчик
+- `mean` : среднее значение всех времен выполнения, в мс
+- `max` .: Максимальное время выполнения, в мс.
+- `min` .: Наименьшее время выполнения, в мс.
+- `stdev` : стандартное отклонение всех средних значений времени выполнения в мс
+
+Вот функция, которую можно использовать для наглядной распечатки этих данных:
+
+```lua
+function printDebugExecutionTime()
+    local stats = Util.DebugExecutionTime()
+    local pretty = "DebugExecutionTime:\n"
+    local longest = 0
+    for name, t in pairs(stats) do
+        if #name > longest then
+            longest = #name
+        end
+    end
+    for name, t in pairs(stats) do
+        pretty = pretty .. string.format("%" .. longest + 1 .. "s: %12f +/- %12f (min: %12f, max: %12f) (called %d time(s))\n", name, t.mean, t.stdev, t.min, t.max, t.n)
+    end
+    print(pretty)
+end
+```
+
+Вы можете вызвать его следующим образом для отладки кода, если он работает медленно:
+
+```lua
+-- event to print the debug times
+MP.RegisterEvent("printStuff", "printDebugExecutionTime")
+-- run every 5000 ms = 5 seconds (or 10, or 60, whatever makes sense for you
+MP.CreateEventTimer("printStuff", 5000)
+```
+
+### Функции ФС
+
+Функции `FS` — это функции **файловой** **системы** , которые стремятся превзойти возможности Lua по умолчанию.
+
+Пожалуйста, всегда используйте `/` в качестве разделителя при указании путей, так как это кроссплатформенно (windows, linux, macos, ...).
+
+#### `FS.CreateDirectory(path: string) -> bool,string`
+
+Создает указанный каталог и любые родительские каталоги, если они не существуют. Поведение примерно эквивалентно обычной команде linux `mkdir -p` .
+
+В случае успеха возвращает `true` и `""` . Если создание каталога не удалось, возвращается `false` и сообщение об ошибке ( `string` ).
+
+Пример:
+
+```lua
+local success, error_message = FS.CreateDirectory("data/mystuff/somefolder")
+
+if not success then
+	print("failed to create directory: " .. error_message)
+else
+	-- do something with the directory
+end
+
+-- Be careful not to do this! This will ALWAYS be true!
+if error_message then
+	-- ...
+end
+```
+
+#### `FS.Remove(path: string) -> bool,string`
+
+Удаляет указанный файл или папку.
+
+Возвращает `true` , если произошла ошибка, с сообщением об ошибке во втором возвращаемом значении.
+
+Пример:
+
+```lua
+local error, error_message = FS.Remove("myfile.txt")
+
+if error then
+	print("failed to delete myfile: " .. error_message)
+end
+```
+
+#### `FS.Rename(pathA: string, pathB: string) -> bool,string`
+
+Переименовывает (или перемещает) `pathA` в `pathB` .
+
+Возвращает `true` , если произошла ошибка, с сообщением об ошибке во втором возвращаемом значении.
+
+#### `FS.Copy(pathA: string, pathB: string) -> bool,string`
+
+Копирует `pathA` в `pathB` .
+
+Возвращает `true` , если произошла ошибка, с сообщением об ошибке во втором возвращаемом значении.
+
+#### `FS.GetFilename(path: string) -> string`
+
+Возвращает последнюю часть пути, которая обычно является именем файла. Вот несколько примеров входов + выходов:
+
+```lua
+input -> output
+
+"my/path/a.txt" 	-> "a.txt"
+"somefile.txt" 		-> "somefile.txt"
+"/awesome/path" 	-> "path"
+```
+
+#### `FS.GetExtension(path: string) -> string`
+
+Возвращает расширение файла или пустую строку, если расширения нет. Вот несколько примеров входов + выходов
+
+```lua
+input -> output
+
+"myfile.txt" 					-> ".txt"
+"somefile." 					-> "."
+"/awesome/path" 				-> ""
+"/awesome/path/file.zip.txt"	-> ".txt"
+"myexe.exe" 					-> ".exe"
+```
+
+#### `FS.GetParentFolder(path: string) -> string`
+
+Возвращает путь к родительскому каталогу, т. е. папке, в которой содержится файл или папка. Вот несколько примеров входных и выходных данных:
+
+```lua
+input -> output
+
+"/var/tmp/example.txt" 		-> "/var/tmp"
+"/"							-> "/"
+"mydir/a/b/c.txt"			-> "mydir/a/b"
+```
+
+#### `FS.Exists(path: string) -> bool`
+
+Возвращает `true` если путь существует, `false` если нет.
+
+#### `FS.IsDirectory(path: string) -> bool`
+
+Возвращает `true` , если указанный путь является каталогом, `false` если нет. Обратите внимание, что `false` НЕ подразумевает, что путь является файлом (см. `FS.IsFile()` ).
+
+#### `FS.IsFile(path: string) -> bool`
+
+Возвращает `true` , если указанный путь является обычным файлом (не символической ссылкой, жесткой ссылкой, блочным устройством и т. д.), `false` если нет. Обратите внимание, что `false` НЕ подразумевает, что путь является каталогом (см. `FS.IsDirectory()` ).
+
+#### `FS.ListDirectories(path: string) -> table`
+
+Возвращает таблицу всех каталогов по указанному пути.
+
+Пример:
+
+```lua
+print(FS.ListDirectories("Resources"))
+```
+
+Результаты в:
+
+```lua
+{
+    1: "Client",
+    2: "Server"
+}
+```
+
+#### `FS.ListFiles(path: string) -> table`
+
+Возвращает таблицу всех файлов по указанному пути.
+
+Пример:
+
+```lua
+print(FS.ListFiles("Resources/Server/examplePlugin"))
+```
+
+Результаты в:
+
+```lua
+{
+    1: "example.json",
+    2: "example.lua"
+}
+```
+
+#### `FS.ConcatPaths(...) -> string`
+
+Складывает (объединяет) все аргументы с предпочитаемым разделителем пути системы.
+
+Пример:
+
+```lua
+FS.ConcatPaths("a", "b", "/c/d/e/", "/f/", "g", "h.txt")
+```
+
+результаты в
+
+```
+a/b/c/d/e/f/g/h.txt
+```
+
+Также разрешает `..` , если он существует в пути в любой точке. Эта функция безопаснее, чем конкатенация строк в lua, и учитывает разделители платформы.
+
+Пожалуйста, всегда используйте `/` в качестве разделителя при указании путей, так как это кроссплатформенно (windows, linux, macos, ...).
+
+### События
+
+#### Объяснение
+
+- Аргументы: Список аргументов, переданных обработчикам этого события.
+- Отменяемое: Можно ли отменить событие. Если его можно отменить, обработчик может сделать это, вернув `1` , например `return 1` .
+
+#### Краткое изложение событий
+
+Присоединение игрока вызывает следующие события в указанном порядке:
+
+1. `onPlayerAuth`
+2. `onPlayerConnecting`
+3. `onPlayerJoining`
+4. `onPlayerJoin`
+
+#### Системные события
+
+##### `onInit`
+
+Аргументы: НЕТ Отменяемо: НЕТ
+
+Срабатывает сразу после инициализации всех файлов в плагине.
+
+##### `onConsoleInput`
+
+Аргументы: `input: string` Отменяемость: НЕТ
+
+Срабатывает, когда консоль BeamMP получает входной сигнал.
+
+##### `onShutdown`
+
+Аргументы: НЕТ Отменяемо: НЕТ
+
+Срабатывает при отключении сервера. В настоящее время происходит после того, как все игроки были выгнаны.
+
+#### События, связанные с игрой
+
+##### `onPlayerAuth`
+
+Аргументы: `player_name: string` , `player_role: string` , `is_guest: bool` , `identifiers: table -> beammp, ip` Возможность отмены: ДА
+
+Первое событие, которое срабатывает, когда игрок хочет присоединиться. Игроку может быть отказано в присоединении, если вернуть `1` или причину ( `string` ) из функции-обработчика.
+
+```lua
+function myPlayerAuthorizer(name, role, is_guest, identifiers)
+	return "Sorry, you cannot join at this time."
+end
+MP.RegisterEvent("onPlayerAuth", "myPlayerAuthorizer")
+```
+
+##### `onPlayerConnecting`
+
+Аргументы: `player_id: number` Возможность отмены: НЕТ
+
+Срабатывает, когда игрок впервые начинает подключение, после `onPlayerAuth` .
+
+##### `onPlayerJoining`
+
+Аргументы: `player_id: number` Возможность отмены: НЕТ
+
+Срабатывает, когда игрок завершил загрузку всех модов, после `onPlayerConnecting` .
+
+##### `onPlayerDisconnect`
+
+Аргументы: `player_id: number` Возможность отмены: НЕТ
+
+Срабатывает при отключении игрока.
+
+##### `onChatMessage`
+
+Аргументы: `player_id: number` , `player_name: string` , `message: string` Возможность отмены: ДА
+
+Срабатывает, когда игрок отправляет сообщение в чате. При отмене сообщение в чате не будет показано никому, даже игроку, который его отправил.
+
+##### `onVehicleSpawn`
+
+Аргументы: `player_id: number` , `vehicle_id: number` , `data: string` Возможность отмены: ДА
+
+Срабатывает, когда игрок создает новое транспортное средство. Аргумент `data` содержит конфигурацию автомобиля и данные о положении/вращении для транспортного средства в виде строки json.
+
+##### `onVehicleEdited`
+
+Аргументы: `player_id: number` , `vehicle_id: number` , `data: string` Возможность отмены: ДА
+
+Срабатывает, когда игрок редактирует свое транспортное средство и применяет редактирование. Аргумент `data` содержит обновленную конфигурацию автомобиля в виде строки json, но **не** включает данные о положении или вращении. Вы можете использовать [MP.GetPositionRaw](#mpgetpositionrawpid-number-vid-number-tablestring) для получения данных о положении и вращении.
+
+##### `onVehicleDeleted`
+
+Аргументы: `player_id: number` , `vehicle_id: number` Возможность отмены: НЕТ
+
+Срабатывает, когда игрок удаляет свое транспортное средство.
+
+##### `onVehicleReset`
+
+Аргументы: `player_id: number` , `vehicle_id: number` , `data: string` Возможность отмены: НЕТ
+
+Срабатывает, когда игрок сбрасывает свое транспортное средство. `data` — это обновленное положение и вращение автомобиля, однако **не** включают конфигурацию транспортных средств. Вы можете использовать [MP.GetPlayerVehicles](#mpgetplayervehiclesplayer_id-number-table) , чтобы получить конфигурацию транспортных средств.
+
+##### `onFileChanged`
+
+*начиная с версии 3.1.0*
+
+Аргументы: `path: string` Возможность отмены: НЕТ
+
+Срабатывает при изменении файла в каталоге `Resources/Server` *или любом его подкаталоге* .
+
+Любое изменение файла в каталоге `Resources/Server/<plugin>` (не в его подпапке) вызовет перезагрузку состояния Lua и событие `onFileChanged` .
+
+Любой файл в подпапках `Resources/Server/<plugin>` , например `Resources/Server/<plugin>/lua/stuff.lua` , не вызовет перезагрузку состояния, а только вызовет событие `onFileChanged` . Таким образом, вы можете перезагрузить его самостоятельно правильным образом (или не перезагружать).
+
+Это относится ко всем файлам, а не только к файлам `.lua` .
+
+`path` указывается относительно корня сервера, например `Resources/Server/myplugin/myfile.txt` . Вы можете выполнить дальнейшую обработку этой строки с помощью семейства функций `FS.*` , например, извлечь имя или расширение ( `FS.GetExtension(...)` , `FS.GetFilename(...)` , ...).
+
+Примечание: файлы, добавленные после запуска сервера, *не* отслеживаются, начиная с версии 3.1.0.
+
+### Миграция со старого Lua
+
+Это краткий обзор основных шагов, которые необходимо предпринять для перехода со старого на новый lua.
+
+#### Понять, как работает новый lua
+
+Для этого внимательно прочтите раздел [«Введение»](#how-to-start-writing-a-plugin) и все его подразделы. Необходимо правильно выполнить следующие шаги.
+
+#### Найти и заменить
+
+Сначала вам следует выполнить поиск и замену всех функций MP. Подстановка должна добавить `MP.` перед всеми функциями MP, за исключением `print()` .
+
+Пример:
+
+```lua
+local players = GetPlayers()
+print(#players)
+```
+
+становится
+
+```lua
+local players = MP.GetPlayers()
+print(#players) -- note how print() doesn't change
+```
+
+#### Прощайте, темы, привет, таймеры событий!
+
+Как обсуждалось во введении, потоки — это таймеры событий. Для любых вызовов `CreateThread` замените его вызовом `CreateEventTimer` . Внимательно проверьте время, которое имел ваш старый CreateThread (число было X в секунду), и подумайте о том, какое значение тайм-аута таймера событий для этого (которое указывается в миллисекундах). Также имейте в виду, что вместо имени функции он принимает имя события, поэтому вам придется также зарегистрировать событие.
+
+Пример:
+
+```lua
+CreateThread("myFunction", 2) -- calls "myFunction" twice per second
+```
+
+становится
+
+```lua
+MP.RegisterEvent("myEvent", "myFunction") -- registering our event for the timer
+MP.CreateEventTimer("myEvent", 500) -- 500 milliseconds = 2 times per second
+```
+
+Если у вас много таймеров событий, имеет смысл попробовать объединить их, например, создав событие "ежеминутное" и зарегистрировав в нем несколько функций, которые нужно вызывать каждую минуту, вместо того, чтобы иметь несколько таймеров событий. Каждый таймер событий требует от сервера немного времени для срабатывания.
+
+#### Больше никаких неявных вызовов событий
+
+Вам нужно регистрировать все ваши события. Вы не можете полагаться на имена функций. В старом lua это было неясно, но в новом lua это обычно соблюдается. Хороший шаблон:
+
+```lua
+MP.RegisterEvent("onChatMessage", "chatMessageHandler")
+-- or
+MP.RegisterEvent("onChatMessage", "handleChatMessage")
+```
+
+Это лучше, чем называть обработчик тем же, что и событие, что вводит в заблуждение и сбивает с толку.
+
+
diff --git a/docs/ru/scripting/server/v2-server-reference.md b/docs/ru/scripting/server/v2-server-reference.md
new file mode 100644
index 00000000..1ab32003
--- /dev/null
+++ b/docs/ru/scripting/server/v2-server-reference.md
@@ -0,0 +1,384 @@
+!!! предупреждение "Этот сайт находится в стадии разработки!"
+
+```
+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 any page too.
+```
+
+# Справочник по серверным скриптам
+
+## Версия сервера 2.X
+
+!!! предупреждение
+
+```
+BeamMP server version 2.X is now unsupported. This documentation is provided as a reference only.
+Please update to the latest version for maintenance and support.
+```
+
+---
+
+> Это скрипт 2.x. Обращайтесь к нему только если ваш сервер старый/устаревший (версия 2.xx). Для получения последней документации см. [здесь](https://docs.beammp.com/scripting/server/latest-server-reference) . {.is-warning}
+
+### Примечания
+
+Чтобы получить вывод функции в консоли сервера, вам нужно обернуть его в оператор `print()` . Например: `print(GetPlayerName(0))` вернет имя первого игрока вашего сервера.
+
+`<PlayersServerID>` начинается с 0.
+
+### Список доступных функций для написания скриптов
+
+#### GetPlayerName(идентификатор_сервера_игроков)
+
+Возвращает имя игрока в Discord в виде строки
+
+```lua
+function onPlayerJoin(playerID)
+	local name = GetPlayerName(playerID)
+	-- Do something
+end
+```
+
+#### GetPlayerDiscordID(playersServerID)
+
+Возвращает имя игрока в Discord в виде строки
+
+```lua
+function onPlayerJoin(playerID)
+	local name = GetPlayerDiscordID(playerID)
+	-- Do something
+end
+```
+
+#### GetPlayerHWID(идентификатор_сервера_игроков)
+
+Возвращает идентификатор игрока в Discord в виде строки
+
+```lua
+function onPlayerJoin(playerID)
+	local name = GetPlayerHWID(playerID)
+	-- Do something
+end
+```
+
+#### GetPlayerVehicles(идентификатор_сервера_игроков)
+
+Возвращает транспортные средства игрока в виде объекта/массива.
+
+```lua
+function onChatMessage(playerID, senderName, message)
+	local vehicleList = GetPlayerVehicles(playerID)
+	for vehicleID, vehicleData in pairs(vehicleList) do
+  	-- Do something
+    -- Could also be used to check how many vehicles a player have
+	end
+end
+```
+
+#### DropPlayer(идентификатор_сервера_игроков)
+
+Сбрасывает соединение для определенного игрока. По сути выгоняет его
+
+```lua
+function onVehicleSpawn(playerID, vehicleID, vehicleData)
+	-- Do something
+	DropPlayer(playerID)
+end
+```
+
+#### SendChatMessage(playersServerID, сообщение)
+
+Отправляет сообщение по сети указанному пользователю. Используйте -1 для всех
+
+```lua
+function onPlayerJoin(playerID)
+	SendChatMessage(-1, "Someone just joined!")
+end
+```
+
+#### CancelEvent() -- УСТАРЕЛО
+
+Отменяет событие. Это может произойти скоро. Используйте `return 1` чтобы отменить событие.
+
+#### onInit()
+
+Если объявлено в файле lua, оно будет вызвано после того, как C++ успешно завершит загрузку текущего файла lua.
+
+```lua
+function onInit()
+	print("Server ready")
+end
+```
+
+#### Выход()
+
+Закрою сервер.
+
+```lua
+function onInit()
+	print("Server Ready. But who needs a server which is running")
+	exit() -- Stops the server
+end
+```
+
+#### CreateThread(имя_функции, интервал_вызова)
+
+Функция будет выполняться в выделенном потоке, и она будет запускать callInterval раз в секунду. 1 = Она будет запускаться каждую секунду.
+
+```lua
+function yourFunction()
+ 	for i = 1,10 do
+		SendChatMessage(-1, "Countdown: "..i)
+		Sleep(1000)
+	end
+end
+CreateThread("yourFunction", 30)
+```
+
+УСТАРЕВШИЙ ПРИМЕР Функция будет выполняться в выделенном потоке
+
+```lua
+function yourFunction()
+ 	for i = 1,10 do
+		SendChatMessage(-1, "Countdown: "..i)
+		Sleep(1000)
+	end
+end
+CreateThread("yourFunction", 30)
+```
+
+#### StopThread(имя_функции)
+
+Прекратит попытки вызвать функцию потока текущего скрипта.
+
+```lua
+function yourFunction()
+	delayExpired = false
+	Sleep(10000)
+	delayExpired = true
+end
+CreateThread("yourFunction", 30)
+-- Do something
+if not delayExpired then
+	StopThread("yourFunction")
+else
+	-- Do something
+end
+
+```
+
+#### Сон (миллисек) - ИЗНОС
+
+Приостановит выполнение на указанное время (предупреждение: это приведет к приостановке всего сервера, если вы не создали поток)
+
+```lua
+function countdown()
+ 	for i = 1,10 do
+		SendChatMessage(-1, "Countdown: "..i)
+		Sleep(1000)
+	end
+end
+CreateThread("countdown", 10)
+```
+
+#### ПолучитьPlayerCount()
+
+Вернет количество подключенных игроков
+
+```lua
+function onPlayerJoin(playerID)
+	SendChatMessage(playerID, "You are the "..GetPlayerCount().."th player!"
+end
+```
+
+#### RemoveVehicle(playerServerID, VehicleID)
+
+Исчезнет транспортное средство.
+
+```lua
+function onVehicleSpawn(playerID, vehicleID, vehicleData)
+	if --[[ Vehicle data equal something it shouldn't be ]] then
+		RemoveVehicle(playerID, vehicleIID)
+	end
+end
+```
+
+#### ПолучитьИгроков()
+
+Вернет таблицу идентификаторов с именами
+
+```lua
+local function onPlayerJoin(joinedPlayerID)
+	local players = GetPlayers()
+	for playerID, playerName in pairs(players) do
+		if playerID == joinedPlayerID then
+			-- Do something
+		end
+	end
+end
+```
+
+#### RegisterEvent(имя_события, имя_функции)
+
+Зарегистрирует эту функцию для указанного события. Оба должны быть строками
+
+```lua
+  function anyEvent()
+		-- Do something
+  	end
+	RegisterEvent("onAnyEventHappen", "anyEvent")
+	-- Do something
+	TriggerLocalEvent("onAnyEventHappen")
+```
+
+#### TriggerLocalEvent(имя_события)
+
+Будет вызывать каждую зарегистрированную функцию в той же папке плагина.
+
+```lua
+  function anyEvent()
+		-- Do something
+  	end
+	RegisterEvent("onAnyEventHappen", "anyEvent")
+	-- Do something
+	TriggerLocalEvent("onAnyEventHappen")
+```
+
+#### TriggerGlobalEvent(имя_события)
+
+Будет вызывать каждую зарегистрированную функцию с этим именем события.
+
+```lua
+	-- File A
+  function anyEvent()
+		-- Do something
+  	end
+	RegisterEvent("onAnyEventHappen", "anyEvent")
+```
+
+```lua
+  	-- File B
+	TriggerGlobalEvent("onAnyEventHappen")
+```
+
+#### TriggerClientEvent(playerServerID, eventName, data)
+
+Вызовет это событие с указанными данными на указанном клиенте (-1 для широковещательной передачи)
+
+```lua
+  function onPlayerJoin(playerServerID)
+     TriggerClientEvent(playerServerID, "anyEvent", "You just joined the server")
+  end
+	RegisterEvent("onAnyEventHappen", "anyEvent")
+```
+
+#### Установить(configID, newValue)
+
+установит настройку конфигурации на новое указанное значение из таблицы ниже|
+
+```lua
+  function onChatMessage(playerID, senderName, message)
+    if playerID == adminPlayer then
+      if message == --[[ anything ]] then
+        Set(3, 10)
+      end
+    end
+  end
+```
+
+#### Список доступных настроек конфигурации для команды `Set()`
+
+> Обратите внимание, что они не будут сохранены в файле конфигурации.
+
+Идентификатор конфигурации | Имя | Приму только
+--- | --- | ---
+`0` | Настройка отладки | правда или ложь
+`1` | Частная обстановка | правда или ложь
+`2` | Макс. количество автомобилей на игрока | число
+`3` | Макс. количество игроков | число
+`4` | Карта | нить
+`5` | Имя | нить
+`6` | Описание | нить
+любой другой идентификатор приведет к появлению предупреждения на консоли |  |
+
+### Список доступных событий для написания сценариев
+
+#### События по умолчанию
+
+Пример использования события:
+
+```lua
+	function onInit()
+  	RegisterEvent("onPlayerJoin", "onPlayerJoin")
+  end
+  
+  function onPlayerJoin(playerServerID)
+  	-- Do something
+  end
+```
+
+Если вы не хотите, чтобы на вашем сервере были гости:
+
+```lua
+	function onInit()
+		print("noGuests Ready")
+		RegisterEvent("onPlayerAuth","onPlayerAuth")
+	end
+
+	function onPlayerAuth(name, role, isGuest)
+		if isGuest then
+			return "You must be signed in to join this server!"
+		end
+	end
+```
+
+Событие | Параметры | Описание
+--- | --- | ---
+`onPlayerAuth` | Имя игрока, роль на форуме, гостевая учетная запись (bool) | Игрок прошел аутентификацию и запрашивает присоединение
+`onPlayerConnecting` | Идентификатор игрока | Игрок загружается (до загрузки карты)
+`onPlayerJoining` | Идентификатор игрока | Игрок загружает карту и скоро присоединится
+`onPlayerJoin` | Идентификатор игрока | Игрок присоединился и загрузился
+`onPlayerDisconnect` | Идентификатор игрока | Игрок отключился
+`onChatMessage` | Идентификатор отправителя, имя и сообщение чата | Сообщение чата было отправлено. Это было бы хорошо для создания системы команд
+`onVehicleSpawn` | Идентификатор игрока, идентификатор транспортного средства и данные транспортного средства | Это называется, когда кто-то создает транспортное средство.
+`onVehicleEdited` | Идентификатор игрока, идентификатор транспортного средства и данные транспортного средства | Это называется, когда кто-то редактирует транспортное средство или заменяет существующее.
+`onVehicleDeleted` | Идентификатор игрока и идентификатор транспортного средства | Это называется, когда кто-то удаляет принадлежащее ему транспортное средство.
+
+#### Пользовательские события
+
+Пользовательские события также могут быть созданы для вашего собственного использования. Это делается примерно так же, как и события по умолчанию.
+
+Пример использования пользовательского события:
+
+```lua
+	function onInit()
+  	RegisterEvent("myCustomEvent", "myCustomEvent")
+  end
+  
+  function myCustomEvent(playerServerID, customData)
+  	-- Do something
+  end
+```
+
+Затем его можно вызвать либо со стороны клиента, либо со стороны сервера, используя соответствующие функции.
+
+### Игроки
+
+Когда игрок подключается к вашему серверу, ему назначается serverID, начиная с 0 и далее. serverID используются повторно; если игрок покидает сервер и снова присоединяется, ему не будет назначен новый serverID, он просто получит другой доступный. Когда сервер перезапустится, serverID будут сброшены.
+
+#### Статические идентификаторы
+
+У игроков в BeamMP есть 3 статических идентификатора, которые можно получить из их serverID: имя, discordID и hardwareID или HWID. (Хотя последний из вышеупомянутых не реализован, мы будем действовать так, как будто он реализован). Каждый из трех типов идентификаторов имеет свое собственное происхождение и сильные/слабые стороны при использовании их для идентификации игрока.
+
+ТИП ИДЕНТИФИКАТОРА | ПЛЮСЫ | МИНУСЫ | ФУНКЦИЯ ДЛЯ ПОЛУЧЕНИЯ
+--- | --- | --- | :-:
+имя | легко получить, просто | не безопасно | ПолучитьИмяИгрока()
+DiscordID | довольно безопасно | неудобно | GetPlayerDiscordID()
+HWID | чрезвычайно безопасно | трудно получить | GetPlayerHWID()
+
+### Транспортные средства
+
+У транспортных средств в beamMP есть 3 атрибута, на которые обращает внимание сервер: serverID владельца, vehicleID транспортного средства и его данные. ServerID владельца прост, это serverID, у каждого транспортного средства также есть ID, идентификаторы транспортных средств не уникальны для транспортного средства; два транспортных средства могут иметь одинаковый ID, если они принадлежат разным владельцам. В отличие от serverID, vehicleID используются повторно, например, если у меня есть 4 транспортных средства, их идентификаторы — 0, 1, 2 и 3, если я удалю транспортное средство в vehicleID 2, у меня будут 0, 1 и 3, когда я создам новое транспортное средство, новое транспортное средство будет помещено в слот ID 2. Наконец, последний атрибут, который есть у транспортных средств, — это data, data содержит транспортное средство, название, детали и другие данные; как следует из названия. data хранится в виде необработанной строки JSON, поэтому вам понадобится библиотека JSON. В качестве альтернативы вы можете вручную пройти по строке и извлечь необходимую информацию.
diff --git a/docs/ru/server/server-maintenance.md b/docs/ru/server/server-maintenance.md
new file mode 100644
index 00000000..ff32c14a
--- /dev/null
+++ b/docs/ru/server/server-maintenance.md
@@ -0,0 +1,237 @@
+# Обслуживание сервера
+
+Руководства, советы и рекомендации по настройке и обслуживанию сервера BeamMP.
+
+## Как установить
+
+Инструкции по установке см. в разделе [Установка сервера](create-a-server.md) .
+
+## Файл ServerConfig
+
+Конфигурация сервера, представляющая собой файл `ServerConfig.toml` , использует [формат TOML](https://toml.io/en/) .
+
+*ПРИМЕЧАНИЕ* : *Старый* файл конфигурации сервера назывался `Server.cfg` , но он больше не используется, и сервер выдаст предупреждение, если он все еще присутствует. Также обратите внимание, что два формата конфигурации **несовместимы** друг с другом.
+
+По умолчанию в конфигурации есть один раздел, называемый `[General]` , который содержит следующие значения:
+
+Ключ | Тип значения | Описание
+--- | --- | ---
+AuthKey | Формат AuthKey `xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx` где все x — буквенно-цифровые символы (цифры и буквы) | Используется для идентификации вашего сервера с бэкэндом. Вы должны были получить его, следуя инструкциям по установке.
+Отлаживать | правда/ложь | При включении (true) будет отображаться больше сообщений в журнале и предоставляться больше информации. Включите это, если у вас возникнут проблемы. Включение этого параметра значительно увеличит размер файла журнала.
+Частный | правда/ложь | Если включено (true), ваш сервер не будет отображаться в списке серверов. Любой с правильным IP и портом все равно сможет подключиться.
+Описание | Любой "текст" | Отображается как описание сервера в списке серверов (если сервер публичный). Вы можете использовать специальные символы для форматирования с помощью цветов и стилей.
+Имя | Любой "текст" | Отображается как имя/заголовок вашего сервера в списке серверов. Вы можете использовать специальные символы для форматирования с помощью цветов и стилей.
+Карта | Допустимое местоположение на карте, например `/levels/gridmap_v2/info.json` | Карта, которую будет размещать ваш сервер. Должна быть установлена либо по умолчанию (список можно найти ниже), либо как серверный мод.
+МаксКарс | Любое число ≥ 1 | Максимальное количество машин на игрока. Любые дополнительные машины, которые игрок попытается создать, будут мгновенно удалены.
+Порт | 1024-65535 | Сетевой порт, на котором будет доступен сервер. Чтобы игрок мог напрямую подключиться к вашему серверу, ему понадобится ваш IP и этот порт.
+
+Другие разделы могут и должны использоваться серверными плагинами (скоро появится API Lua), например: `[MyMod]` .
+
+AuthKey **ДОЛЖЕН** быть установлен вами. Он будет пустым по умолчанию и должен быть заполнен вашим AuthKey с шага установки ранее. Не делитесь этим ключом ни с кем и на снимках экрана полностью размывайте его.
+
+### Все названия ванильных карт
+
+Вот все карты акций:
+
+- /levels/gridmap_v2/info.json
+- /levels/johnson_valley/info.json
+- /levels/automation_test_track/info.json
+- /levels/восточное_побережье_США/info.json
+- /levels/hirochi_raceway/info.json
+- /уровни/италия/info.json
+- /levels/jungle_rock_island/info.json
+- /уровни/промышленный/info.json
+- /levels/маленький_остров/info.json
+- /уровни/smallgrid/info.json
+- /levels/юта/info.json
+- /levels/западное_побережье_США/info.json
+- /уровни/обучение_водителей/info.json
+- /levels/derby/info.json
+
+### Настройте внешний вид имени вашего сервера
+
+Используйте эти специальные символы перед текстом, и к этому тексту в списке серверов будет применен эффект:
+
+Ценить | Описание
+:-: | ---
+`^r` | Перезагрузить
+`^p` | Новая строка (только описания)
+`^n` | Подчеркнуть
+`^l` | Смелый
+`^m` | Зачеркивание
+`^o` | Курсив
+`^0` | Черный
+`^1` | Синий
+`^2` | Зеленый
+`^3` | светло-голубой
+`^4` | Красный
+`^5` | Розовый
+`^6` | Апельсин
+`^7` | Серый
+`^8` | Темно-серый
+`^9` | Светло-фиолетовый
+`^a` | Светло-зеленый
+`^b` | светло-голубой
+`^c` | Темно-оранжевый
+`^d` | светло-розовый
+`^e` | Желтый
+`^f` | Белый
+
+### Настройте теги вашего сервера
+
+Теги могут использоваться для того, чтобы позволить людям искать определенный тип сервера. Ваш serverConfig.toml будет сгенерирован с тегом freeroam `Tags = "Freeroam"` .
+
+Вы можете добавить несколько тегов, разделенных запятой `Tags = "Events,Offroad,lang:english"` , регистр не учитывается.
+
+Вы можете выбрать из следующего списка:
+
+- Возраст/Содержание:
+
+    - `Mature/18+`
+
+- Типы игрового процесса:
+
+    - `Freeroam`
+    - `Roleplay`
+    - `Economy`
+    - `Traffic`
+
+- Категории гонок:
+
+    - `Racing`
+    - `Racing:NASCAR`
+    - `Racing:Track`
+    - `Racing:Drag`
+    - `Racing:Rally`
+    - `Touge`
+
+- Бездорожье и испытания:
+
+    - `Offroad`
+    - `Crawling`
+    - `Dakar`
+    - `Challenge`
+
+- События разрушения:
+
+    - `Derby`
+    - `Arena`
+
+- Погодные и временные условия:
+
+    - `Snow/Ice`
+    - `Rain`
+    - `Night`
+    - `Weather`
+
+- Режимы игры:
+
+    - `Gamemode`
+    - `Gamemode:Racing`
+    - `Gamemode:Rally`
+    - `Gamemode:Drag`
+    - `Gamemode:Derby`
+    - `Gamemode:Infection`
+    - `Gamemode:Cops-Robbers`
+    - `Gamemode:Delivery`
+    - `Gamemode:Sumo`
+
+- Сообщество и события:
+
+    - `Scenarios`
+    - `Events`
+    - `Leaderboard`
+
+- Модификации:
+
+    - `Modded`
+    - `Mod:BeamPaint`
+    - `Mod:BeamJoy`
+    - `Mod:CEI`
+
+- Языки:
+
+    - `Lang:English`
+    - `Lang:Russian`
+    - `Lang:French`
+    - `Lang:Spanish`
+    - `Lang:Portuguese`
+    - `Lang:German`
+    - `Lang:Polish`
+    - `Lang:Arabic`
+
+- Другой:
+
+    - `Vanilla`
+    - `Moderated`
+
+Если тег отсутствует в этом списке, вы можете отправить запрос на его добавление [здесь.](https://forum.beammp.com/t/introducing-server-tags/1320081)
+
+## Файл Server.log
+
+Этот файл будет сгенерирован при запуске сервера. Это зеркало сообщений, которые вы видите в консоли при запуске сервера. Вам следует прикреплять этот файл каждый раз, когда вам нужна поддержка от нашей службы поддержки, и он никогда не покажет ваш AuthKey, поэтому вы обычно можете отправить его без изменений.
+
+Формат следующий (префикс $ означает «переменная», пояснение ниже):
+
+```
+[$DATE $TIME] $CONTEXT [$LOG_LEVEL] $MESSAGE
+```
+
+Где:
+
+- `$DATE` — дата сообщения, например 21/07/2021
+- `$TIME` — время сообщения, например 11:05:23
+- `$CONTEXT` (виден только в режиме отладки и в основном актуален для разработчиков) — контекст сообщения, который может быть:
+    - `(Player ID) “Player Name”` , где ID игрока полезен для модерации
+    - Короткое имя, например «HeartbeatThread»
+- `$LOG_LEVEL` — один из уровней важности сообщения:
+    - `DEBUG` : отображается только в режиме отладки, обычно является спамом и важен только для разработчиков.
+    - `INFO` : Общая информация
+    - `LUA` : Сообщение от плагина Lua
+    - `WARN` : Описывает то, что не должно происходить, обычно
+    - `ERROR` : Что-то пошло не так или произошло очень неожиданно.
+    - `FATAL` : Произошло что-то, что привело к отключению сервера.
+- `$MESSAGE` само сообщение, обычно то, на что следует обратить внимание и что следует понять. В некоторых случаях это может быть зашифровано, но общее правило заключается в том, что пока нет видимых проблем с сервером и нет ОШИБОК, все хорошо.
+
+## Обновление сервера
+
+### Зачем обновлять
+
+Всякий раз, когда выходит новое обновление, вам рекомендуется обновить свой сервер. Обычно это включает исправления ошибок, улучшения стабильности и безопасности, наряду с общими новыми функциями и т. д., которые вводятся.
+
+Чтобы получать новости об обновлениях по мере их выхода, подпишитесь на канал «обновления» сервера Discord, ищите его на форумах или посетите/спросите на [странице релизов GitHub](https://github.com/BeamMP/BeamMP-Server/releases) .
+
+### Как обновить
+
+#### Если вы пользуетесь услугами хостинг-провайдера, являющегося партнером BeamMP
+
+Если вы используете хостинг-провайдера, партнера BeamMP, инструкции ниже, скорее всего, не сработают. Мы рекомендуем дождаться более подробной информации от вашего хостинг-провайдера или связаться с ним для получения помощи.
+
+#### Самостоятельное управление сервером
+
+Сервер обновляется путем замены старого исполняемого файла на новый. Если вы не уверены, как это сделать, ниже приведены пошаговые инструкции для Windows и Linux.
+
+Если вы собрали из исходников, просто пересоберите. Убедитесь, что выполнили `git submodule update --init --recursive` перед пересборкой.
+
+#### В Windows
+
+1. Для запуска сервера убедитесь, что у вас установлены [распространяемые компоненты Visual C++](https://aka.ms/vs/17/release/vc_redist.x64.exe) .
+2. Перейдите на [BeamMP.com](https://beammp.com/) и нажмите кнопку «Загрузить сервер».
+3. После загрузки вы должны увидеть один файл с именем `BeamMP-Server.exe` . Мы назовем его «новый исполняемый файл».
+4. Перейдите в папку, где находится ваш текущий исполняемый файл `BeamMP-Server.exe` (обычно это та же папка, где находится ваш `ServerConfig.toml` ). Мы будем называть его «старым исполняемым файлом».
+5. Замените старый исполняемый файл новым исполняемым файлом (например, скопировав или переместив новый исполняемый файл в папку).
+
+#### На Линуксе
+
+1. Перейдите на [BeamMP.com](https://beammp.com/) и нажмите кнопку «Загрузить сервер», вы будете перенаправлены на страницу релиза сервера на Github.
+2. Загрузите правильную версию для вашего дистрибутива. Для простоты теперь он будет называться `BeamMP-Server-xxx` , где `xxx` обозначает версию для используемого вами дистрибутива.
+3. После загрузки вы должны увидеть один файл с именем `BeamMP-Server-xxx` в зависимости от версии, которую вы скачали. Мы назовем его «новый исполняемый файл».
+4. Перейдите в папку, где находится ваш текущий исполняемый файл `BeamMP-Server-xxx` (обычно это та же папка, где находится ваш `ServerConfig.toml` ). Мы будем называть его «старым исполняемым файлом».
+5. Замените старый исполняемый файл новым исполняемым файлом (например, скопировав или переместив новый исполняемый файл в папку).
+6. Откройте терминал в той папке, где вы только что заменили исполняемый файл, и выполните `sudo chmod +x BeamMP-Server-xxx` . Это позволит убедиться, что сервер может быть запущен.
+
+### Автоматические обновления
+
+Сервер не поддерживает автоматические обновления или уведомления об обновлениях (пока).
+
+Однако вы можете запросить API GitHub для получения последней версии, проверив версию сервера по тегам. Вы можете получить это с помощью GET из `https://api.github.com/repos/BeamMP/BeamMP-Server/git/refs/tags` .
diff --git a/docs/zh/scripting/server/v2-server-reference.md b/docs/zh/scripting/server/v2-server-reference.md
new file mode 100644
index 00000000..2d64f1e3
--- /dev/null
+++ b/docs/zh/scripting/server/v2-server-reference.md
@@ -0,0 +1,385 @@
+!!! 警告 "这个网站正在建设中！"
+
+```
+这个网站正在积极建设中。
+
+觉得你能帮上忙吗？请用铅笔在右侧点击页面！
+
+这也可以在任何页面上完成。
+```
+
+# 服务器脚本参考
+
+## 服务器端版本 2.X
+
+!!! 警告
+
+```
+BeamMP 服务器版本 2.X 已不再提供支持。
+本文档仅供参考。
+请更新到最新版本以进行维护和支持。
+```
+
+---
+
+> 这是 2.x 的脚本，仅当你的服务器端版本是老的/过时的(version 2.x.x)， 时才能使用此方法，有关最新文档，请参见 [这里](https://docs.beammp.com/scripting/server/latest-server-reference)。 {.is-warning}
+
+### 说明
+
+要在服务器控制台中获得函数的输出，必须将其包装在`print()`语句中。例如：`print(GetPlayerName(0))`将返回服务器上第一个玩家的名字。
+
+`<PlayersServerID>` 从0开始。
+
+### 用于编写脚本的可用函数列表
+
+#### GetPlayerName(playersServerID)
+
+以字符串形式返回玩家的Discord名称
+
+```lua
+function onPlayerJoin(playerID)
+	local name = GetPlayerName(playerID)
+	-- Do something
+end
+```
+
+#### GetPlayerDiscordID(playersServerID)
+
+以字符串形式返回玩家的Discord名称
+
+```lua
+function onPlayerJoin(playerID)
+	local name = GetPlayerDiscordID(playerID)
+	-- Do something
+end
+```
+
+#### GetPlayerHWID(playersServerID)
+
+以字符串形式返回玩家的Discord ID
+
+```lua
+function onPlayerJoin(playerID)
+	local name = GetPlayerHWID(playerID)
+	-- Do something
+end
+```
+
+#### GetPlayerVehicles(playersServerID)
+
+返回玩家的车辆作为一个对象/数组
+
+```lua
+function onChatMessage(playerID, senderName, message)
+	local vehicleList = GetPlayerVehicles(playerID)
+	for vehicleID, vehicleData in pairs(vehicleList) do
+  	-- Do something
+    -- Could also be used to check how many vehicles a player have
+	end
+end
+```
+
+#### DropPlayer(playersServerID)
+
+断开特定玩家的连接。“其实就是踢出玩家”
+
+```lua
+function onVehicleSpawn(playerID, vehicleID, vehicleData)
+	-- Do something
+	DropPlayer(playerID)
+end
+```
+
+#### SendChatMessage(playersServerID, message)
+
+通过网络向指定的用户发送消息。每个人都用-1
+
+```lua
+function onPlayerJoin(playerID)
+	SendChatMessage(-1, "Someone just joined!")
+end
+```
+
+#### CancelEvent() -- DEPRECIATED
+
+取消事件的发生。这可能很快就会发生。使用`return 1`来取消事件。
+
+#### onInit()
+
+如果在lua文件中声明，它将在c++成功加载当前lua文件后被调用
+
+```lua
+function onInit()
+	print("Server ready")
+end
+```
+
+#### exit()
+
+将关闭服务器
+
+```lua
+function onInit()
+	print("Server Ready. But who needs a server which is running")
+	exit() -- Stops the server
+end
+```
+
+#### CreateThread(functionName, callInterval)
+
+将在专用线程上执行该函数，它将每秒运行callInterval数次。它每秒钟都会跑一次。
+
+```lua
+function yourFunction()
+ 	for i = 1,10 do
+		SendChatMessage(-1, "Countdown: "..i)
+		Sleep(1000)
+	end
+end
+CreateThread("yourFunction", 30)
+```
+
+已弃用示例：将在专用线程上执行该函数
+
+```lua
+function yourFunction()
+ 	for i = 1,10 do
+		SendChatMessage(-1, "Countdown: "..i)
+		Sleep(1000)
+	end
+end
+CreateThread("yourFunction", 30)
+```
+
+#### StopThread(functionName)
+
+将停止尝试调用当前脚本的线程函数
+
+```lua
+function yourFunction()
+	delayExpired = false
+	Sleep(10000)
+	delayExpired = true
+end
+CreateThread("yourFunction", 30)
+-- Do something
+if not delayExpired then
+	StopThread("yourFunction")
+else
+	-- Do something
+end
+
+```
+
+#### Sleep(millisecs) - DEPRECIATED
+
+将暂停执行指定的时间（警告，如果没有创建线程，将暂停整个服务器）
+
+```lua
+function countdown()
+ 	for i = 1,10 do
+		SendChatMessage(-1, "Countdown: "..i)
+		Sleep(1000)
+	end
+end
+CreateThread("countdown", 10)
+```
+
+#### GetPlayerCount()
+
+将返回多少玩家连接
+
+```lua
+function onPlayerJoin(playerID)
+	SendChatMessage(playerID, "You are the "..GetPlayerCount().."th player!"
+end
+```
+
+#### RemoveVehicle(playerServerID, VehicleID)
+
+这会导致一辆载具消失。
+
+```lua
+function onVehicleSpawn(playerID, vehicleID, vehicleData)
+	if --[[ Vehicle data equal something it shouldn't be ]] then
+		RemoveVehicle(playerID, vehicleIID)
+	end
+end
+```
+
+#### GetPlayers()
+
+将返回一个带有name的id表
+
+```lua
+local function onPlayerJoin(joinedPlayerID)
+	local players = GetPlayers()
+	for playerID, playerName in pairs(players) do
+		if playerID == joinedPlayerID then
+			-- Do something
+		end
+	end
+end
+```
+
+#### RegisterEvent(eventName, functionName)
+
+将该函数注册到指定的事件，都必须是字符串。
+
+```lua
+  function anyEvent()
+		-- Do something
+  	end
+	RegisterEvent("onAnyEventHappen", "anyEvent")
+	-- Do something
+	TriggerLocalEvent("onAnyEventHappen")
+```
+
+#### TriggerLocalEvent(eventName)
+
+将调用同一插件文件夹中的每个注册函数。
+
+```lua
+  function anyEvent()
+		-- Do something
+  	end
+	RegisterEvent("onAnyEventHappen", "anyEvent")
+	-- Do something
+	TriggerLocalEvent("onAnyEventHappen")
+```
+
+#### TriggerGlobalEvent(eventName)
+
+将使用此事件名称调用每个已注册的函数。
+
+```lua
+	-- File A
+  function anyEvent()
+		-- Do something
+  	end
+	RegisterEvent("onAnyEventHappen", "anyEvent")
+```
+
+```lua
+  	-- File B
+	TriggerGlobalEvent("onAnyEventHappen")
+```
+
+#### TriggerClientEvent(playerServerID, eventName, data)
+
+将使用给定的数据在指定的客户端（-1 表示广播）上触发该事件。
+
+```lua
+  function onPlayerJoin(playerServerID)
+     TriggerClientEvent(playerServerID, "anyEvent", "You just joined the server")
+  end
+	RegisterEvent("onAnyEventHappen", "anyEvent")
+```
+
+#### Set(configID, newValue)
+
+会将配置设置修改为下方表格中指定的新值。
+
+```lua
+  function onChatMessage(playerID, senderName, message)
+    if playerID == adminPlayer then
+      if message == --[[ anything ]] then
+        Set(3, 10)
+      end
+    end
+  end
+```
+
+#### 可用于 `Set()` 命令的配置项列表
+
+> Note that these will not save to the config file.
+
+Config ID | 名称 | 只接受以下内容
+--- | --- | ---
+`0` | 调试设置 | true 或 false
+`1` | 私人设置 | true 或 false
+`2` | 每个玩家的最大车辆数 | 数字
+`3` | 最大玩家数 | 数字
+`4` | 地图 | 字符串
+`5` | 名称 | 字符串
+`6` | 描述 | 字符串
+任何其他ID都会导致控制台警告 |  |
+
+### 用于编写脚本的可用事件列表
+
+#### 默认事件
+
+如何使用事件的示例:
+
+```lua
+	function onInit()
+  	RegisterEvent("onPlayerJoin", "onPlayerJoin")
+  end
+  
+  function onPlayerJoin(playerServerID)
+  	-- Do something
+  end
+```
+
+如果你不希望访客进入你的服务器：
+
+```lua
+	function onInit()
+		print("noGuests Ready")
+		RegisterEvent("onPlayerAuth","onPlayerAuth")
+	end
+
+	function onPlayerAuth(name, role, isGuest)
+		if isGuest then
+			return "You must be signed in to join this server!"
+		end
+	end
+```
+
+事件 | 参数 | 描述
+--- | --- | ---
+`onPlayerAuth` | 玩家的名称、论坛角色、是否为访客账号（布尔值） | 有一名玩家已通过验证并正在请求加入。
+`onPlayerConnecting` | 玩家的ID | 玩家正在加载（在加载地图之前）
+`onPlayerJoining` | 玩家的ID | 玩家正在加载地图，很快就会加入
+`onPlayerJoin` | 玩家的ID | 玩家已加入并加载
+`onPlayerDisconnect` | 玩家的ID | 玩家退出了游戏
+`onChatMessage` | 发消息的玩家的ID、昵称和聊天消息 | 发送了一条聊天消息。这对于创建命令系统非常有用
+`onVehicleSpawn` | 玩家ID，车辆ID和车辆数据 | 当有人刷出一辆车时输出
+`onVehicleEdited` | 玩家ID，车辆ID和车辆数据 | 当有人编辑车辆或替换现有车辆时，就会调用此操作
+`onVehicleDeleted` | 玩家的ID和车辆ID | 当某人删除自己拥有的车辆时，就会调用此操作
+
+#### 自定义事件
+
+可以创建自定义事件以供自己使用。这与默认值的处理方式非常相似。
+
+如何使用自定义事件的范例:
+
+```lua
+	function onInit()
+  	RegisterEvent("myCustomEvent", "myCustomEvent")
+  end
+  
+  function myCustomEvent(playerServerID, customData)
+  	-- Do something
+  end
+```
+
+接着可以使用各自的函数从客户端或服务器端调用该函数。
+
+### 玩家
+
+当玩家连接到你的服务器时，他们会被分配一个从 0 开始递增的 serverID。<br>serverID 会被重复利用；如果玩家离开后再次加入，他们不会获得新的 serverID，而是会被分配一个当前可用的 serverID。<br>当服务器重新启动时，serverID 会被重置。
+
+#### 静态标识符
+
+BeamMP 中的玩家拥有 3 个可通过其 serverID 获取的静态标识符，分别是他们的名称、discordID，以及硬件ID（HWID）。<br>（尽管最后一个尚未实现，但在此处我们将假设它已实现。）<br>这三种 ID 类型各自具有不同的来源，以及在玩家识别用途上的优点和缺点。
+
+ID 类型 | 优点 | 缺点 | 获取的函数
+--- | --- | --- | :-:
+name | 容易获得，直截了当 | 不安全 | GetPlayerName()
+discordID | 非常安全 | 不方便 | GetPlayerDiscordID()
+HWID | 超级安全 | 难获得 | GetPlayerHWID()
+
+### 车辆
+
+BeamMP 中的车辆有 3 个服务器会关注的属性：车辆所属者的 serverID、车辆的 vehicleID 以及车辆的数据。<br>所属者的 serverID 很简单，它就是玩家的 serverID。每辆车也有一个 vehicleID，但 vehicleID 并不是车辆唯一的；来自不同玩家的两辆车可能拥有相同的 vehicleID。<br>与 serverID 不同，vehicleID 会被重复使用。例如，如果我有 4 辆车，它们的 ID 分别是 0、1、2 和 3。如果我删除 vehicleID 为 2 的车辆，我就只剩下 0、1 和 3。当我生成一辆新车时，这辆新车会占用 ID 2。<br>最后，车辆的第三个属性是 data。data 包含车辆名称、部件以及其他数据，顾名思义。data 是以原始 JSON 字符串存储的，因此你需要使用 JSON 库来解析它，或者你也可以手动逐步解析字符串，提取所需的信息。
diff --git a/docs/zh/server/error-codes.md b/docs/zh/server/error-codes.md
new file mode 100644
index 00000000..41d68b34
--- /dev/null
+++ b/docs/zh/server/error-codes.md
@@ -0,0 +1,20 @@
+# 错误代码
+
+此页面包含服务器可能显示的所有错误代码。
+
+---
+
+错误代码 | 描述 | 可能的解决方案
+--- | --- | ---
+10022 | 绑定端口时出现问题 | 检查该端口是否已被其他服务占用，如果是，请更换为其他端口。
+10048 | 地址已被占用 | 有另一个 BeamMP 服务器或程序正在使用该端口，请更换为其他端口。
+10051 | 网络不可达 | 端口转发配置错误或类似问题，请确认所有设置均已正确配置。
+10052 | 网络重置 | 当网络在建立连接过程中断开时会发生此情况。请重试连接。
+10053 | 连接已中止 | 由于超时或网络错误导致，请重试连接。
+10054 | 连接被对端重置。 | 有客户端已从你的服务器断开连接。
+10060 | 连接超时 | 你的端口转发存在问题，请参考 [指南步骤](create-a-server.md#1-port-forwarding)。
+10061 | 连接被拒绝 | 你的端口转发存在问题，请参照 [指南步骤](create-a-server.md#1-port-forwarding)。
+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)。
diff --git a/docs/zh/server/manual.md b/docs/zh/server/manual.md
new file mode 100644
index 00000000..2c826b34
--- /dev/null
+++ b/docs/zh/server/manual.md
@@ -0,0 +1,87 @@
+# 服务器手册
+
+# 环境
+
+服务器受各种外部参数状态的影响：
+
+-  "Resources" 文件夹
+- ENV（进程环境）
+- 命令行参数
+- ServerConfig.toml 文件
+- 工作目录
+
+## Resources 文件夹
+
+resources 文件夹会在服务器启动时创建，同时会生成“Client”和“Server”子目录。“Server”子目录可以包含多个文件夹，每个文件夹至少包含一个 `.lua` 文件。位于插件顶层目录的 `.lua` 文件在修改时会被热加载。“Client”子目录仅接受 *&nbsp;`.zip` 文件，这些文件在服务器启动时加载，并假设在运行时不会发生变化。*
+
+## ENV
+
+### 一般设置
+
+从服务器 v3.2.0 版本开始，BeamMP 服务器支持环境变量，这些变量会 **覆盖** ServerConfig.toml 中的设置。所有位于“General”类别/部分的 ServerConfig 变量都是 PascalCase，而环境变量则为 ALL_CAPS，并以 `BEAMMP_` 为前缀。例如，`MaxPlayers` 设置转换为全大写为 `MAX_PLAYERS`（注意每个新单词前的 `_`），加上前缀后变为 `BEAMMP_MAX_PLAYERS`。所有“General”设置都遵循此格式。现有的 ENV 变量如下：
+
+- `BEAMMP_DEBUG`
+- `BEAMMP_PRIVATE`
+- `BEAMMP_PORT`
+- `BEAMMP_MAX_CARS`
+- `BEAMMP_MAX_PLAYERS`
+- `BEAMMP_MAP`
+- `BEAMMP_NAME`
+- `BEAMMP_DESCRIPTION`
+- `BEAMMP_TAGS`
+- `BEAMMP_RESOURCE_FOLDER`
+- `BEAMMP_AUTH_KEY`
+- `BEAMMP_LOG_CHAT`
+
+任何对应于配置参数的环境变量，如果参数类型为字符串或数字，则环境变量必须为字符串，例如 `BEAMMP_NAME="Cool Server"`、`BEAMMP_NAME=Server1`、`BEAMMP_PORT=12345`。对应于布尔类型（true/false、on/off）的配置参数的环境变量必须为 `true` 或 `1`（都表示开启），其他任意值表示关闭。
+
+### 服务器提供者或服务提供相关的设置
+
+这些环境变量允许托管提供者（以及拥有更多服务器的其他用户，此处称为‘提供者’）覆盖某些特定于提供者的设置。
+
+#### `BEAMMP_PROVIDER_PORT_ENV` (在v3.3.0版本)
+
+当设置为非空字符串时，这会用另一个变量替换 `BEAMMP_PORT` 变量，以便从现有的 ENV 中读取该变量。例如，Pterodactyl 可能会将 `SERVER_PORT` 作为 ENV 暴露。要在 BeamMP-Server 中使用它，你需要这样设置 `BEAMMP_PORT=${SERVER_PORT}`，这有点繁琐。
+
+现在，你可以使用 `BEAMMP_PROVIDER_PORT_ENV="SERVER_PORT"`，这样 BeamMP-Server 就会从 `SERVER_PORT` ENV 变量中读取端口。
+
+#### `BEAMMP_PROVIDER_DISABLE_CONFIG` (在v3.3.0版本)
+
+如果设置为 `1` 或 `true`，则 `ServerConfig.toml` 将 **不被生成**，如果存在也 **不会被读取**。服务器必须设置 `BEAMMP_AUTH_KEY` 才能正常运行。
+
+#### `BEAMMP_PROVIDER_UPDATE_MESSAGE` (在v3.2.2版本)
+
+当设置为非空字符串时，这会替换整个更新消息，默认消息为“NEW VERSION IS OUT! Please update to the new...” 等。你提供的更新消息中 **必须**包含 `{}`，服务器会将其替换为新版本号。例如，你的更新消息可以如下所示：
+
+```sh
+BEAMMP_PROVIDER_UPDATE_MESSAGE="BeamMP-Server 的新版本已发布：{}！请按照此更新指南操作：https://example.com/update-guide"
+```
+
+这将生成如下更新消息
+
+```
+BeamMP-Server 的新版本已发布：v5.0.2！请按照此更新指南操作：https://example.com/update-guide
+```
+
+请务必向用户明确说明他们需要更新，并解释如何进行更新。
+
+## 命令行参数
+
+使用 `--help` 参数运行 BeamMP 服务器以了解更多信息。例如：`./BeamMP-Server --help`。
+
+## ServerConfig.toml
+
+该文件会在首次启动时生成。文件内的注释是了解每个设置作用的最新方式。
+
+## 工作目录
+
+服务器的工作目录，而不是服务器可执行文件的位置，决定了 ServerConfig.toml、服务器日志文件和 Resources 文件夹的生成位置。
+
+# 限制
+
+以下限制在 BeamMP 后端中被强制执行，这会影响服务器：
+
+- Name 的长度限制为 250 个字符
+- 描述限制为 1000 个字符
+- 地图名称限制为 100 个字符
+- 标签限制为 100 个字符