[📦] No Unused Chunks

[📦] No Unused Chunks


A Minecraft mod that reduces world size by discarding unused chunks.

Client OptimizationUtility

Created2 years ago
Updateda year ago

Follow Save
[📦] No Unused Chunks has been archived. [📦] No Unused Chunks will not receive any further updates unless the author decides to unarchive the project.
Host your Minecraft server on BisectHosting - get 25% off your first month with code MODRINTH.

Hello anyone potentially reading this. Given the very low demand for this mod, I have eventually decided that it is unfortunately no longer worth continuing to maintain this mod. Although disappointing for anyone potentially still using this mod, some of my "top" projects and new mod ideas also already take a lot of time and effort to maintain and work on, meaning it is next to impossible for me to direct my focus on mods that have "low demand". Below I will offer what I believe to be a helpful alternative to anyone needing help reducing their world sizes for latest game versions.

  • Aternos, also known as a free Minecraft server hosting service, has their own tool that they developed that serves the exact same purpose. The project is called "Thanos". However, keep in mind that this is only usable by those who are already experienced programmers and know how to install and use PHP and CLI. Click here to view the project.
  • For obvious reasons, not everyone is an experienced programmer who can just download "Thanos" and do what they gotta do. For this reason, I have made my own CLI script that uses Thanos, and that is "user-friendly". I have Windows and Linux versions of this script. All you have to do is run it, and the script will guide you through the process and do the world size reducing for you. Hopefully a useful alternative for anyone who might need it. Also, altho I made that script at the times of Minecraft 1.20.1, it should work fine on future versions. Up to what point I am unsure, but work on future versions up to some point it will. It may break one day, but, I have no idea when and if that will take place. Depends on Mojang I guess. Click here to view the script project.


Regarding 1.19.3 and going forward: Many changes were made to the game with the release of 1.19.3, and Mojang has stated that they may bring new features in "patch" (1.x.x) releases now, and not just "minor" (1.x) releases. As such, please avoid using this mod on versions it does not specify it supports, as it could lead to crashes and (possible?) damage to world files (depends on the Minecraft update).

This Minecraft mod reduces world size by discarding unused chunks.

Important: Please back-up your world if you are planning on using this mod on an already existing world. This mod shouldn't cause any issues, but it is still a good idea to back-up worlds, just in case.

How to use this mod:

  1. Go to the world selection screen
  2. Select a world of your choice
  3. Click on the "Edit" button
  4. Click on the "Optimize World" button
  5. There should be a checkbox called "Remove uninhabited chunks". Check it it.
  6. Click on "Create backup and Load". This will back-up your world just in case something goes wrong.
  7. That's it. It's best to also verify everything went to plan and that no data loss took place.

How well does the mod do?

I performed a few tests in Minecraft 1.18.2 by generating an 18x18 chunk area with 18 render distance in a few worlds with and without the mod. I then measured the world sizes after each chunk generation to see what the world size was after generating was done.

# Default (18x18) (100% unflag) (Seed: -4665624743998437880)
- Without mod: ~23.9 MB
- With mod:    ~14.4 MB
- Saved:       ~9.5  MB (-39.75%)
# Default (18x18) (100% unflag) (Seed: 2419730229291416458)
- Without mod: ~24   MB
- With mod:    ~14.4 MB
- Saved:       ~9.6  MB (-40%)
# Superflat (18x18) (no features) (no entities) (100% unflag) (Seed: idk)
- Without mod: ~15.5 MB
- With mod:    ~6.25 MB
- Saved:       ~9.25 MB (-59.7%)
# Amplified (18x18) (100% unflag) (Seed: -2757405298360622893)
- Without mod: ~25.5 MB
- With mod:    ~15.8 MB
- Saved:       ~9.7  MB (-38.04%)

Important notice:

  • The game keeps track of which chunks players have interacted with using a special variable called "InhabitedTime". Whenever a player enters a chunk or does something to a chunk, the value of "InhabitedTime" increases. The way this feature works is by going through every chunk in every region file of a given world, and removing all chunks whose "InhabitedTime" value is set to "0". This means that any and all chunks whose "InhabitedTime" is "0" will get removed. It is important to keep in mind that if you used a creative tool/mod/program to modify chunks without ever entering them as an in-game player and making changes to them manually, or if the game fails to keep track of "InhabitedTime", there is a high chance those chunks will get removed anyways. Always back up your worlds before doing this, and immediately make sure no chunks you needed somehow got removed.
  • If there are any issues/bugs or if you do spot this mod's feature removing chunks it isn't suppoed to remove, please let me know so I can see if something can be done to resolve it.

A showcase of removing unused chunks

This video (click on the image) shows how the mod can be used to remove "uninhabited" chunks to reduce world size:
No Unused Chunks showcase

CurseForge Modrinth

Project members



Technical information

Client side
Server side
Project ID