Back to mods
PortalKey project artwork

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

Choose a version Pick your version below, then grab the matching file.

Quick answer

Which PortalKey release should I use?

Updated 2 days ago
Latest stable file Portal-Key-1.21.1-NeoForge-1.5.2.jar
Game version 1.21.1
Loader NeoForge

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.

Client Source doesn’t say
Dedicated server Source doesn’t say
Loader for this release NeoForge
Required install it here Optional supported, not mandatory Not supported do not install here Source doesn’t say do not assume

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.

No extra mods listed for this file

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.

  1. 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.

  2. 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.

  3. 03

    Put it on the correct side

    The project page does not say whether this file belongs on the client, dedicated server, or both.

  4. 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.

1 available setups

Check the dependencies, then try the file in a copied instance before changing a world you care about.

Recent files

PortalKey versions and loaders

3 of 3 releases match

Looking for an older file? The official CurseForge project page is in Resources.