dazed-mods/worldbox-observer-mod
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
Worldbox Observer Mod (AFK Idle/Spectator)
68 commits 1 branch 0 tags 14 MiB
C# 98.6%
Python 0.7%
Shell 0.7%
Find a file
DazedAnon 1359d86591 Coverage for what we have
2026-07-16 17:32:00 -05:00
.cursor/skills/idle-spectator-e2e Refactor IdleSpectator event handling to improve interest management and camera ownership logic. Update various event catalogs to remove ownership attributes and enhance label templates for clarity. Introduce new scoring logic in InterestDirector to better manage session protection and cut-in conditions. Revise AgentHarness and related components to streamline event registration and improve overall event clarity. Increment version in mod.json to reflect these changes. 2026-07-16 00:06:32 -05:00
docs Coverage for what we have 2026-07-16 17:32:00 -05:00
IdleSpectator Coverage for what we have 2026-07-16 17:32:00 -05:00
scripts Coverage for what we have 2026-07-16 17:32:00 -05:00
.gitattributes Initial Commit 2026-07-14 12:58:19 -05:00
.gitignore Skill for e2e testing 2026-07-14 15:00:05 -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

README.md

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.