RaishxCore

RaishxCore is the shared foundation library behind advanced AE2-oriented addons on Minecraft 1.21.1 / NeoForge. It is not a standalone content mod: install it when another mod, such as UFO Future, requires it.

RaishxCore 0.1.0 is in public beta. Its stable contracts are ready for consumers; APIs explicitly marked experimental may continue to evolve before 1.0.

✨ What it provides

• Exact high-scale amounts using BigInteger, with safe serialization and human-friendly formatting for values beyond normal integer limits.
• Multiblock contracts for immutable structures, tier definitions, orientations, runtime state, visual effects, and validation.
• Transactional ports for items, fluids, chemicals, energy, and coolant: simulate, plan, commit, or roll back without duplicating or losing resources.
• Reusable AE2-style UI widgets for addon menus and client-side controls.
• Guarded machine networking with server-side validation and per-player action rate limits.
• AE2 crafting support for shared CPU capacity, crafting infrastructure, revisions, and a cooperative graph-capture pipeline.

🧠 Cooperative AE2 planning

RaishxCore can integrate an iterative planner with AE2. Graph capture is split into bounded server-thread slices and shared per-tick budgets, so a large grid does not monopolize a tick. The planner has cancellation, backpressure, per-grid circuit breaking, diagnostics, and a configuration kill-switch that hands new requests back to AE2's built-in planner.

This is intended for addon authors and modpacks that need extreme crafting-scale infrastructure—not a claim to replace every AE2 planning workload.

📦 Requirements

Install the RaishxCore JAR in the mods/ folder alongside the addon that requires it. UFO Future 3.0.0-beta.1 requires RaishxCore 0.1.0-beta.1 or a compatible later 0.1.x build.

🧩 For addon developers

The public API is organized by domain:

• api.amount — exact nonnegative amounts and rational rates
• api.multiblock — structures, roles, scan/runtime results, and visuals
• api.port — deterministic item, fluid, chemical, energy, and coolant ports
• api.transaction — simulate/plan/commit transfer contracts
• api.tier — tier definitions and validation
• api.crafting — shared crafting capacity and planner integration
• client.gui.widget — reusable client-only widgets

See the consumer integration guide and source repository for setup, configuration, and API details.

📜 License

RaishxCore is licensed under LGPL-3.0-or-later.

Built by Raishxn.