SPILLWAY — PETAFAB map authoring example

Start here: https://sebastianaaltonen.com/petafab/modding/
Standalone specification: https://sebastianaaltonen.com/assets/modding/petafab-level-format.md

CONTENTS
level.json         Complete editable map source, JSON format version 2.
level.schema.json  Editor completion and field reference.
preview.jpg        Workshop thumbnail, ready to publish.
source/spillway.png Original gameplay capture used for the thumbnail.
source/README.txt  This guide.
source/petafab-level-format.md Standalone level specification, schema and example.

Spillway builds its geometry from JSON brushes and uses PETAFAB's built-in
materials, sky and enemies. There are no separate mesh or texture source files
to install or compile. PETAFAB supplies the built-in assets when the map loads.

PLAY AND EDIT
1. Extract this ZIP into a new folder, such as MySpillway.
2. In PETAFAB on Steam for Windows or macOS, open Workshop > My Levels >
   Play Folder and select the folder containing level.json.
3. Edit level.json in a text editor. Keep its filename and JSON field names.
4. Press F5 while playing to reread the folder or ZIP and restart with your
   edits, including changed textures and skies. On Mac, use Fn+F5 if needed.
   For ZIPs, replace the selected archive first. If loading fails, the current
   map stays active: fix the file and press F5 again. Ordinary restart uses
   the already-loaded map. F5 does not publish changes to Steam Workshop.
5. Press F8 during local play to tune lighting, fog, bloom and sun settings.
   Save JSON writes changes back to this folder. Wait for SAVED LOCALLY.
   After external edits, press F5 before saving from F8. Reloading discards
   tuning changes you have not saved.

FIRST CHANGES
- Change the first wave's two count values from 3 to 5 for ten constructors.
- Change one group's enemy from constructor to constructor2 for blue Factory
  bots alongside the yellow Yard bots. Their gameplay behavior is the same.
- Change fluidDamagePerSecond from 40 to 0 for harmless liquid.
- Change the wall material's builtin from steel to factory:steel.
- To explore without combat, set waves to [] (the example has no boss).

COORDINATES
Positions are [x,y,z] in metres; Y points up. Terrain spans X/Z -32 to 32 and
Y 0 to 32. Spillway's explicit floor brush has its top at Y=4. The player's position
is the lower capsule center, so Y=4.55 places it on that slab.
Brushes run in order: add terrain first, then subtract openings.
Timing uses 120 ticks per second. Zero yaw faces +Z; +90 degrees faces +X.

PUBLISH
New Level also has a Modding Guide button. It opens the instructions in the
Steam overlay, or your default browser when the overlay is unavailable.
Keep level.json and preview.jpg at the folder root. Replace the thumbnail
with your own JPEG smaller than 1 MiB when sharing your edited map.
Open Workshop > My Levels > New Level, select this folder, enter your title
and description, read and accept the Steam terms, then Upload New Item.
Keep Skip source/ folder checked for the playable upload. Uncheck it if you
want to share the editable source notes and original thumbnail capture too.
New items start Private. Finish any agreement acceptance on the Steam page,
test the published copy, and change its visibility to Public when ready.
Use Community > Update on the existing item for later revisions.

For a manual ZIP, put level.json and preview.jpg at the ZIP root, not inside
an enclosing folder. Keep any custom DDS assets at their referenced paths.
Play Local ZIP lets you test that archive before publishing.
