SPC Core — Addon API for Stored Program Controls

SPC Core is the official addon API for Stored Program Controls. It lets mod developers create custom function block nodes that integrate seamlessly into SPC's LOGO!-inspired programming environment.

Addon mods and the main SPC mod both depend on SPC Core — install it alongside Stored Program Controls for addon support.

For Addon Developers

SPC Core provides a clean, stable API surface for extending the SPC automation system:

Custom Function Blocks — Define your own logic nodes with configurable inputs, outputs, and parameters
Six Signal Types — DIGITAL, INTEGER, DECIMAL, TEXT, ITEM, and ITEM_ID with automatic type conversion
Four-Phase Execution — Input Read → Logic Evaluation → State Update → Output Apply
Persistent Node State — Slot-based storage that survives across ticks and world saves
Palette Integration — Register nodes into custom or existing categories in the Programming Block editor
Display Name & Label Customization — Control how your nodes appear in the palette with custom display names, short labels, and descriptions
Context Extensions — Hook into world interaction, sensors, displays, and item I/O
Multiblock & Network APIs — Create nodes that interact with SPC hardware modules and networked devices

Quick Start

// 1. Declare your node schema
SpcNodeSchema schema = new SpcNodeSchema(
    ResourceLocation.fromNamespaceAndPath("myaddon", "my_node"),
    SpcExecutionPhase.LOGIC,
    List.of(inputPort, outputPort),
    List.of(),
    ISpcNodeFactory.of(MyCompiledNode::new)
);

// 2. Register during mod construction
SpcNodeRegistry.register(schema, myCategory);

Setup

Add the SPC Core jar as a compile-only dependency in your build.gradle:

dependencies {
    compileOnly files("libs/storedprogramcontrols-1.1.0-api.jar")
}

Declare the dependency in your neoforge.mods.toml:

[[dependencies.your_mod_id]]
    modId = "spc_core"
    type = "required"
    versionRange = "[1.1.0,)"
    ordering = "AFTER"
    side = "BOTH"

Full documentation and tutorials are available on the SPC Addon API Wiki.

Key Details


API Version	1.1.4
Minecraft	1.21.1
Mod Loader	NeoForge
API Jar Size	~47 KB

For Players

If you use an addon that depends on SPC Core, install both SPC Core and Stored Program Controls. SPC Core contains the shared interfaces that let addons communicate with the main mod.