v0.1.8 ← games.spastic4.com

Project Overview

Uiza-do Musha

Home Changelog
Engine Godot 4.7.2 · 3D Genre Lane Spellcaster Survival Platforms Windows · macOS · Linux · Android Status Early Development Tests 719
00

The Game

∞
waves: you survive until you die, and the score is the point
5
castable spells, plus the Arcane Nova burst
719
automated tests on the GUT framework

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.

Early development

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.

01

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.

Input · where

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

Input · what

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

Input · when

Arcane Nova

Spend 45 mana at once for a 60-damage burst. The one cast you time yourself.

Space · gamepad A · NOVA button

The rule the economy rests on

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.

02

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.

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.
03

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.

SpellDamageCasts / sMana / castWhat it is for
Magic Missile123.50The free fallback. Fast, cheap, always available.
Frost Lance162.26Slows its target to 45% for 2 s, stretching its attack cadence. The one you hold down.
Fire Burst261.618Punches through and splashes the crowd nearby. Empties the pool in seconds.
Lightning Bolt82.09Ultra-fast, chains between enemies standing close, up to six bounces a cast.
Life Steal10 / schannel20 / sDrains the closest foe in reach and heals for what it drains, after a 2 s wind-up.
Mana spent per second of unbroken casting
Magic Missile0 / s
Frost Lance13.2 / s
Lightning Bolt18 / s
Life Steal20 / s
Fire Burst28.8 / s
Bars are against a 30 / s scale; the green tick is the 12 / s regen. Red means the pool is draining. Frost Lance barely outruns regen, so a full pool lasts over a minute; Fire Burst empties it in a few seconds.
04

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 20
Every 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.
The curve is guessed, not measured. Bosses moved from every tenth wave to every wave, and nobody has played far enough to know where the run stops being interesting.
05

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-v8a
All 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.
06

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.

PieceFileJob
MainGamescripts/main_game.gdHit resolution, pickups and minion deaths: the one place holding the wizard, projectiles and monsters together.
Playerscripts/player.gdDriving, sliding, health and mana. Decides whether a cast can be paid for.
SpellBasescripts/spell_base.gdOne overshoot-carrying cooldown shared by every spell.
WaveDirectorscripts/wave_director.gdWave composition and placement on the road. Scene-free, so the difficulty curve is unit-testable.
Bossscripts/boss.gdExtends Monster: the hunt, the telegraphed slam and the three phases.
LaneGridscripts/lane_grid.gdLane count, widths and lane-to-x mapping. Nothing else hardcodes an x.
MinionSwarmscripts/minion_swarm.gdLays the attached crowd out in packed rows in front of the wizard every tick.
TouchLayoutscripts/touch_layout.gdWhere the on-screen controls sit and what a tap means, as static logic tested without a device.
GameRngscripts/game_rng.gdSeeded RNG for all gameplay draws. Fails loud if drawn from before a reset.
ReplayVerifierscripts/replay_verifier.gdRe-runs a recorded input stream and diffs every stat and hash checkpoint.
07

Roadmap

A lean, not a verdict

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.

ItemStatusNotes
Army Rush: minion laneBuilt, untunedMinion health, damage, spacing and cast rate are first guesses.
Army Rush: left laneOpenNeeds its own redesign before power-ups come back, or a new job.
Re-tune for a boss every waveNeeds playtestsThe most urgent balance item. The fodder count was not cut to compensate.
Art & audioScopedSound files drop in by name; a real project icon is needed before any public build.
Online leaderboardServer builtLeft: hosting, and an opt-in client submit flow, off by default.
Monster and boss varietySuggestedAn armored, a fast and a shielded type; distinct attack sets per boss band.
08

Dev Guide

TaskCommand
Testgodot --headless -s res://addons/gut/gut_cmdln.gd -gexit
Lintgdlint scripts/ tests/
Formatgdformat 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.