Wuufu's Waygates is a gate plugin inspired by Creative Gates and Stargate, that allows players to create gates out of any material (minus a couple of key blocks) and connect them into interconnected networks without using a single command. The plugin is highly configurable, with an easy to pickup but deep permission system, as well as highly translatable, with every message provided for easy translation.

This project is licensed under the GNU General Public License version 3.

Creating Gates
Gates can be constructed out of any material providing there are two emerald blocks somewhere in the frame (configurable). Keep in mind that if the frame breaks so does the gate, so constructing the gate out of a strong material is advisable. Once the frame is constructed, a player must also construct a Waygate Constructor, which involves taking a gold nugget and surrounding it in redstone on a crafting table.



By clicking on the inside of the frame with this Waygate Constructor, the gate will be constructed. The inside space of a gate can be as small as a single block, or as large as 200 (also configurable). Mind where you stand when you create the gate, that location will be used as the exit location for the gate, though you can use a Waygate Constructor on a gate in the same way after it has been constructed to update the exit location.

Once a gate is constructed, it is given a random name and assigned to the Void network. The Void network is just that, void! No gates on the void network can see each other, and no users may travel between them (admins excluded). So given this, it is probably a good idea to rename your gate and assign it to a different network.

Using and Editing Gates
In order to use or modify a gate, you must first create a Waygate Key, which involves taking a feather and surrounding it in redstone on a crafting table.



Once this is done, you can right click on any part of the frame using your Waygate Key to bring up the gate's interface. This interface allows you to connect to other gates on the same network, change the settings of a gate (such as its name), and change the gate's network.

Gates can be set to be timed or always on. If you open a connection to another gate from a timed gate, the gate will remain open for 20 seconds (configurable) to allow you to pass through, and will close after the time has elapsed, ready to be opened to another destination. Always on gates will remain open permanently. In either case, the destination of the gate will always appear first in the gate selection list while the gate is active.

Gate's can additionally be private, that is no one but the owner can use a Waygate Key on or travel through it, or hidden, that is no one but the owner can see the gate on the network and travel to it. Those with the permission " wg.bypass" can bypass these constraints.

Players can also change the icon of the gate by right clicking on the frame with an appropriate item while sneaking. The gate will consume the item and change its icon to that item. If this item is a written book, the gate will instead consume it and use the text (up to 200 characters, configurable) as the gate's description.

Controllers
Waygate Controllers act as remote activators of Waygates, able to change the gates destination without being at the gate. These can be created using Control Creators.

Control Creators are crafted by putting a Waygate Key into the center of a crafting grid, and placing a Waygate Constructor to the left and right of it. You can then right click on a single block to generate a Waygate Controller at that block.

Waygate Controllers can be interacted with using either a Waygate Key or an empty hand. They can then be set to activate any Waygate within 50 blocks (configurable).

Fixed Destinations
One other setting that is applicable to gates is that a gate can have a fixed destination. Fixed destination means that gates can only open to that destination gate, even if there are other gates available on the network.

Gates that have fixed destinations can be activated by responding to powered blocks placed next to or on the gate frame. This means you can place pressure plates in front of the gate, or a button on the gate frame, and by activating these you activate and open the gate to the fixed destination. If the gate you are travelling from is private, or the gate you are travelling to is hidden, then the owner of the restricted gates needs to be the near the cause of the powering event for the gate to open.

Networks
There are six types of networks:

1. The Void network: a special system network in which no gates can see each other, and only admins can travel between them;
2. System networks: there are five system networks that are included by default... Overworld, Ocean, Nether, The End, and Underworld;
3. Global networks: these are custom defined networks available for everyone to join;
4. Invite networks: these are networks that a player can create and then invite other users to join and add gates to;
5. Private networks: these are networks that are private to the owner of the gates;
6. Fixed networks: these are like global networks in that anyone can join them, except only gates that the owner (or those the owner "invites" to the network group) can set their gates as not-hidden, all other gates are hidden by default providing a couple of fixed exits that are global to everyone

All of these networks are permissionable so that the server admin can decide who is allowed to create and/or add gates to any of these network types, with special permissions available for individual system, global and fixed networks (so you can permission them individually).

Players with the right permissions can assign their gates to networks of these types, or create their own networks out of the network list. Network icons are preset depending on the type of network, but can be changed by their network owners or server admins to a different icon entirely through the Network Settings menu.

Fixed Networks are unique in that by default they aren't granted to players in the permission sets. The idea behind them was for a server owner to be able to setup one or more exits gates accessible to anyone who connected to them. To prevent clutter in the network list, gates that aren't these exit gates would be auto hidden so only the exit gates would appear.

Entity Travel
Note: the entity travel system on Waygates is currently not working. The intention is to rewrite this system from the ground up focused on modern API usage.

In addition to being able to transport players, Waygates are also able to transport other entities. Specifically, any creature or object a player is riding, such as a horse or boat, will also transport itself through the gates and the player will emerge still riding. Likewise, any creature the player has leashed will reappear on the other side in a safe location, still leashed.

Finally, dropped items or uncontrolled creatures can also pass through Waygates and will drop on the other side at the exit point, but this only works for gates that are using the Nether effect and are connected to gates also using the Nether effect.

You should make sure there is enough room on the other side for the creatures you wish to transport, or you may find yourself or your creatures suffocating.

Commands
For server admins, there are a few commands that are available for use. These allow server admins to list gates in a world and delete them from that world, which is useful for multiworld servers.

" /wg list [world] [page]" gate list per world
" /wg delete <world>" delete all gates in world
" /wg reload" reload config file

See Full Commands List

Permissions

See Full Permissions List

Configuration

See Configuration Info

Optional Integrations

• NBT API - adds NBT tags to the plugin's items for identification purposes and support with plugins such as MMOItems. Please note that 1.18 requires version 2.9.0+ of this plugin to work, 1.19 requires 2.10.0+, and 1.20 requires 2.11.3+.

Other Gate Plugins

I know that not all gate plugins fulfill the needs of every server (it's why I created this one), so if you are on the hunt for gate plugins and this one doesn't do what you want, here are some recommendations:

• Advanced Portals - an advanced portal plugin (Bungee)
• Ancient Gates - create gates using commands
• Portal Stones - converts nether portals for local travel
  
• The Gate - a Stargate plugin (Bungee)
• Simple Portals - create region based portals (Bungee)
• Stargate - the Stargate plugin remade