Electrical Age API Example

Example Forge 1.7.10 mod for exercising the Electrical Age public API from Kotlin.

This repository is meant for API development and validation. It contains small, focused blocks that each cover part of the integration surface and make regressions visible quickly in-game.

Included Examples

• API Test Block: basic power load exposure
• Placement Resistor: oriented two-terminal 200 ohm resistor
• Signal Voltage Display: reads a signal wire and renders the voltage on top of the block
• Fixed Signal Source: outputs a constant 3.3V signal
• Fixed Voltage Source: outputs a constant 240V power voltage
• Signal Bus Monitor: renders a 4x4 top-face grid from signal bus channel voltages

All example blocks are grouped under the Electrical Age API Tests creative tab.

Developer Setup

This project uses a checked-in local Electrical Age API jar from libs/Eln-1.24.7-api.jar. The current dependency is declared in dependencies.gradle.

When the API changes:

1. Build a fresh deobfuscated API jar.
2. Replace the jar in libs/.
3. Update the filename in dependencies.gradle if needed.
4. Update the canonical API documentation in the Electrical Age repo: docs/electrical-api-v1.md.
5. Rebuild this example mod and retest the affected example blocks.

Build And Run

• Compile: ./gradlew compileKotlin compileJava
• Run client: ./gradlew runClient

Waila is included as a compile-only dependency. The mod still loads without Waila present at runtime.

Project Layout

• src/main/kotlin/mods/elnapi: mod code and example blocks
• src/main/kotlin/mods/elnapi/client: client-side renderers
• src/main/kotlin/mods/elnapi/integration/waila: Waila integration
• src/main/resources/assets/elnapitest: lang and textures
• Canonical API docs: https://github.com/age-series/ElectricalAge/blob/main/docs/electrical-api-v1.md