As of April, 2023, the StarGate Ecosystem has merged! The developers of all major SG forks have joined forces to make StarGate Rewritten!
Future releases will be posted through this listing! For more info, please join our Discord.
Preface: Let me just start saying that there is already some saturation of various versions of the Stargate plugin, but this version aims to add major features which were not possible when the original plugin was created. Additionally, this version has been fully updated to 1.19 and is built with Java 17.
The code has been fully commented and simplified for easier future development. A lot of bugs and inconsistencies present in other Stargate plugins have been fixed.
Feature showcase:
Description: Create gates that allow for instant-teleportation between large distances. Gates can be always-open or triggered; they
can share a network or be split into clusters; they can be hidden on a network or accessible to everybody.
-
Vehicle teleportation -- teleport minecarts, boats, horses, pigs and striders (this is the only fork to work properly with furnace minecarts)
-
Leashed teleportation -- teleport any creature in a leash with the player
-
Underwater portals -- portals can be placed underwater as long as a waterproof button is used
-
Button customization -- a large amount of materials usable as buttons (buttons, wall corals, shulkers, chests)
-
Config commands -- All main config values can be changed from the commandline
-
Teleport across worlds or servers (BungeeCord supported)
-
API available -- using the API, a lot of behavior can be changed
-
Player permissions -- let players build their own networks.
-
Vault economy support -- can add costs for create, destroy and use.
-
Ability to create custom gate configurations. Four different default gate configurations are available.
-
Message customization -
Multiple built-in languages (de, en, es, fr, hu, it, ja, nb-no, nl, nn-no, pt-br, ru, zh_cn)
-
Color Customization -- Stargate signs can be colored in many ways. Colors can be set globally, or on a per sign type basis
-
RGB and dye support -- Signs can use RGB colors (using hex codes) as their main and highlighting colors, and can also be dyed on a per-sign basis
-
Dynmap integration -- Stargates are displayed in Dynmap if available
Documentation You san find some documentation in the documentation tab, but the recommended way to read the documentation is using the wiki:
https://git.knarcraft.net/EpicKnarvik97/Stargate/wiki
Installation To install the plugin, just move it to your server's plugin directory. If you have an existing Stargate folder, its contents will be migrated if possible.
CraftBook notice If using craftbook with automatic minecart/boat removal enabled,
enableCraftBookRemoveOnEjectFix must be set to true for minecart/boat teleportation to work properly for players. This removes any NBT data because a new vehicle is spawned.
Various fixes While testing the plugin during the rewrite, I found several bugs and inconsistencies which did not have any mitigation. Here is a list of fixed bugs/inconsistencies:
Portals were created in the nether when the nether-type stargate was used.
End-gates were created in the end when stargates utilizing end-gates were created/used.
Using end-portals to/from the end had weird results as a player teleporting from the end using an end-portal block is respawned, not teleported.
IgnoreEntrances was used to prevent snowmen from breaking stargates, instead of just preventing snowmen from placing snow.
UUIDs were used instead of player names for new stargates, but there was nothing updating a player name to a player UUID.
Signs were generally never updated, preventing a stargate's current state from being accurately displayed.
When a portal button type was changed, there was no change for existing stargates.
Colored stargate names and networks displayed the color tag instead of the colored text on some servers.
Color codes were treated as part of a stargate name or network, which could lead to some confusion or frustration.
The max name length was defined as 12, even though it was really 11, but could be increased to 13.
Color codes were counted as part of the max name or network length limit, reducing the actual limit with 2 characters for each color.
Color codes were included when sorting stargate network, causing sorting to appear broken.
When protectEntrance was enabled, placing a block in a stargate entrance was allowed, but removing it again would case the stargate to be broken.
Furnace minecarts wouldn't change direction and would end up glitching out.
Background
This was originally TheDgtl's Bukkit port of the Stargate plugin for hMod by Dinnerbone. This is a fork
of [PseudoKnight's fork](
https://github.com/PseudoKnight/Stargate-Bukkit). This fork's main purpose is to create a clean
version of Stargate compliant with Spigot 1.17, even if it means changing the entire project's previous structure.
The stargate plugin with 10.x.x started from the same fork as this version, but had its major versjon increased two times since it was forked. Meanwhile, this version was bumped from 0.8.0.3 to 0.9.0.0 once I finished the initial rewrite of all the programming code.
Migration from other stargate versions
This plugin should be compatible with configurations from the Stargate plugin all the way back. The nethergate.gate
file, the endgate.gate file and the watergate.gate file will be overwritten if they exist. Take a backup of the files
and overwrite the files after the first startup if you want to keep your custom gates.
If you have legacy gate files using the old numeric material ids, you need to change them to the new format manually.
Use F3 + H to see material ids. Use them exactly as written after "minecraft:". The configuration will be updated to a
more easily readable format, but the old configuration will be saved in case you want to change back right away.
Permissions have had a few changes, so you should check the permissions section for any differences since you set up
permissions.
Payment to owner using Economy, through Vault, is only possible if the portal owner in the portal database is defined by
a UUID, and not a username. A player name will be upgraded to a UUID when the player with the given name joins the
server.
Requesting translations
While Stargate has 10 available languages, most of them only translate a small part of the plugin's messages. Additionally, more messages have been added to this version, thus making most translations incomplete.
If you are fluent in any language not listed, or any language with an incomplete translation (all but English, Norwegian, Japanese and Simplified Chinese), I'd love to add your translation to the plugin.