Skip to main content

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

BestClient’s HUD system lets you reposition and rescale every custom overlay module independently. Positions are expressed as pixel offsets from each module’s default anchor point, and scale is a percentage of the default size. The easiest way to adjust these values is through the interactive HUD Editor, which allows drag-and-drop repositioning with a live preview. If you prefer to edit values directly, the variables below can be set in the in-game console or written into settings_ddnet.cfg.
HUD position variables that do not have CFGFLAG_SAVE are reset to their defaults on each client launch. The HUD Editor saves the state for you automatically — if you edit them manually, add them to settings_ddnet.cfg to persist across sessions.

​
Music Player HUD

​
bc_hud_music_player_x
int
default:"198"
Horizontal position of the Music Player HUD module, in pixels from the default anchor. Range: -1000–1000.
​
bc_hud_music_player_y
int
default:"0"
Vertical position of the Music Player HUD module, in pixels from the default anchor. Range: -1000–1000.
​
bc_hud_music_player_scale
int
default:"100"
Scale of the Music Player HUD module as a percentage of its default size. Range: 25–300.

​
Voice HUD

​
bc_hud_voice_hud_x
int
default:"4"
Horizontal position of the Voice HUD module (active speakers list). Range: -1000–1000.
​
bc_hud_voice_hud_y
int
default:"122"
Vertical position of the Voice HUD module. Range: -1000–1000.
​
bc_hud_voice_hud_scale
int
default:"100"
Scale of the Voice HUD module as a percentage of its default size. Range: 25–300.

​
Mute Icons

​
bc_hud_voice_mute_icons_x
int
default:"136"
Horizontal position of the microphone and headphones mute status icons. Range: -1000–1000.
​
bc_hud_voice_mute_icons_y
int
default:"0"
Vertical position of the mute status icons. Range: -1000–1000.
​
bc_hud_voice_mute_icons_scale
int
default:"100"
Scale of the mute status icons as a percentage of their default size. Range: 25–300.

​
Chat HUD

​
bc_hud_chat_x
int
default:"5"
Horizontal position of the in-game chat panel. Range: -1000–1000.
​
bc_hud_chat_y
int
default:"278"
Vertical anchor position of the in-game chat panel. Range: -1000–1000.
​
bc_hud_chat_scale
int
default:"100"
Scale of the in-game chat panel as a percentage of its default size. Range: 25–300.

​
Votes HUD

​
bc_hud_votes_x
int
default:"0"
Horizontal position of the vote notification panel. Range: -1000–1000.
​
bc_hud_votes_y
int
default:"60"
Vertical position of the vote notification panel. Range: -1000–1000.
​
bc_hud_votes_scale
int
default:"100"
Scale of the vote notification panel as a percentage of its default size. Range: 25–300.

​
HUD Visibility

​
bc_hide_hud_in_settings
int
default:"0"
Hide all HUD elements while the settings page is open, giving a clean preview of the map and game. 0 = off, 1 = on.

​
Real Hitbox Indicator

​
bc_show_real_hitbox
int
default:"0"
Render a small dot at the exact center of your character’s server-side hitbox. Useful for precise positioning practice. 0 = off, 1 = on.
​
bc_show_real_hitbox_color
color
default:"0xFFFFFFFF"
ARGB color of the real hitbox center dot. Supports alpha. Default is opaque white.

​
Dummy Coordinate Indicator

The dummy coordinate indicator draws a marker on your HUD showing the relative vertical position of a second player (typically your dummy).
​
bc_showhud_dummy_coord_indicator
int
default:"0"
Show a player-position indicator in the in-game HUD. 0 = off, 1 = on.
​
bc_showhud_dummy_coord_indicator_color
color
default:"65407"
ARGB color of the indicator when the tracked player is not at the same height as you.
​
bc_showhud_dummy_coord_indicator_same_height_color
color
default:"5635967"
ARGB color of the indicator when the tracked player is aligned at the same vertical position as you.

​
Speedrun Timer

The speedrun timer displays a countdown on screen and can be configured to auto-disable when it reaches zero.
​
bc_speedrun_timer
int
default:"0"
Enable the speedrun timer HUD element. 0 = off, 1 = on.
​
bc_speedrun_timer_time
int
default:"0"
Speedrun timer time stored in MMSS format. Range: 0–9999.
​
bc_speedrun_timer_hours
int
default:"0"
Speedrun timer hours component. Range: 0–99.
​
bc_speedrun_timer_minutes
int
default:"0"
Speedrun timer minutes component. Range: 0–59.
​
bc_speedrun_timer_seconds
int
default:"0"
Speedrun timer seconds component. Range: 0–59.
​
bc_speedrun_timer_milliseconds
int
default:"0"
Speedrun timer milliseconds component. Range: 0–999.
​
bc_speedrun_timer_auto_disable
int
default:"0"
Automatically disable the speedrun timer when it reaches zero. 0 = off, 1 = on.

​
Finish Prediction

Finish prediction estimates your remaining time or predicted finish time based on current race progress.
​
bc_finish_prediction
int
default:"0"
Enable the finish prediction HUD element. 0 = off, 1 = on.
​
bc_finish_prediction_mode
int
default:"0"
Display mode. 0 = classic text, 1 = progress bar.
​
bc_finish_prediction_show_always
int
default:"1"
Show finish prediction even before the race has started. 0 = off, 1 = on.
​
bc_finish_prediction_time_mode
int
default:"0"
Time display mode. 0 = remaining time, 1 = predicted finish time.
​
bc_finish_prediction_show_time
int
default:"1"
Show the finish prediction time value. 0 = off, 1 = on.
​
bc_finish_prediction_show_percentage
int
default:"1"
Show the finish prediction progress percentage. 0 = off, 1 = on.
​
bc_finish_prediction_show_millis
int
default:"1"
Show milliseconds in the finish prediction time. 0 = off, 1 = on.
​
bc_finish_prediction_bar_custom_color
int
default:"0"
Use a custom color for the finish prediction progress bar. 0 = off, 1 = on.
​
bc_finish_prediction_bar_color
color
default:"0xFFFFFFFF"
ARGB color of the finish prediction progress bar when custom color is enabled. Supports alpha.

​
Hook Combo

The hook combo system shows a popup counter and plays sounds when you chain successive hooks on the same player.
​
bc_hook_combo
int
default:"0"
Show hook combo popups and play combo sounds. 0 = off, 1 = on.
​
bc_hook_combo_mode
int
default:"0"
Combo trigger mode. 0 = hook only, 1 = hammer only, 2 = hook and hammer. Range: 0–2.
​
bc_hook_combo_reset_time
int
default:"1200"
Maximum time in milliseconds between player hooks before the combo counter resets. Range: 100–5000.
​
bc_hook_combo_sound_volume
int
default:"100"
Volume of hook combo sound effects in percent. Range: 0–100.
​
bc_hook_combo_size
int
default:"100"
Size of the hook combo popup overlay in percent. Range: 50–200.

​
Manual Config File Editing

If you prefer to edit HUD positions without opening the game, locate settings_ddnet.cfg in your $USERDIR and add or update lines like the following: 
bc_hud_music_player_x 50
bc_hud_music_player_y 10
bc_hud_music_player_scale 80
bc_hud_chat_x 10
bc_hud_chat_y 300
Save the file while the client is closed, then launch BestClient to see the updated positions.

Build docs developers (and LLMs) love

Get started for freeTalk to us