
GpuShift
Adaptive entity and particle render budgeting.
About this Mod
GpuShift
GpuShift is a client-side optimization utility for Minecraft 1.21.1.
It does not move all Minecraft CPU work to the GPU, replace the renderer, or guarantee higher FPS. Instead, it focuses on a small set of client-render tasks that can become expensive in some scenes, especially when there are many distant living entities or many cosmetic particles.
What It Does
- Adds adaptive client-side render budgeting
- Can skip some distant non-player living entity rendering under render pressure
- Can limit newly spawned cosmetic particles based on a configurable particle budget
- Protects important visuals such as players, named entities, glowing entities, close entities, weather particles, and known compatibility cases
- Includes an optional FPS/frame-time overlay
- Adds keybinds:
F8toggles the GpuShift overlayF9opens GpuShift settings
- Shows a one-time quick setup screen on first world/server join
- Detects common render stacks such as Sodium, Embeddium, and Oculus/Iris-style shader setups
- Includes compatibility safeguards for mods such as Pretty Rain and Tooltip Overhaul
What It Does Not Do
GpuShift does not optimize:
- Server TPS
- Mob AI
- Redstone or machines
- World generation
- Chunk loading
- Networking
- Memory usage
- Recipe loading
- The full Minecraft renderer pipeline
If your bottleneck is server-side logic, chunk generation, RAM pressure, shaders, or GPU load, GpuShift may show little or no visible FPS change.
Performance Expectations
GpuShift is most likely to matter in CPU-bound client-render scenes with many particles or distant living entities.
It may have little effect in lightweight scenes, already-optimized modpacks, or packs where another optimization mod is already handling the expensive render work.
The overlay can be used to check whether GpuShift is actively doing anything. If the skipped entity/particle counters stay at zero, then the current scene likely has little for GpuShift to budget.
Recommended Settings
Default Balanced settings are intended to be conservative.
Recommended particle budget:
70%for better visuals65%for balanced use55%for heavier packs where you are comfortable with fewer cosmetic particles100%disables GpuShift particle culling
Compatibility
GpuShift is designed to avoid hard dependencies.
Known/expected compatibility behavior:
- Sodium / Embeddium: detected automatically
- Oculus / shader stacks: shader assist is kept conservative
- Pretty Rain: weather particles are protected
- Tooltip Overhaul: armor tooltip preview entities are protected
- AsyncParticles or other particle render mods: use
100%particle budget if you want the other mod to fully control particles
If you find a visual issue, please report it with:
- Minecraft version
- Loader and loader version
- GpuShift version
- Modpack or mod list
latest.log- GpuShift config
- Screenshot or reproduction steps
Available Versions
How to Install GpuShift on Your Server
Order Server
Order a Minecraft Java server with at least 3 GB RAM (4 GB recommended).
Set fabric Loader
In the panel under "Egg", select the fabric loader and matching Minecraft version (1.21.1).
Install Mod
Open the mod browser in the dashboard and search for "GpuShift". Click "Install" – done! Alternatively, upload the .jar via SFTP to the /mods folder.
Compatibility
Mod Loaders
Minecraft Versions
1.21.1, 1.20.1
Server-side
✓ RequiredRecommended RAM
4 GB(min. 3 GB)Frequently Asked Questions
GpuShift server crashes on startup – what to do?
Most common cause: wrong fabric version or insufficient RAM. Check the server log (latest.log) for "OutOfMemoryError" or "Mixin" errors. With Mado Hosting: ensure at least 3 GB RAM is allocated and the loader matches the mod version (1.21.1). You can switch loaders with one click in the panel.
Is GpuShift compatible with fabric and forge and neoforge?
GpuShift officially supports fabric, forge, neoforge for Minecraft 1.21.1, 1.20.1. Note: Forge and Fabric mods are NOT cross-compatible – pick one loader and stick with it. The Mado dashboard automatically detects incompatible loader combinations.
Server lagging with GpuShift – how to optimize performance?
Recommended RAM: 4 GB (per 8 players). Use /spark profiler to check if GpuShift consumes the most tick time. Common fixes: reduce server view-distance to 8-10, install "performant" or "starlight" as supplementary mods on Forge. With Mado Hosting, your server runs on NVMe SSDs with dedicated CPU cores for minimal latency.
Similar Mods
Rent Modded Server
Install GpuShift with just one click on your server.