.gitmodules

+[submodule "themes"]
+	path = themes
+	url = https://git.cccv.de/infra/static-pages/mkdocs-themes.git

docs/endoftheworld.en.md

+The End is Nigh ...
+===
+
+[german version](endoftheworld.md)
+
+... but rC3-world will stay for just a little bit longer.
+
+rC3 ends with the the [closing event](https://fahrplan.events.ccc.de/rc3/2021/Fahrplan/#b25fac1a-e220-5f1a-9679-fc6b7680bccc) on December 30th at 19:00.
+After that we will provide most of the infrastructure on a best-effort basis**\*** until January 1st mid-morning and wish you all a very happy new year! Stay safe, stay home! Be excellent to each other!
+
+## World-Chats, Jitsi & BBB
+Yes, you can plan your new year's eve party with the Jitsi servers provided at rC3. Have a great evening together!
+
+## Lounge\*
+Yes, you may have a good evening inside the rC3 Lounge. Our DJ-team will dig deep inside their treasure-chests to entertain you.
+
+## Eventphone
+Yes, you can call all your favourite nerds at midnight via eventphone and wish them a happy new year.
+You can also reach several teams\* but please have a look on the maps of the individual teams like info desk and heaven, etc. where and when they are available.
+
+## Badges & Achievements
+Please be aware that after the end of the rC3-world everything will be gone forever. If you collected badges, you can export them in your profile on the platform. To do so, go to your profile page and the badge section and click on [Export all your badges as ZIP file](https://rc3.world/api/badges.zip).
+
+See you soon!

docs/endoftheworld.md

+Das Ende ist nah ...
+===
+
+[english version](endoftheworld.en.md)
+
+... aber die rC3-Welt bleibt noch ein klein bisschen länger stehen.
+
+Die rC3 endet mit dem [Closing Event](https://fahrplan.events.ccc.de/rc3/2021/Fahrplan/#b25fac1a-e220-5f1a-9679-fc6b7680bccc) am 30. Dezember um 19:00 Uhr.
+Danach werden wir weite Teile der Infrastruktur auf best-effort-Basis**\*** bis zum 1. Januar vormittags weiterbetreiben. Wir wünschen Euch allen einen guten Rutsch ins neue Jahr. Bleibt sicher, bleibt daheim. Be excellent to each other!
+
+## World-Chats, Jitsi & BBB
+Ja, Ihr könnt Eure Silvesterfeier mit dem r3-Jitsi planen. Habt einen schönen gemeinsamen Abend!
+
+## Lounge\*
+Ja, Ihr könnt Euch einen schönen Abend und Jahreswechsel in der rC3-Lounge machen. Unser DJ-Team gräbt tief in der Schatzkiste kramen um Euch zu unterhalten.
+
+## Eventphone
+Ja, Ihr könnt alle Eure Lieblingsnerds um Mitternacht via Eventphone anrufen und ihnen ein frohes neues Jahr wünschen.
+
+Ihr könnt auch einige der Teams\* via Eventphone erreichen, aber schaut bitte in der Welt auf den Maps der einzelnen Teams wie Infodesk oder Heaven ect., wann und über welche Wege sie erreichbar sind.
+
+## Badges & Achievements
+Bitte denkt dran, dass nach dem rC3-Weltuntergang alles für immer weg ist. Wenn Ihr Badges gesammelt habt, könnt Ihr diese in Eurem Profil auf der Plattform exportieren. Geht dazu zur Badge-Sektion Eurer Profilseite und klickt auf ["Export all your badges as ZIP file"](https://rc3.world/api/badges.zip).
+
+Bis bald!

docs/index.md

@@ -4,20 +4,28 @@ Dinge und die Möglichkeiten, zur Veranstaltungen beizutragen.
 
 Aktuell findet Ihr hier:
 
+* [Reiseführer](visit.md)
 * [Maps Tutorial](maps.md)
+* [HowTo Maschinenraum](maschinenraum.md)
 * [HowTo Play](play.md)
+* [Design/Styleguide](https://style.rc3.world)
+* [Spielregeln](rules.md)
+* [End of the world](endoftheworld.md)
 
 This pages should give you an overview over rC3 2021, connected services, as well
 as how to contribute to rC3.
 
 For now, you can find the following here:
 
+* [Travel Guide](visit.en.md)
 * [Maps Tutorial](maps.en.md)
+* [HowTo Maschinenraum](maschinenraum.en.md)
 * [HowTo Play](play.en.md)
+* [Design/Styleguide](https://style.rc3.world)
+* [Principles](rules.en.md)
+* [End of the world](endoftheworld.en.md)
 
 
-<!--
 The event would not be possible without some companies providing network hardware,
-cloud resources and connectivity services. Find them [here](sponsoring.md).
--->
-
+cloud resources and connectivity services. Find them
+[here](https://infra.rc3.world/sponsoring.html).

docs/map-best-practices.en.md

@@ -18,19 +18,33 @@ itself). Please keep them in mind while designing your assemblies.
 - place active elements far enough apart that it's easy to walk between them,
   especially if your map connects several other maps
 
+## Recommended Map Layout
+- it's best to create just a single tile with the property `collides` set to 
+  `true`, and only use it in a single layer "collisions"
+- you can use group layer to collect similar layers (e.g. all layers defining
+  entries or exits, all layers opening websites, etc.). This leaves your map's
+  behaviour unchanged, but makes working with (potentially large) maps with the
+  Tiled editor much easier
+
 ## Accessability
 - avoid animations or design them to be unobtrusive
 - take care to have sufficient contrast (especially between e.g. walls/floor)
 - mark areas playing sounds/music or opening jitsis (e.g. with a sign); don't
   place them directly on the entrypoint where people might run into them by
   mistake
-- place jitsis so that people can walk around them
+- interactive elements and especially video conferences should be placed and
+  designed to be clearly recognisable even before walking in; also be sure to
+  leave sufficient space around them if people want to just walk past them
+- jitsis and websites should only open after pressing the spacebar (i.e. set
+  `jitsiTrigger` / `openWebsiteTrigger` where appropriate)
 - include silent areas (a layer with property `silent` set to `true`)
 - mark thin passages as silent areas, or widen them so people can walk past each
   other without initiating a chat bubble
-- please think of direction when adding portals between maps — walking straight
-  through an exit and then continuing on should not immideately lead to another
-  exit. If in doubt, just include a few tiles distance between the two.
+- please consider directions when adding links between maps — walking straight
+  through an exit, then continuing straight onwards should not immideately lead
+  into another exit (if in doubt, just leave a few tiles' distance); turning
+  around immediately behind an exit and walking back in the opposite direction
+  should lead back to the previous map (in short, "doors should behave like doors")
 - if applicable, include content warnings 
 - warnings in front of long labyrinths or epileptic animations should be signs
   next to the exit that leads to the corresponding map, or next to an early exit

docs/map-best-practices.md

@@ -4,9 +4,9 @@
 ## Best Practices
 
 Folgende Punkte haben sich nach der letztjährigen rc3 und darauf folgenden divocs
-(abgesehe von den technischen Anforderungenm, die Workadventure selbst an die
+(abgesehen von den technischen Anforderungen, die Workadventure selbst an die
 Karten stellt) als Best Practices im Kartendesign herausgebildet. Bitte behaltet 
-sie beim gestalten eurer Assemblies im Hinterkopf.
+sie beim Gestalten eurer Assemblies im Hinterkopf.
 
 ## Logik:
 - Kollisionen nur dort einbauen, wo sie Sinn ergeben — vermeidet also bitte
@@ -16,35 +16,49 @@ sie beim gestalten eurer Assemblies im Hinterkopf.
 - "Rätsel"-Maps sollten einen leicht und schnell auffindbaren Ausgang direkt 
   neben dem Start haben, der direkt zurück führt, idealerweise sollte man nicht
   aus Versehen in eine Rätsel-Map hineinfallen können.
-- Bitte vermeidet Endlose Exit-Schleifen oder kenntzeichnet sie klar als Portal
+- Bitte vermeidet endlose Exit-Schleifen oder kennzeichnet sie klar als Portal
   (Ausgänge sollten nicht auf Eingänge auf der gleichen Map verweisen)
 - Aktive Elemente nicht so dicht nebeneinander legen, dass das Durchqueren der
-  Map einem Hindernisrennen gleicht (insbesondere, wenn die Map eine 
+  Map einem Hindernisrennen gleicht (insbesondere wenn die Map eine 
   Verbindungsfunktion hat)
 
+## Empfehlungen für eure Kartenstruktur
+- Erstellt am besten ein einziges Tile mit der Eigenschaft `collides` auf `true`,
+  das nur in einem einzigen Layer "collisions" verwendet wird
+- Benutzt Group Layer um mehrere Layer mit ähnlichen Funktionen (e.g. alle
+  exit/start Layer, alle Webseiten, etc.) zusammenzufassen; dies hat keinen 
+  Einfluss auf das Verhalten eurer Karte, macht das arbeiten mit (insbesondere
+  großen) Maps in Tiled etwas übersichtlicher
+
 ## Accessibility:
 - Animationen vermeiden oder unaufdringlich gestalten
 - achtet auf ausreichend Kontrast (besonders zwischen e.g. Wänden/Boden)
 - Musikeinspielung und Jitsis in der Map kennzeichnen (etwa durch ein Schild),
   und nicht direkt an den Eingang platzieren, sodass man nicht versehentlich
   darin landet
-- Jitsis so platzieren, dass man sie umgehen kann
+- Interaktive Elemente und insbesondere Videokonferenzen sollten so platziert
+  und gestaltet werden, dass man sie klar als solche erkennen und ggf. umgehen
+  kann
+- Jitsis und Webseiten sollten sich erst nach drücken der Leertaste öffnen
+  (i.e. setzt `jitsiTrigger` / `openWebsiteTrigger`)
 - Ruhezonen vorsehen (ein Layer mit `silent` auf `true`)
-- schmale Durchgänge als Ruhezone einstellen oder breit genug zum Ausweichen
+- schmale Durchgänge als Ruhezone einstellen oder Durchgänge breit genug zum Ausweichen anlegen
 - bei Übergängen zwischen Karten möglichst die Laufrichtung berücksichtigen —
   läuft man geradeaus durch einen Übergang und dann weiter, sollte man nicht
-  direkt wieder in einem Ausgang landen. Im Zweifel baut einfach ein paar Kacheln
-  Abstand dazwischen ein
+  direkt wieder in einem Ausgang landen (lasst im Zweifel einfach ein paar Kacheln
+  Abstand dazwischen); dreht man direkt nach dem Ausgang um und läuft in die
+  entgegengesetzte Richtung, sollte man wieder auf der vorherigen Map landen
+  (kurzgesatz einfach "Türen sollten sich wie Türen verhalten")
 - Gegebenenfalls Content Warnings einblenden
-- Warnung vor z.B. langatmigen Labyrinthen oder epileptischen Animationen 
-  als Schild nebem dem Exit zur entsprechenden Karte, oder early exit direkt 
+- Warnung vor z.B. langatmigen Labyrinthen oder stark flackernde Animationen 
+  als Schild nebem dem Exit zur entsprechenden Karte oder early exit direkt 
   an deren Anfang
 
 ## Zugänglichkeit auch ohne die world
 Nicht jede\*r kann oder will über die world mit der Veranstaltung interagieren.
 So schön eure liebevoll gepixelten Welten also auch sein mögen — denkt darüber
 nach, wie euer Assembly auch ohne diese erreichbar sein kann, und tragt z.B.
-eure jitsi-Räume (insbesondere, wenn dort Sessions/Workshops stattfinden!) im
-hub in euer Assembly ein, veröffentlicht eueren Schedule nicht nur als Schild
+eure jitsi-Räume (insbesondere wenn dort Sessions/Workshops stattfinden!) im
+Hub in euer Assembly ein, veröffentlicht euren Schedule nicht nur als Schild
 in der Karte, etc.
 

docs/maps.en.md

@@ -8,6 +8,9 @@ This tutorial is intended to explain how assemblies can contribute their own
 maps and content. For any remaining questions, don't hesitate to contact us via
 [mail](mailto:world@rc3.world); we'll do our best to extend this page.
 
+To exchange with others there is a
+[channel](https://chat.rc3.world/channel/world/) in the
+[public chat](https://chat.rc3.world/).
 
 ## Meta Information
 
@@ -50,9 +53,11 @@ are now leaving the event area").
 ### Scripts
 You can use all features included in workadventure's
 "[scripting api extra](https://workadventu.re/map-building-extra/about.md)";
-these will all be supported by rc3.world. However, please note that due to
-the large amount of review this would necessitate, including your own 
-self-written javascript will only be possible upon request.
+these will all be supported by rc3.world, except for using variables within links
+to any kind of ressource (e.g. in the `openWebsite` property). Additionally,
+please note that due to the large amount of review this would necessitate,
+including your own self-written javascript will only be possible upon request
+(send an email to world@rc3.world).
 
 ### Starter-Kit
 We will again offer a map building starter kit containing a simple map repository
@@ -74,10 +79,12 @@ obvious violations (e.g. exits to nonexistant maps), or suggest improvements.
 To contribute maps to the world, you have to
 [register an assembly](https://maschinenraum.rc3.world/).
 
-Please store your maps in a git repo of your choice and and enter a (publicly 
-clonable) URL to it our backend. Our infrastructure will then periodically pull 
-your map in, run a rudimentary linter on it to check for a few requirements and
-general consistency, and then deploy it to rc3.world.
+Please store your maps in a git repo of your choice. Then add a new room to your
+assembly. Click the button "create" in the "2D map" field. In the next window you can enter the (publicly clonable) URL of the git repo.  
+
+Our infrastructure will then periodically pull your map in, run a rudimentary
+linter on it to check for a few requirements and general consistency, and then
+deploy it to rc3.world.
 
 Please note that your map may also be rejected in case it contains errors (e.g.
 exits pointing to maps that do not exist) or is simply in the wrong format. If
@@ -85,6 +92,15 @@ that is the case, the back office will notify you and show you an appropriate
 error along with a short explanation — so in case your map doesn't change even
 after waiting and multiple reloads, please take a look there and check.
 
+#### Automatic notification
+You can also be notified automatically when there is a new linter result.
+To do this, create a file named `.mapservice` in the root directory of your repo.
+In this file you enter in which channel of the CCCV rocket chat the bot should write:
+`{"rocket_channel" : "#<CHANNEL>"}`. The channel can also be a person,
+in this case you enter `{"rocket_channel" : "@nick"}` in the file.
+
+Important: The account `Rocket.Cat` needs to be able to access your channel.
+
 ### Links between maps
 Within your repository you can use normal, relative links — e.g. to get from
 one map in `main.json` to another at `garden/secret-base.json`, just enter the
@@ -99,7 +115,7 @@ the rc3.world – these paths would be outside of your repository.
 ### Links to places outside your own assembly
 **Attention:** Does not work as it did last year!
 
-To get to other assemblies or other places in general (e.g. the lobby or lounge),
+To get to other assemblies or other places in general (e.g. the lobby),
 use the following link schema:
 
 `world://<assembly>/<map>.json`
@@ -108,7 +124,7 @@ Where `assembly` is the "technical name" (i.e. slug) of the target assembly, as
 set in the Maschinenraum for your own assembly. The remaining path is then relative
 to the map repository of the linked assembly.
 
-To get back to the lounge, just use `lounge` as the slug.
+To get back to the lobby, just use `lobby` as the slug. The link you'll have to use to connect your map to the lobby will be shown in the Maschinenraum.
 
 Since the validity of such links does not just depend on your own repository but
 also the entire event (and may even change over time), we cannot check such links
@@ -124,7 +140,7 @@ Obviously, your own map should contain at least one exit back to the lobby. As
 a recognisable and consistent exit, we recommend you use the following tile to
 mark it:
 
-![](./img/worldExit.png)
+![](https://tiles.rc3.world/rc3-2021/worldExit.png)
 
 
 
@@ -139,19 +155,25 @@ Please only use tiles that are 32x32 pixels large.
 Tiles can also be transparent, and are saved in the PNG format.
 
 ### Finding tiles:
+
+* We provide many tiles created for the event in our
+[Shared Tiles Repo](https://tiles.rc3.world/). These are also available as a git 
+repository at `https://git.cccv.de/rc3/world-tiles.git`. However, please note
+that we do not support git submodules; please add the files you need to your
+own repository directly.
 * Countless tiles are available on the internet, often combined into tilesets
-  (multiple tiles for one topic)
+  (multiple tiles for one topic).
 * Some examples of websites offering awesome tiles:
     * [itch.io](https://itch.io/)
     * [opengameart.org](https://opengameart.org/)
     * [deviantart.com](https://www.deviantart.com/)
-* Be sure to check that the tiles have the correct size!
+    * [kenney.nl](https://kenney.nl/assets?q=2d)
+* Be sure to check that the tiles have the correct size (32x32)!
 * Check the license of the tiles!
     * We will not actively check the licenses of your tiles, but react to
       violations on a "takedown on notice" principle!
     * Document the license of your tiles via the custom property
       `tilesetCopyright` (type string) on the tileset.
-* [Shared Tiles Repo](https://tiles.rc3.world/)
 
 ### How to design / "pixel" tiles
 You can also design your own tiles (or edit exisiting ones); this is frequently
@@ -188,7 +210,7 @@ of each other. Each map will need at least one tile layer named `start`. Visitor
 to your map will then spawn on a random tile of this layer by default (you can
 move this layer to the bottom of the stack, and let its tiles be covered by other
 layers). You will also need another layer named `floorLayer` of the type
-`objectgroup`, which defines on which layer avatars will move (i.e. which layers
+`Object Layer`, which defines on which layer avatars will move (i.e. which layers
 will be rendered above or below them).
 
 ![](img/layer.png)
@@ -218,6 +240,13 @@ Please pay attention to the licenses of the tiles you use, and document their
 copyright by setting the `tilesetCopyright` custom property (type string) on each
 tileset.
 
+To integrate a tileset into your map, click on "New Tileset" in the lower right corner.
+
+![](img/new_tileset.png)
+
+Here you take over all default settings and under "Source" simply select the PNG
+of your tileset. After that click on "OK" and the tileset is embedded in the map.
+
 ### Additional functionality per layer
 
 #### Start layer
@@ -263,6 +292,17 @@ Also note that websites which are outside of rC3 will be automatically prefixed
 with a dereferrer, which will alert visitors that they are now "leaving the
 event area".
 
+#### Embed website "as map"
+Web pages can also be included inline in maps, which means that they are displayed on the map.
+
+To do this, create a layer of type `Object Layer` and assign it
+the custom property `url` (type string).
+Its value is then the URL of the web page to be included, that is to be included.
+On this layer you create a rectangular area in which the area,
+in which the web page will be displayed.
+
+Additional information can be found in the official [WorkAdventure-HowTo](https://workadventu.re/map-building/website-in-map.md).
+
 ### Embedding Jitsi
 You can embed Jitsi rooms in the same way. Simply set the custom property
 `jitsiRoom` (type string) and assign it the name of your Jitsi room as its value.
@@ -297,11 +337,7 @@ it's not always possible to easily walk past each other.
 ![](img/cp_silent.png)
 
 ### Award badges
-You can award badges when stepping on certain tiles. Add a layer of type 
-`objectgroup` (important!), and then don't place tiles but points and/or 
-rectangles on that layer. Then set the custom property `getBadge` (type string)
-to the token of your badge (which you can find in the Maschinenraum, where you
-can also create new badges). Note that you will need a **Map** redeem token.
+You can award badges when stepping on certain tiles. Add a layer of type `Object Layer` (important!), and then don't place tiles but points and/or rectangles on that layer. To each of these objects you then assign the custom property `getBadge` (type String). Its value is the token of your badge  (which you can create in the Maschinenraum, where you can also create new badges). Note that you will need a **Map** redeem token.
 
 Badges will then be awarded to visitors walking across the corresponding areas
 of the map.
@@ -401,9 +437,9 @@ Your map repository should then look something like this:
 
 
 ## Testing
-We will offer a test instance whose behaviour should be as close as possible to
+A test instance whose behaviour should be as close as possible to
 the "real" infrastructure used during the event so you can test your map
-beforehand. It is currently still a work in progress and should go live soon.
+beforehand is available under [wa.tabascoeye.de](https://wa.tabascoeye.de).
 
 
 ## Self-Hosting

docs/maps.md

@@ -6,9 +6,13 @@ HowTo rC3 world maps
 Auch dieses Jahr wird es zur rC3 wieder eine Art 2D-Adventure, die rC3.world,
 geben. Dieses Tutorial soll erklären, wie Karten und Inhalte zur rC3.world
 beigesteuert werden können. Falls danach noch Fragen offen sind, meldet euch
-gerne per [Email](mailto:world@rc3.world) und wir versuchen das Tutorial zu 
+gerne per [Email](mailto:world@rc3.world) und wir versuchen, das Tutorial zu
 ergänzen.
 
+Zum Austausch mit anderen gibt es einen
+[Channel](https://chat.rc3.world/channel/world/) im
+[public Chat](https://chat.rc3.world/).
+
 ## Metainformationen
 
 ### Disclaimer
@@ -29,21 +33,21 @@ finden:
 
 ### Limitierungen
 Instanzen skalieren nicht unendlich: zwar kann die Infrastruktur an sich
-inzwischen auch Räume mit deutlich mehr gleichzeitigen Nutzer:innen verkraften,
+inzwischen auch Räume mit deutlich mehr gleichzeitigen Nutzer\*innen verkraften,
 da aber Workadventure weiterhin versuchen wird, alle Avatare gleichzeitig
-anzuzeigen überlastet ihr damit einfach nur Browser und Internetleitungen.
-Unsere Erfahrung zeigt, dass das Limit irgendwo bei 200 Nutzer:innen liegt.
+anzuzeigen, überlastet ihr damit einfach nur Browser und Internetleitungen.
+Unsere Erfahrung zeigt, dass das Limit irgendwo bei 200 Nutzer\*innen liegt.
 Bitte denkt beim Karten erstellen daran.
 
 Die Map-Größe kann davon unabhängig relativ flexibel dimensioniert werden.
 Karten im Bereich von 50x50 Tiles laufen ziemlich gut, Karten im Bereich von
 500x500 gehen mit einer relevanten Ladezeit einher. Wir raten generell dazu,
-nicht unnötig riesige Karten zu bauen, damit Besucher:innen darin nicht "verloren
+nicht unnötig riesige Karten zu bauen, damit Besucher\*innen darin nicht "verloren
 gehen" und auch Chancen haben, einander zu finden.
 
 Benutzt bitte keine Tilesets, deren Textur größer ist als 4096 auf 4096 Pixel;
 sonst kann es je nach Endgerät zu Darstellungsfehlern kommen, falls derart große
-Texturen [nicht von WebGL unterstütz werden.](https://developer.mozilla.org/en-US/docs/Web/API/WebGL_API/WebGL_best_practices#understand_system_limits)
+Texturen [nicht von WebGL unterstützt werden.](https://developer.mozilla.org/en-US/docs/Web/API/WebGL_API/WebGL_best_practices#understand_system_limits)
 
 Ausgehenden Links wird (wie letztes Jahr auch) wieder ein Dereferrer ("du verlässt
 jetzt das Gelände") vorgeschaltet.
@@ -51,20 +55,22 @@ jetzt das Gelände") vorgeschaltet.
 
 ### Scripte
 Die "[scripting API extra](https://workadventu.re/map-building-extra/about.md)"
-könnt ihr nach Belieben benutzen, wir werden alle dort enthaltenen Features
-unterstützen. Selbst geschriebene Scripte sind aufgrund des dadurch für uns
-enstehenden Review-Aufwands nur auf Anfrage möglich.
+könnt ihr nach Belieben benutzen, wir werden die dort enthaltenen Features
+unterstützen, allerdings mit der Einschränkung, dass keine Variablen in Links
+vorkommen dürfen (z.B. in der `openWebsite` Property). Selbst geschriebene
+Scripte sind aufgrund des dadurch für uns entstehenden Review-Aufwands nur auf
+Anfrage an world@rc3.world möglich.
 
 ### Starter-Kit
-Es wird auch dieses Jahr wieder ein Starter Kit geben, dass ihr einfach 
-herunterladen, als Vorlage benutzen, oder forken und in eure eigene Map
+Es wird auch dieses Jahr wieder ein Starter Kit geben, das ihr einfach
+herunterladen, als Vorlage benutzen oder forken und in eure eigene Map
 umbauen dürft. Dies ist – ebenso wie Tileset-Vorlagen — aktuell noch in
-Arbeit und wird hier verlinkt sobald es fertig gestellt ist, gedultet 
+Arbeit und wird hier verlinkt, sobald es fertig gestellt ist, gedultet
 euch also noch ein wenig.
 
 
 ### Best Practices
-Um den Besuch der Welt möglichst angenehm zu gestalten haben hat sich über 
+Um den Besuch der Welt möglichst angenehm zu gestalten, hat sich über
 vergangene Veranstaltungen
 [eine Liste an Best Practices für die Kartengestaltung](map-best-practices.md)
 ergeben. Bitte lest sie euch aufmerksam durch und behaltet sie beim Gestalten
@@ -80,20 +86,33 @@ oder schlägt Verbesserungen vor.
 Um Karten in der Welt einbringen zu können, müsst ihr ein
 [Assembly anmelden](https://maschinenraum.rc3.world/).
 
-Eure Karten legt ihr dann bitte in einem Git-Repo eurer Wahl ab und tragt im
-Maschinenraum dessen URL ein. Unser Backend wird eure Karte dann regelmäßig von
-dort herunterladen, mit einem rudimentären Linter auf einige Anforderungen und
-generelle Sinnhaftigkeit prüfen, und daraufhin an rc3.world ausspielen.
+Eure Karten legt ihr dann bitte in einem Git-Repo eurer Wahl ab. Fügt dann im
+Maschinenraum einen neuen Raum zu und klickt im Feld "2D-Karte aktivieren" auf
+"Anlegen". Im nächsten Fenster könnt ihr die URL des (öffentlich clonebaren) Git-Repos eintragen.
+
+Unser Backend wird eure Karte dann regelmäßig von dort herunterladen, mit einem
+rudimentären Linter auf einige Anforderungen und generelle Sinnhaftigkeit prüfen,
+und daraufhin an rc3.world ausspielen.
 
 Bitte beachtet, dass eure Karte auch abgelehnt werden kann, falls sie Fehler
 enthält (z.B. Ausgänge auf Karten zeigen, die gar nicht existieren) oder sie
 einfach im falschen Format ist. In diesem Fall wird euch das im Maschinenraum
 angezeigt und entsprechend begründet — falls sich eure Karte also auch nach
-mehrmaligem neuladen nicht verändert hat, schaut bitte einmal dort nach.
+mehrmaligem Neuladen nicht verändert hat, schaut bitte einmal dort nach.
+
+#### Automatische Benachrichtigung
+Ihr könnt euch auch automatisch benachrichtigen lassen, wenn es ein neues Linter-Ergebnis gibt.
+Dazu legt ihr im Hauptverzeichnis eures Repos eine Datei namens `.mapservice` an. In dieser
+tragt ihr dann ein, in welchen Channel des CCCV-Rocketchats der Bot schreiben soll:
+`{"rocket_channel" : "#<CHANNEL>"}`. Der Channel kann dabei auch eine Person sein, dann
+tragt ihr `{"rocket_channel" : "@nick"}` in die Datei ein.
+
+Wichtig: Der Account `Rocket.Cat` muss auf euren Channel zugreifen können.
+
 
 ### Links zwischen einzelnen Karten
 
-Innerhalb eures Repositories könnt ihr ganz normale, relative Links benutzen —
+Innerhalb eures Repositories könnt ihr ganz normale relative Links benutzen —
 um von einer Karte `main.json` auf eine zweite Karte `garten/geheimbasis.json`
 zu verlinken, tragt also einfach den enstprechenden Pfad ein (andersrum genauso:
 von `garten/geheimbasis.json` zurück nach `main.json` geht es per `../main.json`).
@@ -107,8 +126,7 @@ da diese auf rc3.world dann außerhalb eures Assemblies liegen würden.
 
 **Achtung:** Funktioniert anders als letztes Jahr!
 
-Um von zu anderen Assemblies oder allgemein anderen Orten (z.B. zur Lobby oder
-Lounge) zu linken gibt es ein spezielles Link-Schema:
+Um zu anderen Assemblies oder allgemein anderen Orten (z.B. zur Lobby) zu linken gibt es ein spezielles Link-Schema:
 
 `world://<assembly>/<map>.json`
 
@@ -117,7 +135,7 @@ so wie ihr ihn im Maschinenraum für euer eigenes Assembly festlegen könnt. Der
 Pfad danach bezieht sich dann auf den Ort der Map innerhalb des Git-Repositories
 dieses Assemblies.
 
-Um zurück in die Lounge zu kommen, benutzt als slug einfach `lounge`.
+Um zurück in die Lobby zu kommen, benutzt als slug einfach `lobby`. Der genaue Link, den ihr auf eurerKarte eintragen müsst, steht im Maschinenraum.
 
 Da die Gültigkeit dieser Links nicht von eurem eigenen Repository, sondern auch vom
 Rest der Veranstaltung abhängt (und sich auch mit der Zeit ändern kann), können
@@ -131,9 +149,9 @@ gelangt.
 
 Eure Assembly-Karte sollte natürlich auch einen Ausgang zurück zur Lobby
 enthalten. Als einheitlichen, wiedererkennbaren Ausgang zur Lobby-Karte empfehlen
-wir euch dafür dieses Tile zu verwenden:
+wir euch, dafür dieses Tile zu verwenden:
 
-![](./img/worldExit.png)
+![](https://tiles.rc3.world/rc3-2021/worldExit.png)
 
 
 
@@ -142,24 +160,30 @@ wir euch dafür dieses Tile zu verwenden:
 
 ## Tiles
 Grundlegend bestehen die Karten aus sogenannten Tiles oder Sprites (auch wenn es
-Unterschiede zwischen den Begriffen gibt werden sie hier im Folgenden synonym 
+Unterschiede zwischen den Begriffen gibt, werden sie hier im Folgenden synonym
 verwendet). Bitte benutzt ausschließlich Tiles der Größe 32x32 Pixel.
 
 Tiles können Transparenz beinhalten und liegen im png-Format vor.
 
 ### Tiles finden
+
+* Wir stellen euch im [Shared Tiles Repo](https://tiles.rc3.world/) viele extra
+für das Event erstellte Tiles zur Verfügung; diese Sammlung ist auch als Git
+Repository unter `https://git.cccv.de/rc3/world-tiles.git` verfügbar. Bitte beachtet
+aber, dass Git Submodules nicht unterstützt werden — fügt also die Dateien, die ihr 
+verwendet, zu eurem eigenen Repo hinzu.
 * Tiles gibt es massig im Internet, häufig zu Tilesets (mehrere Tiles zu einem
   Thema) zusammengefasst.
 * Seiten auf denen ihr schöne Tiles finden könnt sind zum Beispiel:
     * [itch.io](https://itch.io/)
     * [opengameart.org](https://opengameart.org/)
     * [deviantart.com](https://www.deviantart.com/)
-* Achtet auf die Größe der Tiles!
-* Achtet auf die Lizenz der Tilesets
-    * wir werden nicht aktiv prüfen, unter welcher Lizenz eure Tiles stehen, 
+    * [kenney.nl](https://kenney.nl/assets?q=2d)
+* Achtet auf die Größe der Tiles (32x32)!
+* Achtet auf die Lizenz der Tilesets.
+    * Wir werden nicht aktiv prüfen, unter welcher Lizenz eure Tiles stehen,
       allerdings nach dem Prinzip "takedown on notice" auf Verstöße reagieren.
-    * tragt die Lizenz eurer Tilesets in die custom property `tilesetCopyright` ein
-* [Shared Tiles Repo](https://tiles.rc3.world/)
+    * Tragt die Lizenz eurer Tilesets in die custom property `tilesetCopyright` ein.
 
 
 
@@ -176,7 +200,7 @@ auch "pixeln" genannt wird. Hierzu empfiehlt sich der Editor
   baut Übergänge von einem Material zu Transparenz, das ist vielseitiger nutzbar
   und erspart euch, zu jedem anderen Material einen Übergang gestalten zu müssen.
 * Auf media.ccc.de könnt ihr euch den [Pixel-Art Workshop von blinry](https://media.ccc.de/v/34C3-jugend-hackt-1016-pixel_art_workshop)
-  ansehen
+  ansehen.
 
 
 ## Maps
@@ -188,10 +212,10 @@ transparent gestaltet werden.
 ### Neue Karte in Tiled anlegen
 Achtet beim Erstellen einer neuen Karte auf folgende Einstellungen:
 
-* die Karte muss orthogonal sein, und Tilesize muss 32x32 Pixel sein
+* Die Karte muss orthogonal sein, und Tilesize muss 32x32 Pixel sein.
 * Während des Erstellens kann es sinnvoll sein, eine unendliche Karte zu
   verwenden, anstatt sich vorab auf eine Größe festzulegen. Dies muss beim
-  finalen Speichern der Karte wieder aber wieder auf eine feste Größe geändert
+  finalen Speichern der Karte aber wieder auf eine feste Größe geändert
   werden!
 
 ### Karte gestalten - Layer
@@ -199,9 +223,10 @@ Eine Karte kann aus beliebig vielen übereinander gelegten Tile Layern bestehen.
 Eure Karte braucht dabei mindestens einen mit dem Namen `start`. Standardmäßig
 werden neue Besucher\*innen dann zufällig auf einer der Tiles dieses Layers
 starten (am besten schiebt ihr diesen Layer im Stapel ganz nach unten, damit
-diese Tiles einfach von den anderen überdeckt werden). Außerdem braucht ihr ein
-Layer namens `floorLayer`, dessen Typ `objectgroup` sein muss und der definiert,
-auf welchem Layer sich die Avatare bewegen bzw. was vor- oder hinter ihnen
+diese Tiles einfach von den anderen überdeckt werden). Dieser Layer benötigt wie alle Startlayer das Custom Property `startLayer` (Typ Boolean), welches ihr auf
+`true` setzt. Außerdem braucht ihr ein
+Layer namens `floorLayer`, dessen Typ `Object Layer`(Objektebene) sein muss und der definiert,
+auf welchem Layer sich die Avatare bewegen bzw. was vor oder hinter ihnen
 angezeigt werden soll.
 
 ![](img/layer.png)
@@ -213,7 +238,7 @@ Für ein leichteres Gestalten hebt euch den aktuellen Layer hervor:
 ### Wände / Kollisionen
 Um Tiles als undurchgängig zu markieren, müsst ihr diese im Tileeditor öffnen
 und die custom property `collides` (Boolean `true`) für das jeweilige Tile
-(nicht dem enthaltendem Layer!) setzen. Vergesst nicht, euer Tileset anschließend
+(nicht das enthaltende Layer!) setzen. Vergesst nicht, euer Tileset anschließend
 zu speichern! Tiled bietet zwar auch die Möglichkeit "collision shapes" für
 einzelne Tiles festzulegen, diese werden von workadventure allerdings nicht
 unterstützt und einfach ignoriert.
@@ -231,6 +256,14 @@ werden bzw. in eurem Repository vorhanden sein.)
 Achtet bitte auf die Lizenzen der verwendeten Tiles und tragt deren Copyright in
 die custom property `tilesetCopyright` ein.
 
+Um ein Tileset in eure Map einzubinden, klickt ihr unten rechts auf "Neues Tileset".
+
+![](img/new_tileset.png)
+
+Hier übernehmt ihr alle Standardeinstellungen und wählt unter "Quelle" einfach das PNG
+eures Tilesets aus. Danach klickt ihr auf "OK" und damit ist das Tileset in die Karte
+eingebettet.
+
 ### Zusatzfunktionen für Layer
 
 #### Weitere Eingänge
@@ -247,7 +280,7 @@ Layer, auf den ihr springen wollt, `bar`, dann wäre die Adresse dafür `foo.jso
 
 #### Ausgänge
 Exits zu anderen Maps funktionieren ähnlich: legt einen neuen Layer an, packt
-an die Stellen, an denen ihr Ausgänge haben wollt, beliebige Tiles, und gebt
+an die Stellen, an denen ihr Ausgänge haben wollt, beliebige Tiles und gebt
 dem Layer die Custom Property `exitUrl` (vom Typ String). Diese setzt ihr
 auf die Url der Karte, zu der dieser Ausgang führen soll, also z.B. `foo.json#bar`,
 um in der Karte `foo.json` auf einen Startpunkt `bar` zu springen (falls ihr
@@ -269,7 +302,7 @@ entsprechenden Stellen und gebt dem Layer die custom property `openWebsite`
 Allgemein wird empfohlen, zusätzlich noch die Property `openWebsiteTrigger` auf
 `onaction` zu setzen, damit die Website erst nach explizitem Wunsch (einem
 Druck auf die Leertaste) aufgeht. Das macht den Besuch der World für langsamere
-Endgeräte.
+Endgeräte angenehmer.
 Außerdem könnt ihr mit der Property `openWebsiteTriggerMessage` noch
 eine kurze eigene Nachricht einstellen, die Besucher\*innen angezeigt wird, wenn
 sie auf den Bereich der Website laufen (dies überschreibt die Standardnachricht
@@ -278,13 +311,26 @@ sie auf den Bereich der Website laufen (dies überschreibt die Standardnachricht
 ![](img/cp_openwebsite.png)
 
 Beachtet außerdem, dass Webseiten außerhalb der rC3 auf der rc3.world automatisch
-einen dereferrer vorgehängt bekommen, der Besucher\*innen darauf hinweißt, dass
+ein Dereferrer vorgehängt wird, der Besucher\*innen darauf hinweist, dass
 sie jetzt "das Gelände verlassen".
 
+
+#### Webseite "als Karte" einbinden
+Webseiten können auch inline in Karten eingebunden werden, dadurch werden sie dann
+auf der Map dargestellt.
+
+Dazu legt ihr einen Layer vom Typ `Object Layer`(Objektebene) an und weist diesem
+das Custom Property `url` (Typ String) zu. Dessen Wert ist dann die URL der Webseite,
+die eingebunden werden soll. Auf diesem Layer erstellt ihr dann einen rechteckigen
+Bereich, in welchem dann die Webseite angezeigt wird.
+
+Weitere Informationen findet ihr im offiziellen [HowTo von WorkAdventure](https://workadventu.re/map-building/website-in-map.md).
+
+
 ### Jitsi einbinden
-Auf die selbe Art könnt ihr auch Jitsi Räume in eure Karte einbinden. Setzt dazu
+Auf dieselbe Art könnt ihr auch Jitsi-Räume in eure Karte einbinden. Setzt dazu
 einfach die custom property `jitsiRoom` (Type String) und gebt ihr als Wert den
-Namen den euer Jitsi Raum haben soll.
+Namen, den euer Jitsi-Raum haben soll.
 
 ![](img/cp_jitsiroom.png)
 
@@ -302,26 +348,24 @@ eine kurze eigene Nachricht einstellen, die Besucher\*innen angezeigt wird, wenn
 sie auf den Bereich des Jitsis laufen (dies überschreibt die Standardnachricht
 "Press SPACE or touch here to enter Jitsi Meet room").
 
+
 ### Big Blue Button einbinden
 Dies funktioniert im wesentlichen genauso wie für Jitsi: setzt `bbbRoom` auf den
 Namen eures Raums, und `bbbTrigger` bzw. `bbbTriggerMessage`, um den Raum nicht
 unverhofft aufploppen zu lassen.
 
 ### Stille Bereiche
-Solltet ihr in gewissen Bereichen keine Audio/Video Kommunikation zwischen den
-Teilnehmern wollen, so könnt ihr hierfür einen eigenen Layer anlegen und diesem
+Solltet ihr in gewissen Bereichen keine Audio/Video-Kommunikation zwischen den
+Teilnehmenden wollen, so könnt ihr hierfür einen eigenen Layer anlegen und diesem
 die custom property `silent` (bool true) geben. Auf allen Tiles dieses Layers
-sind danach keine Gespräche mehr üblich. Besonders sinnvoll ist das z.B. in engen
+sind danach keine Gespräche mehr möglich. Besonders sinnvoll ist das z.B. in engen
 Gängen, in denen man sich nicht ohne weiteres ausweichen kann.
 
 ![](img/cp_silent.png)
 
 ### Badgevergabe
-Ihr könnt Badges an User vergeben. Legt dazu einen Layer vom Typ `objectgroup`
-(wichtig!) an, und platziert dann keine Tiles, sondern Punkte und / oder Rechtecke
-auf diesem Layer. Setzt dann noch die Custom Property `getBadge` (Typ String) auf
-das Token eurer Badge (an dieses kommt ihr im Maschinenraum, wo ihr auch neue
-Badges anlegen könnt). Es funktioniert jedoch nur ein **Map** Redeem Token.
+
+Ihr könnt Badges an User*innen vergeben. Legt dazu einen Layer vom Typ `Object Layer`(Objektebene) (wichtig!) an, und platziert dann keine Tiles, sondern Punkte und / oder Rechtecke auf diesem Layer. Jedem dieser Objekte weist ihr dann das Custom Property `getBadge` (Typ String) zu. Dessen Wert ist das Token eurer Badge (welches ihr im Maschinenraum erstellt, wo ihr auch neue Badges anlegen könnt).Es funktioniert jedoch nur ein **Map** Redeem Token.
 
 Wenn jetzt Besucher\*innen über die entsprechenden Stellen der Map laufen, werden
 sie eure Badge erhalten.
@@ -393,12 +437,12 @@ speichern.
 
 ## Lizenzen
 Achtet bitte bei euren Tilesets auf deren Lizenzen bzw. Copyright. Diese
-müsst (!) ihr via der `tilesetCopyright` Property direkt in eurem Map json für die
+müsst (!) ihr via der `tilesetCopyright` Property direkt in eurem Map-json für die
 jeweiligen Tilesets setzen.
 
 Ebenso müsst (!) ihr für eure gesamte Map Lizenz bzw. Copyright in der custom
 Property `mapCopyright` (Typ String) — gesetzt auf der Map, nicht einem
-einzelnem Layer – angeben.
+einzelnen Layer – angeben.
 
 ## Verzeichnisstruktur
 Achtet beim Ablegen eurer Karten bitte auf die Verzeichnisstruktur, folgende
@@ -427,8 +471,8 @@ Hier ein Beispiel wie ein Verzeichnis mit Karten exemplarisch aussehen könnte:
 
 ## Testen
 Eine Testinstanz, auf der ihr eure Maps direkt testen könnt und die sich (soweit
-möglich und sinnvoll) wie die "echte" Instanz für das Event verhält, ist aktuell
-noch in Arbeit und kommt in Kürze.
+möglich und sinnvoll) wie die "echte" Instanz für das Event verhält, ist unter [wa.tabascoeye.de](https://wa.tabascoeye.de)
+zu finden.
 
 ## Eigene Instanzen
 Wir werden sämtliche Instanzen für die rC3.world betreiben, versucht bitte nicht,

docs/maschinenraum.en.md

 How to Maschinenraum
 ===
 
-This documentation is aimed at assemblies and describes how you can manage your assembly and content in the maschienenraum (engine room).
+This documentation is aimed at assemblies and describes how you can manage your assembly and content in the Maschinenraum (engine room).
 
-The software is designed to also work with future events with physical attendance, as well as mixed events. This is why it also has options to create physical rooms. For RC3 the digital features will be the solely relevant for the most of you.
+The software is designed to also work with future events with physical attendance, as well as mixed events. Therefore it has options to create physical rooms as well. However for the most of you at rC3 only the digital features are relevant.
 
 
 ## Important Infos
 Legal entity for abuse reports is the CCCV GmbH.
-All links that point into the internet, are not whitelisted and will be guarded by a dereferer notice. The notice will highlight that this link is outside our domain and hence the operator of said service is responsible for it.
+All links pointing into the internet, are not whitelisted and will trigger a dereferer notice. The notice will highlight that this link is outside our domain and hence the operator of said service is responsible for it.
 
-You are responsible for your assemblies and any content in them. Any abusive content will be deleted without warning.
+You are responsible for your assemblies and any content within its realm. Any abusive content will be deleted without warning.
 
-Hosting: Should you want to run services, please host them yourself. If this is not possible, use services that are located in the EU. The use of US Providers is not acceptable, should you want to incorporate them into RC3. We reserve the right to remove/ignore these links, since US data protection is not up to our standards.
+Hosting: If you want to run your own services for the rC3, please host them yourself. If you use a service, it has to be based in the EU. Using US-based providers is not acceptable if you want your content to flow into the rC3. We reserve the right to ignore these links or delete them from the engine room immediately. These services are not compatible with our privacy policy.
 
-What ever happens in your assembly is your responsibility. There for please remember to amend you imprint and privacy notice.
+Whatever happens in your assembly: You are responsible for it! Therefore remember to add imprint and privacy statements to your own pages.
 
 
 ## Maschinenraum
-For you to administrate your assembly we've setup the Maschienenraum under [maschinenraum.rc3.world](https://maschinenraum.rc3.world/). This how ever is not the conference front-end and you will not see content of other assemblies.
+The engine room at [maschinenraum.rc3.world](https://maschinenraum.rc3.world/) is for managing your assembly. This is not the conference frontend and you will not see the content of other assemblies!
 
-The account in use for this, may later be used for the conference platform, once a conference ticket has been linked to it. ( To do so we will provide a link through the ticket tool at a later time.) To log in please use your username (not email address) and password from signup.
+The account you use here can (not: must) be used later to access the conference platform, as soon as you have linked a conference ticket to it (a link for this will come from the ticket tool in due time). For login you use username (instead of eMail) and password from the signup.
 
-Upon creation, your assembly will pick an abbreviated name (used in URLs), as well as a spoken name. Once thats done we continue in a bigger menu:
+When you create your assembly, it will get a short name (slug), which we use in URLs, and a descriptive name - after that it will go on in a bigger menu:
 
 ### Organisational Data
-This menu point allows you to select the assembly representation:
+Under this menu item you can define how your assembly is represented:
 
-* Basic data: Whats your name? What do you do? Do you habe a logo or website? Also add tags for the search! Here you can upload your frontend page banner. The page will be about 1200px wide, but will be scaled responsive. 16:9 will be a format that might fit match best, but you are free on that. Banner immages shouldn't be larger than 2000x2000px.
-* Links: To which Assembly do you have ties (personnel or topical)? Next to whom do you "sit"?
-* Members: Who's part of your assembly? The role of "offical contact person"(offizieller Ansprechpartner) will be used as such. We'll highlight the person on the website and use them as contact for the orga, for example in abuse cases. The role manager will be displayed as a regular person (should you choose to assign it), but is capable of changing settings of the assembly. And lastly all members may be shown publicly, but don't have to be.
-* Authentication:
-  * This is where you can fetch tokens, with which your assembly can for example give badges to users.
-  * Additionally this is where you can register external applications, that will use [OAuth2](https://oauth.net/2/) -based authentication for conference participants.
+* Basic data: What's your name? What do you do? Do you habe a logo or website? Enter tags for the search! You can also upload a banner for your page in the frontend. The page is about 1200px wide, but will be scaled responsive. A format of 16:9 makes sense, but you are basically free. Banners should not have more than 2000x2000px.
+* Links: To which assemblies is do you have thematic or personal ties? Next to which can you be placed?
+* Members: Who's part of your assembly? The role of "offical contact person"(offizieller Ansprechperson) will be used as such. We'll highlight the person on the website and use them as contact for the orga, for example in abuse cases. The role manager will be displayed as a regular person (should you choose to assign it), but is capable of changing settings of the assembly. Last but not least, all members can be displayed publicly or not.
+
+### Authentication:
+* Here you can request a token that your assembly can use to distribute badges to users, for example.
+* In addition, external applications can be registered here, which can then request [OAuth2](https://oauth.net/2/) -based authentication from users of the conference.
 
 
 ### How are rooms created?
-Rooms are modeled after the real world (see intro). Then can ether be created for the PlainUI, or for the 2D world. The options differ.
+Rooms are based on the physical world (see intro). They can be created for the conference website (internally also called 'Plain UI') as well as for the 2D world, although there are differences.
 
-The 2D-world is not barrier-free, therefore you have the possibility to create barrier-free PlainUI BBB-rooms for self organized sessions, as well as spontaneous "fireside chats".
+Unfortunately, the 2D-world is not barrier-free, therefore you have the possibility to create barrier-free PlainUI BBB-rooms for Self Organised Sessions or "campfires" for spontaneous gatherings, relaxed chatting and socializing in the barrier-reduced conference website.
 
 To create a room, enter name, type of room and capacity.
-If you're planning a lecture hall, workshop room or stage, please remember that conference rooms online don't scale indefinitely. There have been BBB rooms with aprox. 90 participants. This works if people only unmute if necessary and only the speakers turn on their cameras.
+If you're planning a lecture hall, workshop room or stage, please keep in mind that online conference rooms don't scale indefinitely. There have been BBB rooms with about 90 participants. This only works if participants stay muted when silent and as few as possible activate cameras (e.g. only the speakers).
 
 ### Contributing a map to the 2D world
-To add a map to the 2D world, you have to offer a cloneable git repo. If the repo is private, you'll have to add deploy tokens in the URL, e.g. https://bernd:brot@git.kinderkanal.de/bluemchenwiese.git.
+To add a map to the 2D world, you need to specify a Git repo that is clonebar. If the repo is private, you'll have to add deploy tokens in the URL, e.g. https://bernd:brot@git.kinderkanal.de/bluemchenwiese.git.
+
+You can read a "How to create a compatible map" in the [rC3-World HowTo](https://howto.rc3.world/).
 
-Learn how to create a compatible map in the rC3-World HowTo: [howto.rc3.world](https://howto.rc3.world/)
+Your map will be checked automatically by a linter if you have specified the repo.
+* If you get an "error", your map will not go online. You most likely have not fulfilled important requirements. You will find corresponding hints in the engine room.
+* If a warning is displayed, your map will go online. There are hints with potential for improvement.
 
-### What shall projects actually be?
-Everything you would like to share with the world.
 
-Flying mate crates, cocktail robots, waffles of mass destruction? Show us and the world!
+### What should projects actually be?
+Anything you'd like to share with the world.
+
+Flying mate-box, cocktail robots, waffles of mass destruction? Show us and the world!
 
 ### How are projects created?
-We want to see your projects! To see them in the frontend, we'll need from you:
+We want to see your projects! In order for the good stuff to end up in the frontend, we need from you:
 
 * Project name
-* Description: The flavor text for the info page of your project in the frontend. What's shown? Why would no one want to miss it? Where did the idea come from? Who made this?
+* Description: The flavor text for the info page of your projects in the frontend. What will be shown? Why do beings not want to miss it? Where did the idea come from? Who made it?
 * Also: We're still searching people for xyz
 * Links to other contents (through deferrer) possible, like a gallery or source code repos, ...
 
 ### External links
-Of course you add links for example to the wikis for your projects, however a deferrer warning will be added for everything that is outside of rC3-Domains (e.g. YOLO-land).
+Of course you can link e.g. wikis of your projects. However, anything outside of the rC3 domains is "YOLO land" and will come with a dereferrer warning.
 
 ### External media and streams
-External streams from YOLO-land have several downsides (GEMA, abuse, security, ...), which is why we're not integrating those in the world and plainUI, but instead link out to your own sites. This means users will be accessing your own infrastructure via a deferrer.
-If you want to add audio and video in the rC3 (for example on your map), you have the option to store a small amount of data (aprox. 200MB) in the "hangar" (see below). This can then be integrated in your 2D world and onto your project sites.
-
-### How are events with schedule entry created?
-You can offer lectures and sessions as part of your assembly that will show up in the schedule (a little bit apart from the official program), somewhere between an official lecture and a self-organised session.
-A location is not compulsory (yet useful so people know where to go)
-
-### What is the "hangar" in the back office/Maschinenraum?
-You're reserving a "hangar" space, which is then assigned to you. You can imagine it like a virtual storage room for assemblies to embed static content like short videos and loops, audio, etc. in the world.
-This is NOT meant as a file share, don't use it for hosting any kind of online-presence (you wouldn't put a whole armada of planes in a tiny hangar).
-When you're uploading data to the "hangar" please make sure you have the rights to the uploaded data. Violations will lead to the exclusion of the assembly from the whole event.
-
-You can create the hangar as a room in the [Maschinenraum](https://maschinenraum.rc3.world). To do this, click on the "+" next to the menu item "Rooms". In the overview that opens is an option at the top right to set up the hangar. There is only one hangar per assembly. Further setup is not required. Creating the hangar can take up to 15 minutes.
-
-After the hangar has been created, you will find an ftps link of the following form in the "Hangar Access" field in the created room:<br>
-`ftps://<username>:<password>@<server>/`
-
-`<username>` is the slug of your assembly (see also under "Organisational Data" / "Basic Data")<br>
-`<password>` is your automatically generated FTP password.<br>
-`<server>` is the FTP server on which the upload takes place.<br>
+External streams from YOLO-land have several downsides (GEMA, abuse, security, ...), which is why we don't embed them in the world or in the conference website, but link out to your own pages. That means, users will get to your own infrastructure via a dereferrer.
 
-For example, such a link for an assembly with the slug "ccc" might look like this:<br>
-`ftps://ccc:12345+ab1c@upload.hangar.rc3.world/`
-
-You can upload your files with an FTPS-capable programme (e.g. [FileZilla (external link)](https://filezilla-project.org/download.php?show_all=1)).
-
-After the upload, the file can be included in the rc3.world with the link `https://hangar.rc3.world/<username>/<filename>`. 
-
-`<filename>` is the name of the uploaded file. This may contain spaces, but these must be treated accordingly in the link.
+### How to create events with a timetable entry?
+You can create lectures and sessions as part of your assembly, which will then also appear in the timetable in the frontend (somewhat separated from the official program) - as something in between an official lecture and an independent self-organized session.
+A room reference is not necessary (but somehow useful, because otherwise nobody knows where to go).
+To create a session, click on the plus and enter the relevant information. If you select one of your BBB rooms for such a session, all assembly members with moderation rights will join.
 
 ### What are badges and how to create them?
 Badges should strengthen the event's explorative character: Assemblies can distribute these stickers/awards for "been there", "discovered something" or maybe also "P=NP proven"...
@@ -108,28 +91,29 @@ Badges need:
 * A picture: we recommend PNG, 512x512px
 * Select: sticker or achievement mode
 
-Badges are distributed to users via token. A matching token can be generated when generating the badge.
+Badges are distributed to users via token. A suitable token can be generated when generating the badge.
 
-* Stickermode: click to enable the stickermode. Imagine it similar to the sticker boxes that assemblies at C3 would put up.
+* Stickermode: Click on it, I want to have it, done. Think of it like the sticker boxes you had with your physical assemblies.
 
 * Achievement
     * Mode 1 (anonymous/ user not known): The assemblies gets a redeem token for the user, then they get the token and the profile with the input box opens (similar to found easter eggs). Redeem the redeem code in your profile to unlock the achievement and get the badge.
       * Mode 2 (user / SSO known): The assembly hands out the badge to the user. The user has to accept the badge to receive it.
 
 
-Users will find collected badges in their profile. Users will always have to actively accept a badge - who wants to suddenly find a pink dolphine vibrator in their profile?
+Collected badges can be found in the user's profile. You always have to actively confirm the receipt of the badges - not everyone wants to suddenly find a pink dolphin vibrator in the profile...
 
 ##### Assign directly via Maschinenraum
-Within the Maschinenraum Badges can be directly assigned to users.
+Within the Maschinenraum Badges can be assigned directly to users.
 
 ![](img/backoffice_assign_badge.jpg)
 
 ##### Create Redeem Tokens
-When automaticly assigning badges to users, Redeem Tokens (TM) are necessary. There are four types of Redeem Tokens:
-* **One-Time**: The token can be used exaclty once.
-* **Permanent**: The token can be used an unlimited amount of time.
-* **Map**: The token can be only used in rc3 World Maps.
-* **Limited**: The token can be used an n amount of time.
+Redeem Tokens (TM) are required to otherwise award badges. There are four different classes:
+
+* **One-Time**: This token is redeemable exactly once.
+* **Permanent**: This token is redeemable an infinite number of times.
+* **Map**: This token can only be redeemed in rc3.World-maps.
+* **Limited**: This token is redeemable exactly n times.
 
 ![](img/backoffice_redeem_badges.jpg)
 
@@ -138,8 +122,8 @@ These can be created via the Maschinenraum (see image) or via API:
 Just send a REST POST Request to `/api/c/<conference_slug>/assembly/<assembly>/badges/new_redeem_token` with the following body:
 ```
 {
-  issuing_token: <secret_issuing_token>,
-  badge_class: <private|public|map|limited>,
+  issuing_token: "<secret_issuing_token>",
+  badge_class: "<single|permanent|limited|map>",
   amount: <int>
 }
 ```
@@ -149,6 +133,7 @@ _`amount` is only necessary if you create a limited redeem token._
 
 ##### Using Redeem Tokens to get the badge
 Badges can be distributed via the Redeem Tokens.
+
 ###### User adds it via the frontend
 A user can go to his profile (`/<conference_slug>/me`) and redeem a token in "My badges".
 
@@ -171,8 +156,8 @@ Just send a REST POST Request to `/api/c/<conference_slug>/badges/redeem_token`
 }
 ```
 
-##### Using the rc3.world map to assign badges
-In the rc3.world map a tile can be linked to assigning a badge. It works simiar to opening a website, but using the `getBadge` property instead. Usage of **Map** Redeem Tokens is required.
+##### Assigning badges via rc3.world
+In the rc3.world-map a tile can be linked to a badge. When users enter this part, they automatically get the badge assigned. It works similar to opening a website, for this the `getBadge` property is used. You have to use **Map** Redeem Tokens.
 
 ![](img/cp_getBadge.png)
 
@@ -186,7 +171,8 @@ The API always answaers the following when a badge is sucessfully assigned:
 }
 ```
 
-
+### Assembly status
+In the machine room, you will find a box at the top right of your assembly page that displays the status of your assembly. After logging in, it will say logged in or accepted. If it says rejected, you have already received a mail.
 
 ## Any More Questions?
 Please send any questions not covered here to the Assembly Team: [rc3@c3assemblies.de](mailto:rc3@c3assemblies.de)
@@ -197,4 +183,3 @@ There is separate documentation for channels and connected questions: [c3voc.de/
 In case of questions regarding streams please contact:
 recommended: IRC, #voc-lounge im Hackint.eu
 possible: [voc@c3voc.de](mailto:voc@c3voc.de)
- 

docs/play.en.md

@@ -15,6 +15,9 @@ We will reserve the right to ban participants not behaving excellent.
 
 As usual on CCC events, the photo policy also applies to rC3.world. If you take pictures or screenshots from the world be sure to ask everyone in the picture or not include other peoples faces and / or nicks.
 
+## Enter 2D World
+The 2D World is supposed to be entered via the Event frontend at [rc3.world](https://rc3.world/). There's a Link "world" that takes you to the world startpage. By klicking "Enter 2D World" you can enter it.
+
 ## Recommendations
 
 ### Hardware / Devices

docs/play.md

@@ -17,6 +17,9 @@ Wir behalten uns vor Teilnehmer:innen, die sich nicht entsprechend verhalten, zu
 
 Wie auf sonstigen Chaosevents auch gilt auch für die rC3.world die Fotopolicy. Falls Ihr Bilder oder Screenshots macht, bittet alle im Bild um Erlaubnis oder spart Gesichter und Nicks aus.
 
+## 2D Welt betreten
+Die 2D Welt kann über die Event Seite unter [rc3.world](https://rc3.world/) betreten werden. Der Link "Welt" führt euch zur Startseite der 2D Welt. Durch einen Klick auf "Enter 2D World" könnt ihr sie betreten.
+
 ## Empfehlungen
 
 ### Hardware / Geräte

docs/sponsoring.md

-rC3 - Sponsoring
-===
+# rC3 - Sponsoring
 
 This is a list of companies providing (network) hardware and connectivity services. The event would not have been possible without their support (and a few unlisted), and we thank them for it.
 
 ## Infrastructure
+
 |                                          Company                                          |         Sponsoring         |
-|---|---|
+| ----------------------------------------------------------------------------------------- | -------------------------- |
 | <img src="img/logos/DE-CIX.png" alt="DE-CIX" width="100" height="95"/>                    | Peering Port               |
 | <img src="img/logos/dtag.png" alt="Deutsche Telekom AG" width="250" height="65"/>         | IP Uplink                  |
 | <img src="img/logos/flexoptix.jpeg" alt="Flexoptix GmbH" width="285" height="65"/>        | Optical Network Equipment  |
@@ -18,7 +18,7 @@ This is a list of companies providing (network) hardware and connectivity servic
 | <img src="img/logos/WOBCOM.png" alt="WOBCOM GmbH" width="150" height="65"/>               | Server, Housing & Transit  |
 
 ## World
-|Company|Sponsoring|
-|---|---|
-|<img src="img/logos/Hetzner_Logo.png" alt="Hetzner Online GmbH" width="150" height="45"/>|Cloud Nodes for the online map|
 
+|                                                                                              Company                                                                                               |                    Sponsoring                     |
+| -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------- |
+| <a href="https://rc3.world/2021/dereferrer/https://www.hetzner.com" target="_blank"><img src="img/logos/Hetzner_Logo.png" alt="Hetzner Online GmbH" rel="noreferrer" width="150" height="45"/></a> | Cloud Nodes for the event platform and online map |

docs/visit.en.md

+How to rc3
+===
+
+[Version auf Deutsch](visit.md)
+
+To participate in all parts of the rc3, you need a ticket. Take a look at the email with which you got yours — there'll be a link to a site where you can create an account.
+
+Once you have chosen a username and password you'll see the conference website. Here you can adjust your personal settings, create your own talk- and workshop schedule, communicate with other participants and of course enter the 2D world.
+
+
+## upper right
+
+### profile 
+
+Here you can find the link to your personal settings, where you can
+
+* add a description
+
+* enter your pronouns (so that others will know which ones to use for you)
+
+* set the timezone in which times are displayed
+
+* set the website's theme. Apart from the default there is also a distraction-free mode with a simple dark wallpaper. In "distraction-free (without background)" mode the background is completely black.
+
+* additionally you can choose to disable audio and video transmissions in the 2D world. Simply disable the appropriate check boxes.
+
+Note that changed settings will only be applied once you click "save"!
+
+Under "my badges" you can manage the badges you got — you can find badges either on assemblies' sites in the hub or in the 2D world.
+
+Under "my favorites" you'll find events you marked as such (among the self-organised sessions), assemblies and schedule-talks (from the various channels)
+
+### board
+
+Here you read messages left by others, as well as add your own.
+
+### chat
+
+Here you can write other participants personal messages. You'll need to know the signup name the other person used.
+
+### plan
+
+Here you can find all events offered by channels, assemblies, or individual persons. "Channels" are the locations where talks are produced and streamed live via streaming.media.ccc.de. Events offered by assemblies take place in a variety of digital rooms, which are linked in each case. Finally, single persons can also run their own self-organised sessions, too.
+
+In the list, each event has four icons on the right of its time and date:
+
+* share: a new page will open with information to the session, you can send this url to others, too
+
+* add to schedule: by clicking on that you'll add the session to your own personal schedule so you won't get overwhelmed by everything you want to attend (Your personal schedule is visible in your profile).
+
+* add to favourites: giving our hearts is always a good idea. You can view the collection of all your favourits in the settings; they'll also influence the "this events might interest you"-lists
+
+* report this: if the content of an event violates legal requirements or the principles of the CCC you can report it. You'll be shown a page where you can choose why you want to report something, where you see the problem and if you have an idea for a solution
+
+
+### Globe
+
+The globe lets you choose between German and English as the website's language
+
+## center top
+
+### world
+
+This link will take you to the access site for the 2D world. You can find information on how to use it in [howto rc3.world](https://howto.rc3.world/play.html)
+
+### platform
+
+Here you'll find explanations to the schedule, platform & 2D world as well as the community content.
+
+In the community content section a link will take you to a list of all registered assemblies. There's a lot to browse through!
+
+### info
+
+Here you can find contact information to "helpful teams" that you can turn to with a specific requests or concerns:
+
+* the infodesk for general questions
+
+* the heaven for everything to do with angels
+
+* awareness for support with discrimination, stress or conflicts
+
+* c3auti for support of neurodivergents
+
+* inclusion operation center for questions to do with accessability and inclusion
+
+Beneath those are a list with official and inofficial links related to the event.
+

docs/visit.md

+How to rc3
+===
+
+[english version](visit.en.md)
+
+Um an allen Bestandteilen der rC3 teilnehmen zu können, brauchst du ein Ticket. In der Mail, mit der du dein Ticket erhalten hast, steht ein Link, mit dem du zu der Seite kommst, wo du deinen Account anlegen kannst.
+
+Wenn du Username und Passwort ausgewählt hast, landest du auf der Konferenz-Webseite. Hier kannst du deine Einstellungen anpassen, dir dein persönliches Vortrags- und Workshop-Programm erstellen, mit anderen Teilnehmenden kommunizieren und natürlich die 2D-Welt betreten.
+
+
+## rechts oben
+
+### profil
+
+findest du den Link zu deinen persönlichen Einstellungen. Hier kannst du
+
+* eine Beschreibung einfügen
+
+* dein Pronomen eintragen (damit andere wissen, welches Pronomen sie für dich verwenden können)
+
+* die Zeitzone einstellen, in der dir Uhrzeiten angegeben werden
+
+* das Theme wählen, in dem die Webseite für dich dargestellt wird. Du hast außer Standard auch eine ablenkungsfreie Variante zur Auswahl, bei der der Hintergrund deutlich dezenter ist. Bei "ablenkungsfrei (ohne Hintergrund)" ist der Hintergrund komplett schwarz.
+
+* Außerdem hast du die Möglichkeit, in der 2D-Welt die Übertragung von Ton und Video von anderen Teilnehmenden auszuschalten. Dazu klickst du die Füllung in den Kästchen weg.
+
+Die geänderten Einstellungen werden erst wirksam, wenn du speichern klickst!
+
+Unter "meine Badges" verwaltest du deine erworbenen Badges. Diese erhältst du entweder auf Assembly-Seiten oder in der 2D-Welt.
+
+Unter "meine Favoriten" findest du die von dir markierten Events (aus den Self-organized Sessions), Assemblies und Fahrplan-Talks (aus den verschiedenen Streams).
+
+### board
+
+Hier kannst du öffentliche Nachrichten hinterlassen und die von anderen lesen.
+
+### chat
+
+Hier kannst du anderen Teilnehmenden persönliche Nachrichten schreiben. Dazu brauchst du den Namen, mit dem die andere Person sich angemeldet hat.
+
+### plan
+
+Hier findest du alle Veranstaltungen, die von den Channels und den Assemblies bzw. einzelnen Personen angeboten werden. Die Channel sind die Locations, die die Talks produzieren und streamen, die dann auch auf streaming.media.ccc veröffentlicht werden. Die Veranstaltungen der Assemblies finden in unterschiedlichen digitalen Räumen statt, die sind jeweils verlinkt. Auch einzelne Personen können Self-organized Sessions anbieten.
+
+In der Anzeige als Liste hast du für jede Veranstaltung rechts neben Datum und Uhrzeit vier Icons:
+
+* teilen: Es öffnet sich in einem neuen Tab eine Seite mit den Infos zur Veranstaltung, die URL kannst du an andere schicken.
+
+* zu Zeitplan hinzufügen: Damit setzt du die Veranstaltung auf deinen persönlichen Fahrplan, sodass du eine Übersicht hast, was du dir alles anschauen möchtest. Dein persönlicher Fahrplan wird dir in deinem Profil angezeigt.
+
+* zu Favoriten hinzufügen: Herzen verteilen ist immer gut. Deine Favoriten werden dir in deinen Einstellungen gesammelt angezeigt. Und sie beeinflussen die "diese Events könnten dich auch interessieren"-Listen.
+
+* dies melden: Wenn der Inhalt der Veranstaltung gegen rechtliche Vorgaben oder die Grundsätze des CCC verstößt, kannst du sie melden. Du gelangst auf eine Seite, wo du auswählen kannst, wieso du etwas melden möchtest, wo du das Problem siehst und ob du eine Idee für eine Lösung hast.
+
+### Weltkugel
+
+Hier kannst zwischen deutscher und englischer Sprache wählen.
+
+
+## mitte oben
+
+### world
+
+Über diesen Link kommst du auf die Zugangsseite zur 2D-Welt. Alle Infos zur Benutzung findest du in [Howto rc3.world] (https://howto.rc3.world/play.html)
+
+### platform
+
+Hier findest du Erklärungen zu Fahrplan, Plattform & 2D-Welt sowie dem Community Content.
+
+Unter Community Content bringt ein Link dich zu einer Liste aller angemeldeten Assemblies. Hier gibts einiges zu stöbern!
+
+### info
+
+Hier findest du Kontakte zu "helpful teams", also Teams, an die du dich mit bestimmten Anliegen wenden kannst:
+
+* infodesk für allgemeine Fragen
+
+* heaven für alles rund um Engel(n)
+
+* awareness für Unterstützung bei Diskriminierung, Stress oder Konflikten
+
+* c3auti für Unterstützung von Neurodivergenten
+
+* inclusion operation center für Fragen rund um Accessibility und Inklusion
+
+Darunter gibt es eine Liste mit offiziellen und inoffiziellen Links zur Veranstaltung.
+
+

mkdocs.yml

@@ -7,7 +7,7 @@ strict: true
 
 theme:
   name: null
-  custom_dir: 'themes/rc3/'
+  custom_dir: 'themes/rc3-2021/'
   navigation_depth: 3
 
   static_templates:
@@ -26,9 +26,12 @@ theme:
     search: 83   # s
 
 nav:
-#  - Styleguide: 'styleguide.md'
   - Maps: maps.md
-#  - Maschinenraum: 'maschinenraum.md'
+  - Maschinenraum: 'maschinenraum.md'
 #  - Workadventure: 'workadventure.en.md'
   - Play: 'play.md'
+  - Travel Guide: 'visit.md'
+  - Styleguide: 'https://style.rc3.world'
+  - Principles: 'rules.md'
 #  - Sponsoring: 'sponsoring.md'
+  - EOW: 'endoftheworld.md'

themes @ 23b936d3

+Subproject commit 23b936d3b98e4c168c79b8f5ca701d9f65d0d4a1

themes/c3mkdocs/404.html

-{% extends "base.html" %}
-
-{% block content %}
-
-    <div class="row-fluid">
-      <div id="main-content" class="span12">
-        <h1 id="404-page-not-found" style="text-align: center">404</h1>
-        <p style="text-align: center"><strong>Page not found</strong></p>
-      </div>
-    </div>
-
-{% endblock %}