WorkAdventure Event Karten

An der TU-Ilmenau werden nun zunehmend Veranstaltungen im WorkAdventure der FeM veranstaltet. Die FeM unterstützt euch bei der technischen Durchführung der Veranstaltung. Dies ist ein technischer Leitfaden für die Veranstaltenden.

Die WorkAdventure-Karten

In der Regel sind die WorkAdventure-Karten in einem Git-Repository organisiert. In diesem Repository befinden sich neben den Assets (Grafiken usw.) auch Karten (*.json).

Mehr Info zum Erstellen einer Karte und den Spezifikationen findest du unter maps.

Aufbau von WorkAdventure-Events

Events im WorkAdventure bestehen üblicherweise aus einer zentralen WorkAdventure-Karte, der Lobby. Hier kommen alle neuen Teilnehmenden an. Von dort aus wird in der Regel auf Karten aus anderen Repository weiter verlinkt, die andere beigesteuert haben.

Hinweise zur Lobby

Bei WorkAdventure gibt es ein weiches Limit von 150 Spieler*innen pro Karte. Dieses Limit ist vor allem durch die Leistungsfähigkeit der Endgeräte der Teilnehmenden bestimmt. Vor allem, wenn viel in der Welt passiert, z.B. viele Jitsi-Räume oder normale Bubbles, sollte eher auf 50-100 Spieler*innen pro Karte optimiert werden.

Um genug Platz für alle Spieler*innen zu schaffen, ist es durchaus notwendig die Lobby auf mehrere Karten zu verteilen. Passt dabei auf, wie ihr zwischen die Karten verlinkt, damit ihr im Zweifel keine Engstellen erzeugt. Kreise sind übrigens eine gute Wahl.

Einstiegsseite

Für jedes Event empfiehlt sich eine Landing-Page, in der noch einmal grob erklärt wird, was Menschen nun im Workadventure erwartet und wie man sich dort bewegt und mit anderen interagiert. An dieser Stelle sollte auch nochmal darauf hingewiesen werden, dass im nächsten Schritt Kamera und Mikrofon freigegeben werden müssen.

Außerdem ist es in WorkAdvetnure möglich, dass Karten externe Inhalte einzbinden. Darauf sollte auch hingewiesen werden.

Wir freuen uns wie alle anderen immer über etwas Würdigung unterer ehrenamtlichen Tätigeit und diese Seite eignet sich auch ganz gut dazu, mal auf die Homepage der FeM zu verlinken :)

Jitsi-Räume

Die Jitsi Räume in den Maps können auch von Teilnehmenden betreten werden, wenn sie nicht in der Welt sind. Die URLs dazu, generieren sich folgendermaßen:

Ordnerstruktur eines Events

Wenn wir euer Event bei uns veröffentlichen werden wir die Repositorys folgendermaßen anordnen.

<event>
|-- <repo1>
| |-- <map1>.json
| |-- <map2>.json
| |-- <other assets>
| |-- ...
|-- <repo2>
| |-- <map>.json
| |-- <other assets>
|--<repo3>
| |-- <map>.json
| |-- ...

Exit-URL Schema

Aus der Ordnerstruktur eines Events ergibt sich ein Schema für die Exit-Urls. Dieses sieht wie folgt aus:

../<repo>/<map>.json#<layer>

Wenn wir also eine Karte main.json im Repo fem-office haben und von einer anderen Karte darauf verweisen wollen, sieht die Exit-Url wie folgt aus:

../fem-office/main.json

Workflow

Wenn die FeM die Karten für euch hosten soll, dann verwendet am besten diesen Workflow.

Vorbereitung

Gebt so früh wie möglich unter workworkwork@technik.fem-net.de bescheid. Auch wenn bei euch noch nichts feststeht. Somit können wir einfach etwas besser planen und dafür sorgen, dass alles dann auch funktioniert.

Beachtet unsere Hinweise zum Aufbau von Workadventure Events

Repos sammeln

Teile allen Menschen, die Karten beisteuern, die nötigen Exit-URLs zur Lobby mit.

Frage bei allen mitwirkenden Karten-Erstellern nach folgenden Informationen und halte diese in einer Liste fest:

URL zum Repository

Branch-Name: So kann zum Beispiel eine spezielle Version für das Event erstellt werden, falls die Karte bereits existiert.

Sende die fertige Liste an workworkwork@technik.fem-net.de

Veröffentlichung der Karten

Wenn du soweit alles zusammen hast, dann sende eine Liste mit allen Repository-URLs und Branch-Namen, die wir unter euer Event veröffentlichen sollen, an workworkwork@technik.fem-net.de.

Die Karten werden automatisch alle 15min bei uns aktualisiert und können so noch später bei Problemen spontan geändert werden.

Informationen für Teilnehmende

An die Teilnehmenden gibst du nur den Link zur Einstiegsseite raus. Das ermöglicht uns später noch die eigentlichen Urls zum WorkAdventure und zu den Karten bei technischen Problemen zu ändern.