Files
browser/plugins/examples/scum-server-plugin/schemas/bridge/queries/SCUM_DB_CONTRACT.md
T

1.5 KiB

SCUM.db Query Contract

These query template keys are browser-safe declarations. They intentionally do not carry SQL text, host paths, DSNs, sockets, or credentials. The bound run/agent beside the current SCUM service owns the actual SQLite read implementation and must return rows matching the referenced result schemas.

Template key SCUM.db source tables Projection target
scum.player.profile user_profile, prisoner, prisoner_entity, entity, bank_account_registry, bank_account_registry_currencies, optional squad_member / squad joins Player identity, economy, squad summary, and current position
scum.squads squad, optional squad_member, optional user_profile leader joins Squad records and leader/member counts
scum.squad-members squad_member, user_profile, optional squad joins Squad roster and member identity mapping
scum.vehicles vehicle_spawner, entity, optional owner/squad joins when present Vehicle inventory and coordinates; unknown class labels remain unknown
scum.flags base_element, entity, user_profile, squad_member, squad where available Flag ownership, ownership confidence, and coordinates
scum.positions prisoner_entity, vehicle_spawner, base_element, entity Current player, vehicle, and flag coordinates

last_save_time is freshness evidence only. It must not be treated as proof that a player is online; online state comes from login/logoff evidence or an explicit typed online field.