How to Use World Portals

Portal Guide Header

This page covers Momentum Mod’s implementation of world portals, how they work, how to add them into a map, as well as the limitations associated with the technology.

Prerequisites

In order to easily follow along with this guide it is recommended to have the following:

  • A basic knowledge of the Hammer editor and how to create functional, playable maps using it
  • A version of Momentum Mod from version 0.8.8 or onwards
  • The momentum.fgd file in your Hammer configuration

Introduction

What Are Portals?

World portals are placeable entities that emulate a connection between two points, such as the example pictured below. Portals can have many uses for mappers attempting to push their creativity or for those stuck in Hammer-related corners.

Portal Image

The way that portals are drawn is by rendering a complete extra copy of the world on the far end of the connection and drawing it in addition to the physical world that the player interacts with. For that reason alone it is highly recommended to limit the number of portals visible at any given time to help player framerate if at all possible.

The maximum amount of portals that can be on screen at once is 4! This limit can be ignored with the r_portal_fastpath 0 command at the cost of potential framerate issues.

How to Make a World Portal

The linked_portal_door Point Entity

The entity used to create a world portal is linked_portal_door. Key values of note include:

  • Name - The name by which other entities refer to this entity
  • Pitch Yaw Roll - The orientation of the entity and 3 dimensional space. This is essential for determining which direction the portal will be created
  • Linked Partner - The name of the other linked_portal_door to create a portal with
  • Half-Width - The distance in Hammer Units to either side of the entity. This will determine how wide the portal is on compilation.
  • Half-Height - The distance in Hammer Units above and below the entity. This will determine how tall the portal is on compilation.
  • Start Active - Whether or not this portal will be active as soon as the map loads. If set to false, an input from another entity is required to make the portal functional.

half-width and half-height should typically match between the two entities at either end of the connection, otherwise players may see visual artifacts or get stuck in geometry.

The rotation of either linked_portal_door, however, do not have to match! Creating two portals that have different orientations will cause the player's camera to automatically correct itself on the other end of the portal.

How to Place a Portal.

In order to create a portal a linked_portal_door entity must be placed in the center of the desired location. Orientation is determined by the rotation of the point entity. In the 3D viewport the red axis points to where the open face of the portal will be, the green axis is where the half-width value will be used, and the blue axis is where the half-height value will be used.

Gizmo

Warning! Portals cannot be placed too close to a wall, otherwise the player can get stuck going through them!

The minimum distance between a portal's entity and the wall behind it should be about 32 units. In order to add a portal flush with a wall a setup like the following can be used:

Door

Common Uses of Portals

Impossible Hallway

An impossible hallway is one that is appears to be longer or shorter than it truely is and can serve as an excellent introduction to using portals to simulate non-euclidean geometry. A minimum of two pairs of portals will need to be used in order to extend the hallway for this type of effect. An example of the basic layout necessary can be seen below:

Impossible Hallway

In order to create a fully seamless transition using a portal all details at either end must identical. This includes mundane issues such as props, texture allignment, and particles. However, lighting calculations do not factor portals into their calculations and thus must be manually replicated on both ends to make the seam completely invisible.

Impossible Roundabout

Another common illusion that uses world portals is an impossible roundabout. An impossible roundabout will include multiple separate rooms that each have multiple portal entities connecting them to the previous/next area. An example of such a layout can be seen below:

Impossible Roundabout

A series of half-rooms are used with 2 portals per wall, one leading to the next room and one to the previous. It is important to keep the pattern of left/right and forward/back consistent so that players move reliably from room to room. For example, in this orientation the left portal (from the perspective of a player) will send them to the next box. The right portal will send them to the previous one.

Hiding the Map Through a Skybox

Skybox brushes are notorious for showing any parts of the world behind them that are being rendered. While this may seem inconvenient, it is up to the mapper to avoid. In movement gamemode maps people often want to use and abuse skyboxes in ways that cause this issue to pop up more than the standard Half-Life 2 or Portal 2 level would run into. One common example would be trying to use a skybox as a wall like below:

Skybox Issue

There are many solutions to an issue with skyboxes like this one. Typically, a portal should be the last resort as it has a negative effect on performance. The easiest fix is to change the geometry of the map so that the skybox cannot see any other parts of the map. This could mean removing the skybox and using another light, this could mean rearranging how the map is laid out, or it could mean adding a few extra walls between the skybox and visible area:

Skybox Wall

Given that a skybox simply layers itself behind any other section of the level that is being rendered, traditional optimization tools can be used in many scenarios to hide the problematic section of the level much easier than a portal, except with the added bonus of better performance.

While this is out of the scope of this guide, interlopers.net has an excellent guide about this subject that should help anybody trying to use traditional optimization to hide something behind a skybox.

If adding a portal is truly the best option, it can be relatively straightforward to implement. The portal must go somewhere between the skybox that is being looked through and what is being seen through the level.

Skybox Portal Placement

The map is then cut in two (leaving space to make sure the portals are not placed too close to any wall) and the final layout can look like so:

Skybox Portal

Helpful Portal References