Multiplayer Framework – Arma 2

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - "{{SideTOC}}" to "{{TOC|side}}")
m (Text replacement - "{{Feature | Informative | " to "{{Feature|informative|")
 
(9 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{Feature|arma3|This page is about {{arma2}} and doesn't apply to {{arma3}}. In {{arma3}}, use [[remoteExec]] or [[remoteExecCall]].}}
{{Feature|arma3|This page is about {{arma2}} and does not apply to {{arma3}}. In {{arma3}}, use [[remoteExec]] or [[remoteExecCall]].}}




Line 12: Line 12:
* allows persistent calls - are performed on JIP client even if server processed given MPF call before client connected to game ("per" switch)
* allows persistent calls - are performed on JIP client even if server processed given MPF call before client connected to game ("per" switch)


{{Important | Do '''not''' overwrite '''RE''' variable in your missions when using MPF. Do not use rHINT, rSIDECHAT etc [[Identifier]]s (see library below)}}
{{Feature|important|Do '''not''' overwrite '''RE''' variable in your missions when using MPF. Do not use rHINT, rSIDECHAT etc [[Identifier]]s (see library below)}}




Line 26: Line 26:
# (if wanted) ''remExServer.sqf'' calls script (given as argument) on client that runs even handler
# (if wanted) ''remExServer.sqf'' calls script (given as argument) on client that runs even handler


{{Informative | Remote execution executes script also on calling client (if "loc" flag set, or "loc" not set and object is local on caller client)}}
{{Feature|informative|Remote execution executes script also on calling client (if "loc" flag set, or "loc" not set and object is local on caller client)}}


=== Usage ===
=== Usage ===
Line 32: Line 32:
==== How-to ====
==== How-to ====
* Include functions module in your mission
* Include functions module in your mission
* Wait for global variable "BIS_MPF_InitDone" to be defined (and true): <code>[[waitUntil]] { !([[isNil]] "BIS_MPF_InitDone"); };</code>
* Wait for global variable "BIS_MPF_InitDone" to be defined (and true): <sqf inline>waitUntil { !(isNil "BIS_MPF_InitDone"); };</sqf>
* In scripts or FSMs call: {{Inline code|_handler {{=}} [...] [[call]] '''RE''';}} (syntax - see below; RE stands for remote execution)
* In scripts or FSMs call: <sqf inline>_handler = [/*...*/] call RE;</sqf> (syntax - see below; RE stands for remote execution)


==== Format ====
==== Format ====
Line 42: Line 42:
* "loc"...arbitrary parameter - executes remote script only on machine where ''nil_or_target_object'' is local
* "loc"...arbitrary parameter - executes remote script only on machine where ''nil_or_target_object'' is local
* "per"...arbitrary parameter - executes remote script even on JIP client connectiong *after* this RE call was executed in MP game
* "per"...arbitrary parameter - executes remote script even on JIP client connectiong *after* this RE call was executed in MP game
* script_to_execute - ''usually'' <tt>r + uppercase command</tt> (see [[#Available Commands|available commands]]) e.g for [[hint]]: rHINT
* script_to_execute - ''usually'' {{hl|r + uppercase command}} (see [[#Available Commands|available commands]]) e.g for [[hint]]: rHINT
* RE...remote execution (short for remExWrite.sqf)
* RE...remote execution (short for remExWrite.sqf)


==== Examples ====
==== Examples ====
Hint on all clients currently connected to the MP game:
Hint on all clients currently connected to the MP game:
[<nowiki/>[[nil]], [[nil]], rHINT, "Enjoy the game."] [[call]] '''RE''';
<sqf>[nil, nil, rHINT, "Enjoy the game."] call RE;</sqf>


Hint on all clients currently connected to the MP game + executed also on JIP client just after connection
Hint on all clients currently connected to the MP game + executed also on JIP client just after connection
[<nowiki/>[[nil]], [[nil]], "per", rHINT, "Enjoy the game."] [[call]] '''RE''';
<sqf>[nil, nil, "per", rHINT, "Enjoy the game."] call RE;</sqf>


Hint on client where object ''miles'' is local:
Hint on client where object ''miles'' is local:
[<nowiki/>[[nil]], miles, "loc", rHINT, "Miles is local here."] [[call]] '''RE''';
<sqf>[nil, miles, "loc", rHINT, "Miles is local here."] call RE;</sqf>


Hint on client where number 0 from players group is local. If JIP client connects to this slot, he got also his msg displayed:
Hint on client where number 0 from players group is local. If JIP client connects to this slot, he got also his msg displayed:
[<nowiki/>[[nil]], ([[units]] [[group]] [[player]]) [[select]] 0, "loc" + "per", rHINT, "Hint."] [[call]] '''RE''';
<sqf>[nil, (units group player) select 0, "loc" + "per", rHINT, "Hint."] call RE;</sqf>


Multiple parameters
Multiple parameters
[<nowiki/>[[objNull]], BIS_Rodriguez , "per", rKBADDTOPIC, "armstrongs_speech",  "kb\armstrongs_speech.bikb",  ""] [[call]] '''RE''';
<sqf>[objNull, BIS_Rodriguez , "per", rKBADDTOPIC, "armstrongs_speech",  "kb\armstrongs_speech.bikb",  ""] call RE;</sqf>
{{Informative | "kb\armstrongs_speech.bikb" here becomes {{Inline code|(_this [[select]] 1)}} in '''kbAddTopic.sqf''' library script.}}
{{Feature|informative|{{hl|"kb\armstrongs_speech.bikb"}} here becomes <sqf inline>_this select 1</sqf> in '''kbAddTopic.sqf''' library script.}}




Line 83: Line 83:
! Additional Information
! Additional Information
|-
|-
| move || [[move]] || rMOVE ||
| addAction || [[addAction]] || rADDACTION ||
|-
| addMagazine || [[addMagazine]] || rADDMAGAZINE ||
|-
| addMagazineCargo || [[addMagazineCargo]] || rADDMAGAZINECARGO ||
|-
|-
| moveIn || {{n/a}} || rMOVEIN || can replace [[moveInDriver]], [[moveInGunner]], [[moveInCommander]], [[moveInCargo]]
| addWeapon || [[addWeapon]] || rADDWEAPON ||
|-
|-
| land || [[land]] || rLAND ||
| addWeaponCargo || [[addWeaponCargo]] || rADDWEAPONCARGO ||
|-
|-
| addWPCur || {{n/a}} || rADDWPCUR || takes object and for his group on his local sets current WP
| addWPCur || {{n/a}} || rADDWPCUR || takes object and for his group on his local sets current WP
Line 93: Line 97:
| animate || [[animate]] || rANIMATE ||
| animate || [[animate]] || rANIMATE ||
|-
|-
| setDate || [[setDate]] || rSETDATE ||
| callVar || {{n/a}} || rCALLVAR || (1.03) - calls code that is stored in variable on client
|-
| clearMagazineCargo || [[clearMagazineCargo]] || rCLEARMAGAZINECARGO ||
|-
| clearWeaponCargo || [[clearWeaponCargo]] || rCLEARWEAPONCARGO ||
|-
|-
| playmusic || [[playMusic]] || rPLAYMUSIC ||
| createDiaryRecord || [[createDiaryRecord]] || rCREATEDIARYRECORD ||
|-
|-
| playsound || [[playSound]] || rPLAYSOUND ||
| createSimpleTask || [[createSimpleTask]] || rCREATESIMPLETASK ||
|-
|-
| switchmove || [[switchMove]] || rSWITCHMOVE ||
| createTaskSet || {{n/a}} || rCREATETASKSET ||
|-
| debugLog || [[debugLog]] || rDEBUGLOG ||
|-
|-
| playmove || [[playMove]] || rPLAYMOVE ||
| deleteWP || [[deleteWaypoint]] || rDELETEWP ||
|-
|-
| playmovenow || [[playMoveNow]] || rPLAYMOVENOW ||
| enableSimulation || [[enableSimulation]] || rENABLESIMULATION ||
|-
|-
| playAction || [[playAction]] || rPLAYACTION ||
| endMission || [[endMission]] || rENDMISSION ||
|-
|-
| playActionnow || [[playActionNow]] || rPLAYACTIONNOW ||
| execFSM || [[execFSM]] || rEXECFSM ||
|-
|-
| switchAction || [[switchAction]] || rSWITCHACTION ||
| execVM || [[execVM]] || rEXECVM ||
|-
|-
| hint || [[hint]] || rHINT ||
| fadeMusic || [[fadeMusic]] || rFADEMUSIC ||
|-
|-
| hintC || [[hintC]] || rHINTC ||
| fadeSound || [[fadeSound]] || rFADESOUND ||
|-
|-
| showCommandingMenu || [[showCommandingMenu]] || rSHOWCOMMANDINGMENU ||
| failMission || [[failMission]] || rFAILMISSION ||
|-
|-
| globalChat || [[globalChat]] || rGLOBALCHAT ||
| globalChat || [[globalChat]] || rGLOBALCHAT ||
|-
|-
| globalRadio || [[globalRadio]] || rGLOBALRADIO ||
| globalRadio || [[globalRadio]] || rGLOBALRADIO ||
|-
| sideChat || [[sideChat]] || rSIDECHAT ||
|-
| sideRadio || [[sideRadio]] || rSIDERADIO ||
|-
|-
| groupChat || [[groupChat]] || rGROUPCHAT ||
| groupChat || [[groupChat]] || rGROUPCHAT ||
Line 129: Line 135:
| groupRadio || [[groupRadio]] || rGROUPRADIO ||
| groupRadio || [[groupRadio]] || rGROUPRADIO ||
|-
|-
| kbAddTopic || [[kbAddTopic]] || rKBADDTOPIC ||
| hint || [[hint]] || rHINT ||
|-
|-
| kbRemoveTopic || [[kbRemoveTopic]] || rKBREMOVETOPIC ||
| hintC || [[hintC]] || rHINTC ||
|-
|-
| kbtell || [[kbTell]] || rKBTELL ||
| JIPexec || {{n/a}} || rJIPEXEC || custom scripting functions
|-
|-
| kbreact || [[kbReact]] || rKBREACT ||
| JIPrequest || {{n/a}} || rJIPREQUEST || requesting JIP (RE persistent commands) from server by executing this via RE (on server) - parameter: logic local on client
|-
|-
| deleteWP || [[deleteWaypoint]] || rDELETEWP ||
| kbAddTopic || [[kbAddTopic]] || rKBADDTOPIC ||
|-
|-
| setWPdesc || [[setWaypointDescription]] || rSETWPDESC ||
| kbReact || [[kbReact]] || rKBREACT ||
|-
|-
| setWPtype || [[setWaypointType]] || rSETWPTYPE ||
| kbRemoveTopic || [[kbRemoveTopic]] || rKBREMOVETOPIC ||
|-
|-
| createSimpleTask || [[createSimpleTask]] || rCREATESIMPLETASK ||
| kbTell || [[kbTell]] || rKBTELL ||
|-
|-
| taskHint || [[taskHint]] || rTASKHINT ||
| land || [[land]] || rLAND ||
|-
|-
| createDiaryRecord || [[createDiaryRecord]] || rCREATEDIARYRECORD ||
| move || [[move]] || rMOVE ||
|-
|-
| removeAllWeapons || [[removeAllWeapons]] ||rREMOVEALLWEAPONS ||
| moveIn || {{n/a}} || rMOVEIN || can replace [[moveInDriver]], [[moveInGunner]], [[moveInCommander]], [[moveInCargo]]
|-
|-
| addWeapon || [[addWeapon]] || rADDWEAPON ||
| playAction || [[playAction]] || rPLAYACTION ||
|-
|-
| addWeaponCargo || [[addWeaponCargo]] || rADDWEAPONCARGO ||
| playActionNow || [[playActionNow]] || rPLAYACTIONNOW ||
|-
|-
| addMagazine || [[addMagazine]] || rADDMAGAZINE ||
| playMove || [[playMove]] || rPLAYMOVE ||
|-
|-
| addMagazineCargo || [[addMagazineCargo]] || rADDMAGAZINECARGO ||
| playMoveNow || [[playMoveNow]] || rPLAYMOVENOW ||
|-
|-
| clearMagazineCargo || [[clearMagazineCargo]] || rCLEARMAGAZINECARGO ||
| playMusic || [[playMusic]] || rPLAYMUSIC ||
|-
|-
| clearWeaponCargo || [[clearWeaponCargo]] || rCLEARWEAPONCARGO ||
| playSound || [[playSound]] || rPLAYSOUND ||
|-
|-
| endMission || [[endMission]] || rENDMISSION ||
| removeAction || [[removeAction]] || rREMOVEACTION ||
|-
|-
| failMission || [[failMission]] || rFAILMISSION ||
| removeAllWeapons || [[removeAllWeapons]] ||rREMOVEALLWEAPONS ||
|-
| titleCut || [[titleCut]] || rTITLECUT ||
|-
| titleText || [[titleText]] || rTITLETEXT ||
|-
|-
| say || [[say]] || rSAY ||
| say || [[say]] || rSAY ||
|-
|-
| playMusic || [[playMusic]] || rPLAYMUSIC ||
| setCaptive || [[setCaptive]] || rSETCAPTIVE ||
|-
|-
| switchCamera || [[switchCamera]] || rSWITCHCAMERA ||
| setCurrentTask || [[setCurrentTask]] || rSETCURRENTTASK ||
|-
|-
| fadeMusic || [[fadeMusic]] || rFADEMUSIC ||
| setCurrentTaskArrays || {{n/a}} || rSETCURRENTTASKARRAYS ||
|-
|-
| fadeSound || [[fadeSound]] || rFADESOUND ||
| setDate || [[setDate]] || rSETDATE ||
|-
| addAction || [[addAction]] || rADDACTION ||
|-
| removeAction || [[removeAction]] || rREMOVEACTION ||
|-
| setCaptive || [[setCaptive]] || rSETCAPTIVE ||
|-
|-
| setDir || [[setDir]] || rSETDIR || '''caution:''' often gets overwritten by the server, tied to [[setPos]]
| setDir || [[setDir]] || rSETDIR || '''caution:''' often gets overwritten by the server, tied to [[setPos]]
Line 191: Line 187:
| setObjectTexture || [[setObjectTexture]] || rSETOBJECTEXTURE ||
| setObjectTexture || [[setObjectTexture]] || rSETOBJECTEXTURE ||
|-
|-
| execfsm || [[execFSM]] || rEXECFSM ||
| setSimpleTaskDescription || [[setSimpleTaskDescription]] || rSETSIMPLETASKDESCRIPTION ||
|-
| setSimpleTaskDestination || [[setSimpleTaskDestination]] || rSETSIMPLETASKDESTINATION ||
|-
|-
| execVM || [[execVM]] || rEXECVM ||
| setTaskState || [[setTaskState]] || rSETTASKSTATE ||
|-
|-
| spawn || [[spawn]] || rSPAWN ||
| setWPdesc || [[setWaypointDescription]] || rSETWPDESC ||
|-
|-
| JIPrequest || {{n/a}} || rJIPREQUEST || requesting JIP (RE persistent commands) from server by executing this via RE (on server) - parameter: logic local on client
| setWPtype || [[setWaypointType]] || rSETWPTYPE ||
|-
|-
| JIPexec || {{n/a}} || rJIPEXEC || custom scripting functions
| showCommandingMenu || [[showCommandingMenu]] || rSHOWCOMMANDINGMENU ||
|-
|-
| skiptime || [[skipTime]] || rSKIPTIME || bad
| sideChat || [[sideChat]] || rSIDECHAT ||
|-
|-
| setSimpleTaskDescription || [[setSimpleTaskDescription]] || rSETSIMPLETASKDESCRIPTION ||
| sideRadio || [[sideRadio]] || rSIDERADIO ||
|-
|-
| setSimpleTaskDestination || [[setSimpleTaskDestination]] || rSETSIMPLETASKDESTINATION ||
| skipTime || [[skipTime]] || rSKIPTIME || bad
|-
|-
| setCurrentTask || [[setCurrentTask]] || rSETCURRENTTASK ||
| spawn || [[spawn]] || rSPAWN ||
|-
|-
| setCurrentTaskArrays || {{n/a}} || rSETCURRENTTASKARRAYS ||
| switchAction || [[switchAction]] || rSWITCHACTION ||
|-
|-
| createTaskSet || {{n/a}} || rCREATETASKSET ||
| switchCamera || [[switchCamera]] || rSWITCHCAMERA ||
|-
|-
| setTaskState || [[setTaskState]] || rSETTASKSTATE ||
| switchMove || [[switchMove]] || rSWITCHMOVE ||
|-
|-
| debugLog || [[debugLog]] || rDEBUGLOG ||
| taskHint || [[taskHint]] || rTASKHINT ||
|-
|-
| enablesimulation || [[enableSimulation]] || rENABLESIMULATION ||
| titleCut || [[titleCut]] || rTITLECUT ||
|-
|-
| callVar || {{n/a}} || rCALLVAR || (1.03) - calls code that is stored in variable on client
| titleText || [[titleText]] || rTITLETEXT ||
|}
|}




[[Category:Arma 2: Editor Modules]]
{{GameCategory|arma2|Editor Modules}}

Latest revision as of 21:42, 16 May 2024

Arma 3
This page is about Arma 2 and does not apply to Arma 3. In Arma 3, use remoteExec or remoteExecCall.



Multiplayer Framework (MPF or MPf) is a library that helps MP mission creation, regarding some commands' locality.

  • library of scripts that are performing non-global script commands globally on network
  • using publicVariable + addPublicVariableEventHandler (EH that fires for each publicVariabled variable on all clients - excluding calling client) + direct call on calling client
  • easy use: R-commands match function of single non-global scripting commands (eg. MPF 'rHINT' call is doing 'hint' on clients)
  • allows execution only on client where target object is local ("loc" switch)
  • allows persistent calls - are performed on JIP client even if server processed given MPF call before client connected to game ("per" switch)
⚠
Do not overwrite RE variable in your missions when using MPF. Do not use rHINT, rSIDECHAT etc Identifiers (see library below)


Remote script execution (RE)

On all clients is public variable eventhandler that executes scripts that corresponds to less-than-100-percent-multiplayer-working script commands. One script for one commands, no string sending that will be compiled and executed for the sake of clarity and easiness of creating MP-friendly commands from the engine MP-unfriendly ones.

Function

  1. Script remExWrite.sqf is called with parameters that says: who executes, upon who, [only where local and/or persistent], which scripted command and parameters for scripted command on target client follow
  2. remExWrite.sqf writes in public variable remExField
  3. Change in remExField triggers execution of eventhandlers on all clients in the network game (initialized in init.sqf), script remExServer.sqf interpretes remExField (remExFP resp.)
  4. (if wanted) remExServer.sqf calls script (given as argument) on client that runs even handler
ⓘ
Remote execution executes script also on calling client (if "loc" flag set, or "loc" not set and object is local on caller client)

Usage

How-to

  • Include functions module in your mission
  • Wait for global variable "BIS_MPF_InitDone" to be defined (and true): waitUntil { !(isNil "BIS_MPF_InitDone"); };
  • In scripts or FSMs call: _handler = [/*...*/] call RE; (syntax - see below; RE stands for remote execution)

Format

[nil_or_caller, nil_or_target_object, "loc", script_to_execute, par0, par1...] call RE;
[nil_or_caller, nil_or_target_object, "per", script_to_execute, par0, par1...] call RE;
[nil_or_caller, nil_or_target_object, "loc" + "per", script_to_execute, par0, par1...] call RE;
  • "loc"...arbitrary parameter - executes remote script only on machine where nil_or_target_object is local
  • "per"...arbitrary parameter - executes remote script even on JIP client connectiong *after* this RE call was executed in MP game
  • script_to_execute - usually r + uppercase command (see available commands) e.g for hint: rHINT
  • RE...remote execution (short for remExWrite.sqf)

Examples

Hint on all clients currently connected to the MP game:

[nil, nil, rHINT, "Enjoy the game."] call RE;

Hint on all clients currently connected to the MP game + executed also on JIP client just after connection

[nil, nil, "per", rHINT, "Enjoy the game."] call RE;

Hint on client where object miles is local:

[nil, miles, "loc", rHINT, "Miles is local here."] call RE;

Hint on client where number 0 from players group is local. If JIP client connects to this slot, he got also his msg displayed:

[nil, (units group player) select 0, "loc" + "per", rHINT, "Hint."] call RE;

Multiple parameters

[objNull, BIS_Rodriguez , "per", rKBADDTOPIC, "armstrongs_speech", "kb\armstrongs_speech.bikb", ""] call RE;

ⓘ
"kb\armstrongs_speech.bikb" here becomes _this select 1 in kbAddTopic.sqf library script.


Implementation

  • remExServer
  • remExWrite
  • library
  • custom library (division to library and custom library introduced in Arma 2 v1.03)

Library + custom Library

  • library - functionality of single non-global scripting commands
  • custom library - enhanced functionality (eg. new parameters to scripting commands or more scripting commands triggered by one MPF call)

Available Commands

name command RE equivalent Additional Information
addAction addAction rADDACTION
addMagazine addMagazine rADDMAGAZINE
addMagazineCargo addMagazineCargo rADDMAGAZINECARGO
addWeapon addWeapon rADDWEAPON
addWeaponCargo addWeaponCargo rADDWEAPONCARGO
addWPCur N/A rADDWPCUR takes object and for his group on his local sets current WP
animate animate rANIMATE
callVar N/A rCALLVAR (1.03) - calls code that is stored in variable on client
clearMagazineCargo clearMagazineCargo rCLEARMAGAZINECARGO
clearWeaponCargo clearWeaponCargo rCLEARWEAPONCARGO
createDiaryRecord createDiaryRecord rCREATEDIARYRECORD
createSimpleTask createSimpleTask rCREATESIMPLETASK
createTaskSet N/A rCREATETASKSET
debugLog debugLog rDEBUGLOG
deleteWP deleteWaypoint rDELETEWP
enableSimulation enableSimulation rENABLESIMULATION
endMission endMission rENDMISSION
execFSM execFSM rEXECFSM
execVM execVM rEXECVM
fadeMusic fadeMusic rFADEMUSIC
fadeSound fadeSound rFADESOUND
failMission failMission rFAILMISSION
globalChat globalChat rGLOBALCHAT
globalRadio globalRadio rGLOBALRADIO
groupChat groupChat rGROUPCHAT
groupRadio groupRadio rGROUPRADIO
hint hint rHINT
hintC hintC rHINTC
JIPexec N/A rJIPEXEC custom scripting functions
JIPrequest N/A rJIPREQUEST requesting JIP (RE persistent commands) from server by executing this via RE (on server) - parameter: logic local on client
kbAddTopic kbAddTopic rKBADDTOPIC
kbReact kbReact rKBREACT
kbRemoveTopic kbRemoveTopic rKBREMOVETOPIC
kbTell kbTell rKBTELL
land land rLAND
move move rMOVE
moveIn N/A rMOVEIN can replace moveInDriver, moveInGunner, moveInCommander, moveInCargo
playAction playAction rPLAYACTION
playActionNow playActionNow rPLAYACTIONNOW
playMove playMove rPLAYMOVE
playMoveNow playMoveNow rPLAYMOVENOW
playMusic playMusic rPLAYMUSIC
playSound playSound rPLAYSOUND
removeAction removeAction rREMOVEACTION
removeAllWeapons removeAllWeapons rREMOVEALLWEAPONS
say say rSAY
setCaptive setCaptive rSETCAPTIVE
setCurrentTask setCurrentTask rSETCURRENTTASK
setCurrentTaskArrays N/A rSETCURRENTTASKARRAYS
setDate setDate rSETDATE
setDir setDir rSETDIR caution: often gets overwritten by the server, tied to setPos
setObjectTexture setObjectTexture rSETOBJECTEXTURE
setSimpleTaskDescription setSimpleTaskDescription rSETSIMPLETASKDESCRIPTION
setSimpleTaskDestination setSimpleTaskDestination rSETSIMPLETASKDESTINATION
setTaskState setTaskState rSETTASKSTATE
setWPdesc setWaypointDescription rSETWPDESC
setWPtype setWaypointType rSETWPTYPE
showCommandingMenu showCommandingMenu rSHOWCOMMANDINGMENU
sideChat sideChat rSIDECHAT
sideRadio sideRadio rSIDERADIO
skipTime skipTime rSKIPTIME bad
spawn spawn rSPAWN
switchAction switchAction rSWITCHACTION
switchCamera switchCamera rSWITCHCAMERA
switchMove switchMove rSWITCHMOVE
taskHint taskHint rTASKHINT
titleCut titleCut rTITLECUT
titleText titleText rTITLETEXT
Retrieved from "https://community.bistudio.com/wiki?title=Arma_2:_Multiplayer_Framework&oldid=364499"