Ck7 - Conatus

A performance mod for Minecraft Forge 1.20.1 that cuts server and client overhead by scaling down work the player can't perceive — mob AI, particles, chunk-load spikes, and render resolution — instead of just capping settings globally. Every module has its own toggle and can be tuned or turned off independently from a single in-game config screen.

Built for large multiplayer worlds, villager halls, mob farms, and lower-end/integrated-GPU hardware.

Requirements

Minecraft 1.20.1
Forge 47.4.20 or newer
Optional: Cloth Config — enables the in-game config screen (Mods → Ck7 - Conatus → Config). The mod works fine without it; you just edit the .toml files in config/ directly instead.

Works on client, server, and singleplayer. Server-side modules (Mob AI Freeze, Villager Throttling, Ultra Load's server-side effects) don't require the mod on the client to function, but installing it everywhere gets you the client-side modules too (Particle Priority, Resolution Scale) and the config GUI.

Features

🧟 Mob AI Freeze

Freezes hostile mob AI (pathfinding, target selection, goal selector) outside a configurable radius around each player, using the same mechanism map-makers use for "NoAI" statues — no hacks, fully reversible, mobs resume normally the moment a player gets close again.

Configurable freeze radius (default 48 blocks)
Optional line-of-sight requirement, so mobs behind walls freeze even inside the radius — with an "always active" buffer radius so a zombie banging on your door never freezes mid-fight
Spawn grace period so freshly spawned mobs get a chance to disperse before freezing (avoids entity-cramming deaths at dense spawners)
Whitelist/blacklist by entity type or by mod ID, so you can exclude mods with their own AI management or entities with special mechanics (Warden is excluded by default)
Passive mobs are managed too by default (with line-of-sight easing) since profiling showed they cost roughly 2x an already-frozen hostile

🧑‍🌾 Villager Throttling

The same freeze mechanism, purpose-built for villager halls: freezes pathfinding, POI/job lookups, and Brain activity outside a configurable radius (default 32 blocks). Villagers unfreeze instantly the moment a player right-clicks them, so trading and restocking always feel responsive. Optional support for Wandering Traders.

✨ Particle Priority

Replaces vanilla's single global particle setting with smart, per-category prioritization instead of an all-or-nothing cutoff:

Combat, interaction/crafting, redstone, and ambient particles each get their own visibility radius
Ambient particles (rain, drip, spores, portal, etc.) respect the camera's view cone beyond a "close" radius, so things right next to you never vanish unnaturally
Particles near your last block-break/place/use/attack action get a temporary priority boost, so the feedback you're actively looking for is never the particle that gets dropped
Fully configurable particle-ID-to-category lists

📉 Resolution Scale

Renders the 3D world at a lower (or higher) resolution and stretches it to fill the screen — compatible with Sodium/Embeddium. Great for squeezing extra FPS out of integrated GPUs and lower-end hardware.

Scale from 0.25x to 2.0x (below 1.0 = more FPS, more pixelated; above 1.0 = supersampling, sharper but more expensive)
Linear or nearest-neighbor filtering
Changes apply instantly when you save in the config screen — no restart, no rejoining the world
Disabled by default; it's a newer module, so test it on your own setup before leaving it on

🚨 Ultra Load (panic mode)

Automatically detects heavy chunk-loading bursts (flying/sprinting through new terrain, big teleports, elytra flight) and temporarily shuts down everything that doesn't help chunks appear faster, freeing up CPU for world generation/meshing and GPU for terrain rendering. Everything restores automatically once the load settles, after a short cooldown so it doesn't flicker on and off.

Every effect has its own toggle, grouped by aggressiveness:

Tier 1 (safe): freeze all mob AI, pause natural spawns, pause random ticks (crop/grass growth, fire spread), hide particles, hide entity rendering
Tier 2 (aggressive): fully freeze non-player entity ticking (not just AI — movement/physics too), pause block entity ticking (hoppers, furnaces, spawners)
Tier 3 (experimental): pause scheduled ticks (redstone, fluid flow — nothing is lost, pending ticks just queue up and resume), temporarily reduce entity render distance, temporarily cap framerate (frees CPU for chunk generation on the render thread)

A configurable safe radius around every player exempts anything nearby from the entity-affecting effects, so nothing freezes or vanishes mid-fight right next to you.

🎛️ Master toggle & live config

One switch turns every module off at once, cleanly (each module's existing safe-shutdown logic runs, so nothing gets left in a frozen/broken state). All config changes made through the in-game screen take effect immediately — no restart or config-file watcher delay.

⚙️ In-game config GUI

With Cloth Config installed, every option above is editable from Mods → Ck7 - Conatus → Config — no digging through .toml files. Full tooltips on every option.

🌐 Translations

Available in English, Spanish, and Portuguese (Brazil), covering the config screen and all in-mod messages.

⚠️ Sodium/Embeddium heads-up

If Sodium, Embeddium, or Rubidium is detected, players get a one-time in-chat notice the first time they join a world (dismissible, with a "don't show again" option in the config screen).

Compatibility notes

Works alongside Sodium/Embeddium/Rubidium; the Resolution Scale module specifically accounts for their rendering pipeline.
The Resolution Scale module's core swap-the-render-target mechanism follows the approach pioneered by RenderScale by Zolo101; credit where due.
No known incompatibilities with other AI/optimization mods, but if you run something else that also manages mob AI, use the mod-ID blacklist in Mob AI Freeze to avoid the two fighting over the same entities.

Configuration

All config files live in config/ck7infinite-*.toml (edit directly, or use the in-game GUI):

File	Module
`ck7infinite-general.toml`	Master toggle
`ck7infinite-mobfreeze.toml`	Mob AI Freeze
`ck7infinite-villagerthrottle.toml`	Villager Throttling
`ck7infinite-particlepriority.toml`	Particle Priority
`ck7infinite-resscale.toml`	Resolution Scale
`ck7infinite-ultraload.toml`	Ultra Load