Merge Lua modding SDK, packaged mods and vehicle support

README.md

@@ -8,6 +8,14 @@ A Rust and Bevy skating project built from Skate 3 reverse-engineering research.
 Includes skating, tricks, grinds, offboard movement, difficulty settings and
 `.skate` map support. Gameplay parity is still a work in progress.
 
+## Mods and agent authoring
+
+Drop mod ZIPs into top-level `mods/` and use `PLAY-MARIO-KART.bat` for the integrated
+mod build in this checkout. **Point your coding agent at [sdk/AGENTS.md](sdk/AGENTS.md)**
+to make a mod. See [package structure](docs/mod-packages.md), [Lua API](docs/lua-modding.md),
+[vehicle API](docs/vehicle-sdk.md), [multiplayer mod SDK](docs/multiplayer-mods.md) and [Mixamo workflow](docs/mixamo-vehicle-workflow.md).
+Editable examples live in `sdk/examples/`; `tools/package_mod.py` validates and packages them.
+
 ## Play
 
 Extract the Windows release ZIP and run `skate3rust.exe`. Select your Skate 3