{"id":3387,"date":"2025-09-15T23:54:23","date_gmt":"2025-09-15T20:54:23","guid":{"rendered":"https:\/\/gameteam.io\/blog\/?p=3387"},"modified":"2025-09-15T23:54:24","modified_gmt":"2025-09-15T20:54:24","slug":"minecraft-server-properties-configuration-guide","status":"publish","type":"post","link":"https:\/\/gameteam.io\/blog\/minecraft-server-properties-configuration-guide\/","title":{"rendered":"Minecraft Server Properties: Complete Configuration Guide"},"content":{"rendered":"

The server.properties file is your Minecraft server’s control center \u2013 a single text file that determines everything from world generation to player permissions. Most server crashes, connection issues, and performance problems trace back to misconfigured properties in this file.<\/p>\n

Server properties control your Minecraft server’s core functionality including world settings, player limits, difficulty levels, game modes, and network configuration. Located in your server’s root directory, this file contains approximately 25-30 configurable options that directly impact gameplay experience and server performance.<\/p>\n

Understanding the Server.Properties File Structure<\/h2>\n

Your server.properties file uses a simple key=value format. Each line contains one setting, and the server reads these on startup. Comments begin with # symbols, and blank lines are ignored.<\/p>\n

Here’s what a typical file structure looks like:<\/p>\n

File Location:<\/strong> Found in your server’s root directory alongside the server.jar file
Format:<\/strong> Plain text (.properties extension)
Encoding:<\/strong> UTF-8 (important for special characters)<\/p>\n

The file generates automatically when you first run your Minecraft server software. If you delete it, the server creates a new one with default values on the next startup.<\/p>\n

Essential Server Properties Configuration<\/h2>\n

World and Gameplay Settings<\/h3>\n

level-name=world<\/strong>
Sets your world folder name. Change this to load different worlds or create new ones. The server looks for a folder with this exact name.<\/p>\n

gamemode=survival<\/strong>
Options: survival, creative, adventure, spectator. This sets the default mode for new players joining your server.<\/p>\n

difficulty=easy<\/strong>
Controls mob spawning and damage: peaceful, easy, normal, hard. Peaceful mode disables hostile mobs entirely.<\/p>\n

hardcore=false<\/strong>
When true, players get permanently banned after dying. Only works in survival mode.<\/p>\n

Server Network Configuration<\/h3>\n

server-port=25565<\/strong>
The port players connect to. Change this if running multiple servers or if your hosting provider requires specific ports.<\/p>\n

server-ip=<\/strong>
Leave blank unless you need to bind to a specific network interface. Most users should keep this empty.<\/p>\n

online-mode=true<\/strong>
Enables Mojang account verification. Set to false only for offline\/cracked servers, but this disables many security features.<\/p>\n

max-players=20<\/strong>
Player limit for your server. Higher numbers require more RAM and processing power.<\/p>\n

Performance and Resource Management<\/h3>\n

view-distance=10<\/strong>
How many chunks players can see (measured in chunks, not blocks). Higher values look better but use more server resources. Range: 3-32 chunks.<\/p>\n

simulation-distance=10<\/strong>
Distance where the server processes game mechanics like mob spawning and crop growth. Keep this at or below view-distance.<\/p>\n

spawn-protection=16<\/strong>
Radius around spawn where only operators can modify blocks. Set to 0 to disable spawn protection entirely.<\/p>\n

Advanced Configuration Options<\/h2>\n

World Generation Properties<\/h3>\n

level-type=minecraft\\:normal<\/strong>
World generation type. Options include minecraft:normal, minecraft:flat, minecraft:large_biomes, minecraft:amplified, or custom datapacks.<\/p>\n

generate-structures=true<\/strong>
Controls villages, dungeons, temples, and other structures. Disable for performance gains in creative-only servers.<\/p>\n

level-seed=<\/strong>
Specific world seed for consistent world generation. Leave empty for random generation.<\/p>\n

Player Behavior Settings<\/h3>\n

pvp=true<\/strong>
Enables player vs player combat. Set false for peaceful community servers.<\/p>\n

allow-flight=false<\/strong>
Permits flying in survival mode. Enable this if using flight-based plugins or mods.<\/p>\n

allow-nether=true<\/strong>
Creates and allows access to the Nether dimension. Disable to save resources if not needed.<\/p>\n

enable-command-block=false<\/strong>
Activates command blocks. Enable for adventure maps and automated systems.<\/p>\n

Security and Moderation<\/h3>\n

white-list=false<\/strong>
When enabled, only players in whitelist.json can join. Essential for private servers.<\/p>\n

enforce-whitelist=false<\/strong>
Kicks non-whitelisted players immediately when whitelist is enabled, even if they’re already connected.<\/p>\n

op-permission-level=4<\/strong>
Operator permission level (1-4). Level 4 gives full server control including \/stop and \/ban commands.<\/p>\n

Performance Optimization Through Properties<\/h2>\n

Server performance directly correlates with several property settings. Here’s how to optimize:<\/p>\n

For Better Performance:<\/strong><\/p>\n