More work!!!

docs/ru/get-started/index.md

@@ -0,0 +1,163 @@
+# Начиная
+
+## **1. Совместимость**
+
+BeamMP полностью совместим с Windows и Linux, совместимость с MacOS находится в разработке. Однако Linux и MacOS являются вторичными платформами, поэтому следует ожидать ошибок.
+
+:::предупреждение
+
+```
+BeamMP не будет работать с пиратскими или устаревшими версиями BeamNG.drive.
+Служба поддержки BeamMP не оказывает помощь по вопросам, связанным с пиратскими/устаревшими копиями.
+```
+
+---
+
+## **2. Установка**
+
+### **2а. Установка Windows**
+
+:::примечание
+
+```
+По состоянию на 1 апреля 2026 года, согласно Windows Defender SmartScreen, установщик MSI является «неопознанным приложением».
+
+Чтобы проигнорировать это предупреждение, нажмите «Подробнее», а затем нажмите «Запустить в любом случае».
+```
+
+1. Перейдите на [сайт beammp.com](https://beammp.com/) и нажмите кнопку «Скачать сейчас».
+2. Запустите установщик `BeamMP_Installer.msi` и следуйте инструкциям.
+3. Значок BeamMP Launcher должен появиться на рабочем столе. Если нет, просто введите «BeamMP» в строку поиска Windows.
+
+:::примечание
+
+```
+  Поскольку при загрузке на карту с множеством созданных транспортных средств подключение может занять больше времени, чем ожидалось.
+```
+
+### **2б. Установка Linux**
+
+В настоящее время вам необходимо самостоятельно собрать Launcher. Для этого вам необходимо базовое понимание того, как собрать приложение.
+
+Убедитесь, что у вас установлены базовые инструменты разработки, которые обычно входят в пакеты, например:
+
+- Debian/Ubuntu: `sudo apt install build-essential`
+- Fedora: `sudo dnf install cmake gcc gcc-c++ make perl perl-IPC-Cmd perl-FindBin perl-File-Compare perl-File-Copy kernel-headers kernel-devel`
+- Arch: `sudo pacman -S base-devel`
+- openSUSE: `zypper in -t pattern devel-basis`
+- SteamOS (Arch): `sudo pacman -S base-devel linux-api-headers glibc libconfig` (Вам также необходимо выполнить команду `sudo steamos-readonly disable` , но не забудьте включить ее снова после установки пакетов)
+
+Склонируйте `vcpkg`, выполните его начальную сборку (bootstrap) и добавьте в PATH
+
+1.
+
+```bash
+git clone https://github.com/microsoft/vcpkg.git
+```
+
+1.
+
+```bash
+./vcpkg/bootstrap-vcpkg.sh
+```
+
+1.
+
+```bash
+export VCPKG_ROOT="$(pwd)/vcpkg"
+export PATH=$VCPKG_ROOT:$PATH
+```
+
+Клонируйте репозиторий BeamMP-Launcher в свою систему с помощью `git`, например: `git clone https://github.com/BeamMP/BeamMP-Launcher.git` [Дополнительная информация о клонировании репозитория GitHub](https://docs.github.com/en/repositories/creating-and-managing-repositories/cloning-a-repository)
+
+Переключитесь на тег, который использовался для [последнего релиза](https://github.com/BeamMP/BeamMP-Launcher/releases/latest). Например, если в последнем релизе использовался `v2.6.4`, выполните команду `git checkout v2.6.4`
+
+Если вы использовали пример команды клонирования, который мы предоставили, вы можете использовать `cd BeamMP-Launcher`, чтобы перейти в корневой каталог проекта.
+
+В корневом каталоге проекта,
+
+1.
+
+```cmake
+cmake . -B bin -DCMAKE_TOOLCHAIN_FILE=$VCPKG_ROOT/scripts/buildsystems/vcpkg.cmake -DVCPKG_TARGET_TRIPLET=x64-linux
+```
+
+1.
+
+```cmake
+cmake --build bin --parallel
+```
+
+:::примечание ""
+
+```
+  Если во время сборки не хватит оперативной памяти, можно исключить параметр --parallel — в этом случае сборка будет выполняться только в одном потоке процессора, что позволит сократить объем используемой оперативной памяти.
+```
+
+:::примечание ""
+
+```
+  Не указывая `-DCMAKE_BUILD_TYPE=Release`, вы создаете отладочную версию, которая больше по размеру файла, но не содержит ошибки, из-за которой программа запуска может подключиться к серверу только один раз.
+```
+
+:::примечание "Пользователи Fedora" Если vcpkg выдаёт ошибку при компиляции OpenSSL из-за заголовков ядра, убедитесь, что все зависимости установлены: `bash sudo dnf install kernel-headers kernel-devel gcc gcc-c++ make perl` Затем очистите кэш vcpkg: `bash rm -rf $VCPKG_ROOT/buildtrees/openssl` И повторите команду конфигурации cmake.
+
+Переместите готовое приложение из папки `/bin` в отдельную папку и запустите его оттуда:
+
+```bash
+mkdir -p ~/beammp-launcher
+cp bin/BeamMP-Launcher ~/beammp-launcher/
+cd ~/beammp-launcher
+./BeamMP-Launcher
+```
+
+Нативный Linux-ланчер BeamMP запустится и будет использовать нативную версию BeamNG.drive для Linux
+
+### **2c. Использование beamNG.drive с Proton**
+
+Если вы хотите использовать родной Linux BeamMP-Launcher вместе с BeamNG.drive, работающим через Proton, вы можете сделать это:
+
+Запустите BeamMP-Launcher, используя аргумент `--no-launch` (Это не позволит Launcher запустить собственный Linux BeamNG.drive). Дополнительную информацию об аргументах Launcher можно найти в [разделе Настройка среды разработки](../guides/beammp-dev/beammp-dev.md)
+
+Измените расположение пользовательской папки Proton-BeamNG.drive на расположение Linux-BeamNG.drive (поскольку собственный Linux BeamMP-Launcher в настоящее время записывает только в пользовательскую папку Linux-BeamNG.drive)
+
+Это можно сделать, например, создав символическую ссылку
+
+- Запомните местоположение пользовательской папки Linux-BeamNG.drive (обычно она находится в `~/.local/share/BeamNG.drive`) и переименуйте ее, например, в `BeamNG.drive_old`
+- Обратите внимание на расположение пользовательской папки Proton-BeamNG.drive (обычно она находится в `~/.local/share/Steam/steamapps/compatdata/284160/pfx/drive_c/users/steamuser/AppData/Local/BeamNG.drive`)
+- Создайте символическую ссылку между обеими папками пользователей `ln -s ~/.local/share/Steam/steamapps/compatdata/284160/pfx/drive_c/users/steamuser/AppData/Local/BeamNG.drive ~/.local/share`
+
+После установки символической ссылки между пользовательскими папками и скомпилированным лаунчером вы можете заставить Steam запустить игру через Proton, при этом лаунчер автоматически запустится со следующей заменой параметров запуска для оригинальной игры, которые можно найти в окне «Свойства» игры в ее записи в Steam:
+
+- `~/BeamMP/BeamMP-Launcher --no-launch & %command% ; killall BeamMP-Launcher`
+
+Обратите внимание, что это предполагает, что вы поместили скомпилированный ранее двоичный файл лаунчера в `/home/user/BeamMP/`, поэтому измените его так, чтобы он соответствовал месту, куда вы поместили готовый двоичный файл, и вам придется перекомпилировать лаунчер с правильной веткой git каждый раз при выпуске обновления лаунчера.
+
+::: tip "Добавление шрифта эмодзи для получения эмодзи в тексте"
+
+```
+Для того чтобы эмодзи отображались в списке серверов (как часть пользовательского имени сервера) или во внутриигровом чате, вам нужен шрифт, содержащий эмодзи.
+
+Это можно сделать, например, добавив [Linux-версию шрифта эмодзи Segoe-UI для Windows](https://github.com/mrbvrz/segoe-ui-linux)
+```
+
+---
+
+## **3. Использование BeamMP**
+
+1. После запуска лаунчера вы увидите окно терминала. Вскоре после этого должен запуститься стандартный лаунчер BeamNG. **Не** закрывайте окно терминала.
+2. В главном меню BeamNG.drive нажмите кнопку `Repository` и убедитесь, что включен <strong>только</strong> мод <code>multiplayerbeammp</code> .
+3. Выйдите в главное меню, нажмите «Ещё..», затем кнопку «Мультиплеер», чтобы начать игру по сети.
+4. Вам будет предложено войти или играть в качестве гостя (не все серверы допускают гостей). Вы можете создать учетную запись на нашем [форуме](https://forum.beammp.com), а затем войти в BeamMP с теми же учетными данными.
+5. Выберите любой понравившийся вам сервер и нажмите `Connect`. Наслаждайтесь!
+
+---
+
+## **4. Известные проблемы**
+
+- Нативный linux BeamMP-Launcher в настоящее время может подключиться к серверу только один раз, после отключения вам нужно перезапустить лаунчер. Вы можете сделать это, не закрывая игру между
+- Если вы не видите кнопку «Мультиплеер». Убедитесь, что мод BeamMP присутствует и активирован в «Менеджере модов», затем попробуйте нажать CTRL + L.
+- VPN любого типа могут вызывать проблемы с подключением.
+- Если Launcher сообщает о каких-либо ошибках, прочтите [FAQ](https://forum.beammp.com/c/faq/35).
+
+Если вам потребуется дополнительная помощь с установкой, вы можете создать сообщение на нашем [форуме](https://forum.beammp.com) или задать вопрос на нашем [сервере Discord](https://discord.gg/beammp).

docs/ru/get-started/install-beammp.md

@@ -0,0 +1,163 @@
+# Начиная
+
+## **1. Совместимость**
+
+BeamMP полностью совместим с Windows и Linux, совместимость с MacOS находится в разработке. Однако Linux и MacOS являются вторичными платформами, поэтому следует ожидать ошибок.
+
+:::предупреждение
+
+```
+BeamMP не будет работать с пиратскими или устаревшими версиями BeamNG.drive.
+Служба поддержки BeamMP не оказывает помощь по вопросам, связанным с пиратскими/устаревшими копиями.
+```
+
+---
+
+## **2. Установка**
+
+### **2а. Установка Windows**
+
+:::примечание
+
+```
+По состоянию на 1 апреля 2026 года, согласно Windows Defender SmartScreen, установщик MSI является «неопознанным приложением».
+
+Чтобы проигнорировать это предупреждение, нажмите «Подробнее», а затем нажмите «Запустить в любом случае».
+```
+
+1. Перейдите на [сайт beammp.com](https://beammp.com/) и нажмите кнопку «Скачать сейчас».
+2. Запустите установщик `BeamMP_Installer.msi` и следуйте инструкциям.
+3. Значок BeamMP Launcher должен появиться на рабочем столе. Если нет, просто введите «BeamMP» в строку поиска Windows.
+
+:::примечание
+
+```
+  Поскольку при загрузке на карту с множеством созданных транспортных средств подключение может занять больше времени, чем ожидалось.
+```
+
+### **2б. Установка Linux**
+
+В настоящее время вам необходимо самостоятельно собрать Launcher. Для этого вам необходимо базовое понимание того, как собрать приложение.
+
+Убедитесь, что у вас установлены базовые инструменты разработки, которые обычно входят в пакеты, например:
+
+- Debian/Ubuntu: `sudo apt install build-essential`
+- Fedora: `sudo dnf install cmake gcc gcc-c++ make perl perl-IPC-Cmd perl-FindBin perl-File-Compare perl-File-Copy kernel-headers kernel-devel`
+- Arch: `sudo pacman -S base-devel`
+- openSUSE: `zypper in -t pattern devel-basis`
+- SteamOS (Arch): `sudo pacman -S base-devel linux-api-headers glibc libconfig` (Вам также необходимо выполнить команду `sudo steamos-readonly disable` , но не забудьте включить ее снова после установки пакетов)
+
+Склонируйте `vcpkg`, выполните его начальную сборку (bootstrap) и добавьте в PATH
+
+1.
+
+```bash
+git clone https://github.com/microsoft/vcpkg.git
+```
+
+1.
+
+```bash
+./vcpkg/bootstrap-vcpkg.sh
+```
+
+1.
+
+```bash
+export VCPKG_ROOT="$(pwd)/vcpkg"
+export PATH=$VCPKG_ROOT:$PATH
+```
+
+Клонируйте репозиторий BeamMP-Launcher в свою систему с помощью `git`, например: `git clone https://github.com/BeamMP/BeamMP-Launcher.git` [Дополнительная информация о клонировании репозитория GitHub](https://docs.github.com/en/repositories/creating-and-managing-repositories/cloning-a-repository)
+
+Переключитесь на тег, который использовался для [последнего релиза](https://github.com/BeamMP/BeamMP-Launcher/releases/latest). Например, если в последнем релизе использовался `v2.6.4`, выполните команду `git checkout v2.6.4`
+
+Если вы использовали пример команды клонирования, который мы предоставили, вы можете использовать `cd BeamMP-Launcher`, чтобы перейти в корневой каталог проекта.
+
+В корневом каталоге проекта,
+
+1.
+
+```cmake
+cmake . -B bin -DCMAKE_TOOLCHAIN_FILE=$VCPKG_ROOT/scripts/buildsystems/vcpkg.cmake -DVCPKG_TARGET_TRIPLET=x64-linux
+```
+
+1.
+
+```cmake
+cmake --build bin --parallel
+```
+
+:::примечание ""
+
+```
+  Если во время сборки не хватит оперативной памяти, можно исключить параметр --parallel — в этом случае сборка будет выполняться только в одном потоке процессора, что позволит сократить объем используемой оперативной памяти.
+```
+
+:::примечание ""
+
+```
+  Не указывая `-DCMAKE_BUILD_TYPE=Release`, вы создаете отладочную версию, которая больше по размеру файла, но не содержит ошибки, из-за которой программа запуска может подключиться к серверу только один раз.
+```
+
+:::примечание "Пользователи Fedora" Если vcpkg выдаёт ошибку при компиляции OpenSSL из-за заголовков ядра, убедитесь, что все зависимости установлены: `bash sudo dnf install kernel-headers kernel-devel gcc gcc-c++ make perl` Затем очистите кэш vcpkg: `bash rm -rf $VCPKG_ROOT/buildtrees/openssl` И повторите команду конфигурации cmake.
+
+Переместите готовое приложение из папки `/bin` в отдельную папку и запустите его оттуда:
+
+```bash
+mkdir -p ~/beammp-launcher
+cp bin/BeamMP-Launcher ~/beammp-launcher/
+cd ~/beammp-launcher
+./BeamMP-Launcher
+```
+
+Нативный Linux-ланчер BeamMP запустится и будет использовать нативную версию BeamNG.drive для Linux
+
+### **2c. Использование beamNG.drive с Proton**
+
+Если вы хотите использовать родной Linux BeamMP-Launcher вместе с BeamNG.drive, работающим через Proton, вы можете сделать это:
+
+Запустите BeamMP-Launcher, используя аргумент `--no-launch` (Это не позволит Launcher запустить собственный Linux BeamNG.drive). Дополнительную информацию об аргументах Launcher можно найти в [разделе Настройка среды разработки](../guides/beammp-dev/beammp-dev.md)
+
+Измените расположение пользовательской папки Proton-BeamNG.drive на расположение Linux-BeamNG.drive (поскольку собственный Linux BeamMP-Launcher в настоящее время записывает только в пользовательскую папку Linux-BeamNG.drive)
+
+Это можно сделать, например, создав символическую ссылку
+
+- Запомните местоположение пользовательской папки Linux-BeamNG.drive (обычно она находится в `~/.local/share/BeamNG.drive`) и переименуйте ее, например, в `BeamNG.drive_old`
+- Обратите внимание на расположение пользовательской папки Proton-BeamNG.drive (обычно она находится в `~/.local/share/Steam/steamapps/compatdata/284160/pfx/drive_c/users/steamuser/AppData/Local/BeamNG.drive`)
+- Создайте символическую ссылку между обеими папками пользователей `ln -s ~/.local/share/Steam/steamapps/compatdata/284160/pfx/drive_c/users/steamuser/AppData/Local/BeamNG.drive ~/.local/share`
+
+После установки символической ссылки между пользовательскими папками и скомпилированным лаунчером вы можете заставить Steam запустить игру через Proton, при этом лаунчер автоматически запустится со следующей заменой параметров запуска для оригинальной игры, которые можно найти в окне «Свойства» игры в ее записи в Steam:
+
+- `~/BeamMP/BeamMP-Launcher --no-launch & %command% ; killall BeamMP-Launcher`
+
+Обратите внимание, что это предполагает, что вы поместили скомпилированный ранее двоичный файл лаунчера в `/home/user/BeamMP/`, поэтому измените его так, чтобы он соответствовал месту, куда вы поместили готовый двоичный файл, и вам придется перекомпилировать лаунчер с правильной веткой git каждый раз при выпуске обновления лаунчера.
+
+::: tip "Добавление шрифта эмодзи для получения эмодзи в тексте"
+
+```
+Для того чтобы эмодзи отображались в списке серверов (как часть пользовательского имени сервера) или во внутриигровом чате, вам нужен шрифт, содержащий эмодзи.
+
+Это можно сделать, например, добавив [Linux-версию шрифта эмодзи Segoe-UI для Windows](https://github.com/mrbvrz/segoe-ui-linux)
+```
+
+---
+
+## **3. Использование BeamMP**
+
+1. После запуска лаунчера вы увидите окно терминала. Вскоре после этого должен запуститься стандартный лаунчер BeamNG. **Не** закрывайте окно терминала.
+2. В главном меню BeamNG.drive нажмите кнопку `Repository` и убедитесь, что включен <strong>только</strong> мод <code>multiplayerbeammp</code> .
+3. Выйдите в главное меню, нажмите «Ещё..», затем кнопку «Мультиплеер», чтобы начать игру по сети.
+4. Вам будет предложено войти или играть в качестве гостя (не все серверы допускают гостей). Вы можете создать учетную запись на нашем [форуме](https://forum.beammp.com), а затем войти в BeamMP с теми же учетными данными.
+5. Выберите любой понравившийся вам сервер и нажмите `Connect`. Наслаждайтесь!
+
+---
+
+## **4. Известные проблемы**
+
+- Нативный linux BeamMP-Launcher в настоящее время может подключиться к серверу только один раз, после отключения вам нужно перезапустить лаунчер. Вы можете сделать это, не закрывая игру между
+- Если вы не видите кнопку «Мультиплеер». Убедитесь, что мод BeamMP присутствует и активирован в «Менеджере модов», затем попробуйте нажать CTRL + L.
+- VPN любого типа могут вызывать проблемы с подключением.
+- Если Launcher сообщает о каких-либо ошибках, прочтите [FAQ](https://forum.beammp.com/c/faq/35).
+
+Если вам потребуется дополнительная помощь с установкой, вы можете создать сообщение на нашем [форуме](https://forum.beammp.com) или задать вопрос на нашем [сервере Discord](https://discord.gg/beammp).

docs/ru/get-started/join-first-server.md

@@ -0,0 +1,163 @@
+# Начиная
+
+## **1. Совместимость**
+
+BeamMP полностью совместим с Windows и Linux, совместимость с MacOS находится в разработке. Однако Linux и MacOS являются вторичными платформами, поэтому следует ожидать ошибок.
+
+:::предупреждение
+
+```
+BeamMP не будет работать с пиратскими или устаревшими версиями BeamNG.drive.
+Служба поддержки BeamMP не оказывает помощь по вопросам, связанным с пиратскими/устаревшими копиями.
+```
+
+---
+
+## **2. Установка**
+
+### **2а. Установка Windows**
+
+:::примечание
+
+```
+По состоянию на 1 апреля 2026 года, согласно Windows Defender SmartScreen, установщик MSI является «неопознанным приложением».
+
+Чтобы проигнорировать это предупреждение, нажмите «Подробнее», а затем нажмите «Запустить в любом случае».
+```
+
+1. Перейдите на [сайт beammp.com](https://beammp.com/) и нажмите кнопку «Скачать сейчас».
+2. Запустите установщик `BeamMP_Installer.msi` и следуйте инструкциям.
+3. Значок BeamMP Launcher должен появиться на рабочем столе. Если нет, просто введите «BeamMP» в строку поиска Windows.
+
+:::примечание
+
+```
+  Поскольку при загрузке на карту с множеством созданных транспортных средств подключение может занять больше времени, чем ожидалось.
+```
+
+### **2б. Установка Linux**
+
+В настоящее время вам необходимо самостоятельно собрать Launcher. Для этого вам необходимо базовое понимание того, как собрать приложение.
+
+Убедитесь, что у вас установлены базовые инструменты разработки, которые обычно входят в пакеты, например:
+
+- Debian/Ubuntu: `sudo apt install build-essential`
+- Fedora: `sudo dnf install cmake gcc gcc-c++ make perl perl-IPC-Cmd perl-FindBin perl-File-Compare perl-File-Copy kernel-headers kernel-devel`
+- Arch: `sudo pacman -S base-devel`
+- openSUSE: `zypper in -t pattern devel-basis`
+- SteamOS (Arch): `sudo pacman -S base-devel linux-api-headers glibc libconfig` (Вам также необходимо выполнить команду `sudo steamos-readonly disable` , но не забудьте включить ее снова после установки пакетов)
+
+Склонируйте `vcpkg`, выполните его начальную сборку (bootstrap) и добавьте в PATH
+
+1.
+
+```bash
+git clone https://github.com/microsoft/vcpkg.git
+```
+
+1.
+
+```bash
+./vcpkg/bootstrap-vcpkg.sh
+```
+
+1.
+
+```bash
+export VCPKG_ROOT="$(pwd)/vcpkg"
+export PATH=$VCPKG_ROOT:$PATH
+```
+
+Клонируйте репозиторий BeamMP-Launcher в свою систему с помощью `git`, например: `git clone https://github.com/BeamMP/BeamMP-Launcher.git` [Дополнительная информация о клонировании репозитория GitHub](https://docs.github.com/en/repositories/creating-and-managing-repositories/cloning-a-repository)
+
+Переключитесь на тег, который использовался для [последнего релиза](https://github.com/BeamMP/BeamMP-Launcher/releases/latest). Например, если в последнем релизе использовался `v2.6.4`, выполните команду `git checkout v2.6.4`
+
+Если вы использовали пример команды клонирования, который мы предоставили, вы можете использовать `cd BeamMP-Launcher`, чтобы перейти в корневой каталог проекта.
+
+В корневом каталоге проекта,
+
+1.
+
+```cmake
+cmake . -B bin -DCMAKE_TOOLCHAIN_FILE=$VCPKG_ROOT/scripts/buildsystems/vcpkg.cmake -DVCPKG_TARGET_TRIPLET=x64-linux
+```
+
+1.
+
+```cmake
+cmake --build bin --parallel
+```
+
+:::примечание ""
+
+```
+  Если во время сборки не хватит оперативной памяти, можно исключить параметр --parallel — в этом случае сборка будет выполняться только в одном потоке процессора, что позволит сократить объем используемой оперативной памяти.
+```
+
+:::примечание ""
+
+```
+  Не указывая `-DCMAKE_BUILD_TYPE=Release`, вы создаете отладочную версию, которая больше по размеру файла, но не содержит ошибки, из-за которой программа запуска может подключиться к серверу только один раз.
+```
+
+:::примечание "Пользователи Fedora" Если vcpkg выдаёт ошибку при компиляции OpenSSL из-за заголовков ядра, убедитесь, что все зависимости установлены: `bash sudo dnf install kernel-headers kernel-devel gcc gcc-c++ make perl` Затем очистите кэш vcpkg: `bash rm -rf $VCPKG_ROOT/buildtrees/openssl` И повторите команду конфигурации cmake.
+
+Переместите готовое приложение из папки `/bin` в отдельную папку и запустите его оттуда:
+
+```bash
+mkdir -p ~/beammp-launcher
+cp bin/BeamMP-Launcher ~/beammp-launcher/
+cd ~/beammp-launcher
+./BeamMP-Launcher
+```
+
+Нативный Linux-ланчер BeamMP запустится и будет использовать нативную версию BeamNG.drive для Linux
+
+### **2c. Использование beamNG.drive с Proton**
+
+Если вы хотите использовать родной Linux BeamMP-Launcher вместе с BeamNG.drive, работающим через Proton, вы можете сделать это:
+
+Запустите BeamMP-Launcher, используя аргумент `--no-launch` (Это не позволит Launcher запустить собственный Linux BeamNG.drive). Дополнительную информацию об аргументах Launcher можно найти в [разделе Настройка среды разработки](../guides/beammp-dev/beammp-dev.md)
+
+Измените расположение пользовательской папки Proton-BeamNG.drive на расположение Linux-BeamNG.drive (поскольку собственный Linux BeamMP-Launcher в настоящее время записывает только в пользовательскую папку Linux-BeamNG.drive)
+
+Это можно сделать, например, создав символическую ссылку
+
+- Запомните местоположение пользовательской папки Linux-BeamNG.drive (обычно она находится в `~/.local/share/BeamNG.drive`) и переименуйте ее, например, в `BeamNG.drive_old`
+- Обратите внимание на расположение пользовательской папки Proton-BeamNG.drive (обычно она находится в `~/.local/share/Steam/steamapps/compatdata/284160/pfx/drive_c/users/steamuser/AppData/Local/BeamNG.drive`)
+- Создайте символическую ссылку между обеими папками пользователей `ln -s ~/.local/share/Steam/steamapps/compatdata/284160/pfx/drive_c/users/steamuser/AppData/Local/BeamNG.drive ~/.local/share`
+
+После установки символической ссылки между пользовательскими папками и скомпилированным лаунчером вы можете заставить Steam запустить игру через Proton, при этом лаунчер автоматически запустится со следующей заменой параметров запуска для оригинальной игры, которые можно найти в окне «Свойства» игры в ее записи в Steam:
+
+- `~/BeamMP/BeamMP-Launcher --no-launch & %command% ; killall BeamMP-Launcher`
+
+Обратите внимание, что это предполагает, что вы поместили скомпилированный ранее двоичный файл лаунчера в `/home/user/BeamMP/`, поэтому измените его так, чтобы он соответствовал месту, куда вы поместили готовый двоичный файл, и вам придется перекомпилировать лаунчер с правильной веткой git каждый раз при выпуске обновления лаунчера.
+
+::: tip "Добавление шрифта эмодзи для получения эмодзи в тексте"
+
+```
+Для того чтобы эмодзи отображались в списке серверов (как часть пользовательского имени сервера) или во внутриигровом чате, вам нужен шрифт, содержащий эмодзи.
+
+Это можно сделать, например, добавив [Linux-версию шрифта эмодзи Segoe-UI для Windows](https://github.com/mrbvrz/segoe-ui-linux)
+```
+
+---
+
+## **3. Использование BeamMP**
+
+1. После запуска лаунчера вы увидите окно терминала. Вскоре после этого должен запуститься стандартный лаунчер BeamNG. **Не** закрывайте окно терминала.
+2. В главном меню BeamNG.drive нажмите кнопку `Repository` и убедитесь, что включен <strong>только</strong> мод <code>multiplayerbeammp</code> .
+3. Выйдите в главное меню, нажмите «Ещё..», затем кнопку «Мультиплеер», чтобы начать игру по сети.
+4. Вам будет предложено войти или играть в качестве гостя (не все серверы допускают гостей). Вы можете создать учетную запись на нашем [форуме](https://forum.beammp.com), а затем войти в BeamMP с теми же учетными данными.
+5. Выберите любой понравившийся вам сервер и нажмите `Connect`. Наслаждайтесь!
+
+---
+
+## **4. Известные проблемы**
+
+- Нативный linux BeamMP-Launcher в настоящее время может подключиться к серверу только один раз, после отключения вам нужно перезапустить лаунчер. Вы можете сделать это, не закрывая игру между
+- Если вы не видите кнопку «Мультиплеер». Убедитесь, что мод BeamMP присутствует и активирован в «Менеджере модов», затем попробуйте нажать CTRL + L.
+- VPN любого типа могут вызывать проблемы с подключением.
+- Если Launcher сообщает о каких-либо ошибках, прочтите [FAQ](https://forum.beammp.com/c/faq/35).
+
+Если вам потребуется дополнительная помощь с установкой, вы можете создать сообщение на нашем [форуме](https://forum.beammp.com) или задать вопрос на нашем [сервере Discord](https://discord.gg/beammp).

docs/ru/get-started/multiplayer-settings-quickstart.md

@@ -0,0 +1,323 @@
+# Настройки Мультиплеера
+
+## **1. Общие**
+
+??? setting "Продвинутые настройки"
+
+```
+Если включено, будут видны все настройки многопользовательской игры
+
+Если выключено, видны только базовые настройки
+```
+
+??? setting "Включить защиту от клонирования конфигурации"
+
+```
+Если включено, конфигурация вашего транспортного средства будет защищена от сохранения другими игроками
+
+Если выключено, другие игроки смогут сохранить вашу конфигурацию
+```
+
+??? setting "Отключить паузу из-за нестабильностей"
+
+```
+Если включено, физические нестабильности не будут останавливать игру
+
+Если выключено, нестабильности будут вызывать паузу
+
+::: note ""
+
+    Рекомендуется оставить выключенным, так как повторяющиеся нестабильности могут привести к крашу игры
+```
+
+??? setting "Использовать упрощённые транспортные средства, если доступны"
+
+```
+Если включено, транспортные средства других игроков будут заменяться упрощёнными моделями (как в AI-трафике), если они доступны
+
+Если выключено, будут использоваться оригинальные модели
+```
+
+??? setting "Новое меню чата"
+
+```
+Если включено, чат отображается в окне [IMGUI](https://github.com/ocornut/imgui), которое можно, например, переместить на другой монитор
+
+Если выключено, чат отображается в стандартном UI приложении
+
+::: note ""
+
+    Перетаскивание IMGUI окон может снизить производительность и сбивать программы записи экрана, записывая окно чата вместо основного окна игры
+```
+
+??? setting "Включить сглаживание положения автомобиля"
+
+```
+Если включено, BeamMP будет использовать алгоритм для сглаживания обновлений позиции транспортного средства через регулярные интервалы. Это может быть полезно для игроков с высоким пингом или при высокой потере пакетов
+
+Если выключено, BeamMP будет обновлять позиции транспортных средств по мере их получения
+```
+
+??? setting "Пропускать предупреждение безопасности модов"
+
+```
+Если включено, всплывающее окно с предупреждением о безопасности модов не будет отображаться при подключении к серверу с модами
+
+Если выключено, предупреждение будет показываться каждый раз при подключении к серверу с модами
+```
+
+??? setting "Включить очередь обновлений/редактирования"
+
+```
+Если включено, спавн и изменения транспортных средств других игроков будут помещаться в очередь. Подробнее см. раздел `2. Очередь событий`
+
+Если выключено, спавн и изменения транспортных средств других игроков будут загружаться мгновенно
+```
+
+??? setting "Включить автоматическую синхронизацию деталей"
+
+```
+Если включено, детали вашего транспортного средства автоматически синхронизируются с другими игроками через несколько секунд
+
+Если выключено, необходимо вручную нажимать кнопку синхронизации деталей в меню выбора деталей для отправки синхронизации другим игрокам
+```
+
+??? setting "Выключить переключение на машины других игроков"
+
+```
+Если включено, переключение между транспортными средствами пропустит машины других игроков
+
+Если выключено, переключение будет происходить по всем доступным транспортным средствам
+```
+
+??? setting "Сделать машины прозрачными при приближении"
+
+```
+Если включено, другие машины будут постепенно исчезать по мере приближения
+
+Если выключено, другие машины будут полностью видимы независимо от расстояния
+
+::: note ""
+
+    Это влияет только на видимую 3D-модель машины, а не на физическую mesh-сетку. Чтобы также отключить физику, необходимо включить `Упрощённая физика столкновений` в настройках игры
+```
+
+??? setting "Показывать ID игроков"
+
+```
+Если включено, в списке игроков появится дополнительная колонка с ID каждого игрока. Полезно для разработки или модерации
+
+Если выключено, список игроков будет показывать только имя игрока и пинг
+```
+
+??? setting "Разрешить обновление списка серверов в игре"
+
+```
+Если включено, список серверов будет обновляться с регулярными интервалами во время игры. Это может вызвать лаги
+
+Если выключено, список серверов обновляется только при открытии главного меню
+```
+
+## **2. Очередь событий**
+
+??? setting "Выделить игроков в очереди"
+
+```
+Если включено, игроки с ожидающими событиями будут выделены в списке игроков
+
+Если выключено, игроки не будут выделяться индивидуально
+```
+
+??? setting "Выделять игроков с очередью"
+
+```
+Если установлено `Левая кнопка мыши`, клик по имени игрока в списке левой кнопкой мыши загрузит ожидающие события, правая кнопка — позволит наблюдать за игроком
+
+Если установлено `Правая кнопка мыши`, клик правой кнопкой мыши загрузит ожидающие события, левая кнопка — позволит наблюдать
+```
+
+??? setting "Автоматизировать очередь"
+
+```
+Если включено, события из очереди будут автоматически загружены после того, как ваш транспорт опустится ниже порога скорости на установленное время таймаута
+
+Если выключено, события загружаются вручную, через кнопку `События` в верхней части экрана или клик по имени игрока в списке
+```
+
+??? setting "Порог скорости для срабатывания очереди"
+
+```
+Этот параметр определяет порог скорости для автоматической загрузки событий из очереди. Ваш транспорт должен быть медленнее этого порога дольше, чем `Таймаут срабатывания очереди`, чтобы события были загружены
+```
+
+??? setting "Таймаут срабатывания очереди"
+
+```
+Этот параметр определяет задержку времени для автоматической загрузки событий из очереди. Ваш транспорт должен быть медленнее `Порог скорости для срабатывания очереди` в течение этого времени, чтобы события были загружены
+```
+
+??? setting "Не использовать очередь в режиме наблюдения"
+
+```
+Если включено, событие будет загружено мгновенно, если вы наблюдаете за другим игроком
+
+Если выключено, событие будет помещено в очередь, как при фокусе на вашем транспортном средстве
+```
+
+??? setting "Не использовать очередь с Юнициклами (Снеговиками/Бимлингсами)"
+
+```
+Если включено, событие, связанное с снеговиком или бимлингом, будет загружено мгновенно
+
+Если выключено, снеговики/бимлинги будут помещены в очередь, как и другие машины
+```
+
+## **3. Настройка стандартного Юницикла**
+
+??? setting "Конфигурация Юницикла по Умолчанию"
+
+```
+Этот параметр определяет вариант юницикла, который будет загружаться по умолчанию. Можно выбрать между готовыми конфигурациями или своими сохранёнными настройками
+```
+
+??? setting "Автоматически сохранять последний использованный Юницикл"
+
+```
+Если включено, последний использованный юницикл автоматически сохранится и загрузится при следующем спавне
+
+Если выключено, будет спавниться конфигурация по умолчанию
+```
+
+## **4. Капли**
+
+??? setting "Использовать капли для незаспавнившегося автомобиля"
+
+```
+Если включено, вместо незаспавненного транспортного средства будет отображаться placeholder-объект (капля)
+
+Если выключено, незаспавненный транспорт будет невидим
+```
+
+??? setting "Изменить цвет"
+
+```
+??? setting "Видимость"
+
+    Если включено, капля будет нарисована с использованием выбранного цвета.
+
+    Если выключено, капля отображаться не будет.
+
+??? setting "RGB HEX значения"
+
+    Ожидаемый транспорт: цвет капли при очереди на спавн, стандарт #FF6400
+
+    Незаконный транспорт: цвет капли для запрещенного транспорта (например, через сторонний мод), стандарт #000000
+
+    Удалённый транспорт: цвет капли для удалённого пользователем транспорта, стандарт #333333
+```
+
+## **5. Ники**
+
+??? setting "Скрыть ники игроков"
+
+```
+Если включено, ники игроков не отображаются
+
+Если выключено, ники игроков отображаются в зависимости от позиции их машин
+```
+
+??? setting "Показывать дистанцию до других игроков"
+
+```
+Если включено, к нику будет добавлено расстояние до соответствующего транспортного средства
+
+Если выключено, расстояние отображаться не будет
+```
+
+??? setting "Включить/выключть исчезновение ников"
+
+```
+Если включено, ники будут появляться/исчезать в зависимости от `Дистанция исчезновения ников` и `Инвертировать направление исчезновения`
+
+Если выключено, ники будут отображаться с обычной непрозрачностью вне зависимости от расстояния
+```
+
+??? setting "Дистанция исчезновения ников/Инвертировать направление исчезновения"
+
+```
+::: info "Исчезновение"
+
+    Ники становятся менее видимыми, чем дальше находится игрок
+
+    `Дистанция исчезновения ников` определяет расстояние, на котором ник отображается с минимальной непрозрачностью
+
+::: info "Появление"
+
+    Ники становятся более видимыми, чем дальше находится игрок
+
+    `Дистанция исчезновения ников` определяет расстояние, на котором ник отображается с максимальной непрозрачностью
+```
+
+??? setting "Не скрывать ники полностью"
+
+```
+Если включено, ники не могут быть полностью невидимыми, сохраняется минимальная непрозрачность вне зависимости от расстояния
+
+Если выключено, ники могут стать полностью невидимыми
+```
+
+??? setting "Обрезать длинные никнеймы и роли"
+
+```
+Если включено, `Лимит длины ника` обрежет ники и роли до установленного числа символов
+
+Если выключено, ники и роли отображаются полностью
+```
+
+??? setting "Показать наблюдателей под ником автомобиля"
+
+```
+Если включено, под ником игрока будет отображаться имя наблюдателя
+
+Если выключено, имена наблюдателей не отображаются
+```
+
+??? setting "Показывать никнеймы наблюдателей серым цветом независимо от их роли"
+
+```
+Если включено, ник наблюдателя всегда будет окружён серым фоном
+
+Если выключено, фон будет отражать роль наблюдателя цветом
+```
+
+## **6. Другие**
+
+??? setting "Показывать сетевую активность в консоле"
+
+```
+Если включено, активность сети BeamMP будет отображаться в консоле
+
+Если выключено, активность сети не будет отображаться
+
+::: danger ""
+
+    Будьте осторожны с этой настройкой, так как весь вывод консоли также записывается в лог-файлы
+    
+    При включении эта настройка может привести к росту файлов логов на сотни мегабайт за считанные минуты
+```
+
+??? setting "Порт лаунчера"
+
+```
+Этот параметр определяет порт для связи с лаунчером
+
+Изменять следует только если стандартный порт 4444 использовать нельзя
+
+Не забудьте также изменить его в конфигурации лаунчера `launcher.cfg`
+
+::: tip ""
+
+    Указанный порт — первый из двух. Второй порт используется сразу после него, то есть порт + 1
+
+    Первый порт передаёт основные сетевые пакеты, второй — игровые пакеты, оба через TCP
+```