wikijs/services/partey/map.md

title	description	published	date	tags	editor	dateCreated
Partey Map		true	2021-03-31T10:09:59.613Z		markdown	2021-03-24T20:05:10.881Z

Eigene Karte erstellen

Um eine eigene Karte zu erstellen folgst du einfach der Anleitung von Workadventure [english]. Nachdem du deine Karte erstellt hast, kann die Karte automatisch in Partey eingebunden werden. Die genauen Schritte dazu werden hier erklärt.

Karte für Partey vorbereiten

Workadventure funktioniert nur mit .json-Maps. Exportiere also deine Karten ins JSON-Format oder speichere diese direkt als JSON ab.

Es findet keine Überprüfung auf Korrektheit deiner Karte statt. Fehlt also die main.json oder der start-Layer, ist die exitUrl falsch angegeben oder ein Tileset nicht korrekt werden andere Benutzer mit diesen Fehlern direkt konfrontiert. {.is-info}

Einstiegspunkt

Der Einstiegspunkt in deine Karte ist automatisch immer die main.json. Benenne also deine Startmap in main.json um. Vergiss nicht den start-Layer zu setzen.

Exit-Layer

Der Austiegspunkt zurück in das virtuelle Vereinsheim ist immer über folgende exitUrl erreichbar: ../../member.json#start_{username}. Ersetze {username} natürlich noch mit deinem Usernamen.

Beispiel für den User foobar: ../../member.json#start_foobar.

Beispiel Karte

Als Beispiel für eine eigene Karte kannst du dir die Map von Lurkars unter git.bstly.de/Lurkars/prty-map anschauen.

Karte in Partey einbinden

Damit die Karte automatisch eingebunden werden kann, muss die Karte in einem Git-Repository liegen und die URL über dein we.bstly-Profil angegeben sein. Über das Repository wird die Karte automatisch zur Partey-Karte hinzugefügt und in einem regelmäßigen Intervall aktualisiert. Du kannst also jederzeit deine Karte durch Änderungen in deinem Repository aktualisieren.

Git-Repository

Ein Git-Repository bekommst du entweder über unseren Gitea Dienst oder bei verschiedenen kostenlosen Anbietern wie GitHub, GitLab oder Bitbucket. Eine schnelle Anleitung für den Einstieg in Git findest du hier. Die verschiedenen Dienste wie Gitea erklären die Einrichtung beim erstellen eines neuen Repositories aber meistens auch. Hier eine schnelle Auflistung der wichtigstens Befehle wenn du dein Repsoritory erfolgreich eingerichtet hast:

# Änderungen und neuen Dateien hinzufügen
git add . 
# Änderungen übernehmen
git commit -m "Text über deine Änderungen"
# Änderungen hochladen
git push

Manche Dienste bennen den Hauptzweig eines neuen Repositories oft mit master. Wir empfehlen für den Hauptzweig eine andere Bezeichung wie z.B. main zu wählen, siehe Code ohne Rassismus [Golem]. {.is-info}

Zugriff

Wenn dein Repository öffentlich ist, reicht es den http-Link in dein Profil einzutragen. Möchtest du gerne ein nicht öffentliches Repository verwenden, musst du für folgenden Öffentlichen Schlüssel Lesezugriff gewähren und den ssh-Link in dein Profil übernehmen.

Repository-Url zum Profil zufügen

Füge eine neues Profilfeld vom Datentyp URL mit dem Namen prtyMap deinem Account hinzu und trage als Link einfach die URL zu deinem Repository ein. Das Profilfeld kann auch auf Privat gestellt sein.

Änderungen der Repository URL werden ignoriert! Das Repository wird einmalig hinzugefügt und dann nur noch geupdated. Möchtest oder musst du die URL ändern, lösche bitte deine Karte und warte eine Weile, bis deine Karte auch wirklich entfernt wurde. Anschließend kannst du eine neue URL eintragen. {.is-warning}

Karte löschen

Du kannst natürlich auch jederzeit deine Karte wieder aus Partey entfernen. Dazu musst du nur das Profilfeld prtyMap löschen. Im nächsten Update-Intervall wird die Karte dann automatisch vom Server und aus der Partey-Karte entfernt.