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.

Getting BestClient running takes just a few minutes regardless of your platform. The official download page at bestclient.fun provides pre-built binaries for Windows, Linux, and macOS — no compilation required. Follow the steps below for your platform, then read the storage path section so you know exactly where your settings, screenshots, and assets will live.
BestClient requires an active internet connection on first launch to fetch the DDNet server list and complete initial configuration. Subsequent launches work offline.

​
Installation Steps

1

Download BestClient

Visit bestclient.fun and download the build for your operating system. Current version: 1.9.1 beta.
  • Windows — .exe installer
  • Linux — .AppImage bundle
  • macOS — .dmg disk image
2

Install for your platform

Run the downloaded .exe installer and follow the on-screen prompts. BestClient will be added to your Start Menu and optionally your Desktop. Administrator rights may be required depending on your chosen install directory.
3

Launch BestClient

Start BestClient. On the very first launch the client creates its configuration directory and downloads the DDNet server list. The location of this directory — referred to as $USERDIR — depends on your platform:
PlatformPath
Linux$XDG_DATA_HOME/DDNet (typically ~/.local/share/DDNet)
macOS~/Library/Application Support/DDNet
Windows%APPDATA%\DDNet
All settings, screenshots, demos, and downloaded assets are stored inside $USERDIR.
4

Complete first-run setup

BestClient populates default configuration files and fetches the server list automatically. Once the main menu appears with servers visible in the browser, the setup is complete. You can now proceed to the Quickstart guide to configure your first features.

​
Storage Path System

BestClient inherits DDNet’s three-tier storage path model, defined in storage.cfg. Paths are searched from top to bottom; the first match wins. The top entry is also the save path — where all user data is written. 
add_path $USERDIR
add_path $DATADIR
add_path $CURRENTDIR
VariableDescription
$USERDIRUser data directory (platform-specific, see table above). This is the save path. Settings, screenshots, skins, and downloaded content are written here.
$DATADIRThe data/ directory bundled with the BestClient installation. Contains built-in skins, maps, sounds, and shaders. Read-only in normal use.
$CURRENTDIRThe working directory at launch. Useful for portable setups or development overrides.
To use a custom layout — for example a portable install or a mod overlay — you can ship your own storage.cfg alongside the executable and add extra add_path entries before $USERDIR.

​
Platform Notes

  • The installer registers BestClient in Add or Remove Programs, making clean uninstalls straightforward.
  • If you previously used DDNet or TClient, BestClient will find and reuse the existing %APPDATA%\DDNet directory — your skins, settings, and demos carry over automatically.
  • Windows Defender or other antivirus tools may flag a new unsigned binary. If this happens, allow the executable and consider adding %APPDATA%\DDNet to your AV exclusion list to prevent scan-induced stutters during gameplay.

Build docs developers (and LLMs) love

Get started for freeTalk to us