Bukkit

This plugin allows simultaneous teleportation of all entities (players, mobs) within a portal to another existing portal. Portals are shaped as "phone booths" of different sizes (larger ones allow teleportation of larger parties, but are more expensive to build).

No commands are required for creating, destroying, and selecting the destination of each portal; all this is done through simple interactions with the elements of the portals. Commands are provided for administrative purposes. Supports permissions and internationalized messages (for the users; debug messages are always in English, for now).

The plugin is intended mostly for fun, not necessarily as a tool for sysops, but it might come in handy when friends want to go together to some minigame such as SkyWars from a central "hub".

Usage

Portals consist of booths of 3x3, 5x5, 7x7, 9x9 or 11x11 blocks wide (the maximum radius can be changed in the configuration file via the variable max_booth_radius, by default 5). The walls of the booth must be made of a special material (configurable), by default Quartz blocks. No material is required for the ceiling (it may actually lack a ceiling). Also, the booth must contain three other elements: a door on one side, a sign above the door, and a sign inside the booth, facing the door. As an example, a 5x5 booth will require 46 quartz blocks, two signs and a door.

The sign above the door gives the unique name to the portal. The sign inside the booth is used for choosing the destination: each time you right click on it, it cycles through all available portals (nowhere is a special name meaning that it leads, well, nowhere). Only destination portals which are as large as the source portal may be selected (otherwise entities may be teleported into walls).

The portals are finished with the door, and also destroyed door-first. You cannot destroy any other portal element while the door is in place.

To activate the portal, the user must close the door from the inside of the booth. All entities within the both will then be teleported to the chosen destination, to locations relative to where they were standing in the source portal.

Commands

There is a single main command, "booth", which accepts sub commands from within. If invoqued without any other arguments, it will explain the available sub commands. They are rather standard, self explaining commands for saving, restoring, listing, enabling and disabling the portals.

Credits

While 100% of the code was written by myself, I learned a lot by inspecting and fiddling with the TravelPortals plugin. I wish to thank the author for making his code available so that we all can learn.

Source code

The code is maintained in GitHub. Here is the link: https://github.com/nacho-pancho/super-booth-portals.git