TravelGates

TravelGates

Teleportation System & Nether Portals Substitution

Latest version: v1.10.18 [1.6.4-R0.1]

• Download (BukkitDev)

Description

teleporting destinationsif he is standing on anonther destinationNether PortalsTeleportation blocksadditional worldsCompatibility with Bukkit:

Video tutorials

• Tutorial by ANDREJJGaming. (Installation + Ingame how-to)
• Tutorial by Minecrafter9842. (Installation + Ingame how-to)
• Tutorial by VariationVault. (Ingame how-to)
• Tutorial by LastWishSpain. (Complete tutorial in Spanish)
• Tutorial by AbsintoJ. (Complete tutorial in Portuguese)

How to setup this plugin from scratch

1. Download the latest build: TravelGates-x.x.x.zip, where x.x.x is the latest version
2. Extract this archive. You have two files : TravelGates-x.x.x.jar and resources-x.x.x.zip
3. Extract the resrouces-x.x.x.zip archive
4. Create a directory named "TravelGates" in your "plugins" directory, inside the directory of your Minecraft server (optionnal)
5. Move the TravelGates-x.x.x.jar file in the "plugins" directory
6. Inside the resources directory you have created by extracting the previous archive, move the travelgates.conf file in the "TravelGates" directory
7. Repeat the previous step with the language file of your choice. You can find samples of language files in the "resources\messages" directory. (feel free to update existing files or make your own)
8. Configure the configuration file as it is described in the Readme (page or file) or check the next section below with all configuration paramaters.
9. Restart the Minecraft server
10. Enjoy !

Configuration parameters

• language: set the language used to display messages to players. Has to be the same value as the message file name in the TravelGates directory. (Example : language=en -> messages_en.lang
• usepermissions: (true/false) use PermissionsBukkit or PermissionsEx or Permissions 2x/3x or Native Bukkit Permissions (in that order, depending on what plugin you have)
• teleportwithsign: (true/false) enable the sign to teleport by clicking on it
• teleportwithportal: (true/false) enable Nether Portals substitution
• debug: (true/false) used to enable the debug mode when the plugin is loading.
• clearallinventory: (true/false) used to clear the armor content when the "i" option is set to a destination
• protectadmininventory: (true/false) used to protect admin inventory when the clear inventory option is enabled
• tpblock: (type[,data]/disabled) used to select the teleport block. Type is for a material (example "wool") and data is for the wool color (ex: "lime") or the tree species (ex: "birch"). You can use the numerical data or its name.

Plugin usage

/travelgates/tg
Admin commands:

• /tg {destination} : teleport player
• /tg add {destination} [-options] : add a destination.
• /tg del {destination} : delete a destination.
• /tg save : force to save all destinations
• /tg debug : toggle the debug mode
• /tg dtm : display or not the teleport messages
• /tg options {destination} -[options] : update destination's options. Tthe "-" character is mandatory.
• /tg update {destination} -[options] : same as /tg options
• /tg worlds ({world}|*) [-lu] [world_type]: display available loaded worlds with no options. World name use the same pattern as destinations. Wildcard * can be used to display all worlds in the server directory. Use options [-lu] to load or unload a world. Without options, it will display the state of the world (loaded or unloaded). With the l option is used, you can add the world type : (normal|nether|end), default is normal. You can't unload worlds which have still some players.
• /tg config: display current configuration
• /tg perms : toggle the permissions activation (reload permissions configuration if you enable them)
• /tg signtp : toggle the usage of sign to teleport
• /tg portaltp : toggle the usage of the nether portal to teleport
• /tg clearallinv : toggle the state of the clear all inventory option
• /tg clearallinv : toggle the state of the protect admin inventory option
• /tg autosave : toggle the auto save
• /tg tpblock : modify or toggle the tp block
• /tg {destination} [-f] : teleport player to the destination if he is standing on an existing location. If using -f, the teleportation can be done from everywhere.

Users commands:

• /tg list : display all destinations available to the player.
• /tg details {destination} : display all destinations, their locations and options to the player. You can specify a destination to see its own details.
• /tg restrict {destination} : display allowed destinations from the given destination
• /tg loc {destination} : display location of the destination.
• /tg name : display the name of the location where the player is standing.
• /tg help : display short help of the plugin.
• /tg {destination} : teleport to the destination.

Other teleportation means:

• Right click on a sign containing on a line [TG] or [TRAVELGATES] (case insensitive) and on another line or on the same line (order doesn't matter) the name of an existing destination : do the same as /tg {destination}.
• Use Nether Portals : Place a TravelGates' sign (see above) on a Nether Portal with the "-ON-" state (defined in messages file), configured with a lever or directly on the sign, and use the Portal as usual. The sign has to be placed on the portal bloc facing the head of the player. You can place the destination on the Obsidian blocks or on blocks beside of the portal.
• Using a teleport block: You can be teleported if you use a teleportation block, for instance lime wool. You have to cover a rectangle surface containing the destination with this kind of block to be teleported. Max range around the destination is 5 block (6 with the destination block). All these block have to be at the same height. Just under the player location when the destination has been added.
• Check this page for more detailed information about Nether Portals and Teleportation block features.

Available options:

• i = clear inventory while travelling to a destination
• a = admin teleport only
• s = instant save when adding a new destination or updating the options
• p = set the position of your destination as following -p(world,x,y,z) or -p(x,y,z), and "y" can be equal to "?"
• r = set restricted destinations where players are allowed to go as following : -r{dest1,dest2,dest3} -r{+dest1,-dest2} -r{} -r
• f = force the teleportation to a destination (without being on another destination)

/tg add mydest -iar{test}p(world,5,?,20)sMore exhaustive information in the README.txt fileMore about the Nether Portals usage:

• You have to use a TravelGates sign. So, the destination and the TravelGates tag.
• You can use a lever to toggle the state of the Portal or type it manually.
• The states can be modified in the messages file, instead of using -ON- and -OFF-
• -ON- with the tag [TG] (or [TRAVELGATES]) and an existing destination : you will be teleported to the destination
• -OFF- Regular Nether teleportation.
• If the Sign is invalid, you will be teleported to the Nether.
• If the destination is the same where the portal is standing, teleportation will be canceled. If the Portal is not placed on an existing destination, or adjacent to an existing destination, the teleportation will also be canceled.

Medias

Source code on GitHub :Videos :
Pictures:

Changelog

Next versions

Known bugs

1. If you add other worlds, Nether Portal won't send you to the Nether. Make another nether world and link a TravelGate portal to it or link the portal to the regular Nether world.
2. It is not a bug, but you have to know it. If you try to modify the configuration file manually and try to reload all plugins with the /reload command, it would not work. All data is saved when the plugin is disabled, with the current ingame config. So, your configuration manually changed will be ignored.

In Case of Bugs

/tg debug

Похожие моды

SayAgain? HealMePlease DumbProtection ColoursList PINProtect EasyATM TimeLikeMe Review Plugin