Deploying and Running Xonotic Server Using Agones
Prerequisite
To get started, ensure the following prerequisites are met:
-
You have a running Kubernetes cluster.
-
Agones is installed on your cluster. Refer to the Agones guide for the instructions.
-
The Xonotic client downloaded for gameplay. Download it from Xonotic
-
(Optional) Review Xonotic code to see the details of this example.
Create a Fleet
Let’s create a Fleet using the following command:
kubectl apply -f https://raw.githubusercontent.com/googleforgames/agones/release-1.44.0/examples/xonotic/fleet.yaml
You should see a successful output similar to this :
fleet.agones.dev/xonotic created
This has created a Fleet record inside Kubernetes, which in turn creates two ready GameServers that are available to be allocated for a game session.
kubectl get fleet
It should look something like this:
NAME SCHEDULING DESIRED CURRENT ALLOCATED READY AGE
xonotic Packed 2 2 0 2 55s
You can also see the GameServers that have been created by the Fleet by running kubectl get gameservers
,
the GameServer will be prefixed by xonotic
.
NAME STATE ADDRESS PORT NODE AGE
xonotic-7lk8x-hgfrg Ready 34.71.168.92 7206 gk3-genai-quickstart-pool-3-ba2a705f-wpmc 103s
xonotic-7lk8x-rwhst Ready 34.71.168.92 7330 gk3-genai-quickstart-pool-3-ba2a705f-wpmc 103s
For the full details of the YAML file head to the Fleet Specification Guide
Connect to the Game Server
After allocating a GameServer from the fleet and obtaining its status and IP, you’re ready to connect and play. Here’s how to use the server IP and port to join the game with the Xonotic server:
Launch Xonotic: Start the Xonotic client you previously downloaded by running the executable for your operating system (documentation).
Multiplayer Mode: From the main menu, select “Multiplayer”.
Server Connection: Choose to join a server manually and input the IP and port number you obtained from the kubectl get gameservers
command.
Join the Game: After entering the server details, proceed to join the server. You should now be connected to your Agones-managed Xonotic game server and ready to play.
Cleaning Up
After you’re done playing, it’s a good idea to clean up. To remove the Agones fleet you deployed, execute the following command. This will remove the fleet along with all the game server instances it manages:
kubectl delete -f https://raw.githubusercontent.com/googleforgames/agones/release-1.44.0/examples/xonotic/fleet.yaml
Feedback
Was this page helpful?
Glad to hear it! Please tell us how we can improve.
Sorry to hear that. Please tell us how we can improve.
Last modified November 5, 2024: Update Supported Kubernetes to 1.29, 1.30, 1.31 (#4024) (a0d1614)