Bukkit

CutePortals is a portal plugin that can transport players between servers under your BungeeCord, send commands from console after players arrive at their destinations or simply execute commands when someone enters a portal. It requires WorldEdit for portals setup.

Installation

To install CutePortals, please, follow these steps:

1. Download WorldEdit.jar from the plugin's page;
2. Download CutePortals.jar from this page;
3. Place downloaded jars into your Spigot's or Bukkit's /plugins/ folder;
4. Start your server and enjoy!

How to create a portal

Follow these steps to create a portal:

1. Build a nether portal or place nether portal blocks wherever you want;
2. Select a cuboid region with nether portal blocks using WorldEdit's wooden axe (wand);

3. Use: /cps create <server_name> <command at arrival>,
where server_name is the name of the target server and command at arrival is a command, that a server or a player should execute, when target player arrives at his destination.

Variables

{PLAYER} states for player's nickname;
{NONE} states for no server or for no command;
@ at the end of line states for command execution type changing.
If you understood nothing, see examples!

Examples

/cps create survival say Hello, world!

Portal created using this simple command works like this: when a player uses such portal, firstly he moves to a server named "survival" in your BungeeCord config. After he joins that server, command "say Hello, world!" is executed from the console.

NOTE: You should place CutePortals.jar into "survival" server /plugins/ folder too.

/cps create survival warp spawn {PLAYER}

This example is more interesting. When a player uses portal, created with this command, firstly he moves to a server named "survival" in your BungeeCord config and right after he joins it, the server executes the following command from console: "warp spawn Nickname". This means, that the portal transports your player not only to a server, but to a specific warp on that server!

NOTE: You should place CutePortals.jar into "survival" server /plugins/ folder too.

/cps create lobby spawn @

This works almost like an example above. Player goes to server named "lobby" and executes "/spawn" command. '@' at the end of the command string becomes a magic symbol: it tells target server, that command should be executed from >player<, NOT from >console<.

NOTE: You should place CutePortals.jar into "lobby" server /plugins/ folder too.

/cps create lobby {NONE}

This type of command you should use if you do not want target server or target player execute any commands on arrival. This means the same, as "/server lobby"

/cps create {NONE} warp spawn {PLAYER}

This type of command you should use in case if you don't want to use BungeeCord transportations. It works like this: player enters a portal and right after that console issues "warp spawn Nicky228" ({PLAYER} states for real player's name).

All commands

These useful commands can help you to create and manage portals:
/cuteportals - shows help menu with tips. You can also use /cps or /cportals aliases;
/cps create <server_name> <command to execute at arrival> - creates a portal using your WorldEdit selection;
/cps goto <server_name> <command to execute at arrival> - instantly go to a server and execute a command there.
/cps remove - removes portals from your WorldEdit selection.
/cps reload - reloads configuration and data.

More about GOTO command

Goto command was created for compatibility with item menu plugins like ChestCommands. It works like a portal, but without a portal. For example:

/cps goto lobby warp spawn {PLAYER}

When you execute this command, plugin will instantly teleport you to a server named "lobby" in Bungee settings and execute "warp spawn SuperPlayer15" from server console there. This command requires "cuteportals.create" permission (to disallow players send custom commands from console).

NOTE: You should place CutePortals.jar into "lobby" server /plugins/ folder too.

To link this feature with ChestCommands you should add an item to your menu.yml like this:

skywars:
  COMMAND: 'op:cps goto minigames warp skywars {PLAYER}'
  NAME: '&bSkyWars'
  LORE:
  - '&3Press this item to go to SkyWars warp at Minigames server!'
  ID: grass
  POSITION-X: 3
  POSITION-Y: 1

More info about how to use ChestCommands can be found here.

Permissions

cuteportals.create - Allows players to create portals. Default: op
cuteportals.use - Allows players to use portals. Default: true

Configuration

# Should the plugin perform active portal monitoring or not? If 'true', players will be teleported instantly when they
# enter a portal. If 'false', they will have to wait a little bit. For better performance on large servers it is
# recomended to set this to 'false'. 'true' option is usually suitable for lobbies.
UseQuickPortals: true

Problems and solutions

Q: I have enabled Nether world on my server and created a portal. Now this portal sometimes teleports player to Nether, but it should not! I attached different command to it!
A: This happens due to strange portal mechanics in Minecraft. Portal event fires not only when player is INSIDE portal, but also when player is NEAR portal. You can fix this issue by selecting not only portal blocks, but some space near them, like this:

After making WorldEdit selection in such way, use command for CutePortal creation as usual (see examples above).

Test server

login.mcraft.su - join and test!

Source code

Sources available at GitHub

If you have a problem, feel free to ask for solution! If you like this plugin, please, rate five stars!