spaceship/vessels/VesselDefinition.gd
Loïc Wisniewski 2f161621c3 #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

45 lines
1.9 KiB
GDScript

class_name VesselDefinition
extends Resource
# The stable internal key: capability strings, unlock ids in vessel_levels,
# component scene names and every test refer to a vessel by this, NOT by
# display_name. The two are deliberately allowed to diverge - #77 renamed the
# "distorder" to the Energy Propulser purely in what the player sees, and
# nothing underneath had to be migrated for it.
#
# Note for editors of the .tres files themselves: Godot's resource format does
# NOT accept `#` comments inside a [resource] block. One added there parses as
# part of the preceding value and silently blanks the property after it, which
# presents as "<blank> did not resolve its definition" a long way from the
# edit. Comments about the data go here, in the script.
@export var definition_id: String
@export var display_name: String
@export_multiline var description: String
@export var build_cost: int
@export var build_resource_costs: Dictionary = {}
@export var build_time: float = 10.0
@export var icon: int = 2
@export var glow_color: Color = Color(0.25, 0.85, 1.0)
@export var hull_points: PackedVector2Array = PackedVector2Array([
Vector2(0, -22), Vector2(-14, 16), Vector2(14, 16),
])
@export var fleet_eligible: bool = false
@export var capabilities: PackedStringArray = []
@export var component_scenes: Array[PackedScene] = []
@export var base_stats: Dictionary = {}
@export var minimum_stats: Dictionary = {}
@export var upgrades: Array[Resource] = []
@export var unlock_id: String
@export var unlock_name: String
@export_multiline var unlock_description: String
@export var unlock_cost: int
@export var unlock_resource_costs: Dictionary = {}
# #63: spent from GameState.research_points, alongside unlock_resource_costs
# rather than instead of it. 0 (the default) means this unlock needs no
# research points at all.
@export var research_point_cost: int = 0
@export var unlock_icon: int = -1
func has_capability(capability: String) -> bool:
return capability in capabilities