
Dimensions & structures · Java · Advanced
How to View, Trim, or Remove Custom Datapack Dimensions in Your World Save
Custom datapacks and mods often generate their own dimensions, which can bloat your world save size or cause loading errors if the datapack is later removed. This guide shows you how to locate custom dimension namespaces in your Java Edition world folder, inspect their terrain using our browser-based World Map Viewer, and safely trim or delete their region data. Because our tools run locally in your browser, your world files are never uploaded to any server.
What you need
- A Minecraft Java Edition world save folder or .zip archive
- Access to your system's file manager
- The World Map Viewer and NBT Editor on our site
- A complete backup copy of your world save
Step by step
1Back Up Your World and Locate the Dimensions Folder
Before altering any world files, duplicate your entire world save folder and store it in a safe location. Open your active world folder and look for a subfolder named dimensions. Unlike the vanilla Nether (DIM-1) and The End (DIM1) which sit in the root directory, all custom datapack dimensions are stored inside this dimensions folder, organized by namespace and then dimension name (for example, dimensions/custom_pack/sky_island).
Tip: If you aren't sure what a dimension is called, check the data folder inside the datapack itself to see what namespace it registers.
2Preview the Custom Dimension in the World Map Viewer
Open the World Map Viewer on our site and load your world by clicking to open your world folder or .zip file. Once loaded, use the dimension selector dropdown to switch from the Overworld to your custom namespace dimension (such as custom_pack:sky_island). Pan around the map and hover over generated areas to note the exact region coordinates (such as r.0.0.mca) of builds you want to keep versus empty explored terrain you want to trim.
Tip: Custom blocks from mods may render as missing or default colors, but vanilla blocks used by datapacks will render normally.
3Trim Unwanted Terrain Regions
To reduce your world's file size without deleting the whole dimension, navigate to your file manager and open dimensions/<namespace>/<dimension_name>/region. Inside, you will find .mca files corresponding to the region coordinates you identified in the World Map Viewer. Delete the specific .mca files for the empty areas you wish to prune, and do the same for the matching file names inside the poi and entities subfolders if they exist. When you next visit those areas in-game, Minecraft will freshly regenerate them using your current datapack rules.
4Completely Remove a Custom Dimension's Terrain
If you are uninstalling a datapack or want to completely reset a broken dimension, go to your world's dimensions/<namespace>/ folder and delete the entire <dimension_name> subfolder. If that datapack didn't add any other dimensions, you can delete the parent <namespace> folder as well. This immediately frees up disk space by removing all terrain, entities, and structures associated with that world layer.
Tip: Make sure no players are currently logged out inside the dimension you are deleting, or they may spawn inside solid blocks or the void.
5Clean Up the Dimension Registry in level.dat
Deleting the folder removes the chunks, but Minecraft may still expect the dimension to exist if it is still registered in your main save file. Open our site's NBT Editor, load your world's level.dat file, and expand Data -> WorldGenSettings -> dimensions. Locate the compound tag named after your custom dimension (for example, custom_pack:sky_island), delete that entry, and save the modified level.dat back into your world folder, replacing the original.
Tip: If you also removed the datapack from the datapacks folder, removing this NBT entry prevents 'missing dimension' warnings in the game logs upon startup.
How it works
Since Minecraft Java Edition 1.16, the game uses a data-driven dimension system. While the Overworld stores its region folder directly in the world root, and the Nether and End use legacy DIM-1 and DIM1 folders for backward compatibility, all custom dimensions follow a strict namespaced folder hierarchy: dimensions/<namespace>/<dimension_id>/.
Inside each custom dimension folder, the structure mirrors the main world folder. It contains a region folder for terrain chunks (.mca files), an entities folder for mobs and item frames, a poi folder for villager workstations and portals, and a data folder for dimension-specific raids or map data.
Furthermore, when a world loads a datapack with a dimension, Minecraft copies that dimension's generation settings into the level.dat file under the WorldGenSettings.dimensions compound tag. This is why simply deleting the region files or the datapack itself sometimes leaves behind ghost dimension entries until you clean the NBT data.
Common mistakes
- Deleting DIM-1 or DIM1 by mistake when trying to remove custom dimensions; those two folders are your vanilla Nether and End.
- Deleting a dimension folder while a player's Dimension NBT tag in playerdata still points to that custom dimension, which can cause crashes or suffocation on login.
- Removing the region (.mca) files to reset terrain while forgetting to delete the matching files in the entities folder, resulting in duplicated mobs or floating armor stands when chunks regenerate.
- Editing or deleting files while the world is currently open in Minecraft, which will corrupt the save as the game overwrites your changes from memory.
FAQ
Why does my deleted dimension keep coming back when I load the world?
If the datapack is still inside your world's datapacks folder (or the dimension is still listed in level.dat under WorldGenSettings), Minecraft will recreate the dimension folder automatically every time the world starts.
What happens to players who logged out inside a removed dimension?
If a dimension is completely unregistered and removed, Java Edition usually falls back to placing the player in the Overworld at their last exact coordinates, which can cause them to spawn underground or high in the air. Always move players to the Overworld before deleting a dimension.
Can I view modded dimensions in the World Map Viewer too?
Yes, modded dimensions use the exact same dimensions/<namespace>/<dimension_name> folder structure as vanilla datapacks, though non-vanilla blocks may appear blank or use fallback colors on the map.
By locating the dimensions/<namespace> folder, previewing regions in the World Map Viewer, and cleaning up level.dat, you can easily trim or completely uninstall custom datapack dimensions.