Changelog

1.1.6 Latest

April 19, 2026

New Features

• Custom PNG icons for addon function blocks. SpcNodeSchema gains an optional iconTexture field (10th record component) accepting a ResourceLocation path string (e.g. "mymod:textures/gui/nodes/rotation_input.png"). When set, the programming editor renders the texture inside the block body and inside the palette glyph instead of falling back to the shortLabel text. Recommended texture size: 16×16 or 32×32 PNG in the addon’s resource namespace.
• Custom Python builtins for the Embedded Python block. New com.hypernova.spc.api.python package lets addons register named callables that become available to every Embedded Python block in every program. Use this for Create speed/stress sensors, Mekanism gas readouts, config-aware math helpers, or any read-only world inspection.

Code Examples

Adding a custom block icon:

SpcNodeSchema schema = new SpcNodeSchema(
    typeId,
    SpcExecutionPhase.LOGIC_EVAL,
    inputPorts,
    outputPorts,
    parameters,
    /* requiresDisplay */ false,
    "Rotation Input",                 // displayName
    "RIN",                            // shortLabel
    "Reads Create rotation speed.",   // description
    "RI",                             // labelPrefix
    "createspc:textures/gui/nodes/rotation_input.png" // iconTexture (NEW in 1.1.6)
);

Backwards compatible: the existing 5-arg, 8-arg, and 9-arg SpcNodeSchema constructors continue to work unchanged (iconTexture defaults to null). Use schema.hasIcon() to check whether a custom texture was provided.

Registering a custom Python builtin:

// In your @Mod constructor or FMLCommonSetupEvent:
SpcPythonBuiltinRegistry.register("create_speed", args -> {
    if (args.isEmpty()) return SpcPythonValue.ofFloat(0.0);
    long shaftId = args.get(0).asLong();
    double rpm = MyCreateBridge.lookupSpeed(shaftId);
    return SpcPythonValue.ofFloat(rpm);
});

SpcPythonBuiltinRegistry.register("clamp01", args -> {
    double v = args.isEmpty() ? 0.0 : args.get(0).asDouble();
    return SpcPythonValue.ofFloat(Math.max(0.0, Math.min(1.0, v)));
});

Players can then call these from any Embedded Python block:

# Inside an Embedded Python block in the LOGO editor:
rpm = create_speed(101)
duty = clamp01(rpm / 256.0)
print("duty:", duty)

API Surface

Reserved Builtin Names

These names are reserved for the Embedded Python runtime and cannot be registered by addons (registration throws IllegalArgumentException):

input, print, bool, int, float, str, abs, min, max, len, set_signal_type.

Identifier validation also rejects names that aren’t valid Python identifiers, and registering the same name twice throws IllegalStateException. The registry freezes during FMLCommonSetupEvent — late registration also throws IllegalStateException.

Bug Fixes (runtime jar 0.3.0)

• Fixed “done is not defined” NameError (and related NameErrors) in Embedded Python blocks where a global declaration referenced a matching Bool/Int/Float/String Variable node on the same program. Variable defaults are now seeded into the committed marker maps at program-load time, so Python sees a defined value on tick 1. NBT-restored state is preserved (putIfAbsent semantics).
• Variable nodes with disconnected inputs no longer overwrite a matching Python global’s same-tick write — the pending-value write is now gated on input presence.

Upgrade Steps

1. Replace storedprogramcontrols-1.1.5-api.jar with storedprogramcontrols-1.1.6-api.jar in your libs/ folder.
2. Update build.gradle: compileOnly files('libs/storedprogramcontrols-1.1.6-api.jar')
3. Update neoforge.mods.toml: versionRange="[1.1.6,)" (only if you actually use iconTexture or the Python builtin API — older addons keep working against the 1.1.6 runtime jar).
4. Replace the runtime jar in run/mods/ with storedprogramcontrols-0.3.0.jar.

1.1.5

April 17, 2026

New Features

• Guide Book API (Patchouli integration). Addons can register categories and entries that appear in the in-game LOGO Guide Book without having to ship Patchouli JSON files. Content is served via an in-memory resource pack injected through AddPackFindersEvent.
• Multi-addon safety. Duplicate category/entry IDs are handled gracefully — first registration wins, subsequent duplicates log a warning and are skipped. Unknown category references are logged as warnings at freeze time but do not prevent entries from being included.

Code Example

// In your @Mod constructor:
SpcGuideBookRegistry.registerCategory(new SpcBookCategory(
    ResourceLocation.parse("createspc:rotation"),
    "Create Integration",
    "Rotation, stress, speed sensors and outputs.",
    "createspc:textures/gui/book/rotation_icon.png",
    100,
    null   // no parent
));

SpcGuideBookRegistry.registerEntry(new SpcBookEntry(
    ResourceLocation.parse("createspc:rotation_input"),
    "Rotation Input",
    "createspc:textures/gui/nodes/rotation_input.png",
    ResourceLocation.parse("createspc:rotation"),
    10,
    false,
    List.of(
        SpcBookPage.text("Reads RPM from a Create rotation shaft beneath the block."),
        SpcBookPage.spotlight("createspc:rotation_input_block", "Place this block on a shaft.")
    )
));

API Surface

Upgrade Steps

1. Replace storedprogramcontrols-1.1.4-api.jar with storedprogramcontrols-1.1.5-api.jar in your libs/ folder.
2. Update build.gradle: compileOnly files('libs/storedprogramcontrols-1.1.5-api.jar')
3. Update neoforge.mods.toml: versionRange="[1.1.5,)" (only if you use the Guide Book API).

1.1.4

April 11, 2026

New Features

• Custom node label prefixes for addon nodes. SpcNodeSchema now accepts an optional labelPrefix field. When set, the programming editor displays labelPrefix + channel (e.g. “RI1”, “RQ2”) instead of the generic “B001” label. This gives addon I/O nodes proper PLC-style labels.

Bug Fixes

• Port signal type mismatch no longer blocks simulation. If an addon changes a port’s signal type between versions, existing saved programs would fail validation with a blocking error. This is now a warning with an actionable message (“Re-place the node to update”).

API Changes

Upgrade Steps

1. Replace storedprogramcontrols-1.1.3-api.jar with storedprogramcontrols-1.1.4-api.jar in your libs/ folder.
2. Update build.gradle: compileOnly files('libs/storedprogramcontrols-1.1.4-api.jar')
3. Update neoforge.mods.toml: versionRange="[1.1.4,)"
4. Replace the runtime jar in run/mods/ with the latest storedprogramcontrols-0.2.0.jar.

1.1.3

April 11, 2026

New Features

• Full multiblock connected textures for addon blocks. The MultiblockPosition enum (with its MB_POS block state property) is now included in the API jar. Addon blocks that register MB_POS in their createBlockStateDefinition() will automatically receive position-aware connected textures when the LOGO multiblock forms — borders are removed on internal seams, just like built-in blocks. Provide blockstate JSON variants for each (facing, mb_pos) combination and matching models.

New API Exports

Upgrade Steps

1. Replace storedprogramcontrols-1.1.2-api.jar with storedprogramcontrols-1.1.3-api.jar in your libs/ folder.
2. Update build.gradle: compileOnly files('libs/storedprogramcontrols-1.1.3-api.jar')
3. Update neoforge.mods.toml: versionRange="[1.1.3,)"
4. Replace the runtime jar in run/mods/ with the latest storedprogramcontrols-0.2.0.jar.

1.1.2

April 11, 2026

New Features

• Connected texture API for addon display blocks. New ISpcConnectedDisplay interface allows addon blocks to participate in the LOGO multiblock connected texture system. Implement this on your block class and return the display facing direction via getDisplayFacing(BlockState). SPC’s built-in display blocks (and other addons) will recognize your block as a valid texture neighbor and connect accordingly.
• Live Diagnostics Panel API for addon modules. New ISpcDiagnosticsProvider interface allows addon block entities to contribute custom entries to the Live Diagnostics Panel. Implement this on your BlockEntity and return SpcDiagnosticEntry instances with a label, value, and active flag. Entries appear in a dedicated “Addon” section of the diagnostics overlay.

New API Classes

Upgrade Steps

1. Replace storedprogramcontrols-1.1.1-api.jar with storedprogramcontrols-1.1.2-api.jar in your libs/ folder.
2. Update build.gradle: compileOnly files('libs/storedprogramcontrols-1.1.2-api.jar')
3. Update neoforge.mods.toml: versionRange="[1.1.2,)"
4. Replace the runtime jar in run/mods/ with the latest storedprogramcontrols-0.2.0.jar.

1.1.1

April 11, 2026

Bug Fixes

• Addon blocks now recognized by multiblock validator. LogoMachineBlocks.isMachineBlock() and getModuleType() previously only checked for the internal LogoModuleProvider interface. Blocks implementing the public API interface ISpcMultiblockModule were invisible to both BFS structure discovery and type validation. The multiblock always reported “Missing Input Block” / “Missing Output Block” even when addon blocks were placed correctly.

Details

Both isMachineBlock() and getModuleType() now have a fallback path: if a block is not a built-in LogoModuleProvider, the methods check for ISpcMultiblockModule, look up the registered SpcModuleType from SpcModuleTypeRegistry, and map the declared SpcMultiblockPosition to the corresponding internal LogoModuleType.

No addon-side code changes are required. Just update your dependency version range to [1.1.1,) and replace the API jar.

Upgrade Steps

1. Replace storedprogramcontrols-1.1.0-api.jar with storedprogramcontrols-1.1.4-api.jar in your libs/ folder.
2. Update build.gradle: compileOnly files('libs/storedprogramcontrols-1.1.4-api.jar')
3. Update neoforge.mods.toml: versionRange="[1.1.1,)"
4. Replace the runtime jar in run/mods/ with the latest storedprogramcontrols-0.2.0.jar.

1.1.0

April 11, 2026 — Initial public release

Features

• Custom function block nodes — Register addon nodes via SpcNodeSchema, ISpcCompiledNode, and SpcNodeRegistry.
• Six signal types — DIGITAL, INTEGER, DECIMAL, TEXT, ITEM, ITEM_ID with automatic type conversion.
• Four-phase execution model — Input Read → Logic Evaluation → State Update → Output Apply.
• Persistent node state — Slot-based storage that survives across ticks and world saves.
• Palette customization — displayName, shortLabel, and description fields on SpcNodeSchema for controlling how addon nodes appear in the editor.
• Multiblock module API — ISpcMultiblockModule, SpcModuleType, SpcModuleTypeRegistry, ISpcPhysicalIoHandler for addon blocks that participate in the LOGO multiblock structure.
• Network device API — ISpcNetworkDevice, ISpcNetworkActivation, ISpcCableTraversable, SpcNetworkRegistry.
• Runtime event API — ISpcRuntimeEventListener, SpcRuntimeEventRegistry for hooking into program lifecycle events.
• Context extensions — ISpcExecutionContextExtension for injecting custom world interaction capabilities into the execution context.
• Custom palette categories — Organize addon nodes under named categories in the Programming Block editor.