ii.AirplaneDwarf 0.3.0

iiAirplaneDwarf

iiAirplaneDwarf is a C# library supporting the modification of files relating to Submarine Titans, the 2000 RTS game developed by Ellipse Studios.

Usage

var processor = new DkxProcessor();
foreach (var archive in archives)
{
    if (!File.Exists(archive))
    {
        Console.WriteLine($"skip missing {archive}");
        continue;
    }

    Console.WriteLine($"Reading {archive}");

    var dkdPath = Path.ChangeExtension(archive, "dkd");

    var entries = processor.Read(archive, dkdPath);
    var dest = Path.Combine(outRoot, Path.GetFileNameWithoutExtension(archive));
    Directory.CreateDirectory(dest);

    var written = 0;
    foreach (var entry in entries)
    {
        var payload = entry.Data;
        if (payload == null || payload.Length == 0)
        {
            continue;
        }

        var safe = string.Join("_", entry.Filename.Split(Path.GetInvalidFileNameChars()));
        var path = Path.Combine(dest, $"{safe}.{entry.Extension}");
        if (File.Exists(path))
        {
            path = Path.Combine(dest, $"{safe}_{entry.Type}.{entry.Extension}");
        }

        File.WriteAllBytes(path, payload);
        written++;
    }

    var types = entries.GroupBy(e => e.TypeName).OrderBy(g => g.Key);
    Console.WriteLine($"  {entries.Count} entries, wrote {written} files -> {dest}");
    Console.WriteLine("  " + string.Join(", ", types.Select(g => $"{g.Key}:{g.Count()}")));


    var pic = new PicProcessor();
    
    // Tile texture
    var palette = PicProcessor.LoadPaletteFromBmp(@"PALETTE.bmp");
    using var tile = pic.Read(File.ReadAllBytes(@"MAPTXTR001.pic"), palette);
    tile.SaveAsPng("tile.png");

    // Fog overlay (pass DKX width/height; optional plane 0..15)
    using var fog = pic.Read(dark0Bytes, palette, width: 66, height: 47, plane: 0);

    var tspr = new TsprProcessor();
    var names = tspr.Read(File.ReadAllBytes(@"CUR_CONFIRM.tspr"));
    var spr = new SprProcessor();
    var palette = SprProcessor.LoadPaletteFromBmp(@"CURSOR_PAL.bmp");
    foreach (var name in names)
    {
        var frames = spr.Read(File.ReadAllBytes($@"{name}.spr"), palette);
        // ...
    }

    var tmsk = new TmskProcessor();
    // Width/height from DKX (defaults 32×32)
    var masks = tmsk.Read(@"aven.tmsk");
    masks[0].SaveAsPng("aven_mask0.png");
    
    // Full-resolution mask (e.g. trmmine)
    var full = tmsk.Read(@"trmmine.tmsk", width: 180, height: 140);


    var sar = new SarProcessor();
    var table = sar.Read(@"SND_201.sar");
    foreach (var entry in table.Entries)
    {
        Console.WriteLine($"{entry.Index}: {entry.Value}");
    }

    var fnt = new FntProcessor();
    var font = fnt.Read(@"SYS_FONT.fnt");
    var glyph = font.FindGlyph('A');
    // glyph.Width, glyph.Height, glyph.AtlasOffset
}

Compiling

To clone and run this application, you'll need Git and .NET installed on your computer. From your command line:

# Clone this repository
$ git clone https://github.com/btigi/iiAirplaneDwarf

# Go into the repository
$ cd src

# Build  the app
$ dotnet build

Licencing

iiAirplaneDwarf is licenced under the MIT License. Full licence details are available in licence.md