Bukkit

Description

This is a simple gate/portal type teleportation plugin. Just build a portal frame and stick a sign on the left side with some details (explained later). Right clicking the sign to select a destination gate. Walk through the gate and you will be teleported to the other gate you selected on the sign.

The sign layouts are simple. When creating a sign the first line is [gate] so the plugin knows you are attempting to make a gate. The second line is the name of this gate. The third line is the channel the gate is on.

Gates on the same channel can link to each other and will show up on the gate signs. Just right click on a gate sign to toggle through the other gates on the same channel. There can be more than 3 gates per channel, and the list on the signs will cycle through them all.

Please note that signs MUST go on the far left edge of the frame. Buttons can go anywhere on the frame

Requested here: http://forums.bukkit.org/threads/gates-sign-chooser.178825/

There are permissions to control who can create, destroy, change the destinations, and/or teleport.

Now with 100% more lava and portal blocks! As of v1.7 you can set any block as your portal filler. Water, lava, and portal seems to be the best options, but you can choose literally anything. Use solid blocks if you want to make one-way gates. ;)

If you have any questions about how it works dont hesitate to ask in the comments below.

Enjoy! ^_^

Commands

/pl3xgates (reload) View version info and/or reload config.yml from disk. (Aliases: gates)
/gateinfo Get info about a certain gate. (Right click sign after command) (Aliases: ginfo, gi)

Permissions

pl3xgates.create Allows player to create gates.
pl3xgates.create.remotes Allows player to create remote signs for gates.
pl3xgates.delete Allows player to delete gates.
pl3xgates.delete.remotes Allows player to delete remote signs for gates.
pl3xgates.destination Allows player to change destination of gates.
pl3xgates.teleport Allows player to teleport through gates.

pl3xgates.make Gives pl3xgates.create & pl3xgates.delete & pl3xgates.create.remotes & pl3xgates.delete.remotes
pl3xgates.use Gives pl3xgates.destination & pl3xgates.teleport
pl3xgates.command.* Gives pl3xgates.command.pl3xgates & pl3xgates.command.gateinfo

pl3xgates.admin Gives all permissions, plus gate and channel owner override rights

Default config.yml

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60

# Enable debug info in console
debug-mode: false

# Enable colors in console output
color-logs: true

# Enable sounds
# All compatible sounds can be found in this list: http://jd.bukkit.org/rb/apidocs/org/bukkit/Sound.html
play-sounds: true

# Sound played at both gates when teleporting
teleport-sound: SPLASH

# Sound played at gates when activated (fills with water)
activate-sound: SWIM

# Sound played when selecting a destination
destination-sound: FIRE_IGNITE

# The tag for line 1 on the gate signs. Default is 'gate'.
gate-sign-tag: 'gate'

# Enable or disable the use of remote gate signs
enable-remote-signs: true

# The tag for line 1 on the remote signs. Default is 'remote'.
remote-sign-tag: 'remote'

# The style for gate names. Maximum of 4 characters. Anything longer will be cut off.
# Note: Bug in Minecraft requires color codes to come BEFORE style codes or the style will not work.
gate-name-style: '&1&l'

# The style for destination names. Maximum of 2 characters. Anything longer will be cut off.
# Note: Bug in Minecraft requires color codes to come BEFORE style codes or the style will not work.
gate-destination-style: '&o'

# Maximum number of frame blocks allowed per gate
maximum-frame-blocks: 10

# Teleport minecarts through gates
teleport-minecarts: true

# Enable or disable filler effect for "always on" gates
always-on-show-filler: true

# The default filler if none specified on sign
default-filler: STATIONARY_WATER

# Allow buttons to activate/deactivate gates
use-buttons: true

# Number of seconds for gates to stay active when button its pressed
remain-active-for: 10

# Allowed materials for gate frames
frame-materials:
- STONE
- WOOD
- OBSIDIAN
- IRON_BLOCK

config.yml for v1.7

Todo

• Add language file
• Perm nodes for filler blocks
• More optimization for better experience
• Allow mobs to travel through gates (not sure if I'm going to do this one, will create lots of lag)
• Ability to ride horses through gates Added in v1.5
• Sounds! Added in v1.5
• Remote signs to control gates Added in v1.4
• Allow names to be reused (as long as not on same channel) Added in v1.3
• Owners of channels/gates Added in v1.3
• On/Off states Added in v1.3
• Check for valid frame Added in v1.2
• Variable frame sizes Added in v1.2
• Allow minecarts to travel through gates Added in v1.1
  
  Have a suggestion? Comment below!

Known Issues

• TNTMinecarts lose their primed state when teleported. *
• FurnaceMinecarts lose their powered state when teleported. *
• Entities do not teleport through the gates unless riding a minecart.
• Entities on minecarts do not teleport to different worlds.
• Gates do not load on startup, sometimes. ✝

* No methods in the Bukkit API exist yet to fix both these issues. I could expose the NMS methods via reflection to fix them, however that would mean all future versions on this plugin will be CB version dependent and not future/past version compatible. Another possible solution is to add a dependency like BKCommonLib which has already exposed the NMS methods needed. I've decided to leave this as-is for now. At least until I get enough feedback that these fixes are actually even needed/wanted.

✝ This is due to the order Bukkit loads plugins on server startup. If you are using a plugin to control your worlds, then that plugin must load before Pl3xGates. You can manually do this yourself for v1.5 and below, all future versions will have this fix by default. Use WinRar (or 7zip, etc) to open the Pl3xGates.jar file and then open the plugin.yml in a text editor. The top few lines you need to add a "load" and a "softdepend" to it. Here is what the first few lines should look like with the fix (lines 6 & 7) applied: http://pastebin.com/maGeUT4F Just save this back to the .jar file and restart your server.

Videos

Metrics

This plugin uses metrics to collect stats! It only collect basic things such as version type, and players online. If you want to see everything, click on the graph. Go into /plugins/PluginMetrics/config.yml to disable stat collecting if you wish.

Development Builds