skNetwork

!Cover

Cross-server variables for Skript: shared, global variables that stay in sync across every server on a BungeeCord or Velocity network, plus script sharing from the proxy. A Skungee alternative.

# on the lobby
set {?coins::%player%} to 100

# on survival, straight away, no extra code
send "You have %{?coins::%player%}% coins"

Any variable starting with ? is a network variable. Reads come from this server's own copy, so only writes go over the wire.

Read the wiki for setup, guides, the full syntax reference and copyable example scripts.

---

Features

• Shared variables. Any {?variable} is live on every server.
• Free reads. Served from local memory. Only writes cross the wire.
• Atomic changes. add, remove, set if not set, set if it is. Worked out on the proxy, so nothing is lost when two servers race.
• A spend floor. without going below 0 refuses instead of going negative.
• Read the outcome. and wait gives you the new value, or why it was refused.
• Server identity. network server name, for one script that runs everywhere.
• Sync state. network is synced, on network sync, on network disconnect.
• Change events. on network variable change of "coins::*" fires on every server with the old and the new value.
• Who is where. all network players, network server of "Notch", network server "survival" is online, plus the motd, version, player limit and whitelist of any server. Read from memory, kept fresh by the proxy.
• Messages anywhere. send network message and send network action bar to a player on any server, broadcast ... across the network to everyone.
• Moving players. connect network player "%player%" to "survival".
• Remote console. execute command ... on network server "survival". Off until the proxy config allows it.
• Script sharing. Push scripts from the proxy, with per-server load results.
• Survives restarts. Append-only log, self-compacting, reconnects resume.
• BungeeCord and Velocity. Same jar, same config.

Requirements

	Works with	Recommended
Java	25	25
Minecraft	1.21 to 26.2	26.1.2
Skript	2.16.0+	2.16.2
Proxy	BungeeCord or Velocity	either

Java 25 is required. The jar will not load on Java 21 or older, whatever Minecraft version you run. Both rules apply together: a 1.21 server also has to be started with Java 25.

Every game server and the proxy run the same jar. One that is behind is refused when it connects, with a message on both consoles saying which side to update.

Works on offline servers. skNetwork never looks at player identity. Tested on Minecraft 1.21.11 and 26.1.2, Skript 2.16.2, BungeeCord 26.1 and Velocity 4.1.1.

Commands

/sknet                      state, proxy, copy size, latency
/sknet resync               throw the copy away and pull everything again
/sknet reconnect            drop the connection and continue where it stopped

/sknetproxy                 proxy: state, backends, variable count
/sknetproxy push            proxy: send scripts now
/sknetproxy dump <pattern>  proxy: look up variables, '*' is a wildcard
/sknetproxy log             proxy: storage size, compaction and flush times
/sknetproxy compact         proxy: rewrite the log now
/sknetproxy backup          proxy: timestamped copy of the log into backup/
/sknetproxy reload          proxy: re-read config.yml, apply what can move

The two halves use different names on purpose. A proxy handles any command it knows before the game server sees it, so keeping /sknet free means it always reaches the server you are standing on, where being an operator is already enough.

/sknet also answers to /sknetlocal and /sknl, /sknetproxy to /sknetp and /sknp. Both need sknetwork.admin. Every option the two config.yml files take is on the Configuration wiki page.

---

Links

---

skNetwork uses bStats for anonymous usage stats. You can opt out in plugins/bStats/config.yml.

Bukkit / Spigot / Paper

BungeeCord

Velocity

Setup, config and the full syntax reference are in the wiki.