promotional bannermobile promotional banner

Custom Portal API Reforged

Forge port of Fabrics Custom Portal API, updated for newer versions of MC.

Custom Portal API Reforged 

Library mod allowing developers to create portals to their custom dimensions easily. These custom portals will function exactly like nether portals, except being fully customizable. You can control the frame block, portal block, tinting, ignition source, destination, and more!

Usage

Add the repository/mod to your build.gradle.

repositories {
maven { url 'https://maven.azuredoom.com/mods' }
}
dependencies {
//1.20.1
implementation fg.deobf('net.kyrptonaught.customportalapi:customportalapi-reforged:MODVERSION')

//1.20.2+
implementation "net.kyrptonaught.customportalapi:cpapireforged-neo-1.20.2:MODVERSION"

}

 

 

Now onto creating and registering the portal itself, this is simple thanks to the CustomPortalBuilder class. We will make use of this in FMLCommonSetupEvent.

The following is a very simple portal that will take us to The End, and is lit by right-clicking the frame with an Eye of Ender:

CustomPortalBuilder.beginPortal()
.frameBlock(Blocks.DIAMOND_BLOCK)
.lightWithItem(Items.ENDER_EYE)
.destDimID(new ResourceLocation("the_end"))
.tintColor(45,65,101)
.registerPortal(); 

 

A Nether portal would be registered as follows:

 CustomPortalBuilder.beginPortal()
.frameBlock(Blocks.OBSIDIAN)
.destDimID(new ResourceLocation("the_nether"))
.tintColor(131, 66, 184)
.registerPortal();

 

CustomPortalBuilder is filled with plenty of methods to customize the functionality of your portal, all of which are documented in the class.

 

Some noteworthy methods to mention:

- lightWithWater/Item/Fluid - These allow you to control how the portal is lit.
- onlyLightInOverworld - Only allow the portal to be used in the overworld to your destination of choice
- flatPortal - Flat Portal similar to the End or the Twilight Forest portal.

 

Credits

Based off the main Fabric mod HERE and an older ported mod HERE.

The Custom Portal API Reforged Team

profile avatar
  • 215
    Followers
  • 45
    Projects
  • 146.7M
    Downloads

More from AzureDoomCView all

  • AzureLib project image

    AzureLib

    • 49.3M
    • Mods

    Java Minecraft mod using Bedrock models to create custom models and animations for items, blocks, entities

    • 49.3M
    • April 21, 2026
    • Mods
  • Aftershock project image

    Aftershock

    • 241.7K
    • Mods

    Based on the Tremor series, this mod adds the Precambrian monsters of the deep into your Minecraft experience!

    • 241.7K
    • May 10, 2026
    • Mods
    • +1
  • Arachnids project image

    Arachnids

    • 55.9K
    • Mods

    Arachnids is a mod based on the first Starship Troopers movie and 2005 game about an alien race of bugs.

    • 55.9K
    • May 8, 2026
    • Mods
  • AzureLib Armor project image

    AzureLib Armor

    • 16.7M
    • Mods

    A striped down Azurelib just for Armor!

    • 16.7M
    • March 23, 2026
    • Mods
  • AzureLib project image

    AzureLib

    • 49.3M
    • Mods

    Java Minecraft mod using Bedrock models to create custom models and animations for items, blocks, entities

    • 49.3M
    • April 21, 2026
    • Mods
  • Aftershock project image

    Aftershock

    • 241.7K
    • Mods

    Based on the Tremor series, this mod adds the Precambrian monsters of the deep into your Minecraft experience!

    • 241.7K
    • May 10, 2026
    • Mods
    • +1
  • Arachnids project image

    Arachnids

    • 55.9K
    • Mods

    Arachnids is a mod based on the first Starship Troopers movie and 2005 game about an alien race of bugs.

    • 55.9K
    • May 8, 2026
    • Mods
  • AzureLib Armor project image

    AzureLib Armor

    • 16.7M
    • Mods

    A striped down Azurelib just for Armor!

    • 16.7M
    • March 23, 2026
    • Mods