| read_if |
|
|---|
skelly is a hobby monorepo built around deadvox, a voxel survival game that runs in the browser. Its models and creatures come from the pipelines in the shared asset submodule. The point is to have fun.
Play: https://roobie.github.io/skelly/ opens a launcher for the game. The authoring tools and the asset showcase live in skelly-assets, so the launcher links that site rather than hosting them.
- deadvox: the game. You scavenge a large voxel world full of zombies, with detailed items, bodies and crafting. It runs entirely in the browser, with no server.
- mods (
packages/mods): the shared content mods products build their stacks from; seedocs/decisions/0009-content-defined-products.md, "Definitions and distribution". - skelly-assets: the shared models and the pipelines that build them, including the gun, thing and vehicle authoring tools and the creature pipeline, checked out as the
packages/skelly-assetssubmodule. - things: the design decisions of the thing authoring tools, which live in the submodule.
You need Node.js and npm. The projects are npm workspaces of the root package. From the repository root, one command initializes the shared asset submodule and installs the workspaces, the lit-check tool, the pinned Jsonnet compiler and the pinned asset release:
npm run setupStart the game's dev server:
npm run dev --prefix packages/deadvoxRun the repository-wide checks with npm run ci and npm run test:site. Each project's package.json lists its own checks, and CI runs the workflows under .github/workflows/.
Game code, pipeline tools and the asset showcase use EUPL-1.2. The shared models and built assets in skelly-assets use CC-BY-NC-SA-4.0, which restricts commercial use. Keeping the scopes separate shares the tools without relicensing the models; see REUSE.toml and packages/skelly-assets/REUSE.toml.
Each repository's reuse lint must pass, so no file merges without a stated licence and copyright holder. Skelly's lint skips the submodule, which its own repository lints. A third-party asset keeps the author and licence its manifest credits; REUSE.toml is written from those credits, so each is stated once and a credit change cannot leave a stale licence behind. See tools/reuse/annotations.mjs, creditAnnotations.
Contributing? Start with AGENTS.md, PILLARS.md and docs/PROCESS.md.