Skip to content

Repository files navigation

Moonshell

Moonshell

The open-source, horde-scale incremental tower defense where modding is editing data files.

An AI defends its lunar defensive base from an overwhelming orc swarm. Races, weapons, maps, upgrade trees — the whole game is data: YAML you can open in any editor, Lua you can write in any editor. No SDK. No compilation. No loader hacks.

  • Modding = data: drop a folder in mods/, watch it hot-reload live. Or drive the same content tree from the in-game console (~) with tab completion and save().
  • Stack: Rust + Bevy 0.19 · lossless round-trip YAML (yaml-edit) · sandboxed Lua 5.4 (mlua)
  • License: GPL-3.0 · free on GitHub/itch, paid Steam + Play later (Mindustry model)
  • Goal: out-perform the original — 100k entities @ 60fps (spike pending)

The docs exist before the engine (deliberately)

The modding contract is the product. The draft schemas are published now so the community shapes them before a line of game code is written:

DocCovers
racesEnemy races: stats, behaviors, wave composition
weaponsTowers: firing behavior, projectiles, caps, upgrades
mapsLunar sectors: routes, rounds, orc budgets
upgradesThe tree: unlocks (orbs), upgrades (cubes), stats
scriptingLua dialect, API surface, permission manifest

Try the sample mod — a working skeleton: a new race + 3 towers with upgrade trees. Pure data, zero engine code.

Status & roadmap

Pre-P0. Mod-format docs published; engine next. P0 = repo + 100k perf spike → P1 = core loop prototype → P2 = modding platform → P3 = v1 gate (demo mods, settings, saves) → v1 free beta on itch, paid Steam/Play launch.

Signal interest

This repo is an active interest check. If Moonshell sounds like your thing:

  • Star the repo — the single best signal
  • 👍 React to the pinned issue — tell us what you'd want (player? modder? learner?)
  • 🐛 Open an issue — the schemas are drafts; the docs are data too
  • 📖 Read SPEC.md — the full locked design (market research included)

Links

About

Open-source horde-scale tower defense where modding = editing YAML files. Rust + Bevy, GPL-3.0. Docs published before the engine — shape the contract.

Topics

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors