Update Configuration

2025-09-14 01:34:55 +02:00
parent 29df09f147
commit 18b4f71fdd

@@ -1,47 +1,54 @@
## Configuration ## Configuration
```
language - The language to use (Included languages: en, de, es, fr, hu, it, nb-no, nl, nn-no, pt-br, ru) | Node | Default | Description |
folders: |----------------------------------|---------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
portalFolder - The folder your portal databases are saved in | language | en | The language to use (Included languages: cs, de, en, es, fr, hu, it, ja, nb, nl, nn, pt, ru, uk, zh). |
gateFolder - The folder containing your .gate files | adminUpdateAlert | true | Whether to alert admins about an available update when joining the server. |
gates: | dynmap | | |
maxGatesEachNetwork - If non-zero, will define the maximum amount of gates allowed on any network. | .enableDynmap | true | Should StarGate enable integration with Dynmap? This will show StarGates on your map. |
defaultGateNetwork - The default gate network | .dynmapIconsHiddenByDefault | false | Should StarGate icons be hidden by default? (must users manually enable their checkbox?) |
exitVelocity - The velocity to give players exiting stargates, relative to the entry velocity (1 = same as entry velocity) | gates | | |
cosmetic: | .maxGatesEachNetwork | 0 | If non-zero, will define the maximum amount of gates allowed on any network. |
rememberDestination - Whether to set the first destination as the last used destination for all gates | .defaultGateNetwork | central | The default network for any non-personal Stargate without an explicitly defined network. |
sortNetworkDestinations - If true, network lists will be sorted alphabetically. | .exitVelocity | 0.1 | The velocity to give players exiting stargates, relative to the entry velocity (1 = same as entry velocity) |
mainSignColor - This allows you to specify the color of the gate signs. Use a color code such as WHITE,BLACK,YELLOW or a hex color code such as '#ed76d9'. You need quotes around hex color codes. | gates.functionality | | |
highlightSignColor - This allows you to specify the color of the sign markings. Use a color code such as WHITE,BLACK,YELLOW or a hex color code such as '#ed76d9'. You need quotes around hex color codes. | .enableCraftBookRemoveOnEjectFix | false | Should the plugin sacrifice vehicle integrity in order to fix a CraftBook destroy on exit incompatibility? |
perSignColors: - A list of per-sign color specifications. Format: "SIGN_TYPE:mainColor,highlight_color". The SIGN_TYPE is OAK for an oak sign, DARK_OAK for a dark oak sign and so on. The colors can be "default" to use the color specified in "mainSignColor" or "highlightSignColor", "inverted" to use the inverse color of the default color, a normal color such as BLACK,WHITE,YELLOW or a hex color code such as #ed76d9. | .enableBungee | false | Enable this for BungeeCord support. This allows portals across Bungee servers. |
integrity: | .handleVehicles | true | Whether or not to handle vehicles going through gates. Set to false to disallow vehicles (Manned or not) going through gates. |
destroyedByExplosion - Whether to destroy a stargate with explosions, or stop an explosion if it contains a gates controls. | .handleEmptyVehicles | true | Whether or not to handle empty vehicles going through gates (chest/hopper/tnt/furnace minecarts included). |
verifyPortals - Whether or not all the non-sign blocks are checked to match the gate layout when an old stargate is loaded at startup. | .handleCreatureTransportation | true | Whether to handle players that transport creatures by sending vehicles (minecarts, boats) through gates. |
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) | .handleNonPlayerVehicles | true | Whether or not to handle vehicles with a passenger which is not a player going through gates (pigs, horses, villagers, creepers, etc.). handleCreatureTransportation must be enabled. |
functionality: | .handleLeashedCreatures | true | Whether or not to handle creatures leashed by a player going through gates. Set to false to disallow leashed creatures going through gates. |
enableBungee - Enable this for BungeeCord support. This allows portals across Bungee servers. | gates.integrity | | |
handleVehicles - Whether or not to handle vehicles going through gates. Set to false to disallow vehicles (Manned or not) going through gates. | .destroyedByExplosion | false | Whether to destroy a stargate with explosions, or stop an explosion if it contains a gates controls. |
handleEmptyVehicles - Whether or not to handle empty vehicles going through gates (chest/hopper/tnt/furnace minecarts included). | .verifyPortals | false | Whether or not all the non-sign blocks are checked to match the gate layout when an old stargate is loaded at startup. |
handleCreatureTransportation - Whether or not to handle players that transport creatures by sending vehicles (minecarts, boats) through gates. | .protectEntrance | false | 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) |
handleNonPlayerVehicles - Whether or not to handle vehicles with a passenger which is not a player going through gates (pigs, horses, villagers, creepers, etc.). handleCreatureTransportation must be enabled. | .controlUpdateDelay | 3 | The amount of ticks to wait between each Stargate control block update after startup. Increase this if Stargate loads too many chunks during startup. |
handleLeashedCreatures - Whether or not to handle creatures leashed by a player going through gates. Set to false to disallow leashed creatures going through gates. | gates.cosmetic | | |
enableCraftBookRemoveOnEjectFix - Whether to enable a fix that causes loss of NBT data, but allows vehicle teleportation to work when CraftBook's remove minecart/boat on eject setting is enabled | .rememberDestination | false | Whether the topmost name on a sign's destinations should be the most recently used destination. |
economy: | .sortNetworkDestinations | false | If true, network lists will be sorted alphabetically. |
useEconomy - Whether or not to use Economy | .mainSignColor | BLACK | This allows you to specify the color of the gate signs. Use a color code such as WHITE,BLACK,YELLOW or a hex color code such as '#ed76d9'. You need quotes around hex color codes. |
createCost - The cost to create a stargate | .highlightSignColor | WHITE | This allows you to specify the color of the sign markings. Use a color code such as WHITE,BLACK,YELLOW or a hex color code such as '#ed76d9'. You need quotes around hex color codes. |
destroyCost - The cost to destroy a stargate (Can be negative for a "refund" | .perSignColors | \[List] | A list of per-sign color specifications. Format: "SIGN_TYPE:mainColor,highlight_color". The SIGN_TYPE is OAK for an oak sign, DARK_OAK for a dark oak sign and so on. The colors can be "default" to use the color specified in "mainSignColor" or "highlightSignColor", "inverted" to use the inverse color of the default color, a normal color such as BLACK,WHITE,YELLOW or a hex color code such as #ed76d9. |
useCost - The cost to use a stargate | economy | | |
toOwner - Whether the money from gate-use goes to the owner or nobody | .freeGatesColored | false | Enable to make gates that won't cost the player money show up as green |
chargeFreeDestination - Enable to make players pay for teleportation even if the destination is free | .freeGatesColor | DARK_GREEN | This allows you to specify the color of the markings and name of free stargates |
freeGatesColored - Enable to make gates that won't cost the player money show up as green | .useEconomy | false | Whether or not to enable Economy using Vault (must have the Vault plugin) |
freeGatesColor - This allows you to specify the color of the markings and name of free stargates | .createCost | 0 | The cost to create a stargate |
debugging: | .destroyCost | 0 | The cost to destroy a stargate (Can be negative for a "refund") |
debug - Whether to show massive debug output | .useCost | 0 | The cost to use a stargate |
permissionDebug - Whether to show massive permission debug output | .toOwner | false | Whether the money from gate-use goes to the owner or nobody |
advanced: | .chargeFreeDestination | true | Enable to make players pay for teleportation even if the destination is free |
waitForPlayerAfterTeleportDelay - The amount of ticks to wait before adding a player as passenger of a vehicle. On slow servers, a value of 6 is required to avoid client glitches after teleporting on a vehicle. | .taxAccount | '' | The tax account to use if the server uses a closed economy. |
``` | folders | | |
| .portalFolder | plugins/Stargate/portals/ | The folder your portal databases are saved in |
| .gateFolder | plugins/Stargate/gates/ | The folder containing your .gate files |
| debugging | | |
| .debug | false | Whether to show massive debug output |
| .permissionDebug | false | Whether to show massive permission debug output |
| advanced | | |
| .waitForPlayerAfterTeleportDelay | 6 | The amount of ticks to wait before adding a player as passenger of a vehicle. On slow servers, a value of 6 is required to avoid client glitches after teleporting on a vehicle. |
### Vehicle teleportation options ### Vehicle teleportation options
* handleVehicles disables all vehicle teleportation, no matter what, if disabled * handleVehicles disables all vehicle teleportation, no matter what, if disabled