The CLIPS adapter

CLIPS rules run in process through clipspy, on the installed Python binding. The robot core owns parsing, tracking, helpers and acts. Match templates and field tables are generated from protocol/v2/schema.json; every canonical query and control is a cy-* foreign function generated from protocol/v2/api.json. Install with make install SDK=/opt/clunkyard/sdk after installing Python. Run with PYTHONPATH=/opt/clunkyard/sdk/bindings/clips:/opt/clunkyard/sdk/bindings/python python3 bot.py.

(cy-me-heading) reads a property; (cy-gun-shot-speed 2.0) calls a query. A record is a multifield in its declared field order, nested records inline. A list starts with its count, followed by its records. An absent result is nil; booleans are TRUE and FALSE. A control takes its canonical field name and value: (cy-drive-set "throttle" 0.5). Bare fire uses (cy-gun-fire); getters take the field name. The generated reference gives record layouts and every callable name.

Compatibility facts include game, me, state, contact, cue, zone, storm, pickup, hill and the match's mechanics. The adapter resets the environment for each state, restores hello facts, asserts state facts and runs your rules. Globals persist between turns. Output facts drive, forces, aim, scan, fire, status, extra and forfeit remain available; later facts override earlier fields. The familiar geometry functions forward to the core. shot-damage includes the core's current damage scale and uses the current tick. Direct cy-* calls preserve canonical core semantics.

A tiny robot

Save these rules as tiny.clp:

(defrule tiny
  (state)
  =>
  (bind ?target (cy-sensors-nearest))
  (if (eq ?target nil)
    then
      (cy-drive-set "throttle" 0.75)
      (cy-drive-set "turn" 0.25)
      (cy-scanner-set "heading" (cy-me-heading))
      (cy-scanner-set "arc" 40)
      (cy-status-set "text" "SEARCH")
      (cy-status-set "value" (nth$ 3 (cy-scanner-last)))
    else
      (bind ?range (nth$ 3 ?target))
      (bind ?bearing (nth$ 4 ?target))
      (bind ?elevation (nth$ 5 ?target))
      (bind ?power (cy-gun-power-for-flight-time ?range 1))
      (bind ?aim (cy-gun-lead (expand$ ?target) ?power))
      (cy-gun-aim "heading" (if (eq ?aim nil) then ?bearing else (nth$ 1 ?aim)))
      (cy-gun-aim "pitch" (if (eq ?aim nil) then ?elevation else (nth$ 2 ?aim)))
      (if (eq (cy-gun-can-fire ?power 10) TRUE) then (cy-gun-fire "power" ?power))
      (cy-drive-set "throttle" 0.5)
      (cy-drive-set "turn" (cy-angles-clamp (cy-angles-angle-diff ?bearing (cy-me-heading)) -1 1))
      (cy-scanner-set "heading" ?bearing)
      (cy-scanner-set "arc" 10)
      (cy-status-set "text" "TRACK")
      (cy-status-set "value" ?range)))

Save the launcher as bot.py:

import clunkyard_clips
clunkyard_clips.run("tiny.clp")

run and play use Python's core session. Foreign call errors are reported after rules run; user errors preserve controls set so far. Raise a forfeit fact to give up a match. make test exercises the actual CLIPS function surface against every API vector. Non-finite inputs cannot be represented by CLIPS. Complete names.

Names

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

Download this page as Markdown