Back to mods
PacketFixer project artwork

CurseForge · Minecraft mod

PacketFixer

A server-side Fabric mod (Minecraft 1.21.1, Java 21, v1.5.1, group com.packetfixer) that optimizes server→client network traffic.

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

Quick answer

Which PacketFixer release should I use?

Updated last month
Latest stable file packetfixer-1.5.1.jar
Game version 1.21.1
Loader Fabric

packetfixer-1.5.1.jar targets 1.21.1 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 PacketFixer 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 packetfixer-1.5.1.jar need?

packetfixer-1.5.1.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 PacketFixer without breaking your instance.

Built for packetfixer-1.5.1.jar. Pick another file and the loader, install side or required mods may change.

  1. 01

    Stick to this file

    Use packetfixer-1.5.1.jar. It targets 1.21.1 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 packetfixer-1.5.1.jar. It opens that exact file at the source.

About this project

What does PacketFixer add?

A server-side Fabric mod (Minecraft 1.21.1, Java 21, v1.5.1, group com.packetfixer) that optimizes server→client network traffic. It's a DedicatedServerModInitializer, so it only runs on the server. It does two things: prevents crashes/disconnects caused by other mods' packets, and reduces bandwidth, latency, and network CPU.

The modules

  1. Anti-disconnect for broken mod packets (ClientConnectionMixin) Inserts a handler into the Netty pipeline and intercepts exceptionCaught: if the error is an EncoderException containing custom_payload (i.e. a broken packet from some mod), it logs a warning and swallows it instead of kicking the player.

  2. Custom payload throttling (PacketThrottler + Config → config/packetfixer.json) Max 50 custom payloads per tick per connection; the overflow goes into a queue (max 500, oldest dropped) and is resent at the start of the next tick using batched writes + a single Netty flush. It has adaptive congestion control: as the queue grows, the "live" budget scales down (back-pressure) while the flush budget scales up. Ping-critical packets (position, velocity, block update, inventory, health, sounds) always bypass the throttle, and the cobblemon namespace is excluded by default — clearly to avoid breaking battle packets.

  3. Flush consolidation Adds a Netty FlushConsolidationHandler to merge multiple flushes into fewer syscalls, with an adaptive threshold based on player count (few players = low threshold = better ping; many = higher threshold = less CPU). A tick-end "flush pulse" makes sure nothing gets stuck sitting in the buffers.

  4. Packet optimizers (PacketOptimizerConfig → config/packetoptimizer.properties)

  • NBT stripper (EntityNbtMixin): removes server-only tags (Paper.Origin, Bukkit.updateLevel, etc.) and empty compounds
  • Chunk optimizer (ChunkDataMixin): same cleanup for block entities in chunk data
  • Lazy entity loader (LazyEntityTracker): entities beyond 16 bloy, but in batches of ~10 per tick
  • Entity update throttle (EntityTrackerEntryMixin): entities more than 48 blocks from all players only send position updates every 3rd tick (~66% fewer packets)
  • Compression tuning: forces the Deflater to level 1 via reflection (faster, slightly larger packets)
  • Packet monitor (PacketEncoderMonitorMixin): logs warnings/erroMB — useful for finding which mod is sending huge packets

A couple of things worth knowing

ClientConnectionMixin uses reflection on the compressor's Deflatgile part, and it fails silently (catch + debug log) if theNetty/MC internals change. And the swallowed exceptionCaught means that if a mod genuinely has a serialization bug, the packet vanishes without the client ever knowing — intended here, but it can mask real problems.

Project description from CurseForge.

Pick your setup

PacketFixer by Minecraft version and loader

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

1 available setups

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

Recent files

PacketFixer versions and loaders

1 of 1 releases match

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