Minecraft Mods

Portals v2.0 (Paper Plugin)

  • 8,512 views, 29 today
  • 842 downloads, 3 today
  • 22
  • 20
  • 15
IotaSphere avatar IotaSphere
Level 34 : Artisan System
[ Portals v2.0 (Port) ]

Portals 2.0 is a Paper plugin port of my datapack which adds portal structures to the game.
The portals can travel anywhere in Minecraft and across dimensions. They don't naturally generate and you must craft the spawner to place a portal.

Get the datapack here.

[ Spawning and Despawning ]
To craft a spawner, drop a diamond, end crystal, ender pearl and prismarine crystals atop a respawn anchor. You'll get a spawn egg to place down. The spawn egg displays the bounding box of the portal and will rotate depending on your rotation.

To despawn a portal, place a tnt block on the DHD ( where the soul torch would go ) and confirm by pressing "Yes". The portal will be removed and all items (except for the diamond) will be returned.

[ Using a Portal ]
To activate a portal, place a soul torch on top of the center pillar. Once the torch slides into place, a keypad will open. Using the keypad, enter the ID of the target portal. Portal IDs are displayed above the center column upon activation. To get a list of all portal IDs, use the "/listportals" command. Once the ID is entered, press the blue symbol "-=[@]=-" at the bottom of the keypad. If the ID is valid, the portal will open. By default, portals are one-way (inbound connections show up as red). This can be changed in the config explained below.

Note: You cannot dial yourself.

[ Commands ]
Below is a list of all commands for this plugin. Commands with a red asterisk " *" require an operator to execute
  • * /givespawnegg - Gives the executer a portals spawn egg
  • * /opentimeout - Sets or gets the time (in ticks) until a portal automatically closes
  • * /primedtimeout - Sets or gets the time (in ticks) until a portal automatically un-primes
  • * /keepoldportalframes - Sets or gets whether deleting a portal removes the structure
  • * /updateportalids - Sets or gets whether removing a portal updates other portal IDs to remain synchronous
  • * /showspawneggboundingbox - Sets or gets whether the spawn egg displays its bounding box
  • * /allowduplex - Sets or gets whether two way portals are allowed
  • * /opentimeoutpercent - Sets or gets the percentage of the open timeout a portal will stay open after passing through
  • * /reloadportalstructures - Forcefully reloads all structures; removes any changes to them
  • * /setportalid - Sets the ID of a portal (new ID must be available)
  • * /dialportal - Attempts to open a connection between two portals
  • * /closeportal - Attempts to close a portal
  • * /lockportal - Locks one or more portals; locks all portals if no ID is supplied
  • * /unlockportal - Unlocks one or more portals; unlocks all portals if no ID is supplied
  • * /createportal - Creates a new portal at the set coordinates
  • * /deleteportal - Deletes a portal with the specified ID
  • /listportals - Lists all portals, their location, ID, state, and dimension
  • * /portals2.0 - Opens the Portals plugin configuration manager

[ Portal States ]
Portals have a total of 7 different states, though only 6 matter.
  • IDLE - The portal when idle
  • PRIMED - The portal when a player inserted a soul torch
  • OUTBOUND - The portal during an outbound connection
  • INBOUND - The portal during an inbound connection
  • BLOCKED - The portal if there are non passable blocks inside of the ring
  • LOCKED - The portal when locked
  • SWITCHING - The portal when switching between the other 6 states

[ Other Notes ]
Inbound portals be default display with red particles. Entering the inbound side of a connection will result in your death (does not apply to creative players). This can be disabled by setting the "allowduplex" to true. Duplex portals will show green particles on the inbound side and will simply teleport you back to the dialing portal.

All entities are capable of teleporting through the portals, just in case you have any pets. Just keep in mind that they will need to exit the event horizon before their cooldown wears off ( about 5 seconds ), in which case they might die.

You can block a portal by placing a non-passable block inside of the inner ring. While blocked, the portal will not accept inbound connections and cannot make outbound connections. Locked portals will also refuse any connections.

Any portal in the end will automatically lock if an ender dragon is present. Once the ender dragon is defeated, the portals will unlock.

For non-standard worlds (not any of the 3 base game dimensions), there is a "default_portal" option in the config file for specifying which portal structure to use. Valid portal structure values are "overworld", "nether", and "ender"
You can also specify in the config file, the namespaced key for your world (ex. minecraft:overworld) and a portal structure to use for that world. (Not fully tested so if it doesn't work please leave a comment indicating such)

Example config file
//replace mynamespace:myworldname with the name of your world and set the value to one of "overworld", "nether", or "ender"

For any issues or feedback, leave a comment below.
Progress100% complete
Game VersionMinecraft 1.19.2

5 Update Logs

Update vD-2.1.2 vP-1.2.1 : by IotaSphere 03/10/2023 5:15:31 pmMar 10th

Overhauled how commands are parsed
Allowed commands to be run from the console

Create an account or sign in to comment.

01/24/2023 6:08 amhistory
Level 1 : New Miner
Ijven avatar
I was trying out this plugin but removing portals did not work.
Got the following message:

"Unknown or Incomplete command, see below for error
/SetConfirmBoolean 1 0 <--[​HERE]"

I figured since last remark mentioned uppercase characters I'd retype it with lower case and that worked but this means the UI in chat is broken.

I was hoping this plugin would work with MyWorlds plugin, adding a propper way to link portals instead of just teleporting to the last location you were in. But it seems not to work in the non standard worlds.

Can this be fixed/added?
Great plugin in any case!

Kind regards!
01/24/2023 3:31 pmhistory
Level 34 : Artisan System
IotaSphere avatar
Also added config options for allowing portals in other dimensions
Quick fix is to go into config file ("Portals 2.0/config.txt") and adding the line "default_portal=overworld"
You can replace overworld with one of "overworld", "nether", or "ender"
Also also, for individual worlds, you can specify in config file the name of your world and the portal to use (one of "overworld", "nether", or "ender")

For example, if your world is called "Ijven:myworld", add the line "Ijven:myworld=overworld" or whichever portal to use.

Not fully tested so if you get an error comment and send the log so I can fix it.
01/24/2023 12:18 pm
Level 34 : Artisan System
IotaSphere avatar
Issue should be resolved
Seems I forgot to change some of the internal command names to lowercase
All of them should be fixed now
11/07/2022 4:05 pm
Level 1 : New Miner
Jamo_XD avatar
this plugin doesnt seem to work on my paper 1.19.2 server. is it only for lower versions?
11/07/2022 4:09 pm
Level 34 : Artisan System
IotaSphere avatar
will look into it.
any way for you to share log file?
11/10/2022 11:50 am
Level 34 : Artisan System
IotaSphere avatar
Issue resolved
seems to be minecraft no longer likes commands with uppercase characters (which were all of my commands)
09/12/2022 10:25 am
Level 1 : New Miner
ekekekek avatar
Is there any way you could make this for fabric 1.19? I’m looking to add it to a server, and a plugin this well-developed would be an amazing addition
03/26/2022 10:32 amhistory
Level 1 : New Miner
EnKz avatar
IotaSphere Can you port this to bedrock? there is no updated bedrock teleport/waypoint/waystome/quick travel/portal mods, which makes these type of mods well sort after, the MCPE community would see you as there savior :D

I play the windows 10 version - MCPE, due to my friends play minecraft on mobile, and i got this version so i could play with them, however theres no updated portal mods out there, i have made a dedicated server for us all to play on, using https://www.minecraft.net/en-us/download/server/bedrock for windows, and some mods can be problematic with it, but most work as far as i know

Also i think this is what Diamondee was attempting to ask you also..
03/26/2022 5:08 pm
Level 34 : Artisan System
IotaSphere avatar
EnKz and Diamondee
I'll look into porting but I can't make any promises
I'll have to learn behavior packs and how to make them
04/11/2022 8:22 am
Level 1 : New Miner
EnKz avatar
IotaSphere Any luck learning the bedrock behaviour packs, and porting the the mod to bedrock? :)
Planet Minecraft


© 2010 - 2023