Config builder

Change any setting and the file on the right updates as you go. It only lists what you changed, since Basalt fills in the default for everything else. Already have a basalt.toml? Load it to edit it here. Your changes are remembered in this browser. Every setting is explained on the Configuration page.

Load my basalt.toml

General

server_name

The name shown in the server list.

Default: "Basalt"

world

The folder inside worlds/ to play. Created if it does not exist. See Worlds.

Default: "world"

max_players

The most players allowed on at once.

−+Default: 20

gamemode

The game mode a player gets the first time they join: "survival", "creative", "adventure" or "spectator".

survivalcreativeadventurespectatorDefault: "survival"

force_gamemode

Puts every player in gamemode each time they join, not only the first time.

Default: false

default_player_permission_level

The permission level of players not listed in permissions.json: "visitor", "member" or "operator". See Permissions, allowlist and bans.

visitormemberoperatorDefault: "member"

allow_list

Only lets in players listed in allowlist.json. The allowlist on and allowlist off commands rewrite this line.

Default: false

online_mode

Checks every player's Xbox sign-in.

Default: true

autosave_ticks

Ticks between saving players and the world. 6000 ticks is five minutes.

−+Default: 6000

enchant_bypass_limits

Lets /enchant and plugins put any enchantment on any item at any level up to 32767, ignoring vanilla's maximum levels and conflicts. Off keeps vanilla's rules.

Default: false

Network

signaling_port

The TCP port clients use to start a connection.

−+Default: 19132

media_port

The UDP port game traffic uses.

−+Default: 19133

advertised_addresses

Public addresses to give clients when the host is behind NAT, for example ["203.0.113.10"].

Default: []

compression_threshold

Packet batches smaller than this many bytes are sent uncompressed.

−+Default: 256

botnet_detection

Watches for several connections flooding packets at once. When three or more send over 300 packets a second together and look coordinated (they started together, send the same packet, share a subnet or have just connected), their addresses are disconnected and turned away for a minute.

Default: true

World and simulation

view_distance

The farthest chunk radius sent to a player, however far their client asks to see.

−+Default: 8

tick_distance

The chunk radius around each player where the world runs: mobs, random ticks such as crop growth, and the chunks kept for a while after a player leaves. At least 1; values above view_distance are treated as view_distance.

−+Default: 4

chunk_unload_delay

Seconds a chunk nobody is near stays loaded before it is saved and unloaded. The chunks around a player who leaves stay this long too, with what they dropped.

−+Default: 300

mob_ai

Runs mob AI: wandering, following, attacking and pathfinding. Off, mobs stand where they are, though they still fall, get pushed and can be hurt.

Default: true

mob_ai_kinds

Mobs that keep their AI while mob_ai is off, as "minecraft:zombie" or just "zombie".

Default: []

max_threads

The most threads Basalt uses for connections and for chunk work. 0 uses as many as the machine has; a number above the machine's count is lowered to it.

−+Default: 8

player_tick

Runs each player's hunger: exhaustion, saturation, starving and the health food gives back. Off, players never get hungry and only heal by other means, which suits lobbies and kit servers.

Default: true

client_side_chunk_generation_enabled

Tells clients they may generate the look of chunks beyond the ones Basalt sends.

Default: true

Resource packs

texturepack_required

Players must accept the packs in resource_packs/ to join; refusing disconnects them. The older name force_resource_packs is still accepted.

Default: false

send_behaviour_packs

Also offers behaviour packs, which clients need for some addons. Resource packs are always offered.

Default: true

resource_pack_chunk_size

Bytes of a pack sent at a time (256 KiB).

−+Default: 262144

Skins and graphics

disable_custom_skins

Replaces skins made outside the Minecraft store and the character creator with the default skin.

Default: false

disable_persona

Replaces character creator (persona) skins with the default skin.

Default: false

skin_change_cooldown

Seconds a player must wait between changing skins in game. Changes made sooner are ignored.

−+Default: 30

force_skin_trusted

Treats every skin as trusted, whatever the client says about it.

Default: false

disable_client_vibrant_visuals

Tells clients to use the next best graphics setting instead of Vibrant Visuals.

Default: false

Plugin networking

script_net_enabled

Lets plugins make HTTP requests and open WebSockets.

Default: true

script_net_allowed_hosts

The hosts plugins may reach, as "discord.com", or "*.example.org" for any host under example.org. Empty allows any host. Host names are checked, not the addresses they resolve to.

Default: []

script_net_max_body_bytes

The largest HTTP response body or WebSocket message a plugin takes in, in bytes (8 MiB).

−+Default: 8388608

Rate limits

rate_limit_enabled

Turns on the limits below.

Default: true

max_inbound_packets_per_second

Packets a player may send in a second. More is treated as flooding and disconnects them.

−+Default: 1500

max_packets_per_tick

Packets a player may send in one 50 ms tick. Packets past the limit are dropped.

−+Default: 500

max_commands_per_second

Commands a player may send in a second; spamming more kicks them. 0 is no limit.

−+Default: 10

max_chat_per_second

Chat messages a player may send in a second; more are dropped. 0 is no limit.

−+Default: 2

max_form_responses_per_second

Form answers a player may send in a second; spamming more kicks them. 0 is no limit.

−+Default: 20

max_world_interaction_packets_per_second

Arm swings, sounds and other world interactions a player may send in a second; more are dropped. 0 is no limit.

−+Default: 0

max_movement_packets_per_second

Vehicle moves a riding player may send in a second; more are dropped. 0 is no limit.

−+Default: 40

Anti-cheat

anticheat_proxy

Disconnects players whose login shows the signs of a proxy rewriting it, with "Proxy Detected".

Default: true

anticheat_crash_packets

Drops packets made to crash other clients: eating events for food the player does not hold, sounds and emotes that are not real ones.

Default: true

anticheat_fly

Pulls back players who jump again while already in the air with no way to fly.

Default: true

anticheat_fast_break

Catches inputs that carry many ticks of block breaking at once.

Default: true

anticheat_criticals

Gives no critical hit for a fall the player did not jump or step into.

Default: true

anticheat_reach

Refuses blocks used, and players or mobs hit, through walls or from out of reach.

Default: true

anticheat_inventory

Refuses moves into the armour slots made with old-style inventory transactions.

Default: true

anticheat_self_hit

Drops a player's hit on themselves, which an honest client never sends.

Default: true

anticheat_scaffold

Refuses block placements that come far too fast to make by hand, or land on a face the player is not looking at.

Default: true

basalt.tomlNo changes yet

Include unchanged settings

CopyDownloadReset all

Settings you leave out use their default, so the file only needs the ones you change. Restart Basalt after editing it.