package.thieves.terrortown THis fucking sucks??????? https://github.com/Facepunch/sbox-issues/issues/4827 Quick and dirty way to find the player we're controlling right now Linearly blends two colors. "background-color:" styling with alpha support using rgba(). "background-color:" scss styling, returns a hex color after desaturating and darkening "color:" scss styling, returns a hex color after desaturating and darkening "background-tint:" scss styling, returns a hex color after darkening "background-color:" scss styling, returns a hex color "color:" scss styling, returns a hex color Replace any base surface with our new equivelents. The ModelRenderer that our attachment is from. A utility component that lets you have tags update based on conditions, similarly to how we have Panel.BindClass A cache of binds. Do we have a bind already? Bind a tag to a specific condition. Must not exist. A list of game utilities that'll help us achieve common goals with less code... I guess? Resolve the owning player for a damage-related component without searching arbitrary descendants from a broad scene root. Host-only!!! Snapshot the current list of connected players, make sure that they're correctly owned, then return it. Should help avoid potential churn during heavy things like respawning everyone after a round ends or whatever. Host-only snapshot of round-managed player pawns. Includes connected human players plus ownerless replicated bots. Host-only snapshot used during host migration recovery. Unlike the normal strict connected-player snapshot, this tolerates transient pawn-binding churn so promoted hosts can still normalize surviving players. All players, both assigned to a team and spectating. Get all spawn point transforms for the given team. Pick a random spawn point for the given team. Returns the invoking client to the main menu Change level Try to request a level change. Returns false when request is rejected. Session-backed admin and permission helpers. The bootstrap file only seeds initial admin assignments; the live authority model now lives in MatchSessionState. JSON-serialized list of admin Steam IDs, synced to all clients for lightweight UI visibility checks. This is a projection of the permission document, not the source of truth. Compatibility wrapper for older UI/command callsites. This no longer grants moderation access just because a player is the technical host. Compatibility wrapper for older UI/command callsites. This now means "the local player has moderation authority". Set for the kicked/banned player before scene change so the menu can show the reason when they arrive. The ConnectedClient prefab we'll spawn whenever a player joins. Which player prefab should we spawn? Is this game multiplayer? If not, we won't create a lobby. Is this game an editor mode lobby? Is this game secret? Network membership transition diagnostics. Detailed host-side player join state snapshots. Auto dump lobby state on join/leave for debugging. Delay (seconds) before auto dump to allow host state to settle. Called on the host to decide whether to accept a Sandbox.Connection. Called when a network connection becomes active Ban a player by Steam ID with optional duration. Duration in hours; null = forever. Host-authored settings captured in the main menu before a lobby starts. Persisted local defaults for the create-lobby page. Thin serializer for lobby-start settings over Networking.SetData/GetData. Host-only bootstrap that applies lobby metadata to in-scene systems and republishes normalized values. Default document builders for match-session state. These helpers are intentionally small and opinionated so runtime wiring can create a valid session root without re-encoding group ids, permissions, and policy in multiple places. Canonical built-in group ids and permission keys for match-session authority. Keeping these centralized avoids string drift as runtime systems move onto the session root. Our cross-round match state API for host migration and session state in general Mirrored from lobby settings so the session can validate the invariant. For v1 host migration this must remain false. Host-side decision outcome for round admission. Host-side authority for round participation decisions (AFK and skip-round exclusions). Player lifecycle during a round. This replaces RoundParticipation and is the single authoritative signal for play vs spectate. Centralized, host-only authority for player life/lifecycle transitions. Everything is host authoritative here. KEEP CORE STATE TRANSITIONS ROUTED THROUGH HERE so ordering and logging stay consistent. Guard for clients attempting to call this method. Host-only: set the player's lifecycle state. This is the single source of truth for play vs spectate. Also ensures LifeState is consistent with the lifecycle. Put a player into observer posture and NotInRound lifecycle. Exit observer posture and mark as PreRound. Host-only: reconcile expected alive players at round start. Host-only sanity pass during resync windows: reconcile life vs lifecycle and ensure default equipment. Host-only diagnostic dump for all players in the lobby. RPC called from the client when local respawn finalize completes. Host treats this as an acknowledgement only (no host spawn re-entry). Legacy resync console variables (used only when GameMode.ResyncUseProperties is false). Kept outside PlayerComponent to avoid mixing core gameplay logic with console settings. ConVar: t.resync.enable Master toggle for client-side resync requests. Default: true ConVar: t.resync.interval Minimum seconds between resync requests from the same client. Default: 1 ConVar: t.resync.allow.revive If false, resync will never change Dead -> Alive on the client. Default: true ConVar: t.resync.broadcast.interval Host-only: if > 0, broadcast authoritative state every N seconds (0 disables). Default: 0 ConVar: t.resync.allow.revive.live Legacy: live-round revive policy now comes from GameMode.AllowResyncRevive. Default: false ConVar: t.resync.revive.started.grace Legacy: see GameMode.ResyncStartedGraceSeconds instead. Default: 1 ConVar: t.resync.broadcast.onrequest If true, a client resync request also triggers a broadcast to all clients. Default: true Shared round-phase policy for kill/stat side effects. Only the live round should count kill/death side effects (score, rewards, stats, haste timers). The default voice filter which prevents alive players from hearing dead players. Consolidated round lifecycle rules: waiting, prepare time, counting, time limits, and round delay. Why a spawn was requested. Used for diagnostics and policy branching. Shared player-placement helper used by spawning and map-authored teleports. Host-side physical spawn authority (point selection, teleport, and movement safety). Host-side combined inventory reset + respawn pass with unique spawn reservations. Host-side stabilization tick to catch spawn-time launches. Host-side spawn point chooser with safety checks and reservation support. Select the best available spawn transform for this player. Centralized spawn orchestration for participation, round start spawns, and warmup auto-respawns. Client-side tracker for bodies the local player has covertly inspected. Used by the scoreboard to show "Dead" for privately inspected bodies. Consolidated cleanup for round transitions. This cleans up GameObjects while TerrorTownLegacyMapLoader. It also cleans up corpses, regardless of map loader. Little helper for removing equipment between rounds that isn't "in the inventory" (Body armor, radar etc) Temporary bridge that replays death events into legacy IKillListener callbacks. Projection lifecycle hooks for consuming host-auth round events. Called when a new round ledger starts. Called each time the host appends an event. Called when the current round ledger is sealed. Normalized report model consumed by body UI and logs. Host-authoritative attribution result for one resolved damage action. Read-model notification used by kill feed projection/UI. Shared actor reference used by round-event payloads. Shared inflictor reference used by round-event payloads. Shared damage context used by round-event payloads. Shared attribution details used by round-event payloads. Snapshot row used by scoreboard projection/UI. Replicated read model for latest body inspection reports. Collects death notifications for round-end kill feed rendering. Replicated scoreboard read model composed from host-auth state + score events. Broadcast from host when a player disconnects so every peer immediately hides their row, even before the synced SnapshotJson catches up. Core metadata for one round event. Deterministic event-id helper. One typed event entry in the host-auth round ledger. Helper methods for resolving actor/inflictor components from round event payload references. Host-auth append-only event ledger for the active round. The canonical event families used by the round event store. Who is allowed to see an event payload. Confidence level for attribution decisions. Attribution path selected by host authority. Marker interface for round-event payloads. Registry/broadcast helper for event projections. Tracks recent damage contributors for assist resolution. Host-only corpse inspection service with reveal policy + event emission. Resolves canonical attacker/inflictor attribution for round events. Tracks short-lived causal ownership links used to attribute indirect damage and deaths. Host-only and reset each round. Host-auth death pipeline that emits exactly one death-class round event per lethal hit. Typed host-side notification router for round events. Centralized visibility/reveal rules for body + scoreboard role state. Host-auth scoring pipeline that derives score deltas from death events. Host-authored transition gate for round flow. This tracks transition phases in one place so subsystems can opt into consistent policies. Increments once per round-start transition. Tracked now for observability; not yet used as a hard gate. Begins host-side pre-round processing and bumps round epoch. Host-only phase transition entrypoint. Host-first transition coordinator for round transitions and map-switch recovery. Developer-only role locks for testing. These apply the next time round role assignment runs. Consolidated reward logic for score and traitor credits. Canonical policy for any role-sensitive display logic. UI and presentation code should evaluate through this API instead of reading TeamComponent.Team directly! Designates the team for a player. An action (for ActionGraph, or other components) to listen for team changes The team this player is on. Called when changes across the network. Accessor to get the team of someone/something. Are we friendly with this other team? Are these two s friends with each other? Are these two s friends with each other? Is this a certain team? Single source of truth for whitelisted and blacklisted maps. To add or remove a map, edit the arrays here. Host-authored map vote configuration edited from the terrortown systems prefab. MapVoteSystem remains runtime-spawned and reads from this singleton when present. Returns whitelist packages from cache or fetches. Call PreloadWhitelistPackages() early to avoid first-time delay. Preload whitelist packages in the background so map vote and menu show instantly when opened. Our networked list of voting options. Our networked list of votes. How long until we decide who won? How long until we move server? Which option is the winner? An instance of the map vote overlay UI The screen panel which draws our UI Whether the vote UI is minimized (local client-side state) Public property to check if minimized Set whether the vote panel is minimized What's our current winning option? Returns the full list of options with their vote counts, sorted descending. Useful for external systems to decide winners or resolve draws. Start a vote. This'll make a component on the server and This will immedately stop the game and force everyone to vote!!! RPCs a vote, targeted to the host, so it's not exposed to any public API. Sends a vote to the host. A networked vote. The player's SteamId Which option are we voting for? (Mapped to the list) A voting option that has real data. Cache for whitelist map packages. Lives in a plain static class to avoid Component.Task / whitelist issues. Admin/host force-passes a map change. Skips the normal vote — flags the system as HasPassed/PendingMapVoteAfterRound so the existing round-end → MapVoteSystem flow takes over. Start a map vote at the end of the round limit or cycle automatically to another map. Seconds to wait after pressing Attack1 before the C4 actually spawns. Gives the toss animation time to play (e.g. 11 frames at 30fps ≈ 0.367s). How far in front of the player's eyes the C4 spawns when thrown. Seconds to keep the viewmodel visible after the C4 spawns, so the toss animation can finish. Add this to objects you want to be scannable with the DNA Scanner The player who started this fire (for karma tracking) Runs a trace with all the data we have supplied it, and returns the result Applies one tick of heal if conditions are met. Host-only; call from Pressing (host path) or RequestHeal (RPC from client). Runs a trace with all the data we have supplied it, and returns the result Manually constrains a rigidbody to stay within rope length of an anchor point Visual rope renderer Cleans up the hanging anchor when the corpse is destroyed Runs a trace with all the data we have supplied it, and returns the result Presumably for weapons prefabs placed in the world and to track the player who placed it An ammo container. It holds ammo for a weapon. How much ammo are we holding? Do we have any ammo? Is this container full? Sets the ammo count. Use this from the host to ensure proper sync to clients. Removes ammo from the magazine. Use this from the host to ensure proper sync to clients. Store a reference to the blood impact sound so we don't have to grab it every time. Makes some tracers using particle effects. Runs a trace with all the data we have supplied it, and returns the result TTT Drops ammo with the weapon if no other weapons you have need it. Temporary marker just to make it obvious there's a grenade The player who threw the incendiary grenade (for karma tracking) A weapon component that reacts to input actions. When false, shooting is blocked (e.g. weapon wheel hover) but reload and other input still work. Authoritative shoot block owned by higher-priority systems (e.g. round-end grace). Unlike , this isn't reset by weapon-wheel / slot-swap input handling, so holding Attack1 across weapon swaps won't phantom-fire when the block is lifted elsewhere. What input action are we going to listen for? Should we perform the action when ALL input actions match, or any? What kind of input are we listening for? ActionGraphs action so you can do stuff with visual scripting. Gets the input method Called when the input method succeeds. When the button is up When the button is down Interface for components on weapons that persist when dropped. Interface for components on weapons that persist when dropped. Default implementation will create a copy of this component on the dropped weapon, then copy it back on pickup. Fetches the desired model renderer that we'll focus effects on like trail effects, muzzle flashes, etc. Do shoot effects Runs a trace with all the data we have supplied it, and returns the result Can we shoot this gun right now? Runs a trace with all the data we have supplied it, and returns the result Can we push right now? Do push effects This seems like it would be used for things like throwing a knife at a player, or sticking a poltergeist explosive to them, or maybe a flare gun.. etc The current weapon's ammo container. Remove current weapon on use. Prefab Offset. how long since we shot? Can we shoot this gun right now? How long does it take to reload? How long does it take to reload while empty? This is really just the magazine for the weapon. What sound should we play when we fire? What sound should we play when we dry fire? The current weapon's ammo container. Does this weapon require an ammo container to fire its bullets? How many ricochet hits until we stop traversing Maximum angle in degrees for ricochet to be possible Anything past 2048 units won't produce effects, This is squared. How far will we trace away from a gunshot wound, to make blood splatters? Accessor for the aim ray. how long since we shot? Have we been continuously shooting? Fetches the desired model renderer that we'll focus effects on like trail effects, muzzle flashes, etc. Store a reference to the blood impact sound so we don't have to grab it every time. Play any particle effects such as muzzle flashes. Shoot the gun! Gets the current bullet spread which is accumulated by the player's movement speed, or if they're in the air. Can we shoot this gun right now? A weapon component. Optional editor-authored damage descriptor overrides for this equippable item. Subscribe to changes in the weapon's deployed state. A reference to the weapon's . A tag binder for this weapon. Shorthand to bind a tag. A reference to the weapon's model renderer. Scale multiplier for the world model when spawned, dropped, thrown Scale multiplier for the world model when held by a player The default holdtype for this weapon. What sound should we play when taking this gun out? What sound should we play when taking this gun out? How slower do we walk with this weapon out? Is this weapon currently deployed by the player? Updates the render mode, if we're locally controlling a player, we want to hide the world model. A reference to the weapon's if it has one. Get the weapon's owner - namely the player controller How long it's been since we used this attack. How long it's been since we used this attack. Deploy this weapon. Holster this weapon. Allow weapons to override holdtypes at any notice. Called when trying to shoot the weapon with the "Attack1" input action. Can we even use this attack? Called when trying to shoot the weapon with the "Attack2" input action. Can we even use this attack? Creates a viewmodel for the player to use. A weapon component. This can be anything that controls a weapon. Aiming, recoil, sway, shooting.. The weapon. It's going to be a component on the same . Where we hold all of the player's stats, both persistent ones and per-lobby/map ones. This class represents a connected client and their core data. Replaces the old PawnSystem. The PREFAB this class is on owns round-mode routing (Playing, Spectating, joining late, etc), and everything else (SpectateSystem, PlayerComponent.State, UI) will react accordingly. Unique ID given to players, equal to the owning Player connection ID if it's a real player (and not a bot). Host-authored AFK state. AFK clients are excluded from round admission until cleared. Host-authored count of upcoming rounds to skip (used for slay-style exclusions). Whether this client is currently excluded from the round cycle. This is "What we are right now", the GameObject. Networked reference that lets every client resolve the pawn when/if they need to. Host-authored: epoch for pawn binding updates. Used to detect missed bindings. Host-authored: component Id of the pawn (PlayerComponent). Host-authored: explicit pawn bind state. Avoids empty IDs during transitions. Non-networked, clientside-only: "This local client is currently controlling/viewimg through this pawn". The rule: This is the ONLY control/view truth in the game. This is used around the codebase for control routing and spectating is entirely about which Viewer we're on. Is this client me? Data for all players. Only the host should ever be making use of this! The local client's ClientData (null if not spawned yet). Our persistent player pawn that we always own, whether we're dead or alive. The player we're viewing from the perspective of; ourselves or someone we're spectating. Derived lifecycle state from the owned pawn. This replaces ParticipationState. Clientside-only: currently spectated player (if any). Clientside-only: current spectate camera mode. Should we be controlling our pawn in the world? Are we currently in a spectating state? Are we spectating without a target? Local helper: push AFK preference to host and suppress one-time baseline announce races. Host only: Assign the "owned pawn" for this client- whatever they are controlling and playing as right now. This is NOT the same as Viewer (spectating changes Viewer). Clientside: switch the local view/control target to a pawn. Stops running if we're not the local client or if we are already controlling/viewing this pawn, which lets us use this as a guard rail around the codebase Clientside: Depossesses a pawn. If it's not currently Viewer, it's a no-op. Pawn interface. Anything that can be used as a viewing target or possessed/controlled implements this. Importantly, calls to Possess and Depossess are done by internally calling ConnectedClient to keep the truth in only one place for the player. Called during possession, from the pawn. ConnectedClient initiates the call, the pawn object does any specific work. Called when leaving possession, from the pawn. ConnectedClient initiates the call, the pawn object does any specific work. Shorthand accessor for the value coming from ConnectedClient. Shorthand accessor for the value coming from ConnectedClient. Who is the client that owns this pawn? Pawns Do we have network rights over this pawn? Are we possessing this pawn right now? (Clientside) True when this pawn is the local viewer target, not necessarily controlling This is reference equality. It's fine but we need to be aware as time goes on Viewer should always be the actual IPawn instance not a proxy wrapper or anything Make this pawn the local viewer target. Clear local viewer target (if it is this pawn). Host-authored forensic snapshot attached to each corpse object. Centralized entrypoint for damage classification + descriptor lookup. Stable cause ids for logs, descriptors, and gameplay branching. Canonical classification output for one damage event. Priority-ordered rule classifier for TerrorTown damage events. Canonical high-level damage kind used by gameplay systems and UI. One data-driven classification rule with priority. Describes the damage that should be done to something. This is purposefully a class so it can be derived from, allowing games to create their own special types of damage, while not having to create a whole new system. Usually a player or Npc The weapon/object that did the damage, or a vehicle etc The hitbox that we hit (if any) Stable hitbox/bone name string for networked and descriptor contexts. Tags that define the type of damage this is Amount of damage this should do The location of the damage The source/origin position of this damage, if known. The force of the damage The physics shape that we hit (if any) Canonical classification computed by . Bridge from engine-native damage events to TerrorTown damage info. Editor-authored descriptor overrides for specific damage-producing objects. Master switch for this source. When false, this component is ignored and fallback descriptor data is used. Optional cause ID override for the built descriptor. This currently feeds snapshots; round-event attribution/scoring still use classified cause. Optional scoring category override on the descriptor model. Reserved for scoring/rules consumers; not currently read by . If true, apply instead of inheriting fallback descriptor behavior. Body-info formatting preference used only when is true. When active, BodyInfo context appends weapon naming to the resolved phrase (example: "{bodyInfoText} with {weapon}"). If true, apply instead of inheriting fallback descriptor behavior. Default DNA policy for this descriptor when is enabled. This flows to corpse forensics via . Base body-inspection phrase for BodyInfo context. Grammar slot: treated as the leading clause, then UI appends " {seconds} second(s) ago". Example: "Shot in the chest" -> "Shot in the chest 12 seconds ago". Base kill-feed verb/phrase for KillFeed context. Grammar slot: intended to sit between killer and victim (e.g. "stabbed", "burned"). This is consumed by the live kill-feed projection. Context override text for ConsoleLog context. Intended as a short death descriptor phrase; currently no active console formatter resolves this context. Context override text for RoundSummary context. Intended as a summary-friendly phrase/sentence fragment; currently reserved until summary rendering resolves descriptor context. Context override text for Stats context. Intended as compact stats/log wording; currently reserved until stats renderers resolve descriptor context. Context override text for DetectiveInfo context. Intended for forensic/detective-only readouts; currently reserved until detective views resolve descriptor context. Headshot-only replacement for BodyInfo context. Grammar slot is identical to and still receives the " {seconds} second(s) ago" suffix. Headshot-only replacement for KillFeed context. Grammar slot is identical to (verb/phrase between killer and victim). Descriptor overrides for player equipment and weapons. Descriptor overrides for non-equippable world objects (props, scripted world explosions, etc). Descriptor overrides for authored map hazards (traps, trigger hazards, environmental killers). Text/profile metadata for one canonical damage cause. Base phrase for BodyInfo-like contexts (corpse/inspection wording). Base phrase for KillFeed-like contexts (typically a kill method verb/phrase). Where a damage description is being rendered. Corpse/body inspection text. Current runtime grammar: value is used as a leading clause, then body UI appends elapsed-time text. Kill feed method verb/phrase (typically between killer and victim names). Currently reserved in descriptor pipeline; live kill feed still emits fixed verbs. Console logging representation of the death method. Round summary representation of the death method. Stats/telemetry representation of the death method. Detective/forensics representation of the death method. Registry for cause descriptors used by corpse text, kill feed, and logs. Resolves the best descriptor source component for a damage payload or snapshot. Canonical runtime snapshot of one resolved damage application. One optional weighted descriptor text variant with context/predicate filtering. A health component for any kind of GameObject. Are we in god mode? An action (mainly for ActionGraphs) to respond to when a GameObject's health changes. How long has it been since life state changed? Grace window before reporting life/health mismatch as desync. Are we ready to respawn? How much to reduce damage by when we have armor. What's our health? What's our life state? Called when is changed across the network. The component's life state. A listener put on a component that listens to damage. Called when YOU inflict damage on something Called when YOU take damage from something Called when YOU take damage from something A listener put on a component that listens to damage. Called when something dies A listener that is called BEFORE a player dies, allowing you to handle equipment drops, etc. Called when something is about to die, before the kill sequence begins Hosts the canonical last-damage snapshot authoring path, keeping state storage lean. Set a player's ammo, this is different to SetAmmo as it works for non local players Give ammo to a player, this is different to GiveAmmo as it works for non local players Host-only view of reserves that accounts for grants the host has fired via RPC but whose sync hasn't round-tripped back yet. Decays to the real synced value after HostEstimateTrustSeconds so genuine consumption (firing) takes over correctly. Host-authoritative pickup gate. Returns the amount actually granted (0 if reserves are already full according to the host's estimate, i.e. there's an in-flight grant that already used the remaining space). The player's inventory. What weapons do we have right now? A that will hold all of our weapons. Can we unequip the current weapon so we have no weapons out? Players current Credits Gets the player's current weapon. Internal method that actually performs the weapon drop logic. Can be called directly from host without going through RPC. Tries to set the player's current weapon to a specific one, which has to be in the player's inventory. Removes the given weapon and destroys it. Removes the given weapon (by its resource data) and destroys it. Transfers credits from this player to a teammate (Traitor only). Runs on host via RPC. When jumping into walls, should we bounce off or just stop dead? If enabled, determine what to collide with using current project's collision rules for the of the containing . Optional collider used as the shape of the player's movement trace, uses helper physics body or bbox if unset. Move up and leave the ground, great for jumping. Add acceleration to the current velocity. No need to scale by time delta - it will be done inside. Add our wish direction and speed onto our velocity Apply an amount of friction to the current velocity. No need to scale by time delta - it will be done inside. Trace the controller's current position to the specified delta Disconnect from ground and punch our velocity. This is useful if you want the player to jump or something. We're no longer on the ground, remove it We have a new ground Move from our current position to this target position, but using tracing an sliding. This is good for different control modes like ladders and stuff. The current gravity. How much friction does the player have? The speed at which we fully come to a stop. Can we control our movement in the air? Move a character, with this velocity Get the current friction. Constructs a ray using the camera's GameObject The Input Action that noclipping is triggered by. TODO TODO How quickly does the player move by default? The Input Action that the alternate speed mode is triggered by. If the player should run by default, pressing the run action will swap to default speed The speed the player moves at while in the alternate speed mode. The Input Action that the alternate speed mode is triggered by. The speed the player moves at while in the alternate speed mode. The Input Action that crouching is triggered by. The speed the player moves at while crouching. The Input Action that jumping is triggered by. Can the player hold down jump to repeatedly jump? How powerful is the player's jump? Do we want to jump next movement update? A network message that lets other users that we've triggered a jump. Values from popular games. The Input Action that noclipping is triggered by. Set the visibility of the player's body. Local-only visibility toggle (used for late-join/missed RPC recovery). Client-side loop: detect mismatch and request host resync. Host-side loop: broadcast authoritative state on an interval. See GameMode.cs Resync properties Decide if we should request a resync from the host. ... I am a little worried about this, but we have to make the determination somewhere. Todo: It may be worth checking the game's state as part of this, as opposed to LifecycleState, but we manually set the LifecycleState on transitions- it's probably more reliable than GameState info for the client rn Host-only: owner requests a resync for their pawn. I hate the sbox documentation on these net flags Policy: decide if resync is allowed to revive during the current game state. The player's health component The player's inventory, items, etc. The player's ammo. Component describing which team the player is on. How long since the player last respawned? Host-authored life snapshot (life, health, respawn, lifecycle) sent as a single synchronized value. Host-authored lifecycle state for play/spectate. Derived from LifeSnapshot. Host-authored spawn transform (sequence + position/rotation) for reliable owner teleports. Since this is a synced property from the host, if we miss the teleport RPC, once the property updates we'll snap to the right position Whether the death camera is currently active Host only: Called when a player joins mid-round. Create the player they'll need for next round, but posture only. No death pipeline stuff or in-game state changes. Host-only: Prepare the player's pawn for live play and control. Posture only! Initialize the player pawn. Host-only kill. Host-only: apply death effects without re-authoring life state. Activates the dead camera (camera follows head bone), then switches to spectate mode after 5 seconds or on click/space down. If we're controlling this, ask the host to start spectating Call the host and have them put us in spectator, because we died Visual/posture reset that must run everywhere Host-only call, but executes on all receipients Host-only: Teleport without any RPC. Useful before a NetworkSpawn. Host-only: Teleport the player to this position with this rotation. What weapon are we using? This is the networked truth of who owns this pawn. This is OwnerClient, satisfying IPawn.Owner. Same value. A shorthand accessor to say if we're controlling this player. Is this player the currently possessed controller? TODO change for spectating The player's body A reference to the player's head (the GameObject) A reference to the animation helper (normally on the Body GameObject) The current character controller for this player. The current player mover for this player. Apply a push force to this player (called via RPC to the owner) The current camera controller for this player. ???? - 55 The player's voice The current camera for this player. The outline effect for this player. A reference to the View Model's camera. This will be disabled by the View Model. Handles the player's outfit Handles radar pings for a player A that will hold our ViewModel. Finds the first on An accessor to get the camera controller's aim ray. Called when the player jumps. How far can we use stuff? Unique ID of this Bot Is this a player or a bot Last time this player moved or attacked. Called when YOU inflict damage on something The player. Assigns the player's clothing. Anything commented out is available but not being used, unless it's in the "not working" up here. All this component does is lie Are we allowed to identify this body? (WaitingForPlayers only for testing) Local-only client state for per-player scoreboard tags (Gmod-TTT style). Cleared at the start of each round via . Call each frame from any client-side ticker. Detects round transitions and clears tags at the start of a new round (entry into ). Traces forward from the freecam and returns the alive player under the aim, or null. Shared by the Use-to-spectate action and the on-screen hint. Which spectator prefab should we spawn? Called each frame and determines the camera's position based on the mode Formats keybind origin strings for display (e.g. "return" → "ENTER"). Open the dropdown. Normalizes paths for use in CSS url() so the Sandbox style parser (Zio) accepts them on Windows. Windows paths must be in the form /mnt/<drive>/... for the virtual filesystem. Converts a path to the form expected by the style parser on Windows. If the path is already game-relative (e.g. "ui/icon.png") or null/empty, returns it unchanged. If it is a Windows absolute path (e.g. "C:\..."), converts to /mnt/c/... Single source of truth for HUD/UI as far as "who am I showing" and "what do I know (based on what team I am)" Target = whoever the camera is anchored to (spectated player or me) Local = our owned session player (our own team alignment/perms/etc) Shitload of computed values we can use throughout the UI Local client's owned player pawn, this needs to be and should be stable through the session Player we're currently viewing (Spectate target or our own pawn when playing). This is allowed to be null for freecam What team the local user should perceive the target as. For example, traitors only appear as traitors to their teammates Changes whenever requester/target identity or role-visibility phase context changes. Use in BuildHash for role-sensitive panels to avoid stale display during handoff churn. Client-side award computation for the end-of-round Highlights panel. Pure — operates on already-synced round data (kill feed + scoreboard snapshot). Kill counters are derived from the per-round kill feed so they reflect only this round, while team membership / alive state come from the (cumulative, real-time) scoreboard snapshot. The player the award is attached to. for round-level awards. The player's inventory Reset the timer to default when opening the panel Returns just the 4 digits (no colon) for grid display Adjust the appearance of the crosshair The weapon we're currently holding, if there is one Fill percent in range [0..1]. 1 = full, 0 = empty. Optional overlay text shown centered over the bar. Game-relative texture path, for example: /ui/dnafinal.png Vertical texture scale. 1 = fit bar bounds. Vertical texture position offset in percentage points from center. Width (in percent of bar width) of the soft edge blend. Opacity multiplier for the soft edge. 0 = hard edge, 1 = strongest falloff. 0 to 100 Checks the current button and updates the glyph. 0 to 100 The player's weapon. The player's weapon. Is this selected or being hovered over? Target object that owns the setting property. Current setting value for , read/write via reflection. Metadata for the setting property being rendered. Range and UI metadata used by the slider/option row. Supports both modern [Range(min,max)] + [Step(x)] and legacy Range step overloads. Whether the value label should render for this entry. Whether a text entry field should render for this entry. Resolves an override state to a concrete bool. Current settings group selected by the top bar. Grouped settings metadata used for layout and rendering. Widget metadata resolved from . Main settings column slot containing one or more subgroups. Serialized property wrapper used by . Builds subgroup definitions from the current group's settings metadata. Resolves layout preset metadata for a settings group. Resolves column layout metadata for the current group. Generates inline style for a column based on layout attributes. Resolves explicitly configured column widths from the selected group preset. Resolves compact-mode fallback column widths when no explicit width is configured. Resolves how many main column slots should render for the selected group. Resolves width behavior for the area that contains main columns. Builds ordered main column slots and injects empty slots when requested. Resolves a display label for a column. Maps area mode enum to CSS suffix. Builds fixed-width column style. Builds evenly spaced fill-width column style. Resolves widget anchors into renderable widget metadata. Normalizes a subgroup name for lookup keys. Inline shell style resolved from the group preset. CSS class for shell and group/preset targeting. Maps preset enum to CSS suffix. Generates inline width/height for a widget container. Maps a widget key to a concrete render fragment. Crosshair preview widget (preview + color control). Returns properties visible for the current settings surface (main menu vs in-game). Applies optional filtering for a property. Where the popup renders on screen. Top of the screen, horizontally centered. Dead center of the screen. Just above the crosshair. Just below the crosshair. Bottom-right corner of the HUD. Follows the mouse cursor (updated each Tick). Optional heading line, rendered above the body. Main text. Supports [ActionName] tokens (e.g. [BuyMenu]) that are replaced with the live keybind via . Auto-fade duration in seconds. 0 = sticky mode: stays visible while is true. Set by / . Only used in sticky mode (DurationSeconds == 0). Caller toggles to show/hide. Theme suffix — "neutral" (default), "traitor", "detective". Maps to a CSS class. Where the popup anchors on the screen. Smaller padding / font for tight hint-style popups. Show the popup for seconds then auto-fade. Show the popup until is called or is set false. Update the popup's text without altering visibility. Useful for sticky popups whose text depends on state. Hide immediately, canceling any auto-fade timer. The weapon's slot The weapon instance we're listing Is this selected or being hovered over? Local-only camera rig. Owns the single main camera and routes pose based on local state. When enabled, the main camera excludes the viewmodel tag and we explicitly draw viewmodels via (CommandList). This avoids relying on multi-camera rendering, and is useful for diagnosing cases where viewmodels exist but aren't visible. Pawn's camera. Reacts to "Am I the Viewer pawn?" and "What spectate mode?" Decisions are driven by PlayerLifecycleState Now on LocalCameraRig, created and assigned locally. /// GameObject the Viewmodel Camera is attached to, child of Camera GameObject. Weapon viewmodels are children of this object. Viewmodel CameraComponent. Currently not in use Reference to the player component on the player GameObject. Reference the head on the player for reparenting the camera during death cutscenes, etc. Reference to the player's body for setting visibility, etc. The main model renderer for the player. Our pawn's current CameraMode Apply the correct CameraMode based on what pawn we are Indirectly set via ConnectedClient.Viewer What kind of pawn are we? Used to determine CameraMode Don't run the camera unless we are possessing this pawn External FOV override (e.g., from scope or other visual FX). If not null, this value is used instead of the calculated FOV. LocalPosition offset for the camera in first person LocalPosition offset for the camera in third person Wrapper(?) for UpdateCameraMode that authorities send modes to Initial setup for a given pawn Change the body visibility for the local player, depending on the camera mode. Only world models are children of the body, all viewmodels will be children of the ViewmodelCameraGameObject We call SetBodyRenderType which iterates through the body to show everything, shadows only, or nothing, depending on the need. Local-only visual transition state for spawn/respawn events. A weapon's viewmodel. It's responsibility is to listen to events from a weapon. It should only exist on the client for the currently possessed pawn. A reference to the we want to listen to. A reference to the viewmodel's arms. Is this a throwable? Looks up the tree to find the player controller. The View Model camera Cosmetic-only first-person wall tuck. Lowers/tilts the viewmodel near world geometry. This does not affect damage, traces, or weapon gameplay. Raw access Data in the frame Are we overriding the type here? This purely exists as a wrapper for a real lobby, so we can display fake lobbies in the UI. A reference to our internal lobby type. Is this lobby a dev env? Is this lobby a dedicated server? Clears chat on first join only, not on map changes. Clears chat and resets session flag when disconnecting. Returns true if the local player can use team chat (is Traitor-aligned or Detective). Tracks whether chat input is currently open/focused to arbitrate shared key input (for example Esc). Requests that the chat UI closes from an external input owner (for example Pause menu Esc arbitration). Returns true once when an external close request is pending, then clears it. Returns the registered chat command names sorted alphabetically. Returns up to command names that match the typed prefix. Populates the with methods that have the attribute Attempts to parse the message of its command and parameters. The users message to process as a command Adds a message that only the local player can see with the server as the author. The content of the message Adds a message that only the local player can see with them as the author. Compatibility wrapper over the session-backed gimp sanction helpers. Display override state used by settings UI attributes. Use the default behavior for the control. Force-enable the display option. Force-disable the display option. Attribute for tuning how a setting entry renders in the UI. Use a compact row layout for this entry. Show a value label for this entry. Show a text entry field for this entry. Horizontal alignment for a settings group shell within the viewport. Preset sizing behavior for a settings category. Fully fluid layout that uses available container width. Narrower layout useful for short categories. Width behavior for the area that contains settings columns. Uses preset defaults (Compact = fit content, Fluid = fill available width). Expands to available width. Sizes to the content width of rendered columns. Declarative per-group layout preset with optional shell and column width overrides. Settings group name this preset applies to. Preset key used for style hooks and default behavior. Left-to-right display order for top-level category tabs. Lower values appear first. Optional max width for the group shell in pixels. Zero keeps it fluid. Optional fallback width for main dock columns in pixels. Optional fallback width for sidebar dock columns in pixels. Number of evenly spaced main column slots to reserve when using fill mode. Width behavior for the area that contains main columns. When true, renders the subgroup name as a top label for each main column slot. Declares layout hints for a settings group in the settings UI. Settings group name this layout applies to. Max width in pixels for the settings shell when this group is selected. Alignment for the settings shell when this group is selected. Declares fixed width for a column in a settings group. Settings group name this column layout applies to. Column index within the dock. Fixed column width in pixels. Dock target for the column definition. Placement for a widget relative to its anchor subgroup. Renders the widget in the next column to the right of the anchor subgroup. Renders the widget below subgroup sections in the anchor subgroup's column. Anchors a widget panel to a subgroup, allowing preview/extra UI placement. Settings group name this widget applies to. Subgroup name this widget anchors to. Widget key used by SettingsPage to render a widget fragment. Placement relative to the anchor subgroup. Sort order within the widget area. Preferred widget width in pixels. Preferred widget height in pixels. Dock target used for resolving the anchor column. Provides discrete option values (and optional labels) for a numeric setting. Values displayed in the option selector. Optional labels aligned with . Optional Material icon names aligned with . Placement for a settings sub-group within the settings UI. Attribute for grouping settings into sub-sections within a category. Subgroup title shown in the settings UI. Sort order within the group. Column index this subgroup should render into. Dock target used to split main/sidebar columns. Visibility surface for settings entries. Restricts where a setting is visible in the in-game settings page. The surface where this setting should be visible. Enables a text entry field for a setting value. Whether the text entry field should be shown. Lightweight local cookie jar for UI/tutorial state that doesn't belong in gameplay settings. Barebones persisted key/value storage for client-side UI state. Persist AFK preference and notify host of the local player's desired AFK baseline. Handles loading, saving, and applying . Current settings instance (lazy-loaded from disk). Data file path for serialized settings. Writes settings to disk and applies runtime values. Applies runtime values that need to take effect immediately. Returns true only when every expected mixer was ready and all volumes were applied. Loads settings from disk (or defaults) and applies them. Resets settings to defaults and applies them. Returns true when current settings differ from the last loaded/saved state. Resolves a property's default value from a fresh instance. Compares a value against the default value for the same property. Returns whether the current settings value for a property equals the default. Resets one setting to its default value and persists settings. Persist AFK preference to disk and push it to the host so it survives map changes. For the tinnitus SFX after an explosion happens nearby Keeps main menu stems in sync by only changing volume while all emitters keep playing. Produces footstep sounds for the player. Handles certain events and plays radio sounds. A simple component that plays a sound. How long until we destroy the GameObject. Playback volume for this emitter. Shoulud we follow the current GameObject? Creates a GameObject that plays a sound. Take damage. Creates a which will deferred delete the . Creates a which will deferred delete the . One in a scene, used by to dictate rules around who can broadcast their voices to who. Should we exclude this potential listener from hearing our voice? Animation curve to use, X is the time between 0-1 and Y is how much the door is open to its target angle from 0-1. Sound to play when a door is opened. Sound to play when a door is fully opened. Sound to play when a door is closed. Sound to play when a door has finished closing. Optional pivot point, origin will be used if not specified. The axis the door rotates/moves on. How far should the door rotate. How long in seconds should it take to open this door. Open away from the person who uses this door. Can we open the door at all? Interface for components that can reset their state without being destroyed/recreated Reset this component to its initial state Promotes authored map primitives that rely on Sync/host-owned transforms into real network objects. These objects already exist in the authored scene; we bootstrap networking in-place after map load. Restores map-authored tool components to the immutable baseline captured from the loaded map so host migration does not preserve transient motion state from the old host. Host-side registry for map-authored IResettable components. Captures once and reuses stable references during round cleanup to reduce scene-wide churn. A map instance that can be reset to its initial state, inspired by Source 1's map reset methodology. A list of tags for GameObjects that should be preserved during a map reset. This is analogous to Source 1's s_PreserveEnts list. Stores the serialized data of all non-preserved objects from the initial map load. Stores the Ids of all objects we have captured for reset. Captures the initial state of all resettable GameObjects in the scene. Objects without IResettable are serialized for recreation. Resets the map to its captured initial state. Destroys all GameObjects that have a TemporaryEffect component. Marks a GameObject as a temporary effect and destroys it after a short delay. Used by prefabs for transient particles/tracers. How long until we destroy the GameObject. If true, stop child particle emitters first, then destroy after a short delay. Generic map-facing signal receiver contract used by mapper-authored primitives. Generic signal payload passed between mapper-authored tools. Shared positive-state alias check. Start is the preferred map-tool verb; Open remains a compatibility alias for door- or mover-shaped senders. Shared negative-state alias check. Stop is the preferred map-tool verb; Close remains a compatibility alias for door- or mover-shaped senders. Wiring entry for mapper-authored outputs. Shared map-IO vocabulary and dispatch helpers. Keeping these in a dedicated core file makes the other mapping-tool folders read more like authored behaviors than infrastructure. Shared activator resolution helpers so map tools can translate direct use, RPC callers, and signal activators into the same player-aware runtime objects. Authoring-time and editor-friendly helpers shared by mapper-facing tools. Common direct-use behaviors for mapper-authored buttons and binary movers. Spawns a specific ammo box on round start. Spawns a specific grenade on round start. Spawns a random box of ammo with full ammo. Spawns a random grenade on round start. Spawns a random weapon on round start. Can specify how much of its ammo spawns with it. Spawns a specific weapon on round start. Can specify how much of its ammo spawns with it. Track who damaged this barrel (for karma tracking when it explodes) Host-only registry for authoritative explosive barrel spawn points. Keeps barrel respawn deterministic even if a barrel GameObject is destroyed mid-round. This system exists to collect pending collision sounds and filter them into a unique set, to avoid unnesssary sounds playing, when they're going to be making the same sound anyway. Register this physics collision with the sound system Add a collision sound for this shape Add a collision sound for this shape Create the pending sounds Host-authored policy for ordinary player-vs-loose-prop contact. Keeps per-prop state on TerrorTownProp while centralizing contact push rules. Check if this prop is currently being held by a magneto stick (ObjectGrabberComponent) Reset this prop to its initial state for map reset Marks a runtime-authored world object so local rehydration manifests can tell whether the current host already has a live instance. Local-only manifest of runtime replacement objects that can be recreated from legacy map source data after host migration. A physics surface replacement that controls the physical properties and sounds applied to physics shapes. A simple component that destroys its GameObject. How long until we destroy the GameObject. The real time until we destroy the GameObject. Destroys the GameObject after a delay, optionally tied to a legacy particle system. Optional particle system to stop before destruction. How long until we destroy the GameObject. The real time until we destroy the GameObject. Gets the angle (in degrees) between two Vector2s Handles the main game loop, using components that listen to state change events to handle game logic. Gets all game modes referenced by a scene. Current game state (controlled by the host.) Current game time (controlled by the host.) Current round number, starting at 1. Host-authored: whether resync is allowed to revive (Dead -> Alive) right now. Clients now use this instead of local timing to avoid desyncing. When true, Resync* properties below are authoritative (convars act as overrides, see below). Legacy field retained for backward compatibility; resync requests are always enabled. Minimum seconds between resync requests from the same client. Default: 1 Host-only: if > 0, broadcast authoritative state every N seconds. If true, a client resync request also triggers a broadcast to all clients. (So everyone receives the state update that client just got from the host.) If true, host runs a sanity pass during resync windows (life/participation/equipment). Run periodically only DURING the resync revive window. If false, we don't do any extra correction attempts outside of normal resync replies. Minimum seconds between host sanity passes (Again, only during the resync window). Seconds after GameState.Starting begins before resync revive is allowed. Default is 0- this is just in case we want to test stability, since a fair bit of change happens during the flip to round start. 2-9-26 We probably don't need this anymore Duration of the resync revive window while GameState.Starting. "For how long during round start can we can be forcibly re-synced?" Grace period (seconds) after GameState.Started where resync revive is still allowed. This is after the round has started and roles have been assigned. Default is 1. Enable verbose PlayerState transition logs. Enable verbose resync request/apply logs. Host-only: toggling true will dump lobby state once and then reset. Never start the game, useful for testing weapons. A weapon set that we'll give the player when they spawn. Called on the host at the end of a round to determine if the game should end. Called on the host every update during a round to determine if it should end. TODO: perhaps CheckRoundEnd should return a team? Game start is when "Preparing..." pops up on the screen, after at least 2 players have joined. Called on the host before . Called on the host when a game is starting. Called on the host after completes. Game end is when the ROUND is over, AFTER the 5 seconds or so post-team winning Called on the host before . Called on the host when a game is ending. Called on the host after completes. Round start is when the round formally begins and the roles are assigned to players that are participating Called on the host before . Called on the host when a round is starting. Called on the host after completes. Round end is when a team is determined to have won, the toast pops up and the 5ish seconds of "Game Over" begin Called on the host before . Called on the host when a round is ending. Called on the host after completes. Called on the host before . Called on the host when respawns. Called on the host after . Called on the host when a new player joins, before NetworkSpawn is called. Called on the host when a new player joins, after NetworkSpawn is called. Called on the host when a player is assigned to a team. Split players into two balanced teams. Check team win conditions. Ammo resource metadata used to describe an ammo type as an asset. The prefab to create and attach to the player when spawning it in. The Ammo's model The optional legacy Entity name for this weapon, for map compatibility reasons. Knives etc. Pistols. Non-pistol guns. Grenades etc. Magneto Stick etc. Traitor items etc. Do not use. A resource containing basic information about a weapon. If true, randomly spawns throughout the map If true, owner will drop this weapon if they disconnect. The weapon's icon Is this weapon shown in the buy menu The tab this weapon is shown in the buy menu The tab this weapon is shown in the buy menu How much is this weapon to buy in the buy menu? If true, once purchased, this item can't be bought again until the next round. The prefab to create and attach to the player when spawning it in. The prefab to create when making a viewmodel for this weapon. Ragdoll impulse scale for this weapon. Higher values throw bodies more. Extra upward bias for ragdoll impulse (0-1 recommended). If true, body armor does not reduce this weapon's headshots. Intended for classic one-shot headshot weapons like the Deagle and M24. If true, this weapon suppresses the victim's death scream/audio cue. This is separate from corpse/death-camera flow and is intended for silent-kill behavior. If true, text generators will use 'an' instead of 'a' before this weapon's name. Examples: an Uzi, an M24, a Glock. Rotation override for this weapon's model preview. Useful when a world model faces an awkward direction by default. Additional offset applied to the model preview camera look-at target. Use this to nudge tall or asymmetrical models back into frame. Multiplies the auto-fit camera distance for the model preview. Values above 1 pull the camera back; below 1 push it closer. Field of view override for this weapon's model preview camera. The optional legacy Entity name for this weapon, for map compatibility reasons. Emits particles evenly along a defined line. The starting point of the line in local space. The ending point of the line in local space. If true, the Start/End Point properties will be ignored, and GameObjects will be used instead. The GameObject to use as the starting point of the line. The GameObject to use as the ending point of the line. REMOVE ME WHEN THIS IS ADDED TO SBOX MAIN BRANCH!!!!!! Emits particles in a line. The line can be flat or have a tube-like quality. Renders a single continuous rope between all particles in the system using a LineRenderer. The colour of the rope over its length. The width of the rope over its length. How the texture is applied to the rope. A generic, configurable operator that performs a mathematical operation on a particle property every frame. The toggle state has changed The toggle state has changed Destroy this object before a round starts if the current game mode has a component. Destroy this object before a round starts if the current game mode has a component. Implement this interface on components that need to reset their state before map state capture.