

Modrinth · Forge
PaperFixes on your Minecraft server
PaperFixes runs on Minecraft servers with Forge. Order your server, set the loader in the panel and install the mod with one click in the mod browser.
A collection of bug and performance fixes from CraftBukkit, Spigot, and Paper in a Forge mod.
- Downloads
- 5.9K
- Author
- Elephant1214
- Loader
- Forge
- Minecraft
- 1.12.2
- Updated
- –
Setup
Install PaperFixes on your server
The server and players need the same loader and Minecraft version. Back up the world before adding or updating mods.
- 01
Configure
4 GB of RAM is preselected. You choose the term and add-ons and pay by credit card or PayPal.
- 02
Set the loader
In the panel, set the server software to Forge and choose the matching Minecraft version, for example 1.12.2.
- 03
Install the mod
Search the mod browser for “PaperFixes” and install the release for your loader. Alternatively, upload the .jar to the mods folder via SFTP. Required dependencies are listed on the project page.
- 04
Connect
PaperFixes is optional on the client. Players connect using the server address from the panel.
- On the server
- Optional
- On the client
- Optional
- Loader
- Forge
- Minecraft
- 1.12.2
- License
- LicenseRef-GPL-3.0
The panel
Install mods, find errors.
Real screenshots from the Mado panel. Both come with every Minecraft server.
Mod browser
Modrinth and CurseForge, right in the panel.
The browser filters by your Minecraft version. Install mods with one click, without uploading .jar files.

AI crash analysis
When a mod crashes, the analyzer reads the log.
Mods often fail on a wrong loader version, Java version or missing dependency. The analyzer names a likely cause and suggests a fix.

Releases
Published releases
Pick the file that matches your server’s loader and Minecraft version. The server and players need the same release.
PaperFixes · ModrinthOriginal description by the project author
PaperFixes
A collection of bug and performance fixes from CraftBukkit, Spigot, and Paper in a Forge mod.
This is a performance mod, and bugs and incompatibilities could occur. Please open a GitHub issue if you find any.
Current Fixes and Features
Bugfixes
avoidItemMergeForFullStacks- Skips merging checks for full item stacks before bounding box check.clearPacketQueue- Clears player packet queue on disconnect to prevent memory leaks.explosionsIgnoreDeadEntities- Excludes dead entities and untargetable players from explosions.fixMc54738(MC-54738) - Limits biome weight variable to fix terrain spikes.fixMc80966(MC-80966) - Ensures empty subchunks send data to clients.fixMc98153(MC-98153) - Prevents rubber-banding and suffocation in nether portals.fixMc133373(MC-133373) - Resets NaN attribute values.fixShulkerDispenseCrash- Prevents crash when placing non-empty shulker box via dispenser at height limit.fixShulkerDupe- Fixes duplication from shulker box tile entity not being removed.fixWaterMobSpawnCheck- Ensures water mobs spawn inside water with space.dontOffloadBeaconColorUpdate- Avoids unnecessary thread hopping for beacon updates.handleNullTileCrashes- Logs null tile entities instead of causing more problems.removeInvalidMobSpawners- Removes broken mob spawners that don't exist.sortEnchantments- Sorts enchantments by ID to ensure identical items are treated the same.
Client
-
cacheLastChunk- Because Minecraft accesses the same chunk from the chunk provider multiple times in one frame, we can cache the last one accessed. This doesn’t usually have a big effect on the client, but flying around and loading chunks can be a little faster when many operations are done per chunk. -
fastWorldBorder- Disabled on the client (including the internal server) by default because animations for border movement don’t work correctly, causing the border to snap to the end position when the countdown ends. If you don’t care about this, you can enable world border caching for the client and internal server.
Features
-
spawnChunkGamerule- Enables thespawnChunkRadiusgamerule. Lets you define a spawn chunk radius for your world or server, similar to modern Minecraft, but with a few differences. In Minecraft 1.12, chunk tickets didn’t exist, so spawn chunks are a fixed 16×16 section always loaded and ticked. Entities inside are only processed in a smaller 12×12 area, because entity AI requires a 5×5 loaded area. PaperFixes uses a consistent diameter by centering on the chunk containing spawn, unlike vanilla which can make it 17×17 if spawn is centered in a chunk. Setting this gamerule to0completely disables spawn chunks. -
spawnChunkRadius- Sets the default spawn chunk radius for the above feature. Applies only to new worlds or worlds not yet run with PaperFixes 2.0.0-beta.1 or newer. Values can range from 0 to 32, where 0 disables spawn chunks entirely and 32 gives a 64-chunk diameter. -
improvedTickLoop- Measures time in nanoseconds instead of milliseconds for better accuracy, usesLockSupport.parkNanosfor precise sleeps, and adapts sleep time depending on tick length. Runs ticks as fast as possible when the server is more than 2.5 seconds behind, spinning instead of sleeping near the start of the next tick to avoid oversleeping. -
tickLoopSpinTime- Controls how long (in nanoseconds) the server tick loop will spin instead of sleeping. Also affects when the loop stops running scheduled tasks during what would normally be sleep time. -
runTasksDuringSleep- Allows the tick loop to run scheduled tasks instead of idling during sleep periods. -
fastWorldBorder- Caches the corners of the world border to make calculations faster instead of recomputing them each time.
Performance
-
ioThreadSleep- Controls how long the world save thread sleeps. By default in PaperFixes, it doesn’t sleep at all to avoid rare memory and saving issues. If enabled, it sleeps for 2 ms instead of the usual 10 ms. Best left disabled unless you have a specific reason. -
cacheBlockDensities- Caches block density values so explosions don’t need to re-check the same block data repeatedly. -
cacheLastChunk- Caches the last chunk accessed from the chunk provider within a tick, avoiding repeated lookups. -
compactLut- Uses a smaller, faster lookup table for sine and cosine calculations. Thanks to jellysquid3 and ruViolence. -
fastChests- Runs chest open/close animations only when needed, instead of every tick. -
smartRegionRead- Reads the entire region file header at once for faster world loading and fewer potential issues. -
fastEntityDataMap- Stores and looks up entity data with a faster hash map. -
optimizePathfinding- Improves pathfinding by skipping repeated or impossible paths. -
optimizedTaskQueue- Uses a faster queue implementation for scheduled tasks. -
pathingChunkCache- Tracks the chunk an entity is moving through with a quick 1D cache. Thanks to jellysquid3 and ruViolence. -
pathNodeCache- Saves pathing data so the same blocks aren’t recalculated repeatedly. Thanks to jellysquid3 and ruViolence. -
queueChunkSaving- Saves chunks gradually over time instead of all at once, reducing server pause time during saves. -
trimRegionCache- Unloads only the least-used regions instead of all at once, preventing immediate reloading of active regions. -
sharedRandomForEntities- Uses a shared random number generator for all entities rather than creating a new one for each.
Known Incompatibilities
- The improved tick loop is not compatible with the
mixin.bugfix.slow_tps_catchupoption from
VintageFix (removed as of
commit ecbc3e1 and no longer in the latest release) and the
tick loop changes from Forged Carpet and likely from any other mod. - Bad core mods can cause re-entry errors and crash the game as soon as it starts. This is not PaperFixes' fault and is
unavoidable because these mods are loading game classes too early. The only solution is to replace them with a fork
that fixes the problems.
An incomplete list of problematic core mods and solutions:- Quark: Replace
with Quark: RoTN Edition (Thanks to
sahih_international for finding this)
- Quark: Replace
PaperFixes server crashes on startup – what to do?
Common causes: the loader or Minecraft version does not match the mod file, a dependency is missing, or RAM is too low. Check the log (latest.log) for “OutOfMemoryError”, “Mixin” or missing mods. At Mado, the AI crash analysis reads the log and suggests a cause. You can change the loader and version in the panel.
Which loader does PaperFixes run on?
According to Modrinth, PaperFixes supports Forge for Minecraft 1.12.2.
How much RAM does a server with PaperFixes need?
As guidance, 3–4 GB for a server with this mod. This is an estimate, not a measured minimum. More mods, many players and long view distances need more. The spark profiler shows whether a mod is costing tick time.
Similar mods
Popular mods in the same category
Server-ready
YetAnotherConfigLib (YACL)
by isxander
A builder-based configuration library for Minecraft!
Server-ready
Text Placeholder API
by Patbox
Placeholder and Text manipulation library for your Minecraft mods.
Client only
Dynamic FPS
by juliand665
Reduce resource usage while Minecraft is in the background, idle, or on battery.
Server-ready
No Chat Reports
by Aizistral
Makes chat unreportable (where possible)
Ready for your server with PaperFixes?
4 GB of RAM from €8.00 per month. 35% off your first month with MADO35.
