Ultra Cell

# Ultra Cell

A high-capacity AE2 storage cell addon for Minecraft 1.21.1 · NeoForge 21.1.x.

Provides FE, fluid, and chemical storage cells with massive capacity, integrated into the AE2 network.

## Dependencies

- AppliedFlux
- MEGA Cells
- Applied Mekanistics (appmek)

## Cell Tiers

| Tier | FE | Fluid Slots | Chemical Slots |
|---|---|---|---|
| Hongmeng | 2^128−1 | 128 | 128 |
| Wuji | 2^192−1 | 512 | 512 |

Per-type capacity = total capacity / type slots.

## Items

All items live under the `ultracell:` namespace.

| Registry Name | Display Name |
|---|---|
| `hongmeng_fe_component` | Hongmeng FE Storage Component |
| `hongmeng_fe_cell` | Hongmeng FE Storage Cell |
| `wuji_fe_component` | Wuji FE Storage Component |
| `wuji_fe_cell` | Wuji FE Storage Cell |
| `hongmeng_fluid_component` | Hongmeng Fluid Storage Component |
| `hongmeng_fluid_cell` | Hongmeng Fluid Storage Cell |
| `wuji_fluid_component` | Wuji Fluid Storage Component |
| `wuji_fluid_cell` | Wuji Fluid Storage Cell |
| `hongmeng_chemical_component` | Hongmeng Chemical Storage Component |
| `hongmeng_chemical_cell` | Hongmeng Chemical Storage Cell |
| `wuji_chemical_component` | Wuji Chemical Storage Component |
| `wuji_chemical_cell` | Wuji Chemical Storage Cell |
| `ultimate_cell_housing` | Ultimate Cell Housing |

## Recipes

Shaped recipes use a 3×3 grid; shapeless recipes are listed as ingredient pairs.

### Ultimate Cell Housing

- Singularity = `ae2:singularity`
- Quantum Ring = `ae2:quantum_ring`
- Quantum Link = `ae2:quantum_link`
- Formation Core = `ae2:formation_core`
- Annihilation Core = `ae2:annihilation_core`

### FE Components

**Hongmeng FE Component**

- Singularity = `ae2:singularity`
- 256M Component = `megacells:cell_component_256m`
- Energy Card = `ae2:energy_card`

**Wuji FE Component**

- Singularity = `ae2:singularity`
- Hongmeng Component = `ultracell:hongmeng_fe_component`
- Greater Energy Card = `megacells:greater_energy_card`

### Fluid Components

**Hongmeng Fluid Component**

- Singularity = `ae2:singularity`
- 256M Component = `megacells:cell_component_256m`
- Cauldron = `minecraft:cauldron`

**Wuji Fluid Component**

- Singularity = `ae2:singularity`
- Hongmeng Fluid Component = `ultracell:hongmeng_fluid_component`
- Sky Stone Tank = `ae2:sky_stone_tank`

### Chemical Components

Requires Applied Mekanistics.

**Hongmeng Chemical Component**

- HDPE Sheet = `mekanism:hdpe_sheet`
- 256M Component = `megacells:cell_component_256m`
- Chemical Upgrade = `mekanism:upgrade_chemical`

**Wuji Chemical Component**

- HDPE Stick = `mekanism:hdpe_stick`
- Hongmeng Chemical Component = `ultracell:hongmeng_chemical_component`
- Ultimate Chemical Tank = `mekanism:ultimate_chemical_tank`

### Cells

All cells are **shapeless**: one matching component + one Ultimate Cell Housing.

| Cell | Ingredients |
|---|---|
| Hongmeng FE Cell | `ultracell:hongmeng_fe_component` + `ultracell:ultimate_cell_housing` |
| Wuji FE Cell | `ultracell:wuji_fe_component` + `ultracell:ultimate_cell_housing` |
| Hongmeng Fluid Cell | `ultracell:hongmeng_fluid_component` + `ultracell:ultimate_cell_housing` |
| Wuji Fluid Cell | `ultracell:wuji_fluid_component` + `ultracell:ultimate_cell_housing` |
| Hongmeng Chemical Cell | `ultracell:hongmeng_chemical_component` + `ultracell:ultimate_cell_housing` |
| Wuji Chemical Cell | `ultracell:wuji_chemical_component` + `ultracell:ultimate_cell_housing` |

## Commands

| Command | Permission | Description |
|---|---|---|
| `/ultracell getuuid` | Everyone | Read the UUID of the held cell; click to copy |
| `/ultracell recover <uuid>` | Everyone | Recover the cell with the given UUID |
| `/ultracell scan` | Everyone | Scan for orphan data files |
| `/ultracell trade <player>` | Everyone | Transfer cell ownership to an online player |
| `/ultracell transfer <uuid> <player>` | OP | Force-transfer ownership; works on offline players |
| `/ultracell debug` | OP | Debug utilities |

## Filtering

- No whitelist: dynamic allocation, slots released when emptied.
- Whitelist configured: only accepts whitelisted types.
- Inverter Card: rejects whitelisted types, dynamic allocation for the rest.

## Development Environment

- Minecraft 1.21.1
- NeoForge 21.1.x
- JDK 21
- Gradle Wrapper 8.13
- ModDevGradle

## How It Works

**FE cells**: stored in the item's data components (three longs). No external files; 1.0.0 saves remain compatible.

**Fluid / chemical cells**: each cell has its own `.dat` file (compressed NBT), named by UUID. Write schedule: end-of-tick merge write + shutdown write + cell-leaves-container write + 30-second fallback write. No copy protection.

**Ownership**: a cell in a player's inventory is bound to that player; a cell in an ME network belongs to the network owner; existing ownership is never rebound.

**Orphans**: never auto-deleted, kept for recovery.

## License

MIT License. See `LICENSE`.