Social and Utility Config: Chat, Browser, Streaming

This page documents all bc_* configuration variables related to BestClient’s social systems and utility tooling — inline media previews in chat, the Client Indicator presence system, server browser enhancements, streamer mode privacy options, the admin panel, and several smaller convenience features. All variables are saved to settings_ddnet.cfg unless noted otherwise.

Chat Media

BestClient can fetch and render image and GIF previews directly inside the chat panel when a recognized URL is posted.

bc_chat_media_preview

int

default:"1"

Master toggle for rendering media previews from URLs posted in chat. 0 = off, 1 = on.

bc_chat_media_photos

int

default:"1"

Render static image (photo) previews from chat links. 0 = off, 1 = on.

bc_chat_media_gifs

int

default:"1"

Render animated GIF previews from chat links. 0 = off, 1 = on.

bc_chat_media_content_filter

int

default:"1"

Only allow media previews from domains listed in bc_chat_media_allowed_domains. 0 = allow all domains, 1 = allowlist only.

bc_chat_media_allowed_domains

string

default:"tenor.com; imgur.com; giphy.com"

Semicolon-separated list of domains from which media previews are permitted when the content filter is enabled. Example: tenor.com; imgur.com; giphy.com.

bc_chat_media_preview_max_width

int

default:"220"

Maximum width of a rendered chat media preview in pixels. Range: 120–400.

bc_chat_media_viewer

int

default:"1"

Enable a fullscreen media viewer that opens when you click a chat preview. 0 = off, 1 = on.

bc_chat_media_viewer_max_zoom

int

default:"800"

Maximum zoom level available in the fullscreen media viewer, in percent. Range: 100–2000.

Chat Behavior

bc_chat_save_draft

int

default:"0"

Preserve unsent chat input when you close the chat box, so it is still there when you reopen it. 0 = off, 1 = on.

bc_silent_typing

int

default:"0"

Hide the PLAYERFLAG_CHATTING flag from other players while you are typing, so the chat bubble does not appear above your tee. 0 = off, 1 = on.

bc_chat_alt_command_layout

int

default:"0"

Recognize slash commands typed using a Russian (QWERTY-equivalent) keyboard layout. Useful for players whose OS default layout is Russian. 0 = off, 1 = on.

Client Indicator

The Client Indicator system broadcasts your presence to a lightweight UDP server and annotates name plates and the scoreboard to show which players are running BestClient.

bc_client_indicator

int

default:"1"

Client Indicator is always enabled; this variable documents that state. Fixed at 1.

bc_client_indicator_versions

int

default:"0"

Show a Versions tab in the BestClient server browser panel listing which version each player is running. 0 = off, 1 = on.

bc_client_indicator_in_name_plate

int

default:"1"

Show the BestClient indicator icon in player name plates. 0 = off, 1 = on.

bc_client_indicator_in_name_plate_above_self

int

default:"0"

Show the client indicator above your own tee’s name plate as well. 0 = off, 1 = on.

bc_client_indicator_in_name_plate_size

int

default:"30"

Relative size of the indicator icon in name plates. Range: -50–100.

bc_client_indicator_in_name_plate_dynamic

int

default:"1"

Allow the indicator icon to reposition dynamically in name plates based on other nameplate content. 0 = fixed, 1 = dynamic.

indicator_version

int

default:"0"

Show the BestClient version string in player name plates. 0 = off, 1 = on.

bc_client_indicator_in_scoreboard

int

default:"1"

Show the BestClient indicator icon in the scoreboard next to each player’s name. 0 = off, 1 = on.

bc_client_indicator_in_scoreboard_size

int

default:"100"

Relative size of the indicator icon in the scoreboard. Range: -50–100.

bc_nameplate_client_indicator_offset_x

int

default:"0"

Horizontal pixel offset for the client indicator icon within nameplates. Range: -400–400.

bc_nameplate_client_indicator_offset_y

int

default:"0"

Vertical pixel offset for the client indicator icon within nameplates. Range: -400–400.

bc_client_indicator_server_address

string

default:"150.241.70.188:8778"

UDP address of the Client Indicator presence server. Change only if you are running a self-hosted instance.

bc_client_indicator_browser_url

string

default:"https://150.241.70.188:8779/users.json"

HTTPS URL that the server browser queries to fetch the list of online BestClient users.

bc_client_indicator_token_url

string

default:"https://150.241.70.188:8779/token.json"

HTTPS URL used to bootstrap the shared authentication token on first run.

bc_client_indicator_shared_token

string

default:""

Shared token appended to signed UDP presence packets. Auto-populated from bc_client_indicator_token_url on first launch.

bc_client_indicator_secret_key

string

default:""

Developer secret key for advanced Client Indicator API access. Leave empty unless instructed otherwise.

Server Browser

bc_auto_server_list_refresh

int

default:"0"

Automatically refresh the server browser list while a browser tab is open. 0 = off, 1 = on.

bc_auto_server_list_refresh_seconds

int

default:"10"

Interval between automatic server list refreshes, in seconds. Range: 1–300.

bc_mastersrv

int

default:"0"

Use the BestClient master server mirror as the data source for the server browser instead of the default DDNet master server. 0 = off, 1 = on.

bc_use_short_kog_server_name

int

default:"0"

Display an abbreviated name for KoG Gores servers in the browser list. 0 = full name, 1 = short name.

br_filter_bestclient

int

default:"0"

Filter out servers with no BestClient users from the server browser. 0 = off, 1 = on.

Streamer Mode

Streamer mode hides sensitive information from your screen using a bitmask stored in bc_streamer_flags. Each bit independently controls one category of hidden information.

bc_streamer_flags

int

default:"64"

Bitmask of active streamer mode options. Combine values by adding them together. Default 64 hides the login panel only. Range: 0–127.

Value	Flag	Effect
`1`	`STREAMER_HIDE_SERVER_IP`	Hide the server IP address
`2`	`STREAMER_HIDE_CHAT`	Hide all chat messages
`4`	`STREAMER_HIDE_FRIEND_WHISPER`	Hide friend whisper messages
`8`	`STREAMER_HIDE_OWN_NAME`	Hide your own player name
`16`	`STREAMER_HIDE_OTHER_NAMES`	Hide all other players’ names
`32`	`STREAMER_HIDE_TAB_NAMES`	Hide names in the scoreboard tab
`64`	`STREAMER_HIDE_LOGIN`	Hide the login/password panel

Admin Panel

Admin panel variables (15 variables)

bc_adminpanel_autoscroll

int

default:"1"

Automatically scroll to the bottom of log output in the admin panel. 0 = off, 1 = on.

bc_adminpanel_remember_tab

int

default:"1"

Remember and restore the last active admin panel tab between sessions. 0 = off, 1 = on.

bc_adminpanel_last_tab

int

default:"0"

Index of the last active admin panel tab, saved automatically when bc_adminpanel_remember_tab is on. Range: 0–10.

bc_adminpanel_disable_anim

int

default:"0"

Disable animations inside the admin panel for a snappier feel. 0 = animations on, 1 = animations off.

bc_adminpanel_scale

int

default:"100"

Scale of the admin panel UI as a percentage of its default size. Range: 80–120.

bc_adminpanel_log_lines

int

default:"200"

Maximum number of log lines to retain in the admin panel log view. Older lines are discarded when the limit is reached. Range: 50–500.

bc_adminpanel_rcon_log

int

default:"0"

Log F2 console (rcon) output to rcon-log.txt in the DDNet appdata directory. 0 = off, 1 = on.

bc_adminpanel_bg_color

color

default:"0x8C000000"

Background color of the admin panel window as an ARGB value. Default is a semi-transparent black.

bc_adminpanel_tab_inactive_color

color

default:"0xCC00002E"

ARGB color of inactive tabs in the admin panel.

bc_adminpanel_tab_active_color

color

default:"0xE6000052"

ARGB color of the currently active tab in the admin panel.

bc_adminpanel_tab_hover_color

color

default:"0xE600003D"

ARGB color of a tab when the cursor hovers over it in the admin panel.

Fast Action Slots

The admin panel provides ten fast-action command slots that can each store a single console command for one-click execution.

Fast action command slots (bc_admin_fast_action0 – bc_admin_fast_action9)

bc_admin_fast_action0

string

default:""

Admin panel fast action command slot 1. Max 96 characters.

bc_admin_fast_action1

string

default:""

Admin panel fast action command slot 2. Max 96 characters.

bc_admin_fast_action2

string

default:""

Admin panel fast action command slot 3. Max 96 characters.

bc_admin_fast_action3

string

default:""

Admin panel fast action command slot 4. Max 96 characters.

bc_admin_fast_action4

string

default:""

Admin panel fast action command slot 5. Max 96 characters.

bc_admin_fast_action5

string

default:""

Admin panel fast action command slot 6. Max 96 characters.

bc_admin_fast_action6

string

default:""

Admin panel fast action command slot 7. Max 96 characters.

bc_admin_fast_action7

string

default:""

Admin panel fast action command slot 8. Max 96 characters.

bc_admin_fast_action8

string

default:""

Admin panel fast action command slot 9. Max 96 characters.

bc_admin_fast_action9

string

default:""

Admin panel fast action command slot 10. Max 96 characters.

Auto Update

bc_auto_update

int

default:"0"

Automatically download and apply BestClient updates on startup when a new version is available. 0 = off, 1 = on.

Enable BestClient’s custom UI sound effects for menu interactions. 0 = off, 1 = on.

Volume of BestClient menu sound effects as a percentage. Range: 0–100.

Components Mask

Advanced: these two integers form a 62-bit bitmask that disables specific BestClient components. Each bit corresponds to one entry in the EBestClientComponent enum. Use the BestClient settings UI rather than editing these directly.

bc_disabled_components_mask_lo

int

default:"0"

Low 31 bits of the disabled-components bitmask (components 0–30). Range: 0–2147483647.

bc_disabled_components_mask_hi

int

default:"0"

High 31 bits of the disabled-components bitmask (components 31–61). Range: 0–2147483647.

Settings UI

bc_settings_layout

int

default:"1"

Settings page layout style. 0 = new layout, 1 = classic/old layout.

bc_new_color_picker

int

default:"0"

Replace the default color picker with a wheel-style HSV picker. 0 = standard, 1 = wheel-style.

bc_bestclient_settings_tabs

int

default:"0"

Bit flags controlling which BestClient settings tabs are hidden from the UI. 0 = all tabs visible. Range: 0–65536.

Casino

The built-in casino mini-game tracks your balance and claim cooldown locally.

bc_casino_balance

int

default:"500"

Casino game balance in dollars. Range: 0–9999999.

bc_casino_last_claim

int

default:"0"

Unix timestamp of the last casino free-claim action. Range: 0–2147483647.

Debug

These variables enable verbose logging for specific BestClient subsystems. They are intended for developers and bug reports.

dbg_client_indicator

int

default:"0"

Debug logging level for the Client Indicator subsystem. 0 = off, 1 = verbose, 2 = dump all UDP packet bytes sent and received. Range: 0–2.

dbg_music_player

int

default:"0"

Debug logging level for the music player. 0 = off, 1 = state changes, 2 = verbose periodic diagnostics. Range: 0–2.

Configuration Reference

Social and Utility Config: Chat, Browser, Streaming

Chat Media

Chat Behavior

Client Indicator

Server Browser

Streamer Mode

Admin Panel

Fast Action Slots

Auto Update

Menu Sound Effects

Components Mask

Settings UI

Casino

Debug

Build docs developers (and LLMs) love

Configuration Reference

Documentation Index

​Chat Media

​Chat Behavior

​Client Indicator

​Server Browser

​Streamer Mode

​Admin Panel

​Fast Action Slots

​Auto Update

​Menu Sound Effects

​Components Mask

​Settings UI

​Casino

​Debug

Build docs developers (and LLMs) love

Chat Media

Chat Behavior

Client Indicator

Server Browser

Streamer Mode

Admin Panel

Fast Action Slots

Auto Update

Menu Sound Effects

Components Mask

Settings UI

Casino

Debug