DemonCore ☢️

DemonCore is a chunk loading and full-spectrum client/server performance suite.

Whether you're pushing a Create contraption across the map, flying an Aeronautics plane at full throttle, or just trying to keep your frame time steady in a busy base, DemonCore predicts what you need before you need it — loading chunks ahead of fast movement, trimming rendering work adaptively, and reacting to your hardware in real time so you don't hit lag spikes or empty voids.

🚀 Key Features

🧭 Predictive Chunk Loading

DemonCore watches the speed and heading of fast-moving entities and pre-loads the chunks ahead of them through vanilla's own ticket system, widening its lookahead cone the further out it predicts (to cover turns and drift). Duplicate requests are deduped against a rolling cache, the per-tick loading budget automatically scales down when the server is under load, and an overflow queue drops the oldest pending request rather than piling up unbounded.

🤫 Silent Chunk Tracking

Chunks that haven't changed in a while get marked "silent" and skip redundant mesh re-validation — freeing up CPU on distant, stable terrain — while anything within a chunk of you is always fully checked.

🌀 Seamless Dimension Transitions

Every dimension change automatically clears DemonCore's caches and resets its profilers, so a Nether or End trip never drags stale data with it or causes a lag spike the moment you arrive.

🎨 Adaptive Render Optimization

• Batch render coordinator merges draw calls that share a shader into fewer GPU submissions.
• Render region coalescer folds multiple render regions together to cut draw calls even further.
• Block entity culler hides distant tile entities with a cull radius that automatically shrinks when the screen gets crowded, and stretches back out when it's clear.
• Geometry cache skips recomputing pose and geometry for entities and block entities that haven't visibly changed since the last frame.
• Particle budget enforces a live-particle cap with distance culling and a smooth fall-off as you approach the limit, instead of a hard, jarring cutoff.

🧠 Live Performance Diagnostics

• Bottleneck detector tells you, in plain English, whether you're currently GPU bound, CPU bound (rendering), CPU bound (game logic), memory/GC bound, frame-cap limited, or balanced — plus one concrete setting to change.
• Frame spike protector tracks how often and how long your frame time spikes, and applies suppression to soften the impact.
• Predictive frame scheduler looks at your recent frame-time history and preemptively micro-sleeps when it predicts an overrun, smoothing out your 1% lows instead of just reacting after the fact.
• GC Stutter Guard samples the JVM garbage collector directly; when GC time or heap usage climbs too high, it automatically trims DemonCore's own caches to relieve the pressure before it turns into a freeze.

⚖️ Smart Hardware Balancing (RAM ⇄ GPU)

A feedback controller continuously compares your GPU wait time against your RAM headroom and adjusts how aggressively DemonCore caches geometry and chunk data — leaning harder on RAM when the GPU is the bottleneck, and backing off automatically as memory usage approaches its ceiling. This is the trade at the heart of DemonCore: a bit of extra memory for meaningfully smoother frame times, without needing a high-end GPU or the latest drivers.

🌋 VULCAN MODE

A dedicated override toggle for maximum performance. Vulcan Mode disables adaptive backpressure and multiplies chunk-loading budgets to their absolute maximum, using every bit of hardware you can throw at it.

⚠️ CRITICAL WARNING (READ CAREFULLY)

Much like the nuclear core it's named after: this mod is incredibly powerful, but it requires careful handling.

• Aggressive Resource Usage: DemonCore will aggressively consume RAM (and, to a smaller extent, CPU) to achieve its extreme loading speeds and adaptive optimizations. Use with caution on low-end hardware or budget servers with limited memory.
• Vulcan Mode Risks: When Vulcan Mode is active, all adaptive safety constraints are disabled. This can lead to game crashes, system instability, or thermal throttling if your PC cannot handle the load.
• Liability: This mod is for players who want to break the limits of the game. Use at your own risk!

🧩 Requirements & Compatibility

• Mod Loader: NeoForge (Version 21.1+)
• Minecraft Version: 1.21.1
• Compatibility: Works great with any vehicle or physics mod, particularly recommended for Aeronautics and Create.

💻 Minimum System Requirements

DemonCore leans on RAM instead of raw GPU or CPU power, and its live diagnostics adapt everything else to whatever hardware you actually have. That means it does not need a dedicated graphics card, a modern GPU, or up-to-date drivers — this optimization suite is built to work on old "potato" PCs too, not just gaming rigs. The main trade-off is memory usage, so make sure you have RAM to spare.

ℹ️ If your PC can run vanilla Minecraft with OpenGL 3.2 support at all, it can run DemonCore — no special drivers or dedicated graphics card required. The mod's real cost is RAM, not GPU horsepower. On very low-end machines, avoid Vulcan Mode and let the adaptive systems (bottleneck detector, GC Stutter Guard, block entity culler) do their job instead.

🐛 How to Report Issues

Found a bug, crash, or unexpected behavior? Help us fix it faster by following these steps:

1. Check existing reports first — look through the Issues tab on this page (or the linked GitHub repo, if available) to see if someone already reported it.
2. Open a new report including:
   • Minecraft version, NeoForge version, and DemonCore version
   • A clear description of what happened vs. what you expected
   • Steps to reproduce the problem
   • Your latest.log (and the crash report file, if the game crashed)
   • Whether Vulcan Mode was enabled at the time
   • What the Bottleneck Detector was reporting, if you have it
3. List your other installed mods if you're using a modpack — this makes conflicts much easier to diagnose.

⚠️ Please don't report issues that only occur when Vulcan Mode is enabled on hardware below the minimum spec — that mode intentionally disables all safety limits.