Back to mods
PortalGunMod project artwork

Modrinth · Minecraft mod

PortalGunMod

Portal‑style traversal for Fabric 1.21.11 with custom sounds, clean visuals, and momentum‑accurate teleportation.

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

Quick answer

Which PortalGunMod release should I use?

Updated 11 days ago
Latest stable file 1.2.0
Game version 1.21.11
Loader Fabric

PortalGunMod 1.2.0 targets 1.21.11 with Fabric. Installation on the client is optional. Installation on the dedicated server is optional. No extra mods listed for this file.

Where it goes

Is PortalGunMod required on the client, server, or both?

Installation on the client is optional. Installation on the dedicated server is optional.

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

The source marks this as usable on both the client and server.

What else does PortalGunMod 1.2.0 need?

1.2.0. 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 PortalGunMod without breaking your instance.

Built for PortalGunMod 1.2.0. Pick another file and the loader, install side or required mods may change.

  1. 01

    Stick to this file

    Use 1.2.0. It targets 1.21.11 with Fabric; 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

    Installation on the client is optional. Installation on the dedicated server is optional.

  4. 04

    Pick the file you checked

    Use the “Get this file” button beside 1.2.0. It opens that exact file at the source.

About this project

What does PortalGunMod add?

TikTok -- https://www.tiktok.com/@butterboyrs115
To allow me to keep making mods -- buymeacoffee.com/ButterBoyRS

Portal Gun brings Portal-style traversal and physics to Fabric 1.21.11, with smooth portal placement, momentum-preserving teleportation, grabbing, throwing, portal viewing, and a polished first-person Portal Gun experience.

Fire a blue and orange portal onto valid walls, floors, or ceilings, then move through them while keeping your speed and direction intact. Each player gets their own portal pair, making the mod multiplayer-friendly without portals interfering with each other.

The goal is simple: make portal movement feel fast, clean, and satisfying while staying as close as possible to the style and behavior you’d expect from Portal.

✦ Features
Blue and Orange Portals
Place portals on solid surfaces including walls, floors, and ceilings with automatic orientation and alignment.

Momentum-Based Teleportation
Players, mobs, arrows, snowballs, and other supported projectiles preserve their velocity when traveling through portals.

Portal View Rendering
Look through one portal and see a pixelated view from the other side, including support for portals across dimensions.

Personal Portal Pairs
Every player has their own blue and orange portals, keeping multiplayer gameplay clean and independent.

Portal Stability
Portals automatically fizzle if the blocks supporting them are removed.

Portal-Style First-Person Animations
The Portal Gun features custom recoil, muzzle effects, claw movement, and clearing animations instead of standard Minecraft hand motion.

Custom HUD Reticle
Portal-style reticle indicators show portal availability and active portal status while holding the gun.

Grab Tool
Press G to grab nearby mobs and hold them in front of you.

Block Grabbing
Pick up and move supported solid blocks, including Monster Spawners, while preserving their block entity data.

Throwing
Launch grabbed mobs or blocks using left-click or right-click while grab mode is active.

Moon Portals
At night, portals placed on the moon can create a black-hole effect that pulls nearby players, mobs, entities, and supported blocks toward it.

Portal Gun Pedestal
Display your Portal Gun on a custom Aperture-inspired pedestal designed to fit the mod’s clean sci-fi look.

Custom Sounds
Dedicated sounds for firing, teleporting, clearing portals, grabbing, releasing, and other Portal Gun actions.

✦ Controls
V — Clear your portals
G — Grab or release mobs and supported blocks
Left/Right Click while grabbing — Throw the held object

✦ Design
Portal Gun is built around smooth movement, clean visuals, responsive physics, and a strong Portal-inspired style without adding bulky portal frames or unnecessary setup.

The mod is still actively being developed, so new mechanics, visual improvements, and refinements will continue to be added over time.

Project description from Modrinth.

Pick your setup

PortalGunMod by Minecraft version and loader

Choose the version and loader you play, then open the matching release.

11 available setups

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

Recent files

PortalGunMod versions and loaders

2 of 2 releases match

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