BestClient ships with a rich set of visual enhancements — from subtle UI animations and eye-comfort overlays to full particle systems and tee deformation effects. Every option listed here can be changed live from the in-game console or configured through the BestClient settings UI. All variables are persisted toDocumentation Index
Fetch the complete documentation index at: https://mintlify.com/BestProjectTeam/BestClient/llms.txt
Use this file to discover all available pages before exploring further.
settings_ddnet.cfg in your $USERDIR.
Aspect Ratio
Control the custom aspect ratio feature that lets you render at a non-native ratio such as 4:3 or 5:4.Aspect ratio mode.
-1 = legacy auto, 0 = off, 1 = preset, 2 = custom.Where the custom aspect ratio is applied.
0 = game viewport only, 1 = full screen, 2 = game viewport without HUD. Range: 0–2.Aspect ratio value multiplied by 100.
0 = off. Common presets: 125 = 5:4, 133 = 4:3, 150 = 3:2. Accepts any value from 0 to 1000.Custom aspect ratio numerator (width component).
0 = unset. Range: 0–100000.Custom aspect ratio denominator (height component).
0 = unset. Range: 0–100000.Cinematic Camera
Enable smooth cinematic camera movement when using spectator free-view.
0 = off, 1 = on.Particle Systems
3D Particles
3D Particle variables (19 variables)
3D Particle variables (19 variables)
Toggle the 3D particle system.
0 = off, 1 = on.Particle shape.
1 = Cube, 2 = Heart, 3 = Mixed. Range: 1–3.Total number of 3D particles rendered at once. Range:
1–200.Minimum particle size. Range:
2–200.Maximum particle size. Range:
2–200.Base movement speed of 3D particles. Range:
1–500.Depth range over which particles are distributed. Range:
10–1000.Opacity of 3D particles in percent. Range:
1–100.Time in milliseconds for particles to fade in when they spawn. Range:
1–5000.Time in milliseconds for particles to fade out before despawning. Range:
1–5000.Radius around the local player that pushes nearby particles away. Range:
0–1000.Strength of the player push force applied to nearby particles. Range:
0–2000.Whether 3D particles collide with each other.
0 = off, 1 = on.Extra margin in units outside the visible area before a particle is culled. Range:
0–1000.Color mode for 3D particles.
1 = custom static color, 2 = random per-particle color. Range: 1–2.ARGB color used when
bc_3d_particles_color_mode is 1 (custom). Supports alpha channel.Enable a glow halo around each 3D particle.
0 = off, 1 = on.Opacity of the particle glow in percent. Range:
1–100.Size offset of the glow halo relative to the particle. Range:
1–20.Crystal Laser
Render rifle and shotgun lasers with crystal shards and an icy glow effect.
0 = off, 1 = on.Tee Effects
Jelly Tee
Enable jelly-like deformation on your own tee when it accelerates or changes direction.
0 = off, 1 = on.Apply jelly tee deformation to other players as well.
0 = off, 1 = on.Intensity of the jelly deformation effect. Range:
0–1000.How many frames the deformation persists after an impulse. Range:
1–500.Motion Blur
Enable motion blur by blending the current frame with the previous one.
0 = off, 1 = on.Blend strength as a percentage of the previous frame retained. Range:
0–95.Player Trail
Enable a visual trail that follows your tee as it moves.
0 = off, 1 = on.Show the trail effect on other players too.
0 = off, 1 = on.Trail particle style.
0 = grenade, 1 = invisible, 2 = ninja.Flying Name Plates
Render name plates as kites tethered to players, drifting with movement.
0 = off, 1 = on.Additional upward offset applied to flying name plates. Range:
0–120.How far name plates trail behind the player’s movement direction. Range:
0–200.How quickly flying name plates catch up to their target position. Range:
1–100.Media Background
Enable a custom image or video background in the offline main menu.
0 = off, 1 = on.Enable a custom media background rendered behind the game world.
0 = off, 1 = on.Absolute or relative file path to the custom media background file used in menus.
Controls how much the in-game background is anchored to the map versus the screen.
0 = fully screen-fixed, 100 = fully map-fixed. Range: 0–100.Music Player
The built-in music player renders a configurable HUD overlay with optional cover art, a spectrum visualizer, and album-based color theming.Music Player variables (20 variables)
Music Player variables (20 variables)
Enable the Music Player HUD element.
0 = off, 1 = on.Keep the Music Player visible while playback is paused.
0 = hide when paused, 1 = always show.Enable the spectrum visualizer in the music player.
0 = off, 1 = on.Visualizer bar anchor.
0 = bottom, 1 = center, 2 = up. Range: 0–2.Visualizer sensitivity in percent — higher values respond to quieter audio. Range:
50–300.Visualizer bar smoothing amount. Range:
0–100.Visualizer bar corner rounding in percent. Range:
0–400.Number of visualizer bars. Range:
5–10.Width of each visualizer bar in percent. Range:
50–250.Gap between visualizer bars in percent. Range:
0–250.Color mode for the music player.
0 = static color, 1 = cover accent color, 2 = dominant cover color, 3 = translucent. Range: 0–3.Static color used when
bc_music_player_color_mode is 0.Player size.
0 = normal, 1 = mini. Range: 0–1.Text scale in percent. Range:
70–150.Music player animation duration in milliseconds. Range:
50–1000.Show cover art in the music player.
0 = off, 1 = on.Use the Music Player’s current color for HUD rectangle rendering.
0 = off, 1 = on.Alpha multiplier for the Music Player and HUD colors in percent. Range:
0–100.Optimizer
The Optimizer reduces GPU/CPU load with configurable culling and process priority adjustments.Optimizer variables (10 variables)
Optimizer variables (10 variables)
Enable optimizer features.
0 = off, 1 = on.Disable rendering and updating all particles.
0 = off, 1 = on.Cull non-map rendering outside a distance limit around the camera.
0 = off, 1 = on.Set the DDNet process priority to High while the optimizer is enabled.
0 = off, 1 = on.Set the Discord process priority to Below Normal while the optimizer is enabled.
0 = off, 1 = on.FPS fog culling mode.
0 = manual radius in tiles, 1 = by zoom percent. Range: 0–1.Manual FPS fog radius in tiles (1 tile = 32 units). Used when
bc_optimizer_fps_fog_mode is 0. Range: 5–300.Visible area percentage in zoom mode. Used when
bc_optimizer_fps_fog_mode is 1. Range: 10–120.Render an outline rectangle showing the active FPS fog area.
0 = off, 1 = on.Also cull map tile rendering outside the FPS fog area.
0 = off, 1 = on.Focus Mode
Focus Mode hides selected UI elements to minimize distractions during gameplay.Enable focus mode.
0 = off, 1 = on.Hide all player names while focus mode is active.
0 = off, 1 = on.Hide visual effects while focus mode is active.
0 = off, 1 = on.Hide the HUD while focus mode is active.
0 = off, 1 = on.Hide the song/music player while focus mode is active.
0 = off, 1 = on.Hide unnecessary UI elements while focus mode is active.
0 = off, 1 = on.Hide the chat panel while focus mode is active.
0 = off, 1 = on.Hide the scoreboard while focus mode is active.
0 = off, 1 = on.Effects
Toggle individual visual and audio effects triggered by game events.Enable the snowflakes freeze effect.
0 = off, 1 = on.Enable the hammer hit visual effect.
0 = off, 1 = on.Enable the hammer hit sound effect.
0 = off, 1 = on.Enable the jump visual effect.
0 = off, 1 = on.Enable the jump sound effect.
0 = off, 1 = on.Mute hook sounds produced by other players.
0 = off, 1 = on.Mute hammer sounds produced by other players.
0 = off, 1 = on.Gores Mode
Enable entity-like Gores mode rendering.
0 = off, 1 = on.Automatically disable Gores mode when you are holding the shotgun, grenade launcher, or laser rifle.
0 = off, 1 = on.UI Visuals
Eye Comfort
Render a warm yellow overlay across the entire screen to reduce eye strain.
0 = off, 1 = on.Intensity of the eye-comfort overlay. Higher values are warmer and dimmer. Range:
0–100.Scoreboard & Tab
Render scoreboard team-color rows with a left-to-right gradient fade.
0 = off, 1 = on.Show each player’s DDNet points in the scoreboard, between their name and clan.
0 = off, 1 = on.Display a player list on the Game tab of the ESC pause menu.
0 = off, 1 = on.Emoticons
Draw a drop shadow behind emoticons shown above tees.
0 = off, 1 = on.Nameplates
Apply a gradient to nameplate text using the tee’s body and feet colors.
0 = off, 1 = on.Horizontal pixel offset for the voice-activity icon in nameplates. Range:
-400–400.Vertical pixel offset for the voice-activity icon in nameplates. Range:
-400–400.Animations
Animation variables (16 variables)
Animation variables (16 variables)
Master toggle for all BestClient UI animations.
0 = off, 1 = on.Animate module settings panels sliding into view.
0 = off, 1 = on.Duration of the module reveal animation in milliseconds. Range:
1–500.Animate the in-game ESC menu when it opens or closes.
0 = off, 1 = on.Duration of the ESC menu animation in milliseconds. Range:
1–500.Animate chat messages as they appear.
0 = off, 1 = on.Duration of the chat message animation in milliseconds. Range:
1–500.Animation style for chat messages. Valid values:
1–4.Animate the chat panel sliding open.
0 = off, 1 = on.Duration of the chat open animation in milliseconds. Range:
1–500.Show a typing animation indicator in chat.
0 = off, 1 = on.Duration of the chat typing animation in milliseconds. Range:
1–500.Animate killfeed entries as they enter and leave the screen.
0 = off, 1 = on.Duration of the killfeed animation in milliseconds. Range:
1–500.Animate main menu button hover states.
0 = off, 1 = on.Speed of the main menu hover animation. Range:
1–50.