Globalname

This is a draft page. It is a work in progress open to editing by anyone.
Remember to check for any notes left by the tagger at this article's talk page.

Stub

This article or section is a stub. You can help by expanding it.

globalname is a keyvalue available in all Source games. It's a name to designate two entities in different maps as being logically the same entity. When player transitions from map A to B the entity in map B with matching globalname will get most of its properties from entity that was in map A like origin, angles, color etc. (model for example is not transferred). If the entity was killed in map A it will not spawn in map B.

Warning:Setting this in round based games will cause an entity to not respawn on round restart because entities are killed when round ends.

Important:Don't use in Left 4 Dead series as the transition works differently and globalname is not used in this manner.

Placement Tip:This is important when wanting to transition brush entities as brush models are saved within a map file and is the reason model is one of the properties that isn't transferred.

Other ways to ensure no duplicate (logically same) entities between transition is properly utilizing logic_auto outputs like OnNewGame, OnMapTransition.

Examples

Note:There are several in Half-Life 2

d1_canals_05 / d1_canals_06

The following func_breakables and func_physboxes use globalname to properly preserve state between transitions. File:Todo1

After destroying the func_breakable we can see the following global states using dump_globals command output. File:Todo2

] dump_globals 
is_pc: d1_canals_05 (On) = 217026304
-- Globals --
05.breakable01_2: d1_canals_05 (On) = 12110476
skill.cfg: d1_canals_05 (On) = 0
05.breakable01_1: d1_canals_05 (On) = 12110476
is_console: d1_canals_05 (Off) = 1560839504
05.breakable02_4: d1_canals_05 (Dead) = 12110476
05.breakable02_1: d1_canals_05 (Dead) = 12110476
05.breakable02_5: d1_canals_05 (Dead) = 12110476
05.breakable02_6: d1_canals_05 (Dead) = 12110476
05.breakable02_2: d1_canals_05 (Dead) = 12110476
05.breakable02_3: d1_canals_05 (Dead) = 12110476

After transition we can see states preserved and model name being different. File:Todo3

See also

• targetname
• classname