From Blue Mars Developer Guidebook

This page is protected and certified by Avatar Reality Inc. Only Editable by Avatar Reality Staff Members.

Contents 1 Debug 1.1 Areas 1.2 Character 2 Physics 2.1 Visibility Check 2.2 Collisions 2.3 Splash

Debug

Command: es_dump_entities 
script: 
help: Dumps current entities and their states!


Command: es_dump_entity_classes_in_use 
script: 
help: Dumps all used entity classes

variable: es_debug 
type: int
current: 0
help: Enable entity debugging info
Usage: es_debug [0/1]
Default is 0 (on).

variable: es_debug_not_seen_timeout DUMPTODISK
type: int
current: 0
help: if true, log messages when entities undergo not seen timeout

variable: es_DebugEvents 
type: int
current: 0
help: Enables logging of entity events


variable: es_DebugFindEntity 
type: int
current: 0
help: 

variable: es_DebugTimers 
type: int
current: 0
help: This is for profiling and debugging (for game coders and level designer)
By enabling this you get a lot of console printouts that show all entities that receive OnTimer
events - it's good to minimize the call count. Certain entities might require this feature and
using less active entities can often be defined by the level designer.
Usage: es_DebugTimers 0/1

Areas

Command: es_compile_area_grid 
script: 
help: Trigger a recompile of the area grid

variable: es_DrawAreaGrid 
type: int
current: 0
help: Enables drawing of Area Grid

variable: es_DrawAreas 
type: int
current: 0
help: Enables drawing of Areas

Character

variable: es_CharZOffsetSpeed DUMPTODISK
type: float
current: 2
help: sets the character Z-offset change speed (in m/s), used for IK

variable: es_HitCharacters 
type: int
current: 1
help: specifies whether alive characters are affected by bullet hits (0 or 1)

variable: es_HitDeadBodies 
type: int
current: 1
help: specifies whether dead bodies are affected by bullet hits (0 or 1)

variable: es_activateEntity 
type: string
current: 
help: Activates an entity

variable: es_bboxes 
type: int
current: 0
help: Toggles entity bounding boxes.
Usage: es_bboxes [0/1]
Default is 0 (off). Set to 1 to display bounding boxes.

variable: es_deactivateEntity 
type: string
current: 
help: Deactivates an entity

variable: es_DebrisLifetimeScale 
type: float
current: 0.8
help: 
Usage: es_DebrisLifetimeScale 1.0

variable: es_enable_full_script_save SAVEGAME, DUMPTODISK
type: int
current: 0
help: Enable (experimental) full script save functionality

variable: es_helpers 
type: int
current: 0
help: Toggles helpers.
Usage: es_helpers [0/1]
Default is 0 (off). Set to 1 to display entity helpers.

variable: es_not_seen_timeout DUMPTODISK
type: int
current: 30
help: number of seconds after which to cleanup temporary render buffers in entity

variable: es_profileentities 
type: int
current: 0
help: 
Usage: 1,2,3
Default is 0 (off).

variable: es_removeEntity 
type: string
current: 
help: Removes an entity

variable: es_sortupdatesbyclass 
type: int
current: 0
help: Sort entity updates by class (possible optimization)

variable: es_UpdateAI 
type: int
current: 1
help: Toggles updating of AI entities.
Usage: es_UpdateAI [0/1]
Default is 1 (on). Set to 0 to prevent AI entities from updating.

variable: es_UpdateContainer 
type: int
current: 1
help: 
Usage: es_UpdateContainer [0/1]
Default is 1 (on).

variable: es_UpdateEntities 
type: int
current: 1
help: Toggles entity updating.
Usage: es_UpdateEntities [0/1]
Default is 1 (on). Set to 0 to prevent all entities from updating.



variable: es_UpdateScript 
type: int
current: 1
help: 
Usage: 
Default is 1 (on).

variable: es_UpdateTimer 
type: int
current: 1
help: 
Usage: es_UpdateTimer [0/1]
Default is 1 (on).

Physics

Visibility Check

variable: es_UsePhysVisibilityChecks 
type: int
current: 1
help: Activates physics quality degradation and forceful sleeping for invisible and faraway entities

variable: es_MaxPhysDist 
type: float
current: 200
help: Physical entities farther from the camera than this are forcefully deactivated

variable: es_MaxPhysDistInvisible 
type: float
current: 25
help: Invisible physical entities farther from the camera than this are forcefully deactivated


variable: es_VisCheckForUpdate 
type: int
current: 1
help: 
Usage: es_VisCheckForUpdate [0/1]
Default is 1 (on).

variable: es_FarPhysTimeout 
type: float
current: 4
help: Timeout for faraway physics forceful deactivation

variable: es_UpdatePhysics 
type: int
current: 1
help: Toggles updating of entity physics.
Usage: es_UpdatePhysics [0/1]
Default is 1 (on). Set to 0 to prevent entity physics from updating.

variable: es_MaxImpulseAdjMass 
type: float
current: 2000
help: 
Usage: es_MaxImpulseAdjMass 2000.0

variable: es_MinImpulseVel 
type: float
current: 0
help: 
Usage: es_MinImpulseVel 0.0


variable: es_OnDemandPhysics 
type: int
current: 0
help: 
Usage: es_OnDemandPhysics [0/1]
Default is 1 (on).

variable: es_ImpulseScale 
type: float
current: 0
help: 
Usage: es_ImpulseScale 0.0

Collisions

variable: es_log_collisions 
type: int
current: 0
help: Enables collision events logging


variable: es_UpdateCollision 
type: int
current: 1
help: Toggles updating of entity collisions.
Usage: es_UpdateCollision [0/1]
Default is 1 (on). Set to 0 to disable entity collision updating.

variable: es_UpdateCollisionScript 
type: int
current: 1
help: 
Usage: es_UpdateCollisionScript [0/1]
Default is 1 (on).

Splash

variable: es_SplashThreshold 
type: float
current: 1
help: minimum instantaneous water resistance that is detected as a splashUsage: es_SplashThreshold 200.0


variable: es_SplashTimeout 
type: float
current: 3
help: minimum time interval between consecutive splashesUsage: es_SplashTimeout 3.0