Free tools Windows power users keep installed
One-click scans. No signup required.
A Minecraft server JSON error is fixed by identifying the exact file and line reported in the console or logs/latest.log, validating a copy of that file, and making the least destructive repair. Back up the server first: deleting a damaged administration file can make the server start, but it also resets its whitelist, bans, or operator list.
Prefer not to run the server on your own PC? Godlike.Host offers hosted Minecraft Java servers with free DDoS protection and up to three free backups a day.
This guide covers vanilla, Spigot, Paper, Fabric, Forge, and NeoForge servers, with separate procedures for administration files, plugin and mod settings, datapacks, and the often-confused server.properties file.
As an Amazon Associate I earn from qualifying purchases.
Outdated Drivers Are Slowing You Down
One free scan finds every outdated or missing driver and matches the right update for your exact hardware.Free scan · exact hardware matchPC Slower Than It Used to Be?
A free scan shows the junk files, broken settings and background clutter dragging Windows down - then fixes them in one click.Free scan · Windows 10 & 11Start with the error, not the file you suspect
Do not begin by deleting every JSON file or running a formatter on the live server. A parser normally reports a path, line, and column. That information identifies the ownership and failure point far more reliably than the final message that the server stopped.
- Stop the server cleanly. Use the server console’s
stopcommand when it still accepts input. If it is frozen, stop the process through your service manager or hosting panel and note that the last save may not have completed. - Preserve evidence. Copy the complete server directory when possible. At minimum, copy the suspected file,
logs/latest.log, any new crash report, and the list of installed plugins, mods, and datapacks. - Record context. Write down the Minecraft version, server implementation, Java version if known, and the change immediately before the failure. A file made for a different release can be syntactically valid and still unusable.
- Work on a copy. Give the original a safe name such as
whitelist.json.corrupt-2026-10-14and edit a duplicate. Keep both until the server has completed a normal save cycle.
Find the first useful parse message
Search the console and logs/latest.log for JsonParseException, MalformedJsonException, Couldn't parse, Failed to load, Unexpected character, Unterminated string, or Trailing data. The first detailed parser message is usually actionable; later shutdown messages are consequences.
#1 Best Overall
- BLUE LIGHT BLOCKING GLASSES: Our blue light glasses for women boast UV400 protection, blocking harmful blue rays from computer screens. With these bluelight glasses women, you can enjoy gaming, reading, or watching TV with no worries of eye strain.
- EYE RELIEF: Our blue light glasses are engineered to reduce blurry vision or strain caused by prolonged screen time. These womens blue light glasses aid in better sleep by preventing blue light from disrupting your natural sleep cycle, helping you fall asleep faster and enjoy a more restful night's sleep, making them the perfect christmas present.
- COMFORTABLE: Crafted from durable material, our trendy blue light glasses for woman or blue light glasses men ensure long-lasting comfort. The high-transmittance lenses accessories, gamer gifts for men, help keep your eyes relaxed. Perfect stocking stuffers, gifts for gamers men, christmas gifts for men, halloween costumes.
- LIGHTWEIGHT: These clear blue light glasses feature a lightweight frame, meaning they’ll stay comfy for long-term wear. Perfect as blue blockers glasses for women or mens blue light glasses, these non-prescription fake glasses for men can be worn throughout the day. The blue light blocking glasses women feature polycarbonate HD lenses, which are anti-reflective and restore true color.
- WORRY-FREE PURCHASE: If you experience any issues, our support team is ready to assist you quickly. These are the perfect costume glasses for cosplay dressing up.
Record the complete path and the reported line and column. A parser often complains one token after the real mistake. For example, a missing comma after line 18 may be reported when the parser reaches the first character on line 19. Inspect the reported character and the preceding member.
What to capture
- The exact filename and relative path.
- The line and character (or column) number.
- The exception text and the first several lines of its stack trace.
- Whether the message appears during startup, world loading, plugin enable, mod loading, or a datapack reload.
Classify the file before editing it
Ownership determines the safest recovery. A root administration file is regenerated by Minecraft; a plugin or mod file is defined by that project’s schema; a datapack file belongs to a particular pack and Minecraft version.
Do these 3 things before closing this tab:
1Clear out junk files and repair common Windows errors2Fix the driver behind crashes, sound loss and screen glitches3Repair Windows errors before they cause bigger problems| File or location | Owner and purpose | Typical recovery |
|---|---|---|
whitelist.json |
Vanilla administration data for allowed players | Restore a backup, or move it aside and rebuild with console commands; moving it resets the list. |
banned-players.json and banned-ips.json |
Vanilla player and IP ban data | Restore or regenerate, then reapply bans deliberately. |
ops.json |
Vanilla operator entries and permission levels | Restore or regenerate; regeneration removes operator entries until they are added again. |
plugins/… or a mod’s configuration directory |
Plugin or mod-specific settings and schemas | Use that release’s documentation or a known-good default; do not substitute a vanilla file. |
data/… inside a datapack |
Recipes, loot tables, predicates, tags, functions, dimensions, and other pack resources | Disable only the named pack, test with vanilla safe mode, then repair the pack for the exact game version. |
server.properties |
Key/value server settings, not JSON | Edit its property syntax; never send it to a JSON validator. |
Validate strict JSON on a copy
JSON is a text format for structured data. Objects use curly braces, arrays use square brackets, names are strings, a colon separates each name from its value, and commas separate members. Valid values are objects, arrays, numbers, strings, true, false, and null. The literal values are lowercase.
RFC 8259 states: “A JSON parser MUST accept all texts that conform to the JSON grammar.” In practice, that means comments and trailing commas are not part of standard JSON, even if another configuration format permits them.
Syntax checklist
- Every object starts with
{and ends with}; every array starts with[and ends with]. - Every property name is in double quotation marks and is followed by a colon.
- Members and array items are separated by commas, but the final item has no trailing comma.
- Strings escape quotation marks as
", backslashes as\, and control characters such as a newline asn. - Use
true,false, ornull, notTrue,False, orNone. - Whitespace is allowed around structural characters; comments such as
// explanationare not standard JSON.
Common repairs
This object is valid:
{"enabled":true,"maxPlayers":20,"motd":"Survival server"}These changes would make it invalid:
{"enabled":True,"maxPlayers":20,} Truemust be lowercasetrue.- The comma after
20is trailing and must be removed.
A missing quote or comma can shift the reported location. Compare the parser’s line with the previous line, not just the highlighted character.
Use a validator safely
- Copy the suspect file to a work folder outside the live server.
- Open the copy in a local editor with line and column numbers, or paste the copy into a trusted JSON validator.
- Read the validator’s first error, then inspect the character immediately before it.
- Save only after confirming that the editor did not add comments, a byte-order mark, or smart quotation marks.
- Run the validator again and keep the original unchanged as your rollback.
Repair generated administration files
Minecraft’s root administration files are ordinary JSON arrays of records. A damaged file can prevent startup or prevent a related feature from loading. If you have a known-good backup from the same server version, restoring it is safer than reconstructing records by hand.
Rank #2
- WINDEX GAMING WIPES: effortlessly clean all your gaming gear and gaming electronics in one easy step with our new Windex Gaming Wipes
- AMMONIA FREE: our ammonia-free formula is safe to use on all of your favorite gaming equipment like consoles, headsets, controllers, screens, keyboards, and more
- PRE-MOISTENED WIPES: each wipe instantly removes dust, dirt, and stubborn smudges and fingerprints leaving a streak-free shine
- ANTI-STATIC: great for cleaning and wiping down your gaming gear and electronics leaving behind no visible residue
- COMPACT RESEALABLE PACKAGE: store your pack of Windex Gaming Wipes anywhere in your home for whenever a quick and easy wipedown is needed
When no usable backup exists
- Stop the server.
- Move the corrupt file out of the server directory instead of deleting it. For example, rename
whitelist.jsontowhitelist.json.corrupt. - Start the server once so it can create a fresh file.
- Use the console to rebuild the entries. Typical commands are
whitelist add PlayerName,ban PlayerName,ban-ip 203.0.113.10, andop PlayerName. Run only the commands that match the entries you intentionally want. - Stop and start the server again, then verify the regenerated file and test login or operator access.
Moving or deleting these files resets their contents. Shockbyte’s September 11, 2024 troubleshooting guide specifically warns that this approach can solve corruption while resetting whitelist, ban, and operator data. Treat the old file as evidence in case you later need to recover a name, UUID, or permission level.
Repair plugin and mod configuration
Plugin and mod files often live below plugins, a mod-specific folder, or a package’s own data directory. Their JSON schema is not interchangeable with vanilla administration JSON.
Use the exact release as your reference
- Check the plugin or mod name and version in the error path.
- Compare the file with the default configuration shipped for that exact release, not with a newer or older example.
- Confirm required fields, expected data types, allowed enumerations, and identifier spelling.
- If the project documents a command to regenerate configuration, prefer that command while the server is stopped.
Do not “fix” a semantic error by changing values at random. A syntactically valid number may still be outside the allowed range; a string may have to be a namespaced identifier; and a field removed in a newer release may be rejected by an older one.
Isolate several recent changes
If multiple plugins or mods were updated together, restore the backup and re-enable them one at a time. Start with the minimum set, wait for a clean startup, and then add one component. Keep the component named in each log entry so a second failure does not overwrite your evidence.
Quick wins for a faster PC:
Clear out junk files and repair common Windows errorsFree Scan →Fix the driver behind crashes, sound loss and screen glitchesFind Drivers →Repair Windows errors before they cause bigger problemsFix Now →Handle datapack JSON failures separately
Datapacks contain many JSON resource types, and one malformed recipe or tag can fail during reload. A critical datapack issue can also prevent a world from loading. If the log names a pack, do not edit unrelated root files.
Fast isolation procedure
- Stop the server and back up the world and the datapack directory.
- Remove or rename only the datapack named in the error, preserving its original folder.
- Start the server and test world loading. If it now starts, the pack is the likely cause.
- Inspect the named resource for syntax, then check its schema against the Minecraft version and the pack’s documentation.
- Restore the pack only after the repaired copy validates and the server starts cleanly.
Use vanilla safe mode to confirm the cause
Mojang’s Nether release notes document the Java server’s --safeMode option. It loads only the vanilla datapack, allowing you to determine whether a custom pack blocks world loading. Run the same server JAR with the option added to the startup command, for example:
Rank #3
- Ergonomic & Adjustable Design: Fight "text neck" and improve your posture. Designed for comfort, it offers an adjustable height (7.1in-8.5in) (1.4in adjustable range) and angle (5°-85°) Please note: cell phone stand is only 9 inches tall—the length of a standard pencil
- Without blocking subtitles Perfect for office desk Tiktok Face Time Zoom video—this is the ultimate kitchen desk essential for phones! Perfect viewing experience while reducing neck back strain, A must-have for gamers streamers desk, and anyone who values both style and support!
- Sleek & Stable Design fits Otterbox Case: Say goodbye to bent cables, tangles, and tip-overs! LISEN’s stylish adjustable desk phone holder features a built-in charging hole and smart cable management, keeping your phone secure and your workspace clutter-free cool gadgets for men
- ANTI-SLIP DESIGN free hands: The under 10.00 items easy gadgets back and the bottom of this kitchen essentials for women are fully covered by anti-skid silicone, which LISEN stand up desk decor can provide maximum protection device from any scratches and slides
- Your Perfect Viewing Companion:If your product arrives damaged or breaks within 365 days, reach out to LISEN for a quick and hassle-free solution. Struggling with assembly, like tightening the screw? We’ve got your back! Your experience matters to us. (Product including: phone Holder stand*1, screw*1, hexagon screwdriver*1, specification*1)
java -jar server.jar --safeModeUse the actual JAR filename and your normal Java memory flags. Safe mode is a diagnostic boot, not a repair: it does not fix the pack or permanently remove it. Once the world opens, stop the server, repair or replace the custom pack, and make a normal startup without --safeMode.
Do not treat server.properties as JSON
server.properties is a key/value properties file. Mojang’s Java server setup instructions describe it as a separate configuration step alongside accepting the EULA in eula.txt. Spigot’s reference likewise describes it as the base for server configuration and lists typed settings such as server-port, level-seed, online-mode, difficulty, and generator-settings.
A typical line looks like difficulty=normal, not {"difficulty":"normal"}. Keep one key and value per line, preserve the equals sign, and follow the valid values for your Minecraft release. Spigot’s older defaults are version-specific reference, not a guarantee for current releases. If the log reports an invalid property, correct that property directly rather than converting the entire file to JSON.
Separate syntax, schema, semantics, and version failures
| Failure layer | What the log or behavior suggests | What to do |
|---|---|---|
| Syntax parse | Unexpected character, unterminated string, malformed JSON, trailing data | Fix quotes, commas, braces, brackets, escapes, or lowercase literals. |
| Schema or required field | Valid JSON but a required property is absent or has the wrong type | Use the exact release’s default file and documentation. |
| Semantic identifier or value | Unknown recipe, tag, dimension, namespace, enum, or out-of-range number | Correct the identifier or value within the documented allowed set. |
| Version mismatch | The file worked before an upgrade, downgrade, plugin update, or pack change | Migrate it using that component’s release notes or restore a version-matched backup. |
Only the first row is solved by a generic JSON formatter. The other layers require the owning plugin, mod, datapack, or Minecraft release documentation.
Use the startup phase to narrow ownership
The phase in which the message appears is a useful second clue. An error before the world opens usually points to a root administration file, a server component, or a mod that loads during boot. A message immediately after a plugin’s enable line points to that plugin’s configuration directory. A reload-time message that names a recipe, loot table, tag, or function points toward a datapack resource. Do not infer ownership from the word “JSON” alone; the path and phase together are what matter.
The Tool Desk
Outbyte PC Repair FREEClear out junk files and repair common Windows errorsFree Scan →Outbyte Driver Updater FREEFix the driver behind crashes, sound loss and screen glitchesFind Drivers →If the same filename is reported more than once, compare timestamps and stack traces in latest.log. A file can be parsed successfully at startup and fail later when a reload reads a different resource. Conversely, a startup failure can produce many secondary “failed to load” lines for features that never had a chance to initialize. Fix the earliest specific exception first, then retest before changing anything else.
Rank #4
- Easy Installation: Our gaming lights have been designed to enhance your entertainment experience. Simply position the led light bar next to your TV or game console to create a game room environment with ease. They come with USB power and a 60 inch cord for direct mounting and mobility
- Audio Syncing & Extensive Mode: The built-in high-sensitivity music sensor allows you to sync the TV led lights to your favorite music. Lights react and move to the beat of music, film and game audio, creating an incredible immersive sound and light experience – and all without the need for an additional hub. You can choose from 64+ patterns, including strobe, illusion, jump, energy, gradient, running, chasing, fluttering mode etc. Each mode can be applied to different scenes
- 64+ Chasing IC+RGB & W Effect: The independent control design of IC+RGB and white all-in-one multifunctional rgbw led bar lights monitor backlight allows you to easily switch the led lights for desk between IC+RGB and white to enjoy a variety of lighting effects, you can choose white lighting mode with high brightness for better illumination when working, etc. Choose IC+RGB lighting mode when you need to create an entertaining atmosphere for the light show, 16 million colours of Color changing rgb light bar let you dance to the beat and create a dynamic party atmosphere
- Dynamic and Dimmable Lights: 1%-full brightness free brightness adjustment gives you the flexibility to adjust dimmable led light bar for room decorations or a variety of occasions
- USB Powered: USB light bars for room can be powered by powernank, usb charger, TV, Monitor, laptop PC mainframe, making behind TV led lighting bar easy to install in any location.TV led lights are powered by the TV usb interface / PC mainframe, can be turned on/off synchronously with TV / PC
Back up in a way that supports rollback
A backup is useful only if you can identify what it contains. Keep the original JSON, the repaired copy, and the log that led to the repair together. Label copies with the date, Minecraft version, and server implementation. For a datapack, include the world backup because pack changes can affect world loading. For administration files, retain the corrupt file even after Minecraft regenerates a replacement; it may contain entries that must be re-created.
Do not overwrite the only backup with a newly edited file. If a repair appears to work, make a second backup after a clean startup and a normal save cycle. That gives you a known-good rollback and a record of which change was accepted. If the error returns, restore the earlier copy instead of layering more edits onto an uncertain file.
Common mistakes that make recovery harder
- Editing while the server is running. Minecraft or a plugin may rewrite the file on shutdown and erase your manual change.
- Fixing every highlighted line at once. A parser may report a location after the actual missing comma or quote; changing several areas makes it impossible to know what solved the problem.
- Copying a configuration from another version. Valid syntax does not make fields, identifiers, or value ranges compatible.
- Deleting before recording entries. A regenerated whitelist, ban list, or operator file starts without the old entries.
- Leaving comments or trailing commas in place. Some editors accept them, but strict JSON parsers do not.
- Using safe mode as a permanent launch setting. It is intended to isolate custom datapacks and loads only the vanilla pack.
Restart, verify, and keep the rollback
- Start normally, without diagnostic flags, after replacing or repairing the copy.
- Confirm that the original parser message is absent from the new console output and
latest.log. - Test the affected feature: join with a whitelisted account, check an operator command, load the world, reload the datapack, or exercise the plugin setting that failed.
- Leave the repaired file and the original backup untouched until the server has completed a normal save cycle and you have another backup.
- If the same error returns, restore the backup and isolate the last change rather than making increasingly broad edits.
Recovery decisions at a glance
| Situation | Lowest-risk action | Main risk |
|---|---|---|
| One missing comma or quote, reliable backup available | Restore the backup or repair one character in a copy | Editing the wrong occurrence because the parser points one token late |
| Corrupt whitelist, ban, or operator file, no backup | Move it aside, let Minecraft regenerate, then reapply entries | Lists and permissions are reset |
| Plugin or mod file changed during an update | Use that release’s default or migration instructions | Older settings may be rejected by the new schema |
| Datapack blocks world loading | Disable the named pack or boot with --safeMode |
Safe mode proves causation but does not repair the pack |
Only server.properties is mentioned |
Edit key/value syntax and version-appropriate values | Running a JSON repair can corrupt an otherwise valid properties file |
Prevent the next JSON outage
- Back up the server before editing configuration, installing a plugin or mod, or changing a datapack.
- Keep dated copies of generated administration files so a reset is reversible.
- Make one configuration change at a time and start the server before making the next.
- Record the Minecraft version and implementation with each backup.
- Validate copied JSON before putting it into production, and never rely on comments or trailing commas that standard parsers do not accept.
- After an update, compare configuration schemas and migrate fields deliberately instead of copying an entire old directory over the new installation.
Frequently Asked Questions
How do I find which Minecraft JSON file is broken?
Read the first detailed parse error in the console or logs/latest.log. Record the full path, line, and column, then inspect that line and the character immediately before it because a missing comma or quote is often reported one token late.
Can I delete whitelist.json, ops.json, or a ban file to make the server start?
Move the file aside only after making a backup. Minecraft can regenerate it, but the new file will not contain the old whitelist, bans, IP bans, or operator entries. Rebuild only the entries you intend with console commands.
Why does a JSON validator say my file is valid while the plugin still fails?
The file may pass syntax validation but fail its plugin or mod schema. Check required fields, data types, allowed values, identifiers, and the exact release documentation. A version mismatch can also make valid JSON unusable.
Is server.properties a JSON file?
No. It is a key/value properties file, with lines such as difficulty=normal. Edit that syntax directly and follow the values supported by your Minecraft release; do not run it through a JSON formatter.
Best Value
- Compatible with Wide Screens - To ensure compatibility with the dual monitor mount, your each monitor must meet three conditions at the same time: First, computer screens size range: 13 to 32 inches. Second, screen weight range: 4.4 to 19.8 lbs. Third, the back of the monitor screen must have VESA mounting holes with a pitch of 75x75mm or 100x100mm.
- Regarding the compatibility with desks - Your desk must meet three conditions at the same time: First, desk material: Only wooden desks are recommended, plastic or glass desks cannot be used. Second, desk thickness range: 0.59" - 3.54". Third, the bottom of the desk should not have any cross beams or panels, as this will interfere with installation. We recommend carefully checking that your desk and monitors meets all above conditions before purchasing.
- Dual C-Clamp Hold - Worried your dual monitors might wobble or slip? Our upgraded base uses a larger platform plus a dual C-clamp structure to lock the dual monitor arm firmly to your desk. Each arm safely keeps your screens steady while you type, click and game—no shaking, no sliding, just a clean and secure setup you can trust every day. It also provides Grommet Mounting installation choice, both options ensure stable and secure fixation for your 0.59" - 3.54" desk.
- Full-Motion Adjustment For Comfortable View - Pull the screen closer when you’re deep in a spreadsheet, push it back to watch videos, or rotate to portrait for coding — moving everything smoothly with just one hand. The monitor stand offers +85°/-50° tilt, ±90° swivel and 360° rotation. Raise your monitor up to 15.75″ to support a healthy sitting posture. Whether you’re working from home, gaming through the night, or switching between video calls and documents, getting the screens to your natural line of sight helps relieve neck, shoulder and back strain so you can stay focused longer with less fatigue.
- Keep Your Desk Organized: By lifting both screens off the desktop, this dual monitor stand opens up valuable space for your keyboard, notebook, docking station or a simple, clutter-free work area. Built-in cable management guides wires along the arms, keeping cords out of sight and out of the way. Enjoy a tidy, modern workstation that looks as good as it feels to use.
What does --safeMode do on a Java server?
It loads only the vanilla datapack. Use it as a diagnostic boot when a custom datapack may block world loading, then repair or replace the named pack and return to a normal startup without the option.
Recommended Free Tools
Are comments and trailing commas allowed in Minecraft JSON?
Not in strict JSON. Property names require double quotes, literals are lowercase, strings need valid escapes, and the final member or array item must not have a trailing comma.
Should I edit a JSON file while the server is running?
No. Stop the server, preserve the original, and edit a copy. A running server or a later shutdown save can overwrite your change and destroy useful evidence.
What if several plugins, mods, or datapacks changed at once?
Restore the backup, start with the minimum set, and re-enable components one at a time. Confirm a clean startup and test the affected feature after each addition so the next failure has a clear owner.
The Bottom Line
Find the exact path and parser location first, stop the server, and preserve the file and logs. Validate a copy using strict JSON rules, then choose recovery based on ownership: restore or regenerate vanilla administration files, follow the exact plugin or mod schema, isolate datapacks with --safeMode, and treat server.properties as a separate properties format. Restart normally, test the affected feature, and keep the original backup until a clean save cycle proves the repair.
What’s actually slowing this PC down?
Pick the symptom - the matching free tool is one click away.
Quick Recap
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.
