promotional bannermobile promotional banner
premium banner

Superionic

An all-in-one optimization suite that boosts FPS and eliminates stutters by revamping Minecraft’s rendering and logic. Fully customizable settings allow you to toggle GPU, CPU, and memory enhancements to perfectly match your hardware.

Description

Superionic Banner

A high-performance client-side optimization suite for Minecraft, engineered for rendering efficiency and tick-cycle stability.

Version License Environment Discord CurseForge Modrinth

Superionic is a client-side optimization framework designed to modernize Minecraft's rendering pipeline and reduce internal logic overhead. By targeting specific bottlenecks in the CPU-to-GPU communication and the Java Virtual Machine's memory allocation patterns, Superionic provides a significant increase in frame consistency (1% lows) and overall rendering throughput.

🏗️ Architectural Overview

Superionic operates by injecting modular optimizations into the core engine via the Mixin bootstrap. It avoids invasive changes to world geometry (chunks) and instead focuses on the ephemeral data flow: entity extraction, particle processing, block entity rendering, and network packet handling.

Our primary goal is State Consolidation: identifying redundant operations and suppressed state changes to allow the hardware to operate at higher efficiency.

🛠️ Optimization Categories

1. Rendering & GPU Efficiency

Focus: Reducing draw call counts and driver-level state switches.

  • 🚀 Render Pipeline Batching: Intercepts BufferSource.getBuffer() to suppress endBatch() calls between compatible RenderType objects. This allows thousands of individual triangles to be consolidated into a single GPU buffer submission.
  • 🧍 Entity Type Sorting: Re-orders the visibility list after extraction to group entities by their internal type hash. This ensures that the batching system can process identical models/textures consecutively, minimizing state switches.
  • 🍃 Optimized Leaf Rendering: Implements a highly efficient "Fast Leaves" path that performs actual face culling between adjacent leaf blocks. By treating leaves as opaque during the skip-render check, we eliminate hundreds of redundant faces in forest biomes.
  • 📦 Fast Chest Rendering: Provides a simplified rendering path for ChestBlockEntity. By disabling animation interpolation and lid openness checks at long ranges, we reduce the vertex processing cost of storage rooms.
  • 💨 Particle Culling: Injects a frustum-check during the ParticleEngine extraction phase. Off-screen and distant particles are skipped before they reach the vertex-processing stage. Max distance is user-configurable.

2. Logic & Tick Precision

Focus: Reducing CPU-side "math" overhead per tick.

  • 🤖 AI Pathfinding Throttling: Mobs beyond a configurable radius of the player have their update frequency reduced. This preserves world behavior while slashing the CPU time spent on pathing calculations.
  • 👥 Entity Shadow Culling: Shadows are computation-heavy. Superionic disables shadow calculations for distant entities, maintaining nearby immersion while freeing up CPU cycles. Both distance and throttling intensity are fully adjustable.

3. Memory & JVM Performance

Focus: Minimizing Garbage Collection (GC) impact.

  • 🧹 Allocation Reduction: Targets hot code paths in EntityRenderDispatcher to skip temporary PoseStack and Matrix4f allocations for entities that are strictly not visible or too far away. This leads to fewer GC pauses and smoother frame delivery.

4. Network & Multiplayer

Focus: Streamlining data flow and packet handling.

  • 📡 Network Tuning: Adjusts the setupCompression threshold to 512 bytes. This heuristic skip prevents the CPU from wasting cycles attempting to compress small packets that often result in minimal bandwidth savings or even negative compression ratios.

📈 Evidence & Benchmarking

Benchmarking Methodology

We evaluate Superionic using a combination of Draw Call Monitoring and Frame Time Analysis.

  1. Draw Call Reduction: In a synthetic test world with 500 interleaved Pigs and Sheep, Superionic demonstrates a 45% reduction in total OpenGL/Vulkan draw calls due to sorting-aware batching.
  2. GPU Throughput: By implementing face culling in LeavesBlockMixin, we have measured a direct reduction in the Geometry Render Pass time by up to 20% in jungle biomes (tested at 32-chunk render distance).
  3. CPU Frame Time (1% Lows): AI Throttling and Shadow Culling lead to a measurable increase in frame-to-frame stability on CPU-limited systems (e.g., Ryzen 1000/2000 series).

⚙️ Configuration

Superionic is fully configurable. Settings are stored at .minecraft/config/superionic.json or can be adjusted via the Mod Menu integration.

Configuration Key Default Area Description
batchRendering true GPU Consolidates and suppresses buffer flushes
entitySorting true GPU Groups identical entities for better batching
fastLeaves false GPU Aggressive face culling for leaf blocks
fastChestRendering true GPU Skip animations for storage blocks
aiThrottling true Logic Reduces distant mob AI update frequency
aiThrottlingDistance 64 AI Radius (blocks) before AI throttling starts
aiThrottlingRate 4 AI Frequency of AI updates for distant mobs
particleCulling true GPU Skips off-screen particle processing
particleCullingDistance 64 GPU Radius (blocks) for particle visibility
entityCullingDistance 128 GPU Radius (blocks) for full entity visibility
shadowCullingDistance 64 GPU Radius (blocks) for entity shadows
entityShadowCulling true Logic Disables shadows for distant entities
reduceAllocations true Memory Skip temporary object creation in hot paths
packetCompressionTuning true Net Optimize compression for better CPU balance

📊 Performance Evidence & Benchmarking

Superionic includes a built-in telemetry system to prove and measure its efficiency.

Real-Time Metrics (superionic_bench.csv)

While playing, the mod automatically logs optimization statistics every 60 seconds to your Minecraft directory at: .minecraft/config/superionic_bench.csv

Tracked Metrics:

  • SuppressedFlushes: Total OpenGL state changes prevented by the Batching engine.
  • CulledParticles: Number of off-screen particles that were skipped before vertex processing.
  • CulledShadows: Number of distant entity shadows that were not computed.
  • CulledLeafFaces: Geometry faces omitted due to advanced leaf culling logic.
  • SkippedAiTicks: CPU cycles saved by throttling distant mob logic.

This CSV file serves as definitive evidence for Modrinth and performance audits, showing exactly how many hardware-level operations Superionic has saved during your play session.

🧱 Compatibility & Installation

Superionic is built on modern standards (Java 21) and is designed to be highly compatible.

  • Mod Compatibility: Designed to work alongside Sodium, Iris, and Lithium. Superionic focuses on layers above chunk rendering (Sodium) and below world-logic (Lithium).
  • Client-Side Only: Do not install this on servers. It only affects the local rendering and processing pipeline.

Building from source:

git clone https://github.com/yigit-guven/Superionic.git
cd Superionic
./gradlew build

⚖️ License

Superionic is released under the GNU General Public License v3.0.

Built with ⚡ by Yigit Guven.