CurseForge · Minecraft mod
PortalKey
PortalKey is a Minecraft mod / plugin designed to completely overhaul how portals are unlocked and ignited. Instead of the vanilla system where any player with flint & steel can light a Nether portal
Quick answer
Which PortalKey release should I use?
PortalKey Portal-Key-1.21.1-NeoForge-1.5.2.jar targets 1.21.1 with NeoForge. The project page does not say whether this file belongs on the client, dedicated server, or both. No extra mods listed for this file.
Where it goes
Is PortalKey required on the client, server, or both?
The project page does not say whether this file belongs on the client, dedicated server, or both.
The source does not explicitly classify this release as client-only or server-only.
What else does PortalKey Portal-Key-1.21.1-NeoForge-1.5.2.jar need?
Portal-Key-1.21.1-NeoForge-1.5.2.jar. Change the file and its required mods may change too.
This file does not list any required mods. Do not add a library just because a different file uses it.
This file does not list any required or optional mods.
Before you install it
Add PortalKey without breaking your instance.
Built for PortalKey Portal-Key-1.21.1-NeoForge-1.5.2.jar. Pick another file and the loader, install side or required mods may change.
- 01
Stick to this file
Use Portal-Key-1.21.1-NeoForge-1.5.2.jar. It targets 1.21.1 with NeoForge; another release may have different loader, side or dependency requirements.
- 02
Bring the mods it needs
This file does not list any required mods. Do not add a library just because a different file uses it.
- 03
Put it on the correct side
The project page does not say whether this file belongs on the client, dedicated server, or both.
- 04
Pick the file you checked
Use the “Get this file” button beside Portal-Key-1.21.1-NeoForge-1.5.2.jar. It opens that exact file at the source.
About this project
What does PortalKey add?
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.
Project description from CurseForge.
Pick your setup
PortalKey by Minecraft version and loader
Choose the version and loader you play, then open the matching release.
Check the dependencies, then try the file in a copied instance before changing a world you care about.
Recent files
PortalKey versions and loaders
Portal-Key-1.21.1-NeoForge-1.5.2.jar
12 Sept 2026
Portal-Key-1.21.1-NeoForge-1.4.0.jar
27 Aug 2026
Portal-Key-1.21.1-NeoForge-1.2.0.jar
25 Aug 2026
Looking for an older file? The official CurseForge project page is in Resources.