Potato Runtime

Potato Runtime is a Minecraft performance mod built to make chunk loading and movement through heavily modded worlds feel smoother — especially on weaker hardware.

Instead of throwing every available CPU thread at the problem and hoping for divine intervention, Potato Runtime tries to do the right work at the right time.

It prioritizes terrain around the player, reacts to movement and viewing direction, limits expensive background work when the game is under pressure, and adapts its behavior to the hardware it is running on.

The goal is simple:

Less waiting for chunks. Fewer unnecessary stalls. Better use of the hardware you already have.

And yes, ideally even if your PC is spiritually closer to a root vegetable than a workstation.

---

🥔 What does Potato Runtime improve?

Potato Runtime focuses mainly on the work involved in getting chunks from Minecraft's world data to something you can actually see on screen.

It includes:

• smarter chunk and mesh scheduling
• multithreaded chunk preparation
• movement-aware chunk prioritization
• predictive loading in the direction you are travelling
• better handling of sudden turns and returning to recently visited areas
• adaptive upload pacing to reduce frame-time spikes
• hardware-aware limits for weaker CPUs and GPUs
• safeguards against background work overwhelming the game

Potato Runtime does not secretly reduce your render distance, change world simulation, or perform dark rituals on your settings menu just to make an FPS counter look prettier.

---

⚙️ Three simple modes

Potato Runtime intentionally keeps its public settings simple.

DYNAMIC — Recommended

Automatically adapts Potato Runtime to your hardware and current workload.

This is the mode most players should use.

In other words: turn it on and let the potato think.

ON

Keeps Potato Runtime enabled, but without some of the dynamic behavior.

Useful if you prefer a more consistent configuration or simply do not trust vegetables with decision-making authority.

OFF

Disables Potato Runtime's performance systems and lets the rest of your modpack take full control.

This is also useful for troubleshooting and A/B comparisons.

If Sodium is installed, Potato Runtime integrates directly into Sodium's Video Settings menu.

No separate twelve-tab control panel. No hidden "Advanced Potato Matrix" submenu.

---

🧪 Testing

Potato Runtime 0.9.0 was tested on low-end laptop hardware and in a heavily modded Minecraft 1.21.1 setup with roughly 150 active mods.

The test environment included mods such as:

• Sodium
• Iris
• Voxy / Roxy
• ImmediatelyFast
• EntityCulling
• Create and several Create addons
• Applied Energistics 2
• large biome and world-generation mods
• multiple structure mods

Repeated A/B testing showed that Potato Runtime enabled felt smoother and allowed chunks to keep up better than with Potato Runtime disabled.

This is currently a qualitative result.

Potato Runtime does not claim a specific "X% more FPS" number yet, because inventing a percentage and putting a lightning bolt next to it would be marketing, not benchmarking.

More formal frametime testing is planned for a future update.

---

🔬 Research-informed

Potato Runtime is a research-informed engineering project.

Several parts of its design were inspired by research into parallel scheduling, latency-sensitive systems and large-scale rendering.

Some of the papers that influenced the project include:

Scheduling Multithreaded Computations by Work Stealing
Robert D. Blumofe & Charles E. Leiserson
https://doi.org/10.1145/324133.324234

Adaptive Work-Stealing With Parallelism Feedback
Kunal Agrawal, Charles E. Leiserson, Yuxiong He & Wen-Jing Hsu
https://doi.org/10.1145/1394441.1394443

Work Stealing for Interactive Services to Meet Target Latency
Jing Li et al.
https://doi.org/10.1145/2851141.2851151

Visibility-Based Prefetching for Interactive Out-of-Core Rendering
Wagner T. Corrêa, James T. Klosowski & Cláudio T. Silva
https://doi.org/10.1109/PVGS.2003.1249035

Geometry Clipmaps
Frank Losasso & Hugues Hoppe
https://doi.org/10.1145/1015706.1015799

These papers inspired parts of the design, but Potato Runtime does not claim to reproduce them exactly or inherit their theoretical guarantees.

Reading papers is useful.

Pretending a DOI automatically gives +40 FPS is less useful.

---

🖥️ Vulkan

Potato Runtime contains ongoing Vulkan renderer research.

However, Vulkan is not the active gameplay renderer in Potato Runtime 0.9.0.

The current release uses a safe OpenGL compatibility path when necessary and will fall back instead of enabling an incomplete renderer and turning your world into experimental modern art.

Vulkan development will continue in future versions.

---

✅ Recommended setup

For most players:

Use DYNAMIC.

Install Potato Runtime alongside your usual performance mods and let it adapt to your system.

If something behaves strangely, switch Potato Runtime to OFF and compare.

That is exactly why OFF exists.

Not every bug needs an exorcism. Sometimes you just need an A/B test.

---

🥔 Why "Potato Runtime"?

Because the target is simple:

Minecraft should run on potatoes too.