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.