Differences

This shows you the differences between two versions of the page.

--- tutorial:custom_portals [2022/08/16 20:54] – external edit 127.0.0.1
+++ tutorial:custom_portals [2025/10/16 17:15] (current) – Specify how to make a portal which is lit with fire donillia
@@ Line 1: / Line 1: @@
-FIXME //This page hasn't been updated in a while, and may not work in the future updates. //
 ====== Creating a custom portal to access your dimension ======
@@ Line 26: / Line 24: @@
 </code>
-**Note:** You need to choose the right version for your mod. The library works currently for 1.16 - 1.18.
+**Note:** You need to choose the right version for your mod. The library works currently for 1.16, 1.18 and 1.19.
 ===== Registering your Portal =====
@@ Line 34: / Line 32: @@
 The portals created using the CustomPortalApi act like vanilla portals, and can be as big as 23×23.
-<code java>
+<code java>;
-//  CustomPortalApiRegistry.addPortal(Block frameBlock, Identifier dimID, int r, int g, int b)
-CustomPortalApiRegistry.addPortal(Blocks.GOLD_BLOCK, new Identifier("my_mod_id", "my_dimension_id"), 234, 183, 8);
+CustomPortalBuilder.beginPortal()
+        .frameBlock(Blocks.GOLD_BLOCK)
+        .lightWithItem(Items.ENDER_EYE)
+      //.lightWithFluid(Fluids.WATER)
+        .destDimID(new Identifier("my_mod_id", "my_dimension_id"))
+        .tintColor(234, 183, 8)
+        .registerPortal();
 </code>
+If you want it to be lit with fire, however, you will need to call ''.customIgnitionSource'' passing in ''PortalIgnitionSource.FIRE''.
 Now, this would create the following portal (Custom Portals can work in any dimension!):
@@ Line 47: / Line 54: @@
 <code java>
-//  CustomPortalApiRegistry.addPortal(Block frameBlock, PortalIgnitionSource ignitionSource, Identifier dimID, int r, int g, int b)
-CustomPortalApiRegistry.addPortal(Blocks.NETHERITE_BLOCK, PortalIgnitionSource.FluidSource(Fluids.LAVA), new Identifier("my_mod_id", "my_dimension_id"), 51, 52, 49)
+CustomPortalBuilder.beginPortal()
+        .frameBlock(Blocks.NETHERITE_BLOCK)
+        .lightWithItem(Items.ENDER_EYE)
+      //.lightWithFluid(Fluids.WATER)
+        .destDimID(new Identifier("the_end"))
+        .tintColor(45,65,101)
+        .registerPortal();
 </code>
-Now we have a cool netherite portal that can be lit by using lava and a golden portal!
+Now we have a cool netherite portal that can be lit by using lava and a golden portal that can be lit by using an eye of ender!
 {{https://raw.githubusercontent.com/kyrptonaught/customportalapi/main/images/2020-11-15_17.06.44.png}}