The Game
Uiza-do Musha is a lane-based spellcaster survival game. You are a wizard auto-driving down an endless road. Your spells cast themselves; your own move is sliding across the road, which decides what you are shooting at, or whether you are shooting at all.
A wave is a horde of small orcs you drive straight through, then the boss they were running in front of, which halts you until it falls. There is no win condition, no campaign length and no final boss: every wave is harder than the last, forever, and the run ends when the wizard's health does.
This is an early build and the design is still moving: the road has already gone from four lanes to three, and the wizard from standing still to driving. Expect big changes. Treat everything below as a snapshot of where it stands today, not a spec.
“Uiza” is ウィザード, uizādo, “wizard”; the working title is still the repo name.
How It Plays
Three inputs carry the whole game. There is no fire button: casting is continuous, so every decision is where to stand and what to have equipped.
Slide
Move continuously from one edge of the road to the other. You cast straight up the road, so where you stand is what you hit.
A / D · left stick or d-pad · hold that side of the screen
Cycle Spell
Step through the equipped spell. Lanes are positioning only; the spell is chosen with its own key, whichever lane you are in.
E · right shoulder · CYCLE button
Arcane Nova
Spend 45 mana at once for a 60-damage burst. The one cast you time yourself.
Space · gamepad A · NOVA button
When the equipped spell costs more mana than you have, the cast still happens, as Magic Missile. Running dry is a downgrade, never a jam, so the auto-cast rhythm never breaks.
That is why Fire Burst can spend mana far faster than it regenerates: overspending is self-correcting rather than fatal. It is also why Magic Missile must stay free. A test pins its cost at zero.
The Road
One wide combat lane with a narrow lane on each side. The flanks are safe but useless for damage: you cast straight up your own lane, so standing in one kills nothing.
Paired power-ups. Disabled for now.
The horde and the boss, and nowhere else. Every slam lands here.
A standing queue of friendly minions.
- Combat lane
- Two old lanes merged into one twice the width. The horde stands at real positions across it, and the boss hunts your actual x rather than picking one of two slots.
- Power-up lane
- Power-ups came in pairs, one per wave, one in each flank, so taking one refused the other. Spawning is switched off while the left lane gets its own redesign.
- Minion lane
- “Army Rush”: stand in it and you pick up about one minion a second. They pack into rows in front of you, fire weaker bolts of their own, and die to a single touch or a boss slam. The crowd is uncapped, and a bigger crowd reaches further into the horde.
- No card screen
- There is deliberately no between-wave menu handing out upgrades. The reward is something you leave the fight to reach.
Spells
Every spell shares one cooldown mechanism and differs in cost, damage and what happens on hit. The wizard has 100 mana and regenerates 12 a second.
| Spell | Damage | Casts / s | Mana / cast | What it is for |
|---|---|---|---|---|
| Magic Missile | 12 | 3.5 | 0 | The free fallback. Fast, cheap, always available. |
| Frost Lance | 16 | 2.2 | 6 | Slows its target to 45% for 2 s, stretching its attack cadence. The one you hold down. |
| Fire Burst | 26 | 1.6 | 18 | Punches through and splashes the crowd nearby. Empties the pool in seconds. |
| Lightning Bolt | 8 | 2.0 | 9 | Ultra-fast, chains between enemies standing close, up to six bounces a cast. |
| Life Steal | 10 / s | channel | 20 / s | Drains the closest foe in reach and heals for what it drains, after a 2 s wind-up. |
Waves & Bosses
Waves get harder through count, health and speed, not variety. Only speed is capped, so a monster can never outrun the cast rate and turn the run into a coin flip.
- Horde size
- 27 orcs on wave 1, 15 more each wave, capped at 180 from wave 12. They arrive in clusters of 2 to 4 so Lightning Bolt has something to chain into.
- Horde health
- +18% of base per wave, linear and uncapped.
- Horde speed
- +5% per wave, capped at 1.9× from wave 19. Monsters hold their placed spot, so speed now scales their attack cadence rather than a walk.
- Boss
-
Troll · wave 1Ogre · wave 10Giant · wave 20Every wave ends with one. Four orcs tall, 480 health growing 6% per wave compounded, and a 14-damage slam growing 6% of base per wave.
- The slam
- A 1 s glowing, particle-plumed wind-up, then damage to anyone within half an old lane's width of where it stood. Between slams it slides to your x, and the move itself is the tell. Always dodgeable.
- Phases
- At 100, 66 and 33% health the slam interval tightens from 3.4 to 2.8 to 2.2 s, so the fight gets harder as you win it.
Current State
Early, but playable end to end on all four platforms. The right-hand lane is mid-rework, and everything on screen is still procedural meshes and emissive materials.
- Flow
- Splash, main menu, the run, and a three-letter tag entry for a top-ten score. How to Play, Settings and the high-score list sit off the menu.
- Input
- Keyboard, gamepad and touch. Touch controls are Auto, On or Off in Settings; forcing them on is how the touch layer is tested on desktop.
- Determinism
- Every gameplay draw goes through one seeded RNG, so a run is reproducible from its seed. Cosmetic scenery uses the global RNG on purpose.
- Replays
- Recording, local verification, a headless validator CLI and a Go validator-server are built, ported from TWIN STRIKE. The in-game submit flow is not.
- High scores
- Local top ten, saved between sessions. No online toplist yet.
- Art & audio
- No art or audio assets yet. The audio manager already asks for named sounds and stays silent when a file is missing, so they can land without touching gameplay code. No custom project icon yet either.
- Platforms
-
Windows x86_64macOS universal Linux x86_64Android arm64-v8aAll four are exported by ./release.sh. Android also needs a JDK, the Android SDK and a release keystore; --no-android cuts a desktop-only release.
Architecture
Hit detection is a plain distance check over two small lists rather than physics, because it resolves in a deterministic order. The logic worth testing lives in scene-free scripts.
| Piece | File | Job |
|---|---|---|
| MainGame | scripts/main_game.gd | Hit resolution, pickups and minion deaths: the one place holding the wizard, projectiles and monsters together. |
| Player | scripts/player.gd | Driving, sliding, health and mana. Decides whether a cast can be paid for. |
| SpellBase | scripts/spell_base.gd | One overshoot-carrying cooldown shared by every spell. |
| WaveDirector | scripts/wave_director.gd | Wave composition and placement on the road. Scene-free, so the difficulty curve is unit-testable. |
| Boss | scripts/boss.gd | Extends Monster: the hunt, the telegraphed slam and the three phases. |
| LaneGrid | scripts/lane_grid.gd | Lane count, widths and lane-to-x mapping. Nothing else hardcodes an x. |
| MinionSwarm | scripts/minion_swarm.gd | Lays the attached crowd out in packed rows in front of the wizard every tick. |
| TouchLayout | scripts/touch_layout.gd | Where the on-screen controls sit and what a tap means, as static logic tested without a device. |
| GameRng | scripts/game_rng.gd | Seeded RNG for all gameplay draws. Fails loud if drawn from before a reset. |
| ReplayVerifier | scripts/replay_verifier.gd | Re-runs a recorded input stream and diffs every stat and hash checkpoint. |
Roadmap
The minion lane's whole loop is built but nobody has played a full run with it, and the boss-every-wave curve has the same problem. The most useful next step is play, not code: a few long runs settle both the minion tuning and where the curve breaks.
The left lane's redesign follows from that, since what it should offer depends on how strong the crowd turns out to be.
| Item | Status | Notes |
|---|---|---|
| Army Rush: minion lane | Built, untuned | Minion health, damage, spacing and cast rate are first guesses. |
| Army Rush: left lane | Open | Needs its own redesign before power-ups come back, or a new job. |
| Re-tune for a boss every wave | Needs playtests | The most urgent balance item. The fodder count was not cut to compensate. |
| Art & audio | Scoped | Sound files drop in by name; a real project icon is needed before any public build. |
| Online leaderboard | Server built | Left: hosting, and an opt-in client submit flow, off by default. |
| Monster and boss variety | Suggested | An armored, a fast and a shielded type; distinct attack sets per boss band. |
Dev Guide
| Task | Command |
|---|---|
| Test | godot --headless -s res://addons/gut/gut_cmdln.gd -gexit |
| Lint | gdlint scripts/ tests/ |
| Format | gdformat scripts/ tests/ |
| Run (virtual display) | DISPLAY=:99 godot --path . --rendering-method mobile |
| Release | ./release.sh [VERSION] |
- Repo layout
-
scenes/scripts/tests/docs/ validator-server/addons/assets/
- Never use :0
- Never run the game against DISPLAY=:0. That is the live desktop, and a window torn down abruptly there can leave keyboard focus stuck until you log out. Use Xvfb on :99 and close the game gracefully.
- Working rules
- Work directly on main, use Conventional Commits, and keep tests green. All gameplay randomness goes through GameRng, and movement runs in _process, never _physics_process.