All upgrades are registered in CoreUpgrades and appear in the General Mechanics creative tab. Each upgrade card can be inserted into a compatible machine’s upgrade slots. Compatibility varies by machine.
Most upgrades stack up to 8 copies per machine slot by default. Stacking multiple copies of the same upgrade compounds the effect — for example, three Speed Upgrades apply three layers of speed increase. Individual upgrades may have a lower maximum; check the machine’s registered UpgradeMap for per-upgrade limits.
Upgrade table
| Upgrade | Description |
|---|
| Upgrade Base | Base empty upgrade card. Serves as a placeholder and has no effect when inserted. |
| Speed Upgrade | Increases machine operation speed. |
| Capacity Upgrade | Expands the operational size of machines. |
| Efficiency Upgrade | Reduces power consumption per operation. |
| Overclock Upgrade | Greatly increases speed but at a power efficiency cost. |
| Thermal Buffer | Allows the machine to operate under extreme conditions. |
| Auto Ejector | Automatically pushes output to connected inventories. |
| Input Expander | Allows the machine to accept input from multiple sides. |
| Multi-Processor Unit | Enables running multiple operations at once. |
| Silencing Coil | Suppresses sounds emitted from the machine. |
| Nanite Injector | Increases yield of byproducts or rare drops. |
| Precision Gearbox | Increases accuracy for machines with chance-based outputs. |
| Redstone Interface | Adds advanced redstone control options. |
| Eco-Drive | Idle machines draw near-zero power. |
| Void Mod | Destroys overflow items instead of clogging the machine. |
| Replication Node | Duplicates output at a high power cost. |
The Overclock Upgrade trades power efficiency for speed. Running multiple Overclock Upgrades will significantly increase power draw. Pair with Efficiency Upgrades or a well-supplied power network to avoid machine stalls. On the Matter Fabricator, Overclock is capped at 1 copy.
Upgrade limits by machine
Certain upgrades have a per-machine maximum of 1, regardless of the global cap of 8. The following limits apply on the Matter Fabricator:
| Upgrade | Max per machine |
|---|
| Speed Upgrade | 8 |
| Capacity Upgrade | 8 |
| Efficiency Upgrade | 8 |
| Overclock Upgrade | 1 |
| Auto Ejector | 1 |
| Silencing Coil | 1 |
| Redstone Interface | 1 |
| Eco-Drive | 4 |
| Void Mod | 1 |
| Replication Node | 8 |
Technical details
Descriptions are stored on the UpgradeBase item itself and accessed via getEnglishDescription(). In-game, the tooltip shows a “Press Shift” hint until the player holds Shift, at which point the description is rendered via the translation key <item_id>.desc.
The Upgrade Base card uses UpgradeEmpty, a subclass of UpgradeBase that suppresses all tooltip rendering. It is registered with an empty description and no UpgradeFunctionBuilder, making it entirely inert.
See Machine Upgrades for details on implementing upgrade support in a custom machine. 