Skip to content

Performance Presets

github-actions[bot] edited this page Jun 22, 2026 · 2 revisions

Performance Presets

A preset auto-fills temperature, max tokens, the active-analysis toggle, and all Developer-tab fields at once — a quick way to match the mod's load to your hardware.

Cycle through Normal · Opus · Potato with the preset button on the Behavior tab in /ai menu. Selecting one fills in all the related fields instantly.

Preset For Effect
Normal (default) Most setups Balanced execution speed, tokens and watchdog.
Opus High-end machines Faster step execution, more tokens, longer task watchdog, full AI activity.
Potato Low-end machines Slower step execution, fewer tokens, active analysis disabled to cut API/CPU load.

The selected preset persists across sessions (performancePreset in the config).

Related: Emergency FPS kill-switch

Independently of the preset, a client-side frame-rate watchdog samples FPS every tick. If FPS stays below a preset-dependent floor (Potato 3, Normal 4, Opus 5) for about 3 seconds straight, it trips a mod-wide kill switch:

  • The assistant entity stays in the world but does nothing — no planning, task execution, gear management or chat analysis.
  • All players are notified.
  • Re-enable with /ai resume (or /ai enable) once the framerate recovers. The watchdog re-arms automatically after recovery.

Clone this wiki locally