Cage a mob. Farm its drops. Forever.

RaiSoulForge adds a Soul Cage that captures a living mob, and the Material Soul Transformer — a machine that
takes the cage and endlessly produces exactly what that mob would drop when a player kills it, plus liquid XP.

No power. No fuel. No setup ritual. Craft it, place it, drop a cage in, pipe the loot out.

---

Quick start

1. Craft a Soul Cage.

2. Right-click any mob with the empty cage. The mob disappears from the world and the cage becomes full — its
name now shows in the item's tooltip. The cage stores the mob's complete NBT, so a Wither Skeleton stays a Wither
Skeleton, a pink sheep stays pink, a librarian villager stays a librarian, and armed mobs keep their gear.

3. Craft and place a Material Soul Transformer, then put the cage in the slot on the left. It starts working
immediately.

4. Take the loot out. Hoppers, ducts and item pipes work from all six sides. Liquid XP comes out of any side
through a fluid pipe or a tank.

5. Add upgrades in the three slots at the bottom left to make it faster and more productive.

---

Recipes

All recipes are ordinary crafting recipes, so NEI shows them in game.

---

Upgrades

Three slots, one upgrade of each kind.

- Yield I–V — applies Looting I to V to every kill the machine performs. Real Looting, not a multiplier: mobs that ignore Looting still ignore it, and mobs that scale with it scale properly.
- Speed I–V — shortens the cycle: 200 → 150 → 110 → 75 → 45 → 20 ticks. At Speed V that is one kill per second.
- Boss — the machine refuses to run a cage containing a boss until this upgrade is installed.

---

Bosses

Anything that shows a boss health bar (the Wither, and modded bosses implementing `IBossDisplayData`) can only be caged once it is at 25 % health or lower. Then it needs the Boss upgrade in the machine before it will run.

The Ender Dragon is blacklisted by default — in 1.7.10 it is a multi-part entity that cannot be right-clicked
normally, and it drops no items on death anyway.

---

The part that actually matters

The loot is not a table in a config file. Every cycle the machine rebuilds the stored mob from its NBT and
simulates a genuine player kill on it — the mob is never added to the world, so it never renders, moves or attacks.
A Forge FakePlayer holding a Looting-enchanted sword does the killing, and the drops are intercepted before they hit
the ground.

That means you get:

- Rare drops — potatoes, carrots and iron from zombies, Wither Skeleton skulls, and everything else that only happens when a *player* lands the kill.
- Mob equipment — armed and armoured mobs drop their gear at the usual rates.
- Drops added by other mods — anything hooked into `LivingDropsEvent` fires normally, so third-party additions to vanilla mob loot come through untouched.

Loot is never voided. If the output fills up, the machine stops and holds the generated items in a queue that
survives world saves, until you free up space.

---

Liquid XP

Experience is read straight from the mob and converted at 20 mB per experience point — the same rate OpenBlocks and EnderIO use.

The fluid is registered as `xpjuice`. If another mod already registered it, RaiSoulForge uses theirs instead of
its own, so tanks, pipes and XP drains stay interoperable.

---

Automation

The machine implements `ISidedInventory` and `IFluidHandler` on all six sides:

- Item pipes extract from the 12 output slots only.
- Item pipes can insert a filled cage, so you can swap mobs automatically.
- Cages and upgrades cannot be sucked out by accident.
- A comparator reads the fill level.

---

Config

`config/raisoulforge.cfg` — cycle length per Speed tier, mB per XP point, tank size, whether bosses need the upgrade, capture health thresholds, an entity blacklist, a list of extra entity ids to treat as bosses, optional redstone control, and a switch for mob death sounds (off by default, because at Speed V it gets loud).

---

Requirements

- Minecraft 1.7.10
- Minecraft Forge 10.13.4.1614 or newer
- No other mods required

---

Licence

MIT — free to use in any modpack, public or private, no permission needed.