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

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.