Modde mit deinen Freunden! Geh online mit dem WORLD BUILDER
08.06.2017
08.06.2017

Übersicht

Der EMERGENCY 2017 Online Editor besteht aus zwei Teilen:

  • Der Online Editor Client
  • Der Online Editor Server

Der Online Editor Client ist zwar identisch mit dem Offline Editor, du musst aber zunächst einen Server erstellen. Du kannst diesen Schritt überspringen, falls du einem Modprojekt beigetreten bist, das jemand anderes erstellt und hostet

Es gibt nur einige wenige Unterschiede zwischen Offline und Online Editor, die du wissen musst:

  • Wenn du mit dem Online Editor arbeitest, brauchst du nicht zu speichern. Jeder Vorgang wird automatisch an den Online Editor Server geschickt, der deine Arbeit verwaltet.
  • Wenn du mit dem Online Editor arbeitest, darfst die NIEMALS die Daten in „en5game/data“ direkt bearbeiten. Benutze immer den Online Editor Client, wenn du an diesen Dateien arbeitest – ansonsten werden die Veränderungen nicht an den Online Editor Server gesendet. Andere User können deine Änderungen nicht sehen und unsere Arbeit ist hinüber.
  • Es gibt Benutzerrechte, die beschränken, was ein User tun kann. In den „Preferences“ kannst du sehen, welche Benutzerrechte dir der Online Editor Server momentan zugeteilt hat.
  • Wenn du Elemente auswählst, blockierst du diese. Niemand sonst kann diese Elemente auswählen und editieren. Elemente, die von anderen Nutzern blockiert werden, sind farbig markiert. Bewege deinen Mauszeiger über ein blockiertes Element, um in deiner Statusleiste den Namen des Nutzers zu sehen, der daran arbeitet.
  • Die Befehle „Undo/Redo“ funktionieren auch beim Arbeiten mit dem Online Editor Client. Solange sich ein Element in deiner Undo-History befindet, blockierst du dieses. Es wäre von Vorteil, deine Undo History von Zeit zu Zeit zu löschen und damit deine Blockierungen aufzuheben. Benutze hierfür einfach den entsprechenden „Flush“-Button in der Toolbar.
  • Wenn du die Asset History benutzt, kannst du ein Asset zu seinem vorherigen Zustand zurücksetzen.

Online Editor Client

ACHTUNG

  • Benutze nicht den Online Editor Client, um das Offline-Verzeichnis deines Spiels zu bearbeiten. Das kann zu Datenverlust führen! Falls du Offline-Content mit dem Online Editor bearbeiten willst, erstelle zuerst eine Sicherheitskopie deines Spielverzeichnisses.

 

Den EMERGENCY 2017 Online Editor einrichten

Der EMERGENCY 2017 -Editor ist als reiner Offline-Editor voreingestellt. Um die Verbindung mit dem Editor Server zu ermöglichen, öffne die Datei „bin\editor.app“ mit einem Texteditor und verändere die Zeile

  • "EditorServerHostPort": "offline:4242"

zu

  • "EditorServerHostPort": ""

Wenn du nun den Editor startest, öffnet sich das Verbindungs-Fenster. Es gibt ein Auto-Connect-Feature; solltest du das Verbindungs-Fenster nicht sehen und im Offline-Editor landen, trenne den Editor (Menu -> File -> Disconnect), und das Fenster sollte erscheinen.

 

Mit dem EMERGENCY 2017 Online Editor Server verbinden

Im Verbindungs-Fenster musst du die Server-Adresse und Port angeben.

 

Die Offline- und Online-Editor Clients sind identisch. Es gibt im Grunde drei Optionen: Offline, Local Server Server, Remote Server.

  • Offline: Ein Editor Client wird zum Offline Editor Client, indem er sich mit einem Offline Editor Server „verbindet“ (du musst in diesem Fall keinen Server erstellen). Dazu schreibst du einfach „offline“ in die Adresszeile des Editor Servers. Die Portnummer spielt in diesem Fall keine Rolle.
  • Local: Für den Fall, dass der Online Editor Server auf dem gleichen Rechner liegt wie der Online Editor Client, brauchst du keine Internetverbindung. BEISPIEL: Wenn der lokale Online Editor Server auf Port 4042 läuft, wäre die Editor Server-Adresse „localhost:4042“
  • Remote: Der Standardfall für Zusammenarbeiten. Du musst die Server-Adresse und die Portnummer wissen, um dich verbinden zu können. Eine Server-Adresse könnte beispielsweise „mytestem5onlineeditorserver.de“ sein, wo der Online Editor Server über Port 4042 erreichbar ist.

Sobald du dich erfolgreich mit dem Online Editor Server verbunden hast, wirst du als nächstes das Login-Feld sehen. Hier musst du deinen User-Namen und dein Passwort eintragen, das du von deine Online Server Admin erhalten hast. Als letztes wählst du im „Project Map“-Fenster eine Karte aus, an der du arbeiten möchtest – und schon geht’s los.

 
Nicht übereinstimmende Online Editor Server und Online Editor Client Versionen
Im Falle einer nicht übereinstimmung von Online Editor Server und Online Editor Client Version wird eine Verbindung aus Sicherheitsgründen nicht zugelassen. Falls Sie wissen was Sie tun, können Sie diesen Versions-Sicherheitstest überspringen indem Sie die Datei "qsf_editor_settings.json" in Ihrem Benutzerverzeichniss öffnen und die Einstellgungen wie folgt ändern:
"
},
"qsf::editor::DeveloperSettingsGroup":
{
   "IgnoreEditorServerHostPort": "true",
   "IgnoreEditorServerVersionCheck": "true"
},
"qsf::editor::RenderingSettingsGroup":
{
"
Einstellung "IgnoreEditorServerVersionCheck" auf "true" deaktiviert den Versionstest, Einstellung "IgnoreEditorServerHostPort" auf "true" deaktiviert zusätzlich die feste Koppelung an einen bestimmten Server.


Online Editor Server

  • Anmerkung: Dieser Paragraph ist für Online Editor Server-Admins.
  • ACHTUNG
    • Der Online Editor Server benötigt ein eigenes Arbeitsverzeichnis. Erstelle es nicht innerhalb des EMERGENCY 5-Installationsverzeichnis, DIES KANN ZU DATENVERLUST FÜHREN. Für den Server ist „en5game/data“ ein Ablageverzeichnis für Assets. Dateien, die der Server nicht erkennt, kann und wird er einfach löschen.
    • Der Editor Server managet Asset-Überarbeitungen. Wenn du den Online Editor Server nicht nur für ein schnelles Ausprobieren nutzen möchtest, empfehlen wir deswegen mindestens 50GB freien Speicherplatz auf deiner Festplatte.

Die EMERGENCY 2017 SDK wird mit einem voreingestellten Editor Server geliefert, den du in „/editor_server“ finden kannst. Der Online Editor Server ist eine Microsoft Windows Console Application, die auf einem Rechner läuft und über einen Port mit der Welt kommuniziert. Die Executable findest du unter „editor_server/bin/x64r/qsf_editor_server.exe". Die Erstellung eines Online Editor Servers besteht aus den folgenden Schritten:

  • Starte die Online Editor Server Anwendung (z.B. mit „start_editor_server.bat“)
  • Bespiele den Server mit anfänglichen Dateien.

 

Starte die Online Editor Server Anwendung

Der Online Editor Server speichert Dateien im Verzeichnis "/editor_server/server". Wenn du den Online Editor Server zum ersten Mal startest, wird das Serververzeichnis automatisch erstellt, ebenso wie ein Admin-Account names „admin“. Das Passwort wird automatisch erstellt und ins Log geschrieben. Das Log findest im Verzeichnis „/edtor_server/server/server/etc/log“. Suche im Server-Log so etwas wie „[QSF info] Generated new password for user „admin“: “Y34Bwzoy5qKPCHUbicOg0lBqsDNy0NLa"".

 

Gehe sicher, dass die Anwendung nicht von der Windows Firewall blockiert wird. Das gehört zum Grundkurs für Server-Admins, also google es, wenn du nicht weißt, wie die Firewall funktioniert.

 

Der Port, über den Online Editor Server anwählbar ist, kann in der Datei "/editor_server/server/etc/qsf_editor_server_settings.json“ per Texteditor konfiguriert werden.

Du kannst die Zeile "AssetServerPort" zum Beispiel auf 4042 setzen (das ist die Grundeinstellung). Wenn deine Server-Adresse beispielsweise „mystestem5onlineeditorserver.de“ ist, würde ein Online Editor Client-User „mytestem5onlineeditorserver.de:4042“ eingeben, um sich mit dem Server zu verbinden. Sobald du „QSF started server 0.0.0.0 at port 4042“ in der Windows Kommandozeile lesen kannst, läuft der Server und User können sich damit verbinden.

Um neue Online Editor User hinzuzufügen, startest du den Online Editor Client und logge dich mit deinem Admin-Account ein. Wenn du den Admin-Account benutzt hast du Zugriff auf das Server-Management-Fenster, das du im Dateienmenü findest. Dieses Fenster erlaubt es dir, die User-Liste zu verändern, die in der Datei "/editor_server/server/users/users.json" abgelegt ist.

Wenn der Server herunterfährt, speichert er automatisch die letzten Asset-Veränderungen in "/editor_server/data", das vom Spiel und vom Offline-Editor genutzt wird. Solltest du mit einem Projekt aus dem Online-Editing ins Offline-Editing wechseln wollen, kannst du einfach den Offline Editor Client weiternutzen. Wenn du das Projekt wieder online bearbeiten willst, musst du einen neuen Server kreieren.

 

Bespielen des Servers mit anfänglichen Dateien

Es ist möglich, einen neu erschaffenen Server per Offline Editor mit bearbeitetem Inhalt zu bespielen. Wenn du dich mit einem Admin-Account zum ersten Mal in einen Online Editor Server einloggst, füllt sich der Server automatisch mit den anfänglichen Dateien des Clients. Das kann einige Zeit in Anspruch nehmen, da es sich um jede Menge Dateien handelt.

Hinweise

  • Im Falle von auftreten von Fehlern wie "missing local file", öffnen Sie bitte den Asset Maintenance Dialog (menu -> file -> asset maintenance) um die Fehler zu lokalisieren und zu beheben so das die Asset-Datenbank sich in einem konsistenten Zustand befindet.

 

Den Online Editor Server über das Internet verfügbar machen

Im Internet gibt es jede Menge Information zum Thema „Port Forwarding“.

Weitere Hinweise auf Englisch:
"

You have to do a port forwarding for the port specified as "AssetServerPort" in the configuration with protocol UDP with target ip/hostname the IP/hostname of the PC which is hosting the asset server

You have to do it manually if you don't want to use forwarding via UPNP or it doesn't work (e.g. the firewall/router doesn't support forwarding via UPNP)

In order to enable port forwarding via UPNP, open the "server\etc\qsf_editor_server_settings.json" configuration file and change the value "qsf::editor::server::ServerSettingsGroup" -> "EnablePortForwardingViaUpnp" to "true". For security reasons, this option is disabled by default.
"