Seite gesperrt

Diese Seite ist momentan von einem anderen Benutzer gesperrt. Warte, bis dieser mit dem Bearbeiten fertig ist oder die Sperre abläuft.
Momentan gesperrt von: 3.143.209.210
Sperre läuft ab am: 2025/04/30 06:18 (8 min)
Diese Seite ist nicht editierbar. Du kannst den Quelltext sehen, jedoch nicht verändern. Kontaktiere den Administrator, wenn du glaubst, dass hier ein Fehler vorliegt.
====== Howto Workadventure Maps ======
===== Schnell-Überblick =====
==== Limitierungen ====
Instanzen skalieren nicht unendlich, bitte denkt beim Karten erstellen daran. Unsere Erfahrung zeigt, dass das Limit irgendwo bei 200 Nutzer:innen liegt. Karten für 2k Spieler:innen ergeben also keinen Sinn. Bitte versucht nicht, Vortragssäle nachzubauen. Es ergibt schlichtweg keinen Sinn, im Spiel zu idlen und währenddessen Talks zu schauen.

Die Map-Größe kann davon unabhängig relativ flexibel dimensioniert werden. Karten im Bereich von 128x128 Tiles laufen ziemlich gut, Karten im Bereich von 1000x1000 gehen mit einer relevanten Ladezeit einher. Wir raten eher zu mehreren kleineren Karten anstelle einer riesigen.

==== Starter-Kit ====
Falls ihr nicht wisst wo/wie ihr anfangen sollt gibt es verschiedene Starter-Kits das ihr einfach forken könnt:
  * [[https://git.cccv.de/rc3/world-map-starterkit]]
  * [[https://github.com/workadventure-xce/workadventure-xce-map-starter-kit]]

==== Tiles / Sprites ====
Grundlegend bestehen die Karten aus sogenannten Tiles oder Sprites. Historisch gibt es wohl Unterschiede zwischen den Begriffen, wir werden sie hier aber synonym verwenden. Tiles können Transparenz beinhalten und liegen im png-Format vor.

==== Layer und Attribute ====
Damit ein Tile weitergehende Eigenschaften als sein Aussehen hat, müssen entsprechende Attribute zugeordnet werden. Dies erfolgt über Layer: Das Layer trägt Attribute, und speichert für welche Felder sie gelten sollen.

===== Kartengestatung =====
==== Tiles ====
=== Tiles finden ===
Tiles gibt es massig im Internet, häufig zu Tilesets (mehrere Tiles zu einem Thema) zusammengefasst. Seiten auf denen ihr schöne Tiles finden könnt sind zum Beispiel:
  * [[http://itch.io]]
  * [[http://opengameart.org]]
  * [[http://deviantart.com]]
  * [[https://git.cccv.de/rc3/world-tiles|Shared Tiles Repo]]
Achtet auf die Größe der Tiles!
Achtet auf die Lizenz der Tilesets!

=== Tiles gestalten / "pixeln" ===
Tiles können auch selbst gestaltet bzw. vorhandene verändert werden, was häufig auch "pixeln" genannt wird. Hierzu empfiehlt sich der Editor [[https://krita.org/|krita]], es geht aber prinzipiell auch mit anderen.

  * ListenpunktAchtet auch hierbei darauf, dass die Tiles 32x32 Pixel groß sind. Ihr könnt euch unter view -> show grid ein Raster einblenden und unter settings -> dockers -> grid and guides den Einstellungs-Docker einblenden, in dem ihr die Grid-Größe festlegen könnt.
  * ListenpunktFalls ihr Übergänge von Materialien gestalten müsst, nutzt Transparenz und baut Übergänge von einem Material zu Transparenz, das ist vielseitiger nutzbar und erspart euch, zu jedem anderen Material einen Übergang gestalten zu müssen.
  * ListenpunktPixel-Art Workshop von blinry: [[http://media.ccc.de/v/34C3-jugend-hackt-1016-pixel_art_workshop]]

=== Wände / Kollisionen ===
Um Tiles als undurchgängig zu markieren, müsst ihr diese im Tileeditor öffnen und die custom property ''collides'' (bool true) für das jeweilige Tile (nicht mit Layern verwechseln!) setzen. Vergesst nicht euer Tileset anschließend zu speichern! Tiled bietet zwar auch die Möglichkeit collision shapes für einzelne Tiles festzulegen, diese werden von der Software allerdings ignoriert.

{{:infra:workadventure:maps:edit_tileset.png?400 |}} {{:infra:workadventure:maps:cp_collides.png?400 |}}

=== Tiles einbinden ===
Tilesets müssen in Tiled in die Map eingebunden werden, ein Verweis auf externe Tilesets im TSX Format ist nicht möglich. (Das heißt nicht, dass die Bilddateien mit eingebunden sind. PNG-Dateien müssen ebenfalls auf den Server geladen werden.)

==== Maps ====
Karten können mittels des Editors [[https://www.mapeditor.org/|Tiled]] erstellt werden. Ähnlich wie in diversen Zeichenprogrammen können Karten aus mehreren Layern bestehen, die beim Rendern übereinander gelegt werden. Layer können transparent gestaltet werden.

=== Neue Karte in Tiled anlegen ===
Achtet beim Erstellen einer neuen Karte auf folgende Einstellungen:
  * Karte muss orthogonal sein.
  * Tilessize sollte 32x32 sein.
  * Während des Erstellens kann es sinnvoll sein, eine unendliche Karte zu verwenden statt vorab eine Größe festzulegen. Dies muss beim finalen Speichern der Karte wieder auf eine feste Größe geändert werden.

=== Karte gestalten ===
Eine Karte kann aus beliebig vielen übereinander gelegten Tile Layern bestehen. Eure Karte braucht dabei mindestens einen Startlayer, der definiert, wo auf der Karte neue Spieler:innen spawnen. Dieses Layer muss zwingend ''start'' heißen. Außerdem braucht ihr ein Object Layer ''floorLayer'' das definiert, auf welchem Layer sich die Spielfigur bewegt.

{{ :infra:workadventure:maps:layer.png |}}

Für ein leichteres Gestalten hebt euch den aktuellen Layer hervor:
{{ :infra:workadventure:maps:settings_show_animations.png |}}

==== Spezielle Layer ====
Es gibt ein paar spezielle Layer bzw. Zusatzfunktionen für Layer. Diese werden bis auf das Start Layer über die custom properties der einzelnen Layer abgebildet.

=== Start Layer ===
Eure Karte braucht zwingend ein Start Layer mit dem Namen ''start''. Alle Stellen in diesem Layer, die ein Tile (egal welches) enthalten, sind später Startpunkte für neue Spielfiguren. Gibt es mehrere Tiles, wird beim Betreten zufällig eines davon als Startpunkt ausgewählt. Schiebt dieses Layer am besten ganz nach unten in eurem Stack, die Tiles, die Startpunkte markieren, werden dann einfach von den darüberliegenden verdeckt.

Außerdem könnt ihr weitere Start Layer erstellen, um weitere Einstiegspunkte zu definieren, zum Beispiel um an bestimmte Stellen auf eurer Karte zu springen. Diese Layer funktionieren ähnlich wie der eigentliche Start Layer (also einfach beliebige Tiles an die Stelle, wo die Spielfigur spawnen soll), können beliebig heißen, brauchen allerdings eine custom property ''startLayer'' (bool true). Der Name dieses Layers ist auch die "Sprungadresse", die ihr zum Betreten über dieses Layer braucht. Wenn eure Karte also ''foo.json'' heißt und der Start Layer, auf den ihr springen wollt, ''bar'', dann wäre die Sprungmarke dafür ''foo.json#bar''.

{{ :infra:workadventure:maps:cp_startlayer.png |}}

=== Exit Layer ===
Ähnlich wie beim Start Layer könnt ihr Exits definieren. Ihr erzeugt ein Layer, packt an die Stellen an denen ihr Ausgänge haben wollt ein Tile, und gebt dem Layer die custom property ''exitUrl''. Dieser gebt ihr als Wert (string) die Karte bzw. den Startpunkt auf dieser Karte zu der ihr springen wollt, zum Beispiel also ''foo.json#bar'' um auf die Karte foo.json und dort auf einen Startpunkt auf dem Layer bar zu springen.

{{ :infra:workadventure:maps:cp_exiturl.png |}}

==== Weitergehende Inhalte ====
=== Webseite einbinden ===
Ihr könnt Webseiten einbinden, die sich beim Betreten von bestimmten Tiles öffnen. Analog zu Start und Exit Layern legt ihr ein Layer dafür an, setzt Tiles an die entsprechenden Stellen und gebt dem Layer die custom property ''openWebsite'' (string). Verwendet https!

{{ :infra:workadventure:maps:cp_openwebsite.png |}}

=== Jitsi einbinden ===
Jitsi Räume sind per default an die Instanz gebunden, damit jeder sein eigenes "Hackcenter" haben kann. Es können keine externen Jitsi Server angegeben, sondern nur von uns bereitgestellte genutzt werden.

=== Stille Bereiche ===
Solltet ihr in gewissen Bereichen keine Audio/Video Kommunikation zwischen den Teilnehmern wollen, so könnt ihr hierfür einen eigenen Layer anlegen und diesem die custom property ''silent'' (bool true) geben.

{{ :infra:workadventure:maps:cp_silent.png |}}