Unlocking New Dimensions: A Deep Dive into BBL Portals for Minecraft
Vanilla Minecraft limits you to just two portal types — the obsidian Nether portal and the rare End portal. But what if you could design your own gateways, build them from any block, and link them to any dimension you can imagine? That is exactly what the BBL Portals mod delivers. It hands you the creative keys to craft fully customized portals using KubeJS scripts or direct Java integration, all while fixing long-standing bugs from older portal mods.
What Is BBL Portals?
BBL Portals is a Minecraft mod that lets players and modpack creators define custom portals to any dimension. Whether you want a shimmering gateway to a custom mining world or a spooky passage to a boss arena, this mod makes it possible. It draws inspiration from Custom Portal API and Portal JS, but reimagines them with better performance, fewer crashes, and deeper customization. You can even replace both of those older mods with BBL Portals, as it uses the same KubeJS integration syntax, making migration painless.
Core Features That Set It Apart
The mod shines through its flexibility and polish. Here are the standout features that make BBL Portals a must-have for dimension-hopping adventures:
- Any-Block Frames: You are not locked into obsidian or end stone. Build the portal frame from dirt, diamond blocks, or even modded materials — the choice is yours.
- Dual Portal Styles: Choose between a Nether portal-like vertical plane or an End portal-like horizontal surface. Each behaves exactly as you would expect.
- Texture Customization: The inner portal block can display one unified texture or up to three different textures, allowing animated or layered visual effects.
- KubeJS & Java Support: Script your portals with KubeJS for easy modpack integration, or tap into the Java API for direct mod development.
- Jade Compatibility: When you look at a portal block, Jade (or WTHIT) will display the target dimension, so you always know where you are heading.
One of the most practical upgrades is the bug-fixing layer. Older portal mods often crashed with Sodium installed, especially when using colored portals or lighting them with flint and steel. BBL Portals squashes those crashes and resolves other stability issues, giving you a smooth experience even in heavily modded environments.
Seamless KubeJS Integration
If you have ever scripted portals with Portal JS, you will feel right at home. BBL Portals uses the same event-based system, so you can copy over your existing scripts with minimal changes. The wiki (available on the mod’s GitHub page) provides clear examples for defining portal frames, setting ignition items, and linking dimensions. This compatibility means you can finally retire Custom Portal API and Portal JS without breaking your modpack.
How to Get Started
Using BBL Portals is straightforward whether you are a player or a pack developer. For script-based setups, you will write a KubeJS server script that listens for the portal creation event, then specify the frame blocks, activation item, and destination. For direct mod integration, you can call the API from your own Java mod. The official wiki contains step-by-step guides for both methods, so you can have your first custom portal running in minutes. Installing the mod itself is even easier — a modern launcher like foxygame.net lets you browse and install BBL Portals right from its menu, along with any dependencies, keeping your mod list organized and up to date without hunting for files manually.
Fixes and Quality-of-Life Improvements
Beyond customization, BBL Portals addresses several pain points that plagued earlier portal mods:
- Sodium and Iris no longer cause crashes when rendering colored portals.
- Using flint and steel on a custom portal no longer results in unexpected client freezes.
- Portal blocks now correctly display their destination dimension when using Jade, eliminating guesswork.
- Overall performance is smoother, with fewer tick-related hiccups during teleportation.
These fixes make BBL Portals a reliable backbone for dimension-based modpacks, even on large servers.
Credits and Community
BBL Portals stands on the shoulders of Custom Portal API and Portal JS. Without the groundwork laid by those projects, this mod would not exist. The developer actively maintains the mod and welcomes feedback. You can join the BBL Discord server to report bugs, suggest features, or just chat with fellow dimension crafters. For those who want early access to upcoming mods and modpacks, a Patreon membership is available, offering alpha builds and behind-the-scenes development insights.
Why BBL Portals Deserves a Spot in Your Modpack
Custom portals are more than a gimmick — they are a storytelling tool and a gameplay mechanic rolled into one. BBL Portals gives you that power without the instability of older alternatives. Its tight KubeJS integration, wide block compatibility, and thoughtful fixes make it the go-to choice for Minecraft 1.18.2 and beyond. Whether you are designing a progression system that gates dimensions behind rare materials or simply want a quick way to jump between your base and a mining dimension, this mod delivers with elegance and reliability.
So grab your favorite building blocks, fire up your scripting environment, and start bending the rules of space and time. With BBL Portals, the only limit is your imagination — and maybe the height of your frame.
--- **Update Jul 4, 2026:** Added 2 files for version 26.1.2 (NeoForge).