> Plugin API and runtime bridge library for **AE2 Lightning Tech (AE2LT)**. Lets your mod integrate deeply with AE2LT’s lightning energy network **without ever touching its internal classes**.<\/p>\n
Thunderbolt_lib is a **required dependency** for any third-party plugin that extends, modifies, or hooks into AE2LT’s lightning system. It ships no items, blocks, or recipes of its own \u2014 only frozen public APIs, NeoForge capability contracts, recipe builders, and a reflective runtime bridge that degrades gracefully when AE2LT itself is absent.<\/p>\n
## Why download this?<\/p>\n
– **Players \/ modpack authors** \u2014 if a mod or modpack lists `ae2lt_api` as a dependency, install this jar alongside AE2 Lightning Tech.
\n– **Plugin developers** \u2014 depend on this library to access AE2LT’s machines, recipe types, and lightning energy capabilities **without coupling to AE2LT’s internal classes**.<\/p>\n
> **Important:** Thunderbolt_lib only does meaningful work when AE2 Lightning Tech is installed in the same Minecraft instance. Both mods must be present.<\/p>\n
## Target<\/p>\n
| | |
\n|—|—|
\n| Minecraft | 1.21.1 |
\n| Loader | NeoForge 21.1.x |
\n| Java | 21 |
\n| Targets | AE2 Lightning Tech (backwards-compatible since AE2LT introduced its lightning network) |
\n| Runtime mod ID | `ae2lt_api` |<\/p>\n
The project is presented as Thunderbolt_lib, but registers under `ae2lt_api`, so existing plugin dependency declarations are unaffected.<\/p>\n
## What it provides<\/p>\n
### Lightning energy capability<\/p>\n
Make your blocks and items first-class citizens of the AE2LT lightning network. `ILightningEnergyHandler` is exposed via two NeoForge capabilities \u2014 `LIGHTNING_ENERGY_BLOCK` (sided) and `LIGHTNING_ENERGY_ITEM` (void) \u2014 implement the interface and register it to participate in reads and writes. All quantities are expressed as `long`, scaling cleanly from a single machine to network-wide accounting.<\/p>\n
### Lightning energy tier<\/p>\n
A unified two-tier voltage definition that flows losslessly across API surfaces. `LightningEnergyTier` is a two-value enum (`HIGH_VOLTAGE` \/ `EXTREME_HIGH_VOLTAGE`), and ships with:<\/p>\n
– `CODEC` \u2014 Mojang `Codec It shares its on-the-wire format with AE2LT’s own `LightningTier`, so packets and NBT round-trip cleanly between the two APIs without any hand-written adapter.<\/p>\n ### Reflective runtime bridge<\/p>\n Won’t crash when AE2LT is missing \u2014 just degrades gracefully. Instead of hard-referencing AE2LT’s classes at load time, this library probes them reflectively at runtime and wires the lightning energy capability onto the five grid-connected block entities AE2LT publicly registers:<\/p>\n – `ae2lt:lightning_collector` > `ae2lt:crystal_catalyzer` runs on FE only, does not participate in the lightning energy network, and is intentionally excluded.<\/p>\n ### Frozen ID constants<\/p>\n Reference AE2LT’s registry IDs without dragging its main jar onto your compile path. Two `ResourceLocation` constant sets collect everything in one place:<\/p>\n – `AE2LTBlockEntityIds` \u2014 AE2LT’s block-entity IDs, plus `LIGHTNING_GRID_MEMBERS` (the list of the five grid-connected machines above) Both live in `com.qianchang.ae2lt_api.api.ids`. If AE2LT later renames any internal resource, the patch lands here so plugins don’t have to chase it.<\/p>\n ### Native API detection bridge<\/p>\n Lets both API surfaces coexist in your mod, leaving you in control of which one to call. `com.qianchang.ae2lt_api.api.bridge.AE2LTNativeBridge` checks at runtime whether AE2LT’s first-party API package (`com.moakiee.ae2lt.api`, namespace `ae2lt`) is loaded.<\/p>\n | Surface | This library | AE2LT first-party | The two API surfaces are **deliberately namespace-distinct**; this library performs no implicit conversion between them, so callers explicitly choose which side to use.<\/p>\n ### Events<\/p>\n Intercept lightning collection and apply your own conditional logic. `LightningCollectedEvent` is fired when an AE2LT collector picks up lightning energy. The event is cancellable and exposes `isNaturalWeather()` (to distinguish a true thunderstorm from a machine-induced strike) along with the matching 5-argument constructor; the original 4-argument constructor is preserved with `naturalWeather` defaulted to `false`, so migration is painless.<\/p>\n ### Recipe builders<\/p>\n Generate schema-compliant JSON for all six AE2LT recipe types \u2014 **drop them straight into your data generation pipeline**:<\/p>\n | Builder | Recipe type | `CrystalCatalyzerRecipeBuilder` additionally supports `dustMode()` and `outputTag(…)`, matching AE2LT’s `crystal_catalyzer\/dust\/*.json` schema.<\/p>\n ### Plugin loading & API facade<\/p>\n Unified registration callbacks, no hand-rolled NeoForge lifecycle wiring. Plugin discovery runs through `@AE2LTPlugin`, `IAE2LTPlugin`, and Java `ServiceLoader`; the static facade `AE2LTAPI` collects the API version, capability handles, and bridge utilities into a single entry point you can pull in with one `import static` and use across your codebase with minimal boilerplate.<\/p>\n ## Adding as a dependency<\/p>\n Plugin developers \u2014 declare both `ae2lt_api` (this library) and `ae2lt` (the main mod) as required in your `neoforge.mods.toml`:<\/p>\n “`toml [[dependencies.your_mod_id]] Set the lower bound of `versionRange` to the minimum version your plugin actually supports.<\/p>\n ## Feedback<\/p>\n Bug reports and suggestions are welcome on the [project issue tracker. When reporting an issue, please include the versions of Minecraft, NeoForge, AE2 Lightning Tech, and Thunderbolt_lib you are running \u2014 it makes reproduction and triage much faster.<\/p>\n ## Source, changelog, releases<\/p>\n – **Source code** \u2014 github.com\/QianChang-official\/Thunderbolt_lib ## Credits<\/p>\n Maintained and developed by QianChang.<\/p>\n Special thanks to the **AE2 Lightning Tech** team \u2014 MOAKIEE, CystrySU, gjmhmm8, _leng, TedXenon, and MHanHanBing \u2014 for publishing clear, stable registry IDs and recipe schemas that make this bridge possible.<\/p>\n Thanks also to the **Applied Energistics 2** team \u2014 without AE2 there would be no AE2LT, and no reason for this bridge to exist.<\/p>\n This name is used for non-commercial community purposes only. If any rights holder considers the name to be infringing or unsuitable, please contact the maintainer and it will be changed promptly.<\/p>\n Full notice \u2014 DISCLAIMER.md<\/p>\n<\/details>\n","protected":false},"excerpt":{"rendered":" Thunderbolt_lib is the addon API and runtime bridge library for AE2 Lightning Tech.<\/p>\n","protected":false},"featured_media":156145,"template":"","meta":{"_minecraft_slug":"thunderbolt_lib","_minecraft_project_id":"g9oaYcWN","_minecraft_author":"QianChang-official","_minecraft_license":"MIT","_minecraft_downloads":11,"_minecraft_follows":0,"_minecraft_client_side":"required","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"thunderbolt_lib.zip","_minecraft_size_bytes":290885,"_minecraft_version_count":6,"_minecraft_updated_at":"2026-05-16T12:21:36.690353Z","_minecraft_date_created":"2026-05-12T06:06:15.565788Z","_minecraft_date_modified":"2026-05-06T15:21:09.136852Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/thunderbolt_lib","_minecraft_icon_attachment_id":156145,"_minecraft_imported_at":"2026-06-09T12:23:35+00:00","_minecraft_import_hash":"f704ec38fbefada48222e49fe12ac52c","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[873,158],"mod_loader":[160],"minecraft_version":[37],"class_list":["post-156144","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-library","mod_category-neoforge","mod_loader-neoforge","minecraft_version-1-21-1"],"yoast_head":"\n
\n– `STREAM_CODEC` \u2014 vanilla `StreamCodec
\n– `fromOrdinal(int)` \u2014 ordinal-based static decoder<\/p>\n
\n– `ae2lt:lightning_simulation_room`
\n– `ae2lt:lightning_assembly_chamber`
\n– `ae2lt:overload_processing_factory`
\n– `ae2lt:tesla_coil`<\/p>\n
\n– `AE2LTRecipeIds` \u2014 AE2LT’s recipe-type IDs<\/p>\n
\n|—|—|—|
\n| Java package | `com.qianchang.ae2lt_api.api.*` | `com.moakiee.ae2lt.api.*` |
\n| Namespace | `ae2lt_api` | `ae2lt` |
\n| Capability ID | `ae2lt_api:lightning_energy` | `ae2lt:lightning_energy` |<\/p>\n
\n|—|—|
\n| `LightningAssemblyRecipeBuilder` | `ae2lt:lightning_assembly` |
\n| `LightningTransformRecipeBuilder` | `ae2lt:lightning_transform` |
\n| `LightningSimulationRecipeBuilder` | `ae2lt:lightning_simulation` |
\n| `OverloadProcessingRecipeBuilder` | `ae2lt:overload_processing` |
\n| `CrystalCatalyzerRecipeBuilder` | `ae2lt:crystal_catalyzer` |
\n| `LightningStrikeRecipeBuilder` | `ae2lt:lightning_strike` |<\/p>\n
\n[[dependencies.your_mod_id]]
\n modId = “ae2lt_api”
\n type = “required”
\n versionRange = “[1.0.0,)”
\n ordering = “AFTER”
\n side = “BOTH”<\/p>\n
\n modId = “ae2lt”
\n type = “required”
\n versionRange = “1.0.0,)”
\n ordering = “AFTER”
\n side = “BOTH”
\n“`<\/p>\n
\n– **Changelog** \u2014 CHANGELOG.md
\n– **GitHub releases (jar mirror)** \u2014 all releases<\/p>\nDisclaimer<\/b><\/summary>\n