Ck7 - Conatus (mod id: ck7infinite) Minecraft Forge 1.20.1 · Version 2.2.0

WHAT IT IS

Ck7 - Conatus is a performance/optimization mod for Minecraft Forge 1.20.1. It targets the two biggest real-world FPS/TPS killers on modest hardware (especially laptops with integrated graphics): server tick cost from mob and villager AI, and client render cost from particles and resolution. It does not touch world generation, gameplay balance, or add any new items/blocks/mechanics — every module is a background optimization that can be tuned or switched off independently.

It ships as six independent modules, each with its own config file, plus one master switch that disables all of them at once. If the optional mod Cloth Config is installed, all settings are also editable from a normal in-game GUI (Mods menu -> Ck7 - Conatus -> Config); without it, the mod still works exactly the same, just configured by hand via the .toml files. The GUI and all in-game chat messages are translated into English, Spanish, and Brazilian Portuguese.

---

1. MOB AI FREEZE

---

Server-side. Freezes the AI (pathfinding and goal selector — the systems that decide what a mob does and how it walks toward it) of hostile mobs once they are farther than a configurable radius from every player. Frozen mobs stop thinking and pathing but are not removed, hidden, or despawned — they simply stand still until a player gets close again.

• Freeze radius (default 48 blocks), independent of vanilla's own simulation distance setting.
• Optional line-of-sight requirement: a mob inside the radius but fully blocked from view by terrain (e.g. in a cave under the player) also freezes, unless it's within a smaller "always active" inner radius — this stops mob-farm spawner towers from softlocking while still freezing AI for mobs the player genuinely can't see or reach.
• Configurable re-evaluation interval (how often distance is rechecked per mob) to trade reaction speed for CPU overhead.

---

1. VILLAGER THROTTLING

---

Server-side. The same idea as Mob AI Freeze, but specifically for Villagers (and optionally Wandering Traders) — their pathfinding, POI lookup (bed/job-site searching) and "brain" activity are frozen outside a configurable radius around each player. This is aimed at large villager halls/trading rooms, which are one of the worst tick-cost offenders in a base once villager counts climb into the dozens.

• Throttle radius (default 32 blocks).
• Villagers unfreeze instantly on right-click interaction (so trading never feels laggy) even if still outside the radius, instead of waiting for the next scheduled re-check.
• Configurable re-evaluation interval, same trade-off as Mob AI Freeze.

---

1. PARTICLE PRIORITY

---

Client-side, purely visual/local to each player. Instead of an all-or-nothing particle slider, particles are bucketed by what they mean gameplay-wise and each bucket gets its own always-show radius:

• Combat particles (default 48 blocks) — hit sparks, crit effects, etc.
• Interaction/crafting particles (default 24 blocks) — enchanting, brewing, smithing, etc.
• Redstone particles (default 24 blocks) — redstone dust/repeaters.
• Ambient particles (default 16 blocks, with an 8-block "close" radius that always shows regardless of view angle) — rain, dripping, spore clouds, portal particles, and similar decorative effects.

Beyond each radius, ambient particles are further culled by whether they're inside the player's view cone, so particles behind the camera or far off-screen never get spent frame time. Gameplay-relevant particle categories (combat, interaction, redstone) are never culled by view angle — only by distance — so nothing gameplay-important is ever hidden just because the player isn't looking at it.

---

1. ULTRA LOAD ("panic mode")

---

A chunk-loading-focused panic mode. When the game detects that chunks are being generated/loaded faster than a configurable threshold (default 8 chunks/second — i.e. a player flying, sprinting with elytra, or exploring new terrain quickly), it temporarily disables everything that doesn't help chunks actually appear on screen: mob AI, mob spawning, random block ticks, particle spawning, and entity rendering. This frees CPU (for the world generation/chunk meshing threads) and GPU (for terrain rendering) exactly when it's needed most.

Once chunk-loading load drops back below the threshold, everything is restored after a short cooldown (default 40 ticks / 2 seconds) to avoid flickering on/off during brief pauses. A "safe radius" around each player (default 20 blocks) exempts anything that would affect entities close to the player — so a mob standing right next to you doesn't vanish or freeze mid-fight and then snap back once the panic mode ends. Every individual sacrifice (freeze all mobs, disable spawning, disable particles, hide entities, etc.) has its own on/off toggle.

---

1. ESCALA DE RESOLUCION (Resolution Scale)

---

Client-side GPU render-resolution scaler, in the spirit of the standalone mod RenderScale. Renders the actual 3D world (terrain, entities, water, weather — not the HUD/GUI, which always stays at native resolution and stays sharp) to an internal framebuffer at a scaled-down (or scaled-up) size, then stretches that to fill the real screen. This trades visual sharpness of the world for GPU headroom — useful on integrated GPUs where the bottleneck is pixel fill-rate.

• Scale range 0.25x to 2.0x (below 1.0 = lower resolution, better performance, more pixelated; above 1.0 = supersampling, sharper, worse performance; 1.0 = native resolution, no effect/no cost).
• Choice of linear or nearest-neighbor filtering for the final upscale/downscale stretch.
• Changes apply live and instantly on save — no need to toggle the module off/on or leave and rejoin the world.
• Includes a texture LOD-bias compensation so blocks and water don't look artificially blurry at reduced scale, and a fix that keeps the glowing-entity outline effect (from the Glowing status effect / spectral arrows) correctly aligned with the scaled world instead of drifting off-position.
• Detects the standalone mod RenderScale if it's also installed and warns the player by chat: both mods swap the game's render target independently without coordinating with each other, so running both active at once (at a scale other than 1.0) will corrupt the frame. The mod recommends removing RenderScale or leaving it at 1.0x while Escala de Resolucion is in use. This warning can be dismissed permanently from the config screen.

---

1. SODIUM/EMBEDDIUM COMPATIBILITY WARNING

---

Not a performance module — a one-time chat warning. If Sodium, Embeddium, or Rubidium is detected installed alongside Ck7 - Conatus, the player is warned about a known issue on integrated graphics where those mods' "Use Fog Occlusion" option can cause chunks to fail to render until the player walks directly on top of them, and is told where in the options menu to disable it. Shown once per session unless permanently dismissed from the config screen.

---

MASTER SWITCH & GENERAL BEHAVIOR

• A single master toggle (Mods -> Ck7 - Conatus -> Config -> General) disables all six modules at once without touching each module's own individual toggle — useful for quick A/B comparisons against vanilla behavior without losing per-module settings.
• Every module can also be toggled independently; a module only runs if BOTH the master switch AND its own toggle are enabled.
• All optimizations are reversible/non-destructive: nothing is deleted, despawned, or permanently altered — mobs, villagers, and particles that are "frozen" or "culled" simply resume normal behavior the moment the relevant condition (distance, chunk load, interaction) changes again.