andodeki
435135ed50
Reintroduce apps/arcade and the ten game crates that were ripped out of
the fork (assets, audio, blocks, coedit, gen, net, pkg, render, script,
session), from makepad-internal/dev. Reconcile against the fork's layout:
- makepad-game-sim/math come from the fork's existing libs/sim + sim/math;
the copied internal libs/game/{sim,math} are dropped and the kept game
crates plus arcade point at ../../sim and ../../sim/math.
- arcade AI is rewritten off the removed makepad-ai agent API onto the
makepad-ai-hub headless ChatProvider worker (example/cad pattern):
AiWorker{send,cancel,poll}, ai_worker_loop driving
ClaudeApiChatProvider(ClaudeCli), AiWorkerEvent availability/delta/
done/error mapped into the chat feed and authoring land_edit, with
main.rs send_message/cancel_request/event-drain rebuilt around it.
- the game-script sandbox is adapted to the fork's jailed splash storage:
every isolate gets mod.fs = splash_storage jail; splaes splash_storage
set_root_for_heap is now public so the ScriptHost (or Splash) can grant
a per-game jail root. ENT font: build.rs/dispatch.rs entities fill new
fork sim Entity/Part fields via ..Default::default(); world_raycast now
borrows mutably and returns the material id.
cargo check -p makepad-arcade and the game + arcade test suites pass.
108 lines
5.3 KiB
Markdown
108 lines
5.3 KiB
Markdown
# Makepad Arcade
|
||
|
||
Networked AI game sandbox (plan: repo-root game.md). Run with:
|
||
|
||
cargo run -p makepad-arcade
|
||
|
||
## Stock assets
|
||
|
||
Arcade ships with a searchable library of CC0 models and sounds. The binaries
|
||
are **not** vendored in git — fetch them once:
|
||
|
||
./apps/arcade/download_assets.sh # core packs, ~75 MB
|
||
./apps/arcade/download_assets.sh --packs=all # everything, ~185 MB
|
||
./apps/arcade/download_assets.sh --list # show packs, download nothing
|
||
|
||
The default fetches a **core** set (~1900 models) so a fresh clone isn't forced
|
||
to pull the lot; `--packs=all` gets the full Kenney 3D catalogue (**4669 models
|
||
across 47 packs**), and `--packs=nature-kit,car-kit` picks specific ones. Add
|
||
the 556 sounds and the nine rigged KayKit characters and the full library is
|
||
~5000 searchable assets — of which **36 are rigged and animated**.
|
||
|
||
Everything is gitignored and pinned — starter kits to exact GitHub commits, the
|
||
rest to content-hashed kenney.nl URLs — and every file is sha256-verified, so a
|
||
moved or tampered upstream fails loudly instead of silently changing the
|
||
library. Downloads are sequential with a delay: this is someone else's
|
||
bandwidth.
|
||
|
||
### Mirroring
|
||
|
||
`resources/MIRROR.toml` lists every pack with its canonical URL, sha256, size
|
||
and model count. Because these assets are CC0, anyone may re-host them, and
|
||
that file is what makes a mirror reproducible and verifiable. Point at one with:
|
||
|
||
ARCADE_ASSET_MIRROR=https://your.host/assets ./apps/arcade/download_assets.sh
|
||
./apps/arcade/download_assets.sh --mirror=https://your.host/assets
|
||
|
||
A mirror is expected to serve `<base>/<slug>.zip`. **The sha256 from
|
||
MIRROR.toml is verified identically whichever host served the bytes** — a
|
||
mirror is never trusted more than upstream; the hash is the authority.
|
||
|
||
Everything degrades gracefully without them: the demo runs with primitive
|
||
shapes, and tests that need real assets skip with a hint.
|
||
|
||
**Audio is Ogg Vorbis.** Every Kenney audio pack ships `.ogg` only — no WAV
|
||
variant exists upstream — and this tree has no vorbis decoder. The sounds are
|
||
therefore indexed and searchable by the AI but **not yet playable**; adding a
|
||
decoder (or running `download_assets.sh --transcode`, which converts to WAV
|
||
when ffmpeg is installed) is what closes that gap.
|
||
|
||
### Finding assets
|
||
|
||
The library is queried by *description*, never by filename, via
|
||
`makepad-game-assets`. The agent gets a `find_model` tool and a one-paragraph
|
||
summary — it searches, it never receives the catalogue (5000 entries would not
|
||
fit in a prompt, and the summary stays ~480 characters however large the
|
||
library grows). Ids look like `kenney/racing/vehicle-truck-yellow` and are
|
||
stable across re-downloads, because generated game code writes them.
|
||
|
||
Findability is built in three layers so it scales past 4000 models:
|
||
per-pack theme curation (~55 rows, giving every model its setting), filename
|
||
token parsing (free, and Kenney's names are systematic), and a hand-curated
|
||
query-time synonym table (~240 rows) that applies to the whole catalogue at
|
||
once. Item-level curation is spent only on the few hundred most-requested
|
||
things. At the full 4,999-entry catalogue: index build ~120 ms, a search
|
||
~0.2 ms, ~2.1 MB of heap (release).
|
||
|
||
Query-side stemming means an inflected request still reaches a base-form
|
||
alias ("smashing" → the `smash` alias), and when two entries tie on score the
|
||
kind the query implies wins — an unqualified noun like "spaceship" is an
|
||
object request, while "metal clang" or "win music" wants something audible.
|
||
|
||
## Credits
|
||
|
||
Every asset here is CC0 (public domain). Attribution isn't required by the
|
||
licence — we credit anyway, because these libraries exist because someone chose
|
||
to give them away.
|
||
|
||
- **Kenney** — <https://kenney.nl/assets> — 47 model packs totalling ~4,670
|
||
models (nature, city, castle, space, food, furniture, vehicles, dungeons,
|
||
characters and more), the five starter kits, and all seven sound packs
|
||
(impact, interface, sci-fi, music jingles, UI, RPG and digital audio). Thank
|
||
you for the extraordinary breadth of free, consistent, genuinely usable game
|
||
assets — this library is most of what Arcade can build with.
|
||
- **KayKit / Kay Lousberg** — <https://kaylousberg.itch.io/> — nine rigged and
|
||
animated characters: five adventurers (Knight, Barbarian, Mage, Rogue,
|
||
Rogue_Hooded) and four skeletons (Warrior, Mage, Rogue, Minion). All nine
|
||
share one 41-joint skeleton, so an animation authored for any of them plays
|
||
on every one — the adventurers ship 76 clips and the skeletons those same 76
|
||
plus 19 undead extras. Thank you for giving away rigs and animation sets,
|
||
which are the expensive part.
|
||
|
||
### Rigged characters
|
||
|
||
`find_cast` lists the animated casts. A cast is a set of characters sharing one
|
||
skeleton, so any state works on any member and a part can be recast without
|
||
touching animation code:
|
||
|
||
| rig | members | clips | notable states |
|
||
|-----|---------|-------|----------------|
|
||
| 41 joints (KayKit) | 9 | 76–95 | block, dodge, hurt, dance, sleep, carry |
|
||
| 7 joints (Kenney mini) | 22 | 25–32 | walk, run, jump, attack, sit, wave |
|
||
| 6 joints (Kenney platformer) | 5 | 25 | walk, run, jump, attack |
|
||
|
||
Pick members from ONE cast for a scene, and use different members so a crowd
|
||
isn't clones — the same rule that applies to props.
|
||
|
||
Machine-readable attribution lives in `resources/CREDITS.toml` so a published
|
||
game package can carry credit with it.
|