#ShellRunners Runtime

ShellRunners runtime is the game client module embedded inside core frontend game pages.

#Runtime Role

1. Render gameplay state.
2. Bridge player controls to backend authoritative channels.
3. Display runtime HUD and controls.
4. Emit runtime lifecycle events to parent context.

#Embed Behavior

1. Core frontend opens runtime in embedded panel/frame.
2. Runtime receives bootstrap context from parent.
3. Runtime can request token refresh events.
4. Runtime can signal exit to parent app.

#User Experience Controls

1. Pause/resume controls.
2. Sound controls.
3. Exit controls.
4. Status overlays for score/lives/hunger/entities.

#Stability Notes

1. Runtime startup should avoid repeated scene reboot loops.
2. Token refresh and reconnect paths should not force full page reload.
3. Embedded mode behavior should remain responsive on smaller screens.

#Flow Chart (Detailed)

[Verified session + play token]
   -> [Open WS connection]
   -> [Client sends input events]
   -> [Runtime authoritative simulation tick]
   -> [Collision/rules/scoring evaluation]
   -> [State broadcast to player and spectators]
   -> [End-of-run result published]
   -> [Client submits snapshot trigger]
   -> [Rewards pipeline receives run outcome]