2026-09-30 03:06:43 +02:00
using GameCult.Caching ;
2026-09-26 18:14:36 +02:00
using System ;
using System.Collections.Generic ;
2026-10-10 21:02:22 +02:00
using System.Globalization ;
2026-09-26 18:14:36 +02:00
using System.IO ;
using System.Linq ;
// Uses the existing database executable; mod authoring does not earn another binary target.
public static class ShipAuthoringCommands
{
2026-10-12 03:54:30 +02:00
private const string Usage = "ship-authoring create <ship.cc> <stable-id> <name> [--like <shipped hull name>] | inspect <ship.cc> | centre <ship.cc> | validate <ship.cc> | product <ship.cc> <maker> (--name <name> [--description <text>] | --remove) | price <ship.cc> <price> | compose <shipped.cc> <derived.cc> <mods-dir>" ;
2026-10-03 17:07:09 +02:00
2026-09-26 18:14:36 +02:00
public static int Run ( string [ ] args )
{
if ( args . Length = = 0 )
{
2026-10-03 17:07:09 +02:00
Console . Error . WriteLine ( Usage ) ;
2026-09-26 18:14:36 +02:00
return 1 ;
}
try
{
2026-09-26 18:30:02 +02:00
if ( args [ 0 ] = = "compose" & & args . Length = = 4 )
{
Ship S2 fixes: structural anchors are not mounts, mod presets refused, one bad mod never bricks the boot
- Validate: a hardpoint's anchor role is fixed by its type (thruster-emitter, radiator-mesh, else articulation); ShipModPlan's
duplicate role check is deleted.
- Loadouts.Commit refuses a preset naming a mod design (mod-hull:/mod-ship:), so the shipped catalog never references a mod.
- Compose quarantines each package: a bad package is excluded and named, a collision excludes every package involved; the
game boots on the rest (or the shipped catalog) and the main menu lists the exclusions.
- RequireDesigns refuses a save with a null item or lot instead of throwing NullReferenceException.
- Tests: per structural role, muzzle id ties, every slot/zone/lot in RequireDesigns, listing order, exclusion cases.
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-09-30 08:30:52 +02:00
var composition = ShipModCatalog . Compose ( args [ 1 ] , args [ 2 ] , args [ 3 ] ) ;
Console . WriteLine ( $"Composed {composition.Included.Length} mod ships into {Path.GetFullPath(args[2])}" ) ;
foreach ( var exclusion in composition . Excluded ) Console . Error . WriteLine ( $"Excluded {exclusion}" ) ;
return composition . Excluded . Length = = 0 ? 0 : 1 ;
2026-09-26 18:30:02 +02:00
}
2026-09-26 18:14:36 +02:00
if ( args [ 0 ] = = "inspect" & & args . Length = = 2 )
{
2026-10-12 03:54:30 +02:00
var ( hull , ship , products ) = ShipAuthoringStore . Load ( args [ 1 ] ) ;
2026-09-30 03:06:43 +02:00
Console . WriteLine ( $"{ship.Id}: {hull.Name}, {hull.Hardpoints?.Count ?? 0} hardpoints, {ship.SchematicLines?.Count ?? 0} lines, {ship.SchematicLines?.Sum(line => line.Points?.Length / 3 ?? 0) ?? 0} points" ) ;
2026-10-12 03:54:30 +02:00
foreach ( var product in products ) Console . WriteLine ( $"product {product.Manufacturer.Key.Value}: {product.Name}" ) ;
2026-09-26 18:14:36 +02:00
return 0 ;
}
2026-10-10 21:02:22 +02:00
if ( args [ 0 ] = = "centre" & & args . Length = = 2 )
{
// The one centre of mass Blender places a ship by: Shape.CenterOfMass in cell coordinates, as "x y".
var centre = ShipAuthoringStore . Load ( args [ 1 ] ) . Hull . Shape . CenterOfMass ;
Console . WriteLine ( string . Create ( CultureInfo . InvariantCulture , $"{centre.x:R} {centre.y:R}" ) ) ;
return 0 ;
}
2026-09-26 18:14:36 +02:00
if ( args [ 0 ] = = "validate" & & args . Length = = 2 )
{
2026-10-03 17:07:09 +02:00
// The package's GLB is judged too once it exists (node ids, mesh roles); a draft without one is judged on
// its records alone, and the output says which.
2026-10-12 03:54:30 +02:00
var ( hull , ship , products ) = ShipAuthoringStore . Load ( args [ 1 ] ) ;
2026-10-03 17:07:09 +02:00
var model = string . IsNullOrWhiteSpace ( ship . ModelAsset ) ? null
: Path . Combine ( Path . GetDirectoryName ( Path . GetFullPath ( args [ 1 ] ) ) , ship . ModelAsset ) ;
var judged = model ! = null & & File . Exists ( model ) ? "records and model" : "records only, no model yet" ;
if ( judged = = "records and model" ) ShipModCatalog . ReadPackage ( args [ 1 ] ) ;
2026-10-12 20:00:18 +02:00
else ShipAuthoringStore . ValidateLoaded ( hull , ship , products ) ;
2026-10-03 17:07:09 +02:00
Console . WriteLine ( $"{ship.Id}: {hull.Name}, {hull.Hardpoints.Count} hardpoints, {ship.Anchors.Count} anchors, {ship.SchematicLines.Count} lines ({judged})" ) ;
2026-09-26 18:14:36 +02:00
return 0 ;
}
2026-10-03 17:07:09 +02:00
if ( args [ 0 ] = = "create" & & ( args . Length = = 4 | | args . Length = = 6 & & args [ 4 ] = = "--like" ) )
2026-09-26 18:14:36 +02:00
{
2026-10-10 06:53:03 +02:00
ShipAuthoringStore . RequireShipId ( args [ 2 ] ) ;
2026-09-26 18:14:36 +02:00
var path = Path . GetFullPath ( args [ 1 ] ) ;
if ( File . Exists ( path ) ) throw new InvalidOperationException ( $"Refusing to replace {path}" ) ;
Directory . CreateDirectory ( Path . GetDirectoryName ( path ) ) ;
2026-09-30 03:06:43 +02:00
var ship = new ShipAuthoring { Id = args [ 2 ] , ModelAsset = "ship.glb" , Anchors = new List < ShipAnchor > ( ) } ;
2026-10-03 17:07:09 +02:00
var hull = args . Length = = 6
? ShipAuthoringStore . HullLike ( ShippedShipHull ( args [ 5 ] ) , args [ 3 ] , ship . Id )
: new HullData
{
Name = args [ 3 ] ,
Shape = new Shape ( ) ,
Visual = new CultRecordRef < ShipAuthoring > ( ShipModCatalog . AuthoringKey ( ship . Id ) )
} ;
2026-09-26 18:14:36 +02:00
using ( var cache = ShipAuthoringStore . Open ( path , writable : true ) )
{
2026-09-30 03:06:43 +02:00
ShipAuthoringStore . Write ( cache , hull , ship ) ;
2026-09-26 18:14:36 +02:00
cache . FlushAsync ( ) . Wait ( ) ;
}
Console . WriteLine ( $"Created draft {path}; fill its model bindings and schematic in Blender." ) ;
return 0 ;
}
2026-10-12 03:54:30 +02:00
if ( args [ 0 ] = = "price" & & args . Length = = 3 )
{
// Judged before the file is touched: a refusal leaves it byte-identical.
if ( ! int . TryParse ( args [ 2 ] , NumberStyles . None , CultureInfo . InvariantCulture , out var price ) )
throw new InvalidOperationException ( "price must be a non-negative whole number." ) ;
var ( hull , ship , _ ) = ShipAuthoringStore . Load ( args [ 1 ] ) ;
hull . Price = price ;
using ( var cache = ShipAuthoringStore . Open ( args [ 1 ] , writable : true ) )
{
ShipAuthoringStore . Write ( cache , hull , ship ) ;
cache . FlushAsync ( ) . Wait ( ) ;
}
Console . WriteLine ( $"{ship.Id}: price {price}." ) ;
return 0 ;
}
if ( args [ 0 ] = = "product" & & args . Length > = 4 )
{
var remove = args . Length = = 4 & & args [ 3 ] = = "--remove" ;
var named = args . Length > = 5 & & args [ 3 ] = = "--name" & & ( args . Length = = 5 | | args . Length = = 7 & & args [ 5 ] = = "--description" ) ;
if ( ! remove & & ! named ) { Console . Error . WriteLine ( Usage ) ; return 1 ; }
var ( hull , ship , products ) = ShipAuthoringStore . Load ( args [ 1 ] ) ;
var ( makerKey , makerName ) = ShippedFaction ( args [ 2 ] ) ;
if ( remove )
{
if ( ! products . Any ( product = > product . Manufacturer . Key . Equals ( makerKey ) ) )
throw new InvalidOperationException ( $"{ship.Id}: the package holds no product by that maker." ) ;
}
else if ( string . IsNullOrWhiteSpace ( args [ 4 ] ) )
throw new InvalidOperationException ( "--name: a product needs a name." ) ;
using ( var cache = ShipAuthoringStore . Open ( args [ 1 ] , writable : true ) )
{
if ( remove ) ShipAuthoringStore . DeleteProduct ( cache , ship . Id , makerKey ) ;
else
ShipAuthoringStore . WriteProduct ( cache , ship . Id , new FactionProductData
{
Name = args [ 4 ] ,
Description = args . Length = = 7 ? args [ 6 ] : null ,
Design = new CultRecordRef < CraftedItemData > ( ShipModCatalog . HullKey ( ship . Id ) ) ,
Manufacturer = new CultRecordRef < Faction > ( makerKey ) ,
Roles = hull . Roles . Select ( role = > new ProductRole { Role = role . Name } ) . ToList ( )
} ) ;
cache . FlushAsync ( ) . Wait ( ) ;
}
Console . WriteLine ( $"{ship.Id}: {(remove ? " removed " : " wrote ")} the product by {makerName}." ) ;
return 0 ;
}
2026-10-03 17:07:09 +02:00
Console . Error . WriteLine ( Usage ) ;
2026-09-26 18:14:36 +02:00
return 1 ;
}
catch ( Exception ex )
{
Console . Error . WriteLine ( ex . Message ) ;
return 1 ;
}
}
2026-10-03 17:07:09 +02:00
2026-10-12 03:54:30 +02:00
// A shipped faction by name or short name, from GameData/Aetheria.cc opened read-only: exactly one, or refused.
private static ( CultRecordKey Key , string Name ) ShippedFaction ( string nameOrShortName )
{
using var catalog = AetherDb . Open ( ) . Cache ;
var matches = catalog . GetAll < Faction > ( )
. Where ( faction = > string . Equals ( faction . Name , nameOrShortName , StringComparison . Ordinal ) | |
string . Equals ( faction . ShortName , nameOrShortName , StringComparison . Ordinal ) ) . ToArray ( ) ;
if ( matches . Length ! = 1 )
throw new InvalidOperationException ( $"<maker>: the shipped catalog has {matches.Length} factions with that name or short name; exactly one is required." ) ;
return ( catalog . TryGetHandle ( matches [ 0 ] ) . Value . Key , matches [ 0 ] . Name ) ;
}
2026-10-03 17:07:09 +02:00
// A shipped ship hull by name, from GameData/Aetheria.cc opened read-only.
private static HullData ShippedShipHull ( string name )
{
using var catalog = AetherDb . Open ( ) . Cache ;
var hull = catalog . GetAll < HullData > ( ) . FirstOrDefault ( candidate = > candidate . Name = = name ) ? ?
throw new InvalidOperationException ( $"--like: the shipped catalog has no hull named '{name}'." ) ;
if ( hull . HullType ! = HullType . Ship )
throw new InvalidOperationException ( $"--like: '{name}' is a {hull.HullType} hull, not a ship." ) ;
return hull ;
}
2026-09-26 18:14:36 +02:00
}