Sounds, Images and Videos (YAML)

Media can be used in narrative text, object descriptions and HUD panels.

Sounds

text: |
  The dragon roars! <<https://example.com/sounds/roar.mp3>>
  You take 10 damage.

Supported formats for linting and exports: .mp3, .ogg, .wav, .flac, .m4a.

<<3:https://example.com/sounds/alarm.mp3>>
<<0:https://example.com/sounds/music.mp3>>
<<stop>>

Images

text: |
  [[https://example.com/images/castle.png]]

Supported formats include .png, .jpg, .jpeg, .gif, .webp and .svg depending on the adapter/browser.

Videos (v4.10)

text: |
  ((https://example.com/videos/intro.mp4))

Recognized formats: .mp4, .webm, .mov, .ogv.

If the content does not look like a valid video, it remains normal text with its parentheses.

Video Options

Options go before the URL, separated with ; then :.

Option	Effect
`loop`	Loop playback.
`autoplay`	Autoplay; the engine also forces `muted`.
`muted`	Muted audio.
`controls` or `controls=true`	Show controls. Default.
`controls=false`	Hide controls; click play/pause still works on web/standalone.
`poster=url`	Poster image before playback. URL variables are accepted.

((loop:https://example.com/videos/ambience.mp4))
((autoplay;muted:https://example.com/videos/intro.mp4))
((poster=https://example.com/poster.jpg;loop:https://example.com/videos/scene.mp4))

Variables in URLs

Use {variable_name} inside sound, image and video URLs.

text: |
  [[https://site.test/images/{zone}.png]]
  <<https://site.test/sounds/{ambience}.mp3>>
  ((poster=https://site.test/posters/{clip}.jpg:https://site.test/videos/{clip}.mp4))