Create Package operating reference
Mod version shipped with FlammiCraft: 0.4.0
Handbook overview · Deutsch · Upgrades and migration
Requirements
- Minecraft 1.21.1
- NeoForge 21.1.230 or newer
- Applied Energistics 2 19.2.0 or newer
- Create 6.0.0 or newer
These are the loader metadata minimums.
Core Ideas
Create Package has two main crafting paths:
- Sequenced assembly routing for multi-step Create lines. Use Package Distributors, route tools, and Mechanical Package Patterns.
- Single-machine processing for one Create machine or several identical machines. Use the Kinetic Pattern Provider.
The mod uses AE2 processing patterns as the crafting contract. It validates and simulates target insertions before spending inputs whenever possible. It does not scan the world for dropped item entities; outputs must be recoverable through configured depots, belts, basins, inventories, or machine handlers.
Devices use configured or saved machine positions and sleep while idle. Optional addon adapters use bounded reflection to read their machine APIs. No mixins, world scans, or dropped-item searches are used.
Blocks and Items
Package Distributor
The Package Distributor is the external target for a normal AE2 Pattern Provider.
Use it when you already have an AE2 Pattern Provider and want one linked Create sequenced-assembly route. Place the Package Distributor on the ME network, point an adjacent AE2 Pattern Provider at it, put processing patterns in the AE2 Pattern Provider, then link the physical Create line with the Machine Linker.
The linked route is interpreted as:
- first depot or belt: input position;
- deployers and spouts: supplied in linked order;
- last depot or belt: output recovery position.
Build working transport between the marked positions. The physical Create line performs passive processing such as pressing and cutting. Mark the Deployers and Spouts that need supplies.
Basic Package Distributor
The Basic Package Distributor combines a Package Distributor with an embedded AE2 pattern-provider inventory.
Use it when you want a compact single-route distributor. Put AE2 processing patterns directly into the Basic Package Distributor GUI. It still uses the Machine Linker route saved on the block, but it does not need a separate AE2 Pattern Provider beside it.
It is best for one physical sequenced-assembly line at a time.
Advanced Package Distributor
The Advanced Package Distributor stores 36 patterns for multiple saved routes in one block.
It does not use the Machine Linker route on the block itself. Instead, each Mechanical Package Pattern carries its own saved machine route. Put Mechanical Package Patterns into the Advanced Package Distributor GUI, and the distributor will execute each job using the route stored inside that pattern.
Parallel Cards allow the Advanced Package Distributor to run multiple jobs at once when their saved routes do not overlap:
- 0 Parallel Cards: 1 active line;
- 1 Parallel Card: up to 4 active lines by default;
- 2 Parallel Cards: up to 8 active lines by default. Each card provides the number of slots set by
advancedDistributorParallelCardCapacity.
This is the preferred option for a shared AE2 interface that manages several independent Create assembly lines.
Machine Linker
The Machine Linker stores ordered machine routes.
For Package Distributors and Basic Package Distributors:
- Right-click the distributor with the Machine Linker to select it.
- Right-click route blocks in item-flow order.
- Sneak-right-click a linked block to remove it.
- In Append mode, sneak-right-click the distributor to clear its links and unbind.
For Kinetic Pattern Providers with Parallel Cards:
- Right-click the Kinetic Pattern Provider to select it.
- Right-click matching machines of the same block type as the provider's target machine.
- Sneak-right-click linked machines to unlink them.
When FTB Ultimine shape selection is available, the Machine Linker can batch-link or batch-unlink matching machines.
Ordered route controls
These controls apply to a Linker bound to a standard or Basic Distributor, the Converter, and a Mechanical Package Pattern. Kinetic links are an unordered set.
| Action | Control |
|---|---|
| Switch between Append and Edit | Left-click empty air |
| Add or remove the clicked mark in Append | Right-click to add, sneak-right-click to remove |
| Select an existing mark in Edit | Scroll |
| Replace or remove the selected mark in Edit | Right-click a replacement, or sneak-right-click to remove |
| Rebuild from the first and last marks | Auto-route search, G by default |
For auto-route, the endpoints must be distinct Depots or Belts at the same height. An enabled L-shaped search also requires a Depot or Belt at the corner. The server limits the corridor length and checks loaded positions and edit permissions. The result lists supplied machines. Test actual item transport yourself. To open GuideME, hover over a supported item in an inventory and hold the guide key shown in the tooltip.
Mechanical Pattern Converter
The Mechanical Pattern Converter marks routes and converts normal AE2 encoded processing patterns into Mechanical Package Patterns.
Use it for Advanced Package Distributor workflows:
- Right-click route blocks in order while holding the converter.
- Sneak-right-click a marked block to remove it.
- Sneak-right-click air to clear the current route.
- Right-click air to open the converter GUI.
- Insert an AE2 encoded processing pattern or an existing Mechanical Package Pattern.
- Select Convert and take the result from the bottom row. Each of the nine inputs needs its own free output slot underneath. The result stores the converter’s current route. An empty route can be converted, but AE2 will only register a routed mechanical pattern for autocrafting once it has a route mark.
The converter shows the marked route in its tooltip. Hold Shift to expand machine names and coordinates. Holding the converter in-world highlights the current route.
Crafting recipe: one Create Precision Mechanism plus one AE2 Blank Pattern.
Mechanical Package Pattern
Mechanical Package Patterns are AE2 processing patterns with an additional Create route snapshot.
They preserve the original AE2 encoded pattern and add route data for the Advanced Package Distributor. This means one Advanced Package Distributor can store patterns for different physical lines, and each pattern knows where it should run.
Mechanical Package Patterns can also be edited in-world:
- right-click a markable route block to append it to the pattern route;
- sneak-right-click a route block to remove it;
- hold the pattern to highlight its saved route;
- put it back into the Mechanical Pattern Converter to rewrite the route while preserving the original AE2 pattern.
Kinetic Pattern Provider
The Kinetic Pattern Provider is for single-machine Create processing.
It embeds AE2 Pattern Provider behavior and faces one configured target side. Use a wrench to set the side that points at the Create machine. Put normal AE2 processing patterns into the provider GUI, connect it to the ME network, and request the craft from AE2.
Supported routing includes:
- Deployer: first item input goes to the working position two blocks along the deployer's facing direction; second item input goes into the deployer's held-item inventory; output is recovered from the working position. A reusable application item already held by the deployer may be omitted from the pattern. Items in its overflow output slots do not replace the held item. Consumed ingredients should remain in the pattern so AE2 supplies them for every craft.
- Spout: item input goes to the working position two blocks below the spout; fluid input goes into the spout; output is recovered from that working position.
- Mechanical Press: with a basin two blocks below, all item and fluid inputs go into the basin and outputs are recovered from the basin. Without a basin, one item input goes to the depot, belt, or inventory two blocks below.
- Mechanical Mixer: requires a basin two blocks below. Inputs and outputs use that basin.
- Mechanical Saw: the saw must face up and be running. The provider sets the saw filter from the pattern's primary output, inserts the input, and recovers from the saw's fixed output side.
- Millstone: input goes into the millstone and actual outputs, including probabilistic byproducts, are recovered.
- Crushing Wheel: target the
create:crushing_wheel_controller, not the wheel block. The controller must output into a recoverable belt, depot, or inventory. - Supported addon machines: explicit adapters select their item/fluid input and output positions. An arbitrary item handler alone does not make a machine supported.
Parallel Cards let one Kinetic Pattern Provider distribute jobs to multiple identical machines:
- 0 Parallel Cards: front target only;
- 1 Parallel Card: up to 16 active machines;
- 2 Parallel Cards: up to 32 active machines.
Smart Doubling can be enabled per provider. When enabled, matching processing-pattern pushes can be batched into the current active job. If the target machine cannot currently receive another input set, the provider keeps a lightweight internal pending-dispatch queue and tries again while the job is active. Pending inputs are persisted with the job and returned through AE2 return inventory if the craft is cancelled before dispatch.
Extended Kinetic Pattern Provider
This version uses the same target, pattern, recovery, Smart Doubling and Parallel Card behavior as the Kinetic Pattern Provider. Each page holds 36 patterns. The server setting extendedKineticProviderPageMultiplier defaults to one page and allows up to nine. Use the left toolbar arrows when multiple pages are available. Direct slot actions and shift-clicking affect the displayed page. Occupied higher pages remain available after the limit is reduced until their patterns are removed.
Parallel Card
Parallel Cards upgrade the Advanced Package Distributor and both Kinetic Pattern Providers.
In the Advanced Package Distributor, they increase the number of non-overlapping saved routes that can run at the same time. In the Kinetic Pattern Provider, they unlock linked identical machines for multi-machine dispatch.
Parallel Cards stack in normal inventories, but AE2 upgrade slots still accept one card per slot.
Incomplete Package Distributor
The Incomplete Package Distributor is the transitional item used by the mod's Create sequenced-assembly crafting recipes.
It is not a normal tool or machine. It exists so the mod's own blocks can be crafted through Create assembly chains.
Pattern Rules
Create Package currently uses normal AE2 processing patterns.
For sequenced assembly, encode:
- one base input item;
- consumed deployer items for the full loop count;
- spout fluids for the full loop count;
- the final primary output.
For Precision Mechanism-style recipes, the base item is consumed once and the intermediate item loops through the line. Do not multiply the base item by the number of loops.
Example Precision Mechanism pattern:
- inputs:
1 Gold Sheet,5 Cogwheels,5 Large Cogwheels,5 Iron Nuggets; - output:
1 Precision Mechanism.
AE2 processing patterns do not have probabilistic-output semantics. Do not put optional byproducts in the pattern output list unless AE2 should wait for them as required outputs. Create Package still recovers actual byproducts when they appear.
Sequenced Assembly Behavior
Package Distributors match the pattern's primary output to a Create sequenced-assembly recipe. If multiple recipes match or required inputs are missing, the job is rejected before consuming inputs.
During a job, the distributor:
- validates the route and pattern inputs;
- simulates all target insertions;
- supplies base items, deployer held items, and spout fluids;
- watches the configured output position;
- returns recovered outputs to AE2.
For multi-loop sequenced assembly, Create's transitional item keeps recipe progress data. When the distributor sees the current job's transitional item at the output position, it sends that same item stack back to the input position without stripping its progress data. Intermediate stacks from other recipes stay at the output. Active jobs reserve their route positions across distributors in the same dimension, including while the owning distributor's chunk is unloaded.
For probabilistic primary outputs, the distributor can refill another input round from AE storage when byproducts or empty-output timeouts show that the primary output has not arrived yet. A primary output still waiting for ME insertion pauses that refill.
Material recovery
Failed transfers are rolled back before another attempt. If a machine refuses the rollback, automatic supply for that job stops. Unspent inputs and unreturned ME extractions are saved separately and returned when storage accepts them. Cancel the AE2 craft and recover any material still in the physical machine before requesting it again.
Breaking a distributor or provider with the correct tool preserves its internal queued inputs, fluids, and buffered outputs in the dropped block item. The item tooltip identifies stored recovery materials. Place that block again and connect it to ME to return them. Inputs already delivered to a machine remain in that machine.
Spring Coiling Machines and Belt Grinders require a recoverable inventory at their output. Lasers require a Depot or Belt two blocks below. Loose-item output is unsupported. Saved jobs with old loose-item endpoints stop automatic dispatch; cancel them and collect existing drops manually. Their queued materials remain recoverable.
Route edits check server reach and block protection. Batch and automatic route changes also check permission at each resulting machine position and the selected distributor.
Diagnostics
Engineer’s Goggles and Jade show useful runtime state:
- AE node power, channel, and online status;
- current status and rejection reason;
- active job output and remaining amount;
- route links or saved Mechanical Package Pattern routes;
- parallel-card capacity and active job count;
- Kinetic Pattern Provider target machine and linked parallel machines.
| Status | What to check |
|---|---|
| Waiting for output | Check rotation, the physical output path and the configured recovery position. Verify ME can accept the product. |
| Waiting for refill inputs | Check the shown ingredient and amount. For an active request, inspect the AE2 CPU or Stock Bridge destination and package route. If craftable but idle, check CPU availability and recipe inputs. Supply ingredients without a pattern to ME. |
| Delivery buffered | In 0.4.0, make space in ordinary ME storage so the device can return the buffered ingredients before refilling. |
| Refill target cannot accept inputs | Clear the input carrier or make item or fluid space in the target. |
| Supply stopped | Cancel through AE2, account for inputs in the machine, and wait for pending returns before retrying. |
Limitations
- Create machines must be powered and physically able to move items.
- Outputs must enter configured recoverable positions. Dropped item entities are not scanned.
- Package Distributor and Basic Package Distributor each run one route at a time.
- Advanced Package Distributor parallelism only runs routes that do not overlap.
- Kinetic Pattern Provider is for single-machine processing, not multi-step sequenced assembly.
- Current pattern matching is conservative and may reject ambiguous setups to avoid consuming the wrong inputs.