GpuShift

# 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: - `F8` toggles the GpuShift overlay - `F9` opens 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 visuals - `65%` for balanced use - `55%` for heavier packs where you are comfortable with fewer cosmetic particles - `100%` 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 Bug reports and compatibility issues: https://github.com/orferr/GpuShift-Issues "GpuShift Development Status Active development of GpuShift has ended. The mod will remain available, but no new features or Minecraft version ports are currently planned. Critical fixes may still happen, but there is no guaranteed support schedule. The main reason for this decision is that GpuShift has reached a point where further development is becoming increasingly unpredictable. The mod already modifies and redistributes a significant amount of Minecraft's rendering and performance-related workload, and additional optimizations are starting to affect different hardware configurations in very different ways. An optimization that gives a significant performance improvement on one system can provide little benefit, or even reduce performance, on another. Because of this, I can no longer predict the result of further changes with a sufficiently high level of confidence. At this stage, continuing to add more optimization systems is increasingly likely to result in a performance regression rather than an improvement. In other words, further attempts to push GpuShift beyond its current state are becoming more likely to produce a minus instead of a plus. Fixing this properly would require major architectural changes, extensive hardware-specific testing, profiling, and adaptive behavior. That would effectively mean rebuilding a large part of the project rather than continuing to develop the existing mod. GpuShift started as an experiment in pushing Minecraft optimization further, and I’m happy with what the project managed to achieve. Existing releases will remain available. Thank you to everyone who tested the mod, reported issues, shared benchmarks, and helped with its development."