F# on the .NET binding

F# calls the shared generated net8.0 assembly, Clunkyard.dll. There is no separate F# API implementation. Reference /opt/clunkyard/sdk/bindings/csharp/Clunkyard.dll with Private=false when compiling. Run with dotnet /opt/clunkyard/sdk/bindings/csharp/host/Clunkyard.Host.dll bot.dll. The SDK host loads the binding from the image. It loads the native core as libclunkyard.so.2, or CLUNKYARD_LIB.

Subsystems and facts are properties. Optional records are null; optional scalars use Nullable. Controls accept nullable fields so omitted fields keep earlier values in the turn. Use named arguments to change one field. Raise Forfeit(code, message) to forfeit; other exceptions are logged and send the controls already set. Clunkyard.Play plays lines in memory.

A tiny robot

module Bot
open System
open Clunkyard
let n (value:double)=Nullable value

type Tiny() =
    inherit Robot()
    override this.OnTurn() =
        let target=this.Sensors.Nearest
        if isNull target then
            this.Drive.Set(throttle=n 0.75,turn=n 0.25)
            this.Scanner.Set(n this.Me.Heading,n 40.0)
            this.Status.Set("SEARCH",n this.Scanner.Last.Arc)
        else
            let power=this.Gun.PowerForFlightTime(target.Range,1.0)
            let aim=this.Gun.Lead(target,power)
            let heading,pitch=if isNull aim then target.Bearing,target.Elevation else aim.Heading,aim.Pitch
            this.Gun.Aim(n heading,n pitch)
            if this.Gun.CanFire(power,10.0) then this.Gun.Fire(n power)
            this.Drive.Set(throttle=n 0.5,turn=n(this.Angles.Clamp(this.Angles.AngleDiff(target.Bearing,this.Me.Heading))))
            this.Scanner.Set(n target.Bearing,n 10.0)
            this.Status.Set("TRACK",n target.Range)

[<EntryPoint>]
let main _ =
    Clunkyard.Clunkyard.Run(Tiny())
    0

make test SDK=... compiles the F# entry point against the shared assembly and runs its full API conformance transcript. The README example is also compared with other language bindings, act for act.

Names

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

Download this page as Markdown