Driver FixRecommendedSound, Wi-Fi or graphics acting up? Check drivers firstFind missing or outdated drivers fast.Check DriversHalloween DealsAmazon USHalloween week deals: useful picks before month-endAmazon US: current deals, useful picks and tech finds.Check DealsWindows FixRecommendedWindows errors stealing your time? Find the fix fastScan stability, cleanup and performance issues.Fix Now×
Skip to content
VGSources
Blog

Modded Minecraft Server Config Files Explained: Locations, Scopes, and Safe Editing

A practical guide to modded Minecraft configuration: identify client, common, and server scopes; find the right Forge or NeoForge file; edit TOML safely; and recover when a setting resets or the server will not start.
Length9 min Posted Quest giverVGSources Team
Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Most modded Minecraft server settings are not in one file. Vanilla gameplay defaults live in server.properties; Forge and NeoForge mods usually write TOML files in the server’s config directory; and per-world server settings belong in world/serverconfig. A client may also have its own .minecraft/config files that never affect a dedicated server.

The reliable way to change a setting is to identify the loader, Minecraft version, mod, configuration scope, and exact filename first. Stop the server, back up the file and world, edit only the needed values while preserving TOML or properties syntax, then restart and read the log. The sections below show which file owns each kind of setting, what your friends need, and how to recover from a broken configuration.

As an Amazon Associate I earn from qualifying purchases.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

The three configuration layers on a modded server

Configuration ownership is easier to understand by scope than by filename. NeoForge documents three scopes—CLIENT, COMMON, and SERVER—and Forge-based projects use similar ideas even when their naming differs. The loader registration is authoritative; a suffix such as -common or -server is only a naming convention.

Client configuration

A client-only value is read by an individual player’s game. Its normal location is .minecraft/config on that player’s computer. A dedicated server does not have a matching server copy because the setting affects rendering, key binds, menus, particles, sound, or another local behavior. Changing your client file will not change a mob rule, recipe, permission, or other gameplay rule for everyone.

#1 Best Overall
Minecraft | Java & Bedrock Deluxe Collection | Windows Digital Code
  • DELUXE COLLECTION — Includes Minecraft: Java & Bedrock Edition, three Bedrock add-ons, three exclusive Character Creator items, and 700 Minecoins.
  • CREATE YOUR WORLD — Build whatever you imagine in an infinite world that’s unique in every playthrough.
  • EXPLORE AND CRAFT — Discover biomes, resources, and mobs, then craft your way through a sandbox world filled with surprises.
  • SURVIVE THE ADVENTURE — Face mysterious foes, travel across exciting landscapes, and venture into perilous dimensions.
  • PLAY TOGETHER — Play cross-platform with friends in Bedrock Edition on console, mobile, and PC, or join community servers in Java Edition on PC, Mac, and Linux. Online console multiplayer requires a platform-specific subscription (sold separately).

Common configuration

Common settings are available to both physical sides: the client and the server. A client stores its copy in .minecraft/config; a dedicated server stores its copy in <server_folder>/config. Depending on the mod, values may need to match on both sides, or the server may send the authoritative value when a player connects. Follow the mod’s documentation and the startup log rather than assuming that copying a file is always required.

Server configuration

Server-scoped values control the logical server and are the usual home for world-generation rules, gameplay toggles, spawn behavior, limits, and other shared decisions. On a dedicated server, these files are stored per world in <server_folder>/world/serverconfig. In single-player, the equivalent location is .minecraft/saves/<level_name>/serverconfig. Because the directory belongs to a particular world, moving or creating a file in the global config directory may have no effect.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

NeoForge describes server values as server-side and, where supported, synchronized to clients. That synchronization does not mean every server setting can be controlled by a player’s client: the server remains the authority.

Rank #2
Minecraft | Java & Bedrock Ultimate Collection | Windows Digital Code
  • ULTIMATE COLLECTION — Includes Minecraft: Java & Bedrock Edition, five Bedrock add-ons, five exclusive Character Creator items, and 1000 Minecoins.
  • CREATE YOUR WORLD — Build whatever you imagine in an infinite world that’s unique in every playthrough.
  • EXPLORE AND CRAFT — Discover biomes, resources, and mobs, then craft your way through a sandbox world filled with surprises.
  • SURVIVE THE ADVENTURE — Face mysterious foes, travel across exciting landscapes, and venture into perilous dimensions.
  • PLAY TOGETHER — Play cross-platform with friends in Bedrock Edition on console, mobile, and PC, or join community servers in Java Edition on PC, Mac, and Linux. Online console multiplayer requires a platform-specific subscription (sold separately).

Where each file lives

File or directory Owner and scope Typical format Generated for What it controls
.minecraft/config Client-only or common client copy TOML in Forge/NeoForge packs Each client installation Local behavior and settings shared with a mod’s common configuration
<server_folder>/config Common server copy Usually TOML Each dedicated-server installation Mod settings that exist on both physical sides
<server_folder>/world/serverconfig Server scope Usually TOML Each dedicated-server world World-specific, authoritative gameplay settings
.minecraft/saves/<level_name>/serverconfig Server scope in single-player Usually TOML Each single-player world The same type of logical-server settings as a dedicated world
server.properties Vanilla Java server Java properties text Each server root Vanilla options such as difficulty, view distance, ports, and online-mode behavior
META-INF/mods.toml inside a mod JAR Mod metadata, not runtime gameplay configuration TOML Packaged inside the mod Loading metadata, dependencies, and descriptive information

Forge and NeoForge runtime configuration is commonly TOML read through NightConfig. TOML is plain text, but it is strict about punctuation and value types. A file can look readable and still prevent the server from starting if a bracket, quote, comma, or boolean is damaged.

server.properties versus mod configuration

server.properties is the vanilla Java server’s property file. It is normally in the server’s root directory beside the server JAR, world folder, and logs. Mods do not automatically put all their options there. A mod may expose a vanilla-style option through a command or integration, but its own runtime settings generally remain in a TOML file in config or in a world’s serverconfig.

Use the file’s owner as your first diagnostic question: if the option is listed in vanilla server documentation, check server.properties; if it is described by a mod, check that mod’s generated file or startup message. Editing a similarly named file is a common reason a change appears to do nothing.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Rank #3
Minecraft | Standard Edition | XBOX Digital Code
  • CREATE YOUR WORLD — Build whatever you imagine in an infinite world that is unique in every playthrough.
  • EXPLORE AND CRAFT — Discover biomes, resources, and mobs, then craft your way through a sandbox world full of surprises.
  • SURVIVAL ADVENTURES — Face mysterious foes, travel across varied landscapes, and venture into perilous dimensions.
  • PLAY TOGETHER — Play solo or join friends in local split-screen and cross-platform play across console, mobile, and PC. Online multiplayer supports up to 8 players.
  • COMMUNITY PLAY — Connect with players on community servers, or subscribe to Realms Plus (sold separately) to play with up to 10 friends on a private server.

How to find the exact file safely

  1. Identify the environment. Record whether the server uses Forge, NeoForge, or Fabric, the Minecraft version, the mod version, and whether you are editing a dedicated server or single-player world. Fabric mods may use a different configuration mechanism, so do not apply Forge instructions automatically.
  2. Search the startup log and mod documentation. Look for the mod name, the words config or serverconfig, and messages showing a file being loaded or generated. Use the exact filename named there rather than guessing from a similar suffix.
  3. Stop the server completely. Use the host’s stop control or the console command stop, then wait until the process exits. Editing while the server is running can be overwritten when it saves on shutdown.
  4. Back up both the file and world. Copy the target configuration to a dated backup and copy the relevant world folder before making a change. A world backup matters because server-scoped files and generated data are tied to that world.
  5. Open the file with a plain-text editor. Choose an editor that preserves UTF-8 encoding, line breaks, comments, and punctuation. Avoid word processors that insert smart quotes or hidden formatting.
  6. Change one related group of values. Keep section headers such as [general], quoted strings, commas, and comments intact. Use true or false for booleans when the file does, and keep numeric values within the range documented by the mod.
  7. Save, then apply the required reload. Many settings require a full restart. Some mods listen for a reload event, and a few require unloading and reopening the world. Saving the file alone is not proof that the running server accepted it.
  8. Read the next startup log. Confirm that the file was loaded, note warnings about unknown or renamed keys, and test the setting in-game. Keep the backup until the result is verified.

Which settings must your friends have?

Players need a compatible mod set and any client-side configuration required by those mods, but they do not normally receive a copy of every server file. A useful division is:

  • Client-only: each player can choose their own value. It should not be copied to the server.
  • Common: the mod may require the same mod and compatible values on both sides. If the server synchronizes the setting, the server’s value can become authoritative after login.
  • Server: the dedicated server owns the value. Players do not set it in their clients, although a mod may synchronize the result for display or behavior.

If a player receives a missing-mod, mismatched-version, or configuration-channel error, compare the mod loader, Minecraft version, and mod versions first. Do not distribute a server’s entire world/serverconfig directory as a universal client configuration; it is generated for one world and may contain values that do not belong on a client.

Why a configuration resets or appears to be ignored

You edited the wrong scope

The most frequent mistake is changing .minecraft/config while expecting a dedicated-server gameplay rule to change. Check the world’s serverconfig directory for server-scoped values and the server root for server.properties.

Rank #4
Minecraft
  • Skins! We have biome settlers, city folk, town folk, and more!
  • The Nether and all its inhabitants. Fight Ghasts and make friends with Pigmen
  • Cross platform play for up to five players between Pocket Edition and Windows 10
  • Revamped touch controls, controller support, and a controller mapping screen
  • Enhanced Weather effects! Accumulating snow and more

The server regenerated the file

Mods commonly create a missing file with defaults. If a file returns to its original values, check whether the server was still running when you edited it, whether a startup error caused the file to be replaced, and whether a launcher or modpack update restored defaults. Stop the server, restore your backup, and restart once to verify that the file remains valid.

The key changed between versions

A configuration copied from another Minecraft or mod version may contain renamed, removed, or newly required keys. Unknown-key warnings are evidence that the old file is not a safe drop-in replacement. Generate a fresh file for the installed version, then migrate only values that still exist and have the same documented type.

The value has the wrong type or punctuation

TOML distinguishes strings, numbers, booleans, arrays, and tables. A missing quote, unmatched bracket, stray comma, or text where a number is expected can stop startup. Restore the backup, restart, and change one value at a time. For properties files, keep the key=value form and avoid adding TOML brackets.

Best Value
Minecraft - Bedrock Edition PS4
  • Play and share with friends on console, mobile and Windows 10
  • discover community creations in the new in-game store
  • access new mini games and game modes through servers

The change needs a reload or restart

Some mods read configuration only during initialization; others respond to a reload event. If documentation does not explicitly promise live reload, assume a full server restart is required. A world reload may be necessary for generation settings that are applied when chunks or dimensions are created.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

Diagnosing a Forge or NeoForge startup failure

  1. Stop retrying the same broken file. Repeated launches can overwrite useful log context.
  2. Open the latest log and find the first configuration-related error, not only the final “server stopped” line.
  3. Note the filename, section, key, and expected type reported by the loader or mod.
  4. Restore the last known-good backup and launch once. If the server starts, reapply changes individually.
  5. If the backup also fails, generate a clean file for the installed mod version and compare it with the old file. Migrate only keys confirmed by the new file or current mod documentation.
  6. Check that the mod JAR, loader, and Minecraft versions are compatible. A valid TOML file cannot repair an incompatible binary.

Keep the first error together with the filename when asking for help. “The server will not start” is less actionable than “the server rejects the value in world/serverconfig/example-server.toml because a boolean was supplied where an integer is required.”

Pack distribution and default files

The Default Server Properties mod provides a default-server.properties file in the game root. It changes the values used when vanilla server.properties is created, making it useful for distributing consistent vanilla defaults in a modpack. It does not replace a mod’s TOML files or a world’s serverconfig; those still come from the individual mods and worlds.

For a pack, document which files are global defaults and which are world-specific. Ship a clean template for files that should be identical across installations, but do not overwrite an existing administrator’s file without a deliberate migration step. A release note should identify renamed keys, required restarts, and any settings that only apply to newly generated chunks or worlds.

A practical comparison when choosing where to edit

Question Check first Reason
Is this a vanilla server option? server.properties It is owned by the Java server, not by an individual mod.
Does the mod describe a shared client/server option? config on the relevant installation Common settings may exist on both physical sides.
Does it change world gameplay or generation? world/serverconfig Server-scoped values are tied to that world.
Does it affect only graphics, controls, or local display? Player’s .minecraft/config A dedicated server cannot enforce a client-only preference.
Is the file inside a mod JAR under META-INF? Do not edit it as runtime configuration mods.toml describes mod metadata and loading.

Keeping configurations maintainable

  • Store dated backups outside the live server directory so an update cannot overwrite them.
  • Record the Minecraft, loader, and mod versions alongside each backup.
  • Change one logical group at a time and write down the reason for the change.
  • Never copy a world’s server configuration into another world without checking world-specific assumptions.
  • After upgrades, let the new version generate its own files before migrating values.
  • Test configuration changes on a copy of the world when the option affects terrain, dimensions, progression, or irreversible data.

Once you classify a setting by scope and location, the file names stop being mysterious: root properties are vanilla, global config files are installation-level mod settings, and serverconfig files belong to one logical world. That classification, followed by a stopped-server backup and a log check, prevents nearly every common editing mistake.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Quick Recap

Bestseller No. 4
Minecraft
Minecraft
Skins! We have biome settlers, city folk, town folk, and more!; The Nether and all its inhabitants. Fight Ghasts and make friends with Pigmen
$6.99
Bestseller No. 5
Minecraft - Bedrock Edition PS4
Minecraft - Bedrock Edition PS4
Play and share with friends on console, mobile and Windows 10; discover community creations in the new in-game store
$42.98

Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.

Leave a Reply

Your email address will not be published. Required fields are marked *

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

More quests from Patch Notes

  1. How to Set Up a RedM (RDR2) Server in 2026: License Key, txAdmin and server.cfg, Step by StepBlog11min
  2. Best RedM (RDR2) Server Hosting in 2026: Comparing Four Hosts on Slots, Memory and PriceBlog10min
  3. How to Host a Mindustry Server in 2026: server-release.jar, Port 6567 and the Commands That MatterBlog7min
Recommended PC Tool
Recommended PC Tool
Crashes, No Sound, or Screen Glitches?Free driver scan
Windows Errors? Fix Them Before They SpreadFree repair scan

Two free Windows tools

One Free Minute Could Fix That PC

Before you go - each of these free tools takes about a minute and tackles what quietly slows a Windows PC down.

Special offer. View Outbyte info, uninstall instructions, EULA, and Privacy Policy.