XP Works

# XP Works

**Liquid Experience** for Minecraft 1.21.1, on **NeoForge** and **Forge**. Store your XP in a tank, pipe it around, and collect it from mob farms
with a drain.

- **Liquid Experience:** a glowing green fluid with a bucket. **20 mB = 1 XP point** (1 bucket = 50 points), the
  community standard. It's in the `c:experience` tag, so other mods' XP fluids and machines work with it.
- **Experience Tank:** holds **100 buckets** (5,000 points) of any experience fluid. **Tanks that touch join into one
  big tank**, any shape: 10 tanks hold 1,000 buckets.
- **Experience Drain:** stand on it to pour your levels into the tank below. It also **soaks up XP orbs**, so it
  makes a mob-farm collector.
- Works with **any pipe mod** that moves fluids (on NeoForge: Pipez, Mekanism, Create, ...). JEI info pages for every item.

## Experience Tank

```
I G I      I = Iron Ingot
G B G      G = Glass
I G I      B = Bottle o' Enchanting
```

- **Empty hand, right-click:** take exactly **1 level**.
- **Sneak + empty hand, right-click:** put **all** your XP in.
- **Buckets** in and out. **Pipes** on all six sides.
- **Comparator** output: the fuller it is, the stronger the signal.
- **Keeps its contents when broken.** The tooltip shows how much is inside.
- You can see the fluid level through the glass.

## Bigger tanks: just put them together

Tanks that touch, side by side or stacked, in **any shape**, become **one shared tank**. Each tank adds 100 buckets.

- Pipes, buckets, the Drain and right-clicks work on the **whole group**, through **any** of its tanks.
- A comparator next to any tank reads how full the **whole group** is.
- The liquid settles bottom-first, with one surface across the whole build.
- Break a tank and it takes **its share** of the liquid with it (never more than 100 buckets). If that splits the
  group in two, each part keeps the liquid in proportion to its size.
- Place a tank between two groups and they merge, liquid and all.
- Safe across chunk borders, unloading and restarts: no lost or duplicated XP.

## Experience Drain

Shapeless: **Iron Trapdoor + Hopper + Bottle o' Enchanting**.

- Stand on it in survival (or adventure) and it drains about **1 level per second**. It never drains players in
  creative or spectator mode.
- It absorbs **XP orbs** that touch it, merged orbs included.
- It pushes the liquid into the tank (or any fluid block) **below** it, and keeps a small **4-bucket buffer** that pipes
  can pull from on any side.
- When there's nowhere left to put the liquid, it **stops**: you keep your levels and orbs stay on the ground.

## Config

`serverconfig/xpworks-server.toml` in your world folder:

| Setting | Default |
|---|---|
| Tank capacity | 100 buckets (100,000 mB) per tank |
| Max tanks in one group | 1,000 (tanks past it stay separate) |
| Drain speed | 1 level per second |
| Drain buffer | 4 buckets (4,000 mB) |

## Requirements

| | NeoForge | Forge |
|---|---|---|
| Minecraft | 1.21.1 | 1.21.1 |
| Loader | NeoForge 21.1 or newer | Forge 52.1 or newer |
| File | `xpworks-1.1.0.jar` | `xpworks-1.1.0+forge-1.21.1.jar` |
| JEI | optional | optional |

- Same features and the same save format on both loaders.
- Install it on both the client and the server.
- Pick the file for your loader: each jar only runs on its own loader.

## For mod and pack makers

The fluid id `xpworks:liquid_experience` and the `c:experience` tag are stable, and the ratio is 20 mB per point.
Any machine that pushes into a fluid handler can fill an Experience Tank.

## Modpacks

You're welcome to include XP Works in any modpack.