Portal Warning

Bring Portal-inspired traversal into Content Warning: place a blue portal and an orange portal, see through the linked openings, walk or fall through, and carry your momentum out the other side.

Experimental beta, for Content Warning 1.24.0. All players in the lobby need this mod and the same version. Solo-host gameplay is tested; multiplayer synchronization is implemented but has not been verified with two players.

Features

• A blue/orange portal pair for each player, placed on stationary, flat solid surfaces.
• Live portal views using the game's Universal Render Pipeline.
• Player traversal through walls, floors and ceilings, with velocity redirected by the portal orientation.
• Source-inspired ground acceleration, friction, air steering, constant airborne gravity and jumping.
• Hold Ctrl to crouch, with a check before standing up under a low ceiling.
• A real Portal Gun pickup that spawns beside the video camera each time the camera is spawned at the surface.
• The starting gun stays suspended beside the camera so it cannot fall off the narrow porch railing. After pickup, dropping or throwing it uses normal physics.
• Uses the game's inventory slots, pickup interaction and drop/throw controls. Portals can only be fired while the gun is equipped.
• Optional official Portal world-gun model and texture loaded directly from your own installed copy of Portal, with an original procedural fallback.
• Dual-colour crosshair, placement status and speed display.
• Middle-mouse carrying for loose physics objects that your client owns. Host-owned loose objects can travel through portals too.
• Switch back to Content Warning's usual equipment whenever you need to record or use an item.

Controls

Keyboard and mouse are required for portal-device controls. The game's existing interactions, inventory, oxygen, health, recording and progression remain in place. The mod HUD leaves the game's survival information visible.

Install

Use Thunderstore Mod Manager or r2modman. Select Content Warning, install Portal Warning, and launch Modded. BepInEx is installed as a dependency. Everyone in a co-op lobby should use the same mod profile.

For a local ZIP, use the mod manager's Settings → Import local mod option and select the package. Install the dependency separately if your manager does not resolve dependencies for a local import.

This package adds one plugin DLL. It does not replace, patch on disk, or include any default Portal or Content Warning files. Runtime changes stop when the mod is disabled and the game restarts.

Configuration

After the first modded launch, edit BepInEx/config/peter.portalwarning.cfg inside your mod-manager profile, or use the manager's config editor. Restart the game after changing settings.

You can adjust walking and crouching speeds, ground and air acceleration, friction, jump speed, gravity, FOV, the clear key, the HUD, and portal rendering. For better performance, lower PortalViewResolution or turn off LivePortalViews.

To use the official model, install the original Portal (2007) in a Steam library on the same PC. The mod searches Steam's library folders automatically. If needed, set PortalInstallDirectory to the full installation folder, for example C:\Program Files (x86)\Steam\steamapps\common\Portal. The loader reads the VPK archives into memory without modifying or exporting them. Portal 2 and other Source models are not supported. Without a supported Portal installation, the original fallback model is used automatically. This changes the model and base texture; Valve's animations, shaders, sounds and arms are not imported.

Limits

• This is an original adaptation of Portal's main traversal mechanics, not an exact copy of its engine, menus, animations or levels. It does not add test chambers, gels or Portal puzzles.
• Surfaces must have enough flat space for the whole portal. There is no Portal-style material classification in Content Warning, so stationary solid surfaces are eligible.
• Recursive portal rendering is not enabled. Live views are capped at 40 updates per second per visible portal.
• Players stay upright during travel. Velocity follows the full portal rotation, but the character's body is not allowed to remain upside down.
• The ragdoll controller still affects motion; movement and fling timing are an approximation of Portal.
• Monsters do not traverse portals. Physics-object traversal is restricted to objects the host owns; other clients cannot take control of another player's objects.
• Network portal synchronization is experimental. Use private modded lobbies. This mod is not marked compatible with unmodded lobbies.
• Other mods that replace movement, gravity, player physics, FOV or camera rendering may conflict.
• Select another inventory slot before using ordinary mouse-controlled equipment. G is no longer needed.
• Custom item IDs depend on runtime registration order. Everyone should have the same mod profile and version; other custom-item mods may conflict. Multi-client item pickup and late joining have not been verified.

Credits and source

An unofficial fan mod. Portal is a Valve game; Content Warning is a Landfall game. No Valve or Landfall game code, textures, models, music or sounds are redistributed in this package. The fallback device, portal visuals, icon and synthesized tones are original. The optional official gun belongs to Valve and is read locally from the user's Portal installation.

The implementation was created with AI assistance and is disclosed as AI generated. Source is included in Source/PortalWarning-source.zip for inspection and rebuilding; it contains no game assemblies.

License

The original mod source and procedural assets are MIT licensed. See LICENSE.

Changelog

0.3.0

Removed Source walking, friction, air acceleration, crouch, sprint, jump, gravity, drag, fall-reaction and FOV overrides. Uses Content Warning's normal movement. Corrected the official model's upside-down orientation and anchors its visual to the actual right hand. The native item, inventory slot and FixedJoint retain pickup/drop/throw behavior. Added a native Steam Workshop build with no BepInEx dependency.

0.2.0

Portal Gun is now a real pickup beside the surface video camera. It occupies an inventory slot, equips through the game's normal controls, and can be dropped or thrown and picked up again. Firing is restricted to the equipped gun. Added an optional read-only importer for the official Portal (2007) world model and base texture from a local Steam installation; no Valve assets are included. The previous G toggle has been removed.

0.1.0

First experimental release: paired portals, live views, player and owned-object traversal, momentum redirection, Source-inspired movement, hold crouch, original portal device and HUD. Built for Content Warning 1.24.0.