Skip to content
Please note that GitHub no longer supports your web browser.

We recommend upgrading to the latest Google Chrome or Firefox.

Learn more

/agones

Dedicated Game Server Hosting and Scaling for Multiplayer Games on Kubernetes
dedicated-gameservers kubernetes game-development multiplayer go golang game-server agones dedicated-game-servers
Go C++ CSS Rust HTML JavaScript Other
  1. Go 64.1%
  2. C++ 13.6%
  3. CSS 7.2%
  4. Rust 3.4%
  5. HTML 3.3%
  6. JavaScript 3.3%
  7. Other 5.1%
Branch: master
Find File
Clone or download

Clone with HTTPS

Use Git or checkout with SVN using the web URL.

Download ZIP

Launching GitHub Desktop...

If nothing happens, download GitHub Desktop and try again.

Launching GitHub Desktop...

If nothing happens, download GitHub Desktop and try again.

Launching Xcode...

If nothing happens, download Xcode and try again.

Launching Visual Studio...

If nothing happens, download the GitHub extension for Visual Studio and try again.

@markmandel @roberthbailey
markmandel and roberthbailey Preparation for the 1.0.0 next release (#984)
Latest commit 14c167d Aug 7, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github/ISSUE_TEMPLATE Create issue templates. Apr 25, 2019
build Preparation for the 1.0.0 next release (#984) Aug 7, 2019
cmd Promote allocation to v1 (#881) Jul 10, 2019
docs Update helm repo governance template (#977) Aug 3, 2019
examples Fix Reference docs and sync it with Examples dir (#970) Jul 31, 2019
install Preparation for the 1.0.0 next release (#984) Aug 7, 2019
pkg Remove GameServer UpdateStatus() since its not being used. (#959) Jul 30, 2019
proto/googleapis/google/api Add proto directory and update tooling. Apr 16, 2019
sdks Implement block on connect with Rust SDK (#953) Jul 30, 2019
site Preparation for the 1.0.0 next release (#984) Aug 7, 2019
test Implement block on connect with Rust SDK (#953) Jul 30, 2019
vendor Update client-go to 9.0.0 and k8s api to 1.12.10 (#918) Jul 17, 2019
vendor_fixes/k8s.io/apimachinery Update client-go to 9.0.0 and k8s api to 1.12.10 (#918) Jul 17, 2019
.dockerignore Convert C++ Example to Docker Build Pattern (#746) May 7, 2019
.gitattributes Change License from Google Inc. to Google LLC due to branding change … Apr 10, 2019
.gitignore adds a .clang-format file making Google style the default Apr 18, 2019
.golangci.yml Enabling go modules for Agones Mar 18, 2019
CHANGELOG.md Release 0.12.0 (#983) Aug 7, 2019
CONTRIBUTING.md Clang-formatted the C++ SDK files. Apr 18, 2019
LICENSE First commit for Agon. This is exciting. Dec 5, 2017
README.md Move all to https://github.com/googleforgames/agones (#836) Jun 18, 2019
agones-logo.svg Website for Agones Jan 24, 2019
cloudbuild.yaml Flaky: Make preview --no-promote to avoid promotion race conditions (#… Jul 19, 2019
code-of-conduct.md
doc.go Change License from Google Inc. to Google LLC due to branding change … Apr 10, 2019
go.mod Update client-go to 9.0.0 and k8s api to 1.12.10 (#918) Jul 17, 2019
go.sum Update client-go to 9.0.0 and k8s api to 1.12.10 (#918) Jul 17, 2019
sdk.proto Move the stable api group and promote it to v1 (#894) Jul 17, 2019
sdk.swagger.json Reserve proto definition and generated code (#820) Jul 2, 2019
tools.go Intial tool vendoring commit. Apr 25, 2019

README.md

Agones logo

GoDoc Go Report Card GitHub release Follow on Twitter

Agones is a library for hosting, running and scaling dedicated game servers on Kubernetes.

Agones, is derived from the Greek word agōn which roughly translates to “contest”, “competition at games” and “gathering”. (source)

Disclaimer

This software is currently alpha, and subject to change. Not to be used in production systems.

Why does this project exist?

Agones replaces usual bespoke or proprietary cluster management and game server scaling solutions with a Kubernetes cluster that includes the Agones custom Kubernetes Controller and matching Custom Resource Definitions for GameServers, Fleets and more.

With Agones, Kubernetes gets native abilities to create, run, manage and scale dedicated game server processes within Kubernetes clusters using standard Kubernetes tooling and APIs. This model also allows any matchmaker to interact directly with Agones via the Kubernetes API to provision a dedicated a game server.

For more details on why this project was written, read the announcement blog post.

Major Features

  • Define a single GameServer, and/or large game server Fleets within Kubernetes - either through yaml or via the API
  • Manage GameServer lifecycles - including health checking and connection information.
  • Fleet Autoscaling capabilities that integrate with Kubernetes' native cluster autoscaling
  • Gameserver specific metric exports and dashboards for ops teams

Usage

Documentation can be found on the Agones website.

Get involved

Code of Conduct

Participation in this project comes under the Contributor Covenant Code of Conduct

Development and Contribution

Please read the contributing guide for directions on submitting Pull Requests to Agones, and community membership governance.

See the Developing, Testing and Building Agones documentation for developing, testing and building Agones from source.

The Release Process documentation displays the project's upcoming release calendar and release process.

Agones is in active development - we would love your help in shaping its future!

This all sounds great, but can you explain Docker and/or Kubernetes to me?

Docker

Kubernetes

Licence

Apache 2.0

You can’t perform that action at this time.