sdk.kite

Maximin pack goal + Path.to. Does not walk or attack. Ranger: pick a reachable tile that maximizes min Chebyshev to the pack while staying in [min_range, attack_range] when possible. Spec: docs/superpowers/specs/2026-08-21-sdk-kite-design.md

local M = require("sdk.kite")

Constants

Lua 5.4 has no enums — these are integer (or string) fields on the module.

Name	Value	Summary
line_clear	line_clear	True when the Chebyshev line from A to B is walkable.

to

function · to(from, opts)

Returns table|nil: hit Path.to result plus kind="kite", score, band, hold

Parameters

Name	Type	Summary
from	Pos	—
opts	table	target, pack, occupied, min_range, desired_range, attack_range, look_range, keep_distance, keep_line_of_sight, avoid_dead_ends, heading, last_goal

Returns

Type	Summary
table|nil	hit Path.to result plus kind="kite", score, band, hold
string|nil	err one of: unknown, no path, blocked