Halloween DealsAmazon USHalloween week deals: useful picks before month-endAmazon US: current deals, useful picks and tech finds.Check DealsSlow PC?RecommendedPC slow today? Run a repair scan before it gets worseResolve common Windows issues and optimize system performance.Scan NowHalloween DealsAmazon USOctober picks are moving - compare before checkoutAmazon US: current deals, useful picks and tech finds.See Picks×
Skip to content
World desk10 min

How to Find and Fix JSON Config Errors on a Minecraft Server

A practical, version-aware workflow for locating Minecraft server JSON errors, validating syntax, repairing or regenerating files, and testing datapacks, plugins and mods safely.
Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

A Minecraft server JSON error is fixed by identifying the exact file and parser location first, then repairing a backed-up copy or regenerating only the affected generated file. Do not delete files blindly: whitelist, ban and operator files can be recreated, but doing so removes their entries.

Use the workflow below to distinguish malformed JSON from a schema, value or Minecraft-version problem. It also covers datapacks, plugin and mod configurations, and the separate server.properties format.

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.

Stop the server and preserve evidence

Do not begin by opening every configuration file or repeatedly restarting. A failed start can overwrite logs, regenerate files or obscure the first parser message. If the process is still running, stop it cleanly from the server console with stop. Then preserve the state that produced the error.

  1. Copy the complete server directory to a dated backup. If storage is limited, at minimum copy the suspect file, logs/latest.log, any crash report, and the current plugin, mod and datapack directories.
  2. Record the Minecraft version, server implementation (vanilla, Spigot, Paper, Fabric, Forge or NeoForge), Java version if known, and the last change made before the failure.
  3. Keep the original file unchanged. Make a working copy with a name such as config.json.work; repairs made only to a copy are reversible.
  4. Capture the full first error block from the console and latest.log, including the file path, line, column or character number, and the exception name.

Shockbyte’s September 11, 2024 guidance notes that an invalid .json configuration can crash a server or prevent plugins and mods from loading. That is why the original file and log are evidence, not disposable clutter.

#1 Best Overall
Sale
TOZO A1 Wireless Earbuds Bluetooth 5.3 Light Weight in Ear Headphones | IPX5 Waterproof,2 Mics for AI Calls,Immersive Premium Sound Bass Headset with Charging Case,32 EQ via App Black
  • [Ultra-Lightweight Ear Buds Designed for Small Ears] Each earbud weighs only 3.7g and features a compact, ergonomic in-ear design made especially for small ears. Secure, low-profile, and comfortable for workouts, all-day wear or overnight sleeping.The ultra-slim profile sits flush in your ear with no hard edges poking or rubbing, so you can even sleep on your side without discomfort.
  • [Immersive Stereo Sound with TOZO OrigX Technology] TOZO OrigX tuning delivers clear vocals, balanced mids, and natural stereo sound for music, podcasts, and videos.
  • [Long Battery Life for Daily Use] Get up to 7 hours of playtime on a single charge, with up to 32 hours total using the charging case—ideal for workdays, commuting, and extended listening sessions.
  • [Bluetooth 5.3 & Stable Connection] Bluetooth 5.3 provides fast pairing, stable wireless performance, and reduced dropouts as you move around home or office.
  • [Deep Bass with Clear Vocals] High-performance drivers produce punchy bass while keeping vocals clean and detailed for everyday listening.

Find the first useful parse error

Read the console output and logs/latest.log from the top of the failure, not just the final message such as “server stopped.” Search for JsonParseException, MalformedJsonException, Couldn't parse, Failed to load, Unexpected character, Unterminated string or Trailing data.

The actionable part normally contains a path and a location, for example a configuration filename followed by a line and column. Open that exact file and inspect the reported character and the token immediately before it. Parsers frequently report the position where they finally became unable to continue; a missing comma, quote or closing bracket is often one character earlier.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
  • File path: tells you whether the owner is the vanilla server, a datapack, a plugin or a mod.
  • Line and column: narrow the search. Count from the beginning of the file in a plain-text editor; do not rely on a word processor that reformats text.
  • Exception wording: distinguishes grammar errors from missing fields, invalid values or an incompatible format.
  • First occurrence: later “failed to load” and shutdown messages are usually consequences rather than separate faults.

Classify the file before changing it

Ownership determines the safest recovery. A file called config.json is not necessarily a vanilla file; every plugin and mod can choose its own directory and schema.

Where the error points Typical owner What can go wrong Least-destructive first action
whitelist.json, banned-players.json, banned-ips.json or ops.json in the server root Vanilla administration data Broken punctuation, truncated write or hand-edited entry Restore a known-good copy; if none exists, move the file aside and regenerate it through the console
A JSON resource under a datapack’s data paths Datapack Malformed recipe, tag, predicate, function metadata or a format incompatible with the Minecraft release Remove or rename only that pack, or start with vanilla safe mode to confirm the cause
A plugin’s or mod’s own configuration directory Plugin or mod Syntax, required-field, identifier or version-schema failure Use the exact release documentation; restore the file or let that component regenerate it
server.properties Vanilla server properties Invalid key/value, type or setting for the server version; this is not JSON Edit it as a properties file, preserving one setting per line

Spigot describes server.properties as the base for server configuration and lists typed settings such as server-port, level-seed, online-mode, difficulty and generator-settings. Its older defaults are version-specific reference material, not a promise that current releases use identical defaults.

Rank #2
Sale
Smart Watch for Men Women Compatible with iPhone Samsung Android Phone 1.69 inch Full Touch Screen IP68 Waterproof Bluetooh Fitness Tracker Heart Rate/Sleep Monitor (Black)
  • 【IP68 Waterproof Multifunctinal Smart Watch】Torjalph fitness activity tracker smart watch is IP68 waterproof technology ,you can wear it when swimming,handwashing,it's rain-proof which means that you perform multiple exercise modes outside without worrying about sweat or rain corroding your fitness smart watch,and this watch equipped with a 230 mAh large capacity battery magnetic charging ,and this sports activity tracker watch can be used 5-7 days If fully charged.
  • 【Larger 1.83'' Full Screen Watch & Multi-dial Selection】1.83 inch full HD color touch screen smart watch for men / women provides excellent 240*284 resolution image quality ,This Bluetooth smart watch offers a better touch experience and remarkable immersion and ,more than 200 watch faces for you to choose from App"Da Fit ", you can change the dial style according to your mood to wear keeping the world on your wrist
  • 【Accurate Activity Tracker Smart Watch 】sports watch activity tracker uses sweat and dust resistant breathable silicone strap, our Fitness Tracker Smart Watch for Android iOS Phones supports 12 sports modes,walking,running,bicycle,swimming,badminton,basketball,football,rope skipping. This bluetooth calls smart watch for men women is lightweight and stylish, bringing more convenient and relaxing sports experience while also providing more protection.
  • 【Your 24 Hour Personal Daily Health Monitor】Fitness watch for women men full touch screen IP67 waterproof bluetooth smartwatch for Android iOS Phones with heart rate blood pressure monitor multifunction Andriod smart watch with steps counter sleep monitor sports fitness watch, monitoring blood oxygen saturation allows you to understand your physical condition in real time to track fitness progress ,to know your health status in time.
  • 【More Functions Bluetooth Call Smart Watch】This fitness activity smart watch full screen for iPhone and Android phones includes a bunch of new features including:The bluetooth smart watch can hang up the phone, receive and display WhatsAPP /Text /Facebook /Twitter /Messenger reminder.Support sedentary reminder, alarm clock, stopwatch, timer,weather information,music control, remote camera control compatible with Android 5.0 and above or iOS 9.0 and above smartphones.

Validate strict JSON on a copy

JSON is a text format defined by a grammar. RFC 8259 states: “A JSON parser MUST accept all texts that conform to the JSON grammar.” A validator can identify the first grammar violation, but validate the copied file rather than the live server file. An online validator is convenient; a local editor or command-line parser keeps private configuration off the internet.

Objects, arrays and separators

  • Objects use curly braces: {...}. Arrays use square brackets: [...].
  • Every object name is a quoted string, followed by a colon and its value.
  • Commas separate members or array items. There is no comma after the final member.
  • Whitespace is allowed around structural characters.
{"name":"Alex","enabled":true,"levels":[1,2,3]}

In the example, name is a string, enabled is a Boolean and levels is an array of numbers. These punctuation errors are common:

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
{"name":"Alex" "enabled":true}   // missing comma
{"name":"Alex",}                 // trailing comma
{name:"Alex"}                     // unquoted name

Comments shown after the examples are explanatory text, not valid JSON. Remove comments from an actual file. Trailing commas are not part of the standard grammar even if another programming language accepts them.

Allowed values and escaped strings

A JSON value is an object, array, number, string, true, false or null. The literal names are lowercase: true, not True; false, not FALSE; and null, not NULL. Quote text and escape quotation marks, backslashes and control characters inside strings.

Rank #3
New Bee Guitar Cable 10ft Electric Instrument Bass AMP Cord
  • [Low Noise High Fidelity] New bee guitar cord with 22AWG oxygen-free-copper center conductors provides enhanced signal transfer, the PVC insulation material and the high-density stranded copper double shield provide noise rejection for quiet operation
  • [Ideal for Choice] New bee 1/4 straight and right angle metal connectors, ensures a secure connection in any instrument, pedal, or amp jack. L shape great fro on stage guitar stands
  • [Wide Compatible] Suitable for mixer, power amplifier, microphone, effector, decoder, equalizer, electoronic organ, electric guitar, electric bass and other electronic equipments. Widely used in the installation of smart home, karaoke speaker, professional stage audio, etc
  • [Easy Disassemble] Making incidental repairs quick and easy! Very nice, flexible cable
  • [Dont Hesite to Order] 24 hours customer services and professional technology team are standing by
{"motd":"Welcome to the a7a server","path":"C:\minecraft\world"}

A validator proving that the file is syntactically valid does not prove that Minecraft or a component can use it. The next checks are semantic.

Match the symptom to the likely fault

Message or symptom Likely issue What to inspect
Unexpected character Unquoted name, comment, single quote, stray comma or other non-JSON character The reported character and the preceding separator
Unterminated string Missing closing quote or an unescaped quote/backslash inside text The string that begins on the reported line, including the previous line if a value spans lines
Trailing data Two top-level JSON documents, or extra text after the closing brace/bracket Everything after the first complete root value
Unexpected end of input Truncated write or missing closing brace/bracket/quote The final lines and matching delimiters from the beginning
Valid JSON but “missing” or “invalid” field Schema or semantic validation failure Required names, value types, identifiers and the component’s release documentation
Only one plugin, mod or pack fails after an update Version mismatch or changed schema That release’s format and migration notes, not a generic JSON formatter

Apply the least destructive repair

  1. Restore first if possible. Replace the working copy with the last known-good backup made for the same Minecraft and component version. Keep the corrupt file under a separate name for later comparison.
  2. If editing is necessary, change one thing. Fix the delimiter, quote, escape or value identified by the parser. Do not reformat unrelated sections or convert number, Boolean and string types without documentation.
  3. Validate again. Run the copied file through a strict JSON parser and compare the result with the component’s documented example or a newly generated file from the same release.
  4. Install the repaired copy while the server is stopped. Preserve file ownership and permissions, then start the server once and read the new first error rather than assuming success.
  5. Keep both files until a normal save. Retain the original backup until the server has started, the affected feature has worked, and at least one normal save cycle has completed.

Repair generated vanilla administration files

Whitelist, ban and operator files are generated data, so hand-editing is usually riskier than rebuilding them. Shockbyte warns that deleting these files can clear their contents. If a backup is unavailable, stop the server, move the corrupt file out of the way instead of deleting it, restart, and rebuild only the entries you actually need through console commands.

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

Whitelist

whitelist on
whitelist add PlayerName
whitelist remove PlayerName
whitelist list

Use the exact player name or identifier expected by your server version. Verify the list before allowing players to connect; moving the file aside creates an empty replacement and does not recover forgotten names.

Operators

op PlayerName
deop PlayerName

Re-add operators deliberately and check their permission level. Never paste an old operator file from a different server or release without checking its structure.

Rank #4
BSIMB 15.6" Digital Family Calendar & Chore Chart, No Subscription Fees
  • Digital Family Calendar: BSIMB digital calendar wall touch screen puts an end to your chaotic life. Designed for busy families, the digital calendar keeps you organised and in step with your family. Assign different colours and tasks to each family member to make family scheduling easier and more intuitive.
  • Easy Setup and Auto-Sync: Plug in, connect to WLAN and auto-syn your electric calendar in minutes. Digital wall calendar compatible with Google calendar, iCloud calendar, Outlook calendar, Cozi calendar and Yahoo calendar. Add events directly on the device or through the ecalendar app. Electronic calendar stays current whether you're at work or traveling—no manual updates needed.
  • All-In-One Home Assistant: Smart calendar builds habits and encourage independence with personalised chores. Display daily meal plan to reduce the daily ‘What's for dinner?’ stress. To-do lists keep track of everything you want. Turning chores into valuable achievements with stars and rewards, making life easier and more enjoyable.
  • Manage Anytime Anywhere: BSIMB electronic calendar for family stay connected with the powerful ecalendar app. Access and manage your digital wall calendar anytime, anywhere with free features like stars & rewards, photo screensaver, chore charts, meals plans, to-do lists etc. Electronic planner paid features like Magic Import tailor advanced tools for users with special needs.
  • Stay in Touch with Loved Ones: Share photos or videos from your phone to electronic wall calendar with app, instantly update your life moment, and keep in touch with your family, especially those who are far away; you can also surprise your smart calendar digital wall by sending him a wish card; it's also great for keeping tech-illiterate elders in touch with the youngsters.

Bans

ban PlayerName reason
pardon PlayerName
ban-ip 203.0.113.10 reason
pardon-ip 203.0.113.10

Rebuilding ban data is a security decision: a regenerated file may temporarily omit bans that protected the server. Keep the moved original until you have audited the replacement.

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

Handle datapacks without risking the world

Datapack JSON is loaded as part of a world, so a broken pack can prevent world loading even when the root server files are fine. Mojang’s Nether release notes document two useful behaviors: a failed datapack reload does not apply the changes, and the server has a --safeMode startup option that loads only the vanilla datapack.

  1. Read the log for the datapack name and the resource path under its data directory.
  2. Stop the server and rename or remove only that pack, preserving a copy. Do not delete the world or every pack at once.
  3. If the world still cannot load, add --safeMode to your normal Java server launch command, for example java -jar server.jar --safeMode. Keep your usual memory and other launch arguments as appropriate for your installation.
  4. If safe mode loads the world, the vanilla server and world are usable without the custom pack. Repair or replace the identified pack against the exact Minecraft version, then re-enable it.
  5. When several packs changed together, add them back one at a time and test a reload or world start after each addition.

Safe mode is an isolation tool, not a permanent configuration. It disables custom datapack content, so gameplay, recipes, functions and advancements supplied by those packs will be absent during the test.

Separate syntax errors from schema and version errors

A formatter only answers “is this legal JSON?” Minecraft still checks what the document means. A syntactically valid file can fail because a required field is absent, a value has the wrong type, an identifier is unknown, or the schema belongs to another release.

  • Required field: a component may require a name, type, list or nested object that your file omits.
  • Wrong type: a setting documented as a number may not accept a quoted string such as "10"; a list cannot be replaced with one item.
  • Unknown identifier: namespace and identifier spelling must match what the installed component registers.
  • Version mismatch: datapack formats, plugin options and mod schemas can change with Minecraft or the loader. Compare against documentation for the exact release and implementation.

When a newly installed version creates a fresh file, compare that generated file with your old one field by field. Migrate only documented settings; do not copy obsolete keys simply because they look familiar.

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

Do not treat server.properties as JSON

server.properties is a key/value properties file, normally one setting per line, not an object enclosed in braces. Do not paste it into a JSON formatter or add commas and quotation marks around every value. Preserve the key names and edit values according to their documented type.

server-port=25565
online-mode=true
difficulty=normal
level-seed=

If the server reports a properties or EULA load warning on its first launch, follow the Java server setup process: run the server JAR, accept the EULA in eula.txt, then edit server.properties. Those startup messages are not evidence that a JSON file is broken.

Restart, isolate and verify

After the repaired or regenerated file passes validation, start the server with the same implementation and version recorded at the beginning. Verification has three separate parts:

  1. Startup: confirm the original parse exception is absent from the console and latest.log.
  2. Reload or load: if the affected component supports a reload, confirm it completes without a new error; for a datapack, confirm the world loads normally.
  3. Functional test: test the feature represented by the file, such as joining with a whitelisted account, executing an operator command, crafting a datapack recipe or enabling the plugin feature.

When multiple plugins, mods or datapacks changed together, leave all but one disabled and re-enable them one at a time. The first re-enabled component that reproduces the error owns the next investigation. Keep the repaired file and original backup until the server has completed a normal save cycle and the feature has passed its test.

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

Choose recovery by risk

Situation Preferred action Data risk
Known-good backup for the same version Restore it, then reapply only documented changes Lowest; recent entries made after the backup may be missing
One punctuation error in a hand-maintained component file Minimal edit on a copy, validate, then replace Low if the original is retained
Corrupt generated whitelist, ban or operator file Move aside, restart, and rebuild with console commands Lists reset; entries must be audited and re-added
Datapack prevents world loading Remove or rename that pack, then test with --safeMode Custom content is unavailable during isolation; the world remains separate
Valid JSON rejected after an update Use the exact component documentation and version-matching example Blind edits can silently discard settings or change behavior

Prevent the next JSON failure

  • Make a dated backup before editing, updating a plugin or changing a datapack.
  • Use version control or keep an unchanged original beside every hand-maintained JSON file.
  • Validate generated or edited JSON before starting a production server.
  • Record the Minecraft version, loader or server implementation and component versions with the backup.
  • Change one plugin, mod or datapack at a time when possible, then perform a startup and functional test.
  • Use a text editor that shows line and column numbers and does not silently add comments, smart quotes or a byte-order mark.
  • Keep latest.log and crash reports from failed starts; the first parse location is more valuable than the final shutdown line.

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 *

What’s actually slowing this PC down?

Pick the symptom - the matching free tool is one click away.

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

More from the Wire

  1. World desk4 min
    How to Spot an AI Voice Scam Before Sending MoneyDon’t rely on how a caller sounds. Pause, call back through a known number, and verify the emergency with another trusted person before sending money.
  2. Mountain View desk4 min
    Google’s SynthID Detector: How to Check AI-Generated Images, Video and AudioGoogle’s SynthID Detector looks for an embedded watermark in supported images, video and audio. Here is what its results do—and do not—show.
  3. Redmond desk20 min
    How to create a link to File or Folder in Windows 11Windows 11 gives you several ways to point to a file or folder without moving or duplicating it. You can create a desktop shortcut,…
Recommended PC Tool
Recommended PC Tool
Crashes, No Sound, or Screen Glitches?Free driver scan
PC Slower Than It Used to Be?Free scan - under a minute

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.