Back to mods
Magic Numbers project artwork

CurseForge · Minecraft mod

Magic Numbers

Turns values Minecraft hardcodes into server-side config: mob despawn distance, item despawn timer, experience drops and hunger rate — every knob off by default.

Choose a version Pick your version below, then grab the matching file.

Quick answer

Which Magic Numbers release should I use?

Updated last month
Latest stable file magicnumbers-0.1.0+mc26.1.2.jar
Game version 26.1, 26.1.1, 26.1.2
Loader Fabric

Magic Numbers magicnumbers-0.1.0+mc26.1.2.jar targets 26.1, 26.1.1, 26.1.2 with Fabric. The project page does not say whether this file belongs on the client, dedicated server, or both. No extra mods listed for this file.

Where it goes

Is Magic Numbers required on the client, server, or both?

The project page does not say whether this file belongs on the client, dedicated server, or both.

Client Source doesn’t say
Dedicated server Source doesn’t say
Loader for this release Fabric
Required install it here Optional supported, not mandatory Not supported do not install here Source doesn’t say do not assume

The source does not explicitly classify this release as client-only or server-only.

What else does Magic Numbers magicnumbers-0.1.0+mc26.1.2.jar need?

magicnumbers-0.1.0+mc26.1.2.jar. Change the file and its required mods may change too.

No extra mods listed for this file

This file does not list any required mods. Do not add a library just because a different file uses it.

This file does not list any required or optional mods.

Before you install it

Add Magic Numbers without breaking your instance.

Built for Magic Numbers magicnumbers-0.1.0+mc26.1.2.jar. Pick another file and the loader, install side or required mods may change.

  1. 01

    Stick to this file

    Use magicnumbers-0.1.0+mc26.1.2.jar. It targets 26.1, 26.1.1, 26.1.2 with Fabric; another release may have different loader, side or dependency requirements.

  2. 02

    Bring the mods it needs

    This file does not list any required mods. Do not add a library just because a different file uses it.

  3. 03

    Put it on the correct side

    The project page does not say whether this file belongs on the client, dedicated server, or both.

  4. 04

    Pick the file you checked

    Use the “Get this file” button beside magicnumbers-0.1.0+mc26.1.2.jar. It opens that exact file at the source.

About this project

What does Magic Numbers add?

Magic Numbers

Minecraft hardcodes a lot of numbers. Items vanish after exactly five minutes. Mobs disappear at exactly 128 blocks. Experience and hunger run at exactly the rate the game shipped with. None of that is exposed in server.properties or in a gamerule — it lives in the code.

Magic Numbers turns those constants into server-side config.

Every knob is off by default

Installing this mod changes nothing until you opt in. Each section has its own enabled flag, and a section that is switched off is ignored entirely, whatever its values say. Drop it into a pack, ship it, and it stays inert until somebody flips a switch on purpose.

What you can change

Setting Vanilla What it does
mobDespawn.instantDespawnDistance 128 Beyond this many blocks from the nearest player, mobs despawn immediately
mobDespawn.randomDespawnDistance 32 Inside this radius mobs never despawn; between the two they despawn randomly
itemDespawn.despawnTicks 6000 How long a dropped item survives on the ground (20 ticks = 1 second)
experience.dropMultiplier 1.0 Scales every experience award
hunger.exhaustionMultiplier 1.0 Scales hunger gain; below 1.0 means players get hungry slower

Config

Generated at config/magicnumbers.json on first start.

{
  "mobDespawn": { "enabled": false, "instantDespawnDistance": 128, "randomDespawnDistance": 32 },
  "itemDespawn": { "enabled": true, "despawnTicks": 24000 },
  "experience": { "enabled": false, "dropMultiplier": 1.0 },
  "hunger": { "enabled": true, "exhaustionMultiplier": 0.5 }
}

The example above keeps dropped items around for 20 minutes instead of 5, and makes players get hungry half as fast. Everything else stays vanilla.

A malformed config file never takes the server down: the error is logged and the mod falls back to doing nothing.

Server-side, and nothing else

  • No client install. Players join with a plain Fabric client, or no mod at all.
  • No Fabric API dependency. The mod ships four mixins and a config reader, nothing more.
  • No new items, blocks, recipes or worldgen. Nothing to conflict with.
  • 12 KB.

One thing worth knowing about mob despawn

Vanilla is not uniform here: fish (water_ambient) despawn at 64 blocks while every other category uses 128. instantDespawnDistance applies one value to all categories, so raising it stretches fish further than the vanilla ratio intends. On a world with large oceans, that means more entities loaded. Worth keeping in mind if you turn this knob up.

Requirements

  • Minecraft 26.2
  • Fabric Loader 0.19.3 or newer
  • Java 25

License

MIT. Bundle it in your modpack, no permission needed.


Support

This mod is free and always will be. I build and maintain it in my spare time.

If it helps you, consider buying me a coffee. Every contribution - no matter how small - buys more time for updates, new features and keeping things working after each patch.

Support me

Links

Found a bug or got feedback? Use the comments section here on CurseForge.

Project description from CurseForge.

Pick your setup

Magic Numbers by Minecraft version and loader

Choose the version and loader you play, then open the matching release.

4 available setups

Check the dependencies, then try the file in a copied instance before changing a world you care about.

Recent files

Magic Numbers versions and loaders

2 of 2 releases match

Looking for an older file? The official CurseForge project page is in Resources.