Skip to content

Repository files navigation

SwiftFPS icon

SwiftFPS

A client-side Fabric mod that trims fps overhead on top of whatever renderer you use - vanilla or Sodium.

What it does

SwiftFPS doesn't replace the renderer or change vanilla mechanics. It's a collection of mixins that skip, throttle, or batch work that vanilla does unconditionally, even when nothing is looking at it.

  • Occlusion culling for entities, block entities (chests, signs, spawners...) and name tags - skips rendering things fully hidden behind terrain, independent of frustum culling
  • Distance/tick throttling for mob AI, entity pushing, item/XP orb merging, and beacon beam draw distance
  • Adaptive Performance Mode - auto-engages a lighter preset when fps drops, heap usage spikes, you go AFK, or entity counts blow up (mob farms, dupe piles), and releases it once things settle
  • Vertical render culling - caps how far the chunk visibility graph reaches above/below you, separate from your horizontal render distance (works with Sodium too, via an optional compat mixin)
  • Network tuning - flush consolidation, larger socket buffers, tunable compression level, and an experimental native libdeflate compression path
  • Unfocused window throttling - fills the gap vanilla's own fps limiter leaves (it only checks minimized, not unfocused)
  • A handful of smaller vanilla knob-turns: bigger light engine batches, coarser block-break particle density, animate-tick sampling budget, translucency sort budget

Every setting is configurable and most are on by default. Nothing here touches redstone, mob spawning, or any other simulation-affecting logic - it's fps and network only.

Requirements

  • Minecraft 26.2
  • Fabric Loader ≥ 0.19.3
  • Fabric API
  • Java 25+

Optional: Mod Menu + Cloth Config for an in-game config screen. Without them, edit config/swiftfps.json directly.

Sodium

SwiftFPS works standalone and doesn't need Sodium - most of its mixins (entity culling, throttling, network) apply either way. If you do have Sodium installed, a couple of features get an extra compat mixin to keep working since Sodium replaces vanilla's chunk rendering pipeline outright. Still, installing Sodium is the single biggest fps lever available; SwiftFPS just trims what's left on top of it.

Building from source

./gradlew build

The built jar lands in build/libs/.

License

CC0 1.0 - see LICENSE.

About

Client-side Fabric mod that trims fps overhead on top of vanilla or Sodium - occlusion culling, adaptive performance modes, and network tuning.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages