Ck7 – Conatus

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):

License

All Rights Reserved.