Difference between revisions of "Osiris/API/TriggerRegisterForCharacter"
From Divinity Engine Wiki
(Documented TriggerRegisterForCharacter) |
m |
||
| (8 intermediate revisions by the same user not shown) | |||
| Line 2: | Line 2: | ||
* call '''TriggerRegisterForCharacter'''(''(TRIGGERGUID)'''''_Trigger''', ''(CHARACTERGUID)'''''_Character''') | * call '''TriggerRegisterForCharacter'''(''(TRIGGERGUID)'''''_Trigger''', ''(CHARACTERGUID)'''''_Character''') | ||
===== Description ===== | ===== Description ===== | ||
| − | Ensures that whenever | + | Ensures that whenever '''_Character''' enters resp. leaves '''_Trigger''', a [[Osiris/API/CharacterEnteredTrigger|CharacterEnteredTrigger]] resp. [[Osiris/API/CharacterLeftTrigger|CharacterLeftTrigger]] event will be thrown for this trigger/character combination. |
===== Return Values ===== | ===== Return Values ===== | ||
* None | * None | ||
===== Notes ===== | ===== Notes ===== | ||
| − | * / | + | * If you register a trigger for a character while the character is currently inside the trigger, a [[Osiris/API/CharacterEnteredTrigger|CharacterEnteredTrigger]] [[Osiris/API/CharacterLeftTrigger|CharacterLeftTrigger]] event will also be thrown. This even holds for characters placed in the editor and triggers registered in the INIT section of a story goal that gets initialised once the [[Osiris/API/RegionStarted|RegionStarted]] event for its containing level has executed. |
| + | * [[Triggers#Event_Trigger|Event]] triggers are automatically registered for all characters by the engine and should not be manually registered/unregistered. | ||
===== See Also ===== | ===== See Also ===== | ||
* [[Osiris/API/CharacterEnteredTrigger|CharacterEnteredTrigger]] | * [[Osiris/API/CharacterEnteredTrigger|CharacterEnteredTrigger]] | ||
| Line 14: | Line 15: | ||
* [[Osiris/API/TriggerUnregisterForPlayers|TriggerUnregisterForPlayers]] | * [[Osiris/API/TriggerUnregisterForPlayers|TriggerUnregisterForPlayers]] | ||
* [[Osiris/API/TriggerLaunchIterator|TriggerLaunchIterator]] | * [[Osiris/API/TriggerLaunchIterator|TriggerLaunchIterator]] | ||
| − | * Helper [[Osiris/Shared/DB_InRegion | + | * Helper [[Osiris/Shared/DB_InRegion|DB_InRegion]] |
| − | [[Category:Osiris Calls]] | + | [[Category:Osiris Calls|TriggerRegisterForCharacter]] |
Latest revision as of 16:27, 19 December 2017
Full Definition(s)
- call TriggerRegisterForCharacter((TRIGGERGUID)_Trigger, (CHARACTERGUID)_Character)
Description
Ensures that whenever _Character enters resp. leaves _Trigger, a CharacterEnteredTrigger resp. CharacterLeftTrigger event will be thrown for this trigger/character combination.
Return Values
- None
Notes
- If you register a trigger for a character while the character is currently inside the trigger, a CharacterEnteredTrigger CharacterLeftTrigger event will also be thrown. This even holds for characters placed in the editor and triggers registered in the INIT section of a story goal that gets initialised once the RegionStarted event for its containing level has executed.
- Event triggers are automatically registered for all characters by the engine and should not be manually registered/unregistered.
