(1.13.2 Ready) ⍟ Simple Portals ⍟ - Effective Regional Portals (BungeeCoord Compatible) 1.2.7

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

  1. JKMODz
    Tested Minecraft Versions:
    • 1.7
    • 1.8
    • 1.9
    • 1.10
    • 1.11
    • 1.12
    • 1.13
    Source Code:
    https://github.com/XZot1K/SimplePortals
    Contributors:
    XZot1K
    Please note that all configurations are defaulted to the latest version supported; therefore, all materials, sounds, and effects will need to be changed to their correct values absed on your MC version.
    [​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)

    ⍟ Commands & Permissions ⍟

    Code (Text):
    ⍟ Commands ⍟

    * /simpleportals <selectionmode/sm> - Toggles the player in and out of selection mode which allows them to create a region.

    * /simpleportals list - lists all currently avaliable portals.

    * /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 <setlocation/sl> <name> - sets the teleport location of the specified warp.

    * /simpleportals <showregion/sr> <name> - displays the specified portal's region.

    # Please note that to remove a server from a portal you must set it to 'none'.
    * /simpleportals <switchserver/ss> <name> - sets the server the portal will teleport a player to.

    * /simpleportals <addcommand/addcmd> <name> <command> - this command adds a command line that will be ran when a player enters the portal
    (Spaces must be replaced with underscores and you are able to add :PLAYER or :CONSOLE to the end of the command to determine how the command is ran).

    * /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.

    (Note: By typing an invalid command it will display a usage message.)



    ⍟ 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.

    ⍟ Media ⍟

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


    Servers Using SimplePortals:
    Contact to have yours added here

    Code (Text):
    mc.thecrafters.net - (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:
    Code (Text):
    [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.

    ⍟ Extras ⍟

    * 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".

    * 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 ran 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.

    ⍟ 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.
    Code (Text):
    * 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.

    * 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.


    ⍟ Contact ⍟

    Discord: XZot1K#7490
    Email: [email protected]

    ⍟ Terms of Use ⍟

    Please do NOT use code from this plugin and call it your own. That is pretty much the only thing I ask! :)

Recent Updates

  1. ⍟ 1.2.7 (Large Update) ⍟
  2. ⍟ 1.2.7_SNAPSHOT (Moderate Changes) ⍟
  3. ⍟ 1.2.6-F (Tiny Update) ⍟

Recent Reviews

  1. rapidsave
    rapidsave
    5/5,
    Version: 1.2.6-C
    plugin is sick works live a charm contacted owner and stuck in some commands for me like a boss get this plugin if you need portals +aaaaa
    1. JKMODz
      Author's Response
      I appreciate the awesome review! Glad you are enjoying the plugin!
  2. oldfart
    oldfart
    5/5,
    Version: 1.2.5-B
    Awesome. Working great with Bungeecord. I was so frustrated not been able to find portals plugin that works with Bungee and Spigot 1.13.x Thank you so much for great job.
    1. JKMODz
      Author's Response
      Of course! I appreciate the awesome review. I'm so glad you are enjoying the plugin! Be sure to reach out to me if you have any suggestions or issue reports. :)
  3. Porkchop
    Porkchop
    5/5,
    Version: 1.2.5
    Excellent plugin. Works perfectly. -=[]\;'./!)@(#*$$&%^ (filler text) ---------- :)
    1. JKMODz
      Author's Response
      I appreciate the review, hope you are enjoying the plugin!
  4. Dimo4ka
    Dimo4ka
    5/5,
    Version: 1.2.4-C
    An excellent plugin, as well as a responsive developer, helped me in discord! I advise this plugin, it is very cool
    1. JKMODz
      Author's Response
      I appreciate the review! Glad you are enjoying the plugin!
  5. muddup
    muddup
    5/5,
    Version: 1.2.4-B
    After finding a bug, got a hold of the author and the response was excellent. Author found the issue and fixed it right away.
    This is an excellent plugin, one that was needed for our survival server.
    Kudos to the Author!!! A definite plus for all server owners!!! Thanks!
    1. JKMODz
      Author's Response
      I appreciate the awesome review! :)
  6. SirLemonade
    SirLemonade
    5/5,
    Version: 1.2.2
    Perfect portal plugin, easy and efficient. Quick fix when there is an issue. use it a lot on my server. Left a good review on a previous version and i am writing a review again just to say how this version is just as perfect.
    1. JKMODz
      Author's Response
      Thank you very much for the review, I am glad we could solve that issue for you! Merry Christmas and Happy New Year!
  7. PyraFox
    PyraFox
    5/5,
    Version: 1.1.9
    Brilliant little plugin - little bit difficult to figure out how to use but the developer is friendly and quick to respond via Discord.
    1. JKMODz
      Author's Response
      I appreciate the review! The plugin is being adjusted slowly to become more user-friendly, but since the plugin doesn't require dependencies it had to have its own creative process which is a lot like worldedit. Suggestions are always welcome!
  8. SirLemonade
    SirLemonade
    5/5,
    Version: 1.1.9
    Awesome plugin. Couldn't be more perfect. It's easy and efficient, i use it a lot on my server.
    1. JKMODz
      Author's Response
      Thank you for the awesome review, I'm glad you are enjoying the plugin!
  9. bloody921
    bloody921
    5/5,
    Version: 1.1.7
    Thank you for this, it's simple and effective and speedy. My users are happy because you keep your users happy :-)

    I am also getting the bug with same-world portal destinations resetting to one of the points(-2y) in the portal region itself on reload. worked around this by making the portal "command only" mode and using warp from EssentialsX.
    1. JKMODz
      Author's Response
      I appreciate the awesome review! And this issue should have been fixed within 1.1.7; however, other operations are taking place to confirm the fix.
  10. heromode
    heromode
    5/5,
    Version: 1.1.3
    plugin port that I have searched for long, nice
    -----------------------------------------
    1. JKMODz
      Author's Response
      Thank you for the review, so glad you found what you were looking for! :)