Portal Customization
This mod provides a new block called "Portal Helper". You can build two frames using that block and use flint and steel to light one. Then a new two-way two-faced portal will be generated. The portal's rotation and scale transformation will adapt to the shape difference.
If no linkable frame is found, it will generate a new frame nearby.
Unlike nether portals, the generated portal won't break when the frame breaks. To remove the portal, you need to use the command /portal delete_portal or /portal eradicate_portal_clutter (See below).
The portal helper cannot link to a frame that's far away or in another dimension. However, you can use commands to edit the portal and set the portal destination to any position in any dimension.
Portal helper generates unbreakable portals and is intended to be used in creative mode. To use similar functionality in survivial mode, you can configure a similar custom datapack portal generation. It generates breakable portals, and the frame block can be specified as any block.
Every portal entity is a one-faced and one-way portal. A normal nether portal is bi-faced and bi-way, it consists of 2 portal entities in the overworld and 2 portal entities in the nether, 4 portal entities in total.
Command /portal delete_portal will only remove one portal entity.
Command /portal remove_connected_portals makes the portal one-way and one-faced.
If it's used for a bi-way bi-faced portal, the portal entity that you are targeting will remain and the other 3 portal entities will be removed.
Command /portal complete_bi_way_portal will create the "reverse" version of the portal entity thus make the portal bi-way. Command /portal complete_bi_way_bi_faced_portal creates 3 portals to make the portal bi-way bi-faced.
Command /portal eradicate_portal_clutter removes the whole portal. If used to a bi-way bi-faced portal, all 4 portal entities will be removed.
If you want to edit a bi-way bi-faced portal, 4 portal entities need to be edited. It's recommended to firstly use /portal remove_connected_portals to make only one portal entity remain. Then you can move the portal or change its space transformation without leaving unwanted portal entities. Then you can make this portal two-way and two-faced by /portal complete_bi_way_bi_faced_portal.
There are some portal-targeted commands for managing portals. You need to point to a portal entity when using these commands.
-
Change the portal entity's destination to the end:
/portal set_portal_destination minecraft:the_end 0 70 0 -
Delete a portal entity:
/portal delete_portal -
Change the portal's rotating transformation, rotating 45 degrees along the Y axis
/portal set_portal_rotation 0 1 0 45(0 1 0is the axis vector) . It's equivalent to/portal set_portal_rotation_along y 45 -
Rotate the portal entity itself around X-axis for 30 degrees (does not change the rotation transformation):
/portal rotate_portal_body 1 0 0 30. Equivalent to/portal rotate_portal_body_along x 30 -
Change the portal entity's scale transformation:
/portal set_portal_scale 5 -
Move the portal entity forward 0.5 blocks:
/portal move_portal 0.5 -
Make the portal entity not able to transfer entities, turning it into a "video surveillance":
/portal set_portal_nbt {teleportable:false} -
Make the portal round-shaped:
/portal make_portal_round -
Make the portal to damage the entities that cross this portal:
/portal set_portal_nbt {commandsOnTeleported:["/effect give @s minecraft:instant_damage 1"]}
See All Portal-Targeted Commands
Note: these portal targeted commands only affect one portal entity. To edit a bi-way bi-faced portal, it's recommended to use /portal remove_connected_portals first.
All portal targeted commands can be used by non-player command executors. If the command sender is a portal entity, the command will target that portal entity. For example /execute as @e[type=immersive_portals:portal] run portal set_portal_destination minecraft:the_end 0 80 0
Directly create a new square portal entity:
-
/portal make_portal 1 1 minecraft:the_end 0 80 0Create a portal with width 1 height 1 pointing to the end -
/portal make_portal 1 1 minecraft:overworld shift 5Create a portal whiches the destination is 5 blocks ahead of the position of the portal
You can create a small wrapping zone by /portal create_small_inward_wrapping <x1> <y1> <z1> <x2> <y2> <z2> /portal create_small_outward_wrapping <x1> <y1> <z1> <x2> <y2> <z2>
These commands create normal portals instead of global portals. Global portal wrapping zone commands (such as /portal global remove_wrapping_zone) does not affect them.
You can create a scaled wrapping by /portal create_scaled_box_view <x1> <y1> <z1> <x2> <y2> <z2> <scale> <placeTargetEntity> <isBiWay> [teleportChangesScale]
For example, if you want to create a box viewing the end island, use /execute in minecraft:the_end run portal create_scaled_box_view -100 0 -100 100 128 100 20 @p true
By using /portal set_portal_specific_accessor command you can make a portal entity only accessible for one player. By putting two different portal entities that are specific for two different players into the same place, you can create a portal that points to different destinations for different players.
You can manage overlapped portals using /portal multidest command.
(Portal targeted commands can still be used on the portal that's not accessible to you)
It's not recommended to "connect" two existing portals. The recommended way is to use /portal remove_connected_portals first, then edit the portal, then /portal complete_bi_way_portal.
You can use command /portal tpme <dimension> <x> <y> <z> to teleport yourself across dimensions without loading screen. If you accidentally go through a one-way portal and want to come back, you can use /portal goback