Stargatez
Permissions
stargate.use - Allow use of all gates linking to any world in any network (Override ALL network/world permissions. Set to false to use network/world specific permissions)
- stargate.world - Allow use of gates linking to any world
- stargate.world.{world} - Allow use of gates with a destination in {world}. Set to false to disallow use.
- stargate.network - Allow use of gates on all networks
- stargate.network.{network} - Allow use of all gates in {network}. Set to false to disallow use.
stargate.option - Allow use of all options
- stargate.option.hidden - Allow use of 'H'idden
- stargate.option.alwayson - Allow use of 'A'lways-On
- stargate.option.private - Allow use of 'P'rivate
- stargate.option.free - Allow use of 'F'ree
- stargate.option.backwards - Allow use of 'B'ackwards
- stargate.option.show - Allow use of 'S'how
- stargate.option.nonetwork - Allow use of 'N'oNetwork
- stargate.option.random - Allow use of 'Random' gates
stargate.create - Allow creating gates on any network (Override all create permissions)
- stargate.create.personal - Allow creating gates on network {playername}
- stargate.create.network - Allow creating gates on any network
- stargate.create.network.{networkname} - Allow creating gates on network {networkname}. Set to false to disallow creation on {networkname}
- stargate.create.gate - Allow creation of any gate layout
- stargate.create.gate.{gatefile} - Allow creation of only {gatefile} gates
stargate.destroy - Allow destruction gates on any network (Orderride all destroy permissions)
- stargate.destroy.personal - Allow destruction of gates owned by user only
- stargate.destroy.network - Allow destruction of gates on any network
- stargate.destroy.network.{networkname} - Allow destruction of gates on network {networkname}. Set to false to disallow destruction of {networkname}
stargate.free - Allow free use/creation/destruction of gates
- stargate.free.use - Allow free use of Stargates
- stargate.free.create - Allow free creation of Stargates
- stargate.free.destroy - Allow free destruction of Stargates
stargate.admin - Allow all admin features (Hidden/Private only so far)
- stargate.admin.private - Allow use of Private gates not owned by user
- stargate.admin.hidden - Allow access to Hidden gates not ownerd by user
- stargate.admin.reload - Allow use of /sg reload
Default Permissions
- stargate.use - Everyone
- stargate.create - Op
- stargate.destroy - Op
- stargate.option - Op
- stargate.free - Op
- stargate.admin - Op
Instructions
Building a gate:
- OO
- O O - These are Obsidian blocks. You need 10.
- O O - Place a sign on either of these two blocks of Obsidian.
- O O
- OO
Sign Layout:
- Line 1: Gate Name (Max 12 characters)
- Line 2: Destination Name [Optional] (Max 12 characters, used for fixed-gates only)
- Line 3: Network name [Optional] (Max 12 characters)
- Line 4: Options [Optional] :
- 'A' for always-on fixed gate
- 'H' for hidden networked gate
- 'P' for a private gate
- 'F' for a free gate
- 'B' is for a backwards facing gate (You will exit the back)
- 'S' is for showing an always-on gate in the network list
- 'N' is for hiding the network name
- 'R' is for random gates. These follow standard permissions of gates, but have a random exit location every time a player enters.
Options: The options are the single letter, not the word. So to make a private hidden gate, your 4th line would be 'PH'.
Using a gate:
- Right click the sign to choose a destination.
- Right click the button to open up a portal.
- Step through.
Fixed gates:
- Fixed gates go to only one set destination.
- Fixed gates can be linked to other fixed gates, or normal gates. A normal gate cannot open a portal to a fixed gate however.
- To create a fixed gate, specify a destination on the second line of the stargate sign.
- Set the 4th line of the stargate sign to "A" to enable an always-open fixed gate.
Gate networks:
- Gates are all part of a network, by default this is "central".
- You can specify (and create) your own network on the third line of the sign when making a new gate.
- Gates on one network will not see gates on the second network, and vice versa.
- Gates on different worlds, but in the same network, will see eachother.
Hidden Gates:
- Hidden gates are like normal gates, but only show on the destination list of other gates under certain conditions.
- A hidden gate is only visible to the creator of the gate, or somebody with the stargate.hidden permission.
- Set the 4th line of the stargate sign to 'H' to make it a hidden gate.
iConomy Support: Stargate has support for iConomy. Gate creation, destruction and use can all have different costs associated with them. You can also define per-gate layout costs. The default cost is assigned in the config.yml file, while the per-gate costs are defined in the .gate files. To define a certain cost to a gate just add these lines to your .gate file:
- usecost=5
- destroycost=5
- createcost=5
- toowner=true
Custom Gate Layout
You can create as many gate formats as you want, the gate layouts are stored in plugins/Stargate/gates/ The .gate file must be laid out a specific way, the first lines will be config information, and after a blank line you will lay out the gate format. Here is the default nether.gate file:
- portal-open=90
- portal-closed=0
- X=49
- -=49
- XX
- X..X
- -..-
- X*.X
- XX
portal-open/closed are used to define the material in the gate when it is open or closed. "X" and "-" are used to define block "types" for the layout (Any single-character can be used, such as "#"). In the gate format, you can see we use "X" to show where obsidian must be, "-" where the controls (Button/sign) are. You will also notice a "*" in the gate layout, this is the "exit point" of the gate, the block at which the player will teleport in front of. You can supply block data in the format X=35:15 Which would only allow black wool. If no data is supplied any version of a block will work (Any color of wool for example).
Configuration
- default-gate-network - The default gate network
- portal-folder - The folder your portal databases are saved in
- gate-folder - The folder containing your .gate files
- destroyexplosion - Whether to destroy a stargate with explosions, or stop an explosion if it contains a gates controls.
- useiconomy - Whether or not to use iConomy
- createcost - The cost to create a stargate
- destroycost - The cost to destroy a stargate (Can be negative for a "refund"
- usecost - The cost to use a stargate
- chargefreedestination - Enable to allow free travel from any gate to a free gate
- freegatesgreen - Enable to make gates that won't cost the player money show up as green
- toowner - Whether the money from gate-use goes to the owner or nobody
- maxgates - If non-zero, will define the maximum amount of gates allowed on any network.
- lang - The language to use (Included languages: en, de, es, fr, hu, it, nl, pt-br, ru)
- destMemory - Whether to set the first destination as the last used destination for all gates
- ignoreEntrance - Set this option to true to not check the entrance of a gate on startup. This is a workaround for snowmen breaking gates.
- handleVehicles - Whether or not to handle vehicles going through gates. Set to false to disallow vehicles (Manned or not) going through gates.
- sortLists - If true, network lists will be sorted alphabetically.
- protectEntrance - If true, will protect from users breaking gate entrance blocks (This is more resource intensive than the usual check, and should * only be enabled for servers that use solid open/close blocks)
- signColor: This allows you to specify the color of the gate signs. Valid colors:
- debug - Whether to show massive debug output
- permdebug - Whether to show massive permission debug output
Message Customization
It is possible to customize all of the messages Stargate displays, including the [Stargate] prefix. You can find the strings in plugins/Stargate/lang/en.txt. If a string is removed, or left blank, it will not be shown when the user does the action associated with it. There are three special cases when it comes to messages, these are:
- ecoDeduct=Spent %cost%
- ecoRefund=Refunded %cost%
- ecoObtain=Obtained %cost% from Stargate %portal%
As you can see, these three strings have %cost% and %portal% variables in them. These variables are fairly self-explanatory.
The full list of strings is as follows:
- prefix=[Stargate]
- teleportMsg=Teleported
- destroyMsg=Gate Destroyed
- invalidMsg=Invalid Destination
- blockMsg=Destination Blocked
- denyMsg=Access Denied
- destEmpty=Destination List Empty
- ecoDeduct=Deducted %cost%
- ecoRefund=Redunded %cost%
- ecoObtain=Obtained %cost% from Stargate %portal%
- ecoInFunds=Insufficient Funds
- createMsg=Gate Created
- createNetDeny=You do not have access to that network
- createPersonal=Creating gate on personal network
- createNameLength=Name too short or too long.
- createExists=A gate by that name already exists
- createFull=This network is full
- createWorldDeny=You do not have access to that world
- createConflict=Gate conflicts with existing gate
Known Bugs
Unable to reproduce: Stargates teleport a user into the ground/under the ground Bukkit Issue (as of last test): Stargate will randomly NPE when drawing a sign. Long-standing Bukkit issue, that they just made worse by disallowing me to override the sign class. This won't actually affect Stargate use.
Other Notes
- This plugin is based upon to the original Stargate plugin created by Drakia but the code is all new and there are new features.
Supported Plugins/Features.
- This plugin supports Register as well as Vault and IConomy
- BungeeCord is supported as well
- I will make a video soon on how to use this plugin.
If you have any questions just ask in the comments below.
If anyone comes upon this thread in future;
1.13 + versions can be found here!
Since 2019, most active development efforts have merged into a github organization.
Current versions are a collaboration between the devs of most previous SG forks.
Here you have, working with 1.10.2
https://github.com/MerilandServer/Stargate-Bukkit
This still work as of 1.10.2 which in itself is amazing. ;)
Development will be restarted here: http://dev.bukkit.org/bukkit-plugins/stargate-reloaded/
it still works in 1.8.x
WOOOW!!! == ==== o_0 ==== este plugins aun funciona perfectamente en la version 1.7.10, se los recomiendo ampliamente!! y sin actualizarlo jajaja =)
Hello, Whenever i try and upload it to my server, It will be in my Ftp but it wont show up in game, not even red in /pl help?
Since this is abandonned, I strongly recommend people using this stargate plugin: http://forum.thedgtl.net/viewtopic.php?f=4&t=5 Working wonderfully on spigot 1.8 - my server has been using it for years.
@Talffury
I have the same issue too.
I workaround it by using water.
If there is source code I can look into it and try to fix it.
@PikachuEXE
I got it working. Using Java 7 was the issue. Updated to 8 and all is well.
However at one angle the gate looks fine but at the other angle it looks like this:
http://i.imgur.com/goi3GIX.png
Works for me on Spigot 1.8.3 BuildTool #35
Doesn't work on 1.8.3 :(
hoping this stays updated :) i love this plugin more than any other portal plugin out there.
@iTob191
I am also working on having all objects being teleported through the gate. I am not putting to much work in right now because of the whole server software situation.
@BloodyTech17
Yes the frame can be changed in the .gate file. Read the custom gate layout section.
Can I change the Obsidian Frame to other block?
And another idea from me: Teleporting while riding a horse^^
@GreatGBL
Hey, when any plugin says this: Unsupported major.minor version 52.0 it means that you need to install java 8. For example, if it said Unsupported major.minor version 51 you would need java 7 and for Unsupported major.minor version 50 you would need java 6.
[07:39:08] [Server thread/ERROR]: Could not load 'plugins\Stargate_v0.5.jar' in folder 'plugins' org.bukkit.plugin.InvalidPluginException: java.lang.UnsupportedClassVersionError: net/Flash247/Stargate/Stargate : Unsupported major.minor version 52.0 at org.bukkit.plugin.java.JavaPluginLoader.loadPlugin(JavaPluginLoader.java:135) [spigot.jar:git-Spigot-8a983f9-e81edfc] at org.bukkit.plugin.SimplePluginManager.loadPlugin(SimplePluginManager.java:329) [spigot.jar:git-Spigot-8a983f9-e81edfc] at org.bukkit.plugin.SimplePluginManager.loadPlugins(SimplePluginManager.java:251) [spigot.jar:git-Spigot-8a983f9-e81edfc] at org.bukkit.craftbukkit.v1_8_R1.CraftServer.loadPlugins(CraftServer.java:291) [spigot.jar:git-Spigot-8a983f9-e81edfc] at net.minecraft.server.v1_8_R1.DedicatedServer.init(DedicatedServer.java:152) [spigot.jar:git-Spigot-8a983f9-e81edfc] at net.minecraft.server.v1_8_R1.MinecraftServer.run(MinecraftServer.java:505) [spigot.jar:git-Spigot-8a983f9-e81edfc] at java.lang.Thread.run(Unknown Source) [?:1.7.0_71] Caused by: java.lang.UnsupportedClassVersionError: net/Flash247/Stargate/Stargate : Unsupported major.minor version 52.0 at java.lang.ClassLoader.defineClass1(Native Method) [?:1.7.0_71] at java.lang.ClassLoader.defineClass(Unknown Source) [?:1.7.0_71] at java.security.SecureClassLoader.defineClass(Unknown Source) [?:1.7.0_71] at java.net.URLClassLoader.defineClass(Unknown Source) [?:1.7.0_71] at java.net.URLClassLoader.access$100(Unknown Source) [?:1.7.0_71] at java.net.URLClassLoader$1.run(Unknown Source) [?:1.7.0_71] at java.net.URLClassLoader$1.run(Unknown Source) [?:1.7.0_71] at java.security.AccessController.doPrivileged(Native Method) [?:1.7.0_71] at java.net.URLClassLoader.findClass(Unknown Source) [?:1.7.0_71] at org.bukkit.plugin.java.PluginClassLoader.findClass(PluginClassLoader.java:101) [spigot.jar:git-Spigot-8a983f9-e81edfc] at org.bukkit.plugin.java.PluginClassLoader.findClass(PluginClassLoader.java:86) [spigot.jar:git-Spigot-8a983f9-e81edfc] at java.lang.ClassLoader.loadClass(Unknown Source) [?:1.7.0_71] at java.lang.ClassLoader.loadClass(Unknown Source) [?:1.7.0_71]
First of all, Nice work! I always really liked the plugin and after a year that I didnt play minecraft, I recently came back and was really disapointed that the plugin was discontinued but then I found this here and you saved my day! Thanks for that :)
When configuring stargate with permissions I had some problems. I wanted to allow everything for admins except for the stargate.admin features. I tried everything like
but nothing worked. I finally found the solution while writing this post:
That works fine now, but I think it's kind of misleading that you have to forbid each permission (.hidden, .private) on its own AND additionally the whole admin package. For me the first code was more comprehensible, so I would suggest to remove the meta-permissions like "stargate.admin" (or "stargate.option",..) because you could use "stargate.admin.*" instead. But thats just my opionion^^
While testing the problem above I found another permission combination that works strange in my point of view:
This permission-setup does exactly nothing as "-stargate.use" is just overwritten by "stargate.network" in combination with "stargate.world". For me it would be more comprehensible if "stargate.use" was some kind of super-permission, so if not granted you cannot use any gate and if granted then lower permissions like "stargate.network" and "stargate.world" would be checked. In addition I would remove the meta-permissions ("stargate.world", "stargate.network") here and just use "stargate.world.*" and "stargate.network.*" instead (same reason as above).
Can you add a short explanation what free gates are?
Finally a little misleading error message: If you dont not have the permission to create gates and anyway try to create one you get "You do not have access to that network" instead of "Acces denied" or something similar.
Anyway thanks for continuing this great plugin!
/e: Ups, havent seen the explanation of "stargate.use" x)