(1.16 Ready) ⍟ Simple Portals ⍟ - Effective Regional Portals (BungeeCord Compatible) 1.6.3

A simple yet effective way to create portals for your server!

  1. XZot1K
    Native Minecraft Version:
    1.16
    Tested Minecraft Versions:
    • 1.8
    • 1.9
    • 1.10
    • 1.11
    • 1.12
    • 1.13
    • 1.14
    • 1.15
    • 1.16
    Source Code:
    https://github.com/XZot1K/SimplePortals
    Contributors:
    XZot1K
    I currently use DedicatedMC as the official ZotWare testing server. If you need something powerful in terms of hardware without digging a hole in your pocket give them a shot and let me know how you like them!
    [​IMG]

    [​IMG]

    What is Simple Portals?

    Simple Portals is the simplest, yet effective way to create region-based portals. The plugin was heavily tested on many large live servers and put under stress to ensure performance was optimal. Simple Portals also allows the teleporting of players across your bungee cord server without even using the bungee cord API!

    ⍟ Features ⍟
    • Packet particle visuals for selections, region display, and other immersive effects.
    • Object-oriented portals making the API very easy to manipulate and modify specific portals.
    • No dependencies (Everything is developed from scratch within the plugin)
    • Per-portal permissions
    • Command Sympathy (Many commands have abbreviations for easier use)
    • Fluids and other movable materials are frozen in the portal regions.
    • Optimized Code (As stated above the plugin was thoroughly tested on multiple servers and developed with plenty of care)
    • Bungee Coord server switching (This feature uses the plugin channel, therefore, it communicates with the bridge server)
    • Lightweight Update checker (Checks for newer versions once every time on enable)
    • Powerful Developer API (Enough methods and events to take full control)
    • Simple To Manipulate (All commands and features are made to be used with ease)
    • Auto-Updating Configuration
    • Entity Portal Transfer (Items, Vehicles, etc. can all teleport through portals maintaining velocity and more!)
    • Nether/End Portal Destination Replacement - Ability to replace where nether/end portals take players per-world without the need of custom created portals!


    ⍟ Commands ⍟
    (Note: By typing an invalid command, a usage message will be displayed.)​
    • /simpleportals <selectionmode/sm> - Toggles the player in and out of selection mode which allows them to create a region.
    • /simpleportals reload - reloads all configurations.
    • /simpleportals info - provides information about the plugin.
    • /simpleportals create <name> - creates a new portal if the player's region is full created.
    • /simpleportals delete <name> - deletes a existing portal.
    • /simpleportals fill <name> <material> - attempts to fill the portal with the defined material (directional support is partial, meaning some materials may be better placed or created before portal creation).
    • /simpleportals <setlocation/sl> <name> - sets the teleport location of the specified portal to the sender's location.
    • /simpleportals <setlocation/sl> <name> <name> - sets the teleport location of the specified portal to the center of the other entered portal.
    • /simpleportals <showregion/sr> <name> - displays the specified portal's region.
    • /simpleportals <enable/disable> <name> - enables/disabled the portal entirely untiled toggled again
    • /simpleportals <switchserver/ss> <name> <server> - sets the server the portal will teleport a player to.
      • # Please note that to remove a server from a portal you must set it to 'none'.
    • /simpleportals <addcommand/addcmd> <name> <command> - this command adds a command line that will be run when a player enters the portal (You are able to add a colon followed by PLAYER or CONSOLE to the end of the command to determine how the command is run).
    • /simpleportals <clearcommands/clearcmds> <name> - this command simply clears the commands in the list.
    • /simpleportals <togglecommandonly/tco> <name> - this command toggles command only mode for a portal.
    • /simpleportals <commands/cmds> <name> - provides a list of all commands on the defined warp in the order they were added.
    • /simpleportals message <name> <text> - sets the message of the specified portal to the specified text (A colon followed by NORMAL, BAR, TITLE, or SUBTITLE can be used to define the type of message to be set).
    • /simpleportals <disablemessages/dm> <name> - disables all messages associated with the defined portal.
    ⍟ Permissions ⍟
    • simpleportals.showregion - Allows the player to view a portal's region.
    • simpleportals.setlocation - Allows the player to set a portal's teleport location.
    • simpleportals.info - Allows the player to view the plugin's information.
    • simpleportals.reload - Allows the player to reload the configuration files.
    • simpleportals.create - Allows the player to create a portal.
    • simpleportals.delete - Allows the player to delete a portal.
    • simpleportals.list - Allows the player to list all portals.
    • simpleportals.switchserver - Allows the player to change the server a portal can teleport a player to using BungeeCord.
    • simpleportals.selectionmode - Allows the player to enter/exit selection mode.
    • simpleportals.portal.* - Allows the player to use all portals.
    • simpleportals.portal.<name> - Allows the player to use the specified portal.
    • simpleportals.addcommand - Allows the player to add a command to the specified portal.
    • simpleportals.clearcommands - Allows the player to clear all commands from the specified portal.
    • simpleportals.togglecommandonly - Allows the player to toggle command only mode for a portal.
    • simpleportals.viewcommands - Allows the player to view the commands of a portal.
    • simpleportals.toggle - Allows the player to toggle a portal entirely.
    • simpleportals.message - Allows the sender to use the message command for portals.
    • simpleportals.dm - Allows the sender to use the disable messages command for portals.
    • simpleportals.fill - Grants access to the portal fill commands.
    ⍟ Media ⍟

    The showcase below was provided by @Ajneb97, he did a wonderful review highlighting some major and smaller features of SimplePortals. At the time of recording, SimplePortals v1.2.8 was being used. He covered some Version Specific issues that may occur and other very specific tweaks you can accomplish in the config (Though some things were changed/fixed in newer versions). Many thanks to him!


    The showcase below was provided by Lucas Gaspareto, many thanks to him for the awesome showcase! (Please note that this video was made using an early v1.2 build)


    Servers Using SimplePortals:
    Contact to have yours added here
    • mc.thecrafters.net - (Using mainly for server-based portals)
    • Galacticamc.com:25570 - (Using mainly for server-based portals)
    If you create a tutorial on this plugin, please let me know as I will post it here!

    Below is a very brief look at the region visual display during the portal create process:
    [​IMG]

    ⍟ Plugin Usage ⍟

    SimplePortals is made to be, well... simple! Therefore the portal creation process is quite straightforward. Please find instruction below:

    [NOTE] - The "Selection Mode" command is a toggle, meaning when ran once it will enable and twice it will disable.

    • Step 1) - In order to create a portal, you must first enter "selection mode" by using the command "/portals selectionmode" or "/portals sm".
    • Step 2) - The next step is to "left-click" the lowest block at the end of a cuboid or rectangular region and then "right-click" the highest block in the opposite corner of the region. This will set your current selection for any portals you wish to create soon.
    • Step 3) - To finish off the portal creation process you must use the command "/portals create <portal name>" to create the portal using your WorldEdit-Like selection.
    • Step 4) - From this point, you have a created portal. Now by default the destination, the portal will teleport the user to will always be set to the lowest-block or Point-1. To change the portal's destination, use the command "/portals setlocation" or "/portals sl" at the location you wish your portal to take you to.

    Below is some extra information:
    • You can fill a portal's region with a specific material by using the "/portals fill <portal name>" command (Don't worry all liquid-based materials will not flow out of the region).
    • You can relocate the portal's region by using the "/portals relocate <portal name>" command after making another selection in "selection mode".
    • For commands and some other features in the plugin, use {player} as the placeholder to obtain the player's name.
    • To make a portal teleport the player to another server via Bungee simply set the server name using the command "/portals switchserver <portal name> <server>". You can set this value to "none" to disable the feature for a portal.
    • As for adding commands to be run by the portal when entered you can add them using the "/portals addcommand <portal name> <command>" command. To remove the commands you may use the "/portals clearcommands <portal name>" command.
    • When adding a command ensure NOT to use a slash.
    • Always END IT WITH A COLON followed by either PLAYER or CONSOLE. Another that can be used since v1.3.6 is CHAT which sends the command into chat for other plugins to use as fake commands!
    • Similar to command adding, setting a portal's message requires a type. Behind the entered text, simply add either :NORMAL, ':BAR, :TITLE, or :SUBTITLE to indicate which message should be set (INCLUDE THE COLONS).
    ⍟ Developer API ⍟

    Currently, everything in the API can be found in the API package inside the plugin which can be found on the GitHub page. However, below you can find the API class names and their purpose.
    • Manager (Class) - this stores all general methods, calculations, and storage lists or maps.
    • PointType (Enum) - this is used inside the listener for the region selection.
    • Portal (Class Object) - this is an entire object that stores all information about a single portal.
    • Region (Class Object) - this is an entire object that stores all information about a region (Coordinates and Locations).
    • SerializableLocation (Class Object) - this is used to serialize a location and prevent future changes to the same location.
    • TaskHolder (Class Object) - this is used to store the visual effect tasks for each player. This class also manages them to make sure not too many are shown at once.
    • [Removed in 1.4.3] PortalActionEvent (Event Object) - this event is called when a player is teleported by a portal.
    • PortalEnterEvent (Event Object) - this event is called when a player enters a portal's region.
    ⍟ FAQ ⍟

    (Q) Users are teleported to the nether/end when using a dedicated portal material for a simple portal.


    (A) This issue has been reported before, a majority of the time this is due to world manipulation plugins such as Multiverse or MultiWorld. Please ensure you test without the world plugin and also use their latest build (dev build) to ensure it was not something that was resolved.

    (Q) I'm getting an error/message involving the "simpleportals.cdbypass" permission node. How can I resolve this?

    (A) This is not actually an issue, the message is to notify the user who is either OP or has the permission that they have bypassed the cooldown for the feature. This message can be disabled by setting it to "" in the lang.yml.

    (Q) I'm getting an error in the console and I'm unable to teleport or use portals in general. How can I resolve this?

    (A) The plugin is native to the latest version of Minecraft; therefore, older versions may need tweaking within the configuration. Normally in this case setting the particle options in the config.yml will resolve this issue for you.

    (Q) How can I disable the portal titles, action bar, or subtitle messages?

    (A) If the portal has not been created yet, setting the default messages in the lang.yml will disable them for all newly created portals. For already made portals you must either disable the plugin and set the messages to "" in the portals.yml or use the "/portals message <name> :NORMAL", "/portals message <name> :BAR", "/portals message <name> :TITLE", or "/portals message <name> :SUB-TITLE" commands to simply disable each one individually. As of v1.5.1, the command "/portals dm <name>" can be used to disable messages.

    ⍟ Contact ⍟

    For the best support experience please contact through the official support discord here!

    BEFORE requesting support check the FAQ section above ^^^

    Please try to avoid contacting the developer through a direct message.

    ⍟ Terms of Use ⍟

    Please do NOT use code from this plugin and call it your own or report issues/bugs within the review section. That is pretty much the only thing I ask! :)

Recent Reviews

  1. n1n
    n1n
    4/5,
    Version: 1.5.9
    Hey just wondering if there were any features implemented that could import files from other plugins? A server I play on and help with uses a very old plugin with the .yml.bac type of backups and couldn't tell if there were ways to import these old portals
    1. XZot1K
      Author's Response
      Please utilize the "Discussion" for questions and such, but at this time there are no importing features due to most other plugins handling data differently. SimplePortals requires a couple extra things; therefore, it is unable to convert that data. This does not mean it can't be added in the future; however, keep in mind that SimplePortals is built to be utilized on more of an admin level and portal creation is pretty quick!
  2. morose
    morose
    5/5,
    Version: 1.5.5
    Very very well made plugin. I have a few bugs here and there. Sometimes it glitches around but very rarely. If you clean up everything it works completely fine. I rely a lot on this plugin since its one of the core elements of my server (multiple dimensions and worls you unlock at higher ranks) And so far its working out very great. Biggest + is the usage of commands for the plugins and the ease to create them. Keep up the good work, thank you for making this.
    1. XZot1K
      Author's Response
      Hey there! I appreciate the review, new features and adjustments come as needed so of course if you have any interesting encounters be sure to report those. I'm always on the lookout for anything peculiar to resolve! The glitches you mention sound like it could have been anything ranging from how vanilla mechanics interact with the plugin and similar instances. I'd recommend maybe trying the plugin on a completely stock server if the glitch becomes replicable to ensure its not something like setting!
  3. FlyingMarkus
    FlyingMarkus
    3/5,
    Version: 1.5.4-B
    Its okay. When I try to fill out the portal the error message the portal freebuild does not exist. I cannot use the fill command even after reinstalling several times. I use MC 1.16.4
    1. XZot1K
      Author's Response
      Seems you caught a bad build-out of the mix! Some users reported some issues and they were resolved as soon as possible. Be sure to reach out if you encounter anything like this again! :)
  4. Itznewer
    Itznewer
    5/5,
    Version: 1.5.3
    This plugin is amazing. Thanks you so much. Its works well on 1.16.4
    Recommended!
    1. XZot1K
      Author's Response
      I appreciate the review! Glad you enjoy the plugin :)
  5. LH4005
    LH4005
    3/5,
    Version: 1.5.3
    When using it i want it to be as if it were a nether portal... But the problem is many of my admins go through the portals in gm c and they get tped in the nether first causing it to not work Though it works for peeps in survival
    1. XZot1K
      Author's Response
      Users have reported this several times, so far seems to be a MultiVerse issue. Most have stated the issue is resolved after updating to a dev build.

      In addition, use a proper support method, please.
  6. M45T3R
    M45T3R
    4/5,
    Version: 1.5.3
    Very good plugin it gets the job done, but can you do something about the LAG it causes?

    https://imgur.com/a/ei7EPec

    Seems like all the lag was being caused by this plugin for me on 1.16.4
    1. XZot1K
      Author's Response
      I appreciate the review!

      The BlockFromToEvent is due to water/lava movement. The plugin will only prevent water or lava flow if nothing else can. It's always better to utilize water or lava portals in a natural manner or utilize optimized configurations for your server jar.
  7. NahuelLeshuga
    NahuelLeshuga
    4/5,
    Version: 1.5.2
    Al usar el plugin, y al poner un comando, me sale nada
    ayudaa... ¿que puedo hacer para arreglarlo?
    1. XZot1K
      Author's Response
      Please reframe from posting issues in the review section; however, I will need some more information on this so please send me the error code you are encountering to evaluate it.

      As for some quick recommendations, make sure the JAR has been uploaded correctly (mainly just checking if there are multiple SimplePortals JARs in the plugin directory), double-check the config.yml for any mismatching sounds to your Minecraft version, and check for incompatibilities! One of these should resolve it for you :)
  8. FineAppleJuice
    FineAppleJuice
    5/5,
    Version: 1.5.1
    Very easy plugin to use and dev is active in answering questions. 100% recommended.
    1. XZot1K
      Author's Response
      Glad to hear it! Enjoy!
  9. weedorpy
    weedorpy
    5/5,
    Version: 1.5.1
    very very good plugin!!
    everything i need! switch server, run comand! very full. Thank You ;D
    1. XZot1K
      Author's Response
      Of couse! Enjoy! ;)
  10. MoMOAH
    MoMOAH
    5/5,
    Version: 1.4.8-B
    Best Portal's plugin ever ! There are many useful features and without any lag! It is support the latest version 1.16.2 :) thanks!
    1. XZot1K
      Author's Response
      Must appreciated! :)