PortalKey

# Portal Key

**Turn every dimension into a real progression milestone.**

Portal Key is a configurable dimension-access mod for **Minecraft 1.21.1 NeoForge**. It replaces normal portal activation items with items chosen by the modpack and gives every player a personal unlock for each supported dimension.

Craft the required item to earn its advancement. Until then, the dimension remains locked—even if another player has already opened the portal.

## Supported Dimensions

| Dimension | Original method replaced | Default required item | Personal advancement |
| --- | --- | --- | --- |
| Nether | Flint and steel, fire charges, and normal fire | `irons_spellbooks:fire_rune` | Nether Unlocked! |
| Twilight Forest | Diamond | `irons_spellbooks:nature_rune` | Twilight Forest Unlocked! |
| Deeper and Darker: Otherside | Heart of the Deep | `irons_spellbooks:ender_rune` | Otherside Unlocked! |
| The Aether | Water buckets and placed water | `irons_spellbooks:holy_rune` | Aether Unlocked! |
| Voidscape: The Void | Charred Bone | `irons_spellbooks:arcane_rune` | Voidscape Unlocked! |

## How Progression Works

- Every dimension has its own configurable activation item.
- Every player must personally craft the configured unlock item.
- Crafting awards a visible dimension-unlock advancement.
- Receiving the item from another player, loot, trades, or commands does not count as crafting it.
- Locked players cannot enter portals opened by somebody else.
- Unlocks survive death and relogging.
- Voidscape's alternative bedrock-entry method is protected by the same personal unlock.
- Creative players keep portal activation items.

## Portal Activation

- Right-click a complete obsidian frame to open the Nether portal.
- Throw the configured item into a valid Twilight Forest portal pool.
- Right-click a complete reinforced-deepslate frame to open the Otherside portal.
- Right-click a complete glowstone frame to open the Aether portal.
- Right-click a complete Voidic Crystal frame to open the Voidscape portal.

## Made for Modpacks and Servers

Each integration has its own configuration file. Server owners can change:

- Portal activation items.
- Personal craft-unlock items.
- Whether an activation consumes one item.
- Whether personal unlocks are required.
- Whether the original portal activation method is blocked.
- Messages shown when dimension access is denied.
- The protected Aether destination ID.

Any valid vanilla or modded item ID can be used. The default setup uses runes from **Iron's Spells 'n Spellbooks**, but those defaults can be replaced with other items.

## Compatibility

- Minecraft 1.21.1
- NeoForge 21.1+
- Multiplayer and dedicated servers
- The Twilight Forest 4.7.x
- Deeper and Darker 1.4.x
- The Aether 1.5.x
- Voidscape 1.9.x

Dimension integrations are optional and activate only when their corresponding mod is installed. **Restricted Portals is not required.**

Install Portal Key on the server and every player's client. Stop the game or server before editing its configuration files.

please consider to donate to keep up with the mod development and future updates and more mods.