The .NET binding

C#, F# and PowerShell share one generated net8.0 assembly, Clunkyard.dll, which calls the core's C ABI through P/Invoke. It loads under the image's .NET 10 runtime and PowerShell's .NET 9 runtime. The API, record layouts, enums and conformance dispatch are generated from protocol/v2/api.json. Only loading, the run loop and exception mapping are written by hand.

Install with make install SDK=/opt/clunkyard/sdk. Reference /opt/clunkyard/sdk/bindings/csharp/Clunkyard.dll when compiling and set Private to false on that reference. Run with dotnet /opt/clunkyard/sdk/bindings/csharp/host/Clunkyard.Host.dll bot.dll. The SDK host resolves the binding from the image; the artifact holds only its own program and other dependencies. The binding loads libclunkyard.so.2, or the file named by CLUNKYARD_LIB.

Without Make, run node install.cjs SDK_DIRECTORY with your installed .NET SDK. Both commands use the same installer and need no Unix shell utilities on Windows. Build files stay in a temporary directory; only the binding and host assemblies are installed into the selected SDK. Set CLUNKYARD_LIB to the matching native core library, including clunkyard.dll on Windows or libclunkyard.2.dylib on macOS. The player CLI selects that path for local matches.

Subsystems and facts are properties. Methods use PascalCase. Optional records are null, and optional scalars are nullable value types. Controls accept nullable fields, with named arguments for changing only one field; fields merge within the turn. Drive.Get("throttle") reads one back. Throw new Forfeit(code, message) to forfeit. Other exceptions are logged with their trace and send the controls already set. Clunkyard.Play plays lines in memory for tests.

A tiny robot

using Clunkyard;

class Bot : Robot {
    public override void OnTurn(){
        var target=Sensors.Nearest;
        if(target==null){
            Drive.Set(throttle:0.75,turn:0.25);
            Scanner.Set(Me.Heading,40);
            Status.Set("SEARCH",Scanner.Last.Arc);
            return;
        }
        double power=Gun.PowerForFlightTime(target.Range,1);
        var aim=Gun.Lead(target,power);
        Gun.Aim(aim?.Heading??target.Bearing,aim?.Pitch??target.Elevation);
        if(Gun.CanFire(power,10))Gun.Fire(power);
        Drive.Set(throttle:0.5,turn:Angles.Clamp(Angles.AngleDiff(target.Bearing,Me.Heading)));
        Scanner.Set(target.Bearing,10);
        Status.Set("TRACK",target.Range);
    }
    static void Main()=>Clunkyard.Clunkyard.Run(new Bot());
}

make test SDK=... compares every API vector with the core's transcript, including exact floating-point results and act lines. The tiny robot also participates in the cross-language act identity check.

Names

Every entry of the robot API 2.0.0 in C# / .NET. names.md has every language side by side.

Download this page as Markdown