Version 0.3.1

- server/run_server.sh: checks Godot is 4.7+, imports a fresh copy once
  (the class cache in .godot/ isn't in git), then starts the server
- The dedicated server refuses to start, with a clear reason, on Godot
  older than 4.7 or when the game's scripts failed to load, instead of
  claiming to listen
- tests/run_all.sh imports a fresh copy first
- Setup doc: 4.7+ (not 4.3+), importing a fresh copy, running a server

.gitignore

@@ -3,7 +3,7 @@
 .import/
 *.import
 export.cfg
-export_presets.cfg
+# (export_presets.cfg is kept: signing passwords live in .godot/export_credentials.cfg)
 
 # Exported builds
 /build/
@@ -18,3 +18,9 @@ Thumbs.db
 
 # Editor
 *.tmp
+
+# Cloudflare wrangler cache (tools/site deploys)
+.wrangler/
+
+# Kokoro TTS environment (tools/voice/make_voice.sh sets it up)
+tools/voice/.venv/

README.md

@@ -16,7 +16,18 @@ addon SDK with guard rails.
 ## Status
 See `docs/ROADMAP.md` for milestones and `docs/ARCHITECTURE.md` for the design.
 
-Current milestone: **M0 — playable single-player world skeleton** (scaffolding on disk; needs Godot 4 installed to open & run).
+**Emberwild 0.3.0** is released (download page and player guide:
+https://emberwild-95k.pages.dev, builds on the Gitea releases). Built so far:
+- M0-M1: the island, survival, crafting, building, weather, wildlife, hunting, fishing.
+- M2: self-hosted multiplayer (Host Game, dedicated servers, rules, chat, admin).
+- P1-P5 (`docs/PROGRESSION_DESIGN.md`): iron, stone building, the wolf moon and
+  alpha, the bear, crows and foxes, the barrow, hazards, the Old Stag. P6: a use
+  for every material, lights to place, dropping items, bag rows on the hotbar.
+- T1, T2, T4 (`docs/TUTORIAL_DESIGN.md`): the tutorial with Old Tam (spoken),
+  and his tips in normal worlds.
+- M4 so far: packaged builds, the update check, music, ambience, sound effects
+  and creature voices (`assets/audio/CREDITS.md`), the trailer and help pages.
+Next: the worldlets and the journey between them (`docs/WORLDLETS_DESIGN.md`).
 
 ## Requirements
 - **Godot 4.3+** (standard build; no C# needed — this project uses GDScript).
@@ -34,6 +45,34 @@ godot --path .
 godot --headless --path . -- --server
 ```
 
+## Packaged builds
+```bash
+tools/export.sh          # build/Emberwild-<version>-macos.zip and -windows.zip
+tools/export.sh macOS    # or just one ("macOS" / "Windows")
+```
+Needs the Godot export templates for your Godot version (Editor > Manage
+Export Templates). The version number is `application/short_version` in
+`export_presets.cfg`.
+- **Mac:** a universal .app, ad-hoc signed but not notarised. On another Mac,
+  the first launch needs right-click > Open (or System Settings > Privacy &
+  Security > Open Anyway).
+- **Windows:** unzip and run `Emberwild.exe` (keep `Emberwild.pck` beside
+  it). It's unsigned, so SmartScreen says "Windows protected your PC":
+  More info > Run anyway.
+- A packaged copy is also a dedicated server:
+  `Emberwild.app/Contents/MacOS/Emberwild --headless -- --server` (Mac) or
+  `Emberwild.exe --headless -- --server` (Windows). Saves and settings live in
+  the same user folder as a copy run from source.
+
+## Trailer and download page
+```bash
+tools/trailer/make_trailer.sh   # build/Emberwild-trailer.mp4: recorded in-game (Movie Maker), needs ffmpeg
+tools/site/make_site.sh         # build/site/: index.html + poster.jpg + trailer.mp4 for the current release
+```
+The page's download links point at the Gitea release named in
+`build/version.json`, so rebuild it after each `tools/export.sh` release.
+Gitea doesn't serve HTML pages: copy `build/site/` to any static web host.
+
 ## Layout
 ```
 project.godot          Godot project definition

assets/audio/CREDITS.md

@@ -0,0 +1,54 @@
+# Audio credits
+
+Everything here is CC0 (public domain): free to use, change and ship, with
+no attribution required. Credit is given anyway.
+
+## Kenney (CC0)
+`sfx/kenney/` holds sounds from three of Kenney's packs, renamed:
+- **RPG Audio**: creaks, doors, cloth, leather, knife, metal clicks
+- **Impact Sounds**: wood, mining, plank, punch and soft impacts; footsteps
+  on grass, snow, wood and concrete
+- **Interface Sounds**: open, close, tick and confirmation chimes
+
+https://kenney.nl/assets/rpg-audio,
+https://kenney.nl/assets/impact-sounds,
+https://kenney.nl/assets/interface-sounds:
+"License: (Creative Commons Zero, CC0)
+http://creativecommons.org/publicdomain/zero/1.0/". Thank you, Kenney.
+
+Which file is which is listed in `KENNEY` in `tools/audio/make_audio.py`,
+which also re-copies them (`--kenney <folder with the unzipped packs>`).
+
+## SamsterBirdies (CC0)
+`ambience/birds.ogg` is from "Bird ambience. Coniferous forest dawn chorus."
+by SamsterBirdies (https://freesound.org/people/SamsterBirdies/sounds/745273/,
+License: Creative Commons 0): its first 90 s (kept in
+`tools/audio/sources/birds_samsterbirdies_745273.ogg`), softened a little and
+made into a seamless loop by `tools/audio/make_audio.py birds`. Thank you.
+
+## OwlStorm (CC0)
+`ambience/crickets.ogg` is "Night Crickets Ambience on Rural Property" by
+OwlStorm (https://freesound.org/people/OwlStorm/sounds/320145/, License:
+Creative Commons 0; the preview is in `tools/audio/sources/`), with the low
+rumble taken out and made into a seamless loop by
+`tools/audio/make_audio.py crickets`. Thank you.
+
+## Breviceps (CC0)
+`ambience/owl_0.ogg` and `owl_1.ogg` are the two hoots in "Owl Hoot" by
+Breviceps (https://freesound.org/people/Breviceps/sounds/465697/, License:
+Creative Commons 0; the preview is in `tools/audio/sources/`), cut at 0.12 s
+and 2.65 s (leaving out the short sound between them), then levelled. Thank you.
+
+## Old Tam's voice
+`voice/` is spoken by **Kokoro** (Kokoro-82M by hexgrad, Apache-2.0,
+https://huggingface.co/hexgrad/Kokoro-82M) with its British "George" voice,
+made a little older (deeper, slower, warmer) by `tools/voice/make_voice.py`.
+The recordings are generated from our own text; rebuild them with
+`tools/voice/make_voice.sh` after changing any line.
+
+## Emberwild's own (CC0)
+`music/`, `ambience/` and `sfx/synth/` are synthesised from scratch by
+`tools/audio/make_audio.py` (no samples): the five music tracks (calm,
+night, storm, danger, boss), the fire crackle, the creature voices, and the
+swings, eating, splashes, the fishing reel and bite, the bow, the hurt thump
+and death. Released under CC0 like the rest of this folder.