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






About this Mod
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.
Available Versions
How to Install PortalGunMod on Your Server
Order Server
Order a Minecraft Java server with at least 3 GB RAM (4 GB recommended).
Set fabric Loader
In the panel under "Egg", select the fabric loader and matching Minecraft version (1.21.11).
Install Mod
Open the mod browser in the dashboard and search for "PortalGunMod". Click "Install" – done! Alternatively, upload the .jar via SFTP to the /mods folder.
Compatibility
Mod Loaders
Minecraft Versions
1.21.11, 1.21.10, 1.21.9 (+8 more)
Server-side
✓ RequiredRecommended RAM
4 GB(min. 3 GB)Frequently Asked Questions
PortalGunMod server crashes on startup – what to do?
Most common cause: wrong fabric version or insufficient RAM. Check the server log (latest.log) for "OutOfMemoryError" or "Mixin" errors. With Mado Hosting: ensure at least 3 GB RAM is allocated and the loader matches the mod version (1.21.11). You can switch loaders with one click in the panel.
Is PortalGunMod compatible with fabric?
PortalGunMod officially supports fabric for Minecraft 1.21.11, 1.21.10, 1.21.9. The Mado dashboard automatically detects incompatible loader combinations.
Server lagging with PortalGunMod – how to optimize performance?
Recommended RAM: 4 GB (per 8 players). Use /spark profiler to check if PortalGunMod consumes the most tick time. Common fixes: reduce server view-distance to 8-10, install "performant" or "starlight" as supplementary mods on Forge. With Mado Hosting, your server runs on NVMe SSDs with dedicated CPU cores for minimal latency.
Similar Mods
Rent Modded Server
Install PortalGunMod with just one click on your server.