Until now, a Network was a Velocity proxy with a list of servers to forward players to. Making those servers actually work behind the proxy was up to you: turn on forwarding, copy the secret over, switch to offline mode, keep players from bypassing the proxy. Every server, every time.
With v0.3.0, the Network does that work for you.
One template, many servers
A network now describes its servers itself. serverTemplate holds what they all share, and each entry in servers adds what makes it different:
apiVersion: kobblestone.io/v1alpha1kind: Networkmetadata: name: my-networkspec: serverTemplate: eula: true type: Paper version: '26.2' storage: size: 2Gi servers: - name: lobby spec: properties: level-type: minecraft:flat - name: survival hostname: survival.example.com try: false spec: storage: size: 20GiApply this, and Kobblestone creates the Servers my-network-lobby and my-network-survival, configures them to trust the proxy and starts Velocity in front of them. Players land in the lobby and switch with /server survival, or go straight there through survival.example.com.
The managed servers are ordinary Server resources, so everything you know about servers still applies: backups, commands, auto sleep. Paper, Pufferfish, Purpur and Folia work out of the box. For Fabric and Quilt, Kobblestone installs FabricProxy-Lite and Fabric API on its own.
Bring your existing servers
Already have a server you care about? Name it in serverName and it joins the network, world included. When you remove a server from the list, it is released and keeps running on its own by default. Set serverDeletionPolicy: Delete if you want it gone instead.
Servers you want to keep configuring yourself can still be added as unmanaged entries. The network only forwards players to them. For those, the new spec.forwarding on a Server makes trusting a Velocity proxy a one-liner.
Upgrading
This changes the Network API without a migration path: existing Network resources have to be rewritten in the new form. The changelog lists everything else that changed in v0.3.0.
Read the networks guide for all the details, or look up every field in the new API reference, which now lives right here on the website.
