How to Install and Use the Portal Gun Mod in Minecraft

Portal Gun Mod Overview

The Portal Gun mod brings Valve-style portal travel into Minecraft, giving players a new way to move through builds, caves, bases, and dangerous areas. Instead of walking every block like a responsible miner, you can place linked portals and step through them instantly.

This Forge mod lets you craft a portal gun, create paired gateways, view the other side in real time, and even move certain blocks or objects around. It is useful for exploration, building, quick escapes, and general multiplayer chaos. To run it on a server, both the client and server need the mod installed, along with its required dependency, iChunUtil.

Downloading the Files

Start by downloading the correct files for the Minecraft version you want to use. Portal Gun is version-sensitive, so the mod, dependency, Forge profile, and server version all need to match.

• Open the Portal Gun page on CurseForge and select Files.

• Find the file that matches your intended Minecraft version.

• Open the three-dot menu beside that file, then choose Download File.

• Save the downloaded `.jar` somewhere easy to find.

• Repeat the same process for iChunUtil, since Portal Gun depends on it to work correctly.

Installing Portal Gun on Your Client

Forge must be installed in the Minecraft Launcher before the mod can load. Once Forge is ready, add both Portal Gun and iChunUtil to the client-side `mods` folder.

• Open the Minecraft Launcher and go to Installations.

• Find your Forge installation, then click the folder icon for that profile.

• In the folder that opens, enter the `mods` directory. If it does not exist, create a folder named `mods`.

• Move the Portal Gun and iChunUtil `.jar` files into that folder.

• Return to the launcher and start Minecraft with the Forge profile.

If Minecraft fails to launch, check that the downloaded mod files match the exact Forge and Minecraft version being used.

Installing Portal Gun on a Server

Your Minecraft server also needs Forge installed before Portal Gun can run. In your hosting panel, select the Forge server version that matches your client, then restart once so the server can generate its folders.

After Forge is ready, upload the same mod files to the server.

• Open your server panel and go to the FTP or file manager section.

• Enter your password, then log in to the file manager.

• Open the `mods` folder. If it is missing, create it after Forge has been installed and the server has started at least once.

• Upload both Portal Gun and iChunUtil, then wait until the upload reaches 100%.

• Return to the main server page and restart the server.

Players joining the server must have the same matching client-side mods installed. A server can have the fanciest portal gun in the world, but a mismatched client will still refuse to cooperate.

Getting Started In Game

Once the server is running and you can join successfully, the next step is gathering materials for the portal gun. The recipe uses several rare resources, so expect to spend time hunting endermen, visiting the Nether, and defeating the Wither.

Installing a recipe viewer such as JEI is recommended if you want an easier way to confirm crafting patterns in game. Portal Gun includes custom items, and JEI helps prevent the usual crafting-table staring contest.

Gathering Ender Pearls

The portal gun recipe chain requires 8 ender pearls for one gun. Endermen are the standard source, and the End dimension is usually the fastest place to farm them once you have access.

A sword with Looting can speed up the process by improving drop rates. If you are still in the Overworld, search at night or in warped forests in the Nether. Either method works, but farming in the End is far more efficient for multiple portal guns.

Making Ender Pearl Dust

After collecting the ender pearls, smelt them in a furnace with any fuel source. Each ender pearl becomes ender pearl dust, which is needed for the next custom crafting step.

You need 8 ender pearl dust for one portal gun. If several players want their own, multiply the material cost before starting. There is no alternate recipe for this dust, so ender pearls are unavoidable.

Crafting a Miniature Black Hole

The miniature black hole is the hardest custom component. To make it, you need the ender pearl dust and a nether star, which means summoning and defeating the Wither.

For survival servers, prepare properly before the fight. Bring strong armor, plenty of healing, and choose a controlled area where the Wither cannot casually remodel your base. If cheats are enabled or you are an operator, the required items can also be spawned for testing.

Portal Gun Recipe

Once the miniature black hole is crafted, gather the remaining recipe items:

• 5 iron ingots
• 1 diamond
• 2 obsidian
• 1 miniature black hole

Place the items in the crafting table according to the mod recipe to create the portal gun. Repeat the process for extra guns if needed.

Each player has their own portal channel, which helps prevent portals from mixing together across the server. That matters on multiplayer worlds where several people may be using portal guns at once.

Using the Portal Gun

Hold the portal gun and use left-click or right-click to place the linked portals. The portal colors vary based on the active channel. Once both portals are placed, players and some entities can pass through them.

Portals also show a live view of the connected side, so you can look through before stepping in. This is useful when checking a dangerous cave, moving between base floors, or creating quick routes across a large build.

One simple trick is placing one portal at a low point and another at a higher ledge to climb without stairs. Another is lining portals up so movement continues through both repeatedly. It is fun, slightly disorienting, and not recommended right after spinning your camera for no reason.

The portal gun can also move blocks or objects. Hold the portal gun, press `G`, then right-click to release the object. This can help with building, repositioning items, or experimenting with the mod's physics.

Helpful Controls

Controls may vary depending on version and keybind conflicts, but these are the common actions:

• Left-click: fire one portal color
• Right-click: fire the other portal color
• `G`: pick up or move supported blocks and objects
• Minecraft controls menu: change conflicting keybinds if another mod uses the same key

If a key does nothing, check Options, then Controls, then search for Portal Gun-related bindings.

Common Problems

The server will not let players join

Make sure Portal Gun and iChunUtil are installed on both the server and every player client. The Minecraft version, Forge version, and mod versions must match. A 1.12.2 mod build, for example, belongs with the matching 1.12.2 Forge setup.

If other mods are installed, test Portal Gun and iChunUtil by themselves in a clean profile. This helps identify whether another mod is causing a conflict.

The mod loads on the client but not the server

Confirm that the `.jar` files were uploaded to the server's `mods` folder, not the root directory or a nested folder. Restart the server after uploading. If the `mods` folder does not exist, Forge may not be installed or the server may not have completed its first startup.

Minecraft crashes on launch

Crashes usually come from missing dependencies, mismatched versions, or conflicting client mods. Install iChunUtil, verify the Minecraft and Forge versions, then test with only Portal Gun and iChunUtil in the `mods` folder. Allocating more launcher memory may also help if the game runs out of RAM.

Portals cause lag

Portal rendering can be demanding because the mod shows a real-time view through the gateway. Lowering graphics settings, reducing render distance, and improving server performance may help, but some lag is tied to how the mod works. If the issue happens only with heavy modpacks, test Portal Gun in a smaller setup.

Useful References

• Portal Gun on CurseForge
• How to install Forge for Minecraft
• How to add mods to a Minecraft server
• How to become a Minecraft server operator