Skip to content
Browse docs

Search documentation

Release 0.2.2

Enter a topic to search.

    Extension API Workshop

    This world demonstrates machines that add-on developers can connect to WWPG 0.2.2. You can switch new sources and loads, charge storage, change transformer voltages, and try a new CEE panel indicator and PG board component. You do not need programming knowledge to operate the examples.

    The extension API is the interface developers use to add these devices. For the ordinary CEE and Power Grid equipment, use the Stationary Test Yard.

    Download and extract the example-worlds bundle. Its worlds folder contains wwpg-0.2.2-api-workshop.zip and the Pinout installation edition.

    Follow the installation guide for Minecraft 1.21.1, NeoForge 21.1.231 / 21.1.248, Java 21, Create 6.0.10-280, CEE 1.1.3, Power Grid 0.6.2, Architectury 13.0.8 and WWPG 0.2.2. Also put both example mod jars in mods from the bundle’s workshop-mods folder on the server and every client:

    • wwpg-api-example-1.0.0.jar, the new machines.
    • wwpg-upstream-api-example-1.0.0.jar, the panel and board extensions.

    These two add-ons are required for this save. Ordinary WWPG factories do not require them. The Pinout installation edition additionally requires CC:Tweaked 1.120.2 and CC;CPG: Pinout 0.2.1. Its workshop stations are the same; the computer demonstrations live in the Pinout Stationary Yard.

    Extract the save folder into your instance’s saves directory. Keep a clean copy before cutting wires or rebuilding designs. API, source and Javadoc jars are developer files; keep them out of mods.

    New players spawn on the platform at 9004, 64, 8995. The chest at 9000, 64, 8997 holds goggles, both handheld meters, cutters, spools, assembly parts and the workshop guide. Put on goggles, take both meters and walk south along the white paths. If an existing player position overrides spawn, teleport to those coordinates.

    If the PG design editor’s name field or buttons are cut off, reduce Options → Video Settings → GUI Scale. GUI Scale 2 displays the complete editor in a 1280 × 720 window.

    Each general API block has red and blue terminal markers on its north face. Red identifies the positive terminal; blue identifies the negative terminal. The upper pair is its input or primary winding. Blocks with a lower pair expose their output or secondary winding there.

    With an empty hand, right-click an example block to print its readings in chat. Hold Shift while right-clicking to change its setting. Bright block faces show that it is receiving power or holding charge. You can also read the surrounding gauges or use either handheld meter. Both mods’ wire systems connect to these devices.

    Station Device position Action and expected result
    A01 Parallel load 9006,64,9000 Sneak-click the load: two parallel resistors change between ON and practically disconnected. ON is 20 V, 0.4 A total and 8 W.
    A02 DC source 9022,64,9000 Sneak-click the gold source: the native resistor and gauge change between 20 V and zero.
    A03 AC source 9044,64,9000 Sneak-click the source: the API load lights at 50 Hz, 20 V peak, 14.14 V RMS and 4 W total.
    A04 Capacitor 9006,64,9020 Sneak-click green storage: the internal stored voltage settles from 20 to 10 V. Re-enable to charge back to 20 V. With discharge enabled, switch its gold feed OFF to drain it.
    A05 Inductor 9028,64,9020 Toggle the gold feed: accepted coil current settles between about 0.2 A and zero.
    A06 Diode 9050,64,9020 Toggle the gold feed: the forward diode powers a native resistor at about 19 V. Reversing the diode’s connections blocks that feed.
    A07 Transformer 9006,64,9040 Sneak-click copper coupling: its native output load changes between 40 and 10 V from a 20 V input.
    A08 Voltage control 9028,64,9040 Sneak-click purple control: its native output load changes between 40 V and zero.
    A09 Current control 9050,64,9040 Sneak-click orange control: its native output load changes between −20 V at 0.2 A and zero.
    A10 CEE storage indicator 9007,64,9060 Open its adjacent native feed switch: the panel light fades over a few seconds. Close it: the 70 V feed restores its light.
    A11 PG shunt board 9029,64,9060 Open/close its adjacent native feed switch: the assembled 100 Ω board and gauge change between 20 V/about 0.2 A and zero.

    AC voltage repeatedly changes direction and passes through zero. At A03, a momentary zero does not mean the power has stopped: the load can remain lit and the RMS reading shows its effective voltage. At A09, the negative voltage comes from the connection direction; the resistor still receives power. At A04, the gauge reads the external terminals while chat separately labels the capacitor’s internal stored voltage.

    A07 is an ideal transformer example. It uses a DC demonstration source to make the voltage ratios easy to read; you can substitute the AC example source to try AC operation. CEE and PG transformers keep their own electrical behavior and assembly requirements; try those in the Stationary Yard.

    Restore the gold supplies and all API block settings to enabled ON. On the green capacitor, enabled ON means its discharge resistor is disconnected. Close the native feed switches beside A10 and A11. Give the capacitor and panel indicator a few seconds to settle.

    Both mods’ cutters and spools operate on the example terminals. Reconnect matching red/blue pairs; leave lower output pairs separate from upper input pairs at A07–A09. The tool chest provides extra native panel and board components for assembly experiments. Consult the add-ons’ instructions before rebuilding their designs:

    These ideal sources and creative resistors demonstrate add-on behavior; they are not a balanced survival progression. Wires you break still drop normally. Construction debris was removed before export.

    Release-pinned source