AE2 BatchCraft

# AE2 BatchCraft v1.0.2 (⚠️Breaking Update — Back Up Your Save Before Upgrading)

For Minecraft 1.21.1, NeoForge 21.1+, and Applied Energistics 2 19.x.

This update focuses on adding batch distribution for large processing jobs, while improving output extraction throughput, job recovery reliability, and GUI usability.

## New Features

### Batch Distribution

- The input endpoint now supports two task distribution modes: **“Full Distribution”** and **“Batch Distribution.”**
- In the Processing Pattern of the Pattern Encoding Terminal, press **Ctrl + Middle Mouse Button** on the primary output to open the **Batch Configuration** interface.
- The batch size defines the minimum amount of a task that can be dispatched at once.
- Batch distribution allocates materials in integer multiples of the atomic task size, based on the number of available machines and the amount of input capacity currently available on each machine.
- Materials that have not yet been dispatched remain stored in the AE2 Pattern Provider. The input endpoint only accepts materials that can actually be distributed at that time.
- When a machine frees up input space, it can continue receiving subsequent batches without waiting for the previous batch's processing to finish.
- Full Distribution retains the original strict behavior: an endpoint must receive the entire task and will never partially supply materials.

> The batch size only verifies whether the material and output quantities in the pattern are divisible by the specified batch size. It cannot determine the machine's actual recipe ratios. Please ensure that the resulting minimum batch size can be processed correctly by the machine.

## Output Extraction Improvements

- The maximum output extraction amount has been increased from 64 to **2147483647**.
- Values exceeding the input field's display width can now be viewed by moving the cursor within the field.
- Improved per-tick output extraction throughput for high-capacity, multi-slot machines.
- A single endpoint can now perform multiple rounds of safe extraction within a single tick.
- Extraction stops when the AE network or return inventory is full, preventing item loss.
- Added endpoint-level and network-level extraction budgets to prevent unbounded loops or severe lag under extreme configurations.

## Task Distribution Improvements

- Machine capacity detection now uses **“2× expansion + binary search”**, reducing the number of capacity probes required for large tasks.
- Optimized continuous batch feeding for identical patterns and round-robin distribution across multiple machines.
- Added failure backoff, state-change wakeups, and a maximum-wait fallback to reduce unnecessary polling when machines are unable to accept materials.
- If an input endpoint is destroyed, materials that have already been received but not yet dispatched are preferentially returned to the AE network. Only materials that cannot be returned will be dropped into the world.

## Upgrade Notes

Batch Distribution is **disabled by default**. Existing configurations will continue to use **Full Distribution** mode.

⚠️⚠️⚠️This is a **breaking update**. It is recommended that you back up your save before upgrading and remove the corresponding components from older development versions first.