wikijs/services/partey/map.md

70 lines
4.8 KiB
Markdown
Raw Normal View History

2021-03-24 20:46:29 +01:00
---
title: Partey Map
description:
published: true
2021-09-03 10:01:05 +02:00
date: 2021-09-03T08:01:03.852Z
2021-03-24 20:46:29 +01:00
tags:
editor: markdown
2021-03-24 21:24:37 +01:00
dateCreated: 2021-03-24T20:05:10.881Z
2021-03-24 20:46:29 +01:00
---
# Eigene Karte erstellen
2021-09-03 10:01:05 +02:00
Um eine eigene Karte zu erstellen folgst du einfach der [Anleitung von Work Adventure](https://workadventu.re/map-building/wa-maps) \[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.
2021-03-24 20:46:29 +01:00
2021-03-31 12:08:45 +02:00
## Karte für Partey vorbereiten <a name="preparation" id="preparation"></a>
2021-03-24 20:46:29 +01:00
2021-09-03 10:01:05 +02:00
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.
2021-03-24 20:46:29 +01:00
> 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}
2021-03-31 12:08:45 +02:00
### Einstiegspunkt <a name="entry" id="entry"></a>
2021-03-24 20:46:29 +01:00
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.
2021-03-31 12:08:45 +02:00
### Exit-Layer <a name="exit" id="exit"></a>
2021-03-24 20:46:29 +01:00
2021-04-03 09:13:49 +02:00
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.
2021-03-24 20:46:29 +01:00
Beispiel für den User *foobar*: `../../member.json#start_foobar`.
2021-03-31 12:08:45 +02:00
### Beispiel Karte <a name="example" id="example"></a>
2021-03-24 20:46:29 +01:00
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.
2021-03-31 12:08:45 +02:00
## Karte in Partey einbinden <a name="embed" id="embed"></a>
2021-03-24 20:46:29 +01:00
2021-03-31 12:09:33 +02:00
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.
2021-03-24 20:46:29 +01:00
2021-03-31 12:08:45 +02:00
### Git-Repository <a name="git" id="git"></a>
2021-03-24 20:46:29 +01:00
2021-04-03 09:13:49 +02:00
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:
2021-03-24 20:46:29 +01:00
```
# Änderungen und neuen Dateien hinzufügen
git add .
# Änderungen übernehmen
git commit -m "Text über deine Änderungen"
# Änderungen hochladen
git push
```
2021-04-03 09:13:49 +02:00
> 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\].
2021-03-24 20:46:29 +01:00
{.is-info}
2021-03-31 12:08:45 +02:00
#### Zugriff <a name="access" id="access"></a>
2021-03-24 20:46:29 +01:00
2021-04-13 19:09:21 +02:00
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.
2021-03-24 20:46:29 +01:00
2021-03-31 12:08:45 +02:00
### Repository-Url zum Profil zufügen <a name="profile" id="profile"></a>
2021-03-24 20:46:29 +01:00
2021-03-31 12:09:33 +02:00
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.
2021-03-24 20:46:29 +01:00
2021-04-13 19:09:21 +02:00
> Ä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.
2021-03-24 20:46:29 +01:00
{.is-warning}
2021-03-31 12:08:45 +02:00
## Karte löschen <a name="delete" id="delete"></a>
2021-03-24 20:46:29 +01:00
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.