ISceneFreeze interface
Pauses the whole game world while any token is held: the game’s clock stops, so every character — yours included — NPCs, pets, mounts, monsters, skills mid-cast, effects and particles hold still where they are. Players and monsters the server moves while paused stay where they were drawn (unless turned off — HoldsPositions). The framework, its windows and hotkeys, plugin updates, the free camera and screen capture keep running, and so do the network and the server’s world: a fight goes on server-side, and damage or a death taken meanwhile shows when the world runs again. A monster killed while paused stays visible until the pause ends. Local only. Reference-counted; the framework releases every token on a zone change, a cutscene, the game’s own camera mode, a logout (a disconnect is seen only as the game’s logout, Logout) and the holder’s unload — never on a free-camera release — and releases every token on its own if a pause is ever lost (outside the world, a stalled framework tick). Main thread only.
Unity’s scaled time stops for every plugin while frozen, not only for the game: Time.deltaTime is 0 and Time.time stands still, so WaitForSeconds, UniTask.Delay with its default DelayType.DeltaTime and any animation driven by scaled time wait until the world runs again. Use Time.unscaledDeltaTime / Time.realtimeSinceStartup, WaitForSecondsRealtime, DelayType.Realtime or the framework’s own timers for anything that must keep running.
Known limits: the position hold covers players and monsters within 80 m of the local player (farther ones may glide in their paused pose); the server still drives the local player’s hit reactions, so your own character can re-pose in stop-motion when hit while frozen. A Changed handler that throws is logged and skipped; it never keeps the freeze from starting or ending.
public interface ISceneFreezeMembers
Section titled “Members”| name | description |
|---|---|
| HoldsPositions { get; } | True while the drawn positions of other players and monsters are being held in place (false when turned off or over budget: then a player or monster the server moves glides, in a paused pose). |
| IsFrozen { get; } | True while the world is paused. |
| event Changed | Raised when IsFrozen or HoldsPositions changes; the argument is IsFrozen. |
| Freeze() | Pauses the world until the returned token is disposed. |
See Also
Section titled “See Also”- namespace Stellar.Abstractions.Services