Worldbox Observer Mod (AFK Idle/Spectator)
Find a file
DazedAnon 8a4314be6f Enhance Lore interactions and improve dismiss behavior.
- Allow multiple named entries for grave force command on the same tile
- Update dismiss behavior to clear Lore and dossier while keeping idle off
- Introduce new methods for managing dismiss grace period
- Refactor focus handling for fallen subjects and their killers
- Increment version to 0.28.13 in mod.json
2026-07-17 16:47:17 -05:00
.cursor/skills/idle-spectator-e2e Enhance dossier interactions and improve Lore click handling. 2026-07-17 13:36:33 -05:00
.tmp-reflect Implement combat isolation and improve combat event handling. 2026-07-17 14:40:32 -05:00
docs Implement durable combat pair ownership and enhance outbreak handling. Introduce FixedDwell beat cooldowns to prevent immediate reclaiming of camera focus on the same subject. Update combat event catalog to support unordered pair keys for combat scenes. Increment version to 0.25.87 in mod.json. 2026-07-17 02:32:43 -05:00
IdleSpectator Enhance Lore interactions and improve dismiss behavior. 2026-07-17 16:47:17 -05:00
scripts Fix focus handoff 2026-07-16 21:54:44 -05:00
.cursorrules Enhance dossier interactions and improve Lore click handling. 2026-07-17 13:36:33 -05:00
.gitattributes Initial Commit 2026-07-14 12:58:19 -05:00
.gitignore Implement gravestone features and enhance Lore interactions. 2026-07-17 16:32:10 -05:00
README.md Refactor event handling in IdleSpectator to improve reason clarity and ownership management. Update label templates across various event catalogs to provide more descriptive outputs. Enhance event registration logic to ensure accurate representation of actions and relationships. Increment version in mod.json to 0.19.2 to reflect these changes. 2026-07-15 23:03:57 -05:00

IdleSpectator

WorldBox NeoModLoader mod: AFK Idle Spectator camera director.

Controls

  • I - toggle Idle Spectator on/off
  • F9 - toggle Character Chronicle side panel (non-modal; works with focus)
  • Dragging the camera while Spectator is on turns it off (after a short grace period)

What it follows

The camera follows ranked events from live feeds (wars, fights, relationships, buildings, statuses, plots, …). EventStrength decides who wins; quieter events still take the shot when nothing stronger is pending. Character fill only runs when the event queue is empty (no orange reason; task chip shows the live job).

While watching, a dossier caption shows who they are and an orange event sentence (why the camera is here), e.g. Kaszus is fighting Waaaf. See docs/event-reason.md.

Lingering on someone writes a Chronicle line; F9 lists them and click jumps the camera.

Layout

  • IdleSpectator/ - mod source (mod.json + C#), loaded/compiled by NML
  • scripts/verify-nml.sh - load verification helper
  • docs/event-reason.md - events-own-camera + EventReason contract

Deploy

ln -sfn "$(pwd)/IdleSpectator" \
  "$HOME/.local/share/Steam/steamapps/common/worldbox/Mods/IdleSpectator"

Requires NeoModLoader in worldbox_Data/StreamingAssets/mods/ and Experimental Mode enabled.