TravelGates
TravelGates
Teleportation System & Nether Portals Substitution
Latest version: v1.10.18 [1.6.4-R0.1]
- Download (BukkitDev)
Watch the source code of TravelGates on GitHub.
Description
This plugin intends to set teleporting destinations where player can be teleported if he is standing on anonther destination. To split destinations as if they were on separated servers, player's inventory can be cleared. The player is facing the same direction, after being teleported, as the OP when the destination is created. The teleportation works through different worlds too. You can also use Nether Portals to be teleported. Just add a "TravelGates" Sign on the Nether Portal, facing the player's head. Teleportation blocks also allow you to be teleported around an existing destination. You can also manage additional worlds.
Check this page for more detailed information about the teleportation system.
This plugin is multilangual. There are only 2 languages (English and French) provided with the plugin. You can modify the messages file or create your own in another language.
Compatibility with Bukkit:
This plugin must be used with Craftbukkit version 1.1-Rx. Previous versions won't work.
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
- Download the latest build: TravelGates-x.x.x.zip, where x.x.x is the latest version
- Extract this archive. You have two files : TravelGates-x.x.x.jar and resources-x.x.x.zip
- Extract the resrouces-x.x.x.zip archive
- Create a directory named "TravelGates" in your "plugins" directory, inside the directory of your Minecraft server (optionnal)
- Move the TravelGates-x.x.x.jar file in the "plugins" directory
- Inside the resources directory you have created by extracting the previous archive, move the travelgates.conf file in the "TravelGates" directory
- 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)
- Configure the configuration file as it is described in the Readme (page or file) or check the next section below with all configuration paramaters.
- Restart the Minecraft server
- Enjoy !
Please see the README page for more information.
You can also go to the english language sample file page to configure the ingame messages.
Check the Permissions page for more information about permissions nodes used in this plugin. If you want to use permissions but don't know how to set them, check this Bukkit wiki page. Otherwise, just disable permissions in the configuration of this plugin and op/non-op conditions will apply (users permissions will be given to all non-op players and admins permissions only for op players).
If you want to see an example of the default configuration file, click here !
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
Main command is "/travelgates" but you can use the alias "/tg".
All commands and destinations are case insensitive.
See the Examples page to see examples of the most "complicated" commands this plugin offers.
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)
Example: /tg add mydest -iar{test}p(world,5,?,20)s -> Add the destination "mydest", clear the inventory after being teleported, "mydest" is only for admins, the "test" destination is the one target destination allowed to travel to, the location is in the world named "world" at the location x=5, y=max available height, z=20, and finally save the new destination.
More exhaustive information in the README.txt file
More 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 :
Source Code
Videos :
New youtube video of Nether Portals (in v1.5)
French youtube trailer (in v1.0)
Pictures:
Some example of TravelGates's teleportation Signs:
Sign control to enable/disable the Nether Portal Substitution :
Changelog
Please see the Changeslog page
Next versions
Version 2 stopped.
Known bugs
- 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.
- 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
If you encounter some bugs, please use the /tg debug in game command and send me the server logs by creating a new ticket.You can also enable the debug mode at the beginning of the plugin loading by using the configuration "debug=true" in the configuration file. Thanks.
Latest version: v1.10.18 [1.6.4-R0.1]
- Download (BukkitDev)
Description
This plugin intends to set teleporting destinations where player can be teleported if he is standing on anonther destination. To split destinations as if they were on separated servers, player's inventory can be cleared. The player is facing the same direction, after being teleported, as the OP when the destination is created. The teleportation works through different worlds too. You can also use Nether Portals to be teleported. Just add a "TravelGates" Sign on the Nether Portal, facing the player's head. Teleportation blocks also allow you to be teleported around an existing destination. You can also manage additional worlds. Check this page for more detailed information about the teleportation system. This plugin is multilangual. There are only 2 languages (English and French) provided with the plugin. You can modify the messages file or create your own in another language. Compatibility with Bukkit: This plugin must be used with Craftbukkit version 1.1-Rx. Previous versions won't work.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
- Download the latest build: TravelGates-x.x.x.zip, where x.x.x is the latest version
- Extract this archive. You have two files : TravelGates-x.x.x.jar and resources-x.x.x.zip
- Extract the resrouces-x.x.x.zip archive
- Create a directory named "TravelGates" in your "plugins" directory, inside the directory of your Minecraft server (optionnal)
- Move the TravelGates-x.x.x.jar file in the "plugins" directory
- Inside the resources directory you have created by extracting the previous archive, move the travelgates.conf file in the "TravelGates" directory
- 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)
- Configure the configuration file as it is described in the Readme (page or file) or check the next section below with all configuration paramaters.
- Restart the Minecraft server
- 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
Main command is "/travelgates" but you can use the alias "/tg".All commands and destinations are case insensitive. See the Examples page to see examples of the most "complicated" commands this plugin offers. 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.
- /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.
- 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.
- 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)
- 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 : Source Code Videos : New youtube video of Nether Portals (in v1.5)French youtube trailer (in v1.0) Pictures: Some example of TravelGates's teleportation Signs:
Sign control to enable/disable the Nether Portal Substitution :
Changelog
Please see the Changeslog pageNext versions
Version 2 stopped.Known bugs
- 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.
- 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.
@Ghomerr
Seems to be working fine, here is a re-paste just in case. http://pastebin.com/36tgNzR2
Thanks.
@Siphonex
Hello. I'm sorry but your link does not work.
Receiving this error with the latest version on Bukkit 1.5.1R2
http://pastebin.com/LikyPhhB
PermissionEx is my perms plugin (TravelGates v1.10.13 Works fine)
@Ubique1964
Yes, I know that there are many things to do or to configure in this plugin. This is why I'm trying since many months to make it from scratch to keep only simple features and make it the easiest to use, as you won't have noting to configure to make it work ingame the first time.
The reason why the plugin is like that is because I have added so many things that people asked me since the plugin exists. So it was hard to keep it consistent.
Even the code is very hard to update and maintain because of that.
@xXhackzzorXx
Your video is too fast to see clearly what you are doing, sorry.
If you don't understand what you have to do to use portals with this plugin, as I said to robin, watch videos linked on the first page of the bukkit forums page.
Edit: well, I have checked a little more the video and I've seen what you said, about your problem. In this case, I always say that you should paste the server logs in debug mode (debug=true in configuration) to let me investigate. I will try to reproduce your bug but I am never sure that this is the same problem if I cannot compare the server logs.
-Moreover, I am always available for answering to any questions asked here. Many questions are asked several times. People don't read all comments or all information here. I cannot be behind everyone to guide them personally. I know there is much information here but everything is here to make the plugin work.
And if you don't succeed in making work, if you ask it clearly, not "plugin is crap did not work", I will do my best to help you. I cannot do more. I hope the next version will be released soon and will be more convenient for everyone.
Finally, as you said Ubique, if you only needs some features, feel free to check the code on github and make your own plugin. You can even use CommandBlocks, if you only need teleportation through the same world.
What an absolute horses arse of a plugin, it takes quite a bit of time to set up your better off designing your own plugin
Hmm i think i got the same problem as robin, well im not so good at english so i just made a quick video when i go into the portal sometimes ill get to nether and i have signs ON and (/tg portaltp enable).
http://www.youtube.com/watch?v=wIhJpShj3Cs&feature=youtu.be
@richturd
You can find some videos from Bukkit forums here: http://forums.bukkit.org/threads/tp-admn-wgen-travelgates-v1-10-14-teleportation-system-nether-portal-substitution-1-5-1-r0-3.36899/
Some of them are linked in the main page, here, on Bukkit Dev. You may have missed them.
This is very complicated. Can you please upload a video tutorial on what the portal should look like?
@robinwiel
Hello. I'm not sure I understand well your problem. When you say that the "Nether is disabled", what do you mean? Is the sign showing "ON" or "OFF" ?
If it's OFF, the portal works as usual and will send you to the Nether. If it's ON, the portal will send you to the destination you have put in the sign on the portal frame.
This is the normal and expected behavior. I don't understand what is your problem here.
If you think something behaved wrong, enable the debug mode (/tg debug) and reproduce the problem. Then copy the logs from the server of this reproduction and send it to me. I will check if there is a problem or not.
Regards
Hey!
Great mod, but I have one bug. Even though I disabled the Nether, sometimes when using the 'teleport via portal' sends me to the Nether. I don't get a message saying You have arrived at... or anything. I have to go back and re-enable the lever to get the portal working and send me to the right place. Is there a fix for this?
Robin
It depends on the permissions plugin you use. If you use the Bukkit permissions system, you can check this wiki page: http://wiki.bukkit.org/Permissions.yml
Permissions provided for my plugin are only "permissions nodes" that the plugin will use to know if an action is allowed by the permissions system used on the server.
I hope this will help.
Can i just copy and paste the permissions? If not can someone please show me an example of what it should look like?
Thanks for the continued updates!
@Zen3515
OK. Please paste the content of your configuration file, provide the server logs when it starts up, with the debug mode enabled and if you can show me how your files are organised in your plugins directory it would help a lot.
Thanks.
@Ghomerr
But It still tell me that file not found In game I can use command but it show me like this YOU_CANT_GO_THERE
@Zen3515
What is the problem ? Could you please describe your issue ? Do you encounter an error message in the server logs ? In game error messages ?
Only the path "D:\Zen3515\MC-Sever\plugins\TravelGates\messages_en.lang" is valid.
If you check the readme file, you can see:
Help me please any one please tell me directory where should I paste "messages_en.lang" and other file "D:\Zen3515\MC-Sever\plugins\TravelGates\messages_en.lang" "D:\Zen3515\MC-Sever\plugins\TravelGates\messages\messages_en.lang" "D:\Zen3515\MC-Sever\plugins\TravelGates\message_en.lang" "D:\Zen3515\MC-Sever\plugins\TravelGates\messages\message_en.lang" All above directory does't work.
Requested feature by gawelium is now available: http://dev.bukkit.org/server-mods/travelgates/?comment=55
Hi,
Well, the new version does not progress very well. I have very few moments to developp so this is very slow, sorry.
However, the last version of this plugin worked when I released it. What version of Bukkit do you use ?
I will try to update to the latest build as soon as possible.
Any news about the next version? The current version 1 time freezed my server when i made a portal.