From 65de219688c3d965dc468b09a0d983fa02ac6919 Mon Sep 17 00:00:00 2001 From: Protogen187 <162638343+Protogen187@users.noreply.github.com> Date: Tue, 6 Jan 2026 23:15:28 +0100 Subject: [PATCH 1/5] Update server-maintenance.md Update variable table --- docs/en/server/server-maintenance.md | 29 ++++++++++++++++++---------- 1 file changed, 19 insertions(+), 10 deletions(-) diff --git a/docs/en/server/server-maintenance.md b/docs/en/server/server-maintenance.md index 682f363f..dba4782e 100644 --- a/docs/en/server/server-maintenance.md +++ b/docs/en/server/server-maintenance.md @@ -14,16 +14,25 @@ The server config, which is a file called `ServerConfig.toml`, uses the [TOML fo 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. | +| Key | Value Type | Description | +|-------------------|----------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| 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 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. | +| AllowGuests | true/false | Determines wether guests are allowed to join the server or not. | +| LogChat | true/false | When enabled (true), chat messages are logged in the server.log file. | +| 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. | +| InformationPacket | true/false | When enabled (true), the server is going to !! <--- NEEDS FILLING ---> !! | +| 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. | +| Tags | Any "text" | Tags for search e.g. Police, Racing etc... | +| MaxCars | Any number ≥ 1 | The maximum number of cars per player. Any additional cars a player tries to spawn will be deleted instantly. | +| MaxPlayers | Any Number ≥ 1 | The maximum amount of players per server. This does not affect vehicle count. | +| 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. | +| 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. | +| ResourceFolder | A valid folder location, such as "D:\Server\BeamMP\Resources" | Useful to store the server and the resource folder seperately. | +| ImScaredOfUpdates | true/false | This sets the Server to either auto update or not when a new version is released. | +| UpdateReminderTime| Any number with s, min, h, d appended. (30s) | Sets the interval of the update reminder message printed in the terminal. + Other sections can and should be used by server plugins (Lua API coming soon), like so: `[MyMod]`. From 7a0bd071d2e51967b5965445c8c03e7d082378a1 Mon Sep 17 00:00:00 2001 From: Protogen187 <162638343+Protogen187@users.noreply.github.com> Date: Sat, 24 Jan 2026 20:31:51 +0100 Subject: [PATCH 2/5] Update server-maintenance.md Update .toml variable table --- docs/en/server/server-maintenance.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/en/server/server-maintenance.md b/docs/en/server/server-maintenance.md index dba4782e..4379dcaa 100644 --- a/docs/en/server/server-maintenance.md +++ b/docs/en/server/server-maintenance.md @@ -16,13 +16,13 @@ The config has one section by default, called `[General]`, which holds the follo | Key | Value Type | Description | |-------------------|----------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| 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 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. | +| Port | 1024-65535 | The networking port on which the server will be reachable. (Must be unique and not be used by another service on the same host). | +| AuthKey | AuthKey format `xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx` where all x's are alphanumeric characters (numbers and letters) | Used to identify a public set server with the backend. | | AllowGuests | true/false | Determines wether guests are allowed to join the server or not. | | LogChat | true/false | When enabled (true), chat messages are logged in the server.log file. | | 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. | -| InformationPacket | true/false | When enabled (true), the server is going to !! <--- NEEDS FILLING ---> !! | +| InformationPacket | true/false | When enabled (true), the server is going to allow unauthenticated clients to get the same info as on the server listing but directly via the server. | | 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. | | Tags | Any "text" | Tags for search e.g. Police, Racing etc... | | MaxCars | Any number ≥ 1 | The maximum number of cars per player. Any additional cars a player tries to spawn will be deleted instantly. | From fd374ec99f53a00c884f6216d81510cee12d768f Mon Sep 17 00:00:00 2001 From: Protogen187 <162638343+Protogen187@users.noreply.github.com> Date: Sun, 1 Feb 2026 20:17:17 +0100 Subject: [PATCH 3/5] Update server-maintenance.md Add referal to tag list --- docs/en/server/server-maintenance.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/en/server/server-maintenance.md b/docs/en/server/server-maintenance.md index 4379dcaa..021d45b1 100644 --- a/docs/en/server/server-maintenance.md +++ b/docs/en/server/server-maintenance.md @@ -24,7 +24,7 @@ The config has one section by default, called `[General]`, which holds the follo | 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. | | InformationPacket | true/false | When enabled (true), the server is going to allow unauthenticated clients to get the same info as on the server listing but directly via the server. | | 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. | -| Tags | Any "text" | Tags for search e.g. Police, Racing etc... | +| Tags | See list of allowed tags further below. | Tags for search e.g. Police, Racing etc... | | MaxCars | Any number ≥ 1 | The maximum number of cars per player. Any additional cars a player tries to spawn will be deleted instantly. | | MaxPlayers | Any Number ≥ 1 | The maximum amount of players per server. This does not affect vehicle count. | | 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. | From 419bb7f5e1ad5944fb946dc79e733b3c77942b38 Mon Sep 17 00:00:00 2001 From: Protogen187 <162638343+Protogen187@users.noreply.github.com> Date: Sun, 22 Feb 2026 18:47:36 +0100 Subject: [PATCH 4/5] Update create-a-server.md add Windows Defender reference in 1.1 --- docs/en/server/create-a-server.md | 1 + 1 file changed, 1 insertion(+) diff --git a/docs/en/server/create-a-server.md b/docs/en/server/create-a-server.md index 4f4747e6..7c45458a 100644 --- a/docs/en/server/create-a-server.md +++ b/docs/en/server/create-a-server.md @@ -65,6 +65,7 @@ Depending on your setup, you may need to let BeamMP-Server through your firewall There you want to allow the BeamMP-Server through the firewall, **both incoming and outgoing connections**, and **both TCP and UDP**. If your firewall asks for a port instead, that will have to be the same port you used in step “1\. Port Forwarding” (usually 30814). +For a more detailed guide, refer to [this documentation page](https://docs.beammp.com/FAQ/Defender-exclusions/). If you have issues, also feel free to ask on our [Forum](https://forum.beammp.com) or on our [Discord server](https://discord.gg/beammp) in the `#support` channel. ### **2. Obtaining an Authentication Key** From 32edae3db1af00bccad26e810714fe0086925ee4 Mon Sep 17 00:00:00 2001 From: Protogen187 <162638343+Protogen187@users.noreply.github.com> Date: Sun, 22 Feb 2026 19:17:58 +0100 Subject: [PATCH 5/5] Update Defender-exclusions.md Adapt to include BeamMP-Server section. --- docs/en/FAQ/Defender-exclusions.md | 22 +++++++++++++++++----- 1 file changed, 17 insertions(+), 5 deletions(-) diff --git a/docs/en/FAQ/Defender-exclusions.md b/docs/en/FAQ/Defender-exclusions.md index ba65dc49..aebde919 100644 --- a/docs/en/FAQ/Defender-exclusions.md +++ b/docs/en/FAQ/Defender-exclusions.md @@ -12,25 +12,37 @@ We take no responsibility for any content on any externally linked services or websites. -## 1. Firewall exclusion for the BeamMP-Launcher. +## 1. Defender Firewall exclusion for the BeamMP-Launcher. 1. Open the `Windows Defender Firewall with advanced setting`. 2. In the Window, click `Inbound` to open the inbound exclusions tab. 3. Click `Create new rule` in the top right to create a new exclusion. 4. Select `Program` to create a program specific exclusion. -5. Enter the full qualified path towards the `BeamMP-Launcher.exe`. By default, this would be `%appdata%\BeamMP-Launcher\BeamMP-Launcher.exe` without quotes. +5. Enter the full qualified path towards the `BeamMP-Launcher.exe`. The default would be `%appdata%\BeamMP-Launcher\BeamMP-Launcher.exe` (without quotes). 6. Make sure to allow the connection 7. Give the exclusion a name (e.g. "BeamMP-Launcher") and save it. -8. Restart your PC. +9. Restart your PC. -## 2. Antivirus exclsuion for the BeamMP-Launcher. +## 1.1 Defender Firewwall exclusion for the BeamMP-Server. + +1. Open the `Windows Defender Firewall with advanced setting`. +2. In the Window, click `Inbound` to open the inbound exclusions tab. +3. Click `Create new rule` in the top right to create a new exclusion. +4. Select `Port` to create a program specific exclusion. +5. Enter the same port as in the ServerConfig.toml. +6. Enter the full qualified path towards the `BeamMP-Server.exe`. The file is located whereever you placed it after downloading it. +7. Make sure to allow the connection +8. Give the exclusion a name (e.g. "BeamMP-Server") and save it. +9. Restart your PC. + +## 2. Defender Antivirus exclsuion for the BeamMP-Launcher/Server. 1. Open the `Windows Security` app. 2. Click the first item `virus and threat protection`. 3. Click `Manage settings` beneath "Virus & threat protection settings". 4. Scroll down to navigate to the `Exclusions` tab. 5. There, click 'Add an exclusion' and select `process`. -6. Enter `BeamMP-Launcher.exe` into the field and save it. +6. Enter `BeamMP-Launcher.exe` or `BeamMP-Server.exe`into the field and save it. 7. Restart your PC. ## Still facing issues?