Merge branch 'master' into style-2021

docs/maps.en.md

@@ -124,7 +124,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,8 +139,12 @@ 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/). The repository can also be embedded
+as a submodule into your maps repository via `https://git.cccv.de/rc3/world-tiles.git`.
 * 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/)
@@ -151,7 +155,6 @@ Tiles can also be transparent, and are saved in the PNG format.
       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
@@ -249,20 +252,28 @@ You can embed websites, which will open when upon stepping on predefined tiles.
 Same as for start and exit layers, add a layer, place tiles at the desired
 positions, and then set the property `openWebsite` (type string). Use https!
 
+In general we recommend also setting the property `openWebsiteTrigger` to
+`onaction`, which will cause the web site to open only after explicit user
+interaction (a press on the space bar), which makes visiting the world much
+easier on older laptops.
+You can also set a custom message to be displayed where setting the
+`openWebsiteTriggerMessage` property (which will overwrite the default "Press
+SPACE or touch here to open web site").
+
 ![](img/cp_openwebsite.png)
 
-Also not that websites which are outside of rC3 will be automatically prefixed
+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".
 
-### Embedding jitsi
+### 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.
+`jitsiRoom` (type string) and assign it the name of your Jitsi room as its value.
 
 ![](img/cp_jitsiroom.png)
 
 To avoid unintentional collisions between different assemblies (e.g. so that
-everyone can define their own "hackcenter") names of jitsi rooms are local to
+everyone can define their own "hackcenter") names of Jitsi rooms are local to
 your own assembly. If you want to share a room with a different assembly, just
 prefix its name with `shared-`.
 
@@ -270,12 +281,12 @@ In general we recommend also setting the property `jitsiTrigger` to `onaction`,
 which will cause the room to open only after explicit user interaction (a press
 on the space bar), which makes visiting the world much easier on older laptops
 and prevents people accidentally stumbling into your session. You can also set
-a custom message to be displayed where the jitsi can be opened by setting the
-`jitsiTriggerMessage` property (which will overwrite the default "press SPACE
-to open jitsi meet").
+a custom message to be displayed where the Jitsi can be opened by setting the
+`jitsiTriggerMessage` property (which will overwrite the default "Press SPACE
+or touch here to enter Jitsi Meet room").
 
 ### Embedding Big Blue Button
-This works essentially the same as with jitsi: set `bbbRoom` to your room's name,
+This works essentially the same as with Jitsi: set `bbbRoom` to your room's name,
 and `bbbTrigger` along with `bbbTriggerMessage` to prevent the room from popping
 open unexpectedly.
 
@@ -332,6 +343,9 @@ on their tiles. Only mp3 files included via a path relativ to your map are
 supported. External files can not be included. If you want to include streams,
 please write an email to [world@rc3.world](mailto:world@rc3.world). If you want
 the audio to also loop, additionally set `audioLoop` (type boolean) to `true`.
+To reduce playback volume, you can set `audioVolume` (type float) to a value
+between `0.0` (0%) and `1.0` (100%). Users can also set a maximum volume. In this
+case the lower value will be used.
 
 ![](img/cp_playaudio.png)
 

docs/maps.md

@@ -133,7 +133,7 @@ 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:
 
-![](./img/worldExit.png)
+![](https://tiles.rc3.world/rc3-2021/worldExit.png)
 
 
 
@@ -148,6 +148,10 @@ 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. Ihr könnt das Repository auch
+als Submodule in euer Karten-Repo einbinden: `https://git.cccv.de/rc3/world-tiles.git`.
 * 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:
@@ -159,7 +163,6 @@ Tiles können Transparenz beinhalten und liegen im png-Format vor.
     * 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/)
 
 
 
@@ -266,6 +269,15 @@ Analog zu Start und Exit Layern legt ihr ein Layer dafür an, setzt Tiles an die
 entsprechenden Stellen und gebt dem Layer die custom property `openWebsite`
 (Typ String). Verwendet https!
 
+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.
+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
+"Press SPACE or touch here to open web site").
+
 ![](img/cp_openwebsite.png)
 
 Beachtet außerdem, dass Webseiten außerhalb der rC3 auf der rc3.world automatisch
@@ -280,21 +292,21 @@ Namen den euer Jitsi Raum haben soll.
 ![](img/cp_jitsiroom.png)
 
 Um Kollisionen zwischen verschiedenen Assemblies zu verhindern (damit z.B.
-alle ihr eigenes "Hackcenter" definieren können) sind die Namen der jitsi-Räume
+alle ihr eigenes "Hackcenter" definieren können) sind die Namen der Jitsi-Räume
 standardmäßig lokal für euer Assembly. Falls ihr einen Raum mit einem anderen
 Assembly teilen wollt, hängt bitte vorne an den Namen `shared-` an.
 
 Allgemein wird empfohlen, zusätzlich noch die Property `jitsiTrigger` auf
-`onaction` zu setzen, damit der jitsi-Raum erst nach explizitem Wunsch (einem
+`onaction` zu setzen, damit der Jitsi-Raum erst nach explizitem Wunsch (einem
 Druck auf die Leertaste) aufgeht. Das macht den Besuch der World für langsamere
 Laptops angenehmer und verhindert, dass sich versehentlich wer in eure laufende
 Session verirrt. Außerdem könnt ihr mit der Property `jitsiTriggerMessage` noch
 eine kurze eigene Nachricht einstellen, die Besucher\*innen angezeigt wird, wenn
-sie auf den Bereich des Jitsis laufen (dies Überschreibt die Standardnachricht
-"press SPACE to open jitsi meet"). 
+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
+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.
 
@@ -354,6 +366,10 @@ der Karte eingebunden werden können. Externe mp3-Dateien können nicht eingebun
 werden. Falls ihr Streams eimbinden wollt wendet euch bitte an
 [world@rc3.world](mailto:world@rc3.world). Soll sich der Audioschnipsel wiederholen,
 so setzt zusätzlich `audioLoop` (Typ Boolean) auf `true`.
+Wenn die Audiodatei leiser wiedergegeben werden soll, kann das mit der Property
+`audioVolume` eingestellt werden, die eine Fließkommazahl zwischen `0.0` (0%) und
+`1.0` (100%) annehmen kann. User können auch client-seitig eine Maximallautstärke
+einstellen - es wird dann immer der kleinere Wert verwendet.
 
 ![](img/cp_playaudio.png)