CurseForge · Minecraft mod
Custom Portal API Reforged
Forge port of Fabrics Custom Portal API, updated for newer versions of MC.
Quick answer
Which Custom Portal API Reforged release should I use?
Custom Portal API Reforged customportalapi-reforged 1.7.0 targets 1.21.10 with NeoForge. The project page does not say whether this file belongs on the client, dedicated server, or both. No extra mods listed for this file.
Where it goes
Is Custom Portal API Reforged required on the client, server, or both?
The project page does not say whether this file belongs on the client, dedicated server, or both.
The source does not explicitly classify this release as client-only or server-only.
What else does Custom Portal API Reforged customportalapi-reforged 1.7.0 need?
customportalapi-reforged 1.7.0. Change the file and its required mods may change too.
This file does not list any required mods. Do not add a library just because a different file uses it.
This file does not list any required or optional mods.
Before you install it
Add Custom Portal API Reforged without breaking your instance.
Built for Custom Portal API Reforged customportalapi-reforged 1.7.0. Pick another file and the loader, install side or required mods may change.
- 01
Stick to this file
Use customportalapi-reforged 1.7.0. It targets 1.21.10 with NeoForge; another release may have different loader, side or dependency requirements.
- 02
Bring the mods it needs
This file does not list any required mods. Do not add a library just because a different file uses it.
- 03
Put it on the correct side
The project page does not say whether this file belongs on the client, dedicated server, or both.
- 04
Pick the file you checked
Use the “Get this file” button beside customportalapi-reforged 1.7.0. It opens that exact file at the source.
About this project
What does Custom Portal API Reforged add?
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.
Project description from CurseForge.
Pick your setup
Custom Portal API Reforged by Minecraft version and loader
Choose the version and loader you play, then open the matching release.
1.21.9
1 loader build1.21.6
1 loader build1.21.5
1 loader build1.21.1
1 loader build1.20.6
1 loader build1.20.4
1 loader build1.20.2
1 loader build1.20.1
2 loader buildsCheck the dependencies, then try the file in a copied instance before changing a world you care about.
Recent files
Custom Portal API Reforged versions and loaders
customportalapi-reforged 1.7.0
cpapireforged-neo-1.21.10-1.7.0.jar
28 Nov 2025
customportalapi-reforged 1.6.0
cpapireforged-neo-1.21.9-1.6.0.jar
1 Oct 2025
customportalapi-reforged 1.2.2
cpapireforged-neo-1.21.1-1.2.2.jar
8 Jul 2025
customportalapi-reforged 1.5.0
cpapireforged-neo-1.21.6-1.5.0.jar
25 Jun 2025
customportalapi-reforged 1.4.0
cpapireforged-neo-1.21.5-1.4.0.jar
21 May 2025
customportalapi-reforged 1.2.1
cpapireforged-neo-1.21.1-1.2.1.jar
8 Mar 2025
customportalapi-reforged 1.0.11
cpapireforged-neo-1.21.1-1.0.11.jar
22 Nov 2024
customportalapi-reforged 1.0.10
cpapireforged-neo-1.21.1-1.0.10.jar
25 Sept 2024
customportalapi-reforged 1.0.10
cpapireforged-neo-1.21.1-1.0.10.jar
25 Sept 2024
customportalapi-reforged1.20.6 1.0.8
cpapireforged-neo-1.20.6-1.0.8.jar
30 Jun 2024
customportalapi-reforged 1.0.6
cpapireforged-neo-1.20.4-1.0.6.jar
30 Jun 2024
customportalapi-reforged1201 1.0.4
cpapireforged-1.0.4.jar
30 Jun 2024
Looking for an older file? The official CurseForge project page is in Resources.