diff --git a/docs/maps.en.md b/docs/maps.en.md
index dd4dbd5e548bba7f83486dd3ce6a636b43a85033..471bd5072de82cd8115f859433f448e5fa935930 100644
--- a/docs/maps.en.md
+++ b/docs/maps.en.md
@@ -20,6 +20,7 @@ This tutorial is "work in progess", hence its worth checking it from time to tim
* 2020-12-17: Audio: removed external URLs. **IMPORTANT:** If you want to include streams please contact us!
* 2020-12-20: Starter kit added.
* 2020-12-22: World-Exit added.
+* 2020-12-22: Cross-Assembly Links added.
## Known Bugs
Following bugs are known and worked on:
@@ -201,6 +202,15 @@ A example map might look like this:
### Entrypoint / Lobby / Exit
We create central Entrymaps to join the world and lead to the different assembly maps. Please drop us an email via [world@rc3.world](mailto:world@rc3.world) naming your assemblyname, that we can reserve an exitpoint to your assembly. Besides that we would ask you to reserve a spot for an exit back to the lobby maps on your map. Tiles and the address for the jump will be provided by us via mail.
+### Crossy-Assembly links
+There will be placeholders which get automatically replaced by the right url. Example for a placeholder: `{<SLUG>/map.json#YourStartLayer}`. **< and > are important and need to stay in the placeholder!**
+
+You can find _your slug_ in the Maschinenraum under Organisational Data -> Basic Data -> "Slug".
+
+If you want to link to the foobar assembly for example and the foobar assemblys slug is `foobar`, the value for the exit layer would be `{<foobar>/main.json}`.
+
+Attention: This does **not** work for the test instance.
+
### Testing
For testing you may put the map on any server reachable by https and embed the URL in our test instance. Lets assume your map is stored under _https://example.com/mymaps/foo.json_ then the URL to test it would be *https://test.visit.at.wa-test.rc3.cccv.de/_/global/example.com/mymaps/foo.json*. The option to load external maps is just for testing and will be disabled for rC3.
@@ -209,5 +219,9 @@ You might need to set the matching CORS Headers on the server serving the map.
## Hosting your own Instance
Please do not try to host your own instance! We will not allow jumps to external instances!
+## Big Blue Button
+We like BBB, but the rC3.world already contains a stable inclusion of jitsi, which we host on dedicated hardware. We currently do not have the resources to make BBB embedding possible.
+Please don't expect BBB for the rC3.world and use jitsi instead.
+
## Infrastructure
The infrastructure is kindly sponsored by <a href="https://www.hetzner.com/de/cloud"><img src="img/hetzner-logo.svg" alt="hetzner online" width="100px" /></a>.
diff --git a/docs/maps.md b/docs/maps.md
index 468d9d4b5fa8a881b5c2fe73c8fc60f6210c59ed..7123267174809f595fba5020f5fdb5300ceb36ce 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,18 @@ 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: `{<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 die Assembly foobar linken und der Slug vom foobar Assembly lautet `foobar`, dann ergibt sich `{<foobar>/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.
@@ -218,8 +231,8 @@ Ggf. kann es sein, dass ihr passende CORS Header auf dem ausliefernden Webserver
Wir werden sämtliche Instanzen für die rC3.world betreiben, versucht bitte nicht, eigene Instanzen dafür aufzusetzen, Sprünge zu Instanzen außerhalb der rC3.world werden nicht möglich sein.
## Big Blue Button
-Wir mögen BBB, aber WorkAdventure bietet bereits eine solide Einbettung für Jitsi, welches wir auf dezidierter Hardware betreiben. Der Aufwand BBB einbindbar zu machen ist aktuell nicht stemmbar für uns.
-Bitte rechnet nicht damit und benutzt stattdessen Jitsi für den rc3.
+Wir mögen BBB, aber die rC3.world bietet bereits eine solide Einbettung für Jitsi, welches wir auf dezidierter Hardware betreiben. Der Aufwand BBB einbindbar zu machen ist aktuell nicht stemmbar für uns.
+Bitte rechnet nicht damit und benutzt stattdessen Jitsi.
## Infrastruktur
Die Infrastruktur der rC3.world wird von <a href="https://www.hetzner.com/de/cloud"><img src="img/hetzner-logo.svg" alt="hetzner online" width="100px" /></a> gesponsert.