Custom Portals
🟡 Updated this year⚠️ Install Order · 2 steps
Install in this order, then this mod last — most mods fail to load without their framework and dependencies in place.
Preview

🔍 Analysis
- 👍 0.0% endorsement rate
- 🏆 #122 of 653 adventure mods in this game by downloads
📋 About This Mod
<p style="text-align: center;"><img src="https://i.imgur.com/6D50SAz.png" width="2560" height="1417" /></p> <p style="text-align: center;"><span style="font-size: 24px; font-family: verdana, geneva, sans-serif;"><strong>Now with portals in any shape!</strong></span></p> <p style="text-align: center;"><span style="font-size: 18px; font-family: verdana, geneva, sans-serif;"><strong>Versions 3.4.0 and above require <a href="https://modrinth.com/mod/yacl">YetAnotherConfigLib</a>.</strong></span></p> <p style="text-align: center;"> </p> <p style="text-align: center;"><span style="font-size: 24px; font-family: verdana, geneva, sans-serif;"><strong><img src="https://i.imgur.com/0dsN3ni.png" width="709" height="399" /></strong></span></p> <p style="text-align: center;"><span style="font-family: verdana, geneva, sans-serif; font-size: 14px;">Custom Portals is a mod for Minecraft that allows you to construct inter- and intradimensional portals out of any block.</span></p> <p style="text-align: center;"> </p> <p style="text-align: center;"><span style="font-family: verdana, geneva, sans-serif; font-size: 18px;">Please read the FAQ before posting an issue!</span></p> <p style="text-align: left;"><span style="font-size: 18px; font-family: verdana, geneva, sans-serif;"><strong>Installation</strong></span></p> <div class="spoiler"> <p style="text-align: left;"><span style="font-family: verdana, geneva, sans-serif; font-size: 14px;">Custom Portals is a Fabric mod. To use this mod, you will first need to <a href="https://fabricmc.net/use/">i</a><a href="https://fabricmc.net/use/">nstall Fabric.</a> You will also need the <a href="https://www.curseforge.com/minecraft/mc-mods/fabric-api">Fabric API</a>. For versions prior to the release for 1.18.1, you will also need the <a href="https://www.curseforge.com/minecraft/mc-mods/cardinal-components">Cardinal Components API.</a><br /></span></p> <p style="text-align: left;"><span style="font-family: verdana, geneva, sans-serif; font-size: 14px;">Navigate to your .minecraft folder and place the .jar file you downloaded, along with the .jar for the Fabric API & Cardinal Components API, into the "mods" folder. Launch Minecraft, and the mod should be installed.</span></p> </div> <p> </p> <p style="text-align: left;"><span style="font-size: 18px; font-family: verdana, geneva, sans-serif;"><strong>Getting Started</strong></span></p> <div class="spoiler"> <p style="text-align: left;"><span style="font-size: 14px; font-family: verdana, geneva, sans-serif;">To construct portals, you will need to craft portal catalysts. These are crafted with four ender pearls, four eyes of ender, and any dye, like so:</span></p> <p> </p> <p><span style="font-size: 14px; font-family: verdana, geneva, sans-serif;"><img style="display: block; margin-left: auto; margin-right: auto;" src="https://i.imgur.com/DIW7Dn6.png" alt="" width="509" height="290" /></span></p> <p style="text-align: center;"> </p> <p style="text-align: left;"><span style="font-size: 14px; font-family: verdana, geneva, sans-serif;">Once you have your portal catalysts, you'll want to build frames for your portals out of the block of your choice. The frames can be any size and shape (for versions before 3.2.0, they must be rectangular).<br /></span></p> <p style="text-align: left;"><span style="font-size: 14px; font-family: verdana, geneva, sans-serif;">When you're done, right click on the inside of the frame with your portal catalyst, and the portal will activate. Do the same where you want the other portal to be. If both of your portals are made out of the same materials and are within range, they will automatically link to each other and you will be able to travel between them. Portals that are linked will have an animated, lit-up texture and emit particles. By default, you will spawn in the center of your portal. You can change your portal's spawn position by shift-right-clicking the portal block you want to set it to with an empty hand.<br /></span></p> </div> <p style="text-align: left;"> </p> <p style="text-align: left;"><span style="font-size: 18px;"><strong><span style="font-family: verdana, geneva, sans-serif;">Applying a redstone signal to a portal now turns it off!</span></strong></span></p> <p style="text-align: left;"><span style="font-size: 14px;"><span style="font-family: verdana, geneva, sans-serif;">Want to make portals that are only one way? Want to turn your portal off when you're not using it so that mobs don't wander in? Versions for Minecraft 1.19 and above allow you to do so with redstone!</span></span></p> <p style="text-align: left;"> </p> <p style="text-align: left;"> <span style="font-size: 18px; font-family: verdana, geneva, sans-serif;"><strong>New in Versions 2.0.0 and above: Runes</strong></span></p> <div class="spoiler"><span style="font-family: verdana, geneva, sans-serif; font-size: 14px;">In version 2.0.0+, portals that are made out of the same material will no lon

Now with portals in any shape!
Versions 3. 4. 0 and above require YetAnotherConfigLib.

Custom Portals is a mod for Minecraft that allows you to construct inter- and intradimensional portals out of any block.
Please read the FAQ before posting an issue!
Installation
Custom Portals is a Fabric mod. To use this mod, you will first need to install Fabric. You will also need the Fabric API. For versions prior to the release for 1. 18. 1, you will also need the Cardinal Components API.
Navigate to your .minecraft folder and place the .jar file you downloaded, along with the .jar for the Fabric API & Cardinal Components API, into the "mods" folder. Launch Minecraft, and the mod should be installed.
Getting Started
To construct portals, you will need to craft portal catalysts. These are crafted with four ender pearls, four eyes of ender, and any dye, like so:

Once you have your portal catalysts, you'll want to build frames for your portals out of the block of your choice. The frames can be any size and shape (for versions before 3. 2. 0, they must be rectangular).
When you're done, right click on the inside of the frame with your portal catalyst, and the portal will activate. Do the same where you want the other portal to be. If both of your portals are made out of the same materials and are within range, they will automatically link to each other and you will be able to travel between them. Portals that are linked will have an animated, lit-up texture and emit particles. By default, you will spawn in the center of your portal. You can change your portal's spawn position by shift-right-clicking the portal block you want to set it to with an empty hand.
Applying a redstone signal to a portal now turns it off!
Want to make portals that are only one way? Want to turn your portal off when you're not using it so that mobs don't wander in? Versions for Minecraft 1. 19 and above allow you to do so with redstone!
New in Versions 2. 0. 0 and above: Runes
📊 Mod Details
- Game
- Minecraft Mods
- Author
- Palyon-dev
- Version
- 4.0.0
- Downloads
- 294,595
- Endorsements
- 141
- Category
- adventure
- Created
- 2/28/2023
- Updated
- 6/3/2026
- Game Versions
- 26.1.2
- Tags
- adventure, magic, transportation
🔧 How to Install Minecraft Mods Mods
Download from Modrinth. Use Prism Launcher or drop into your mods folder.
📖 Full step-by-step install guide for Minecraft Mods →
Visit the official mod page for specific installation instructions for this mod.
🎮 Need cheat codes or console commands? Check ur gaming wiki for Minecraft Mods commands, item IDs, and more.
❓ Frequently Asked Questions
Which Minecraft Mods versions does Custom Portals support?
The author lists 26.1.2. Other versions may work but are untested by the author.
What is the latest version of Custom Portals?
Version 4.0.0, published 2026-06-03 with 294,595 downloads recorded at the source.
Keep browsing — more Minecraft Mods mods await