Skip to content

Configuration

G-Mr. Xiong edited this page Oct 3, 2026 · 1 revision

Configuration

The client reads config.json from the same folder as the binary (or config.en.json / config.zh.json for the packaged editions). Every key can also be changed at runtime with .config <key> <value>.

Default config

{
  "version": "2.1.0",
  "username": "",
  "server_address": "localhost:25565",
  "minecraft_version": "1.8.9",
  "language": "en",
  "fast_start": false,
  "log_enabled": false,
  "spam_enabled": false,
  "spam_rate": 1.0,
  "spam_messages": ["Hello!", "Anyone there?", "GG"],
  "command_autocomplete": true,
  "auto_eat": true,
  "auto_eat_health_threshold": 10,
  "auto_walk": false,
  "auto_walk_waypoints": [],
  "stop_walk_on_damage": true,
  "proximity_alerts": true,
  "proximity_distance": 5.0,
  "human_actions": true,
  "human_action_interval_min": 2.0,
  "human_action_interval_max": 7.0,
  "multi_bot_enabled": false,
  "bot_count": 10,
  "bot_name_prefix": "Bot",
  "bot_name_digits": 4,
  "bot_join_delay": 0.5,
  "bot_auth_enabled": false,
  "bot_auth_mode": "register",
  "bot_auth_password": "",
  "bot_auth_delay": 1.5,
  "bot_auth_register_command": "/register {password} {password}",
  "bot_auth_login_command": "/login {password}"
}

Connection

Key Type Description
username string Player name. Empty generates a random one.
server_address string Server address. SRV domains are supported (mc.example.com), or write host:port.
minecraft_version string Server version, anything between 1.8 and 26.2. The real protocol is probed before login.
language string UI language: zh or en.
fast_start boolean Skip the remote version check and announcement fetch on startup.

Behaviour

Key Type Description
command_autocomplete boolean Toggle the grey inline command preview.
auto_eat / auto_eat_health_threshold bool, int Auto-eat switch and the health value that triggers it.
auto_walk / auto_walk_waypoints bool, array Auto-walk switch and custom waypoints in relative coordinates.
stop_walk_on_damage boolean Stop walking automatically when damaged or killed.
proximity_alerts / proximity_distance bool, float Nearby-player alerts and the radius in blocks.
human_actions / human_action_interval_min / human_action_interval_max bool, float, float Human-like actions and the random interval bounds in seconds.

Logging and spam

Key Type Description
log_enabled boolean Enable session logging by default (.log on also works).
spam_enabled / spam_rate / spam_messages bool, float, array Auto-spam switch, rate in messages per second, and the message list.

Multi-bot

Key Type Description
multi_bot_enabled / bot_count bool, int Launch multiple bots at once — for example 20 or 100.
bot_name_prefix / bot_name_digits string, int Random username prefix and how many random digits it gets (Bot4821).
bot_join_delay float Seconds between bot connections.
bot_auth_enabled / bot_auth_mode bool, string Auto-login switch and mode: register, login or both.
bot_auth_password string Password inserted into the auth commands.
bot_auth_delay float Seconds after joining before the auth command is sent.
bot_auth_register_command / bot_auth_login_command string Command templates; {password} is replaced with bot_auth_password.

See Multi-Bot Mode for a full walkthrough.

Clone this wiki locally