net.minecraft.nbt.ReportedException: Loading NBT data

What this error means

The net.minecraft.nbt.ReportedException: Loading NBT data error indicates that the server has encountered corrupted data while trying to read a file in the NBT (Named Binary Tag) format. This usually occurs within player data files, level.dat, or specific chunk files, preventing the server from starting or a player from joining.

Causes

• Unexpected server crashes during a save operation.
• Disk space exhaustion on the host machine.
• Incompatible mods or plugins modifying NBT structures.
• Interrupted file transfers via SFTP.

How to fix it

On AwakeNode

1. Use the File Manager: Navigate to the File Manager in your panel. Locate the folder causing the issue (usually world/playerdata or world/region).
2. Identify the file: Check the latest log file in the logs/ directory to see which specific file is throwing the error.
3. Rename or remove: Rename the corrupted file (e.g., append .old to the filename) to force the server to regenerate a clean version. If the issue persists, open a Support ticket for further investigation.

On other hosts / manually

1. Check the logs: Open your latest.log file. Look for the file path mentioned in the stack trace immediately following the ReportedException error.
2. Backup your data: Always create a full backup of your server directory before deleting files.
3. Manual removal: Using an SFTP client (like FileZilla or WinSCP), navigate to the file path identified in the logs. Delete or rename the corrupted file.
4. Restart: Restart your server. If the file was a player data file, the player will lose their inventory; if it was a chunk file, that specific area of the world will regenerate.