Initial Stargate plugin: Paper gate plugin + Velocity/Bungee cross-server bridges

2026-08-09 09:53:55 -04:00
commit 83a0392ee9
34 changed files with 2317 additions and 0 deletions
@@ -0,0 +1,55 @@
+# Stargate configuration
+
+# Unique id for THIS server. Used to tag gates created here and to route cross-server
+# dials through the proxy. Must be unique across your network and match the server's
+# name as configured in the Velocity/Bungee proxy config.
+server-id: "server1"
+
+storage:
+  # sqlite  -> single server, file-based, zero setup
+  # mysql   -> required if you want gates to be visible/dialable across multiple
+  #            backend servers sharing this same database
+  type: sqlite
+  mysql:
+    host: localhost
+    port: 3306
+    database: stargate
+    username: stargate
+    password: ""
+    table-prefix: "stargate_"
+
+# Enables sending players to another backend server when they dial a gate whose
+# server-id differs from this one. Requires the stargate-velocity or stargate-bungee
+# companion plugin installed on the proxy, and storage.type: mysql so all servers
+# share gate data.
+cross-server:
+  enabled: false
+
+gate:
+  # Any of these materials count as the decorative frame ring. Mix and match to match
+  # your build (the default matches an obsidian/gold-block/birch-planks arch).
+  frame-materials:
+    - OBSIDIAN
+    - GOLD_BLOCK
+    - BIRCH_PLANKS
+    - OAK_PLANKS
+  # Chevron blocks embedded in the frame. Build them as chevron-unlit-material; the
+  # plugin swaps them to chevron-lit-material as the gate dials/opens, and swaps them
+  # back when the gate closes/deactivates.
+  chevron-unlit-material: BLACK_STAINED_GLASS
+  chevron-lit-material: GLOWSTONE
+  # Material poured into the interior (the "event horizon") while the gate is open.
+  iris-material: WATER
+  max-frame-blocks: 300
+  max-iris-blocks: 200
+  min-frame-blocks: 8
+
+dialing:
+  # Seconds the gate stays open (iris filled) before auto-closing if nobody walks through.
+  open-seconds: 10
+  # Delay in ticks between lighting each chevron during the dial animation.
+  chevron-tick-delay: 4
+  play-sounds: true
+
+network:
+  default-network: "main"
@@ -0,0 +1,27 @@
+name: Stargate
+version: '${version}'
+main: dev.skywalker3200.stargate.paper.StargatePlugin
+api-version: '1.21'
+author: skywalker3200
+description: Network-aware Stargate portals with cross-server dialing.
+folia-supported: false
+
+commands:
+  stargate:
+    description: Manage Stargate networks and gates.
+    aliases: [sg]
+    usage: /sg <create|destroy|network|reload|list> ...
+
+permissions:
+  stargate.use:
+    description: Allows dialing and using stargates.
+    default: true
+  stargate.create:
+    description: Allows creating new stargates.
+    default: op
+  stargate.destroy:
+    description: Allows destroying stargates you do not own.
+    default: op
+  stargate.admin:
+    description: Allows reload, network admin, and bypassing ownership checks.
+    default: op