From 83053b248e44a1d50180bd631e54755eabd18fe7 Mon Sep 17 00:00:00 2001
From: deinkoks <deinkoks@cert.ccc.de>
Date: Tue, 22 Dec 2020 21:16:17 +0000
Subject: [PATCH] Added cross-assembly links section
---
docs/maps.md | 15 +++++++++++++++
1 file changed, 15 insertions(+)
diff --git a/docs/maps.md b/docs/maps.md
index 468d9d4..b2f20ff 100644
--- a/docs/maps.md
+++ b/docs/maps.md
@@ -23,6 +23,7 @@ Dieses Tutorial ist ein work in progress und wird immer mal wieder erweitert, es
* 2020-12-17: Audio: Externe URLs werden nicht mehr unterstüzt. **WICHTIG:** Falls ihr Streams einbinden wollt, müsst ihr uns kontaktieren!
* 2020-12-20: Vorlage ergänzt.
* 2020-12-22: World-Exit ergänzt.
+* 2020-12-22: Cross-Assembly Links ergänzt.
## Known Bugs
Folgende Bugs sind aktuell bekannt, wir versuchen bereits, Lösungen dafür zu finden:
@@ -209,6 +210,20 @@ Hier ein Beispiel wie ein Verzeichnis mit Karten exemplarisch aussehen könnte:
### Einstiegspunkt / Lobby / Exit
Wir gestalten zentrale Einstiegskarten, über die man dann zu euren Assembly-Karten gelangt. Meldet euch dafür bitte unter Angabe eures Assemblynamens bei [world@rc3.world](mailto:world@rc3.world), damit wir einen Ausgang zu eurer Karte vorsehen können. Außerdem bitten wir euch, einen Platz für einen Ausgang zurück zur Lobby freizuhalten. Tiles und die genaue Sprungadresse dafür teilen wir euch dann per Mail mit.
+### Cross-Assembly Links
+Es wird Platzhalter geben welche automatisch mit dem richtigen Link ersetzt werden.
+Beispiel für einen Platzhalter (wird automatisch ersetzt): `exitURL: "{<SLUG>/map.json#YourStartLayer}"`
+
+**Die <> sind wichtig und müssen drin bleiben.**
+
+_Euren Slug_ findet ihr im Maschinenraum unter Organisational Data -> Basic Data -> "Kurzname"
+
+Ihr wollt zum Beispiel direkt auf den Himmel linken. Der Slug vom Himmel lautet `heaven`. Damit ergibt sich `exitURL: "{<heaven>/main.json}"` für euren Exit-Layer.
+
+Gegenwärtig müsst ihr die Slugs anderer Assemblies dort erfragen, ihr könnt sie nicht selbst im Maschinenraum sehen.
+
+Achtung: Das funktioniert _nicht_ auf der Testinstanz
+
### Testen
Zum Testen könnt ihr eure Dateien einfach auf einen beliebigen per https erreichbaren Server legen und über die URL auf unserer Testinstanz einbinden. Nehmen wir an, eure Karte läge unter _https://example.com/mymaps/foo.json_, so wäre die URL zum Testen *https://test.visit.at.wa-test.rc3.cccv.de/_/global/example.com/mymaps/foo.json*. Die Möglichkeit externe Karten einzubinden existiert nur zum Testen und wird zum rC3 deaktiviert werden.
--
GitLab