Skip to main content

Upgrade cards and migration

Mod version shipped with FlammiCraft: 0.4.0

Deutsch

Since version 0.2.0 of the local fork, Basic and Advanced Package Distributors and both Kinetic Pattern Providers use one four-slot upgrade inventory. Visible menu slots and sneak-right-click insertion access the same cards. The Basic variant still does not accept Parallel Cards. Other variants retain their limit of two Parallel Cards and their existing job capacities.

The known Applied Flux and ExtendedAE Plus inventory fields also refer to this inventory. Their own card readers and change callbacks remain connected, including induction-card checks, capability invalidation and Plus card state. Known addon cards inherit the limits registered for an ordinary AE2 Pattern Provider where this machine has no existing limit. A slot does not add a card function that its addon or the crafting path does not support.

Automatic migration

Loading imports the entries actually saved under the old upgrades and, when present, compat_upgrades keys. Both the host and Applied Flux used upgrades, so that saved source is read once. Independently saved cards remain distinct even if their contents match.

After migration, createpackage_upgrades is authoritative. Subsequent saves and loads do not import old copies again. Card components such as owners and channel bindings are retained. Routes, patterns, queued materials and running crafting jobs keep their existing formats. Cards overwritten before this update and no longer present in a save cannot be reconstructed from that save alone.

Retained entries

The upgrade-panel tooltip reports retained entries:

  • Readable cards that exceed the four slots remain saved. Normal dismantling with a suitable tool returns them as cards.
  • If a card or one of its components cannot be read because an addon is missing, its original data remains saved unchanged. Dismantling carries that data in the dropped block item, with a tooltip notice. Restore the missing mod and place the block again; it tries to restore those cards into free slots.

A missing addon cannot supply its card function until restored. Removing an addon does not authorize migration of other world data. Keep block items containing retained data. Regular cards drop once even when several addon hooks inspect the same inventory.

Rollback and verification

Use the same build on the client and server. Before downgrading to the old inventory code, recover all cards and retained data using the new build. The old version does not understand the new storage or recovery component. If recovery is not possible, use a matching world backup; replacing the JAR alone does not restore the previous state. Before downgrading, empty every pattern slot and page the target version cannot access.

Automated checks cover migration, components, repeated loads, card limits, direct field readers and callback binding, duplicate drop hooks, overflow and raw missing-addon recovery. ABI inspection covered Applied Flux 2.1.4 and the installed 2.1.7, plus ExtendedAE Plus 1.5.4.1. This is not in-game acceptance. Manual checks still need to cover menu/sneak insertion, card effects, dismantling/replacement and world reload with the actual addon mixins, both with and without the optional addons.