StationeersLua [StationeersLaunchPad]

StationeersLua

Lua scripting support for Stationeers programmable chips

Write automation in Lua 5.2 instead of IC10 — tables, functions, coroutines. Server-authoritative multiplayer.

[hr][/hr]

v1.0 highlights

• ic.disk portable UTF-8 storage on vanilla Data Disks, plus a craftable Configuration Disk for ScriptedScreens config mode. Labeller names print on the disk model.
• Wireless Data Access Point structure (replaces the old omni transmitter patch). Suit Networking Module and personal area network (PAN) for local worn-gear chip links without a remote wireless hop.
• ic.timer scheduler (every / cron / in_seconds), full FR/DE in-game Lua reference parity, improved Lua auto-indent, and cleaner pack_ascii6 behavior.

Editor, reference, and optional MCP

Searchable in-game Lua reference when Lua formatting is active, Lua auto-indent in IC10Editor, sleep/yield inside tick() plus user coroutines, find/find_all with optional glob/regex modes, and Lua in pipe device hosts and suit housings. Optional in-game MCP and REST (off by default) pair with the StationeersLua VS Code extension when you enable Enabled / EnableExtensionApi; EnableExperimentalDebugger unlocks the VS Code debug adapter. Multiplayer can use an optional debug proxy on private servers.

Wireless suit and tablets

Wireless Development Board EVA suit module: pick powered Wireless Data Access Point networks, mesh handoff, reconnect grace, small extra suit drain while linked (Allow network chip access must be on). Optional Suit Networking Module for local PAN between worn Lua gear. Lua chips in suit IC slots and the Survival Toolbelt share the board wireless data network when available. ic.wireless from suit chips, belt chips, or ScriptedScreens wireless cartridges lists, connects, or disconnects the wireless data link in Lua.

Requirements

• BepInEx 5.x
• StationeersLaunchPad
• IC10Editor (Steam) — recommended

[hr][/hr]

Lua chip & sandbox

Integrated Circuit (Lua) in any IC housing. Default instruction limits: 500,000 init, 50,000/tick (server/host can change Lua VM mod config). No arbitrary filesystem or process access. Standard libraries: math, string, table, coroutine, utf8, pcall/xpcall, JSON, optional HTTP. UTF-8 Unicode in source through editor, save, and network.

Devices & memory

• Read/write logic, slots, reagents, device memory by pin or ReferenceId; batch read/write across all devices of a type (Average, Sum, Min, Max)
• Label devices, device_list, prefab/name hashes, 512-word chip memory, IC10-compatible stack, 53-bit bitwise ops

Inter-chip networking

On the same data cable network: direct send/receive, broadcast, pub/sub with wildcards + retained messages + TTL, RPC with timeouts, MessagePack pack/unpack.

Library chips & persistence

Library chips (--@module name) expose require("name") to other chips on the network (compiled into the caller). Auto-save source + registers/stack/memory; optional serialize/deserialize for custom state blobs.

Events

ic.events.on / off for custom events (e.g. ScriptedScreens UI) dispatched at the start of each tick.

In-game debugger

Motherboard (Lua Debugger) on the data network inspects live Lua chips: errors, tracebacks, memory, logs, and quick editor access.

IC10 editor integration

Lua syntax highlighting; open the ? panel to disable script/line caps for long scripts.

[hr][/hr]

🚀 Quick start

[olist] [*] Install BepInEx, LaunchPad, IC10Editor; subscribe here [*] Craft Integrated Circuit (Lua), insert in IC housing, open editor, paste: [/olist] Quick sample: a short while-loop toggles pin d0 every second using logic enums and sleep(1). A paste-ready listing ships in GUIDE.MD.

[hr][/hr]

IC10 → Lua

[table][tr][th]IC10[/th][th]Lua[/th][/tr] [tr][td]l r0 d0 Temperature[/td][td]read(0, LT.Temperature)[/td][/tr] [tr][td]s d0 On 1[/td][td]write(0, LT.On, 1)[/td][/tr] [tr][td]lb r0 HASH("GasSensor") Temperature 2[/td][td]batch_read(hash("GasSensor"), LT.Temperature, LBM.Average)[/td][/tr] [tr][td]sleep 5[/td][td]sleep(5)[/td][/tr] [tr][td]push 42 / pop r0[/td][td]stack_push(42) / stack_pop()[/td][/tr] [/table] Locals, tables, and functions replace register gymnastics.

[hr][/hr]

ScriptedScreens

ScriptedScreens — Lua-driven touch UIs on consoles/tablets; requires StationeersLua.

[hr][/hr]

Documentation

• 📖 Online documentation — full API + guides
• GUIDE.MD (beginner walkthrough) and MAPPING.MD (IC10 line-by-line) ship with the mod

[hr][/hr]

VS Code extension (separate install)

Install the StationeersLua VS Code extension (pair with EnableExtensionApi): Chip Explorer groups chips by data network, explicit Export compiles to the chip, metadata-only auto refresh, conflict-aware pulls using per-chip source_version, and debug actions when EnableExperimentalDebugger is on in the game.