# Pocket Mansion

**Your own private world — in your inventory.**

Pocket Mansion adds a personal dimension you can enter from anywhere with a single right-click. No portal frames to build. No coordinates to remember. Just craft the Pocket Dimension item, hold it, and step into a world that's yours alone.

Bring your favorite animals with you using the Mob Capsule. Build your dream mansion in peace. Return to the overworld whenever you want — the mod remembers exactly where you left.

---

## What's inside?

### 🏰 Pocket Dimension
A craftable item that takes you to your own private dimension. Right-click to enter. Right-click again from inside to return to exactly where you left the overworld. Each player gets their own private space — no other player can enter yours unless you bring them.

### 🐾 Mob Capsule
A reusable capture item for peaceful mobs. Right-click a cow, sheep, wolf, cat, parrot, or any non-hostile creature to store them inside. Carry them with you, walk into your Pocket Dimension, and release them there to build your personal sanctuary.

The Mob Capsule respects the world:
- ✅ Captures peaceful and tamed animals
- ❌ Cannot capture hostile mobs
- ❌ Cannot capture players
- 🏠 Mobs can only be released inside the Pocket Dimension — protecting other players' worlds from intrusions

---

## Recipes

Pocket Dimension

O G O
G D G
O G O

**O** = Obsidian · **G** = Gold Ingot · **D** = Diamond

Yields: 1 Pocket Dimension

A mid-game crafting gate — you'll need to have ventured into the Nether for obsidian and found at least one diamond before you can craft your dimension. This keeps the item meaningful instead of trivial.

Mob Capsule

. C .
C G C
. C .

**C** = Copper Ingot · **G** = Gold Ingot

Yields: 2 Mob Capsules

Affordable and craftable as soon as you have copper and gold — start collecting your menagerie early.

---

## How it works

1. **Craft a Pocket Dimension item.**
2. **Right-click it** in any world to step into your private dimension. The mod remembers exactly where you came from.
3. **Build.** It's your world — there are no hostile mobs, no time pressure, no other players. Build a mansion, a farm, a museum, whatever you want.
4. **Bring company.** Craft Mob Capsules, capture your favorite animals, and release them in your Pocket Dimension to keep you company.
5. **Right-click the item again** from inside to return to your exact starting point. Step in and out as often as you want.

---

## Why use it?

- **Privacy on multiplayer servers** — no one can grief your build because no one can find it.
- **A safe creative space** without changing the rules of your main world.
- **An animal sanctuary** for your tamed pets and farm animals.
- **A separate project space** — start a build without committing to a location in your main world.
- **No portal hassle** — no obsidian frames, no flint and steel, no coordinates. Just one item.

---

## Languages

- English

---

## Requirements

- Minecraft 1.21.10 (26.1.2)
- NeoForge 26.1.2.26-beta or newer

---

## Status

This is an early release (v0.1.0). The core mechanics are stable and tested:
- ✅ Pocket Dimension item and dimension travel
- ✅ Return-point persistence across sessions
- ✅ Mob Capsule capture and release logic
- ✅ Hostile/player capture protection

Planned for future versions:
- Decorative mansion-building blocks themed for the dimension
- Multiple dimension layouts to choose from
- Shared dimensions (invite friends)

Feedback and feature requests are welcome.

---

## Credits

Created by **TheMorf**.