Game Constants

World Size1024×1024

Radar Range300 units

Max Speed4 units/tick

Boost Speed8 units/tick

Boost Duration500ms

Boost Cooldown5000ms

Shield DurationWhile active

Tick Rate50ms (20 FPS)

Weapon Stats

Bullet

Damage12

Range500 units

Cooldown280ms

Missile

Damage22

Range700 units

Cooldown1800ms

SpecialAuto-tracks!

Shotgun

Damage7×5 pellets

Range220 units

Cooldown700ms

Laser

Damage10

Range900 units

Cooldown1200ms

Movement

forward(power)

Move forward. power: 0-1 (default: 1)

reverse(power)

Move backward. power: 0-1 (default: 1)

turnLeft(deg)

Turn left. deg: degrees (default: 5)

turnRight(deg)

Turn right. deg: degrees (default: 5)

strafeLeft(power)

Strafe left. power: 0-1

strafeRight(power)

Strafe right. power: 0-1

brake(power)

Apply brakes. power: 0-1

boost()

Speed boost (has cooldown of 5000ms)

setTargetAngle(angle)

Set target angle to rotate towards automatically

turnTowards(x, y)

Turn towards specific coordinates

Sensors

getX()

Get ship X position (0-1024)

getY()

Get ship Y position (0-1024)

getAngle()

Get ship angle in degrees (0-360)

getHealth()

Get ship health (0-100)

getSpeed()

Get current velocity

getAngularMomentum()

Get rotation speed

getBoostCooldown()

Get boost cooldown remaining in ms

getShieldEnergy()

Get shield energy (0-100)

getState()

Returns complete ship state: {x, y, angle, health, speed, shieldEnergy, shieldActive, boostActive, cooldowns}

getMapZone()

Returns current map zone (3×3 grid): {x: 0-2, y: 0-2, id: 0-8}

Enemy Detection

enemyVisible()

Returns true if any enemy is within radar range (300 units)

enemyX()

Get nearest visible enemy X position. Returns -1 if not visible

enemyY()

Get nearest visible enemy Y position. Returns -1 if not visible

enemyAngle()

Angle to nearest enemy (handles toroidal wrapping). Returns -1 if not visible

enemyAngleDiff()

Returns angle difference to enemy. Positive = turn right, Negative = turn left. Returns null if not visible

enemyDistance()

Distance to nearest enemy (toroidal). Returns -1 if not visible

deltaX()

Returns shortest X distance to enemy (can be negative). Handles world wrap. Returns null if not visible

deltaY()

Returns shortest Y distance to enemy (can be negative). Handles world wrap. Returns null if not visible

getEnemies()

Get array of all visible enemies: [{x, y, distance, angle, deltaX, deltaY}]

Weapons

fire()

Fire a standard bullet. Damage: 12, Range: 500, Cooldown: 280ms

fireMissile()

Fire a homing missile. Auto-tracks enemy! Damage: 22, Range: 700, Cooldown: 1800ms

fireShotgun()

Fire 5 spread pellets. Damage: 7×5, Range: 220, Cooldown: 700ms

fireLaser()

Fire instant laser beam. Damage: 10, Range: 900, Cooldown: 1200ms

getWeaponCooldown(weaponType)

Returns remaining cooldown in ms. weaponType: "bullet", "missile", "shotgun", or "laser"

Defense

activateShield()

Activate shield (consumes 2 energy per tick while active)

getShieldEnergy()

Get shield energy (0-100). Regenerates when not active

Obstacle Detection

getObstacles(range = 500)

Returns nearby obstacles sorted by distance: [{x, y, radius, distance, angle}]

obstacleAhead()

Returns true if obstacle is in front (within 30° and 100 units)

nearestObstacle()

Get nearest obstacle info: {x, y, radius, distance, angle}

Events

onEnemySpotted(callback)

Triggered when enemy enters radar range. callback: function to execute

onLowHealth(callback)

Triggered when health drops below 30%. callback: function to execute

onBulletNear(callback)

Triggered when enemy projectile is within 150 units. callback(bullet): receives bullet info {x, y, angle, distance, type}

onCooldownReady(callback)

Triggered when any weapon is ready. callback(weaponType): receives weapon name

State & Memory

getState()

Returns complete ship state: {x, y, angle, health, speed, shieldEnergy, shieldActive, boostActive, cooldowns}

getMemory()

Get persistent memory object for storing custom data between ticks

getTick()

Get current game tick number

getTime()

Get elapsed time in seconds

Utilities

log(...args)

Log to game console. Supports all data types

min(a, b)

Returns minimum of two values

max(a, b)

Returns maximum of two values

abs(n)

Returns absolute value

sqrt(n)

Returns square root

sin(deg)

Sin of angle in degrees

cos(deg)

Cos of angle in degrees

atan2(y, x)

Atan2 returning degrees (0-360)

random()

Random number 0-1

floor(n)

Round down

ceil(n)

Round up

round(n)

Round to nearest integer

clamp(val, min, max)

Clamp value between min/max

lerp(a, b, t)

Linear interpolation between a and b by t

distance(x1, y1, x2, y2)

Distance between points (handles toroidal wrapping)

angleTo(x1, y1, x2, y2)

Angle from point to point (handles toroidal wrapping)