Skip to content

GitLab

Last edited by Felix
Page history

Home

W-Functions_Banner

"EDV-Systeme verarbeiten, womit sie gefüttert werden. Kommt Mist rein, kommt Mist raus." - André Kostolany

Das Wiki

Das Wiki zu den W-Functions ist in zwei Bereiche geteilt, die ihr über das Menüband am rechten Bildschirmrand auswählen könnt.

Unter Functions findet ihr Dokumentation und Nutzungsbeispiele zu allen Endnutzerfunktionen der W-Functions.

Unter Systems folgen Erklärungen zu einzelnen Systemen und wie diese verwendet werden können/sollten. Dabei werden Zusammenhänge erklärt, welche aus der reinen Dokumentation vielleicht nicht direkt hervorgehen.

Bitte beachte, dass die Sidebar rechts nicht alle Pages anzeigt. Für eine Gesamtübersicht klicke entweder HIER, oder in der Sidebar auf "View All Pages"

Motivation

In selbstgebauten Missionen für Arma 3 ist ein flüssiges Spielerlebnis wichtig für die Immersion. Jedoch beansprucht aktive KI den Server sehr.
Daher bedeutet gutes Missionsdesign unter Anderem, dass stets nur die KI gespawnt wird, die für den Spieler zum aktuellen Zeitpunkt auch tatsächlich 'relevant' ist.
Das Spawnen in Abhängigkeit solcher Bedingungen ist am einfachsten über Trigger umzusetzen.
Leider erfordert dieser Ansatz in der Regel gute SQF-Kenntnisse und ist deutlich aufwändiger als der sehr leistungshungrige Ansatz, die KI einfach im Editor vorzuplatzieren.
Jetzt kommen die W_FNC ins Spiel:
sie verstecken das komplizierte Klein-Klein des 'normalen' Skriptens (bspw. Lernen der Befehle, Lokalitäten, korrekte Reihenfolge der Waypoints bei komplizierten Aufgaben wie Fahrzeugboarding/Transport) und reduzieren es so auf das Ausfüllen von ein paar wenigen Funktionen. Dadurch ermöglichen die W_FNC auch unerfahrenen Skriptern sehr dynamische Missionen mit potentiell beliebig viel KI und einer großen Reduktion des technischen Fehlerrisikos.

Allgemeines Prinzip

Die Nutzung der W_FNC geschieht in zwei grundlegenden Abschnitten. Zuerst findet die Registrierung aller Eigenschaften für die KI statt, die im weiteren Verlauf des Missionsbaus in der Regel selten, oder garnicht mehr geändert werden (siehe dazu unter Functions das Kapitel 1_Einrichten). Dazu gehören bspw. Aspekte wie die Sprache der KI, die zugehörige Seite, ihre Skill-Werte und Ähnliches, was die allgemeine Fraktion betrifft. Durch diesen ersten Abschnitt, das einmalige Einrichten, wird der zweite Abschnitt, die reguläre Verwendung zum dynamischen Spawnen erst so richtig einfach. Im einfachsten Fall muss so nur noch ein Name, Spawn-Positionen und die Gruppenstruktur eingefügt werden, um einen dynamischen Spawn auszuführen. Die verfügbaren Funktionen dazu finden sich unter Functions im Kapitel 2_Verwenden und für zahlreiche Beispiele ist die gut gepflegte Demo-Mission sehr zu empfehlen!

W-Functions Demo Mission

Für eine umfangreiche Übersicht anhand zahlreicher Beispiele ist die gut gepflegte Demo-Mission sehr zu empfehlen! Ladet diese Mission im Editor und lest die Kommentare auf der Karte, um zu erfahren, wie die Beispiele funktionieren. Außerdem schadet ein Blick in die initServer.sqf der Demo-Mission nicht, falls ihr auf eigene Faust erkunden wollt, wie alles funktioniert. Aber darauf wird im Folgenden noch genauer eingegangen!

W-Functions in eine Mission einbinden

Methode 1: Von Grund Auf

  1. Lade dir den neuesten Release herunter
  2. Kopiere den Ordner W_fnc und die Datei CfgWFNC.hpp in den Missionsordner
  3. Füge in der description.ext folgendes hinzu:
#include "CfgWFNC.hpp"

class CfgFunctions {
    #include "W_fnc\CfgFunctions.hpp"
};

(Beachte, dass die class CfgFunctions in der description.ext nur EINMAL aufgerufen werden darf!) 4. Füge in der CfgLoadouts.hpp folgendes hinzu:

class CfgLoadouts {
    //include MIL_AI Loadouts
    #include "W_fnc\mil_spawn\MIL_factions.hpp"
};

(Beachte, dass die class CfgLoadouts in der CfgLoadouts.hpp nur EINMAL aufgerufen werden darf!)

An dieser Stelle sind die Funktionen für dich erreichbar und nutzbar. Das vollständige Einrichten, bis die Spawn-Funktionen in ihrer vorgesehenen Funktion verwendet werden können, erfordert weitere Schritte in der initServer.sqf:

  1. füge Fraktionen hinzu
  2. füge Gruppenkonfigurationen hinzu
  3. definiere deine Skills

Methode 2: Copy & Paste

In dieser Variante ist auch die Einrichtung enthalten, so dass diese nur noch auf die eigenen Wünsche angepasst werden muss.

  1. Falls du in deine description.ext schon bearbeitet hast, sichere sie.
  2. Lade die Demo-Mission herunter
  3. Öffne den Ordner der Demo-Mission und kopiere Alles außer mission.sqm in den eigenen Missionsordner
  4. Öffne die Demo-Mission im Editor und gehe auf die Karte.
  5. Markiere und Kopiere (strg+c) respawn_west , HC, Spectators, Zeus und die W-Flagge, die den W_tech_support enthält (die Objekte sind mit einem Kommentar auf der Karte markiert)
  6. Lade wieder deine eigene Mission und platziere die kopierten Objekte (strg+v)
  7. Gehe in deinen Missionsordner, öffne die neue, kopierte description.ext (die Schaltzentrale deiner Misison) und passe ganz oben die Beschreibung wieder auf deine Mission an. (lösche deine Sicherung)

Nun sind unter Anderem alle notwendigen Funktionen für das Einrichten der W_FCN (siehe unter 1_Einrichten) in der initServer.sqf referenziert. Diese referenzierten Skripte befinden sich nun leicht erkennbar in eurem Missionsordner unter Scripts/Setup, den ihr mit dieser Methode in eure Mission kopiert haben werdet. Hangelt euch nun einfach durch die Dateien, in der Reihenfolge, wie sie in der initServer.sqf inkludiert sind.

  1. Falls ihr den Namen in Fraktionen in der Faction_Presets.sqf ändert bzw. eine andere Standard-Fraktion ausgewählt haben wollt, dann müsst ihr in eurem Missionsordner in der Datei CfgWFNC.hpp den Namen ebenfalls anpassen. Gleiches gilt dann auch für die Skills.

Anschließend solltet ihr euch in der Demo-Mission die Beispiele und die zugehörigen Skripte ansehen. Dabei werden sicher einige Zusammenhänge deutlicher und die Verwendung der W_FNC schnell zur Gewöhnung. Bei Fragen kann jederzeit auf einige Mitglieder (Pyro, Peer, Miller, Felix, Konny, Lusor, John of Gaunt, Gigaplex ... ) zugegangen werden.

W-Functions Verwenden

Nach der Einbindung und Einrichtung (eingerichtet sind sie nach Methode 2: Copy & Paste zwar auch schon, aber noch nicht auf eure Wünsche angepasst) beginnt die profitable Phase. Dynamisches Spawnen per Skript reduziert sich nun, im einfachsten Fall, auf die Create-Funktion, mit der schon sehr viele Fälle abgedeckt werden können:

[
    ["altis_airport_opfor"],
    "ft",
    "SAD"
] call GrpW_misc_fnc_create;

Dieses Beispiel spawnt an allen Markern im Editor, die mit 'altis_airport_opfor' beginnen, ein fireteam, das als 'ft' in einer Gruppenkonfiguration gespeichert ist und gibt ihnen jeweils einen Search & Destroy Waypoint auf ihre eigene Position.

Der fortgeschrittenere Nutzer möchte eventuell etwas mehr Kontrolle über einzelene Zwischenschritte. Hier ein Beispiel, für das 'manuelle' Pendant zum obigen Beispiel:

// manual spawn
private _positions = ["altis_airport_opfor"] call GrpW_misc_fnc_getPositions;
["altis_airport_opfor", _positions, "ft"] call GrpW_spawn_fnc_spawnHandler;

// manual task
private _groups = ["altis_airport_opfor",[1,4]] call GrpW_db_fnc_getGroups;
{
    [_x, "SAD"] call GrpW_tasks_fnc_multiTaskExecute;
} forEach _groups;

Grundsätzlich ist es sehr empfehlenswert wenigstens die allgemeinen Beschreibungen der Funktionen unter Kapitel 2_Verwenden zu lesen!

Dadurch erhält man einen ersten sehr guten Überblick über den tatsächlichen Umfang und die Vielfältigkeit der W_FNC. Es gab nicht nur einmal den Fall, dass Missionsbauer überrascht waren, dass bestimmte Features bereits mit den W_FNC implementiert waren. Anschließend kann kann man sich über die jeweiligen Parameterlisten und Beispiele der Funktionen ein genaueres Bild verschaffen. Wer ganz abgefahren ist (der weis das vermutlich zwar selbst) zieht sich einfach im Ordner der W_FNC die Funktionen als Code rein.