Caff-Infint — Scripting Reference

Scripts use a Python-like syntax. Indentation is significant. Comments start with #.

Recipes are auto-generated from data/recipes.js. Adding a new recipe there automatically creates a usable script alias. The canonical alias is the snake_case version of the recipe key. Extra shorthand aliases are listed alongside.

The optional 4th argument fills all module slots of each placed building with the specified module. Modules are consumed from inventory at placement time. Buildings with no module slots (AM1, stone/steel furnace) ignore this argument.

craft(item, n) adds n copies to the unified manual craft queue. Items are crafted one at a time in order; ingredients are consumed when crafting begins.

fortify(type, n) transfers items from inventory to the perimeter. Will not exceed perimeter capacity.

Pass the exact display name or internal key. Infinite techs use the colon format.

All item counts are floored to integers. The variable name is the camelCase item key converted to SCREAMING_SNAKE_CASE.

Every inventory variable has a corresponding DELTA_* version that shows the rate of change per second (updated every 1 second). Negative values mean consumption.

These variables count how many of each placeable building item you have in your inventory. Use them to check whether you have buildings ready to place before calling place(). The INV_ prefix distinguishes them from placed building counts (e.g. ASSEMBLERS).

Count of each module type currently in your inventory (not installed in buildings). Use these to gate place() calls that require modules. The calculator's generated scripts use these automatically when a module type is selected.

Variables whose names start with MEM_ are automatically saved to the game state and persist between script executions (including Auto runs). Use them to track state across runs.

# Count how many times this script has run
MEM_RUNS = MEM_RUNS + 1
print("Run #", MEM_RUNS)

# Remember when we last needed iron
if IRON_ORE < 500:
    MEM_IRON_LOW_WAVE = BITER_WAVE
    place("miner", "iron")

Keep coal stocked and iron miners running

# Auto script — runs every 10 seconds
if COAL < 200:
    place("miner", "coal")

if MINERS_IRON < 5 and Q_miners == 0:
    place("miner", "iron", 5 - MINERS_IRON)

Research chain automation

# Unlock automation path automatically
if RED_SCIENCE > 100:
    research("automation")
if GREEN_SCIENCE > 50:
    research("logistics")
research("robot:speed")  # queues infinite tech

Defend with walls and turrets

# Fill perimeter walls first, then add gun turrets
walls_needed = PERIMETER_MAX_WALLS - PERIMETER_WALLS
if walls_needed > 0 and STONE_WALL >= walls_needed:
    fortify("walls", walls_needed)

turrets_free = PERIMETER_MAX_TURRETS - PERIMETER_GUN_TURRETS - PERIMETER_LASER_TURRETS
if turrets_free > 0 and GUN_TURRET_ITEM > 0:
    fortify("gun", turrets_free)

Persistent crafting tracker

# Craft 10 circuits, but only if queue is empty
if Q_len == 0:
    craft("circuit", 10)
    MEM_CRAFT_RUNS = MEM_CRAFT_RUNS + 1
    print("Craft batch", MEM_CRAFT_RUNS)
else:
    print("Queue busy:", Q_len, "items")

Scale mining to demand

# If iron is dropping, add a miner
if DELTA_IRON_ORE < 0 and IRON_ORE < 2000:
    place("e_drill", "iron")
    print("Added electric miner — iron rate:", DELTA_IRON_ORE)

Power shortage response

if POWER_RATIO < 0.8:
    print("Low power!", round(POWER_RATIO * 100), "%")
    if SOLAR_PANEL_ITEM > 0:
        place("solar_panel")
    elif STEAM_ENGINE_ITEM > 0:
        place("steam_engine")