From 0f4f1cc1011bc8bf4b1d72195ed1917ebf6b48ab Mon Sep 17 00:00:00 2001
From: Reis <gubazrasta890@gmail.com>
Date: Mon, 20 Oct 2025 09:58:42 +0000
Subject: [PATCH 01/21] Translate index.md via GitLocalize

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

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

From 7929c45422855b2ceebcfd987043a1cf64713eb0 Mon Sep 17 00:00:00 2001
From: Reis <gubazrasta890@gmail.com>
Date: Mon, 20 Oct 2025 09:58:44 +0000
Subject: [PATCH 02/21] Translate maps.md via GitLocalize

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

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
+
+...
+
+## Введение
+
+...
+
+## Начало работы
+
+...

From 3df2210dcdd586ba41fad3022294703f3d6593b1 Mon Sep 17 00:00:00 2001
From: Reis <gubazrasta890@gmail.com>
Date: Mon, 20 Oct 2025 09:58:47 +0000
Subject: [PATCH 03/21] Translate props.md via GitLocalize

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

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
+
+...
+
+## Введение
+
+...
+
+## Начало работы
+
+...

From 7b93b1622dabdeb0c39911271e0a3ce62101cd69 Mon Sep 17 00:00:00 2001
From: Reis <gubazrasta890@gmail.com>
Date: Mon, 20 Oct 2025 09:58:49 +0000
Subject: [PATCH 04/21] Translate vehicles.md via GitLocalize

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

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
+
+...
+
+## Введение
+
+...
+
+## Начало работы
+
+...

From 546fb9b5b37eaaa348f86899f97387d656f1e255 Mon Sep 17 00:00:00 2001
From: Reis <gubazrasta890@gmail.com>
Date: Mon, 20 Oct 2025 09:58:51 +0000
Subject: [PATCH 05/21] Translate imgui-windows.md via GitLocalize

---
 docs/ru/beamng/dev/modding/imgui-windows.md | 3 +++
 1 file changed, 3 insertions(+)
 create mode 100644 docs/ru/beamng/dev/modding/imgui-windows.md

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
+
+Эту страницу нужно заполнить

From 7c4683d6e1aba518307b71357b3103e16074a5ed Mon Sep 17 00:00:00 2001
From: Reis <gubazrasta890@gmail.com>
Date: Mon, 20 Oct 2025 09:58:53 +0000
Subject: [PATCH 06/21] Translate lua-mods.md via GitLocalize

---
 docs/ru/beamng/dev/modding/lua-mods.md | 3 +++
 1 file changed, 3 insertions(+)
 create mode 100644 docs/ru/beamng/dev/modding/lua-mods.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
+
+Эту страницу нужно заполнить

From aeed0ac7a51b5e791df87fe7c68a45a99fec15d8 Mon Sep 17 00:00:00 2001
From: Reis <gubazrasta890@gmail.com>
Date: Mon, 20 Oct 2025 09:58:56 +0000
Subject: [PATCH 07/21] Translate ui-apps.md via GitLocalize

---
 docs/ru/beamng/dev/modding/ui-apps.md | 273 ++++++++++++++++++++++++++
 1 file changed, 273 insertions(+)
 create mode 100644 docs/ru/beamng/dev/modding/ui-apps.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.

From cf28258e73688ffe42eca9a972b321d375825e92 Mon Sep 17 00:00:00 2001
From: Reis <gubazrasta890@gmail.com>
Date: Mon, 20 Oct 2025 09:58:58 +0000
Subject: [PATCH 08/21] Translate contributing.md via GitLocalize

---
 docs/ru/contributing.md | 43 +++++++++++++++++++++++++++++++++++++++++
 1 file changed, 43 insertions(+)
 create mode 100644 docs/ru/contributing.md

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.
+```

From 5eb30ea9baf19b16fa9df5cb4b41b4c4cb78fb4b Mon Sep 17 00:00:00 2001
From: vadyanka <vadilkam.gm@gmail.com>
Date: Mon, 20 Oct 2025 09:59:05 +0000
Subject: [PATCH 09/21] Translate server-maintenance.md via GitLocalize

---
 docs/ru/server/server-maintenance.md | 237 +++++++++++++++++++++++++++
 1 file changed, 237 insertions(+)
 create mode 100644 docs/ru/server/server-maintenance.md

diff --git a/docs/ru/server/server-maintenance.md b/docs/ru/server/server-maintenance.md
new file mode 100644
index 00000000..ceefe5d8
--- /dev/null
+++ b/docs/ru/server/server-maintenance.md
@@ -0,0 +1,237 @@
+# Обслуживание сервера
+
+Руководства, советы и рекомендации по настройке и обслуживанию сервера BeamMP.
+
+## Как установить
+
+For installation instructions, please see [server installation](create-a-server.md).
+
+## The ServerConfig file
+
+The server config, which is a file called `ServerConfig.toml`, uses the [TOML format](https://toml.io/en/).
+
+*NOTE*: The *old* server config file was called `Server.cfg`, but this is no longer used, and the server will warn when this is still present. Please also note that the two config formats are **not** compatible with each other.
+
+The config has one section by default, called `[General]`, which holds the following values:
+
+Key | Value Type | Description
+--- | --- | ---
+AuthKey | AuthKey format `xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx` where all x's are alphanumeric characters (numbers and letters) | Used to identify your server with the backend. You should have gotten one while following the installation instructions.
+Debug | true /false | When enabled (true), will show more messages in the log and provide more information. Enable this if you run into issues. Enabling this will drastically increase the size of the log file.
+Private | true/false | When enabled (true), your server will not be shown in the server list. Anyone with the correct IP and port can still connect.
+Description | Any "text" | Shown as the description of the server in the server list (if the server is public). You can use special characters to format this with colors and styles.
+Name | Any "text" | Shown as the name / title of your server in the server list. You can use special characters to format this with colors and styles.
+Map | A valid map location, such as `/levels/gridmap_v2/info.json` | The map your server will host. Has to be installed either by default (a list can be found below) or as a server mod.
+MaxCars | Any number ≥ 1 | The maximum number of cars per player. Any additional cars a player tries to spawn will be deleted instantly.
+Port | 1024-65535 | The networking port on which the server will be accessible. For a player to connect to your server directly, they will need your IP and this port.
+
+Other sections can and should be used by server plugins (Lua API coming soon), like so: `[MyMod]`.
+
+The AuthKey **HAS** to be set by you. It will be empty by default, and needs to be filled with your AuthKey from the installation step earlier. Do not share this Key with anyone and, in screenshots, blur it fully.
+
+### All vanilla maps names
+
+Here are all the stock maps:
+
+- /levels/gridmap_v2/info.json
+- /levels/johnson_valley/info.json
+- /levels/automation_test_track/info.json
+- /levels/east_coast_usa/info.json
+- /levels/hirochi_raceway/info.json
+- /levels/italy/info.json
+- /levels/jungle_rock_island/info.json
+- /levels/industrial/info.json
+- /levels/small_island/info.json
+- /levels/smallgrid/info.json
+- /levels/utah/info.json
+- /levels/west_coast_usa/info.json
+- /levels/driver_training/info.json
+- /levels/derby/info.json
+
+### Customize the look of your server name
+
+Use these special symbols before your text and it'll apply an effect to that text in the server list:
+
+Value | Description
+:-: | ---
+`^r` | Reset
+`^p` | Newline (descriptions only)
+`^n` | Underline
+`^l` | Bold
+`^m` | Strike-through
+`^o` | Italic
+`^0` | Black
+`^1` | Blue
+`^2` | Green
+`^3` | Light blue
+`^4` | Red
+`^5` | Pink
+`^6` | Orange
+`^7` | Grey
+`^8` | Dark grey
+`^9` | Light purple
+`^a` | Light green
+`^b` | Light blue
+`^c` | Dark orange
+`^d` | Light pink
+`^e` | Yellow
+`^f` | White
+
+### Customize your server tags
+
+Tags can be used to allow people to search for a specific type of server. Your serverConfig.toml will generate with the freeroam tag `Tags = "Freeroam"`.
+
+You can add multiple tags separated by comma `Tags = "Events,Offroad,lang:english"`, they are not case sensitive.
+
+You can choose from the following list:
+
+- Age/Content:
+
+    - `Mature/18+`
+
+- Gameplay Types:
+
+    - `Freeroam`
+    - `Roleplay`
+    - `Economy`
+    - `Traffic`
+
+- Racing Categories:
+
+    - `Racing`
+    - `Racing:NASCAR`
+    - `Racing:Track`
+    - `Racing:Drag`
+    - `Racing:Rally`
+    - `Touge`
+
+- Off-Roading and Challenges:
+
+    - `Offroad`
+    - `Crawling`
+    - `Dakar`
+    - `Challenge`
+
+- Destruction Events:
+
+    - `Derby`
+    - `Arena`
+
+- Weather and Time Conditions:
+
+    - `Snow/Ice`
+    - `Rain`
+    - `Night`
+    - `Weather`
+
+- Gamemodes:
+
+    - `Gamemode`
+    - `Gamemode:Racing`
+    - `Gamemode:Rally`
+    - `Gamemode:Drag`
+    - `Gamemode:Derby`
+    - `Gamemode:Infection`
+    - `Gamemode:Cops-Robbers`
+    - `Gamemode:Delivery`
+    - `Gamemode:Sumo`
+
+- Community and Events:
+
+    - `Scenarios`
+    - `Events`
+    - `Leaderboard`
+
+- Mods:
+
+    - `Modded`
+    - `Mod:BeamPaint`
+    - `Mod:BeamJoy`
+    - `Mod:CEI`
+
+- Languages:
+
+    - `Lang:English`
+    - `Lang:Russian`
+    - `Lang:French`
+    - `Lang:Spanish`
+    - `Lang:Portuguese`
+    - `Lang:German`
+    - `Lang:Polish`
+    - `Lang:Arabic`
+
+- Other:
+
+    - `Vanilla`
+    - `Moderated`
+
+Should a tag be missing from this list, you can submit a request for it to be added [here](https://forum.beammp.com/t/introducing-server-tags/1320081)
+
+## The Server.log file
+
+This file will be generated when the server runs. It's a mirror of the messages you see in the console when you run the server. You should attach this file every time you need support from our support staff, and it will never show your AuthKey, so you can usually send it without modifications.
+
+The format is as follows ($ prefix means “variable”, explained below):
+
+```
+[$DATE $TIME] $CONTEXT [$LOG_LEVEL] $MESSAGE
+```
+
+Where:
+
+- `$DATE` is the date of the message, for example 21/07/2021
+- `$TIME` is the time of the message, for example 11:05:23
+- `$CONTEXT` (only visible if in Debug mode and mostly relevant to developers) is the context of the message, which is either:
+    - `(Player ID) “Player Name”`, where the Player's ID is useful for moderation
+    - A short name such as “HeartbeatThread”
+- `$LOG_LEVEL` is one of the levels of importance of a message:
+    - `DEBUG`: Only visible in Debug mode, usually spammy and only important to developers
+    - `INFO`: General information
+    - `LUA`: Message from a Lua plugin
+    - `WARN`: Describes something that isn't supposed to happen, usually
+    - `ERROR`: Something went very wrong, or was very unexpected
+    - `FATAL`: Something happened that causes the server to shut down
+- `$MESSAGE` the message itself, usually something that you should pay attention to and understand. In some cases this might be cryptic, but the general rule is that, as long as nothing is visibly wrong with the server and there are no ERRORs, all is good.
+
+## Updating the server
+
+### Why to update
+
+Whenever a new update is released, you're advised to update your server. Usually this involves bug fixes, stability improvements and security improvements, next to the general new features etc. that are introduced.
+
+To receive news about updates when they come out, either follow the discord server's “update” channel, look out for it on the forums, or look at / ask the [GitHub releases page](https://github.com/BeamMP/BeamMP-Server/releases).
+
+### How to update
+
+#### If you are using a BeamMP partnered hosting provider
+
+If you are using a BeamMP partnered hosting provider, the instructions below likely won't work. We recommend waiting for more details from your hosting provider, or contacting them for assistance.
+
+#### Managing the server yourself
+
+The server is updated by replacing the old executable with the new one. If you are unsure how to do this, there are step-by-step instructions for Windows and Linux below.
+
+If you built from source, you just rebuild. Make sure to run `git submodule update --init --recursive` before you rebuild.
+
+#### On Windows
+
+1. Ensure you have installed the [Visual C++ Redistributables](https://aka.ms/vs/17/release/vc_redist.x64.exe) in order to run the server.
+2. Go to [BeamMP.com](https://beammp.com/) and click the “Download Server” button.
+3. Once downloaded, you should see one file called `BeamMP-Server.exe`. We will call this one the “new executable”.
+4. Go to the folder where your current `BeamMP-Server.exe` executable is located (same folder where your `ServerConfig.toml` is, usually). We will call this one the “old executable”.
+5. Replace the old executable with the new executable (for example by copying or moving the new executable into the folder).
+
+#### On Linux
+
+1. Go to [BeamMP.com](https://beammp.com/) and click the “Download Server” button, you will be redirected to the server's Github release page.
+2. Download the correct version for your distro. For simplicity, it will now be called `BeamMP-Server-xxx` from now on, where `xxx` denotes the version for the distro you're using.
+3. Once downloaded, you should see one file called `BeamMP-Server-xxx` depending on the version you've downloaded. We will call this one the “new executable”.
+4. Go to the folder where your current `BeamMP-Server-xxx` executable is located (same folder where your `ServerConfig.toml` is, usually). We will call this one the “old executable”.
+5. Replace the old executable with the new executable (for example by copying or moving the new executable into the folder).
+6. Open a terminal in that folder where you just replaced the executable, and run `sudo chmod +x BeamMP-Server-xxx`. This will make sure the server can be run.
+
+### Automated updates
+
+The server does not support automatic updates or update notifications (yet).
+
+You can, however, ask the GitHub API for the lastest release by checking the server's version against the tags. You can get that by GET'ing from `https://api.github.com/repos/BeamMP/BeamMP-Server/git/refs/tags`.

From 557621fb5af97fd87fbafc3d0796fffc4e58a227 Mon Sep 17 00:00:00 2001
From: mt-gitlocalize <mt@gitlocalize.com>
Date: Mon, 20 Oct 2025 09:59:07 +0000
Subject: [PATCH 10/21] Translate server-maintenance.md via GitLocalize

---
 docs/ru/server/server-maintenance.md | 220 +++++++++++++--------------
 1 file changed, 110 insertions(+), 110 deletions(-)

diff --git a/docs/ru/server/server-maintenance.md b/docs/ru/server/server-maintenance.md
index ceefe5d8..ff32c14a 100644
--- a/docs/ru/server/server-maintenance.md
+++ b/docs/ru/server/server-maintenance.md
@@ -4,99 +4,99 @@
 
 ## Как установить
 
-For installation instructions, please see [server installation](create-a-server.md).
+Инструкции по установке см. в разделе [Установка сервера](create-a-server.md) .
 
-## The ServerConfig file
+## Файл ServerConfig
 
-The server config, which is a file called `ServerConfig.toml`, uses the [TOML format](https://toml.io/en/).
+Конфигурация сервера, представляющая собой файл `ServerConfig.toml` , использует [формат TOML](https://toml.io/en/) .
 
-*NOTE*: The *old* server config file was called `Server.cfg`, but this is no longer used, and the server will warn when this is still present. Please also note that the two config formats are **not** compatible with each other.
+*ПРИМЕЧАНИЕ* : *Старый* файл конфигурации сервера назывался `Server.cfg` , но он больше не используется, и сервер выдаст предупреждение, если он все еще присутствует. Также обратите внимание, что два формата конфигурации **несовместимы** друг с другом.
 
-The config has one section by default, called `[General]`, which holds the following values:
+По умолчанию в конфигурации есть один раздел, называемый `[General]` , который содержит следующие значения:
 
-Key | Value Type | Description
+Ключ | Тип значения | Описание
 --- | --- | ---
-AuthKey | AuthKey format `xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx` where all x's are alphanumeric characters (numbers and letters) | Used to identify your server with the backend. You should have gotten one while following the installation instructions.
-Debug | true /false | When enabled (true), will show more messages in the log and provide more information. Enable this if you run into issues. Enabling this will drastically increase the size of the log file.
-Private | true/false | When enabled (true), your server will not be shown in the server list. Anyone with the correct IP and port can still connect.
-Description | Any "text" | Shown as the description of the server in the server list (if the server is public). You can use special characters to format this with colors and styles.
-Name | Any "text" | Shown as the name / title of your server in the server list. You can use special characters to format this with colors and styles.
-Map | A valid map location, such as `/levels/gridmap_v2/info.json` | The map your server will host. Has to be installed either by default (a list can be found below) or as a server mod.
-MaxCars | Any number ≥ 1 | The maximum number of cars per player. Any additional cars a player tries to spawn will be deleted instantly.
-Port | 1024-65535 | The networking port on which the server will be accessible. For a player to connect to your server directly, they will need your IP and this port.
+AuthKey | Формат AuthKey `xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx` где все x — буквенно-цифровые символы (цифры и буквы) | Используется для идентификации вашего сервера с бэкэндом. Вы должны были получить его, следуя инструкциям по установке.
+Отлаживать | правда/ложь | При включении (true) будет отображаться больше сообщений в журнале и предоставляться больше информации. Включите это, если у вас возникнут проблемы. Включение этого параметра значительно увеличит размер файла журнала.
+Частный | правда/ложь | Если включено (true), ваш сервер не будет отображаться в списке серверов. Любой с правильным IP и портом все равно сможет подключиться.
+Описание | Любой "текст" | Отображается как описание сервера в списке серверов (если сервер публичный). Вы можете использовать специальные символы для форматирования с помощью цветов и стилей.
+Имя | Любой "текст" | Отображается как имя/заголовок вашего сервера в списке серверов. Вы можете использовать специальные символы для форматирования с помощью цветов и стилей.
+Карта | Допустимое местоположение на карте, например `/levels/gridmap_v2/info.json` | Карта, которую будет размещать ваш сервер. Должна быть установлена либо по умолчанию (список можно найти ниже), либо как серверный мод.
+МаксКарс | Любое число ≥ 1 | Максимальное количество машин на игрока. Любые дополнительные машины, которые игрок попытается создать, будут мгновенно удалены.
+Порт | 1024-65535 | Сетевой порт, на котором будет доступен сервер. Чтобы игрок мог напрямую подключиться к вашему серверу, ему понадобится ваш IP и этот порт.
 
-Other sections can and should be used by server plugins (Lua API coming soon), like so: `[MyMod]`.
+Другие разделы могут и должны использоваться серверными плагинами (скоро появится API Lua), например: `[MyMod]` .
 
-The AuthKey **HAS** to be set by you. It will be empty by default, and needs to be filled with your AuthKey from the installation step earlier. Do not share this Key with anyone and, in screenshots, blur it fully.
+AuthKey **ДОЛЖЕН** быть установлен вами. Он будет пустым по умолчанию и должен быть заполнен вашим AuthKey с шага установки ранее. Не делитесь этим ключом ни с кем и на снимках экрана полностью размывайте его.
 
-### All vanilla maps names
+### Все названия ванильных карт
 
-Here are all the stock maps:
+Вот все карты акций:
 
 - /levels/gridmap_v2/info.json
 - /levels/johnson_valley/info.json
 - /levels/automation_test_track/info.json
-- /levels/east_coast_usa/info.json
+- /levels/восточное_побережье_США/info.json
 - /levels/hirochi_raceway/info.json
-- /levels/italy/info.json
+- /уровни/италия/info.json
 - /levels/jungle_rock_island/info.json
-- /levels/industrial/info.json
-- /levels/small_island/info.json
-- /levels/smallgrid/info.json
-- /levels/utah/info.json
-- /levels/west_coast_usa/info.json
-- /levels/driver_training/info.json
+- /уровни/промышленный/info.json
+- /levels/маленький_остров/info.json
+- /уровни/smallgrid/info.json
+- /levels/юта/info.json
+- /levels/западное_побережье_США/info.json
+- /уровни/обучение_водителей/info.json
 - /levels/derby/info.json
 
-### Customize the look of your server name
+### Настройте внешний вид имени вашего сервера
 
-Use these special symbols before your text and it'll apply an effect to that text in the server list:
+Используйте эти специальные символы перед текстом, и к этому тексту в списке серверов будет применен эффект:
 
-Value | Description
+Ценить | Описание
 :-: | ---
-`^r` | Reset
-`^p` | Newline (descriptions only)
-`^n` | Underline
-`^l` | Bold
-`^m` | Strike-through
-`^o` | Italic
-`^0` | Black
-`^1` | Blue
-`^2` | Green
-`^3` | Light blue
-`^4` | Red
-`^5` | Pink
-`^6` | Orange
-`^7` | Grey
-`^8` | Dark grey
-`^9` | Light purple
-`^a` | Light green
-`^b` | Light blue
-`^c` | Dark orange
-`^d` | Light pink
-`^e` | Yellow
-`^f` | White
+`^r` | Перезагрузить
+`^p` | Новая строка (только описания)
+`^n` | Подчеркнуть
+`^l` | Смелый
+`^m` | Зачеркивание
+`^o` | Курсив
+`^0` | Черный
+`^1` | Синий
+`^2` | Зеленый
+`^3` | светло-голубой
+`^4` | Красный
+`^5` | Розовый
+`^6` | Апельсин
+`^7` | Серый
+`^8` | Темно-серый
+`^9` | Светло-фиолетовый
+`^a` | Светло-зеленый
+`^b` | светло-голубой
+`^c` | Темно-оранжевый
+`^d` | светло-розовый
+`^e` | Желтый
+`^f` | Белый
 
-### Customize your server tags
+### Настройте теги вашего сервера
 
-Tags can be used to allow people to search for a specific type of server. Your serverConfig.toml will generate with the freeroam tag `Tags = "Freeroam"`.
+Теги могут использоваться для того, чтобы позволить людям искать определенный тип сервера. Ваш serverConfig.toml будет сгенерирован с тегом freeroam `Tags = "Freeroam"` .
 
-You can add multiple tags separated by comma `Tags = "Events,Offroad,lang:english"`, they are not case sensitive.
+Вы можете добавить несколько тегов, разделенных запятой `Tags = "Events,Offroad,lang:english"` , регистр не учитывается.
 
-You can choose from the following list:
+Вы можете выбрать из следующего списка:
 
-- Age/Content:
+- Возраст/Содержание:
 
     - `Mature/18+`
 
-- Gameplay Types:
+- Типы игрового процесса:
 
     - `Freeroam`
     - `Roleplay`
     - `Economy`
     - `Traffic`
 
-- Racing Categories:
+- Категории гонок:
 
     - `Racing`
     - `Racing:NASCAR`
@@ -105,26 +105,26 @@ You can choose from the following list:
     - `Racing:Rally`
     - `Touge`
 
-- Off-Roading and Challenges:
+- Бездорожье и испытания:
 
     - `Offroad`
     - `Crawling`
     - `Dakar`
     - `Challenge`
 
-- Destruction Events:
+- События разрушения:
 
     - `Derby`
     - `Arena`
 
-- Weather and Time Conditions:
+- Погодные и временные условия:
 
     - `Snow/Ice`
     - `Rain`
     - `Night`
     - `Weather`
 
-- Gamemodes:
+- Режимы игры:
 
     - `Gamemode`
     - `Gamemode:Racing`
@@ -136,20 +136,20 @@ You can choose from the following list:
     - `Gamemode:Delivery`
     - `Gamemode:Sumo`
 
-- Community and Events:
+- Сообщество и события:
 
     - `Scenarios`
     - `Events`
     - `Leaderboard`
 
-- Mods:
+- Модификации:
 
     - `Modded`
     - `Mod:BeamPaint`
     - `Mod:BeamJoy`
     - `Mod:CEI`
 
-- Languages:
+- Языки:
 
     - `Lang:English`
     - `Lang:Russian`
@@ -160,78 +160,78 @@ You can choose from the following list:
     - `Lang:Polish`
     - `Lang:Arabic`
 
-- Other:
+- Другой:
 
     - `Vanilla`
     - `Moderated`
 
-Should a tag be missing from this list, you can submit a request for it to be added [here](https://forum.beammp.com/t/introducing-server-tags/1320081)
+Если тег отсутствует в этом списке, вы можете отправить запрос на его добавление [здесь.](https://forum.beammp.com/t/introducing-server-tags/1320081)
 
-## The Server.log file
+## Файл Server.log
 
-This file will be generated when the server runs. It's a mirror of the messages you see in the console when you run the server. You should attach this file every time you need support from our support staff, and it will never show your AuthKey, so you can usually send it without modifications.
+Этот файл будет сгенерирован при запуске сервера. Это зеркало сообщений, которые вы видите в консоли при запуске сервера. Вам следует прикреплять этот файл каждый раз, когда вам нужна поддержка от нашей службы поддержки, и он никогда не покажет ваш AuthKey, поэтому вы обычно можете отправить его без изменений.
 
-The format is as follows ($ prefix means “variable”, explained below):
+Формат следующий (префикс $ означает «переменная», пояснение ниже):
 
 ```
 [$DATE $TIME] $CONTEXT [$LOG_LEVEL] $MESSAGE
 ```
 
-Where:
+Где:
 
-- `$DATE` is the date of the message, for example 21/07/2021
-- `$TIME` is the time of the message, for example 11:05:23
-- `$CONTEXT` (only visible if in Debug mode and mostly relevant to developers) is the context of the message, which is either:
-    - `(Player ID) “Player Name”`, where the Player's ID is useful for moderation
-    - A short name such as “HeartbeatThread”
-- `$LOG_LEVEL` is one of the levels of importance of a message:
-    - `DEBUG`: Only visible in Debug mode, usually spammy and only important to developers
-    - `INFO`: General information
-    - `LUA`: Message from a Lua plugin
-    - `WARN`: Describes something that isn't supposed to happen, usually
-    - `ERROR`: Something went very wrong, or was very unexpected
-    - `FATAL`: Something happened that causes the server to shut down
-- `$MESSAGE` the message itself, usually something that you should pay attention to and understand. In some cases this might be cryptic, but the general rule is that, as long as nothing is visibly wrong with the server and there are no ERRORs, all is good.
+- `$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` само сообщение, обычно то, на что следует обратить внимание и что следует понять. В некоторых случаях это может быть зашифровано, но общее правило заключается в том, что пока нет видимых проблем с сервером и нет ОШИБОК, все хорошо.
 
-## Updating the server
+## Обновление сервера
 
-### Why to update
+### Зачем обновлять
 
-Whenever a new update is released, you're advised to update your server. Usually this involves bug fixes, stability improvements and security improvements, next to the general new features etc. that are introduced.
+Всякий раз, когда выходит новое обновление, вам рекомендуется обновить свой сервер. Обычно это включает исправления ошибок, улучшения стабильности и безопасности, наряду с общими новыми функциями и т. д., которые вводятся.
 
-To receive news about updates when they come out, either follow the discord server's “update” channel, look out for it on the forums, or look at / ask the [GitHub releases page](https://github.com/BeamMP/BeamMP-Server/releases).
+Чтобы получать новости об обновлениях по мере их выхода, подпишитесь на канал «обновления» сервера Discord, ищите его на форумах или посетите/спросите на [странице релизов GitHub](https://github.com/BeamMP/BeamMP-Server/releases) .
 
-### How to update
+### Как обновить
 
-#### If you are using a BeamMP partnered hosting provider
+#### Если вы пользуетесь услугами хостинг-провайдера, являющегося партнером BeamMP
 
-If you are using a BeamMP partnered hosting provider, the instructions below likely won't work. We recommend waiting for more details from your hosting provider, or contacting them for assistance.
+Если вы используете хостинг-провайдера, партнера BeamMP, инструкции ниже, скорее всего, не сработают. Мы рекомендуем дождаться более подробной информации от вашего хостинг-провайдера или связаться с ним для получения помощи.
 
-#### Managing the server yourself
+#### Самостоятельное управление сервером
 
-The server is updated by replacing the old executable with the new one. If you are unsure how to do this, there are step-by-step instructions for Windows and Linux below.
+Сервер обновляется путем замены старого исполняемого файла на новый. Если вы не уверены, как это сделать, ниже приведены пошаговые инструкции для Windows и Linux.
 
-If you built from source, you just rebuild. Make sure to run `git submodule update --init --recursive` before you rebuild.
+Если вы собрали из исходников, просто пересоберите. Убедитесь, что выполнили `git submodule update --init --recursive` перед пересборкой.
 
-#### On Windows
+#### В Windows
 
-1. Ensure you have installed the [Visual C++ Redistributables](https://aka.ms/vs/17/release/vc_redist.x64.exe) in order to run the server.
-2. Go to [BeamMP.com](https://beammp.com/) and click the “Download Server” button.
-3. Once downloaded, you should see one file called `BeamMP-Server.exe`. We will call this one the “new executable”.
-4. Go to the folder where your current `BeamMP-Server.exe` executable is located (same folder where your `ServerConfig.toml` is, usually). We will call this one the “old executable”.
-5. Replace the old executable with the new executable (for example by copying or moving the new executable into the folder).
+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. Замените старый исполняемый файл новым исполняемым файлом (например, скопировав или переместив новый исполняемый файл в папку).
 
-#### On Linux
+#### На Линуксе
 
-1. Go to [BeamMP.com](https://beammp.com/) and click the “Download Server” button, you will be redirected to the server's Github release page.
-2. Download the correct version for your distro. For simplicity, it will now be called `BeamMP-Server-xxx` from now on, where `xxx` denotes the version for the distro you're using.
-3. Once downloaded, you should see one file called `BeamMP-Server-xxx` depending on the version you've downloaded. We will call this one the “new executable”.
-4. Go to the folder where your current `BeamMP-Server-xxx` executable is located (same folder where your `ServerConfig.toml` is, usually). We will call this one the “old executable”.
-5. Replace the old executable with the new executable (for example by copying or moving the new executable into the folder).
-6. Open a terminal in that folder where you just replaced the executable, and run `sudo chmod +x BeamMP-Server-xxx`. This will make sure the server can be run.
+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` . Это позволит убедиться, что сервер может быть запущен.
 
-### Automated updates
+### Автоматические обновления
 
-The server does not support automatic updates or update notifications (yet).
+Сервер не поддерживает автоматические обновления или уведомления об обновлениях (пока).
 
-You can, however, ask the GitHub API for the lastest release by checking the server's version against the tags. You can get that by GET'ing from `https://api.github.com/repos/BeamMP/BeamMP-Server/git/refs/tags`.
+Однако вы можете запросить API GitHub для получения последней версии, проверив версию сервера по тегам. Вы можете получить это с помощью GET из `https://api.github.com/repos/BeamMP/BeamMP-Server/git/refs/tags` .

From 7d292396df059b6d2a12248d5dfa750aa18f1472 Mon Sep 17 00:00:00 2001
From: mt-gitlocalize <mt@gitlocalize.com>
Date: Mon, 20 Oct 2025 09:59:13 +0000
Subject: [PATCH 11/21] Translate mod-reference.md via GitLocalize

---
 docs/ru/scripting/mod-reference.md | 45 ++++++++++++++++++++++++++++++
 1 file changed, 45 insertions(+)
 create mode 100644 docs/ru/scripting/mod-reference.md

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
+```

From 262fd539c985459738614bdfc129d83f6eb9b20d Mon Sep 17 00:00:00 2001
From: mt-gitlocalize <mt@gitlocalize.com>
Date: Mon, 20 Oct 2025 09:59:15 +0000
Subject: [PATCH 12/21] Translate getting-started.md via GitLocalize

---
 .../mod-creation/server/getting-started.md    | 101 ++++++++++++++++++
 1 file changed, 101 insertions(+)
 create mode 100644 docs/ru/guides/mod-creation/server/getting-started.md

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")
+```

From 8c8f31bd4fc2f4bda092f7420b406823673bee85 Mon Sep 17 00:00:00 2001
From: mt-gitlocalize <mt@gitlocalize.com>
Date: Mon, 20 Oct 2025 09:59:18 +0000
Subject: [PATCH 13/21] Translate error-codes.md via GitLocalize

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

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.

From dd3a682e71a7e04480cd7ea3bb635893de9f80f8 Mon Sep 17 00:00:00 2001
From: mt-gitlocalize <mt@gitlocalize.com>
Date: Mon, 20 Oct 2025 09:59:20 +0000
Subject: [PATCH 14/21] Translate Defender-exclusions.md via GitLocalize

---
 docs/ru/FAQ/Defender-exclusions.md | 40 ++++++++++++++++++++++++++++++
 1 file changed, 40 insertions(+)
 create mode 100644 docs/ru/FAQ/Defender-exclusions.md

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` .

From eb39b87ce5e9d386ec5f70ff4cc450e89ba89507 Mon Sep 17 00:00:00 2001
From: mt-gitlocalize <mt@gitlocalize.com>
Date: Mon, 20 Oct 2025 09:59:22 +0000
Subject: [PATCH 15/21] Translate game-faq.md via GitLocalize

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

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) .

From 1b0fb8edf9be2019a4d9df876dd7bc9d56fbf9ef Mon Sep 17 00:00:00 2001
From: mt-gitlocalize <mt@gitlocalize.com>
Date: Mon, 20 Oct 2025 09:59:24 +0000
Subject: [PATCH 16/21] Translate player-faq.md via GitLocalize

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

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) , где сообщество может задавать вопросы и получать ответы.

From b4d85cc0dfee74bad17c02705312620efbc80292 Mon Sep 17 00:00:00 2001
From: mt-gitlocalize <mt@gitlocalize.com>
Date: Mon, 20 Oct 2025 09:59:26 +0000
Subject: [PATCH 17/21] Translate Update-launcher.md via GitLocalize

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

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, скачать,

From 6ce8467c463e3e700a4587a895844ca7c36ea2a4 Mon Sep 17 00:00:00 2001
From: mt-gitlocalize <mt@gitlocalize.com>
Date: Mon, 20 Oct 2025 09:59:29 +0000
Subject: [PATCH 18/21] Translate v2-server-reference.md via GitLocalize

---
 .../scripting/server/v2-server-reference.md   | 384 ++++++++++++++++++
 1 file changed, 384 insertions(+)
 create mode 100644 docs/ru/scripting/server/v2-server-reference.md

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. В качестве альтернативы вы можете вручную пройти по строке и извлечь необходимую информацию.

From 6b9f8c32a45ee077aa852a60b46c1d6c33c8defe Mon Sep 17 00:00:00 2001
From: mt-gitlocalize <mt@gitlocalize.com>
Date: Mon, 20 Oct 2025 09:59:33 +0000
Subject: [PATCH 19/21] Translate latest-server-reference.md via GitLocalize

---
 .../server/latest-server-reference.md         | 1317 +++++++++++++++++
 1 file changed, 1317 insertions(+)
 create mode 100644 docs/ru/scripting/server/latest-server-reference.md

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..a350320d
--- /dev/null
+++ b/docs/ru/scripting/server/latest-server-reference.md
@@ -0,0 +1,1317 @@
+!!! предупреждение "Этот сайт находится в стадии разработки!"
+
+```
+This site is being actively worked on.
+
+Feel you could help? Please do by clicking on the page with a pencil on the right!
+
+This can be done on any page too.
+```
+
+# Справочник по серверным скриптам
+
+## Версия сервера 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")
+```
+
+Это лучше, чем называть обработчик тем же, что и событие, что вводит в заблуждение и сбивает с толку.

From c09bbc4294b22d10e6e5f8337e879f9fe989e7e3 Mon Sep 17 00:00:00 2001
From: vadyanka <vadilkam.gm@gmail.com>
Date: Mon, 20 Oct 2025 09:59:34 +0000
Subject: [PATCH 20/21] Translate latest-server-reference.md via GitLocalize

---
 docs/ru/scripting/server/latest-server-reference.md | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/docs/ru/scripting/server/latest-server-reference.md b/docs/ru/scripting/server/latest-server-reference.md
index a350320d..fb8aa95a 100644
--- a/docs/ru/scripting/server/latest-server-reference.md
+++ b/docs/ru/scripting/server/latest-server-reference.md
@@ -1,11 +1,11 @@
 !!! предупреждение "Этот сайт находится в стадии разработки!"
 
 ```
-This site is being actively worked on.
+Над этим сайтом ведется активная работа.
 
-Feel you could help? Please do by clicking on the page with a pencil on the right!
+Чувствуете, что можете помочь? Пожалуйста, сделайте это, нажав на страницу с карандашом справа!
 
-This can be done on any page too.
+Это можно сделать на любой странице.
 ```
 
 # Справочник по серверным скриптам
@@ -1315,3 +1315,5 @@ MP.RegisterEvent("onChatMessage", "handleChatMessage")
 ```
 
 Это лучше, чем называть обработчик тем же, что и событие, что вводит в заблуждение и сбивает с толку.
+
+

From c75e90a848694e18f11da8fa491308331cf067e5 Mon Sep 17 00:00:00 2001
From: mt-gitlocalize <mt@gitlocalize.com>
Date: Mon, 20 Oct 2025 09:59:36 +0000
Subject: [PATCH 21/21] Translate How-to-check-for-CGNAT.md via GitLocalize

---
 docs/ru/FAQ/How-to-check-for-CGNAT.md | 45 +++++++++++++++++++++++++++
 1 file changed, 45 insertions(+)
 create mode 100644 docs/ru/FAQ/How-to-check-for-CGNAT.md

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, Сбой подключения, Переадресация портов, Брандмауэр