Vapor is a powerful optimization mod for Minecraft 1.21, designed to drastically improve server performance and tick rates by optimizing how the game handles entities.

Unlike other entity culling mods that simply remove mobs or break farm mechanics, Vapor employs intelligent dynamic tick scaling and sleep systems. This ensures your game runs smoothly even with thousands of active entities, without compromising on vanilla behavior or breaking complex mob farms.

Whether you are running a large dedicated server or a busy single-player world, Vapor works in the background to reclaim wasted CPU cycles from idle villagers, animals, and armor stands.

📥 Installation Guide

Vapor is available for Fabric Loader to ensure a lightweight and stable experience. To install, simply place the mod into your mods folder like any other mod.

Not sure how to configure the mod? Don't worry, you probably don't need to. By default, Vapor comes pre-tuned to provide significant performance gains immediately upon installation. It automatically detects when entities should be put into a low-frequency "sleep" mode and wakes them instantly when a player approaches.

Need even more performance? By design, Vapor focuses strictly on entity and mob logic. You should generally install this alongside other optimization mods, such as Lithium (for general game physics/logic) and Phosphor (for lighting engine fixes), to achieve the best possible tick rates. Vapor is fully compatible with these mods out of the box.

✅ Key Optimizations

Vapor achieves its performance gains through several non-invasive techniques:

Smart Entity Sleeping: Distant or inactive entities enter a low-CPU usage state, significantly reducing the server load in explored areas.
Villager AI Improvements: The complex "brain" updates for Villagers—including gossiping and profession tasks—are optimized to run faster while maintaining standard vanilla behavior.
Dynamic Scaling: The mod adjusts tick rates dynamically based on server performance and player distance, ensuring a stable TPS (Ticks Per Second) even under heavy load.

🐛 How to Report Issues

Please use the issue tracker to report bugs, crashes, and other issues. When reporting a problem, make sure to include information about the other mods you are using (such as Lithium or FerriteCore) and attach any crash reports or log files generated.

❓ Frequently Asked Questions

Can I customize the settings? Yes. While the defaults are designed for most users, server admins can fine-tune thresholds, whitelist specific entities, and debug optimizations using the /vapor status and /vapor optimize commands, or by editing the JSON configuration file.