Einführung

Ich teile hier mal alles was ich bisher über Enforce, die Script Sprache auf der die DayZ Standalone und womöglich spätere Bohemia Titel basieren werden, herausgefunden habe.

Das ganze richtet sich an bereits erfahrene Programmierer, die die Grundkonzepte moderner Hochsprachen verstehen. Also falls ihr euch mit C#, C++ oder auch Java auskennt solltet ihr klarkommen. Falls nicht wird das ganze hier euch nicht wirklich weiterhelfen.

Ich kann nicht versichern das alles was ich hier schreibe zu 100% richtig ist, da es auf meinen eigenen getesteten Theorien basiert sowie auf Aussagen von Nutzern der DayZ Modding Discords.

Also falls jemand mehr weiß oder einen Fehler entdeckt kann er es ja posten.

Ich empfehle die DayZ Tools auf Steam unter Tools. In den DayZ Tools gibt es unter Workbench->Editors->Script Editor einen Script Editor mit Code highlighting und Codevorschlägen. Zum einrichten der Workbench für tatsächliche Mods (nicht nur modifizierte Missionfiles) diesen Guide verwenden.

Am Anfang empfiehlt es sich allerdings die dayZOffline.ChernarusPlus Mission im DayZ Verzeichnis->missions->init.c zu Editieren (vorher Backup machen!). Zum Starten von DayZ im offline mode braucht ihr eine batch Datei im Missionverzeichnis in der steht:

@echo off

taskkill /F /IM DayZ_x64.exe /T

RD /s /q "storage_-1" > nul 2>&1

cd ../../

start DayZ_x64.exe -mission=.\Missions\dayzOffline.ChernarusPlus -scrAllowFileWrite -nosplash -noPause -noBenchmark -name MyName -scriptDebug=true -filePatching -doLogs

(Batchdatei von Arkensor aus der CommunityOfflineMode)

Ganz wichtig dabei auch: DayZ SA windowed starten (einfach im Optionsmenü einstellen) so kann man bei Fehlern einfach Wiederholen drücken.

Wenn alles Funktioniert müsst ihr das Spiel auch nicht komplett neustarten um Änderungen in der Missionfile wirksam zu machen. Einfach dafür im Menü Neustarten drücken (manchmal ist trotzdem ein kompletter Neustart erforderlich z.B. beim bearbeiten von Dateien die mit #include eingebunden sind.).

Hilfreiche Links

• Lystic API Referenz (Stark Veraltet)
• Ingame Item Liste
• DayZ Modders Discord
• DayZ Discord
  
• Workbench Einrichten
  
• Meine Beispiele

Enforce Script - Grundlegende Konzepte

Enforce Script ist eine Scriptsprache die für die Enforce Engine entwickelt wurde.

Alles Scripts, auch die der grundlegenden Spiellogik sind in der scripts.pbo im dta Ordner des DayZSA verzeichnisses offen einsehbar und sind hilfreich um herauszufinden wie gewisse Sachen funktionieren (bis endlich eine ordentliche API referenz herauskommt).

Wichtige Eigenschaften:

• Objektorientiert
• Anweisungen werden mit einem ; (Semikolon) beendet.
• Funktionskörper/Kontrollstrukturenkörper in {} (Geschweiften Klammern)
• C Sprachen ähnlich
• Erstes Array Element ist 0
• Keine Mehrfachdeklarationen/Definitionen auf einer Zeile (z.B. int a,b;)
• Case sensitive (Groß und Kleinschreibung ist wichtig!)
• Big-endian (ggf. Systemabhängig)
• Für manches gibt es mehr als einen Syntax z.B. extends
• Nach Kontrollstrukturen können {} weggelassen werden wenn nur eine Anweisung kommt.
• Deklaration und Definition von Klassen und Funktionen immer gleichzeitig nie seperat (soweit ich weiß).
• Alles wird wie ein Objekt behandelt.
• Auf nicht initialisierte Objekte kann mit if(!e) geprüft werden.
• Klassen und Funktionen können auch verwendet werden vor der Zeile in der sie definiert werden.

Keywords

Liste ggf. unvollständig.

Datentypen

Basistypen

Fortgeschrittene

Sonstige

Alle Standardtypen sind auch als Klassen definiert.

Für die von der Engine definierten Memberfunktionen und Variablen Dateien EnScript.c, EnString.c und EnConvert.c in Verzeichnis scripts.pbo->1_Core->proto durchlesen.

Operatoren

Logik

Arithmetisch

Bitwise

Sonstige

Kommentare

Kontollstrukturen

Alternativen

if, else

if(a)
{
    //Code wenn a wahr ist.
}
else if(b)
{
    //Code wenn a falsch ist und b wahr.
}
else
{
    //Code wenn a und b falsch sind.
}

switch

switch(a)
{
case 1:
    Code für a=1
    break;
case 2:
    //Code für a=2
    break;
default:
    //Code für Sonstige
}

Schleifen

while

while(true)
{
    //Endlosschleife
}

for

for(int i=0;i<5;i++)
{
    //Code wird 5 mal ausgeführt i dabei von 0 bis 4
}

foreach

foreach(int a : arr) //arr vom typ array<int>
{
    //a geht all member von arr durch
}
foreach(int a, string b : m) //m vom typ map<int,string>
{
    //geht alle map Elemente durch. a ist der int teil und b der string Teil.
}

break, continue

while(true)
{
    if(a) break; //führt solang code durch bis a true (das gleiche wie while(!a))
}
for(int i=1;i<=10;i++)
{
    //Code wird bei jedem durchlauf durchgeführt.
    if(i>=5) continue;
    //Code wird nur bei Durchlauf 1 bis 4 durchgeführt.
}

Goto

a:
//Endlosschleife
goto a;

Funktionen

int foo()
{
    //Funktion die 1 Zurückgibt.
    return 1;
}
int foo(int para) //Überladene Funktion
{
    return para;
}
void bar(out array<int> b)
{
    //Funktion die array modifiziert.
}
int func(int a = 1)
{
    //Funktion mit Standardwert (Wird genommen beim auslassen dieses Parameters).
    return a;
}

//Funktionsaufrufe
int v = foo();
bar(arr);
func();
func(2);

Klassen

Klassen in Enforce Script stammen alle von der Klasse "Class" ab und haben damit immer die folgenden Memberfunktionen, die nicht überschrieben werden können:

Alle relevanten Arten von memberfunktionen/variablen sind im Beispiel. Am ende der Klassendefinition ist immer ein ; (Semikolon).

Beispiel:

class B
{
    void bar(){}
    void Bfoo() {}
}
class A : B //class A extends B ist das gleiche
{
    private static m_cnt=0; //Static variable
    private m_a; //Private Variable
    protected m_b; //Protected Variable
    void A(){m_cnt++;} //Konstruktor
    void ~A(){m_cnt--;} //Destruktor
    void foo()
    {
        //Funktion der Klasse
        super.Bfoo(); //Zugriff auf Bfoo von parent Klasse B
        DoSomething(this); //Funktion wird eigene Instanz übergeben. 
    }
    override bar()
    {
        //überschriebene Funktion bar()
    }
    static int GetCnt() {return m_cnt;} //static funktion die Anzahl der Instanzen zurückgibt.
}

Ref

Ref sorgt dafür, das eine Klasse als Referenz übergeben wird allerdings nicht immer.

Hier erläuterung von einem anderem Discord user (Jacob_Mango):

ref Class m_RefClass;
Class m_CopyClass;

void WillBeRef(Class class)
{
    m_RefClass = class;
}

void WillBeRef(ref Class class)
{
    m_RefClass = class;
}

void WillBeCopy(Class class)
{
    m_CopyClass = class;
}

void WillBeCopy(ref Class class)
{
    m_CopyClass = class;
}

Anzumerken ist auch das Instanzen die vom Typ Object erben und dieser Typ selbst immer als Referenz übergeben werden da Sie direkt mit dem Objekt in der Spielwelt zusammenhängen.

Generell ist aber zu empfehlen alles als Referenz zu übergeben es sei denn eine Kopie ist erwünscht.

Bei Basis typen scheint das Keyword nicht zu funktionieren und crashed das Spiel!

Typecasts

Man man;
Object obj;
man=Man.Cast(obj); //Kann fehlschlagen da man von Objekt erbt
Class.CastTo(man,obj); //selbes wie Oben gibt true zurück wenn erfolgreich
man=(Object)obj; //wieder selbes anscheinend Funktionieren C Casts auch

Typecasts funktionieren nur zwischen Objekten die kompatibel sind. Etwas wie childclass->parentclass funktioniert immer parentclass->childclass aber nur wenn die Instanz auch tatsächlich eine childclass ist. So kann ein Spieler (Instanz von PlayerBase) nicht in eine Pflanze (PlantBase) umgewandelt werden auch wenn es der Spielstil mancher Spieler vermuten lässt.

Templates

Muss noch getestet werden geht vlt. auch mit Funktionen.

class A<typename T>
{
    T var;
}
//A<int> ist Klasse wo T im Body mit int ersetzt wurde.

Nomenklatur der API

Das scheint die Nomenklatur zu sein (meist):

Attribute

Anscheinend gibt es sowas wie spezielle Attribute wie NonSerialized() diese werden in [] geschrieben siehe scripts.pbo->1_Core->proto->Serializer.c für ein Beispiel.

Präprozessor

Präprozessor Anweisungen werden vor der Script ausgeführt wird geprüft und sind u.a. dazu da Scriptdateien dynamisch zu verändern z.B. je nach Platform. Sie Starten immer mit einer # (Raute) und sind im Grunde identisch zu C/C++.

Defines (unvollständig)

In API zurechtfinden

Die API ist nicht Dokumentiert und meist muss man selbst die Scripts durchsuchen. Dafür empfiehlt es sich die scripts.pbo im Dayz Verzeichnis->dta mit dem PBO Manager zu entpacken. Diesen Ordner kann dann mit Notepad++ über Suchen->In Datein Suchen durchsuchen. Das ist ganz hilfreich um Beispiele zur Anwendung verschiedener Klassen/Funktionen zu finden. Lystics API Referenz ist auch hilfreich um Informationen zu finden. Dafür einfach im Suchfeld ungefähr eingeben was man will und meist findet man dann auch was man sucht.

Mods von anderen Moddern können auch mit dem PBO Manager entpackt werden und deren Quelltext damit eingesehen.

Der oben genannte DayZ Modder Discord kann auch nach Stichworten durchsucht werden und im Notfall kann man dort auch mal fragen meist findet man dort was man will.

Da Google sowas nur ab und zu ausspuckt: https://community.bistudio.com…ayZ:Enforce_Script_Syntax

https://community.bistudio.com/wiki/Category:DayZ:Editing