Multisource

GoldSrc

Source Engine

This entity is obsolete. Its use is discouraged. It may only exist/function in older engine branches.
It has since been deprecated by: logic_branch_listener.

This entity is not in the FGD by default.
See below for instructions on making it available.

Class hierarchy
CMultiSource ↳CLogicalEntity ↳CServerOnlyEntity ↳CBaseEntity
logicentities.cpp

multisource is a logical entity available in all Source games.

Deprecated entity from GoldSrc, only used in Half Life: Source, deprecated by logic_branch_listener in Source.

This entity is the only entity that can be used as a master. (Entities that specify a master cannot be enabled unless their master is enabled.)

Keyvalues

Name (targetname) <string>[ Edit ]

The name that other entities refer to this entity by, via Inputs/Outputs or other keyvalues (e.g. parentname or target).
Also displayed in Hammer's 2D views and Entity Report.

See also:  Generic Keyvalues, Inputs and Outputs available to all entities

Global State Master (globalstate) <string>

Fire outputs only if this global state is ON.

Inputs

Use

Multisource contains a list of all entities that are targeting it (i.e. target keyvalue of an entity is set to targetname of the multisource) and a state ON/OFF for each entity in the list. If an entity from the list is caller of this input the state is toggled. If all states are ON then OnTrigger output is fired.

Bug:If a caller of this input is not in the list, the game is supposed to print warning in console and ignore the input but instead it toggles the state of last entity in the list.

Code Fix:Change the condition in CMultiSource::Use() from i > m_iTotal to i >= m_iTotal. See GitHub PR.

  (tested in: l4d2 and checked sdk2013 source code)

Outputs

OnTrigger

!activator = activator of Use input
!caller = this entity
When Use input is successful

Example

Example with 3 entities which target the multisource. All entities that target multisource must send the Use input to it and also be the caller. (the caller is in rare cases not the entity from which the output originates )

{
"classname" "multisource"
"targetname" "ALL_THAT_TARGET_ME_MUST_USE_ME_TO_TRIGGER_ME"
"OnTrigger" "door,Unlock,,,"
}
{
"classname" "info_target"
"targetname" "FireUser1_on_me_before_letting_you_proceed"
"target" "ALL_THAT_TARGET_ME_MUST_USE_ME_TO_TRIGGER_ME"
"OnUser1" "ALL_THAT_TARGET_ME_MUST_USE_ME_TO_TRIGGER_ME,Use,,,1"
}
{
"classname" "trigger_multiple"
"targetname" "Touch_me_before_you_proceed"
"target" "ALL_THAT_TARGET_ME_MUST_USE_ME_TO_TRIGGER_ME"
"OnStartTouch" "ALL_THAT_TARGET_ME_MUST_USE_ME_TO_TRIGGER_ME,Use,,,1"
}
{
"classname" "func_button"
"targetname" "Press_me_before_you_proceed"
"target" "ALL_THAT_TARGET_ME_MUST_USE_ME_TO_TRIGGER_ME"
"OnPressed" "ALL_THAT_TARGET_ME_MUST_USE_ME_TO_TRIGGER_ME,Use,,,1"
}

FGD Code

@PointClass iconsprite("editor/multisource.vmt") base(Targetname) color(128 255 128) = multisource : "Multisource"
[
	target(target_destination) : "Target"
	globalstate(string) : "Global State Master"
	input Use(void)
	output OnTrigger(void)
]

See also

• multi_manager