# addAction (Grundlegendes)

Das Kommando ***addAction*** fügt einen Eintrag ins Aktionsmenü ("Mausradmenü") hinzu, welcher wiederum ein Script ausführt oder eine Variable definiert. Das Kommando ist vom Effekt her lokal, allerdings für alle Clients zugänglich, wenn man es in die Init-Box eines Objekts setzt! Man kann damit auch den gesamten Mission-Flow per Aktionsmenü steuern, wenn man der Figur des Spielleiters entsprechende Einträge zugänglich macht:

https://community.bistudio.com/wiki/addAction

  
**1. FARBE ändern:**

Hinter die ersten Anführungszeichen (als Bestandteil des "titels") im Init:

<t color='#160ff3'> (ROT)

Alle Farbcodes: <span style="text-decoration: underline;">https://www.webfx.com/web-design/color-picker/</span>

  
**2. AKTION hinzufügen:**

a) Führt Script/Function aus:  
  
 this addAction \["<span style="color: #339966;">&lt;t color='#FF0000'&gt;</span><span style="color: #800080;">title</span>",<span style="color: #ff9900;">"scripts\\arty.sqf"</span>,<span style="color: #993300;">nil</span>,<span style="color: #0000ff;">1.5</span>,<span style="color: #ff00ff;">false</span>,<span style="color: #00ccff;">true</span><span style="color: #ffffff;">,</span><span style="color: #ff0000;">""<span style="color: #ffffff;">,""</span></span>,<span style="color: #008000;">3</span>,false,"",""\];  
  
b) Globale Variable definieren (zum Beispiel zur Wegpunkt-Aktivierung):  
  
 <span style="color: #ff6600;">this</span> addAction \["<span style="color: #339966;">&lt;t color='#FF0000'&gt;</span><span style="color: #800080;">title</span>",{meineVariable = true; publicVariable "meineVariable";}, \[\], 0, false, true, "", "", 3\];

**Syntax:**

<span style="color: #ff6600;">Objekt</span> addAction \["<span style="color: #339966;">&lt;Farbe&gt;</span><span style="color: #800080;">Titel</span>", <span style="color: #ff9900;">"Scriptpfad"</span>, <span style="color: #993300;">arguments</span>, <span style="color: #0000ff;">Priorität (0-6)</span>, <span style="color: #ff00ff;">mittig\_anzeigen?</span>, <span style="color: #00ccff;">hide\_on\_use?</span>, <span style="color: #ff0000;">shortcut\_key, <span style="color: #ffffff;">condition</span></span>, <span style="color: #008000;">radius\_in\_meters</span>, unconscious?, selection, memoryPoint\]

  
**3. RESTRIKTIONEN (<span style="color: #ffffff;">condition</span>):**

Es kann per Parameter festgelegt werden, welcher Spieler auf welchen Eintrag an welchem Objekt zugreifen kann. Will man einen Eintrag nur für einen Spieler haben, sollte zum Beispiel "\_target isEqualTo \_this" funktionieren. Will man, dass nur eine bestimmte Spielerfigur (zum Beispiel mit dem Var.name p1) einen Eintrag innerhalb eines Fahrzeugs zur Verfügung hat, so sollte "p1 in \_target" klappen.

"\_this" ist dabei dabei die Spielerfigur, die (lokal!) Zugriff haben/den Eintrag sehen soll, "\_target" bezeichnet das Objekt, dem der Eintrag zugeordnet ist.

Bei "\_target isEqualTo \_this" ist also z. B. der Eintrag in der Init-Box der Spielerfigur und zugleich ist die Figur das "\_target" (isEqualto).