TimeSinceSceneStart

Minutes since the current visit of the active scene began. Returns int.MaxValue when no scene is active. Re-entering a scene starts a new visit, so the counter resets to zero on re-entry.

Category: Time Returns: int

Signature

TimeSinceSceneStart()

No arguments.

Examples

TimeSinceSceneStart() > 10              // been in this scene 10+ minutes
TimeSinceSceneStart() == 0              // just arrived
TimeSinceSceneStart() < FromHours(1)    // less than an hour into the visit

Notes

• Requires time to be enabled for the project (Project, then Time). With time disabled, any expression using this function fails validation.
• Tracks the currently active scene specifically: it takes no argument. To ask about a scene that may or may not be the active one, use TimeSinceLastVisit with that scene’s id.
• Each scene activation allocates a fresh visit-state, so leaving a scene and coming back resets this counter to zero, even though the underlying in-fiction clock kept advancing while you were away.