addMPEventHandler - Revision history

Lou Montana: Text replacement - "{{Link|:Category:" to "{{Link|Category:"

2024-10-16T13:52:05Z

Text replacement - "{{Link|:Category:" to "{{Link|Category:"

← Older revision		Revision as of 15:52, 16 October 2024
Line 18:		Line 18:
	\|eff= global		\|eff= global

	\|descr= Adds a multiplayer event handler (EH) to the given object and returns EH handle. See {{Link\|:Category:Event Handlers\|Event Handlers}}.		\|descr= Adds a multiplayer event handler (EH) to the given object and returns EH handle. See {{Link\|Category:Event Handlers\|Event Handlers}}.
	{{Feature\|important\|A Multiplayer Event Handler is '''not''' saved in a save file and therefore will not be restored on load - use it accordingly.}}		{{Feature\|important\|A Multiplayer Event Handler is '''not''' saved in a save file and therefore will not be restored on load - use it accordingly.}}

	\|mp= Multiplayer EHs are added globally to every client and the server will fire on itself and every client upon event.		\|mp= Multiplayer EHs are added globally to every client and the server will fire on itself and every client upon event.
	The only exception is the '''MPRespawn''' EH that one only fires where the respawned unit is local. Make sure to check the EHs' locality in {{Link\|:Category:Event Handlers\|Event Handlers}} pages.		The only exception is the '''MPRespawn''' EH that one only fires where the respawned unit is local. Make sure to check the EHs' locality in {{Link\|Category:Event Handlers\|Event Handlers}} pages.

	\|s1= object [[addMPEventHandler]] [type, expression]		\|s1= object [[addMPEventHandler]] [type, expression]

Lou Montana: Text replacement - "(\|[pr][0-9]+ = [^-]+) - E([a-z])" to "$1 - e$2"

2023-11-08T13:06:09Z

Text replacement - "(\|[pr][0-9]+ *= *[^-]+) *- *E([a-z])" to "$1 - e$2"

← Older revision		Revision as of 15:06, 8 November 2023
Line 30:		Line 30:
	\|p2= type: [[String]] - event handler name		\|p2= type: [[String]] - event handler name

	\|p3= expression: [[String]] or [[Code]] - ~~Expression~~ to execute.<br>		\|p3= expression: [[String]] or [[Code]] - expression to execute.<br>
	If EH has some data to return upon event (e.g. the "MPKilled" EH will return an array with 2 elements: the killed unit, and the killer), it is passed in {{hl\|_this}} variable.		If EH has some data to return upon event (e.g. the "MPKilled" EH will return an array with 2 elements: the killed unit, and the killer), it is passed in {{hl\|_this}} variable.
	{{Feature\|arma3\|Since Arma 3 v.1.64 the EH handle is also stored in {{hl\|_thisEventHandler}} variable and is available during EH code execution.}}		{{Feature\|arma3\|Since Arma 3 v.1.64 the EH handle is also stored in {{hl\|_thisEventHandler}} variable and is available during EH code execution.}}

Lou Montana: Add save note

2023-03-29T09:25:39Z

Add save note

← Older revision		Revision as of 11:25, 29 March 2023
Line 19:		Line 19:

	\|descr= Adds a multiplayer event handler (EH) to the given object and returns EH handle. See {{Link\|:Category:Event Handlers\|Event Handlers}}.		\|descr= Adds a multiplayer event handler (EH) to the given object and returns EH handle. See {{Link\|:Category:Event Handlers\|Event Handlers}}.
			{{Feature\|important\|A Multiplayer Event Handler is '''not''' saved in a save file and therefore will not be restored on load - use it accordingly.}}

	\|mp= Multiplayer EHs are added globally to every client and the server will fire on itself and every client upon event.		\|mp= Multiplayer EHs are added globally to every client and the server will fire on itself and every client upon event.

Lou Montana: Add _thisEvent and _thisEventHandler

2023-03-28T21:23:06Z

Add _thisEvent and _thisEventHandler

← Older revision		Revision as of 23:23, 28 March 2023
Line 18:		Line 18:
	\|eff= global		\|eff= global

	\|descr= Adds a multiplayer event handler (EH) to the given object and returns EH handle.		\|descr= Adds a multiplayer event handler (EH) to the given object and returns EH handle. See {{Link\|:Category:Event Handlers\|Event Handlers}}.

	~~{{Feature \| Informative \| For more information, see [[Arma_3:_Event_Handlers#Multiplayer_Event_Handlers\|Event Handlers/addMPEventHandler]].}}~~		\|mp= Multiplayer EHs are added globally to every client and the server will fire on itself and every client upon event.
			The only exception is the '''MPRespawn''' EH that one only fires where the respawned unit is local. Make sure to check the EHs' locality in {{Link\|:Category:Event Handlers\|Event Handlers}} pages.
	\|mp= Multiplayer EHs are added globally to every client and the server ~~and~~ will fire on every client ~~and server~~ upon event. ~~Only~~ exception is the '''MPRespawn''' EH~~. That~~ one only fires where the respawned unit is local. Make sure to check the locality ~~of the EHs on [[~~:Category:Event Handlers\|~~EventHandlers List]]~~.

	\|s1= object [[addMPEventHandler]] [type, expression]		\|s1= object [[addMPEventHandler]] [type, expression]

	\|p1= object: [[Object]] - ~~Object~~ to monitor		\|p1= object: [[Object]] - object to monitor

	\|p2= type: [[String]] - ~~Event~~ handler name		\|p2= type: [[String]] - event handler name

	\|p3= expression: [[String]] or [[Code]] - Expression to execute.<br>If EH has some data to return upon event (e.g. the "MPKilled" EH will return an array with 2 elements: the killed unit, and the killer), it is passed in {{hl\|_this}} variable.		\|p3= expression: [[String]] or [[Code]] - Expression to execute.<br>
			If EH has some data to return upon event (e.g. the "MPKilled" EH will return an array with 2 elements: the killed unit, and the killer), it is passed in {{hl\|_this}} variable.
	{{Feature\|arma3\|Since Arma 3 v.1.64 the EH handle is also stored in {{hl\|_thisEventHandler}} variable and is available during EH code execution.}}		{{Feature\|arma3\|Since Arma 3 v.1.64 the EH handle is also stored in {{hl\|_thisEventHandler}} variable and is available during EH code execution.}}
			* Event Handler parameters are accessible via <sqf inline>_this</sqf>
			* The Event Handler type is available as <sqf inline>_thisEvent</sqf>
			* The Event Handler index is available as <sqf inline>_thisEventHandler</sqf>

	\|r1= [[Number]] - ~~Eventhandler~~ index		\|r1= [[Number]] - event handler index

	\|x1= <sqf>_index = player addMPEventHandler ["MPKilled", { _this execVM "playerKilled.sqf"; }];</sqf>		\|x1= <sqf>_index = player addMPEventHandler ["MPKilled", { _this execVM "playerKilled.sqf"; }];</sqf>

Killzone Kid at 14:59, 6 July 2022

2022-07-06T14:59:57Z

← Older revision		Revision as of 16:59, 6 July 2022
Line 37:		Line 37:
	\|x1= <sqf>_index = player addMPEventHandler ["MPKilled", { _this execVM "playerKilled.sqf"; }];</sqf>		\|x1= <sqf>_index = player addMPEventHandler ["MPKilled", { _this execVM "playerKilled.sqf"; }];</sqf>

	\|seealso= [[:Category:Event Handlers\|EventHandlers List]] [[removeMPEventHandler]] [[removeAllMPEventHandlers]]		\|seealso= [[:Category:Event Handlers\|EventHandlers List]] [[removeMPEventHandler]] [[removeAllMPEventHandlers]] [[getEventHandlerInfo]]
	}}		}}

Lou Montana: Text replacement - "\|x([0-9])= `([^<])<\/code>" to "|x$1= $2"`


2022-05-13T09:21:25Z
Text replacement - "\|x([0-9])= *<code>([^<]*)<\/code>" to "|x$1= <sqf>$2</sqf>"

				
				
				
				
				
				← Older revision
				Revision as of 11:21, 13 May 2022
				
Line 35:
Line 35:
|r1= [[Number]] - Eventhandler index |r1= [[Number]] - Eventhandler index



|x1= <code>_index = player addMPEventHandler ["MPKilled", { _this execVM "playerKilled.sqf"; }];</code> |x1= <sqf>_index = player addMPEventHandler ["MPKilled", { _this execVM "playerKilled.sqf"; }];</sqf>



|seealso= [[:Category:Event Handlers|EventHandlers List]] [[removeMPEventHandler]] [[removeAllMPEventHandlers]] |seealso= [[:Category:Event Handlers|EventHandlers List]] [[removeMPEventHandler]] [[removeAllMPEventHandlers]]
}} }}



Lou Montana: Text replacement - "([^<]*)\[\[Magic Variables#this\|(_this)\]\]([^<]*)<\/code>" to "$1$2$3"

2022-05-13T08:27:45Z
Text replacement - "<code>([^<]*)\[\[Magic Variables#this\|(_this)\]\]([^<]*)<\/code>" to "<code>$1$2$3</code>"

				
				
				
				
				
				← Older revision
				Revision as of 10:27, 13 May 2022
				
Line 35:
Line 35:
|r1= [[Number]] - Eventhandler index |r1= [[Number]] - Eventhandler index



|x1= <code>_index = player addMPEventHandler ["MPKilled", { [[Magic Variables#this|_this]] execVM "playerKilled.sqf"; }];</code> |x1= <code>_index = player addMPEventHandler ["MPKilled", { _this execVM "playerKilled.sqf"; }];</code>



|seealso= [[:Category:Event Handlers|EventHandlers List]] [[removeMPEventHandler]] [[removeAllMPEventHandlers]] |seealso= [[:Category:Event Handlers|EventHandlers List]] [[removeMPEventHandler]] [[removeAllMPEventHandlers]]
}} }}



Lou Montana: Text replacement - "([^
]*)\[\[([a-zA-Z0-9_]+)\]\]([^
]*)<\/code>" to "$1$2$3"

2022-05-12T10:02:07Z
Text replacement - "<code>([^ ]*)\[\[([a-zA-Z0-9_]+)\]\]([^ ]*)<\/code>" to "<code>$1$2$3</code>"

				
				
				
				
				
				← Older revision
				Revision as of 12:02, 12 May 2022
				
Line 35:
Line 35:
|r1= [[Number]] - Eventhandler index |r1= [[Number]] - Eventhandler index



|x1= <code>_index = player addMPEventHandler ["MPKilled", { [[Magic Variables#this|_this]] [[execVM]] "playerKilled.sqf"; }];</code> |x1= <code>_index = player addMPEventHandler ["MPKilled", { [[Magic Variables#this|_this]] execVM "playerKilled.sqf"; }];</code>



|seealso= [[:Category:Event Handlers|EventHandlers List]] [[removeMPEventHandler]] [[removeAllMPEventHandlers]] |seealso= [[:Category:Event Handlers|EventHandlers List]] [[removeMPEventHandler]] [[removeAllMPEventHandlers]]
}} }}



Lou Montana: Text replacement - "([^
]*)\[\[([a-zA-Z0-9_]+)\]\]([^
]*)<\/code>" to "$1$2$3"

2022-05-12T10:01:19Z
Text replacement - "<code>([^ ]*)\[\[([a-zA-Z0-9_]+)\]\]([^ ]*)<\/code>" to "<code>$1$2$3</code>"

				
				
				
				
				
				← Older revision
				Revision as of 12:01, 12 May 2022
				
Line 35:
Line 35:
|r1= [[Number]] - Eventhandler index |r1= [[Number]] - Eventhandler index



|x1= <code>_index = player [[addMPEventHandler]] ["MPKilled", { [[Magic Variables#this|_this]] [[execVM]] "playerKilled.sqf"; }];</code> |x1= <code>_index = player addMPEventHandler ["MPKilled", { [[Magic Variables#this|_this]] [[execVM]] "playerKilled.sqf"; }];</code>



|seealso= [[:Category:Event Handlers|EventHandlers List]] [[removeMPEventHandler]] [[removeAllMPEventHandlers]] |seealso= [[:Category:Event Handlers|EventHandlers List]] [[removeMPEventHandler]] [[removeAllMPEventHandlers]]
}} }}



Lou Montana: Text replacement - "([a-zA-Z0-9\. _"']+)<\/tt>" to "{{hl|$1}}"

2021-11-15T22:46:46Z
Text replacement - "<tt>([a-zA-Z0-9\. _"']+)<\/tt>" to "{{hl|$1}}"

				
				
				
				
				
				← Older revision
				Revision as of 00:46, 16 November 2021
				
Line 30:
Line 30:
|p2= type: [[String]] - Event handler name |p2= type: [[String]] - Event handler name



|p3= expression: [[String]] or [[Code]] - Expression to execute.<br>If EH has some data to return upon event (e.g. the "MPKilled" EH will return an array with 2 elements: the killed unit, and the killer), it is passed in <tt>_this</tt> variable. |p3= expression: [[String]] or [[Code]] - Expression to execute.<br>If EH has some data to return upon event (e.g. the "MPKilled" EH will return an array with 2 elements: the killed unit, and the killer), it is passed in {{hl|_this}} variable.
{{Feature|arma3|Since Arma 3 v.1.64 the EH handle is also stored in <tt>_thisEventHandler</tt> variable and is available during EH code execution.}} {{Feature|arma3|Since Arma 3 v.1.64 the EH handle is also stored in {{hl|_thisEventHandler}} variable and is available during EH code execution.}}



|r1= [[Number]] - Eventhandler index |r1= [[Number]] - Eventhandler index

addMPEventHandler - Revision history

Lou Montana: Text replacement - "{{Link|:Category:" to "{{Link|Category:"

Lou Montana: Text replacement - "(\|[pr][0-9]+ = [^-]+) - E([a-z])" to "$1 - e$2"

Lou Montana: Add save note

Lou Montana: Add _thisEvent and _thisEventHandler

Killzone Kid at 14:59, 6 July 2022

Lou Montana: Text replacement - "\|x([0-9])= `([^<])<\/code>" to "|x$1= $2"`

Lou Montana: Text replacement - "`([^<])\[\[Magic Variables#this\|(_this)\]\]([^<])<\/code>" to "$1$2$3"`

Lou Montana: Text replacement - "`([^ ])\[\[([a-zA-Z0-9_]+)\]\]([^ ])<\/code>" to "$1$2$3"`

Lou Montana: Text replacement - "`([^ ])\[\[([a-zA-Z0-9_]+)\]\]([^ ])<\/code>" to "$1$2$3"`

Lou Montana: Text replacement - "`([a-zA-Z0-9\. _"']+)<\/tt>" to "{{hl|$1}}"`

← Older revision		Revision as of 11:21, 13 May 2022
Line 35:		Line 35:
	\|r1= [[Number]] - Eventhandler index		\|r1= [[Number]] - Eventhandler index

	\|x1= <~~code~~>_index = player addMPEventHandler ["MPKilled", { _this execVM "playerKilled.sqf"; }];</~~code~~>		\|x1= <sqf>_index = player addMPEventHandler ["MPKilled", { _this execVM "playerKilled.sqf"; }];</sqf>

	\|seealso= [[:Category:Event Handlers\|EventHandlers List]] [[removeMPEventHandler]] [[removeAllMPEventHandlers]]		\|seealso= [[:Category:Event Handlers\|EventHandlers List]] [[removeMPEventHandler]] [[removeAllMPEventHandlers]]
	}}		}}

← Older revision		Revision as of 10:27, 13 May 2022
Line 35:		Line 35:
	\|r1= [[Number]] - Eventhandler index		\|r1= [[Number]] - Eventhandler index

	\|x1= <code>_index = player addMPEventHandler ["MPKilled", { ~~[[Magic Variables#this\|~~_this]] execVM "playerKilled.sqf"; }];</code>		\|x1= <code>_index = player addMPEventHandler ["MPKilled", { _this execVM "playerKilled.sqf"; }];</code>

	\|seealso= [[:Category:Event Handlers\|EventHandlers List]] [[removeMPEventHandler]] [[removeAllMPEventHandlers]]		\|seealso= [[:Category:Event Handlers\|EventHandlers List]] [[removeMPEventHandler]] [[removeAllMPEventHandlers]]
	}}		}}

← Older revision		Revision as of 12:02, 12 May 2022
Line 35:		Line 35:
	\|r1= [[Number]] - Eventhandler index		\|r1= [[Number]] - Eventhandler index

	\|x1= <code>_index = player addMPEventHandler ["MPKilled", { [[Magic Variables#this\|_this]] [[execVM]] "playerKilled.sqf"; }];</code>		\|x1= <code>_index = player addMPEventHandler ["MPKilled", { [[Magic Variables#this\|_this]] execVM "playerKilled.sqf"; }];</code>

	\|seealso= [[:Category:Event Handlers\|EventHandlers List]] [[removeMPEventHandler]] [[removeAllMPEventHandlers]]		\|seealso= [[:Category:Event Handlers\|EventHandlers List]] [[removeMPEventHandler]] [[removeAllMPEventHandlers]]
	}}		}}

← Older revision		Revision as of 12:01, 12 May 2022
Line 35:		Line 35:
	\|r1= [[Number]] - Eventhandler index		\|r1= [[Number]] - Eventhandler index

	\|x1= <code>_index = player [[addMPEventHandler]] ["MPKilled", { [[Magic Variables#this\|_this]] [[execVM]] "playerKilled.sqf"; }];</code>		\|x1= <code>_index = player addMPEventHandler ["MPKilled", { [[Magic Variables#this\|_this]] [[execVM]] "playerKilled.sqf"; }];</code>

	\|seealso= [[:Category:Event Handlers\|EventHandlers List]] [[removeMPEventHandler]] [[removeAllMPEventHandlers]]		\|seealso= [[:Category:Event Handlers\|EventHandlers List]] [[removeMPEventHandler]] [[removeAllMPEventHandlers]]
	}}		}}

← Older revision		Revision as of 00:46, 16 November 2021
Line 30:		Line 30:
	\|p2= type: [[String]] - Event handler name		\|p2= type: [[String]] - Event handler name

	\|p3= expression: [[String]] or [[Code]] - Expression to execute.<br>If EH has some data to return upon event (e.g. the "MPKilled" EH will return an array with 2 elements: the killed unit, and the killer), it is passed in ~~<tt>~~_this~~</tt>~~ variable.		\|p3= expression: [[String]] or [[Code]] - Expression to execute.<br>If EH has some data to return upon event (e.g. the "MPKilled" EH will return an array with 2 elements: the killed unit, and the killer), it is passed in {{hl\|_this}} variable.
	{{Feature\|arma3\|Since Arma 3 v.1.64 the EH handle is also stored in ~~<tt>~~_thisEventHandler~~</tt>~~ variable and is available during EH code execution.}}		{{Feature\|arma3\|Since Arma 3 v.1.64 the EH handle is also stored in {{hl\|_thisEventHandler}} variable and is available during EH code execution.}}

	\|r1= [[Number]] - Eventhandler index		\|r1= [[Number]] - Eventhandler index

addMPEventHandler - Revision history

Lou Montana: Text replacement - "{{Link|:Category:" to "{{Link|Category:"

Lou Montana: Text replacement - "(\|[pr][0-9]+ *= *[^-]+) *- *E([a-z])" to "$1 - e$2"

Lou Montana: Add save note

Lou Montana: Add _thisEvent and _thisEventHandler

Killzone Kid at 14:59, 6 July 2022

Lou Montana: Text replacement - "\|x([0-9])= *([^<]*)<\/code>" to "|x$1= $2"

Lou Montana: Text replacement - "([^<]*)\[\[Magic Variables#this\|(_this)\]\]([^<]*)<\/code>" to "$1$2$3"

Lou Montana: Text replacement - "([^ ]*)\[\[([a-zA-Z0-9_]+)\]\]([^ ]*)<\/code>" to "$1$2$3"

Lou Montana: Text replacement - "([^ ]*)\[\[([a-zA-Z0-9_]+)\]\]([^ ]*)<\/code>" to "$1$2$3"

Lou Montana: Text replacement - "([a-zA-Z0-9\. _"']+)<\/tt>" to "{{hl|$1}}"

Lou Montana: Text replacement - "(\|[pr][0-9]+ = [^-]+) - E([a-z])" to "$1 - e$2"

Lou Montana: Text replacement - "\|x([0-9])= `([^<])<\/code>" to "|x$1= $2"`

Lou Montana: Text replacement - "`([^<])\[\[Magic Variables#this\|(_this)\]\]([^<])<\/code>" to "$1$2$3"`

Lou Montana: Text replacement - "`([^ ])\[\[([a-zA-Z0-9_]+)\]\]([^ ])<\/code>" to "$1$2$3"`

Lou Montana: Text replacement - "`([^ ])\[\[([a-zA-Z0-9_]+)\]\]([^ ])<\/code>" to "$1$2$3"`

Lou Montana: Text replacement - "`([a-zA-Z0-9\. _"']+)<\/tt>" to "{{hl|$1}}"`