Examples on Agones

Custom Controller for Agones Game Servers

Mon, 01 Jan 0001 00:00:00 +0000

Prerequisite

To get started, ensure the following prerequisites are met:

You have a running Kubernetes cluster.
Agones is installed on your cluster. Refer Agones guide.
(Optional) Review Custom Controller code to see the details of this example.

Create a Custom Controller

Let’s create a custom controller on your cluster using the following command:

kubectl apply -f https://raw.githubusercontent.com/googleforgames/agones/release-1.57.0/examples/custom-controller/deployment.yaml

When you run this command, it quickly sets up your controller by doing four things:

Build and Run a Simple Game Server that Connects to an Inference Server

Mon, 01 Jan 0001 00:00:00 +0000

Setting up the GenAI Inference Server

You will need a separate GenAI inference server. This example uses the Google for Games GenAI as its inference server. This particular inference server has the request structure for the /chat endpoint:

type GenAIRequest struct {
	Context         string  `json:"context,omitempty"`
	Prompt          string  `json:"prompt"`
}

(Optional) Modify the GenAIRequest Structure

If you need a different request structure for your GenAI endpoint, you will need to clone or fork the Agones repository and modify the above GenAIRequest struct in main.go. Update REPOSITORY in the agones/examples/simple-genai-server/Makefile to your own container registry and run make build && make push from within the agones/examples/simple-genai-server path. Then modify the gameserver_*.yaml to pull the image from your container registry. If you are making a series of changes you may also want to add imagePullPolicy: Always to the container image in gameserver_*.yaml.

Deploying and Running SuperTuxKart Server Using Agones

Mon, 01 Jan 0001 00:00:00 +0000

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 SuperTuxKart client downloaded for gameplay. Download it from SuperTuxKart
(Optional) Review SuperTuxKart 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.57.0/examples/supertuxkart/fleet.yaml

You should see a successful output similar to this :

Deploying and Running Xonotic Server Using Agones

Mon, 01 Jan 0001 00:00:00 +0000

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.57.0/examples/xonotic/fleet.yaml

You should see a successful output similar to this :