Die Werkbank

Auf der Werkbank schreibst du eine Mod: Dateien und Konfigurationsfelder nebeneinander, dazu das Installationsformular, eine Vorschau dessen, was sich auf einem Server ändert, und die Probleme, die dzbot findet. Creator-Mods und Organisations-Mods nutzen dieselbe Werkbank.

Navigationspfade:

• Creator Space -> eine Mod
• Organisation -> Mods -> eine Mod

Aufbau

• Dateibaum (links) – die Dateien der Mod in Ordnern nach ihrem Zielpfad, jede mit ihrer Operation: Ersetzen, Zusammenführen · Hinzufügen, Zusammenführen · Abgleichen oder Löschen (siehe Dateiänderungen). Ein Pfad kann mehrere Dateien haben; sie werden von oben nach unten angewendet, und per Ziehen änderst du die Reihenfolge. Dateien mit ungespeicherten Änderungen sind markiert.
• Editor (Mitte) – ein Tab pro offener Datei. Der Kopf jeder Datei zeigt Pfad, Operation und den Schalter Dynamische Variablen. Strg+S (Cmd+S) speichert; verlässt du die Seite mit ungespeicherten Änderungen, wirst du vorher gefragt. Ein Klick auf eine {$variable} springt zu ihrem Konfigurationsfeld.
• Konfiguration (rechts, einklappbar) – schaltet zwischen Felder und Formular-Vorschau um:
  • Felder listet die Konfigurationsfelder mit ihren Sektionen. Du öffnest eines direkt an Ort und Stelle zum Bearbeiten, sortierst per Ziehen und legst neue an. Jedes Feld zeigt, wo es verwendet wird (Datei und Zeile, anklickbar), und warnt, wenn keine Datei es nutzt. Siehe Konfigurationen.
  • Formular-Vorschau ist das Installationsformular, wie ein Server-Admin es sieht. Was du dort eingibst, sind die Testwerte, mit denen die Vorschau rendert.
• Bereich unten:
  • Probleme – Template-Fehler, undefinierte Variablen und Bedingungen, die ein Feld leer lassen, obwohl eine Datei es noch braucht
  • Vorschau – die echte Gegenüberstellung, die dein Entwurf mit den Testwerten erzeugt, gegen die Vanilla-Mission einer der Karten der Mod oder gegen die Dateien deines Testservers. Neue und ungespeicherte Dateien sind mit drin
  • Logs – was beim letzten Transfer auf dem Testserver passiert ist

Dateien von deinem Rechner hineinziehen

Zieh Dateien von deinem Rechner auf die Werkbank:

• auf eine Datei im Baum – ersetzt ihren Inhalt (hat die Datei ungespeicherte Änderungen, wirst du vorher gefragt)
• zwischen Dateien oder auf einen Ordner – legt an dieser Stelle eine neue Datei an, benannt wie die gezogene Datei, mit Ersetzen als Operation (bei Bedarf änderst du sie gleich)
• auf den offenen Editor – ersetzt den Inhalt dieser Datei

Mehrere Dateien auf einmal gehen auch. Passt das Format nicht – eine JSON-Datei auf eine XML-Datei –, wirst du gefragt, bevor etwas ersetzt wird.

Änderungen von anderswo

Was auch immer eine Datei der Mod speichert – die Werkbank in einem anderen Tab, ein Mitwirkender, der AI Companion oder eine verbundene KI-App –, erscheint sofort in jeder offenen Werkbank der Mod.

• Ohne eigene ungespeicherte Änderungen aktualisiert sich die offene Datei von selbst.
• Mit ungespeicherten Änderungen entscheidest du: die andere Fassung übernehmen, beide vergleichen oder deine behalten.

Nichts wird still überschrieben: Speichern über eine Fassung, die du nicht gesehen hast, wird abgelehnt.

Entwurf und ältere Versionen

Bearbeiten lässt sich nur der Entwurf. Eine ältere Version öffnest du schreibgeschützt über den Versions-Umschalter in der Kopfzeile, mit einer Gegenüberstellung zum Entwurf. Veröffentlichen in der Kopfzeile veröffentlicht den Entwurf mit einem Changelog, siehe Versionen und Veröffentlichen.

Mit KI bauen

Eine mit dzbot verbundene KI-App oder der AI Companion kann den Entwurf direkt bearbeiten: Dateien, Konfigurationsfelder, eine Prüfung auf Probleme und eine Vorschau mit selbst gewählten Werten. Ihre Änderungen erscheinen live in der Werkbank. Für einen einfachen KI-Assistenten beschreibt die Mod-Builder-Referenz für Agenten die Dateioperationen, die Template-Syntax und die Feldtypen.

Im Spiel mit dzStudio bearbeiten

dzStudio, der Objekt-Editor in DayZ, öffnet die Object-Spawner-Dateien einer Mod direkt aus dzbot und speichert zurück in den Entwurf — ohne Export und Import. Du verbindest es einmal: dzStudio zeigt einen Code und öffnet dzbot.de/editor/connect. Dort meldest du dich mit deinem eigenen Konto an und bestätigst den Code — nur wenn das Spiel genau diesen Code zeigt und du gerade selbst verbindest. Die Verbindung steht danach in deinem Profil unter Verbundene Apps. Trennen in dzStudio beendet nur die Verbindung dieses Rechners; Trennen unter Verbundene Apps beendet alle dzStudio-Verbindungen deines Kontos.

dzStudio öffnet die Mods, deren Inhalt du bearbeiten darfst, und die Platzierungen der Server, auf denen du admin.mods.manage hast; Bearbeiten braucht dzbot Pro für die Organisation bzw. den Server. Es speichert alle geänderten Dateien zusammen oder gar nicht, und was in der Werkbank inzwischen geändert wurde, erscheint im Spiel. dzbot legt jede Datei genau so ab, wie dzStudio sie geschrieben hat, und prüft vor dem Speichern, dass sie unverändert angekommen ist; eine unterwegs beschädigte Datei wird nicht gespeichert, und dzStudio meldet das.

Object-Spawner-Dateien, die dzStudio anlegt, trägt dzbot bei jeder Übertragung der Mods selbst in die cfggameplay.json des Servers ein, jede einmal, neben dem, was die Datei des Servers und andere Mods schon nennen. Löschst oder benennst du eine Spawner-Datei um, auch in der Werkbank, fällt sie bei der nächsten Übertragung aus der Liste. Die cfggameplay.json schreibt dzStudio nie. Eine Delta-Datei von dzStudio, die durch ein Speichern keine Einträge mehr hat, wird gelöscht und nicht als leere Datei behalten.

Kopiert jemand die Verbindung von dzStudio aus dem Profilordner des Spiels und benutzt sie, beendet dzbot diese Verbindung für beide, und dzStudio bittet dich, neu zu verbinden; deine anderen dzStudio-Verbindungen bleiben.

Eine gemeinsame dzStudio-Sitzung

Mehrere Leute können eine Mod gemeinsam in dzStudio bearbeiten. Solange so eine Sitzung läuft, sagt das ein Hinweis in der Werkbank, und Dateien, Konfigurationsfelder und Veröffentlichen der Mod lassen sich nur aus der Sitzung heraus ändern — Werkbank, AI Companion und verbundene KI-Apps werden abgewiesen, bis sie endet. Eine Sitzung, die keinen Kontakt mehr hat, gibt die Mod nach zehn Minuten von selbst frei. Wer die Mod bearbeiten und verwalten darf, kann eine hängende Sitzung auch freigeben; was die Sitzung noch nicht gespeichert hat, bleibt in dzStudio und ist nicht mehr vor dem Überschreiben geschützt.

dzStudio kann aus einer Sitzung heraus auch ein neues Projekt in dzbot anlegen (Speichern unter mit dzbot als Ziel), wenn du mindestens eine Mod oder Platzierung in dzStudio bearbeiten darfst. Es wird eine private Mod von dir, mit dem eingegebenen Namen und für die Karte der Sitzung, und steht in deinen Mods, sobald die Sitzung zum ersten Mal speichert. Seine Objekt-Spawner-Dateien (.json) landen in der Mod, Loot-Dateien des Projekts nicht.

Freunde für gemeinsame Sitzungen

Dein dzbot-Konto führt eine Freundesliste für dzStudio mit höchstens 200 Konten. Du pflegst sie unter dzbot.de/account/dzstudio: Dort suchst du ein Konto nach seinem Namen oder dem Namen eines seiner Spieler (ab drei Zeichen) — du findest nur Konten, die auf mindestens einem deiner Server einen Spieler haben — und entfernst es wieder; dorthin führt dzStudio-Freunde verwalten unter Verbundene Apps in deinem Profil. Ändern kannst du die Liste nur mit deiner eigenen Discord-Anmeldung, nicht über einen Anmeldelink. In einer dzStudio-Sitzung kannst du außerdem die anderen Teilnehmer zum Freund machen, auch jemanden, der per Code dazukam. Die Liste gehört nur dir: Wen du aufnimmst, wird weder gefragt noch benachrichtigt, und an seiner Liste ändert sich nichts.

Deine Freunde stehen beim Einladen zur Auswahl. Ein Freund mit darf immer beitreten kommt ohne Einladung in Sitzungen, die du mit einem lokalen Projekt startest, und darf andere einladen, die Sitzung aber nicht verwalten; schaltest du es aus, bleibt er in einer laufenden Sitzung, bis er sie verlässt. Für Mods und Platzierungen gibt der Schalter nichts: Dort zählen nur die Rechte an der Mod bzw. Platzierung. Ob ein Freund online oder in einer Sitzung ist, siehst du nur, wenn er dich ebenfalls als Freund führt.