Initial commit: SpaceshipTest, a top-down space RTS in Godot 4.7.1
A fleet of neon-outlined ships explores a procedurally generated, seeded
infinite world: tap/joystick steering, pinch zoom, formation pivoting,
planet landings, an ore economy with extractors and haulers, and player
built structures (mothership, ship crafter, command centre).
All art is hand-drawn with draw_* calls rather than textures, and the
backgrounds are camera-relative shaders so they stay precise at large
world coordinates.
Includes a 35-test headless suite (tests/run_tests.sh) plus screenshot
tooling that renders real frames through Xvfb and Mesa softpipe, since
--headless has no GPU.
Excluded from version control: .godot/ (import cache, and it holds
export credentials), builds/, android/build/ and packaged APKs - all
regenerable, and ~325 MB combined.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-10 18:41:58 +02:00
|
|
|
extends Node2D
|
|
|
|
|
|
#84: move 215 root files into a folder hierarchy
Everything lived in one flat directory, so a diff gave no clue what area it
touched and finding the file you wanted meant knowing its exact name. Twelve
folders now, grouped by what a thing IS rather than what type it is - a
vessel's definition, its component scenes and its upgrade resources sit
together, because that is the set you read when you change one of them.
buildings core controllers enemies logistics planets
resources shaders surface ui vessels vfx world
332 files moved and every res:// reference rewritten - 306 files touched,
including the autoload and main-scene paths in project.godot. Nothing renamed:
this is purely where files sit, so the diff is a pile of pure moves and no
behaviour is buried in it. ui_theme.tres, icon.svg and web_shell.html stay at
the root, where Godot and the export preset expect them.
Verified three ways, because a suite alone would not have caught all of it:
the full 117 pass, the web export builds clean, and the game renders.
The export is why that matters. The FIRST export after the move failed with
"Attempt to open script 'res://GameState.gd'" - the old path - while
project.godot on disk plainly said res://core/GameState.gd. That is this
project's documented Android FUSE mtime trap: Godot served a cached copy of a
file whose content had changed. A `touch` fixed it. Nothing in the test suite
would have found that, because the suite runs from a copy on a native
filesystem - the one place the bug cannot happen.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-21 19:44:14 +02:00
|
|
|
const PLANET_DEFINITIONS = preload("res://planets/PlanetDefinitions.gd")
|
2026-08-14 16:13:24 +02:00
|
|
|
|
2026-08-14 16:05:32 +02:00
|
|
|
|
Initial commit: SpaceshipTest, a top-down space RTS in Godot 4.7.1
A fleet of neon-outlined ships explores a procedurally generated, seeded
infinite world: tap/joystick steering, pinch zoom, formation pivoting,
planet landings, an ore economy with extractors and haulers, and player
built structures (mothership, ship crafter, command centre).
All art is hand-drawn with draw_* calls rather than textures, and the
backgrounds are camera-relative shaders so they stay precise at large
world coordinates.
Includes a 35-test headless suite (tests/run_tests.sh) plus screenshot
tooling that renders real frames through Xvfb and Mesa softpipe, since
--headless has no GPU.
Excluded from version control: .godot/ (import cache, and it holds
export credentials), builds/, android/build/ and packaged APKs - all
regenerable, and ~325 MB combined.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-10 18:41:58 +02:00
|
|
|
# A landable world-object - unlike regular Asteroid.gd, planets are
|
|
|
|
|
# stationary ("Big Stable Asteroid" - stable means it doesn't drift or
|
|
|
|
|
# destroy ships on touch). Whether the fleet counts as "landed" is decided
|
|
|
|
|
# by PlanetField comparing the fleet's CENTROID distance to landing_radius,
|
|
|
|
|
# not per-ship Area2D collision - a single stable number, immune to the
|
|
|
|
|
# constant minor jostling of individual ships holding formation, which
|
|
|
|
|
# used to make the "enter atmosphere" prompt flicker on/off as ships
|
|
|
|
|
# drifted in and out of the boundary independently of each other even
|
|
|
|
|
# while the fleet as a whole was clearly sitting on the planet.
|
|
|
|
|
|
|
|
|
|
@export var planet_name: String = ""
|
2026-08-14 22:16:40 +02:00
|
|
|
@export var planet_id: String = ""
|
2026-08-14 16:13:24 +02:00
|
|
|
@export var definition_id: String = PLANET_DEFINITIONS.DEFAULT_DEFINITION_ID
|
Initial commit: SpaceshipTest, a top-down space RTS in Godot 4.7.1
A fleet of neon-outlined ships explores a procedurally generated, seeded
infinite world: tap/joystick steering, pinch zoom, formation pivoting,
planet landings, an ore economy with extractors and haulers, and player
built structures (mothership, ship crafter, command centre).
All art is hand-drawn with draw_* calls rather than textures, and the
backgrounds are camera-relative shaders so they stay precise at large
world coordinates.
Includes a 35-test headless suite (tests/run_tests.sh) plus screenshot
tooling that renders real frames through Xvfb and Mesa softpipe, since
--headless has no GPU.
Excluded from version control: .godot/ (import cache, and it holds
export credentials), builds/, android/build/ and packaged APKs - all
regenerable, and ~325 MB combined.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-10 18:41:58 +02:00
|
|
|
@export var landing_radius: float = 140.0
|
|
|
|
|
# Set by whoever spawns this planet (PlanetField, seeded from the chunk's
|
|
|
|
|
# own coordinates) so the outline shape is stable across respawns of the
|
|
|
|
|
# same chunk, instead of reading as a "different" planet every time.
|
|
|
|
|
@export var shape_seed: int = 0
|
|
|
|
|
|
2026-08-14 16:13:24 +02:00
|
|
|
var definition: Resource
|
|
|
|
|
var visual: Node2D
|
|
|
|
|
|
|
|
|
|
var resource_type: String:
|
|
|
|
|
get: return String(definition.resource_id) if definition != null else "ore"
|
|
|
|
|
|
|
|
|
|
var surface_profile_id: String:
|
|
|
|
|
get: return String(definition.surface_profile_id) if definition != null else "rocky"
|
|
|
|
|
|
|
|
|
|
var shape_points: PackedVector2Array:
|
|
|
|
|
get:
|
|
|
|
|
if visual != null and "shape_points" in visual:
|
|
|
|
|
return visual.shape_points
|
|
|
|
|
return PackedVector2Array()
|
|
|
|
|
|
|
|
|
|
var gas_phase: float:
|
|
|
|
|
get:
|
|
|
|
|
if visual != null and "gas_phase" in visual:
|
|
|
|
|
return float(visual.gas_phase)
|
|
|
|
|
return 0.0
|
Initial commit: SpaceshipTest, a top-down space RTS in Godot 4.7.1
A fleet of neon-outlined ships explores a procedurally generated, seeded
infinite world: tap/joystick steering, pinch zoom, formation pivoting,
planet landings, an ore economy with extractors and haulers, and player
built structures (mothership, ship crafter, command centre).
All art is hand-drawn with draw_* calls rather than textures, and the
backgrounds are camera-relative shaders so they stay precise at large
world coordinates.
Includes a 35-test headless suite (tests/run_tests.sh) plus screenshot
tooling that renders real frames through Xvfb and Mesa softpipe, since
--headless has no GPU.
Excluded from version control: .godot/ (import cache, and it holds
export credentials), builds/, android/build/ and packaged APKs - all
regenerable, and ~325 MB combined.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-10 18:41:58 +02:00
|
|
|
|
Show buildings on the world map, and extractors on their planets
Forgejo #11: buildings the player has placed now appear on the world
map. They are placed freely in space rather than tied to a chunk, so
they get their own pass in WorldMapContent._draw() rather than riding
along with the chunk markers. Each type has its own shape and colour,
mirroring Building.gd's constants so a marker reads as the same
building you built.
Forgejo #9: a planet with an extractor built on it now shows it, in
both places you look at a planet - an amber derrick on its outline in
space, and a matching badge on its world-map marker. The extractor
lives on PlanetSurface.tscn, a scene you are not looking at from
space, so an already-mined planet was otherwise indistinguishable
from an untouched one until you landed on it.
The positioning steps are factored out (building_markers(),
chunk_has_extractor_badge(), extractor_derrick_tip()) so headless
tests can assert on them - --headless has no GPU and draws no pixels,
so there is nothing to check in _draw() itself. Both features were
also rendered for real via tests/screenshot.sh and looked at.
extractor_derrick_tip() exists because the first version of the
"derrick is not buried inside the planet" check measured the furthest
of all four derrick points, which passes a derrick pointing straight
into the ground: the base corners sit a half-width off the rim vertex
and clear the outline on their own. Mutation-testing caught it.
screenshot.sh now clears a stale /tmp/.X99-lock. A run killed
mid-screenshot leaves it behind and Xvfb then refuses :99, which
resurfaces later as Godot's misleading "X11 Display is not available".
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-11 15:29:56 +02:00
|
|
|
# An extractor is built down on this planet's SURFACE, in a different scene
|
|
|
|
|
# the player is no longer looking at, so from space nothing distinguished a
|
|
|
|
|
# planet already being mined from an untouched one - you had to land to find
|
|
|
|
|
# out. This is a derrick planted on the rim: the same amber the world map
|
|
|
|
|
# uses for its extractor badge, so the two read as the same fact.
|
|
|
|
|
const EXTRACTOR_MARKER_COLOR: Color = Color(1.0, 0.85, 0.3)
|
|
|
|
|
const DERRICK_HEIGHT: float = 44.0
|
|
|
|
|
const DERRICK_HALF_WIDTH: float = 16.0
|
|
|
|
|
|
2026-08-11 15:43:43 +02:00
|
|
|
# Kept in step with GameState.extractor_added rather than polled per frame.
|
|
|
|
|
# An extractor is built from SPACE (BuildController._planet_under_fleet(),
|
|
|
|
|
# with the fleet parked on the planet), so this node is already in the tree
|
|
|
|
|
# with its _ready() long since run when the answer changes - resolving it
|
|
|
|
|
# only at _ready() left the planet looking untouched until it happened to
|
|
|
|
|
# despawn and respawn.
|
Show buildings on the world map, and extractors on their planets
Forgejo #11: buildings the player has placed now appear on the world
map. They are placed freely in space rather than tied to a chunk, so
they get their own pass in WorldMapContent._draw() rather than riding
along with the chunk markers. Each type has its own shape and colour,
mirroring Building.gd's constants so a marker reads as the same
building you built.
Forgejo #9: a planet with an extractor built on it now shows it, in
both places you look at a planet - an amber derrick on its outline in
space, and a matching badge on its world-map marker. The extractor
lives on PlanetSurface.tscn, a scene you are not looking at from
space, so an already-mined planet was otherwise indistinguishable
from an untouched one until you landed on it.
The positioning steps are factored out (building_markers(),
chunk_has_extractor_badge(), extractor_derrick_tip()) so headless
tests can assert on them - --headless has no GPU and draws no pixels,
so there is nothing to check in _draw() itself. Both features were
also rendered for real via tests/screenshot.sh and looked at.
extractor_derrick_tip() exists because the first version of the
"derrick is not buried inside the planet" check measured the furthest
of all four derrick points, which passes a derrick pointing straight
into the ground: the base corners sit a half-width off the rim vertex
and clear the outline on their own. Mutation-testing caught it.
screenshot.sh now clears a stale /tmp/.X99-lock. A run killed
mid-screenshot leaves it behind and Xvfb then refuses :99, which
resurfaces later as Godot's misleading "X11 Display is not available".
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-11 15:29:56 +02:00
|
|
|
var shows_extractor: bool = false
|
|
|
|
|
|
Initial commit: SpaceshipTest, a top-down space RTS in Godot 4.7.1
A fleet of neon-outlined ships explores a procedurally generated, seeded
infinite world: tap/joystick steering, pinch zoom, formation pivoting,
planet landings, an ore economy with extractors and haulers, and player
built structures (mothership, ship crafter, command centre).
All art is hand-drawn with draw_* calls rather than textures, and the
backgrounds are camera-relative shaders so they stay precise at large
world coordinates.
Includes a 35-test headless suite (tests/run_tests.sh) plus screenshot
tooling that renders real frames through Xvfb and Mesa softpipe, since
--headless has no GPU.
Excluded from version control: .godot/ (import cache, and it holds
export credentials), builds/, android/build/ and packaged APKs - all
regenerable, and ~325 MB combined.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-10 18:41:58 +02:00
|
|
|
|
|
|
|
|
func _ready() -> void:
|
|
|
|
|
add_to_group("planets")
|
|
|
|
|
z_index = -1
|
2026-08-14 16:13:24 +02:00
|
|
|
definition = PLANET_DEFINITIONS.get_definition(definition_id)
|
|
|
|
|
visual = definition.visual_scene.instantiate()
|
|
|
|
|
visual.configure(shape_seed)
|
|
|
|
|
get_node("VisualHost").add_child(visual)
|
2026-08-14 22:16:40 +02:00
|
|
|
if planet_id == "":
|
|
|
|
|
planet_id = planet_name
|
|
|
|
|
shows_extractor = GameState.has_extractor_at(planet_id)
|
2026-08-11 15:43:43 +02:00
|
|
|
GameState.extractor_added.connect(_on_extractor_added)
|
|
|
|
|
queue_redraw()
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
func _on_extractor_added(built_on: String) -> void:
|
|
|
|
|
# Only the planet it was actually built on, and only a redraw when the
|
|
|
|
|
# answer really changed - every other planet in range gets this too.
|
2026-08-14 22:16:40 +02:00
|
|
|
if built_on != planet_id or shows_extractor:
|
2026-08-11 15:43:43 +02:00
|
|
|
return
|
|
|
|
|
shows_extractor = true
|
Initial commit: SpaceshipTest, a top-down space RTS in Godot 4.7.1
A fleet of neon-outlined ships explores a procedurally generated, seeded
infinite world: tap/joystick steering, pinch zoom, formation pivoting,
planet landings, an ore economy with extractors and haulers, and player
built structures (mothership, ship crafter, command centre).
All art is hand-drawn with draw_* calls rather than textures, and the
backgrounds are camera-relative shaders so they stay precise at large
world coordinates.
Includes a 35-test headless suite (tests/run_tests.sh) plus screenshot
tooling that renders real frames through Xvfb and Mesa softpipe, since
--headless has no GPU.
Excluded from version control: .godot/ (import cache, and it holds
export credentials), builds/, android/build/ and packaged APKs - all
regenerable, and ~325 MB combined.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-10 18:41:58 +02:00
|
|
|
queue_redraw()
|
|
|
|
|
|
|
|
|
|
|
Show buildings on the world map, and extractors on their planets
Forgejo #11: buildings the player has placed now appear on the world
map. They are placed freely in space rather than tied to a chunk, so
they get their own pass in WorldMapContent._draw() rather than riding
along with the chunk markers. Each type has its own shape and colour,
mirroring Building.gd's constants so a marker reads as the same
building you built.
Forgejo #9: a planet with an extractor built on it now shows it, in
both places you look at a planet - an amber derrick on its outline in
space, and a matching badge on its world-map marker. The extractor
lives on PlanetSurface.tscn, a scene you are not looking at from
space, so an already-mined planet was otherwise indistinguishable
from an untouched one until you landed on it.
The positioning steps are factored out (building_markers(),
chunk_has_extractor_badge(), extractor_derrick_tip()) so headless
tests can assert on them - --headless has no GPU and draws no pixels,
so there is nothing to check in _draw() itself. Both features were
also rendered for real via tests/screenshot.sh and looked at.
extractor_derrick_tip() exists because the first version of the
"derrick is not buried inside the planet" check measured the furthest
of all four derrick points, which passes a derrick pointing straight
into the ground: the base corners sit a half-width off the rim vertex
and clear the outline on their own. Mutation-testing caught it.
screenshot.sh now clears a stale /tmp/.X99-lock. A run killed
mid-screenshot leaves it behind and Xvfb then refuses :99, which
resurfaces later as Godot's misleading "X11 Display is not available".
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-11 15:29:56 +02:00
|
|
|
func extractor_derrick_anchor() -> Vector2:
|
2026-08-14 16:13:24 +02:00
|
|
|
if visual != null and visual.has_method("extractor_anchor"):
|
|
|
|
|
return visual.extractor_anchor()
|
|
|
|
|
return Vector2(0.0, -100.0)
|
Show buildings on the world map, and extractors on their planets
Forgejo #11: buildings the player has placed now appear on the world
map. They are placed freely in space rather than tied to a chunk, so
they get their own pass in WorldMapContent._draw() rather than riding
along with the chunk markers. Each type has its own shape and colour,
mirroring Building.gd's constants so a marker reads as the same
building you built.
Forgejo #9: a planet with an extractor built on it now shows it, in
both places you look at a planet - an amber derrick on its outline in
space, and a matching badge on its world-map marker. The extractor
lives on PlanetSurface.tscn, a scene you are not looking at from
space, so an already-mined planet was otherwise indistinguishable
from an untouched one until you landed on it.
The positioning steps are factored out (building_markers(),
chunk_has_extractor_badge(), extractor_derrick_tip()) so headless
tests can assert on them - --headless has no GPU and draws no pixels,
so there is nothing to check in _draw() itself. Both features were
also rendered for real via tests/screenshot.sh and looked at.
extractor_derrick_tip() exists because the first version of the
"derrick is not buried inside the planet" check measured the furthest
of all four derrick points, which passes a derrick pointing straight
into the ground: the base corners sit a half-width off the rim vertex
and clear the outline on their own. Mutation-testing caught it.
screenshot.sh now clears a stale /tmp/.X99-lock. A run killed
mid-screenshot leaves it behind and Xvfb then refuses :99, which
resurfaces later as Godot's misleading "X11 Display is not available".
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-11 15:29:56 +02:00
|
|
|
|
|
|
|
|
|
|
|
|
|
func extractor_derrick_tip() -> Vector2:
|
|
|
|
|
# Exposed separately from the polygon because "does the derrick clear the
|
|
|
|
|
# planet's outline" is a question about the TIP alone. The base corners
|
|
|
|
|
# sit a half-width off to either side, so they are sqrt(|base|^2 + w^2)
|
|
|
|
|
# from the centre and can clear the rim on their own even when the tower
|
|
|
|
|
# points straight into the ground.
|
|
|
|
|
var base: Vector2 = extractor_derrick_anchor()
|
|
|
|
|
var out: Vector2 = base.normalized()
|
|
|
|
|
if out == Vector2.ZERO:
|
|
|
|
|
out = Vector2.UP
|
|
|
|
|
return base + out * DERRICK_HEIGHT
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
func extractor_derrick_points() -> PackedVector2Array:
|
|
|
|
|
var base: Vector2 = extractor_derrick_anchor()
|
|
|
|
|
var out: Vector2 = base.normalized()
|
|
|
|
|
if out == Vector2.ZERO:
|
|
|
|
|
out = Vector2.UP
|
|
|
|
|
var side: Vector2 = Vector2(-out.y, out.x)
|
|
|
|
|
var tip: Vector2 = extractor_derrick_tip()
|
|
|
|
|
return PackedVector2Array([
|
|
|
|
|
base - side * DERRICK_HALF_WIDTH,
|
|
|
|
|
tip - side * (DERRICK_HALF_WIDTH * 0.35),
|
|
|
|
|
tip + side * (DERRICK_HALF_WIDTH * 0.35),
|
|
|
|
|
base + side * DERRICK_HALF_WIDTH,
|
|
|
|
|
])
|
|
|
|
|
|
|
|
|
|
|
Initial commit: SpaceshipTest, a top-down space RTS in Godot 4.7.1
A fleet of neon-outlined ships explores a procedurally generated, seeded
infinite world: tap/joystick steering, pinch zoom, formation pivoting,
planet landings, an ore economy with extractors and haulers, and player
built structures (mothership, ship crafter, command centre).
All art is hand-drawn with draw_* calls rather than textures, and the
backgrounds are camera-relative shaders so they stay precise at large
world coordinates.
Includes a 35-test headless suite (tests/run_tests.sh) plus screenshot
tooling that renders real frames through Xvfb and Mesa softpipe, since
--headless has no GPU.
Excluded from version control: .godot/ (import cache, and it holds
export credentials), builds/, android/build/ and packaged APKs - all
regenerable, and ~325 MB combined.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-10 18:41:58 +02:00
|
|
|
func _draw() -> void:
|
Show buildings on the world map, and extractors on their planets
Forgejo #11: buildings the player has placed now appear on the world
map. They are placed freely in space rather than tied to a chunk, so
they get their own pass in WorldMapContent._draw() rather than riding
along with the chunk markers. Each type has its own shape and colour,
mirroring Building.gd's constants so a marker reads as the same
building you built.
Forgejo #9: a planet with an extractor built on it now shows it, in
both places you look at a planet - an amber derrick on its outline in
space, and a matching badge on its world-map marker. The extractor
lives on PlanetSurface.tscn, a scene you are not looking at from
space, so an already-mined planet was otherwise indistinguishable
from an untouched one until you landed on it.
The positioning steps are factored out (building_markers(),
chunk_has_extractor_badge(), extractor_derrick_tip()) so headless
tests can assert on them - --headless has no GPU and draws no pixels,
so there is nothing to check in _draw() itself. Both features were
also rendered for real via tests/screenshot.sh and looked at.
extractor_derrick_tip() exists because the first version of the
"derrick is not buried inside the planet" check measured the furthest
of all four derrick points, which passes a derrick pointing straight
into the ground: the base corners sit a half-width off the rim vertex
and clear the outline on their own. Mutation-testing caught it.
screenshot.sh now clears a stale /tmp/.X99-lock. A run killed
mid-screenshot leaves it behind and Xvfb then refuses :99, which
resurfaces later as Godot's misleading "X11 Display is not available".
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-11 15:29:56 +02:00
|
|
|
if shows_extractor:
|
|
|
|
|
NeonDraw.draw_glowing_polygon(self, extractor_derrick_points(), EXTRACTOR_MARKER_COLOR, 1.0)
|