# Tidewall build entry points. Everything runs headless with the repo-local engine.
GODOT := tools/godot.sh

.PHONY: tutorial-check tutorial-captures qa-captures effects-captures app-icon deb deb-check bench dist dist-check build-captures poi-captures art figure figure-captures sea-captures models item-captures audio audio-check check import parse test test-selfcheck smoke capture-test terrain-capture binaries verify-engine balance bot-matches duo-matches bot-builds match match-captures client-check client-captures hud-captures style-captures menu-captures chart-captures discovery-check fuzz stability soak soak-selfcheck server-package-check

## A8: regenerates every sound in assets/audio/ from tools/audio/ (about 6 s).
audio: import
	@$(GODOT) --script res://tools/audio/generate.gd

## A8: checks the generated audio's hashes and loudness against the rules.
audio-check: import
	@$(GODOT) --script res://tools/audio/check.gd

## A4: rebuilds every item model and icon in headless Blender (CPU only, about 20 s).
models:
	@nice -n 15 blender --background --factory-startup --python tools/models/items.py
	@$(GODOT) --import --quit >/dev/null 2>&1 || true

## A2 and A4: every generated model, the player figure and the items with their icons.
art: figure models

## A2: the player figure's parts (assets/models/figure/), about 3 s.
figure:
	@nice -n 15 blender --background --factory-startup --python tools/models/figure.py >/dev/null
	@$(GODOT) --import --quit >/dev/null 2>&1 || true

## A2: the figure in every movement state, every action, and close up
## (captures/figure_*.png, about 1.5 min). Needs Docker. Look at them.
figure-captures: import
	@for stage in states actions close; do tools/capture.sh figure_$$stage captures/figure_$$stage.png; done

## A6: the sea at every tide phase from out at sea, a calm beach, the last land in the
## gale and the view under water (captures/sea_*.png, about 6 min), and three of them
## again in the Compatibility renderer (*_compat.png). Needs Docker. Look at them.
sea-captures: import
	@for stage in tide_0 tide_1 tide_2 tide_3 tide_4 tide_5 tide_6 tide_7 shore_calm shore_gale underwater; do tools/capture.sh sea_$$stage captures/sea_$$stage.png; done
	@for stage in tide_2 shore_gale underwater; do CAPTURE_RENDERER=compatibility tools/capture.sh sea_$$stage captures/sea_$${stage}_compat.png; done

## A4: items held in the hand, over the shoulder, lying on the ground and by tier
## (captures/items_*.png, about 3 min). Needs Docker. Look at them.
item-captures: import
	@for stage in held shoulder ground tiers; do tools/capture.sh items_$$stage captures/items_$$stage.png; done

## A7: renders the visual effects: a hit over the shoulder, a keg blast and collapse, the
## quieter effects, and the stress scene at the largest budget (about 6 min).
## H6: every capture scenario, the HUD at 4K and contact sheets (captures/qa/, about
## 40 min). Needs Docker. Judge each against docs/VISUAL_QA.md.
qa-captures: import
	@tools/qa_captures.sh

effects-captures: import
	@for stage in fight blast work stress; do tools/capture.sh effects_$$stage captures/effects_$$stage.png; done

## H1: server tick times and client draw calls, triangles and memory against the budgets
## in docs/ARCHITECTURE.md (about 3 minutes; the client half needs Docker).
bench: import
	@tools/bench.sh

## R1: exports the game with the official templates into
## build/dist/tidewall-<version>-linux-x86_64.tar.gz (about 20 s).
dist: import
	@tools/dist.sh

## R1: builds the package, unpacks it outside the repo, and runs smoke, a whole bot match
## and its game playing on its server there (about 2 minutes).
dist-check: import
	@tools/dist_check.sh

## R2: renders assets/icons/app/tidewall.svg to the PNG sizes desktops use.
app-icon:
	@$(GODOT) --script res://tools/app_icon.gd

## R2: builds build/dist/tidewall_<version>-1_amd64.deb from the release package.
deb: import
	@tools/deb.sh

## R2: builds the .deb and checks it in a throwaway Debian 13 container: install,
## desktop entry, the server and the game headless, lintian, purge (about 3 minutes).
deb-check: import
	@tools/deb_check.sh

## Everything that must pass before a push.
check: verify-engine binaries parse test test-selfcheck smoke

verify-engine:
	@$(GODOT) --verify

binaries:
	@tools/check_binaries.sh

## Refreshes Godot's global class cache, so class_name lookups resolve.
import:
	@$(GODOT) --import --quit >/dev/null 2>&1 || true

parse: import
	@$(GODOT) --script res://tools/parse_all.gd

test: import
	@tools/run_tests.sh

## Proves the test runner detects each kind of failure.
test-selfcheck: import
	@tools/test_selfcheck.sh

## Boots the headless server for 1,000 ticks and checks exit codes, logs and timing.
smoke: import
	@tools/smoke.sh

## Plays 20 bot-only matches and checks each has a winner, few bots drown and easy
## bots do worst. Takes about ten minutes, so it isn't part of `check`.
## BOT_MATCH_SEEDS and BOT_MATCH_FIRST change how many seeds and where they start.
## H3: the balance pass over 200 bot-only matches; report in build/balance/report.txt.
balance: import
	@tools/balance.sh

bot-matches: import
	@tools/bot_matches.sh

## M7: plays 10 bot-only duos matches (12 teams of two, under nice) and checks each is
## won by one team, bots go down and revive each other, teammates never hurt each other
## and the ticks keep within budget. DUO_MATCH_SEEDS and DUO_MATCH_FIRST change the seeds.
duo-matches: import
	@tools/duo_matches.sh

## M6: plays 40 bot-only matches in which every other bot gathers and builds (about 12
## minutes, under nice) and checks the builders build in over a third of the fights they
## can afford to, lose fewer of the fights they build in than of the rest, and place no
## worse than the others. BOT_BUILDS_SEEDS and BOT_BUILDS_FIRST change the seeds.
bot-builds: import
	@tools/bot_builds.sh

## Plays one whole offline match, lobby to results, with a scripted player and 23 bots,
## then replays its command log and checks the replay ends in the same state.
## MATCH_SEED picks the seed.
match: import
	@tools/match.sh

## Renders each stage of the match `make match` last played. Needs Docker.
match-captures: import
	@tools/match_captures.sh

## A12: the tutorial's scripted player finishes it from the barge to the end on 12
## seeds, through a real ClientSession and its offline server (about 40 s).
tutorial-check: import
	@nice -n 15 $(GODOT) --script res://tools/tutorial_check.gd -- --seeds=$${TUTORIAL_SEEDS:-12} --first=$${TUTORIAL_FIRST:-1}

## A12: the tutorial's card at three steps, and the welcome that offers it
## (captures/tutorial_*.png, menu_welcome.png, about 2 min). Needs Docker. Look at them.
tutorial-captures: import
	@for scene in tutorial_move tutorial_build tutorial_tide menu_welcome; do tools/capture.sh $$scene captures/$$scene.png; done

## Joins a real client process to a real server process over loopback UDP and checks
## it gets from the lobby into the match. About a minute, in real time.
client-check: import
	@tools/client_check.sh

## Feeds FUZZ_MESSAGES (default 1,000,000) malformed messages to every network parser.
FUZZ_MESSAGES ?= 1000000
FUZZ_SEED ?= 1
fuzz: import
	@nice -n 15 $(GODOT) --script res://tools/fuzz_parsers.gd -- --messages=$(FUZZ_MESSAGES) --seed=$(FUZZ_SEED)

## Finds a real game server on the LAN (over loopback) and through a real list server.
discovery-check: import
	@tools/discovery_check.sh

## Renders what a network client sees on the barge, gliding and landed. Needs Docker.
client-captures: import
	@for stage in barge glide landed basin build build_refused hud hud_build; do tools/capture.sh client_$$stage captures/client_$$stage.png; done

## A9: the HUD at 1280x720 and at 3840x2160 (captures/hud_*.png). Needs Docker.
hud-captures: import
	@CAPTURE_SIZE=1280x720 tools/capture.sh client_hud captures/hud_720.png
	@CAPTURE_SIZE=1280x720 tools/capture.sh client_hud_build captures/hud_build_720.png
	@CAPTURE_SIZE=1280x720 tools/capture.sh client_hud_downed captures/hud_downed_720.png
	@CAPTURE_SIZE=3840x2160 tools/capture.sh client_hud captures/hud_2160.png

## A10: every menu screen (captures/menu_*.png, about 5 min). Needs Docker. Look at them.
menu-captures: import
	@for scene in menu_welcome menu_main menu_practice menu_join menu_settings menu_settings_mouse menu_pause menu_results; do tools/capture.sh $$scene captures/$$scene.png; done

## A11: the chart and minimap with the first tide forecast, and after it has risen
## (captures/chart_*.png, about 2 min). Needs Docker. Look at them.
chart-captures: import
	@for scene in chart_first chart_later; do tools/capture.sh $$scene captures/$$scene.png; done

## A5: every kind of point of interest, and the fort and wall state test card. Needs Docker.
poi-captures: import
	@for scene in poi_hamlet poi_dock poi_lighthouse poi_quarry poi_salt_works poi_shrine; do tools/capture.sh $$scene captures/$$scene.png; done

build-captures: import
	@for scene in build_fort build_fort_side build_states vessels; do tools/capture.sh $$scene captures/$$scene.png; done

## A1: the woodcut print pass on and off, side by side scenes (captures/style_*.png). Needs Docker.
style-captures: import
	@for scene in style_hamlet style_hamlet_plain style_dock style_dock_plain; do tools/capture.sh $$scene captures/$$scene.png; done

## Renders the capture test scenes in the offscreen container. Needs Docker.
capture-test: import
	@tools/capture_selfcheck.sh

## Renders the terrain crack check and its control in the offscreen container. Needs Docker.
terrain-capture: import
	@tools/terrain_capture_check.sh

## The 24-client network soak: a real server and 24 headless clients behind a relay that
## adds latency, jitter and loss, for SOAK_MATCHES (default 2) whole matches in real
## time, about half an hour. Checks for desyncs, errors, leaks and the tick budget.
## H4: 50 bot matches back to back on one unthrottled server; report in build/stability/report.txt.
stability: import
	@tools/stability.sh

soak: import
	@tools/soak.sh

## About a minute: proves the soak catches a client whose world has drifted.
soak-selfcheck: import
	@SOAK_SELFCHECK=1 tools/soak.sh

## Builds the server image with packaging/docker/compose.yaml, starts it, joins it with a
## headless client and stops it with SIGTERM. Needs Docker. About a minute and a half.
server-package-check: import
	@tools/server_package_check.sh
