Basic Configuration

Core server settings in configuration.toml

The configuration.toml file contains essential settings for running your Pumpkin server. All settings have sensible defaults matching vanilla Minecraft behavior.

Edition Support

java_edition · boolean · default: "true"

Whether Java Edition clients are accepted.

java_edition_address · SocketAddr · default: "0.0.0.0:25565"

The address and port to which the Java Edition server will bind.

Format: "IP:PORT" (e.g., "0.0.0.0:25565" for all interfaces, or "127.0.0.1:25565" for localhost only)

bedrock_edition · boolean · default: "true"

Whether Bedrock Edition clients are accepted.

bedrock_edition_address · SocketAddr · default: "0.0.0.0:19132"

The address and port to which the Bedrock Edition server will bind.

Format: "IP:PORT"

World Settings

seed · Seed · default: "random"

The seed for world generation. Can be a number or string. If not specified, a random seed is generated.

Example: seed = "12345" or seed = "MyWorld"

default_level_name · string · default: "world"

The name of the default world folder.

allow_nether · boolean · default: "true"

Whether the Nether dimension is enabled.

allow_end · boolean · default: "true"

Whether the End dimension is enabled.

default_difficulty · Difficulty · default: "Normal"

The default game difficulty.

Valid values:

• "Peaceful" - No hostile mobs, natural health regeneration
• "Easy" - Hostile mobs deal reduced damage
• "Normal" - Standard difficulty
• "Hard" - Increased mob damage, limited health regen

hardcore · boolean · default: "false"

Whether the server is in hardcore mode.

Player Settings

max_players · u32 · default: "1000"

The maximum number of players allowed on the server.

Set to 0 to disable the limit.

view_distance · NonZeroU8 · default: "16"

The maximum view distance for players in chunks.

Validation: Must be between 2 and 64 (inclusive).

simulation_distance · NonZeroU8 · default: "10"

The maximum simulation distance in chunks. Determines how far away from players entities and blocks are updated.

default_gamemode · GameMode · default: "Survival"

The default gamemode for players.

Valid values:

• "Survival" - Standard survival mode
• "Creative" - Unlimited resources, flying, invulnerable
• "Adventure" - Cannot break blocks without proper tools
• "Spectator" - Fly through blocks, observe without interacting

force_gamemode · boolean · default: "false"

If enabled, the server forces the default gamemode when players join.

Authentication & Security

online_mode · boolean · default: "true"

Whether online mode is enabled. When enabled, requires valid Minecraft accounts.

Validation: When true, encryption must also be true.

encryption · boolean · default: "true"

Whether packet encryption is enabled. Required when online mode is enabled.

allow_chat_reports · boolean · default: "false"

Whether chat messages should be signed, allowing players to report chat messages.

Validation: Requires online_mode = true.

scrub_ips · boolean · default: "true"

Whether to remove IP addresses from logs for privacy.

Server Identity

motd · string · default: "A blazingly fast Pumpkin server!"

Message of the Day - the server’s description displayed on the status screen.

Example:

motd = "Welcome to my server!"

use_favicon · boolean · default: "true"

Whether to use a server favicon (the icon displayed in the server list).

favicon_path · Option<String> · default: "None"

Optional path to a custom server favicon image.

Example:

favicon_path = "icon.png"

Whitelist

white_list · boolean · default: "false"

Whether to enable the whitelist. When enabled, only whitelisted players can join.

enforce_whitelist · boolean · default: "false"

Whether to enforce the whitelist immediately. When enabled, non-whitelisted players are kicked when the whitelist is activated.

Permissions

op_permission_level · PermissionLvl · default: "Four"

The permission level assigned by the /op command.

Valid values:

• Zero - Normal player, basic commands only
• One - Moderator, can bypass spawn protection
• Two - Gamemaster, can use command blocks
• Three - Admin, can manage multiplayer
• Four - Owner, full access to all commands

Server Performance

tps · f32 · default: "20.0"

The server’s ticks per second. Minecraft’s default is 20 TPS.

Changing this value may cause unexpected behavior and is not recommended.

Example Configuration

configuration.toml

# Server Edition Support
java_edition = true
java_edition_address = "0.0.0.0:25565"
bedrock_edition = true
bedrock_edition_address = "0.0.0.0:19132"

# World Settings
seed = "MyAwesomeWorld"
default_level_name = "world"
allow_nether = true
allow_end = true
default_difficulty = "Normal"
hardcore = false

# Player Settings
max_players = 100
view_distance = 12
simulation_distance = 8
default_gamemode = "Survival"
force_gamemode = false

# Authentication & Security
online_mode = true
encryption = true
allow_chat_reports = false
scrub_ips = true

# Server Identity
motd = "Welcome to my Pumpkin server!"
use_favicon = true
# favicon_path = "icon.png"

# Whitelist
white_list = false
enforce_whitelist = false

# Permissions
op_permission_level = "Four"

# Performance
tps = 20.0