Magic portal

^ magic portal
Generates	Never randomly; special levels and branches only
Effect	Transports between branches

A magic portal, ^, is a type of trap that appears in NetHack. When activated, a magic portal takes you to a corresponding square on the destination level, which can be in a different branch of the dungeon altogether.

Generation

Portals are never randomly generated, and can be found in very specific areas:

• A magic portal leading to the Quest will occur on a dungeon level from 11 to 16, where it is placed randomly in a normal dungeon room (i.e. with no stairs).
• A magic portal leading to Fort Ludios can appear in a vault anywhere from dungeon level 11 to Medusa.
  • This portal is the only one that is not guaranteed to appear - several factors can influence this possibility, such as the limit of one portal per dungeon level and the fact that vaults are not guaranteed to appear on a compatible floor.
• In Gehennom, a portal in one of the fake Wizard's towers leads to the real one.
• A one-way portal is randomly placed on each of the Elemental Planes, leading to the next.

There will always be one portal per dungeon level - while it is technically possible for more than one portal to exist on a level, the code does not account for this when transporting you between portal endpoints, since it will make use of the first portal it finds in the list of traps regardless of where you departed from originally.

Description

A magic portal is hidden until it is either activated by you or a monster moving onto its square, or else it is revealed through other means such as a wand of secret door detection. Magic portals cannot be "escaped" like other 'traps': Moving onto a portal's square will always activate it, unless you are placed there as a result of entering the other end of a portal; you can trigger a portal while on its square by using #sit, provided there are no objects on that square.

A magic portal will not disappear when used unless it is a one-way portal, which are encountered on the Elemental Planes; a one-way magic portal can also be wished for in wizard mode, and stepping on its square causes you to escape the dungeon, ending the game immediately with no option to continue.

While a comment in the source code describes the branchporting effect of the Eye of the Aethiopica as "open[ing] a use-once portal", the effect does not physically create a portal, instead sending the player directly to the target level.

The following information pertains to an upcoming version (NetHack 3.7.0). If this version is now released, please verify that it is still accurate, then update the page to incorporate this information.

Using a magic portal causes you to be stunned for three turns.

Quest portal

The presence of the magic portal to your quest on a dungeon floor is announced by a message from your quest leader the first time you enter that floor, with an example provided below:

You receive a faint telepathic message from Neferet the Green:
Your help is urgently needed at the Lonely Tower!  Look for a ...ic transporter.
You couldn't quite make out that last message.

Subsequent visits to that floor will print a message like the one shown below until the Quest is completed:

You again sense Neferet the Green pleading for help.

If you attack the quest leader, have converted your alignment, or fail the alignment test more than seven times, the portal will disappear permanently, which can render the game unwinnable.

The following information pertains to an upcoming version (NetHack 3.7.0). If this version is now released, please verify that it is still accurate, then update the page to incorporate this information.

The portal will no longer disappear under these circumstances, in order to prevent an unwinnable game.

Removal

This trap cannot be removed, although the portal to your Quest will disappear if you are rejected with prejudice.

Strategy

There are several methods to detect portals before stumbling into them, including the usual methods of trap detection such as reading a scroll of gold detection that is cursed, or else reading a scroll of any beatitude while confused - see the linked article above for details.

Variants

SLASH'EM

In SLASH'EM, the portal to the Quest is found on a dungeon level ranging from 15 to 19, as well as three additional portals to the three alignment quests - the Lawful Quest, Neutral Quest and Chaotic Quest - with one portal per level.

Encyclopedia entry

Portals can be Mirrors, Pictures, Standing Stones, Stone
Circles, Windows, and special gates set up for the purpose.
You will travel through them both to distant parts of the
continent and to and from our own world. The precise manner
of their working is a Management secret.

[ The Tough Guide to Fantasyland, by Diana Wynne Jones ]