70 lines
4.8 KiB
Markdown
70 lines
4.8 KiB
Markdown
---
|
|
title: Partey Map
|
|
description:
|
|
published: true
|
|
date: 2021-09-28T08:32:40.201Z
|
|
tags:
|
|
editor: markdown
|
|
dateCreated: 2021-03-24T20:05:10.881Z
|
|
---
|
|
|
|
# Eigene Karte erstellen
|
|
|
|
Um eine eigene Karte zu erstellen folgst du einfach der [Anleitung von Work Adventure](https://workadventu.re/map-building/) \[english\]. Nachdem du deine Karte erstellt hast, kann die Karte automatisch in [Partey](/de/services/partey) eingebunden werden. Die genauen Schritte dazu werden hier erklärt.
|
|
|
|
## Karte für Partey vorbereiten <a name="preparation" id="preparation"></a>
|
|
|
|
Work Adventure funktioniert nur mit `.json`-Maps. Exportiere also deine Karten ins JSON-Format oder speichere diese direkt als JSON ab. Achte auch darauf, dass die Tilesets eingebettet sind. Beim Importieren von Tilesets unbedingt das entsprechende Häkchen setzen.
|
|
|
|
> 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 <a name="entry" id="entry"></a>
|
|
|
|
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 <a name="exit" id="exit"></a>
|
|
|
|
Der [Ausstiegspunkt](https://workadventu.re/map-building/entry-exit#defining-exits) 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 <a name="example" id="example"></a>
|
|
|
|
Als Beispiel für eine eigene Karte kannst du dir die Map von [Lurkars](https://we.bstly.de/p/Lurkars) unter [git.bstly.de/Lurkars/prty-map](https://git.bstly.de/Lurkars/prty-map) anschauen.
|
|
|
|
## Karte in Partey einbinden <a name="embed" id="embed"></a>
|
|
|
|
Damit die Karte automatisch eingebunden werden kann, muss die Karte in einem Git-Repository liegen und die URL über dein [we.bstly-Profil](/de/services/webstly#profile) 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 <a name="git" id="git"></a>
|
|
|
|
Ein Git-Repository bekommst du entweder über unseren [Gitea](/de/services/gitea) Dienst oder bei verschiedenen kostenlosen Anbietern wie [GitHub](https://github.com/), [GitLab](https://gitlab.com/) oder [Bitbucket](https://bitbucket.org/). Eine schnelle Anleitung für den Einstieg in Git findest du [hier](https://rogerdudler.github.io/git-guide/index.de.html). Die verschiedenen Dienste wie [Gitea](/de/services/gitea) erklären die Einrichtung beim erstellen eines neuen Repositories aber meistens auch. Hier eine schnelle Auflistung der wichtigsten 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 benennen den Hauptzweig eines neuen Repositories oft mit *master*. Wir empfehlen für den Hauptzweig eine andere Bezeichnung wie z.B. **main** zu wählen, siehe [Code ohne Rassismus](https://www.golem.de/news/black-lives-matter-code-ohne-rassismus-2006-149032.html) \[Golem\].
|
|
{.is-info}
|
|
|
|
|
|
#### Zugriff <a name="access" id="access"></a>
|
|
|
|
Wenn dein Repository öffentlich ist, reicht es den http-Link in dein [Profil](#profile) einzutragen. Möchtest du gerne ein nicht öffentliches Repository verwenden, musst du für folgenden [Öffentlichen Schlüssel](/partey/workdadvenutekey.pub) Lesezugriff gewähren und den SSH-Link in dein [Profil](#profile) übernehmen.
|
|
|
|
### Repository-Url zum Profil zufügen <a name="profile" id="profile"></a>
|
|
|
|
Füge eine [neues Profilfeld](/de/services/webstly#profile) 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](#delete) bitte deine Karte und warte eine Weile (~5-10 Minuten) bis deine Karte auch wirklich entfernt wurde. Anschließend kannst du eine neue Url eintragen.
|
|
{.is-warning}
|
|
|
|
|
|
## Karte löschen <a name="delete" id="delete"></a>
|
|
|
|
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. |