From 7e3ae96a80149880668df97fa1f8f1474d701c6a Mon Sep 17 00:00:00 2001 From: O1LER <44237025+O1LER@users.noreply.github.com> Date: Fri, 28 Feb 2025 22:18:48 +0100 Subject: [PATCH 1/6] Add multiplayer options page in replacement of tailoring --- docs/en/game/multiplayer-settings.md | 213 +++++++++++++++++++++++++++ docs/en/game/tailoring.md | 9 -- docs/stylesheets/custom.css | 18 +++ mkdocs.yml | 12 +- 4 files changed, 237 insertions(+), 15 deletions(-) create mode 100644 docs/en/game/multiplayer-settings.md delete mode 100644 docs/en/game/tailoring.md diff --git a/docs/en/game/multiplayer-settings.md b/docs/en/game/multiplayer-settings.md new file mode 100644 index 00000000..00e21d64 --- /dev/null +++ b/docs/en/game/multiplayer-settings.md @@ -0,0 +1,213 @@ +# Mutliplayer Settings + +## **1. General** + +??? setting "Show advanced options" + + If enabled, you will see all multiplayer settings + + If disabled, you will see only basic multiplayer settings + +??? setting "Enable config cloning protection" + + If enabled, your spawned vehicle config will be protected from other players saving it + + If disabled, your spawned vehicle config can be saved by other players + +??? setting "Disable pausing caused by instabilities" + + If enabled, physics instabilities will not cause your game to pause + + If disabled, physics instabilities will cause your game to pause + + !!! note "" + + Its advised to leave disabled, since repeated instabilities can cause the game to crash + +??? setting "Use simplified vehicles when available" + + If enabled, the game will replace vehicles of other players with their simplified versions (from AI traffic) if available + + If disabled, the game will use the intended vehicle models + +??? setting "New chat menu" + + If enabled, the ingame chat will be displayed in an [IMGUI](https://github.com/ocornut/imgui) window, that for example can be dragged out of the game onto another monitor + + If disabled, the ingame chat will be displayed in the UI app + + !!! note "" + + Dragging IMGUI windows out of the main game window can cause performance issues, as well as trick screen recording software into recording the chat window instead of the main game window + +??? setting "Enable vehicle position smoothing" + + If enabled, beamMP will use an algorithm to smooth vehicle position updates to regular intervalls. Can be beneficial between players with high ping or when a connection experiences a high package drop rate + + If disabled, beamMP will update vehicle locations as they are received + +??? setting "Skip the mod security warning popusp" + + If enabled, the mod security popup will not be shown when trying to connect to a server with mods + + If disabled, the mod security popup will be shown when trying to connect to a server with mods the first time + +??? setting "Enable player vehicle update/edit queuing" + + If enabled, other players vehicle spawns and edits will be put into a queue. See the section `2. Event queue` for further details + + If disabled, other players vehicle spawns and edits will be loaded by the game instantly + +??? setting "Enable automatic part sync" + + If enabled, your vehicles parts will automatically be synced to other players after a few seconds + + If disbaled, you need to click the part sync button in the part picker in order to send a sync out to other players + +??? setting "Disable switching to other players vehicles" + + If enabled, tabbing trough vehicles will skip other players vehicles + + If disabled, tabbing trough vehicles will cycle over every spawned vehicle + +??? setting "Fade out vehicles as they get closer" + + If enabled, other vehicles will fade out as they get closer + + If disbaled, other vehicles will stay fully visible regardless of distance + + !!! note "" + + This only affects the visible 3d mesh of a vehicle, not its physics node-beam-mesh. In order to also disable physics, you need to enable `Simplified collision physics` in the Gameplay settings + +??? setting "Show the player ID`s" + + If enabled, the ingame playerlist will have an additional row showing each players ID. Useful for development or moderation + + If disabled, the ingame playerlist will only show the rows for playername and ping + +??? setting "Allow the serverlist to refresh ingame" + + If enabled, the serverlist will update in regular intervalls while playing. This can cause lag spikes + + If disabled, the serverlist will only update once you open the main menu + +## **2. Event queue** + +??? setting "Highlight queued players" + + If enabled, players with a queued event will be highlighted in the ingame playerlist + + If disabled, players will not be individually highlighted + +??? setting "Apply vehicle changes with" + + If set to `Left mouse button`, clicking on a players name in the playerlist using the left mouse button will load the queued events. Clicking with the right mouse button will spectate said player + + If set to `Right mouse button`, clicking on a players name in the playerlist using the right mouse button will load the queued events. Clicking with the left mouse button will spectate said player + +??? setting "Automatically apply queued vehicle changes" + + If enabled, the queued events will be automatically loaded once `Queue apply speed treshold` was not surpassed for `Queue apply timeout` + + If disabled, the queued events will only load manually, by clicking on either the `Events` button at the top of the screen or on a players name in the playerlist + +??? setting "Queue apply speed treshold" + + This setpoint defines the speed treshold of the automatic event queue loading. Your vehicle has to be slower than this for longer than `Queue apply timeout` in order to load the queued events + +??? setting "Queue apply timeout" + + This setpoint defines the time delay of the automatic event queue loading. Your vehicle has to be slower than `Queue apply speed treshold` for this time in order to load the queued events + +??? setting "Skip queue if spectating others" + + If enabled, an event will instantly load if you are spectating another player + + If disabled, an event will be queued just like it would when focused on your own vehicle + +??? setting "Don't queue Unicycles (Snowmen/Beamlings)" + + If enabled, an event concerning a snowmen/beamling will be loaded instantly + + If disabled, snowmen/beamlings will be queued just like other vehicles + +## **3. Set default Unicycle** + +??? setting "Default Unicycle config" + + This setpoint defines the unicycle variant to be loaded by default. You can choose between premade configs and your own should you have saved custom unicycle configs + +??? setting "Automatically save your last used Unicycle" + + If enabled, your last used unicycle will be automatically saved and reloaded once you spawn it again + + If disabled, your default unicycle config will spawn every time + +## **4. Blobs** + +??? setting "Enable blobs for unspawned vehicles" + + If enabled, you will see a placeholder orb, or blob, in place of an unspawned vehicle + + If disabled, an unspawned vehicle will be invisible + +??? setting "Tune colors" + + ??? setting "Visible" + + If enabled, a blob will be drawn, using the color below + + If disabled, no blob will be drawn for the specified function + + ??? setting "RGB HEX values" + + Queued vehicle: The color a blob will use if a vehicle is queued for spawning. Standard value #FF6400 + + Illegal vehicle: The color a blob will use if a vehicle is illegal, for example trough a mod that was sideloaded. Standard value #000000 + + Deleted vehicle: The color a blob will use if a vehicle was deleted by the user. Standard value #333333 + +## **5. Nametags** + +??? setting "Hide player nametags" + + If enabled, player nametags will not be drawn + + If disabled, player nametags will be drawn according to their vehicles relative position + +??? setting "Show distance from other players" + + If enabled, the nametag will be prepended by the distance to the respective vehicle + + If disabled, no additional distance will be shown in the nametag + +??? setting "Fade nametags in/out" + + If enabled, a nametag will be faded in/out according to `Fade distance` and `Invert nametag fade direction` + + If disabled, anametag will be drawn at standard opacity regardless of distance to the respective vehicle + +??? setting "Fade distance/Invert nametag fade direction" + + ??? setting "Fade out" + + `Fade distance` defines the distance at which a nametag will be drawn at minimal opacity. The opacity level is gradually increased over that distance, getting more visible the closer a vehicle gets + + ??? setting "Fade in" + + `Fade distance` defines the distance at which a nametag will be drawn at maximal opacity. The opacity level is gradually decreased over that distance, getting less visible the closer a vehicle gets + +??? setting "Don't fully hide nametags" + + If enabled, a nametag can not get fully invisible, it will retain a minimal opacity regardless of distance + + If disabled, nametags can get fully invisble + +??? setting "Shorten nametag and role tags" + + If enabled, `Nametag length limit` will truncate nametags and roles to the set limit of characters + + If disabled, nametag and role tags will be shown at full length + +??? setting "Show spectators' nametag under vehicle nametags" diff --git a/docs/en/game/tailoring.md b/docs/en/game/tailoring.md deleted file mode 100644 index 2cd7a229..00000000 --- a/docs/en/game/tailoring.md +++ /dev/null @@ -1,9 +0,0 @@ -!!! warning "This site is under construction!" - - 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. - -# Customizing your BeamMP Installation \ No newline at end of file diff --git a/docs/stylesheets/custom.css b/docs/stylesheets/custom.css index 328b479e..153f29b9 100644 --- a/docs/stylesheets/custom.css +++ b/docs/stylesheets/custom.css @@ -10,4 +10,22 @@ a.md-header__button.md-logo > img { height: 50px; +} + +:root { + --md-admonition-icon--setting: url('data:image/svg+xml;charset=utf-8,') +} +.md-typeset .admonition.setting, +.md-typeset details.setting { + border-color: rgb(255, 102, 0); +} +.md-typeset .setting > .admonition-title, +.md-typeset .setting > summary { + background-color: rgba(255, 102, 0, 0.1); +} +.md-typeset .setting > .admonition-title::before, +.md-typeset .setting > summary::before { + background-color: rgb(255, 102, 0); + -webkit-mask-image: var(--md-admonition-icon--setting); + mask-image: var(--md-admonition-icon--setting); } \ No newline at end of file diff --git a/mkdocs.yml b/mkdocs.yml index 311c1f21..d90323d5 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -111,7 +111,7 @@ plugins: Playing BeamMP: Jugando a BeamMP Installing BeamMP: Instalación de BeamMP Error Codes: Códigos de error - Customizing your setup: Personaliza tu configuración + Multiplayer Settings: Ajustes multijugador Running a Server: Ejecutando un Servidor Server Installation: Instalación del Servidor Server Maintenance: Manutención del Servidor @@ -154,7 +154,7 @@ plugins: Playing BeamMP: BeamMP spielen Installing BeamMP: BeamMP Installation Error Codes: Fehlercodes - Customizing your setup: Konfiguration anpassen + Multiplayer Settings: Einstellungen anpassen Running a Server: Server ausführen Server Installation: Server Installation Server Maintenance: Server Wartung @@ -197,7 +197,7 @@ plugins: Playing BeamMP: Jouer à BeamMP Installing BeamMP: Installation de BeamMP Error Codes: Codes d'erreur - Customizing your setup: Personnalisation de votre configuration + Multiplayer Settings: Paramètres multijoueurs Running a Server: Exécution d'un serveur Server Installation: Installation du serveur Server Maintenance: Maintenance du serveur @@ -240,7 +240,7 @@ plugins: Playing BeamMP: Giocare a BeamMP Installing BeamMP: Installazione di BeamMP Error Codes: Codici di errore - Customizing your setup: Personalizza la tua configurazione + Multiplayer Settings: Impostazioni multigiocatore Running a Server: Eseguire un server Server Installation: Installazione del server Server Maintenance: Manutenzione del server @@ -283,7 +283,7 @@ plugins: Playing BeamMP: Игра в BeamMP Installing BeamMP: Установка BeamMP Error Codes: коды ошибок - Customizing your setup: Настройка конфигурации + Multiplayer Settings: Настройки мультиплеера Running a Server: Запуск сервера Server Installation: Установка сервера Server Maintenance: Обслуживание сервера @@ -350,7 +350,7 @@ nav: - Playing BeamMP: - Installing BeamMP: game/getting-started.md - Error Codes: game/error-codes.md - - Customizing Your Setup: game/tailoring.md + - Multiplayer Settings: game/multiplayer-settings.md - Running a Server: - Server Installation: server/create-a-server.md - Port Forwarding: server/port-forwarding.md From 05a44980fe369a0aa312438350665ee655558139 Mon Sep 17 00:00:00 2001 From: O1LER <44237025+O1LER@users.noreply.github.com> Date: Sat, 1 Mar 2025 21:16:05 +0100 Subject: [PATCH 2/6] Finished settings explanations and toned down the orange a bit --- docs/en/game/multiplayer-settings.md | 38 ++++++++++++++++++++++++++++ docs/stylesheets/custom.css | 4 +-- 2 files changed, 40 insertions(+), 2 deletions(-) diff --git a/docs/en/game/multiplayer-settings.md b/docs/en/game/multiplayer-settings.md index 00e21d64..a9f39b1b 100644 --- a/docs/en/game/multiplayer-settings.md +++ b/docs/en/game/multiplayer-settings.md @@ -211,3 +211,41 @@ If disabled, nametag and role tags will be shown at full length ??? setting "Show spectators' nametag under vehicle nametags" + + If enabled, a spectators name will be added underneath a players nametag + + If disabled, no spectator names will be added to nametags + +??? setting "Same color for spectator nametags" + + If enabled, a spectators name will always be surrounded by a grey background + + If disabled, a spectators name will be surrounded by a colored background, reflecting the spectators role + +## **6. Others** + +??? setting "Show network activity in the console" + + If enabled, the beamMP network activity will be shown in the console + + If disabled, no further network activity will be shown in the console + + !!! danger "" + + Be careful with this setting, since all the console output gets also written into the log files + + They can grow by hundrets of MB in minutes with this setting enabled + +??? setting "Launcher port" + + This setpoint defines the port used for communicating with the launcher + + Should only be changed if the standard port 4444 can not be used + + Dont forget to also change it on the launcher side, by modifying `launcher.cfg` + + !!! tip "" + + The port specified is only the first of two, the second port being used is directly following, set port + 1 + + The first port carries core network pakets, the second game network pakets, both over TCP \ No newline at end of file diff --git a/docs/stylesheets/custom.css b/docs/stylesheets/custom.css index 153f29b9..904cae1a 100644 --- a/docs/stylesheets/custom.css +++ b/docs/stylesheets/custom.css @@ -17,7 +17,7 @@ a.md-header__button.md-logo > img { } .md-typeset .admonition.setting, .md-typeset details.setting { - border-color: rgb(255, 102, 0); + border-color: rgba(255, 102, 0, 0.2); } .md-typeset .setting > .admonition-title, .md-typeset .setting > summary { @@ -25,7 +25,7 @@ a.md-header__button.md-logo > img { } .md-typeset .setting > .admonition-title::before, .md-typeset .setting > summary::before { - background-color: rgb(255, 102, 0); + background-color: rgba(255, 102, 0, 0.7); -webkit-mask-image: var(--md-admonition-icon--setting); mask-image: var(--md-admonition-icon--setting); } \ No newline at end of file From 8d7e9ea814fbfe6d266a8d0ed339816fa995a672 Mon Sep 17 00:00:00 2001 From: O1LER <44237025+O1LER@users.noreply.github.com> Date: Sat, 1 Mar 2025 21:28:24 +0100 Subject: [PATCH 3/6] Adjusted fade nametag block --- docs/en/game/multiplayer-settings.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/en/game/multiplayer-settings.md b/docs/en/game/multiplayer-settings.md index a9f39b1b..19286e39 100644 --- a/docs/en/game/multiplayer-settings.md +++ b/docs/en/game/multiplayer-settings.md @@ -190,13 +190,13 @@ ??? setting "Fade distance/Invert nametag fade direction" - ??? setting "Fade out" + !!! setting "Fade out" - `Fade distance` defines the distance at which a nametag will be drawn at minimal opacity. The opacity level is gradually increased over that distance, getting more visible the closer a vehicle gets + `Fade distance` defines the distance at which a nametag will be drawn at minimal opacity. The opacity level is gradually increased, getting more visible, as it gets closer - ??? setting "Fade in" + !!! setting "Fade in" - `Fade distance` defines the distance at which a nametag will be drawn at maximal opacity. The opacity level is gradually decreased over that distance, getting less visible the closer a vehicle gets + `Fade distance` defines the distance at which a nametag will be drawn at maximal opacity. The opacity level is gradually decreased, getting less visible, as it gets closer ??? setting "Don't fully hide nametags" From d109e1ebc5cb17f18ab0324c7e69112471d920d5 Mon Sep 17 00:00:00 2001 From: O1LER <44237025+O1LER@users.noreply.github.com> Date: Sat, 1 Mar 2025 21:48:15 +0100 Subject: [PATCH 4/6] My brain is fading out --- docs/en/game/multiplayer-settings.md | 8 ++++++-- 1 file changed, 6 insertions(+), 2 deletions(-) diff --git a/docs/en/game/multiplayer-settings.md b/docs/en/game/multiplayer-settings.md index 19286e39..afa58ae1 100644 --- a/docs/en/game/multiplayer-settings.md +++ b/docs/en/game/multiplayer-settings.md @@ -192,11 +192,15 @@ !!! setting "Fade out" - `Fade distance` defines the distance at which a nametag will be drawn at minimal opacity. The opacity level is gradually increased, getting more visible, as it gets closer + Nametags are getting less visible the further away a player is + + `Fade distance` defines the distance at which a nametag will be drawn at minimal opacity !!! setting "Fade in" - `Fade distance` defines the distance at which a nametag will be drawn at maximal opacity. The opacity level is gradually decreased, getting less visible, as it gets closer + Nametags are getting more visible the further away a player is + + `Fade distance` defines the distance at which a nametag will be drawn at maximal opacity ??? setting "Don't fully hide nametags" From bca4fc829f019d49a493091c0c15f11c333b7a29 Mon Sep 17 00:00:00 2001 From: O1LER <44237025+O1LER@users.noreply.github.com> Date: Sun, 2 Mar 2025 21:11:07 +0100 Subject: [PATCH 5/6] Update docs/en/game/multiplayer-settings.md Co-authored-by: Tixx <83774803+WiserTixx@users.noreply.github.com> --- docs/en/game/multiplayer-settings.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/en/game/multiplayer-settings.md b/docs/en/game/multiplayer-settings.md index afa58ae1..63cf7b89 100644 --- a/docs/en/game/multiplayer-settings.md +++ b/docs/en/game/multiplayer-settings.md @@ -238,7 +238,7 @@ Be careful with this setting, since all the console output gets also written into the log files - They can grow by hundrets of MB in minutes with this setting enabled + They can grow by hundreds of MB in minutes with this setting enabled ??? setting "Launcher port" From 03cd2aee5f56c0b17c04f5b4d8a6e9ea0fc04218 Mon Sep 17 00:00:00 2001 From: O1LER <44237025+O1LER@users.noreply.github.com> Date: Sun, 2 Mar 2025 21:39:51 +0100 Subject: [PATCH 6/6] Auto queue changed --- docs/en/game/multiplayer-settings.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/en/game/multiplayer-settings.md b/docs/en/game/multiplayer-settings.md index 63cf7b89..759ba06f 100644 --- a/docs/en/game/multiplayer-settings.md +++ b/docs/en/game/multiplayer-settings.md @@ -50,7 +50,7 @@ If enabled, the mod security popup will not be shown when trying to connect to a server with mods - If disabled, the mod security popup will be shown when trying to connect to a server with mods the first time + If disabled, the mod security popup will be shown whenever you connect to a server with mods ??? setting "Enable player vehicle update/edit queuing" @@ -108,7 +108,7 @@ ??? setting "Automatically apply queued vehicle changes" - If enabled, the queued events will be automatically loaded once `Queue apply speed treshold` was not surpassed for `Queue apply timeout` + If enabled, the queued events will be automatically loaded once you've been going under the speed treshold for the amount of time set as the timeout If disabled, the queued events will only load manually, by clicking on either the `Events` button at the top of the screen or on a players name in the playerlist