# 🧳 Dimension Suitcase

Pack an entire private island into a suitcase, set it down anywhere, and step inside.

Dimension Suitcase gives every world one portable pocket dimension — a hand-built island that
lives in its own dimension file, safe from creepers, safe from griefers, and always exactly
where you left it. Bring your friends. Bring your pets. Bring a full storage network.

## ✨ Features

### 🚪 A pocket island you carry
Place the **Dimension Portal** and right-click it to travel. The island is a real dimension with
its own world border — build on it, farm on it, live on it. Leave through an **Exit Doorway**
and you come out exactly where the suitcase is standing.

The first player to join a world is given a portal automatically, in every game mode.

### 📍 Arrive where you want
Craft a **Suitcase Spawn Plate** and stand on it — that becomes *your* personal arrival point.
Every player can have their own. No plate? Everyone lands at the island's front door.

### 💾 A wireless storage network
Place a **Computer Suitcase**, feed it a **Master Card**, then install a **Suitcase Tablet** and
bind it. Link your chests, barrels and modded containers to the network and open a single
terminal that shows *everything* at once:

- 🔍 Search by name, or type `@create` to filter by mod
- ↕️ Sort A–Z, or by count low-to-high / high-to-low
- 📥 Withdraw and deposit from anywhere on the island
- 👀 Hold **Shift** to see every linked container outlined through the walls

Each Master Card raises how many containers the network can hold, so the system grows with you.

### 🧭 Never lose your suitcase
The **Suitcase Compass** points at the nearest player carrying a portal, or at a portal that has
been placed down. If there isn't one anywhere, the needle simply drifts — a lost compass, not a
broken one.

### 🐑 Bring anyone with you
Carry animals and pets through the portal, and invite other players to travel with you. They
confirm with `/suitcase accept` — nobody gets dragged into a dimension they didn't agree to.

### 🛡️ The island plays by its own rules
Hostile mobs don't spawn, mobs can't grief your builds, and you don't take fall damage — all
scoped to the island only, so your main world is untouched. PvP and keepInventory are
configurable. The last Exit Doorway on the island can never be broken, so you can't strand
yourself.

### 🗺️ Use your own island
Built something better? Point the config at your own world save folder and Dimension Suitcase
will ship *your* island to every player instead of the built-in one.

---

## 🔨 Getting started

1. Craft or receive a **Dimension Portal**
2. Place it and right-click to enter the island
3. Craft a **Computer Suitcase** and a **Suitcase Tablet**
4. Insert a **Master Card**, install the tablet, and bind it to the computer
5. Link your chests and open the terminal from anywhere
6. Leave through the **Exit Doorway**

Every block and item has a crafting recipe — all of it is reachable in survival.

---

## ⌨️ Commands

| Command | Who | What it does |
|---|---|---|
| `/suitcase accept` | Everyone | Accept an invitation to travel |
| `/suitcase install skip` | OP | Finish a tablet installation instantly |
| `/suitcase island tp` | OP | Teleport to the island |
| `/suitcase island home` | OP | Return to the overworld |
| `/suitcase island info` | OP | Show island status |
| `/suitcase island reset` | OP | Restore the island to its original state |
| `/suitcase givedoor` | OP | Grant an Exit Doorway |

---

## ⚙️ Configuration

`config/dimension_suitcase-common.toml` lets you change arrival coordinates, world border size,
what new players are granted, invite timings, tablet install time and network size limits, and
the folder your custom island is loaded from.

> ⚠️ Forge never rewrites a config file once it exists. If you change these settings, delete the
> file or edit it by hand — new defaults will not apply to an existing world.

---

## 📋 Requirements

- Minecraft **1.20.1**
- Forge **47.x**
- Works in singleplayer and on servers. Required on both sides.

---

## 💬 Feedback

Found a bug or have an idea? Leave a comment — it gets read.

Pocket Dimension Suitcase