# Starfall Haven

Original landscape, touch-first Android colony-survival vertical slice. The simulation is deterministic and platform-independent; rendering uses the Android Canvas API (no network/runtime dependencies).

## Play loop
Three colonists autonomously prioritize food, wood, stone, then star crystal. Tap **GATHER** and a resource to override a job. Build **WALL** barriers, survive nightly void-prowler raids, then place the **BEACON** for 30 wood / 20 stone / 12 crystal and defend it for 25 seconds. Colonists automatically eat and fight. Starvation/exhaustion causes health loss. All colonists down is defeat; completing the beacon is victory.

## Touch
- Tap resource/ground: semantic action for selected tool
- Drag world: camera pan
- Pinch: zoom
- Large bottom controls: Gather, Wall, Beacon, Pause, Speed

## Build and test
```sh
export JAVA_HOME=/usr/lib/jvm/java-21-openjdk-amd64
./gradlew testDebugUnitTest assembleDebug
```
APK: `app/build/outputs/apk/debug/app-debug.apk`

PixelLab replacement contract: `app/src/main/assets/art/pixellab/README.md` and `AssetCatalog.java`.
