Kotlin on the Java binding

Kotlin calls the arena's generated Java core binding directly. Import clunkyard.*; the robot API and C ABI conversion live in the same clunkyard.jar as Java, with no second implementation or copied SDK.

Compile with kotlinc Bot.kt -cp /opt/clunkyard/sdk/bindings/java/clunkyard.jar -include-runtime -d bot.jar. Run with java --enable-native-access=ALL-UNNAMED -cp bot.jar:/opt/clunkyard/sdk/bindings/java/clunkyard.jar BotKt. The jar loads libclunkyard.so.2, or the file named by CLUNKYARD_LIB.

Subsystems and facts are methods, and absent results use Java Optional, OptionalDouble or OptionalInt. Controls take their fields in order or a builder such as Drive.throttle(0.5).turn(0.2). Fields merge within a turn. Throw Forfeit(code, message) to forfeit; other exceptions are logged and send the controls already set. Clunkyard.play plays lines in memory.

A tiny robot

import clunkyard.*

class Bot : Robot() {
    override fun onTurn() {
        val target = sensors().nearest().orElse(null)
        if (target == null) {
            drive().set(Drive.throttle(0.75).turn(0.25))
            scanner().set(me().heading(), 40.0)
            status().set("SEARCH", scanner().last().arc())
            return
        }
        val power = gun().powerForFlightTime(target.range(), 1.0)
        val aim = gun().lead(target, power).orElse(null)
        if (aim == null) gun().aim(target.bearing(), target.elevation())
        else gun().aim(aim.heading(), aim.pitch())
        if (gun().canFire(power, 10.0)) gun().fire(power)
        drive().set(Drive.throttle(0.5).turn(angles().clamp(angles().angleDiff(target.bearing(), me().heading()))))
        scanner().set(target.bearing(), 10.0)
        status().set("TRACK", target.range())
    }
}
fun main() = Clunkyard.run(Bot())

make test SDK=... compiles Kotlin against the shared binding and runs its full API conformance transcript. The README robot is also compared with the other bindings' examples, act for act.

Names

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

Download this page as Markdown