Ingenium

!(https://cdn.modrinth.com/data/cached_images/3b8296c754e62032ce78159d2a6329c7cf3e2d98.png)

A dynamic, hardware-aware performance mod for Minecraft 1. 20. 1 — Fabric.

## So what is Ingenium?

Most performance mods apply the same static optimizations to every machine, every world, every situation. Ingenium takes a different approach: it monitors your JVM and server metrics in real time and shifts between optimization profiles on the fly — keeping your server at 20 TPS without you needing to configure anything.

It covers both client and server performance in a single mod, and is designed to stack with Sodium, Lithium, and FerriteCore rather than replace them.

## Performance Comparison

The screenshots below show FPS with Sodium(plus ferrite core, c2me, and lithium) versus Sodium paired with Ingenium(including previous mods mentioned), tested in the same scene.

!(https://cdn.modrinth.com/data/cached_images/6c33d80839cab59a85b51ced5660121075adad02.webp)

!(https://cdn.modrinth.com/data/cached_images/d4c60c66a64de2defbced8513791f5ab422c76c8.webp)

Sodium + Ingenium

!(https://cdn.modrinth.com/data/cached_images/cc8c23a73cfd2e7f35879122f357603af092b4bf.webp)

!(https://cdn.modrinth.com/data/cached_images/41cfacdc1f1457dc2d7b3f1c6f23de46b68aba6a.webp)

## ⚠️ Alpha Notice

Ingenium is currently in alpha. Core systems are working, but you may encounter rough edges, unexpected crashes, or unusual behavior. Back up your worlds before installing.

If something goes wrong, please open an issue on (https://github.com/Tunact124/ingenium/issues) — every report directly helps development.

!(https://cdn.modrinth.com/data/cached_images/7fac49b32dd855b5d8a502835d2e1cb037015f4a_0.webp)

## Features

### 🔁 Adaptive Performance Governor Ingenium's core system monitors live server MSPT and shifts between four profiles automatically:

• Balanced — default, minimal interference
• Reactive — activates when TPS starts to dip
• Aggressive — heavy intervention under sustained load
• Emergency — last-resort stabilization

Each profile controls how aggressively subsystems like render distance, block entity budgets, and chunk priority are managed. No manual configuration required — Ingenium probes your hardware on startup (processor count, heap size, throughput) and calibrates accordingly.

### 📉 Adaptive Render Distance When the server is struggling, Ingenium automatically steps down your render distance to recover headroom, then gradually restores it once load stabilizes. The full state machine: `STABLE → REDUCING → REDUCED → RECOVERING → STABLE`. Your configured render distance is always fully restored once performance is healthy.

### 🧱 Entity Backface Culling Polygon-level culling for entity models — geometry that isn't facing the camera is skipped entirely before it reaches the GPU. Produces measurable FPS gains in areas with many entities, with no visual difference.

### ⏱️ Timing Wheel Scheduler Replaces vanilla's block and fluid tick scheduler with a timing wheel — a data structure purpose-built for high-volume time-ordered scheduling. Only activates when Lithium is not installed, so there is no overlap if you use both. Particularly effective in worlds with large numbers of active blocks.

### 🌍 SIMD-Accelerated World Generation Uses Java's Vector API to run noise interpolation across multiple values simultaneously. On Java 21+ this works automatically. On Java 17, add `--add-modules jdk.incubator.vector` to your JVM flags, or Ingenium will fall back to scalar math automatically with no breakage. Does not alter terrain output.

### 🗃️ Off-Heap Block Entity Storage Moves block entity metadata off the JVM heap using direct memory allocation. Reduces GC pressure and the frequency of GC pauses — especially noticeable in worlds with many block entities like chests, furnaces, and hoppers.

### ♻️ GC-Adaptive Scheduling Monitors the JVM's garbage collector MX beans in real time and coordinates with the governor to avoid scheduling expensive work during or immediately after a GC cycle.

### 🗺️ Dimension Cache Snapshots block entity and cache state when you leave a dimension, then restores it when you return — so frequently visited dimensions don't have to rebuild from scratch every time. Caches are evicted automatically if they get too old.

### 📦 Chunk Priority Engine Prioritizes chunk loading and generation work based on player position and movement, so the chunks that matter most get processed first.

### 🔌 Network Buffer Pooling Pools `FriendlyByteBuf` network packet buffers to reduce allocation pressure on the packet pipeline — fewer short-lived objects, less GC churn from network traffic.

### 🔧 Additional Optimizations - Hopper throttle — intelligent cooldown scheduling for hoppers under load - XP orb coalescing — merges nearby XP orbs to reduce entity count - POI spatial cache —