diff --git a/examples/fleet.yaml b/examples/fleet.yaml
index 8d3e5caa7a..f08a49edbf 100644
--- a/examples/fleet.yaml
+++ b/examples/fleet.yaml
@@ -50,6 +50,17 @@ spec:
       maxSurge: 25%
       # the amount to decrements GameServers by. Defaults to 25%
       maxUnavailable: 25%
+  # [Stage:Alpha]
+  # [FeatureFlag:FleetAllocationOverflow]
+  # Labels and/or Annotations to apply to GameServers when the number of Allocated GameServers drops below
+  # the desired replicas on the underlying `GameServerSet`
+  # Commented out since Alpha, and disabled by default
+  # allocationOverflow: # applied to the GameServerSet's number Allocated GameServers that are over the desired replicas
+  #   labels:
+  #     mykey: myvalue
+  #     version: "" # empty an existing label value
+  #   annotations:
+  #     otherkey: setthisvalue
   template:
     # GameServer metadata
     metadata:
diff --git a/pkg/apis/agones/v1/fleet.go b/pkg/apis/agones/v1/fleet.go
index 0131fcf967..e3413a4e57 100644
--- a/pkg/apis/agones/v1/fleet.go
+++ b/pkg/apis/agones/v1/fleet.go
@@ -62,7 +62,7 @@ type FleetSpec struct {
 	Replicas int32 `json:"replicas"`
 	// [Stage: Alpha]
 	// [FeatureFlag:FleetAllocationOverflow]
-	// Labels and Annotations to apply to GameServers when the number of Allocated GameServers drops below
+	// Labels and/or Annotations to apply to GameServers when the number of Allocated GameServers drops below
 	// the desired replicas on the underlying `GameServerSet`
 	// +optional
 	AllocationOverflow *AllocationOverflow `json:"allocationOverflow,omitempty"`
diff --git a/pkg/gameserversets/allocation_overflow.go b/pkg/gameserversets/allocation_overflow.go
new file mode 100644
index 0000000000..f4d9249507
--- /dev/null
+++ b/pkg/gameserversets/allocation_overflow.go
@@ -0,0 +1,162 @@
+// Copyright 2023 Google LLC All Rights Reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+package gameserversets
+
+import (
+	"context"
+	"time"
+
+	"agones.dev/agones/pkg/apis/agones"
+	agonesv1 "agones.dev/agones/pkg/apis/agones/v1"
+	"agones.dev/agones/pkg/client/clientset/versioned"
+	getterv1 "agones.dev/agones/pkg/client/clientset/versioned/typed/agones/v1"
+	"agones.dev/agones/pkg/client/informers/externalversions"
+	listerv1 "agones.dev/agones/pkg/client/listers/agones/v1"
+	"agones.dev/agones/pkg/gameservers"
+	"agones.dev/agones/pkg/util/logfields"
+	"agones.dev/agones/pkg/util/runtime"
+	"agones.dev/agones/pkg/util/workerqueue"
+	"github.com/heptiolabs/healthcheck"
+	"github.com/pkg/errors"
+	"github.com/sirupsen/logrus"
+	k8serrors "k8s.io/apimachinery/pkg/api/errors"
+	v1 "k8s.io/apimachinery/pkg/apis/meta/v1"
+	"k8s.io/client-go/tools/cache"
+)
+
+// AllocationOverflowController watches `GameServerSets`, and those with configured
+// AllocationOverflow settings, will the relevant labels and annotations to `GameServers` attached to the given
+// `GameServerSet`
+type AllocationOverflowController struct {
+	baseLogger          *logrus.Entry
+	counter             *gameservers.PerNodeCounter
+	gameServerSynced    cache.InformerSynced
+	gameServerGetter    getterv1.GameServersGetter
+	gameServerLister    listerv1.GameServerLister
+	gameServerSetSynced cache.InformerSynced
+	gameServerSetLister listerv1.GameServerSetLister
+	workerqueue         *workerqueue.WorkerQueue
+}
+
+// NewAllocatorOverflowController returns a new AllocationOverflowController
+func NewAllocatorOverflowController(
+	health healthcheck.Handler,
+	counter *gameservers.PerNodeCounter,
+	agonesClient versioned.Interface,
+	agonesInformerFactory externalversions.SharedInformerFactory) *AllocationOverflowController {
+	gameServers := agonesInformerFactory.Agones().V1().GameServers()
+	gameServerSet := agonesInformerFactory.Agones().V1().GameServerSets()
+	gsSetInformer := gameServerSet.Informer()
+
+	c := &AllocationOverflowController{
+		counter:             counter,
+		gameServerSynced:    gameServers.Informer().HasSynced,
+		gameServerGetter:    agonesClient.AgonesV1(),
+		gameServerLister:    gameServers.Lister(),
+		gameServerSetSynced: gsSetInformer.HasSynced,
+		gameServerSetLister: gameServerSet.Lister(),
+	}
+
+	c.baseLogger = runtime.NewLoggerWithType(c)
+	c.baseLogger.Debug("Created!")
+	c.workerqueue = workerqueue.NewWorkerQueueWithRateLimiter(c.syncGameServerSet, c.baseLogger, logfields.GameServerSetKey, agones.GroupName+".GameServerSetController", workerqueue.FastRateLimiter(3*time.Second))
+	health.AddLivenessCheck("gameserverset-allocationoverflow-workerqueue", c.workerqueue.Healthy)
+
+	gsSetInformer.AddEventHandler(cache.ResourceEventHandlerFuncs{
+		UpdateFunc: func(oldObj, newObj interface{}) {
+			newGss := newObj.(*agonesv1.GameServerSet)
+
+			// Only process if there is an AllocationOverflow, and it has labels or annotations.
+			if newGss.Spec.AllocationOverflow == nil {
+				return
+			} else if len(newGss.Spec.AllocationOverflow.Labels) == 0 && len(newGss.Spec.AllocationOverflow.Annotations) == 0 {
+				return
+			}
+			if newGss.Status.AllocatedReplicas > newGss.Spec.Replicas {
+				c.workerqueue.Enqueue(newGss)
+			}
+		},
+	})
+
+	return c
+}
+
+// Run this controller. Will block until stop is closed.
+func (c *AllocationOverflowController) Run(ctx context.Context) error {
+	c.baseLogger.Debug("Wait for cache sync")
+	if !cache.WaitForCacheSync(ctx.Done(), c.gameServerSynced, c.gameServerSetSynced) {
+		return errors.New("failed to wait for caches to sync")
+	}
+
+	c.workerqueue.Run(ctx, 1)
+	return nil
+}
+
+// syncGameServerSet checks to see if there are overflow Allocated GameServers and applied the labels and/or
+// annotations to the requisite number of GameServers needed to alert the underlying system.
+func (c *AllocationOverflowController) syncGameServerSet(ctx context.Context, key string) error {
+	// Convert the namespace/name string into a distinct namespace and name
+	namespace, name, err := cache.SplitMetaNamespaceKey(key)
+	if err != nil {
+		// don't return an error, as we don't want this retried
+		runtime.HandleError(loggerForGameServerSetKey(c.baseLogger, key), errors.Wrapf(err, "invalid resource key"))
+		return nil
+	}
+
+	gsSet, err := c.gameServerSetLister.GameServerSets(namespace).Get(name)
+	if err != nil {
+		if k8serrors.IsNotFound(err) {
+			loggerForGameServerSetKey(c.baseLogger, key).Debug("GameServerSet is no longer available for syncing")
+			return nil
+		}
+		return errors.Wrapf(err, "error retrieving GameServerSet %s from namespace %s", name, namespace)
+	}
+
+	// just in case something changed, double check to avoid panics and/or sending work to the K8s API that we don't
+	// need to
+	if gsSet.Spec.AllocationOverflow == nil {
+		return nil
+	}
+	if gsSet.Status.AllocatedReplicas <= gsSet.Spec.Replicas {
+		return nil
+	}
+
+	overflow := gsSet.Status.AllocatedReplicas - gsSet.Spec.Replicas
+
+	list, err := ListGameServersByGameServerSetOwner(c.gameServerLister, gsSet)
+	if err != nil {
+		return err
+	}
+
+	matches, rest := gsSet.Spec.AllocationOverflow.CountMatches(list)
+	if matches >= overflow {
+		return nil
+	}
+
+	rest = sortGameServersByStrategy(gsSet.Spec.Scheduling, rest, c.counter.Counts())
+	rest = rest[:(overflow - matches)]
+
+	opts := v1.UpdateOptions{}
+	for _, gs := range rest {
+		gsCopy := gs.DeepCopy()
+		gsSet.Spec.AllocationOverflow.Apply(gsCopy)
+
+		if _, err := c.gameServerGetter.GameServers(gs.ObjectMeta.Namespace).Update(ctx, gsCopy, opts); err != nil {
+			return errors.Wrapf(err, "error updating GameServer %s with overflow labels and/or annotations", gs.ObjectMeta.Name)
+		}
+	}
+
+	return nil
+}
diff --git a/pkg/gameserversets/allocation_overflow_test.go b/pkg/gameserversets/allocation_overflow_test.go
new file mode 100644
index 0000000000..ffde7cf8b8
--- /dev/null
+++ b/pkg/gameserversets/allocation_overflow_test.go
@@ -0,0 +1,203 @@
+// Copyright 2023 Google LLC All Rights Reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+package gameserversets
+
+import (
+	"context"
+	"fmt"
+	"testing"
+	"time"
+
+	agonesv1 "agones.dev/agones/pkg/apis/agones/v1"
+	"agones.dev/agones/pkg/gameservers"
+	agtesting "agones.dev/agones/pkg/testing"
+	"github.com/heptiolabs/healthcheck"
+	"github.com/stretchr/testify/assert"
+	"github.com/stretchr/testify/require"
+	"k8s.io/apimachinery/pkg/runtime"
+	"k8s.io/apimachinery/pkg/watch"
+	k8stesting "k8s.io/client-go/testing"
+)
+
+func TestAllocationOverflowControllerWatchGameServers(t *testing.T) {
+	t.Parallel()
+
+	gsSet := defaultFixture()
+	gsSet.Status.Replicas = gsSet.Spec.Replicas
+	gsSet.Status.ReadyReplicas = gsSet.Spec.Replicas
+	c, m := newFakeAllocationOverflowController()
+
+	received := make(chan string, 10)
+	defer close(received)
+
+	gsSetWatch := watch.NewFake()
+	m.AgonesClient.AddWatchReactor("gameserversets", k8stesting.DefaultWatchReactor(gsSetWatch, nil))
+
+	c.workerqueue.SyncHandler = func(_ context.Context, name string) error {
+		received <- name
+		return nil
+	}
+
+	ctx, cancel := agtesting.StartInformers(m, c.gameServerSetSynced)
+	defer cancel()
+
+	go func() {
+		err := c.Run(ctx)
+		require.NoError(t, err)
+	}()
+
+	change := func() string {
+		select {
+		case result := <-received:
+			return result
+		case <-time.After(3 * time.Second):
+			require.FailNow(t, "timeout occurred")
+		}
+		return ""
+	}
+
+	nochange := func() {
+		select {
+		case <-received:
+			assert.Fail(t, "Should be no value")
+		case <-time.After(time.Second):
+		}
+	}
+
+	gsSetWatch.Add(gsSet.DeepCopy())
+	nochange()
+
+	// update with no allocation overflow
+	require.Nil(t, gsSet.Spec.AllocationOverflow)
+	gsSet.Spec.Replicas++
+	gsSetWatch.Modify(gsSet.DeepCopy())
+	nochange()
+
+	// update with no labels or annotations
+	gsSet.Spec.AllocationOverflow = &agonesv1.AllocationOverflow{}
+	gsSet.Spec.Replicas++
+	gsSetWatch.Modify(gsSet.DeepCopy())
+	nochange()
+
+	// update with allocation <= replicas (and a label)
+	gsSet.Spec.AllocationOverflow.Labels = map[string]string{"colour": "green"}
+	gsSet.Status.AllocatedReplicas = 2
+	gsSetWatch.Modify(gsSet.DeepCopy())
+	nochange()
+
+	// update with allocation > replicas
+	gsSet.Status.AllocatedReplicas = 20
+	gsSetWatch.Modify(gsSet.DeepCopy())
+	require.Equal(t, fmt.Sprintf("%s/%s", gsSet.ObjectMeta.Namespace, gsSet.ObjectMeta.Name), change())
+
+	// delete
+	gsSetWatch.Delete(gsSet.DeepCopy())
+	nochange()
+}
+
+func TestAllocationOverflowSyncGameServerSet(t *testing.T) {
+	t.Parallel()
+
+	// setup fictures.
+	setup := func(gs func(server *agonesv1.GameServer)) (*agonesv1.GameServerSet, *AllocationOverflowController, agtesting.Mocks) {
+		gsSet := defaultFixture()
+		gsSet.Status.AllocatedReplicas = 5
+		gsSet.Status.Replicas = 3
+		gsSet.Spec.Replicas = 3
+		gsSet.Spec.AllocationOverflow = &agonesv1.AllocationOverflow{Labels: map[string]string{"colour": "green"}}
+		list := createGameServers(gsSet, 5)
+		for i := range list {
+			list[i].Status.State = agonesv1.GameServerStateAllocated
+			gs(&list[i])
+		}
+
+		c, m := newFakeAllocationOverflowController()
+		m.AgonesClient.AddReactor("list", "gameserversets", func(action k8stesting.Action) (bool, runtime.Object, error) {
+			return true, &agonesv1.GameServerSetList{Items: []agonesv1.GameServerSet{*gsSet}}, nil
+		})
+		m.AgonesClient.AddReactor("list", "gameservers", func(action k8stesting.Action) (bool, runtime.Object, error) {
+			return true, &agonesv1.GameServerList{Items: list}, nil
+		})
+		return gsSet, c, m
+	}
+
+	// run the sync process
+	run := func(c *AllocationOverflowController, m agtesting.Mocks, gsSet *agonesv1.GameServerSet, update func(action k8stesting.Action) (bool, runtime.Object, error)) func() {
+		m.AgonesClient.AddReactor("update", "gameservers", update)
+		ctx, cancel := agtesting.StartInformers(m, c.gameServerSetSynced, c.gameServerSynced)
+		err := c.syncGameServerSet(ctx, gsSet.ObjectMeta.Namespace+"/"+gsSet.ObjectMeta.Name)
+		require.NoError(t, err)
+		return cancel
+	}
+
+	t.Run("labels are applied", func(t *testing.T) {
+		gsSet, c, m := setup(func(_ *agonesv1.GameServer) {})
+		count := 0
+		cancel := run(c, m, gsSet, func(action k8stesting.Action) (bool, runtime.Object, error) {
+			ua := action.(k8stesting.UpdateAction)
+			gs := ua.GetObject().(*agonesv1.GameServer)
+			require.Equal(t, gs.Status.State, agonesv1.GameServerStateAllocated)
+			require.Equal(t, "green", gs.ObjectMeta.Labels["colour"])
+
+			count++
+			return true, nil, nil
+		})
+		defer cancel()
+		require.Equal(t, 2, count)
+	})
+
+	t.Run("Labels are already set", func(t *testing.T) {
+		gsSet, c, m := setup(func(gs *agonesv1.GameServer) {
+			gs.ObjectMeta.Labels["colour"] = "green"
+		})
+		cancel := run(c, m, gsSet, func(action k8stesting.Action) (bool, runtime.Object, error) {
+			require.Fail(t, "should not update")
+			return true, nil, nil
+		})
+		defer cancel()
+	})
+
+	t.Run("one label is set", func(t *testing.T) {
+		set := false
+		gsSet, c, m := setup(func(gs *agonesv1.GameServer) {
+			// just make one as already set
+			if !set {
+				gs.ObjectMeta.Labels["colour"] = "green"
+				set = true
+			}
+		})
+
+		count := 0
+		cancel := run(c, m, gsSet, func(action k8stesting.Action) (bool, runtime.Object, error) {
+			ua := action.(k8stesting.UpdateAction)
+			gs := ua.GetObject().(*agonesv1.GameServer)
+			require.Equal(t, gs.Status.State, agonesv1.GameServerStateAllocated)
+			require.Equal(t, "green", gs.ObjectMeta.Labels["colour"])
+
+			count++
+			return true, nil, nil
+		})
+		defer cancel()
+		require.Equal(t, 1, count)
+	})
+}
+
+// newFakeAllocationOverflowController returns a controller, backed by the fake Clientset
+func newFakeAllocationOverflowController() (*AllocationOverflowController, agtesting.Mocks) {
+	m := agtesting.NewMocks()
+	counter := gameservers.NewPerNodeCounter(m.KubeInformerFactory, m.AgonesInformerFactory)
+	c := NewAllocatorOverflowController(healthcheck.NewHandler(), counter, m.AgonesClient, m.AgonesInformerFactory)
+	return c, m
+}
diff --git a/pkg/gameserversets/controller.go b/pkg/gameserversets/controller.go
index 37314cde99..52cf100899 100644
--- a/pkg/gameserversets/controller.go
+++ b/pkg/gameserversets/controller.go
@@ -72,20 +72,21 @@ type Extensions struct {
 	apiHooks   agonesv1.APIHooks
 }
 
-// Controller is a the GameServerSet controller
+// Controller is a GameServerSet controller
 type Controller struct {
-	baseLogger          *logrus.Entry
-	counter             *gameservers.PerNodeCounter
-	crdGetter           apiextclientv1.CustomResourceDefinitionInterface
-	gameServerGetter    getterv1.GameServersGetter
-	gameServerLister    listerv1.GameServerLister
-	gameServerSynced    cache.InformerSynced
-	gameServerSetGetter getterv1.GameServerSetsGetter
-	gameServerSetLister listerv1.GameServerSetLister
-	gameServerSetSynced cache.InformerSynced
-	workerqueue         *workerqueue.WorkerQueue
-	recorder            record.EventRecorder
-	stateCache          *gameServerStateCache
+	baseLogger           *logrus.Entry
+	counter              *gameservers.PerNodeCounter
+	crdGetter            apiextclientv1.CustomResourceDefinitionInterface
+	gameServerGetter     getterv1.GameServersGetter
+	gameServerLister     listerv1.GameServerLister
+	gameServerSynced     cache.InformerSynced
+	gameServerSetGetter  getterv1.GameServerSetsGetter
+	gameServerSetLister  listerv1.GameServerSetLister
+	gameServerSetSynced  cache.InformerSynced
+	workerqueue          *workerqueue.WorkerQueue
+	recorder             record.EventRecorder
+	stateCache           *gameServerStateCache
+	allocationController *AllocationOverflowController
 }
 
 // NewController returns a new gameserverset crd controller
@@ -123,6 +124,10 @@ func NewController(
 	eventBroadcaster.StartRecordingToSink(&typedcorev1.EventSinkImpl{Interface: kubeClient.CoreV1().Events("")})
 	c.recorder = eventBroadcaster.NewRecorder(scheme.Scheme, corev1.EventSource{Component: "gameserverset-controller"})
 
+	if runtime.FeatureEnabled(runtime.FeatureFleetAllocateOverflow) {
+		c.allocationController = NewAllocatorOverflowController(health, counter, agonesClient, agonesInformerFactory)
+	}
+
 	gsSetInformer.AddEventHandler(cache.ResourceEventHandlerFuncs{
 		AddFunc: c.workerqueue.Enqueue,
 		UpdateFunc: func(oldObj, newObj interface{}) {
@@ -178,6 +183,14 @@ func (c *Controller) Run(ctx context.Context, workers int) error {
 		return errors.New("failed to wait for caches to sync")
 	}
 
+	if runtime.FeatureEnabled(runtime.FeatureFleetAllocateOverflow) {
+		go func() {
+			if err := c.allocationController.Run(ctx); err != nil {
+				c.baseLogger.WithError(err).Error("error running allocation overflow controller")
+			}
+		}()
+	}
+
 	c.workerqueue.Run(ctx, workers)
 	return nil
 }
@@ -216,7 +229,7 @@ func (ext *Extensions) updateValidationHandler(review admissionv1.AdmissionRevie
 			Details: &details,
 		}
 
-		loggerForGameServerSet(newGss, ext.baseLogger).WithField("review", review).Debug("Invalid GameServerSet update")
+		loggerForGameServerSet(ext.baseLogger, newGss).WithField("review", review).Debug("Invalid GameServerSet update")
 		return review, nil
 	}
 
@@ -251,7 +264,7 @@ func (ext *Extensions) creationValidationHandler(review admissionv1.AdmissionRev
 			Details: &details,
 		}
 
-		loggerForGameServerSet(newGss, ext.baseLogger).WithField("review", review).Debug("Invalid GameServerSet update")
+		loggerForGameServerSet(ext.baseLogger, newGss).WithField("review", review).Debug("Invalid GameServerSet update")
 		return review, nil
 	}
 	return review, nil
@@ -280,18 +293,6 @@ func (c *Controller) gameServerEventHandler(obj interface{}) {
 	c.workerqueue.EnqueueImmediately(gsSet)
 }
 
-func loggerForGameServerSetKey(key string, logger *logrus.Entry) *logrus.Entry {
-	return logfields.AugmentLogEntry(logger, logfields.GameServerSetKey, key)
-}
-
-func loggerForGameServerSet(gsSet *agonesv1.GameServerSet, logger *logrus.Entry) *logrus.Entry {
-	gsSetName := "NilGameServerSet"
-	if gsSet != nil {
-		gsSetName = gsSet.Namespace + "/" + gsSet.Name
-	}
-	return loggerForGameServerSetKey(gsSetName, logger).WithField("gss", gsSet)
-}
-
 // syncGameServer synchronises the GameServers for the Set,
 // making sure there are aways as many GameServers as requested
 func (c *Controller) syncGameServerSet(ctx context.Context, key string) error {
@@ -299,14 +300,14 @@ func (c *Controller) syncGameServerSet(ctx context.Context, key string) error {
 	namespace, name, err := cache.SplitMetaNamespaceKey(key)
 	if err != nil {
 		// don't return an error, as we don't want this retried
-		runtime.HandleError(loggerForGameServerSetKey(key, c.baseLogger), errors.Wrapf(err, "invalid resource key"))
+		runtime.HandleError(loggerForGameServerSetKey(c.baseLogger, key), errors.Wrapf(err, "invalid resource key"))
 		return nil
 	}
 
 	gsSet, err := c.gameServerSetLister.GameServerSets(namespace).Get(name)
 	if err != nil {
 		if k8serrors.IsNotFound(err) {
-			loggerForGameServerSetKey(key, c.baseLogger).Debug("GameServerSet is no longer available for syncing")
+			loggerForGameServerSetKey(c.baseLogger, key).Debug("GameServerSet is no longer available for syncing")
 			return nil
 		}
 		return errors.Wrapf(err, "error retrieving GameServerSet %s from namespace %s", name, namespace)
@@ -342,7 +343,7 @@ func (c *Controller) syncGameServerSet(ctx context.Context, key string) error {
 
 		fields[key] = v.(int) + 1
 	}
-	loggerForGameServerSet(gsSet, c.baseLogger).
+	loggerForGameServerSet(c.baseLogger, gsSet).
 		WithField("targetReplicaCount", gsSet.Spec.Replicas).
 		WithField("numServersToAdd", numServersToAdd).
 		WithField("numServersToDelete", len(toDelete)).
@@ -359,13 +360,13 @@ func (c *Controller) syncGameServerSet(ctx context.Context, key string) error {
 
 	if numServersToAdd > 0 {
 		if err := c.addMoreGameServers(ctx, gsSet, numServersToAdd); err != nil {
-			loggerForGameServerSet(gsSet, c.baseLogger).WithError(err).Warning("error adding game servers")
+			loggerForGameServerSet(c.baseLogger, gsSet).WithError(err).Warning("error adding game servers")
 		}
 	}
 
 	if len(toDelete) > 0 {
 		if err := c.deleteGameServers(ctx, gsSet, toDelete); err != nil {
-			loggerForGameServerSet(gsSet, c.baseLogger).WithError(err).Warning("error deleting game servers")
+			loggerForGameServerSet(c.baseLogger, gsSet).WithError(err).Warning("error deleting game servers")
 		}
 	}
 
@@ -476,12 +477,7 @@ func computeReconciliationAction(strategy apis.SchedulingStrategy, list []*agone
 	}
 
 	if deleteCount > 0 {
-		if strategy == apis.Packed {
-			potentialDeletions = sortGameServersByLeastFullNodes(potentialDeletions, counts)
-		} else {
-			potentialDeletions = sortGameServersByNewFirst(potentialDeletions)
-		}
-
+		potentialDeletions = sortGameServersByStrategy(strategy, potentialDeletions, counts)
 		toDelete = append(toDelete, potentialDeletions[0:deleteCount]...)
 	}
 
@@ -495,7 +491,7 @@ func computeReconciliationAction(strategy apis.SchedulingStrategy, list []*agone
 
 // addMoreGameServers adds diff more GameServers to the set
 func (c *Controller) addMoreGameServers(ctx context.Context, gsSet *agonesv1.GameServerSet, count int) error {
-	loggerForGameServerSet(gsSet, c.baseLogger).WithField("count", count).Debug("Adding more gameservers")
+	loggerForGameServerSet(c.baseLogger, gsSet).WithField("count", count).Debug("Adding more gameservers")
 
 	return parallelize(newGameServersChannel(count, gsSet), maxCreationParalellism, func(gs *agonesv1.GameServer) error {
 		gs, err := c.gameServerGetter.GameServers(gs.Namespace).Create(ctx, gs, metav1.CreateOptions{})
@@ -510,7 +506,7 @@ func (c *Controller) addMoreGameServers(ctx context.Context, gsSet *agonesv1.Gam
 }
 
 func (c *Controller) deleteGameServers(ctx context.Context, gsSet *agonesv1.GameServerSet, toDelete []*agonesv1.GameServer) error {
-	loggerForGameServerSet(gsSet, c.baseLogger).WithField("diff", len(toDelete)).Debug("Deleting gameservers")
+	loggerForGameServerSet(c.baseLogger, gsSet).WithField("diff", len(toDelete)).Debug("Deleting gameservers")
 
 	return parallelize(gameServerListToChannel(toDelete), maxDeletionParallelism, func(gs *agonesv1.GameServer) error {
 		// We should not delete the gameservers directly buy set their state to shutdown and let the gameserver controller to delete
diff --git a/pkg/gameserversets/gameserversets.go b/pkg/gameserversets/gameserversets.go
index 3d4eef24a2..03fd8c1e24 100644
--- a/pkg/gameserversets/gameserversets.go
+++ b/pkg/gameserversets/gameserversets.go
@@ -17,14 +17,37 @@ package gameserversets
 import (
 	"sort"
 
+	"agones.dev/agones/pkg/apis"
 	agonesv1 "agones.dev/agones/pkg/apis/agones/v1"
 	listerv1 "agones.dev/agones/pkg/client/listers/agones/v1"
 	"agones.dev/agones/pkg/gameservers"
+	"agones.dev/agones/pkg/util/logfields"
 	"github.com/pkg/errors"
+	"github.com/sirupsen/logrus"
 	metav1 "k8s.io/apimachinery/pkg/apis/meta/v1"
 	"k8s.io/apimachinery/pkg/labels"
 )
 
+func loggerForGameServerSetKey(log *logrus.Entry, key string) *logrus.Entry {
+	return logfields.AugmentLogEntry(log, logfields.GameServerSetKey, key)
+}
+
+func loggerForGameServerSet(log *logrus.Entry, gsSet *agonesv1.GameServerSet) *logrus.Entry {
+	gsSetName := "NilGameServerSet"
+	if gsSet != nil {
+		gsSetName = gsSet.Namespace + "/" + gsSet.Name
+	}
+	return loggerForGameServerSetKey(log, gsSetName).WithField("gss", gsSet)
+}
+
+// sortGameServersByStrategy will sort by least full nodes when Packed, and newest first when Distributed
+func sortGameServersByStrategy(strategy apis.SchedulingStrategy, list []*agonesv1.GameServer, counts map[string]gameservers.NodeCount) []*agonesv1.GameServer {
+	if strategy == apis.Packed {
+		return sortGameServersByLeastFullNodes(list, counts)
+	}
+	return sortGameServersByNewFirst(list)
+}
+
 // sortGameServersByLeastFullNodes sorts the list of gameservers by which gameservers reside on the least full nodes
 func sortGameServersByLeastFullNodes(list []*agonesv1.GameServer, count map[string]gameservers.NodeCount) []*agonesv1.GameServer {
 	sort.Slice(list, func(i, j int) bool {
diff --git a/pkg/util/runtime/features.go b/pkg/util/runtime/features.go
index 7a5d09baef..cdee73cbe3 100644
--- a/pkg/util/runtime/features.go
+++ b/pkg/util/runtime/features.go
@@ -60,16 +60,16 @@ const (
 	// FeaturePodHostname enables the Pod Hostname being assigned the name of the GameServer
 	FeaturePodHostname = "PodHostname"
 
+	// FeatureFleetAllocateOverflow enables setting labels and/or annotations on Allocated GameServers
+	// if the desired number of the underlying GameServerSet drops below the number of Allocated GameServers.
+	FeatureFleetAllocateOverflow = "FleetAllocationOverflow"
+
 	// FeatureSplitControllerAndExtensions is a feature flag that will split agones-controller into two deployments
 	FeatureSplitControllerAndExtensions = "SplitControllerAndExtensions"
 
 	////////////////
 	// "Pre"-Alpha features
 
-	// FeatureFleetAllocateOverflow enables setting labels and/or annotations on Allocated GameServers
-	// if the desired number of the underlying GameServerSet drops below the number of Allocated GameServers
-	FeatureFleetAllocateOverflow = "FleetAllocationOverflow"
-
 	// FeatureCountsAndLists is a feature flag that enables/disables counts and lists feature
 	// (a generic implenetation of the player tracking feature).
 	FeatureCountsAndLists Feature = "CountsAndLists"
@@ -119,11 +119,11 @@ var (
 		FeaturePlayerTracking:               false,
 		FeatureResetMetricsOnDelete:         false,
 		FeaturePodHostname:                  false,
+		FeatureFleetAllocateOverflow:        false,
 		FeatureSplitControllerAndExtensions: false,
 
 		// Pre-Alpha features
-		FeatureCountsAndLists:        false,
-		FeatureFleetAllocateOverflow: false,
+		FeatureCountsAndLists: false,
 
 		// Example feature
 		FeatureExample: false,
diff --git a/site/content/en/docs/Guides/feature-stages.md b/site/content/en/docs/Guides/feature-stages.md
index 3b10feeb78..898fab158f 100644
--- a/site/content/en/docs/Guides/feature-stages.md
+++ b/site/content/en/docs/Guides/feature-stages.md
@@ -35,6 +35,7 @@ The current set of `alpha` and `beta` feature gates:
 | [Reset Metric Export on Fleet / Autoscaler deletion]({{% relref "./metrics.md#dropping-metric-labels" %}})            | `ResetMetricsOnDelete`         | Disabled | `Alpha` | 1.26.0 |
 | [GameServer Stable Network ID]({{% ref "/docs/Reference/gameserver.md#stable-network-id" %}})                         | `PodHostname`                  | Disabled | `Alpha` | 1.29.0 |
 | [Split `agones-controller` ](https://github.com/googleforgames/agones/issues/2797)                                    | `SplitControllerAndExtensions` | Disabled | `Alpha` | 1.30.0 |
+| [Allocated GameServers are notified on relevant Fleet Updates](https://github.com/googleforgames/agones/issues/2682)  | `FleetAllocationOverflow`      | Disabled | `Alpha` | 1.30.0 |
 | Example Gate (not in use)                                                                                             | `Example`                      | Disabled | None    | 0.13.0 |
 
 {{< alert title="Note" color="info" >}}
diff --git a/site/content/en/docs/Reference/agones_crd_api_reference.html b/site/content/en/docs/Reference/agones_crd_api_reference.html
index 90f901a071..5d524d628d 100644
--- a/site/content/en/docs/Reference/agones_crd_api_reference.html
+++ b/site/content/en/docs/Reference/agones_crd_api_reference.html
@@ -3,13 +3,10 @@
 description="Detailed list of Agones Custom Resource Definitions available"
 +++
 
-{{% feature expiryVersion="1.31.0" %}}
+{{% feature expiryVersion="1.32.0" %}}
 <p>Packages:</p>
 <ul>
 <li>
-<a href="#agones.dev%2fv1">agones.dev/v1</a>
-</li>
-<li>
 <a href="#allocation.agones.dev%2fv1">allocation.agones.dev/v1</a>
 </li>
 <li>
@@ -18,23 +15,23 @@
 <li>
 <a href="#multicluster.agones.dev%2fv1">multicluster.agones.dev/v1</a>
 </li>
+<li>
+<a href="#agones.dev%2fv1">agones.dev/v1</a>
+</li>
 </ul>
-<h2 id="agones.dev/v1">agones.dev/v1</h2>
+<h2 id="allocation.agones.dev/v1">allocation.agones.dev/v1</h2>
 <p>
 <p>Package v1 is the v1 version of the API.</p>
 </p>
 Resource Types:
 <ul><li>
-<a href="#agones.dev/v1.Fleet">Fleet</a>
-</li><li>
-<a href="#agones.dev/v1.GameServer">GameServer</a>
-</li><li>
-<a href="#agones.dev/v1.GameServerSet">GameServerSet</a>
+<a href="#allocation.agones.dev/v1.GameServerAllocation">GameServerAllocation</a>
 </li></ul>
-<h3 id="agones.dev/v1.Fleet">Fleet
+<h3 id="allocation.agones.dev/v1.GameServerAllocation">GameServerAllocation
 </h3>
 <p>
-<p>Fleet is the data structure for a Fleet resource</p>
+<p>GameServerAllocation is the data structure for allocating against a set of
+GameServers, defined <code>selectors</code> selectors</p>
 </p>
 <table>
 <thead>
@@ -50,7 +47,7 @@ <h3 id="agones.dev/v1.Fleet">Fleet
 string</td>
 <td>
 <code>
-agones.dev/v1
+allocation.agones.dev/v1
 </code>
 </td>
 </tr>
@@ -59,13 +56,13 @@ <h3 id="agones.dev/v1.Fleet">Fleet
 <code>kind</code></br>
 string
 </td>
-<td><code>Fleet</code></td>
+<td><code>GameServerAllocation</code></td>
 </tr>
 <tr>
 <td>
 <code>metadata</code></br>
 <em>
-<a href="https://v1-24.docs.kubernetes.io/docs/reference/generated/kubernetes-api/v1.24/#objectmeta-v1-meta">
+<a href="https://v1-25.docs.kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
 Kubernetes meta/v1.ObjectMeta
 </a>
 </em>
@@ -79,8 +76,8 @@ <h3 id="agones.dev/v1.Fleet">Fleet
 <td>
 <code>spec</code></br>
 <em>
-<a href="#agones.dev/v1.FleetSpec">
-FleetSpec
+<a href="#allocation.agones.dev/v1.GameServerAllocationSpec">
+GameServerAllocationSpec
 </a>
 </em>
 </td>
@@ -90,43 +87,82 @@ <h3 id="agones.dev/v1.Fleet">Fleet
 <table>
 <tr>
 <td>
-<code>replicas</code></br>
+<code>multiClusterSetting</code></br>
 <em>
-int32
+<a href="#allocation.agones.dev/v1.MultiClusterSetting">
+MultiClusterSetting
+</a>
 </em>
 </td>
 <td>
-<p>Replicas are the number of GameServers that should be in this set. Defaults to 0.</p>
+<p>MultiClusterPolicySelector if specified, multi-cluster policies are applied.
+Otherwise, allocation will happen locally.</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>allocationOverflow</code></br>
+<code>required</code></br>
 <em>
-<a href="#agones.dev/v1.AllocationOverflow">
-AllocationOverflow
+<a href="#allocation.agones.dev/v1.GameServerSelector">
+GameServerSelector
+</a>
+</em>
+</td>
+<td>
+<p>Deprecated: use field Selectors instead. If Selectors is set, this field is ignored.
+Required is the GameServer selector from which to choose GameServers from.
+Defaults to all GameServers.</p>
+</td>
+</tr>
+<tr>
+<td>
+<code>preferred</code></br>
+<em>
+<a href="#allocation.agones.dev/v1.GameServerSelector">
+[]GameServerSelector
+</a>
+</em>
+</td>
+<td>
+<p>Deprecated: use field Selectors instead. If Selectors is set, this field is ignored.
+Preferred is an ordered list of preferred GameServer selectors
+that are optional to be fulfilled, but will be searched before the <code>required</code> selector.
+If the first selector is not matched, the selection attempts the second selector, and so on.
+If any of the preferred selectors are matched, the required selector is not considered.
+This is useful for things like smoke testing of new game servers.</p>
+</td>
+</tr>
+<tr>
+<td>
+<code>priorities</code></br>
+<em>
+<a href="#allocation.agones.dev/v1.Priority">
+[]Priority
 </a>
 </em>
 </td>
 <td>
 <em>(Optional)</em>
-<p>[Stage: Alpha]
-[FeatureFlag:FleetAllocationOverflow]
-Labels and Annotations to apply to GameServers when the number of Allocated GameServers drops below
-the desired replicas on the underlying <code>GameServerSet</code></p>
+<p>(Alpha, CountsAndLists feature flag) The first Priority on the array of Priorities is the most
+important for sorting. The allocator will use the first priority for sorting GameServers in the
+Selector set, and will only use any following priority for tie-breaking during sort.
+Impacts which GameServer is checked first.</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>strategy</code></br>
+<code>selectors</code></br>
 <em>
-<a href="https://v1-24.docs.kubernetes.io/docs/reference/generated/kubernetes-api/v1.24/#deploymentstrategy-v1-apps">
-Kubernetes apps/v1.DeploymentStrategy
+<a href="#allocation.agones.dev/v1.GameServerSelector">
+[]GameServerSelector
 </a>
 </em>
 </td>
 <td>
-<p>Deployment strategy</p>
+<p>Ordered list of GameServer label selectors.
+If the first selector is not matched, the selection attempts the second selector, and so on.
+This is useful for things like smoke testing of new game servers.
+Note: This field can only be set if neither Required or Preferred is set.</p>
 </td>
 </tr>
 <tr>
@@ -142,15 +178,16 @@ <h3 id="agones.dev/v1.Fleet">Fleet
 </tr>
 <tr>
 <td>
-<code>template</code></br>
+<code>metadata</code></br>
 <em>
-<a href="#agones.dev/v1.GameServerTemplateSpec">
-GameServerTemplateSpec
+<a href="#allocation.agones.dev/v1.MetaPatch">
+MetaPatch
 </a>
 </em>
 </td>
 <td>
-<p>Template the GameServer template to apply for this Fleet</p>
+<p>MetaPatch is optional custom metadata that is added to the game server at allocation
+You can use this to tell the server necessary session data</p>
 </td>
 </tr>
 </table>
@@ -160,8 +197,8 @@ <h3 id="agones.dev/v1.Fleet">Fleet
 <td>
 <code>status</code></br>
 <em>
-<a href="#agones.dev/v1.FleetStatus">
-FleetStatus
+<a href="#allocation.agones.dev/v1.GameServerAllocationStatus">
+GameServerAllocationStatus
 </a>
 </em>
 </td>
@@ -170,14 +207,15 @@ <h3 id="agones.dev/v1.Fleet">Fleet
 </tr>
 </tbody>
 </table>
-<h3 id="agones.dev/v1.GameServer">GameServer
+<h3 id="allocation.agones.dev/v1.CounterSelector">CounterSelector
 </h3>
 <p>
-<p>GameServer is the data structure for a GameServer resource.
-It is worth noting that while there is a <code>GameServerStatus</code> Status entry for the <code>GameServer</code>, it is not
-defined as a subresource - unlike <code>Fleet</code> and other Agones resources.
-This is so that we can retain the ability to change multiple aspects of a <code>GameServer</code> in a single atomic operation,
-which is particularly useful for operations such as allocation.</p>
+(<em>Appears on:</em>
+<a href="#allocation.agones.dev/v1.GameServerSelector">GameServerSelector</a>)
+</p>
+<p>
+<p>CounterSelector is the filter options for a GameServer based on the count and/or available capacity.
+0 for MaxCount or MaxAvailable means unlimited maximum. Default for all fields: 0</p>
 </p>
 <table>
 <thead>
@@ -189,331 +227,379 @@ <h3 id="agones.dev/v1.GameServer">GameServer
 <tbody>
 <tr>
 <td>
-<code>apiVersion</code></br>
-string</td>
-<td>
-<code>
-agones.dev/v1
-</code>
+<code>minCount</code></br>
+<em>
+int64
+</em>
 </td>
-</tr>
-<tr>
 <td>
-<code>kind</code></br>
-string
 </td>
-<td><code>GameServer</code></td>
 </tr>
 <tr>
 <td>
-<code>metadata</code></br>
+<code>maxCount</code></br>
 <em>
-<a href="https://v1-24.docs.kubernetes.io/docs/reference/generated/kubernetes-api/v1.24/#objectmeta-v1-meta">
-Kubernetes meta/v1.ObjectMeta
-</a>
+int64
 </em>
 </td>
 <td>
-Refer to the Kubernetes API documentation for the fields of the
-<code>metadata</code> field.
 </td>
 </tr>
 <tr>
 <td>
-<code>spec</code></br>
+<code>minAvailable</code></br>
 <em>
-<a href="#agones.dev/v1.GameServerSpec">
-GameServerSpec
-</a>
+int64
 </em>
 </td>
 <td>
-<br/>
-<br/>
-<table>
+</td>
+</tr>
 <tr>
 <td>
-<code>container</code></br>
+<code>maxAvailable</code></br>
 <em>
-string
+int64
 </em>
 </td>
 <td>
-<p>Container specifies which Pod container is the game server. Only required if there is more than one
-container defined</p>
 </td>
 </tr>
+</tbody>
+</table>
+<h3 id="allocation.agones.dev/v1.GameServerAllocationSpec">GameServerAllocationSpec
+</h3>
+<p>
+(<em>Appears on:</em>
+<a href="#allocation.agones.dev/v1.GameServerAllocation">GameServerAllocation</a>)
+</p>
+<p>
+<p>GameServerAllocationSpec is the spec for a GameServerAllocation</p>
+</p>
+<table>
+<thead>
+<tr>
+<th>Field</th>
+<th>Description</th>
+</tr>
+</thead>
+<tbody>
 <tr>
 <td>
-<code>ports</code></br>
+<code>multiClusterSetting</code></br>
 <em>
-<a href="#agones.dev/v1.GameServerPort">
-[]GameServerPort
+<a href="#allocation.agones.dev/v1.MultiClusterSetting">
+MultiClusterSetting
 </a>
 </em>
 </td>
 <td>
-<p>Ports are the array of ports that can be exposed via the game server</p>
+<p>MultiClusterPolicySelector if specified, multi-cluster policies are applied.
+Otherwise, allocation will happen locally.</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>health</code></br>
+<code>required</code></br>
 <em>
-<a href="#agones.dev/v1.Health">
-Health
+<a href="#allocation.agones.dev/v1.GameServerSelector">
+GameServerSelector
 </a>
 </em>
 </td>
 <td>
-<p>Health configures health checking</p>
+<p>Deprecated: use field Selectors instead. If Selectors is set, this field is ignored.
+Required is the GameServer selector from which to choose GameServers from.
+Defaults to all GameServers.</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>scheduling</code></br>
+<code>preferred</code></br>
 <em>
-agones.dev/agones/pkg/apis.SchedulingStrategy
+<a href="#allocation.agones.dev/v1.GameServerSelector">
+[]GameServerSelector
+</a>
 </em>
 </td>
 <td>
-<p>Scheduling strategy. Defaults to &ldquo;Packed&rdquo;</p>
+<p>Deprecated: use field Selectors instead. If Selectors is set, this field is ignored.
+Preferred is an ordered list of preferred GameServer selectors
+that are optional to be fulfilled, but will be searched before the <code>required</code> selector.
+If the first selector is not matched, the selection attempts the second selector, and so on.
+If any of the preferred selectors are matched, the required selector is not considered.
+This is useful for things like smoke testing of new game servers.</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>sdkServer</code></br>
+<code>priorities</code></br>
 <em>
-<a href="#agones.dev/v1.SdkServer">
-SdkServer
+<a href="#allocation.agones.dev/v1.Priority">
+[]Priority
 </a>
 </em>
 </td>
 <td>
-<p>SdkServer specifies parameters for the Agones SDK Server sidecar container</p>
+<em>(Optional)</em>
+<p>(Alpha, CountsAndLists feature flag) The first Priority on the array of Priorities is the most
+important for sorting. The allocator will use the first priority for sorting GameServers in the
+Selector set, and will only use any following priority for tie-breaking during sort.
+Impacts which GameServer is checked first.</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>template</code></br>
+<code>selectors</code></br>
 <em>
-<a href="https://v1-24.docs.kubernetes.io/docs/reference/generated/kubernetes-api/v1.24/#podtemplatespec-v1-core">
-Kubernetes core/v1.PodTemplateSpec
+<a href="#allocation.agones.dev/v1.GameServerSelector">
+[]GameServerSelector
 </a>
 </em>
 </td>
 <td>
-<p>Template describes the Pod that will be created for the GameServer</p>
+<p>Ordered list of GameServer label selectors.
+If the first selector is not matched, the selection attempts the second selector, and so on.
+This is useful for things like smoke testing of new game servers.
+Note: This field can only be set if neither Required or Preferred is set.</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>players</code></br>
+<code>scheduling</code></br>
 <em>
-<a href="#agones.dev/v1.PlayersSpec">
-PlayersSpec
-</a>
+agones.dev/agones/pkg/apis.SchedulingStrategy
 </em>
 </td>
 <td>
-<em>(Optional)</em>
-<p>(Alpha, PlayerTracking feature flag) Players provides the configuration for player tracking features.</p>
+<p>Scheduling strategy. Defaults to &ldquo;Packed&rdquo;.</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>counters</code></br>
+<code>metadata</code></br>
 <em>
-<a href="#agones.dev/v1.CounterStatus">
-map[string]agones.dev/agones/pkg/apis/agones/v1.CounterStatus
+<a href="#allocation.agones.dev/v1.MetaPatch">
+MetaPatch
 </a>
 </em>
 </td>
 <td>
-<em>(Optional)</em>
-<p>(Alpha, CountsAndLists feature flag) Counters and Lists provides the configuration for generic tracking features.</p>
+<p>MetaPatch is optional custom metadata that is added to the game server at allocation
+You can use this to tell the server necessary session data</p>
 </td>
 </tr>
-<tr>
-<td>
-<code>lists</code></br>
-<em>
-<a href="#agones.dev/v1.ListStatus">
-map[string]agones.dev/agones/pkg/apis/agones/v1.ListStatus
+</tbody>
+</table>
+<h3 id="allocation.agones.dev/v1.GameServerAllocationState">GameServerAllocationState
+(<code>string</code> alias)</p></h3>
+<p>
+(<em>Appears on:</em>
+<a href="#allocation.agones.dev/v1.GameServerAllocationStatus">GameServerAllocationStatus</a>)
+</p>
+<p>
+<p>GameServerAllocationState is the Allocation state</p>
+</p>
+<h3 id="allocation.agones.dev/v1.GameServerAllocationStatus">GameServerAllocationStatus
+</h3>
+<p>
+(<em>Appears on:</em>
+<a href="#allocation.agones.dev/v1.GameServerAllocation">GameServerAllocation</a>)
+</p>
+<p>
+<p>GameServerAllocationStatus is the status for an GameServerAllocation resource</p>
+</p>
+<table>
+<thead>
+<tr>
+<th>Field</th>
+<th>Description</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td>
+<code>state</code></br>
+<em>
+<a href="#allocation.agones.dev/v1.GameServerAllocationState">
+GameServerAllocationState
 </a>
 </em>
 </td>
 <td>
+<p>GameServerState is the current state of an GameServerAllocation, e.g. Allocated, or UnAllocated</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>eviction</code></br>
+<code>gameServerName</code></br>
 <em>
-<a href="#agones.dev/v1.Eviction">
-Eviction
-</a>
+string
 </em>
 </td>
 <td>
-<em>(Optional)</em>
-<p>(Alpha, SafeToEvict feature flag) Eviction specifies the eviction tolerance of the GameServer. Defaults to &ldquo;Never&rdquo;.</p>
-</td>
-</tr>
-</table>
 </td>
 </tr>
 <tr>
 <td>
-<code>status</code></br>
+<code>ports</code></br>
 <em>
-<a href="#agones.dev/v1.GameServerStatus">
-GameServerStatus
+<a href="#agones.dev/v1.GameServerStatusPort">
+[]GameServerStatusPort
 </a>
 </em>
 </td>
 <td>
 </td>
 </tr>
-</tbody>
-</table>
-<h3 id="agones.dev/v1.GameServerSet">GameServerSet
-</h3>
-<p>
-<p>GameServerSet is the data structure for a set of GameServers.
-This matches philosophically with the relationship between
-Deployments and ReplicaSets</p>
-</p>
-<table>
-<thead>
-<tr>
-<th>Field</th>
-<th>Description</th>
-</tr>
-</thead>
-<tbody>
 <tr>
 <td>
-<code>apiVersion</code></br>
-string</td>
-<td>
-<code>
-agones.dev/v1
-</code>
+<code>address</code></br>
+<em>
+string
+</em>
 </td>
-</tr>
-<tr>
 <td>
-<code>kind</code></br>
-string
 </td>
-<td><code>GameServerSet</code></td>
 </tr>
 <tr>
 <td>
-<code>metadata</code></br>
+<code>nodeName</code></br>
 <em>
-<a href="https://v1-24.docs.kubernetes.io/docs/reference/generated/kubernetes-api/v1.24/#objectmeta-v1-meta">
-Kubernetes meta/v1.ObjectMeta
-</a>
+string
 </em>
 </td>
 <td>
-Refer to the Kubernetes API documentation for the fields of the
-<code>metadata</code> field.
 </td>
 </tr>
 <tr>
 <td>
-<code>spec</code></br>
+<code>source</code></br>
 <em>
-<a href="#agones.dev/v1.GameServerSetSpec">
-GameServerSetSpec
-</a>
+string
 </em>
 </td>
 <td>
-<br/>
-<br/>
+<p>If the allocation is from a remote cluster, Source is the endpoint of the remote agones-allocator.
+Otherwise, Source is &ldquo;local&rdquo;</p>
+</td>
+</tr>
+</tbody>
+</table>
+<h3 id="allocation.agones.dev/v1.GameServerSelector">GameServerSelector
+</h3>
+<p>
+(<em>Appears on:</em>
+<a href="#allocation.agones.dev/v1.GameServerAllocationSpec">GameServerAllocationSpec</a>)
+</p>
+<p>
+<p>GameServerSelector contains all the filter options for selecting
+a GameServer for allocation.</p>
+</p>
 <table>
+<thead>
+<tr>
+<th>Field</th>
+<th>Description</th>
+</tr>
+</thead>
+<tbody>
 <tr>
 <td>
-<code>replicas</code></br>
+<code>LabelSelector</code></br>
 <em>
-int32
+<a href="https://v1-25.docs.kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#labelselector-v1-meta">
+Kubernetes meta/v1.LabelSelector
+</a>
 </em>
 </td>
 <td>
-<p>Replicas are the number of GameServers that should be in this set</p>
+<p>
+(Members of <code>LabelSelector</code> are embedded into this type.)
+</p>
+<p>See: <a href="https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/">https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/</a></p>
 </td>
 </tr>
 <tr>
 <td>
-<code>allocationOverflow</code></br>
+<code>gameServerState</code></br>
 <em>
-<a href="#agones.dev/v1.AllocationOverflow">
-AllocationOverflow
+<a href="#agones.dev/v1.GameServerState">
+GameServerState
 </a>
 </em>
 </td>
 <td>
 <em>(Optional)</em>
-<p>[Stage: Alpha]
-[FeatureFlag:FleetAllocationOverflow]
-Labels and Annotations to apply to GameServers when the number of Allocated GameServers drops below
-the desired replicas on the underlying <code>GameServerSet</code></p>
+<p>[Stage:Beta]
+[FeatureFlag:StateAllocationFilter]
+GameServerState specifies which State is the filter to be used when attempting to retrieve a GameServer
+via Allocation. Defaults to &ldquo;Ready&rdquo;. The only other option is &ldquo;Allocated&rdquo;, which can be used in conjunction with
+label/annotation/player selectors to retrieve an already Allocated GameServer.</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>scheduling</code></br>
+<code>players</code></br>
 <em>
-agones.dev/agones/pkg/apis.SchedulingStrategy
+<a href="#allocation.agones.dev/v1.PlayerSelector">
+PlayerSelector
+</a>
 </em>
 </td>
 <td>
-<p>Scheduling strategy. Defaults to &ldquo;Packed&rdquo;.</p>
+<em>(Optional)</em>
+<p>[Stage:Alpha]
+[FeatureFlag:PlayerAllocationFilter]
+Players provides a filter on minimum and maximum values for player capacity when retrieving a GameServer
+through Allocation. Defaults to no limits.</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>template</code></br>
+<code>counters</code></br>
 <em>
-<a href="#agones.dev/v1.GameServerTemplateSpec">
-GameServerTemplateSpec
+<a href="#allocation.agones.dev/v1.CounterSelector">
+map[string]agones.dev/agones/pkg/apis/allocation/v1.CounterSelector
 </a>
 </em>
 </td>
 <td>
-<p>Template the GameServer template to apply for this GameServerSet</p>
-</td>
-</tr>
-</table>
+<em>(Optional)</em>
+<p>(Alpha, CountsAndLists feature flag) Counters provides filters on minimum and maximum values
+for a Counter&rsquo;s count and available capacity when retrieving a GameServer through Allocation.
+Defaults to no limits.</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>status</code></br>
+<code>lists</code></br>
 <em>
-<a href="#agones.dev/v1.GameServerSetStatus">
-GameServerSetStatus
+<a href="#allocation.agones.dev/v1.ListSelector">
+map[string]agones.dev/agones/pkg/apis/allocation/v1.ListSelector
 </a>
 </em>
 </td>
 <td>
+<em>(Optional)</em>
+<p>(Alpha, CountsAndLists feature flag) Lists provides filters on minimum and maximum values
+for List capacity, and for the existence of a value in a List, when retrieving a GameServer
+through Allocation. Defaults to no limits.</p>
 </td>
 </tr>
 </tbody>
 </table>
-<h3 id="agones.dev/v1.AggregatedPlayerStatus">AggregatedPlayerStatus
+<h3 id="allocation.agones.dev/v1.ListSelector">ListSelector
 </h3>
 <p>
 (<em>Appears on:</em>
-<a href="#agones.dev/v1.FleetStatus">FleetStatus</a>, 
-<a href="#agones.dev/v1.GameServerSetStatus">GameServerSetStatus</a>)
+<a href="#allocation.agones.dev/v1.GameServerSelector">GameServerSelector</a>)
 </p>
 <p>
-<p>AggregatedPlayerStatus stores total player tracking values</p>
+<p>ListSelector is the filter options for a GameServer based on List available capacity and/or the
+existence of a value in a List.
+0 for MaxAvailable means unlimited maximum. Default for integer fields: 0
+&ldquo;&rdquo; for ContainsValue means ignore field. Default for string field: &ldquo;&rdquo;</p>
 </p>
 <table>
 <thead>
@@ -525,7 +611,17 @@ <h3 id="agones.dev/v1.AggregatedPlayerStatus">AggregatedPlayerStatus
 <tbody>
 <tr>
 <td>
-<code>count</code></br>
+<code>containsValue</code></br>
+<em>
+string
+</em>
+</td>
+<td>
+</td>
+</tr>
+<tr>
+<td>
+<code>minAvailable</code></br>
 <em>
 int64
 </em>
@@ -535,7 +631,7 @@ <h3 id="agones.dev/v1.AggregatedPlayerStatus">AggregatedPlayerStatus
 </tr>
 <tr>
 <td>
-<code>capacity</code></br>
+<code>maxAvailable</code></br>
 <em>
 int64
 </em>
@@ -545,17 +641,14 @@ <h3 id="agones.dev/v1.AggregatedPlayerStatus">AggregatedPlayerStatus
 </tr>
 </tbody>
 </table>
-<h3 id="agones.dev/v1.AllocationOverflow">AllocationOverflow
+<h3 id="allocation.agones.dev/v1.MetaPatch">MetaPatch
 </h3>
 <p>
 (<em>Appears on:</em>
-<a href="#agones.dev/v1.FleetSpec">FleetSpec</a>, 
-<a href="#agones.dev/v1.GameServerSetSpec">GameServerSetSpec</a>)
+<a href="#allocation.agones.dev/v1.GameServerAllocationSpec">GameServerAllocationSpec</a>)
 </p>
 <p>
-<p>AllocationOverflow specifies what labels and/or annotations to apply on Allocated GameServers
-if the desired number of the underlying <code>GameServerSet</code> drops below the number of Allocated GameServers
-attached to it.</p>
+<p>MetaPatch is the metadata used to patch the GameServer metadata on allocation</p>
 </p>
 <table>
 <thead>
@@ -573,8 +666,6 @@ <h3 id="agones.dev/v1.AllocationOverflow">AllocationOverflow
 </em>
 </td>
 <td>
-<em>(Optional)</em>
-<p>Labels to be applied to the <code>GameServer</code></p>
 </td>
 </tr>
 <tr>
@@ -585,21 +676,18 @@ <h3 id="agones.dev/v1.AllocationOverflow">AllocationOverflow
 </em>
 </td>
 <td>
-<em>(Optional)</em>
-<p>Annotations to be applied to the <code>GameServer</code></p>
 </td>
 </tr>
 </tbody>
 </table>
-<h3 id="agones.dev/v1.CounterStatus">CounterStatus
+<h3 id="allocation.agones.dev/v1.MultiClusterSetting">MultiClusterSetting
 </h3>
 <p>
 (<em>Appears on:</em>
-<a href="#agones.dev/v1.GameServerSpec">GameServerSpec</a>, 
-<a href="#agones.dev/v1.GameServerStatus">GameServerStatus</a>)
+<a href="#allocation.agones.dev/v1.GameServerAllocationSpec">GameServerAllocationSpec</a>)
 </p>
 <p>
-<p>CounterStatus stores the current counter values</p>
+<p>MultiClusterSetting specifies settings for multi-cluster allocation.</p>
 </p>
 <table>
 <thead>
@@ -611,9 +699,9 @@ <h3 id="agones.dev/v1.CounterStatus">CounterStatus
 <tbody>
 <tr>
 <td>
-<code>count</code></br>
+<code>enabled</code></br>
 <em>
-int64
+bool
 </em>
 </td>
 <td>
@@ -621,9 +709,11 @@ <h3 id="agones.dev/v1.CounterStatus">CounterStatus
 </tr>
 <tr>
 <td>
-<code>capacity</code></br>
+<code>policySelector</code></br>
 <em>
-int64
+<a href="https://v1-25.docs.kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#labelselector-v1-meta">
+Kubernetes meta/v1.LabelSelector
+</a>
 </em>
 </td>
 <td>
@@ -631,15 +721,14 @@ <h3 id="agones.dev/v1.CounterStatus">CounterStatus
 </tr>
 </tbody>
 </table>
-<h3 id="agones.dev/v1.Eviction">Eviction
+<h3 id="allocation.agones.dev/v1.PlayerSelector">PlayerSelector
 </h3>
 <p>
 (<em>Appears on:</em>
-<a href="#agones.dev/v1.GameServerSpec">GameServerSpec</a>, 
-<a href="#agones.dev/v1.GameServerStatus">GameServerStatus</a>)
+<a href="#allocation.agones.dev/v1.GameServerSelector">GameServerSelector</a>)
 </p>
 <p>
-<p>Eviction specifies the eviction tolerance of the GameServer</p>
+<p>PlayerSelector is the filter options for a GameServer based on player counts</p>
 </p>
 <table>
 <thead>
@@ -651,40 +740,39 @@ <h3 id="agones.dev/v1.Eviction">Eviction
 <tbody>
 <tr>
 <td>
-<code>safe</code></br>
+<code>minAvailable</code></br>
 <em>
-<a href="#agones.dev/v1.EvictionSafe">
-EvictionSafe
-</a>
+int64
+</em>
+</td>
+<td>
+</td>
+</tr>
+<tr>
+<td>
+<code>maxAvailable</code></br>
+<em>
+int64
 </em>
 </td>
 <td>
-<p>(Alpha, SafeToEvict feature flag)
-Game server supports termination via SIGTERM:
-- Always: Allow eviction for both Cluster Autoscaler and node drain for upgrades
-- OnUpgrade: Allow eviction for upgrades alone
-- Never (default): Pod should run to completion</p>
 </td>
 </tr>
 </tbody>
 </table>
-<h3 id="agones.dev/v1.EvictionSafe">EvictionSafe
-(<code>string</code> alias)</p></h3>
-<p>
-(<em>Appears on:</em>
-<a href="#agones.dev/v1.Eviction">Eviction</a>)
-</p>
-<p>
-<p>EvictionSafe specified whether the game server supports termination via SIGTERM</p>
-</p>
-<h3 id="agones.dev/v1.FleetSpec">FleetSpec
+<h3 id="allocation.agones.dev/v1.Priority">Priority
 </h3>
 <p>
 (<em>Appears on:</em>
-<a href="#agones.dev/v1.Fleet">Fleet</a>)
+<a href="#allocation.agones.dev/v1.GameServerAllocationSpec">GameServerAllocationSpec</a>)
 </p>
 <p>
-<p>FleetSpec is the spec for a Fleet</p>
+<p>Priority is a sorting option for GameServers with Counters or Lists based on the count or
+number of items in a List.
+PriorityType: Sort by a &ldquo;Counter&rdquo; or a &ldquo;List&rdquo;.
+Key: The name of the Counter or List. If not found on the GameServer, has no impact.
+Order: Sort by &ldquo;Ascending&rdquo; or &ldquo;Descending&rdquo;. Default is &ldquo;Descending&rdquo; so bigger count is preferred.
+&ldquo;Ascending&rdquo; would be smaller count is preferred.</p>
 </p>
 <table>
 <thead>
@@ -696,80 +784,49 @@ <h3 id="agones.dev/v1.FleetSpec">FleetSpec
 <tbody>
 <tr>
 <td>
-<code>replicas</code></br>
-<em>
-int32
-</em>
-</td>
-<td>
-<p>Replicas are the number of GameServers that should be in this set. Defaults to 0.</p>
-</td>
-</tr>
-<tr>
-<td>
-<code>allocationOverflow</code></br>
-<em>
-<a href="#agones.dev/v1.AllocationOverflow">
-AllocationOverflow
-</a>
-</em>
-</td>
-<td>
-<em>(Optional)</em>
-<p>[Stage: Alpha]
-[FeatureFlag:FleetAllocationOverflow]
-Labels and Annotations to apply to GameServers when the number of Allocated GameServers drops below
-the desired replicas on the underlying <code>GameServerSet</code></p>
-</td>
-</tr>
-<tr>
-<td>
-<code>strategy</code></br>
+<code>priorityType</code></br>
 <em>
-<a href="https://v1-24.docs.kubernetes.io/docs/reference/generated/kubernetes-api/v1.24/#deploymentstrategy-v1-apps">
-Kubernetes apps/v1.DeploymentStrategy
-</a>
+string
 </em>
 </td>
 <td>
-<p>Deployment strategy</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>scheduling</code></br>
+<code>key</code></br>
 <em>
-agones.dev/agones/pkg/apis.SchedulingStrategy
+string
 </em>
 </td>
 <td>
-<p>Scheduling strategy. Defaults to &ldquo;Packed&rdquo;.</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>template</code></br>
+<code>order</code></br>
 <em>
-<a href="#agones.dev/v1.GameServerTemplateSpec">
-GameServerTemplateSpec
-</a>
+string
 </em>
 </td>
 <td>
-<p>Template the GameServer template to apply for this Fleet</p>
 </td>
 </tr>
 </tbody>
 </table>
-<h3 id="agones.dev/v1.FleetStatus">FleetStatus
-</h3>
+<hr/>
+<h2 id="autoscaling.agones.dev/v1">autoscaling.agones.dev/v1</h2>
 <p>
-(<em>Appears on:</em>
-<a href="#agones.dev/v1.Fleet">Fleet</a>, 
-<a href="#autoscaling.agones.dev/v1.FleetAutoscaleRequest">FleetAutoscaleRequest</a>)
+<p>Package v1 is the v1 version of the API.</p>
 </p>
+Resource Types:
+<ul><li>
+<a href="#autoscaling.agones.dev/v1.FleetAutoscaler">FleetAutoscaler</a>
+</li></ul>
+<h3 id="autoscaling.agones.dev/v1.FleetAutoscaler">FleetAutoscaler
+</h3>
 <p>
-<p>FleetStatus is the status of a Fleet</p>
+<p>FleetAutoscaler is the data structure for a FleetAutoscaler resource</p>
 </p>
 <table>
 <thead>
@@ -781,76 +838,112 @@ <h3 id="agones.dev/v1.FleetStatus">FleetStatus
 <tbody>
 <tr>
 <td>
-<code>replicas</code></br>
+<code>apiVersion</code></br>
+string</td>
+<td>
+<code>
+autoscaling.agones.dev/v1
+</code>
+</td>
+</tr>
+<tr>
+<td>
+<code>kind</code></br>
+string
+</td>
+<td><code>FleetAutoscaler</code></td>
+</tr>
+<tr>
+<td>
+<code>metadata</code></br>
 <em>
-int32
+<a href="https://v1-25.docs.kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
+Kubernetes meta/v1.ObjectMeta
+</a>
 </em>
 </td>
 <td>
-<p>Replicas the total number of current GameServer replicas</p>
+Refer to the Kubernetes API documentation for the fields of the
+<code>metadata</code> field.
 </td>
 </tr>
 <tr>
 <td>
-<code>readyReplicas</code></br>
+<code>spec</code></br>
 <em>
-int32
+<a href="#autoscaling.agones.dev/v1.FleetAutoscalerSpec">
+FleetAutoscalerSpec
+</a>
+</em>
+</td>
+<td>
+<br/>
+<br/>
+<table>
+<tr>
+<td>
+<code>fleetName</code></br>
+<em>
+string
 </em>
 </td>
 <td>
-<p>ReadyReplicas are the number of Ready GameServer replicas</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>reservedReplicas</code></br>
+<code>policy</code></br>
 <em>
-int32
+<a href="#autoscaling.agones.dev/v1.FleetAutoscalerPolicy">
+FleetAutoscalerPolicy
+</a>
 </em>
 </td>
 <td>
-<p>ReservedReplicas are the total number of Reserved GameServer replicas in this fleet.
-Reserved instances won&rsquo;t be deleted on scale down, but won&rsquo;t cause an autoscaler to scale up.</p>
+<p>Autoscaling policy</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>allocatedReplicas</code></br>
+<code>sync</code></br>
 <em>
-int32
+<a href="#autoscaling.agones.dev/v1.FleetAutoscalerSync">
+FleetAutoscalerSync
+</a>
 </em>
 </td>
 <td>
-<p>AllocatedReplicas are the number of Allocated GameServer replicas</p>
+<em>(Optional)</em>
+<p>[Stage:Beta]
+[FeatureFlag:CustomFasSyncInterval]
+Sync defines when FleetAutoscalers runs autoscaling</p>
+</td>
+</tr>
+</table>
 </td>
 </tr>
 <tr>
 <td>
-<code>players</code></br>
+<code>status</code></br>
 <em>
-<a href="#agones.dev/v1.AggregatedPlayerStatus">
-AggregatedPlayerStatus
+<a href="#autoscaling.agones.dev/v1.FleetAutoscalerStatus">
+FleetAutoscalerStatus
 </a>
 </em>
 </td>
 <td>
-<em>(Optional)</em>
-<p>[Stage:Alpha]
-[FeatureFlag:PlayerTracking]
-Players are the current total player capacity and count for this Fleet</p>
 </td>
 </tr>
 </tbody>
 </table>
-<h3 id="agones.dev/v1.GameServerPort">GameServerPort
+<h3 id="autoscaling.agones.dev/v1.BufferPolicy">BufferPolicy
 </h3>
 <p>
 (<em>Appears on:</em>
-<a href="#agones.dev/v1.GameServerSpec">GameServerSpec</a>)
+<a href="#autoscaling.agones.dev/v1.FleetAutoscalerPolicy">FleetAutoscalerPolicy</a>)
 </p>
 <p>
-<p>GameServerPort defines a set of Ports that
-are to be exposed via the GameServer</p>
+<p>BufferPolicy controls the desired behavior of the buffer policy.</p>
 </p>
 <table>
 <thead>
@@ -862,89 +955,59 @@ <h3 id="agones.dev/v1.GameServerPort">GameServerPort
 <tbody>
 <tr>
 <td>
-<code>name</code></br>
-<em>
-string
-</em>
-</td>
-<td>
-<p>Name is the descriptive name of the port</p>
-</td>
-</tr>
-<tr>
-<td>
-<code>portPolicy</code></br>
-<em>
-<a href="#agones.dev/v1.PortPolicy">
-PortPolicy
-</a>
-</em>
-</td>
-<td>
-<p>PortPolicy defines the policy for how the HostPort is populated.
-Dynamic port will allocate a HostPort within the selected MIN_PORT and MAX_PORT range passed to the controller
-at installation time.
-When <code>Static</code> portPolicy is specified, <code>HostPort</code> is required, to specify the port that game clients will
-connect to</p>
-</td>
-</tr>
-<tr>
-<td>
-<code>container</code></br>
-<em>
-string
-</em>
-</td>
-<td>
-<em>(Optional)</em>
-<p>Container is the name of the container on which to open the port. Defaults to the game server container.</p>
-</td>
-</tr>
-<tr>
-<td>
-<code>containerPort</code></br>
+<code>maxReplicas</code></br>
 <em>
 int32
 </em>
 </td>
 <td>
-<p>ContainerPort is the port that is being opened on the specified container&rsquo;s process</p>
+<p>MaxReplicas is the maximum amount of replicas that the fleet may have.
+It must be bigger than both MinReplicas and BufferSize</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>hostPort</code></br>
+<code>minReplicas</code></br>
 <em>
 int32
 </em>
 </td>
 <td>
-<p>HostPort the port exposed on the host for clients to connect to</p>
+<p>MinReplicas is the minimum amount of replicas that the fleet must have
+If zero, it is ignored.
+If non zero, it must be smaller than MaxReplicas and bigger than BufferSize</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>protocol</code></br>
+<code>bufferSize</code></br>
 <em>
-<a href="https://v1-24.docs.kubernetes.io/docs/reference/generated/kubernetes-api/v1.24/#protocol-v1-core">
-Kubernetes core/v1.Protocol
-</a>
+k8s.io/apimachinery/pkg/util/intstr.IntOrString
 </em>
 </td>
 <td>
-<p>Protocol is the network protocol being used. Defaults to UDP. TCP and TCPUDP are other options.</p>
+<p>BufferSize defines how many replicas the autoscaler tries to have ready all the time
+Value can be an absolute number (ex: 5) or a percentage of desired gs instances (ex: 15%)
+Absolute number is calculated from percentage by rounding up.
+Example: when this is set to 20%, the autoscaler will make sure that 20%
+of the fleet&rsquo;s game server replicas are ready. When this is set to 20,
+the autoscaler will make sure that there are 20 available game servers
+Must be bigger than 0
+Note: by &ldquo;ready&rdquo; we understand in this case &ldquo;non-allocated&rdquo;; this is done to ensure robustness
+and computation stability in different edge case (fleet just created, not enough
+capacity in the cluster etc)</p>
 </td>
 </tr>
 </tbody>
 </table>
-<h3 id="agones.dev/v1.GameServerSetSpec">GameServerSetSpec
+<h3 id="autoscaling.agones.dev/v1.FixedIntervalSync">FixedIntervalSync
 </h3>
 <p>
 (<em>Appears on:</em>
-<a href="#agones.dev/v1.GameServerSet">GameServerSet</a>)
+<a href="#autoscaling.agones.dev/v1.FleetAutoscalerSync">FleetAutoscalerSync</a>)
 </p>
 <p>
-<p>GameServerSetSpec the specification for GameServerSet</p>
+<p>FixedIntervalSync controls the desired behavior of the fixed interval based sync.</p>
 </p>
 <table>
 <thead>
@@ -956,66 +1019,25 @@ <h3 id="agones.dev/v1.GameServerSetSpec">GameServerSetSpec
 <tbody>
 <tr>
 <td>
-<code>replicas</code></br>
+<code>seconds</code></br>
 <em>
 int32
 </em>
 </td>
 <td>
-<p>Replicas are the number of GameServers that should be in this set</p>
-</td>
-</tr>
-<tr>
-<td>
-<code>allocationOverflow</code></br>
-<em>
-<a href="#agones.dev/v1.AllocationOverflow">
-AllocationOverflow
-</a>
-</em>
-</td>
-<td>
-<em>(Optional)</em>
-<p>[Stage: Alpha]
-[FeatureFlag:FleetAllocationOverflow]
-Labels and Annotations to apply to GameServers when the number of Allocated GameServers drops below
-the desired replicas on the underlying <code>GameServerSet</code></p>
-</td>
-</tr>
-<tr>
-<td>
-<code>scheduling</code></br>
-<em>
-agones.dev/agones/pkg/apis.SchedulingStrategy
-</em>
-</td>
-<td>
-<p>Scheduling strategy. Defaults to &ldquo;Packed&rdquo;.</p>
-</td>
-</tr>
-<tr>
-<td>
-<code>template</code></br>
-<em>
-<a href="#agones.dev/v1.GameServerTemplateSpec">
-GameServerTemplateSpec
-</a>
-</em>
-</td>
-<td>
-<p>Template the GameServer template to apply for this GameServerSet</p>
+<p>Seconds defines how often we run fleet autoscaling in seconds</p>
 </td>
 </tr>
 </tbody>
 </table>
-<h3 id="agones.dev/v1.GameServerSetStatus">GameServerSetStatus
+<h3 id="autoscaling.agones.dev/v1.FleetAutoscaleRequest">FleetAutoscaleRequest
 </h3>
 <p>
 (<em>Appears on:</em>
-<a href="#agones.dev/v1.GameServerSet">GameServerSet</a>)
+<a href="#autoscaling.agones.dev/v1.FleetAutoscaleReview">FleetAutoscaleReview</a>)
 </p>
 <p>
-<p>GameServerSetStatus is the status of a GameServerSet</p>
+<p>FleetAutoscaleRequest defines the request to webhook autoscaler endpoint</p>
 </p>
 <table>
 <thead>
@@ -1027,86 +1049,63 @@ <h3 id="agones.dev/v1.GameServerSetStatus">GameServerSetStatus
 <tbody>
 <tr>
 <td>
-<code>replicas</code></br>
-<em>
-int32
-</em>
-</td>
-<td>
-<p>Replicas is the total number of current GameServer replicas</p>
-</td>
-</tr>
-<tr>
-<td>
-<code>readyReplicas</code></br>
-<em>
-int32
-</em>
-</td>
-<td>
-<p>ReadyReplicas is the number of Ready GameServer replicas</p>
-</td>
-</tr>
-<tr>
-<td>
-<code>reservedReplicas</code></br>
+<code>uid</code></br>
 <em>
-int32
+k8s.io/apimachinery/pkg/types.UID
 </em>
 </td>
 <td>
-<p>ReservedReplicas is the number of Reserved GameServer replicas</p>
+<p>UID is an identifier for the individual request/response. It allows us to distinguish instances of requests which are
+otherwise identical (parallel requests, requests when earlier requests did not modify etc)
+The UID is meant to track the round trip (request/response) between the Autoscaler and the WebHook, not the user request.
+It is suitable for correlating log entries between the webhook and apiserver, for either auditing or debugging.</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>allocatedReplicas</code></br>
+<code>name</code></br>
 <em>
-int32
+string
 </em>
 </td>
 <td>
-<p>AllocatedReplicas is the number of Allocated GameServer replicas</p>
+<p>Name is the name of the Fleet being scaled</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>shutdownReplicas</code></br>
+<code>namespace</code></br>
 <em>
-int32
+string
 </em>
 </td>
 <td>
-<p>ShutdownReplicas is the number of Shutdown GameServers replicas</p>
+<p>Namespace is the namespace associated with the request (if any).</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>players</code></br>
+<code>status</code></br>
 <em>
-<a href="#agones.dev/v1.AggregatedPlayerStatus">
-AggregatedPlayerStatus
+<a href="#agones.dev/v1.FleetStatus">
+FleetStatus
 </a>
 </em>
 </td>
 <td>
-<em>(Optional)</em>
-<p>[Stage:Alpha]
-[FeatureFlag:PlayerTracking]
-Players is the current total player capacity and count for this GameServerSet</p>
+<p>The Fleet&rsquo;s status values</p>
 </td>
 </tr>
 </tbody>
 </table>
-<h3 id="agones.dev/v1.GameServerSpec">GameServerSpec
+<h3 id="autoscaling.agones.dev/v1.FleetAutoscaleResponse">FleetAutoscaleResponse
 </h3>
 <p>
 (<em>Appears on:</em>
-<a href="#agones.dev/v1.GameServer">GameServer</a>, 
-<a href="#agones.dev/v1.GameServerTemplateSpec">GameServerTemplateSpec</a>)
+<a href="#autoscaling.agones.dev/v1.FleetAutoscaleReview">FleetAutoscaleReview</a>)
 </p>
 <p>
-<p>GameServerSpec is the spec for a GameServer resource</p>
+<p>FleetAutoscaleResponse defines the response of webhook autoscaler endpoint</p>
 </p>
 <table>
 <thead>
@@ -1118,153 +1117,158 @@ <h3 id="agones.dev/v1.GameServerSpec">GameServerSpec
 <tbody>
 <tr>
 <td>
-<code>container</code></br>
+<code>uid</code></br>
 <em>
-string
+k8s.io/apimachinery/pkg/types.UID
 </em>
 </td>
 <td>
-<p>Container specifies which Pod container is the game server. Only required if there is more than one
-container defined</p>
+<p>UID is an identifier for the individual request/response.
+This should be copied over from the corresponding FleetAutoscaleRequest.</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>ports</code></br>
+<code>scale</code></br>
 <em>
-<a href="#agones.dev/v1.GameServerPort">
-[]GameServerPort
-</a>
+bool
 </em>
 </td>
 <td>
-<p>Ports are the array of ports that can be exposed via the game server</p>
+<p>Set to false if no scaling should occur to the Fleet</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>health</code></br>
+<code>replicas</code></br>
 <em>
-<a href="#agones.dev/v1.Health">
-Health
-</a>
+int32
 </em>
 </td>
 <td>
-<p>Health configures health checking</p>
+<p>The targeted replica count</p>
 </td>
 </tr>
+</tbody>
+</table>
+<h3 id="autoscaling.agones.dev/v1.FleetAutoscaleReview">FleetAutoscaleReview
+</h3>
+<p>
+<p>FleetAutoscaleReview is passed to the webhook with a populated Request value,
+and then returned with a populated Response.</p>
+</p>
+<table>
+<thead>
 <tr>
-<td>
-<code>scheduling</code></br>
-<em>
-agones.dev/agones/pkg/apis.SchedulingStrategy
-</em>
-</td>
-<td>
-<p>Scheduling strategy. Defaults to &ldquo;Packed&rdquo;</p>
-</td>
+<th>Field</th>
+<th>Description</th>
 </tr>
+</thead>
+<tbody>
 <tr>
 <td>
-<code>sdkServer</code></br>
+<code>request</code></br>
 <em>
-<a href="#agones.dev/v1.SdkServer">
-SdkServer
+<a href="#autoscaling.agones.dev/v1.FleetAutoscaleRequest">
+FleetAutoscaleRequest
 </a>
 </em>
 </td>
 <td>
-<p>SdkServer specifies parameters for the Agones SDK Server sidecar container</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>template</code></br>
+<code>response</code></br>
 <em>
-<a href="https://v1-24.docs.kubernetes.io/docs/reference/generated/kubernetes-api/v1.24/#podtemplatespec-v1-core">
-Kubernetes core/v1.PodTemplateSpec
+<a href="#autoscaling.agones.dev/v1.FleetAutoscaleResponse">
+FleetAutoscaleResponse
 </a>
 </em>
 </td>
 <td>
-<p>Template describes the Pod that will be created for the GameServer</p>
 </td>
 </tr>
+</tbody>
+</table>
+<h3 id="autoscaling.agones.dev/v1.FleetAutoscalerPolicy">FleetAutoscalerPolicy
+</h3>
+<p>
+(<em>Appears on:</em>
+<a href="#autoscaling.agones.dev/v1.FleetAutoscalerSpec">FleetAutoscalerSpec</a>)
+</p>
+<p>
+<p>FleetAutoscalerPolicy describes how to scale a fleet</p>
+</p>
+<table>
+<thead>
 <tr>
-<td>
-<code>players</code></br>
-<em>
-<a href="#agones.dev/v1.PlayersSpec">
-PlayersSpec
-</a>
-</em>
-</td>
-<td>
-<em>(Optional)</em>
-<p>(Alpha, PlayerTracking feature flag) Players provides the configuration for player tracking features.</p>
-</td>
+<th>Field</th>
+<th>Description</th>
 </tr>
+</thead>
+<tbody>
 <tr>
 <td>
-<code>counters</code></br>
+<code>type</code></br>
 <em>
-<a href="#agones.dev/v1.CounterStatus">
-map[string]agones.dev/agones/pkg/apis/agones/v1.CounterStatus
+<a href="#autoscaling.agones.dev/v1.FleetAutoscalerPolicyType">
+FleetAutoscalerPolicyType
 </a>
 </em>
 </td>
 <td>
-<em>(Optional)</em>
-<p>(Alpha, CountsAndLists feature flag) Counters and Lists provides the configuration for generic tracking features.</p>
+<p>Type of autoscaling policy.</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>lists</code></br>
+<code>buffer</code></br>
 <em>
-<a href="#agones.dev/v1.ListStatus">
-map[string]agones.dev/agones/pkg/apis/agones/v1.ListStatus
+<a href="#autoscaling.agones.dev/v1.BufferPolicy">
+BufferPolicy
 </a>
 </em>
 </td>
 <td>
+<em>(Optional)</em>
+<p>Buffer policy config params. Present only if FleetAutoscalerPolicyType = Buffer.</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>eviction</code></br>
+<code>webhook</code></br>
 <em>
-<a href="#agones.dev/v1.Eviction">
-Eviction
+<a href="#autoscaling.agones.dev/v1.WebhookPolicy">
+WebhookPolicy
 </a>
 </em>
 </td>
 <td>
 <em>(Optional)</em>
-<p>(Alpha, SafeToEvict feature flag) Eviction specifies the eviction tolerance of the GameServer. Defaults to &ldquo;Never&rdquo;.</p>
+<p>Webhook policy config params. Present only if FleetAutoscalerPolicyType = Webhook.</p>
 </td>
 </tr>
 </tbody>
 </table>
-<h3 id="agones.dev/v1.GameServerState">GameServerState
+<h3 id="autoscaling.agones.dev/v1.FleetAutoscalerPolicyType">FleetAutoscalerPolicyType
 (<code>string</code> alias)</p></h3>
 <p>
 (<em>Appears on:</em>
-<a href="#allocation.agones.dev/v1.GameServerSelector">GameServerSelector</a>, 
-<a href="#agones.dev/v1.GameServerStatus">GameServerStatus</a>)
+<a href="#autoscaling.agones.dev/v1.FleetAutoscalerPolicy">FleetAutoscalerPolicy</a>)
 </p>
 <p>
-<p>GameServerState is the state for the GameServer</p>
+<p>FleetAutoscalerPolicyType is the policy for autoscaling
+for a given Fleet</p>
 </p>
-<h3 id="agones.dev/v1.GameServerStatus">GameServerStatus
+<h3 id="autoscaling.agones.dev/v1.FleetAutoscalerSpec">FleetAutoscalerSpec
 </h3>
 <p>
 (<em>Appears on:</em>
-<a href="#agones.dev/v1.GameServer">GameServer</a>)
+<a href="#autoscaling.agones.dev/v1.FleetAutoscaler">FleetAutoscaler</a>)
 </p>
 <p>
-<p>GameServerStatus is the status for a GameServer resource</p>
+<p>FleetAutoscalerSpec is the spec for a Fleet Scaler</p>
 </p>
 <table>
 <thead>
@@ -1276,129 +1280,133 @@ <h3 id="agones.dev/v1.GameServerStatus">GameServerStatus
 <tbody>
 <tr>
 <td>
-<code>state</code></br>
+<code>fleetName</code></br>
 <em>
-<a href="#agones.dev/v1.GameServerState">
-GameServerState
-</a>
+string
 </em>
 </td>
 <td>
-<p>GameServerState is the current state of a GameServer, e.g. Creating, Starting, Ready, etc</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>ports</code></br>
+<code>policy</code></br>
 <em>
-<a href="#agones.dev/v1.GameServerStatusPort">
-[]GameServerStatusPort
+<a href="#autoscaling.agones.dev/v1.FleetAutoscalerPolicy">
+FleetAutoscalerPolicy
 </a>
 </em>
 </td>
 <td>
+<p>Autoscaling policy</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>address</code></br>
+<code>sync</code></br>
 <em>
-string
-</em>
-</td>
-<td>
-</td>
-</tr>
-<tr>
-<td>
-<code>nodeName</code></br>
-<em>
-string
+<a href="#autoscaling.agones.dev/v1.FleetAutoscalerSync">
+FleetAutoscalerSync
+</a>
 </em>
 </td>
 <td>
+<em>(Optional)</em>
+<p>[Stage:Beta]
+[FeatureFlag:CustomFasSyncInterval]
+Sync defines when FleetAutoscalers runs autoscaling</p>
 </td>
 </tr>
+</tbody>
+</table>
+<h3 id="autoscaling.agones.dev/v1.FleetAutoscalerStatus">FleetAutoscalerStatus
+</h3>
+<p>
+(<em>Appears on:</em>
+<a href="#autoscaling.agones.dev/v1.FleetAutoscaler">FleetAutoscaler</a>)
+</p>
+<p>
+<p>FleetAutoscalerStatus defines the current status of a FleetAutoscaler</p>
+</p>
+<table>
+<thead>
+<tr>
+<th>Field</th>
+<th>Description</th>
+</tr>
+</thead>
+<tbody>
 <tr>
 <td>
-<code>reservedUntil</code></br>
+<code>currentReplicas</code></br>
 <em>
-<a href="https://v1-24.docs.kubernetes.io/docs/reference/generated/kubernetes-api/v1.24/#time-v1-meta">
-Kubernetes meta/v1.Time
-</a>
+int32
 </em>
 </td>
 <td>
+<p>CurrentReplicas is the current number of gameserver replicas
+of the fleet managed by this autoscaler, as last seen by the autoscaler</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>players</code></br>
+<code>desiredReplicas</code></br>
 <em>
-<a href="#agones.dev/v1.PlayerStatus">
-PlayerStatus
-</a>
+int32
 </em>
 </td>
 <td>
-<em>(Optional)</em>
-<p>[Stage:Alpha]
-[FeatureFlag:PlayerTracking]</p>
+<p>DesiredReplicas is the desired number of gameserver replicas
+of the fleet managed by this autoscaler, as last calculated by the autoscaler</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>counters</code></br>
+<code>lastScaleTime</code></br>
 <em>
-<a href="#agones.dev/v1.CounterStatus">
-map[string]agones.dev/agones/pkg/apis/agones/v1.CounterStatus
+<a href="https://v1-25.docs.kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#time-v1-meta">
+Kubernetes meta/v1.Time
 </a>
 </em>
 </td>
 <td>
 <em>(Optional)</em>
-<p>(Alpha, CountsAndLists feature flag) Counters and Lists provides the configuration for generic tracking features.</p>
+<p>lastScaleTime is the last time the FleetAutoscaler scaled the attached fleet,</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>lists</code></br>
+<code>ableToScale</code></br>
 <em>
-<a href="#agones.dev/v1.ListStatus">
-map[string]agones.dev/agones/pkg/apis/agones/v1.ListStatus
-</a>
+bool
 </em>
 </td>
 <td>
-<em>(Optional)</em>
+<p>AbleToScale indicates that we can access the target fleet</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>eviction</code></br>
+<code>scalingLimited</code></br>
 <em>
-<a href="#agones.dev/v1.Eviction">
-Eviction
-</a>
+bool
 </em>
 </td>
 <td>
-<em>(Optional)</em>
-<p>(Alpha, SafeToEvict feature flag) Eviction specifies the eviction tolerance of the GameServer.</p>
+<p>ScalingLimited indicates that the calculated scale would be above or below the range
+defined by MinReplicas and MaxReplicas, and has thus been capped.</p>
 </td>
 </tr>
 </tbody>
 </table>
-<h3 id="agones.dev/v1.GameServerStatusPort">GameServerStatusPort
+<h3 id="autoscaling.agones.dev/v1.FleetAutoscalerSync">FleetAutoscalerSync
 </h3>
 <p>
 (<em>Appears on:</em>
-<a href="#allocation.agones.dev/v1.GameServerAllocationStatus">GameServerAllocationStatus</a>, 
-<a href="#agones.dev/v1.GameServerStatus">GameServerStatus</a>)
+<a href="#autoscaling.agones.dev/v1.FleetAutoscalerSpec">FleetAutoscalerSpec</a>)
 </p>
 <p>
-<p>GameServerStatusPort shows the port that was allocated to a
-GameServer.</p>
+<p>FleetAutoscalerSync describes when to sync a fleet</p>
 </p>
 <table>
 <thead>
@@ -1410,35 +1418,52 @@ <h3 id="agones.dev/v1.GameServerStatusPort">GameServerStatusPort
 <tbody>
 <tr>
 <td>
-<code>name</code></br>
+<code>type</code></br>
 <em>
-string
+<a href="#autoscaling.agones.dev/v1.FleetAutoscalerSyncType">
+FleetAutoscalerSyncType
+</a>
 </em>
 </td>
 <td>
+<p>Type of autoscaling sync.</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>port</code></br>
+<code>fixedInterval</code></br>
 <em>
-int32
+<a href="#autoscaling.agones.dev/v1.FixedIntervalSync">
+FixedIntervalSync
+</a>
 </em>
 </td>
 <td>
+<em>(Optional)</em>
+<p>FixedInterval config params. Present only if FleetAutoscalerSyncType = FixedInterval.</p>
 </td>
 </tr>
 </tbody>
 </table>
-<h3 id="agones.dev/v1.GameServerTemplateSpec">GameServerTemplateSpec
+<h3 id="autoscaling.agones.dev/v1.FleetAutoscalerSyncType">FleetAutoscalerSyncType
+(<code>string</code> alias)</p></h3>
+<p>
+(<em>Appears on:</em>
+<a href="#autoscaling.agones.dev/v1.FleetAutoscalerSync">FleetAutoscalerSync</a>)
+</p>
+<p>
+<p>FleetAutoscalerSyncType is the sync strategy for a given Fleet</p>
+</p>
+<h3 id="autoscaling.agones.dev/v1.WebhookPolicy">WebhookPolicy
 </h3>
 <p>
 (<em>Appears on:</em>
-<a href="#agones.dev/v1.FleetSpec">FleetSpec</a>, 
-<a href="#agones.dev/v1.GameServerSetSpec">GameServerSetSpec</a>)
+<a href="#autoscaling.agones.dev/v1.FleetAutoscalerPolicy">FleetAutoscalerPolicy</a>)
 </p>
 <p>
-<p>GameServerTemplateSpec is a template for GameServers</p>
+<p>WebhookPolicy controls the desired behavior of the webhook policy.
+It contains the description of the webhook autoscaler service
+used to form url which is accessible inside the cluster</p>
 </p>
 <table>
 <thead>
@@ -1450,158 +1475,162 @@ <h3 id="agones.dev/v1.GameServerTemplateSpec">GameServerTemplateSpec
 <tbody>
 <tr>
 <td>
-<code>metadata</code></br>
+<code>url</code></br>
 <em>
-<a href="https://v1-24.docs.kubernetes.io/docs/reference/generated/kubernetes-api/v1.24/#objectmeta-v1-meta">
-Kubernetes meta/v1.ObjectMeta
-</a>
+string
 </em>
 </td>
 <td>
-Refer to the Kubernetes API documentation for the fields of the
-<code>metadata</code> field.
+<em>(Optional)</em>
+<p><code>url</code> gives the location of the webhook, in standard URL form
+(<code>scheme://host:port/path</code>). Exactly one of <code>url</code> or <code>service</code>
+must be specified.</p>
+<p>The <code>host</code> should not refer to a service running in the cluster; use
+the <code>service</code> field instead. The host might be resolved via external
+DNS in some apiservers (e.g., <code>kube-apiserver</code> cannot resolve
+in-cluster DNS as that would be a layering violation). <code>host</code> may
+also be an IP address.</p>
+<p>Please note that using <code>localhost</code> or <code>127.0.0.1</code> as a <code>host</code> is
+risky unless you take great care to run this webhook on all hosts
+which run an apiserver which might need to make calls to this
+webhook. Such installs are likely to be non-portable, i.e., not easy
+to turn up in a new cluster.</p>
+<p>The scheme must be &ldquo;https&rdquo;; the URL must begin with &ldquo;https://&rdquo;.</p>
+<p>A path is optional, and if present may be any string permissible in
+a URL. You may use the path to pass an arbitrary string to the
+webhook, for example, a cluster identifier.</p>
+<p>Attempting to use a user or basic auth e.g. &ldquo;user:password@&rdquo; is not
+allowed. Fragments (&ldquo;#&hellip;&rdquo;) and query parameters (&ldquo;?&hellip;&rdquo;) are not
+allowed, either.</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>spec</code></br>
+<code>service</code></br>
 <em>
-<a href="#agones.dev/v1.GameServerSpec">
-GameServerSpec
+<a href="https://v1-25.docs.kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#servicereference-v1-admissionregistration">
+Kubernetes admissionregistration/v1.ServiceReference
 </a>
 </em>
 </td>
 <td>
-<br/>
-<br/>
-<table>
+<em>(Optional)</em>
+<p><code>service</code> is a reference to the service for this webhook. Either
+<code>service</code> or <code>url</code> must be specified.</p>
+<p>If the webhook is running within the cluster, then you should use <code>service</code>.</p>
+</td>
+</tr>
 <tr>
 <td>
-<code>container</code></br>
+<code>caBundle</code></br>
 <em>
-string
+[]byte
 </em>
 </td>
 <td>
-<p>Container specifies which Pod container is the game server. Only required if there is more than one
-container defined</p>
+<em>(Optional)</em>
+<p><code>caBundle</code> is a PEM encoded CA bundle which will be used to validate the webhook&rsquo;s server certificate.
+If unspecified, system trust roots on the apiserver are used.</p>
 </td>
 </tr>
+</tbody>
+</table>
+<hr/>
+<h2 id="multicluster.agones.dev/v1">multicluster.agones.dev/v1</h2>
+<p>
+<p>Package v1 is the v1 version of the API.</p>
+</p>
+Resource Types:
+<ul><li>
+<a href="#multicluster.agones.dev/v1.GameServerAllocationPolicy">GameServerAllocationPolicy</a>
+</li></ul>
+<h3 id="multicluster.agones.dev/v1.GameServerAllocationPolicy">GameServerAllocationPolicy
+</h3>
+<p>
+<p>GameServerAllocationPolicy is the Schema for the gameserverallocationpolicies API</p>
+</p>
+<table>
+<thead>
+<tr>
+<th>Field</th>
+<th>Description</th>
+</tr>
+</thead>
+<tbody>
 <tr>
 <td>
-<code>ports</code></br>
-<em>
-<a href="#agones.dev/v1.GameServerPort">
-[]GameServerPort
-</a>
-</em>
+<code>apiVersion</code></br>
+string</td>
+<td>
+<code>
+multicluster.agones.dev/v1
+</code>
 </td>
+</tr>
+<tr>
 <td>
-<p>Ports are the array of ports that can be exposed via the game server</p>
+<code>kind</code></br>
+string
 </td>
+<td><code>GameServerAllocationPolicy</code></td>
 </tr>
 <tr>
 <td>
-<code>health</code></br>
+<code>metadata</code></br>
 <em>
-<a href="#agones.dev/v1.Health">
-Health
+<a href="https://v1-25.docs.kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
+Kubernetes meta/v1.ObjectMeta
 </a>
 </em>
 </td>
 <td>
-<p>Health configures health checking</p>
+Refer to the Kubernetes API documentation for the fields of the
+<code>metadata</code> field.
 </td>
 </tr>
 <tr>
 <td>
-<code>scheduling</code></br>
+<code>spec</code></br>
 <em>
-agones.dev/agones/pkg/apis.SchedulingStrategy
+<a href="#multicluster.agones.dev/v1.GameServerAllocationPolicySpec">
+GameServerAllocationPolicySpec
+</a>
 </em>
 </td>
 <td>
-<p>Scheduling strategy. Defaults to &ldquo;Packed&rdquo;</p>
-</td>
-</tr>
+<br/>
+<br/>
+<table>
 <tr>
 <td>
-<code>sdkServer</code></br>
+<code>priority</code></br>
 <em>
-<a href="#agones.dev/v1.SdkServer">
-SdkServer
-</a>
+int32
 </em>
 </td>
 <td>
-<p>SdkServer specifies parameters for the Agones SDK Server sidecar container</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>template</code></br>
+<code>weight</code></br>
 <em>
-<a href="https://v1-24.docs.kubernetes.io/docs/reference/generated/kubernetes-api/v1.24/#podtemplatespec-v1-core">
-Kubernetes core/v1.PodTemplateSpec
-</a>
+int
 </em>
 </td>
 <td>
-<p>Template describes the Pod that will be created for the GameServer</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>players</code></br>
+<code>connectionInfo</code></br>
 <em>
-<a href="#agones.dev/v1.PlayersSpec">
-PlayersSpec
+<a href="#multicluster.agones.dev/v1.ClusterConnectionInfo">
+ClusterConnectionInfo
 </a>
 </em>
 </td>
 <td>
-<em>(Optional)</em>
-<p>(Alpha, PlayerTracking feature flag) Players provides the configuration for player tracking features.</p>
-</td>
-</tr>
-<tr>
-<td>
-<code>counters</code></br>
-<em>
-<a href="#agones.dev/v1.CounterStatus">
-map[string]agones.dev/agones/pkg/apis/agones/v1.CounterStatus
-</a>
-</em>
-</td>
-<td>
-<em>(Optional)</em>
-<p>(Alpha, CountsAndLists feature flag) Counters and Lists provides the configuration for generic tracking features.</p>
-</td>
-</tr>
-<tr>
-<td>
-<code>lists</code></br>
-<em>
-<a href="#agones.dev/v1.ListStatus">
-map[string]agones.dev/agones/pkg/apis/agones/v1.ListStatus
-</a>
-</em>
-</td>
-<td>
-</td>
-</tr>
-<tr>
-<td>
-<code>eviction</code></br>
-<em>
-<a href="#agones.dev/v1.Eviction">
-Eviction
-</a>
-</em>
-</td>
-<td>
-<em>(Optional)</em>
-<p>(Alpha, SafeToEvict feature flag) Eviction specifies the eviction tolerance of the GameServer. Defaults to &ldquo;Never&rdquo;.</p>
 </td>
 </tr>
 </table>
@@ -1609,14 +1638,14 @@ <h3 id="agones.dev/v1.GameServerTemplateSpec">GameServerTemplateSpec
 </tr>
 </tbody>
 </table>
-<h3 id="agones.dev/v1.Health">Health
+<h3 id="multicluster.agones.dev/v1.ClusterConnectionInfo">ClusterConnectionInfo
 </h3>
 <p>
 (<em>Appears on:</em>
-<a href="#agones.dev/v1.GameServerSpec">GameServerSpec</a>)
+<a href="#multicluster.agones.dev/v1.GameServerAllocationPolicySpec">GameServerAllocationPolicySpec</a>)
 </p>
 <p>
-<p>Health configures health checking on the GameServer</p>
+<p>ClusterConnectionInfo defines the connection information for a cluster</p>
 </p>
 <table>
 <thead>
@@ -1628,98 +1657,67 @@ <h3 id="agones.dev/v1.Health">Health
 <tbody>
 <tr>
 <td>
-<code>disabled</code></br>
-<em>
-bool
-</em>
-</td>
-<td>
-<p>Disabled is whether health checking is disabled or not</p>
-</td>
-</tr>
-<tr>
-<td>
-<code>periodSeconds</code></br>
+<code>clusterName</code></br>
 <em>
-int32
+string
 </em>
 </td>
 <td>
-<p>PeriodSeconds is the number of seconds each health ping has to occur in</p>
+<p>Optional: the name of the targeted cluster</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>failureThreshold</code></br>
+<code>allocationEndpoints</code></br>
 <em>
-int32
+[]string
 </em>
 </td>
 <td>
-<p>FailureThreshold how many failures in a row constitutes unhealthy</p>
+<p>The endpoints for the allocator service in the targeted cluster.
+If the AllocationEndpoints is not set, the allocation happens on local cluster.
+If there are multiple endpoints any of the endpoints that can handle allocation request should suffice</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>initialDelaySeconds</code></br>
+<code>secretName</code></br>
 <em>
-int32
+string
 </em>
 </td>
 <td>
-<p>InitialDelaySeconds initial delay before checking health</p>
+<p>The name of the secret that contains TLS client certificates to connect the allocator server in the targeted cluster</p>
 </td>
 </tr>
-</tbody>
-</table>
-<h3 id="agones.dev/v1.ListStatus">ListStatus
-</h3>
-<p>
-(<em>Appears on:</em>
-<a href="#agones.dev/v1.GameServerSpec">GameServerSpec</a>, 
-<a href="#agones.dev/v1.GameServerStatus">GameServerStatus</a>)
-</p>
-<p>
-<p>ListStatus stores the current list values</p>
-</p>
-<table>
-<thead>
-<tr>
-<th>Field</th>
-<th>Description</th>
-</tr>
-</thead>
-<tbody>
 <tr>
 <td>
-<code>capacity</code></br>
+<code>namespace</code></br>
 <em>
-int64
+string
 </em>
 </td>
 <td>
+<p>The cluster namespace from which to allocate gameservers</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>values</code></br>
+<code>serverCa</code></br>
 <em>
-[]string
+[]byte
 </em>
 </td>
 <td>
+<p>The PEM encoded server CA, used by the allocator client to authenticate the remote server.</p>
 </td>
 </tr>
 </tbody>
 </table>
-<h3 id="agones.dev/v1.PlayerStatus">PlayerStatus
+<h3 id="multicluster.agones.dev/v1.ConnectionInfoIterator">ConnectionInfoIterator
 </h3>
 <p>
-(<em>Appears on:</em>
-<a href="#agones.dev/v1.GameServerStatus">GameServerStatus</a>)
-</p>
-<p>
-<p>PlayerStatus stores the current player capacity values</p>
+<p>ConnectionInfoIterator an iterator on ClusterConnectionInfo</p>
 </p>
 <table>
 <thead>
@@ -1731,82 +1729,58 @@ <h3 id="agones.dev/v1.PlayerStatus">PlayerStatus
 <tbody>
 <tr>
 <td>
-<code>count</code></br>
+<code>currPriority</code></br>
 <em>
-int64
+int
 </em>
 </td>
 <td>
+<p>currPriority Current priority index from the orderedPriorities</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>capacity</code></br>
+<code>orderedPriorities</code></br>
 <em>
-int64
+[]int32
 </em>
 </td>
 <td>
+<p>orderedPriorities list of ordered priorities</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>ids</code></br>
+<code>priorityToCluster</code></br>
 <em>
-[]string
+map[int32]map[string][]*agones.dev/agones/pkg/apis/multicluster/v1.GameServerAllocationPolicy
 </em>
 </td>
 <td>
+<p>priorityToCluster Map of priority to cluster-policies map</p>
 </td>
 </tr>
-</tbody>
-</table>
-<h3 id="agones.dev/v1.PlayersSpec">PlayersSpec
-</h3>
-<p>
-(<em>Appears on:</em>
-<a href="#agones.dev/v1.GameServerSpec">GameServerSpec</a>)
-</p>
-<p>
-<p>PlayersSpec tracks the initial player capacity</p>
-</p>
-<table>
-<thead>
-<tr>
-<th>Field</th>
-<th>Description</th>
-</tr>
-</thead>
-<tbody>
 <tr>
 <td>
-<code>initialCapacity</code></br>
+<code>clusterBlackList</code></br>
 <em>
-int64
+map[string]bool
 </em>
 </td>
 <td>
+<p>clusterBlackList the cluster blacklist for the clusters that has already returned</p>
 </td>
 </tr>
 </tbody>
 </table>
-<h3 id="agones.dev/v1.PortPolicy">PortPolicy
-(<code>string</code> alias)</p></h3>
-<p>
-(<em>Appears on:</em>
-<a href="#agones.dev/v1.GameServerPort">GameServerPort</a>)
-</p>
-<p>
-<p>PortPolicy is the port policy for the GameServer</p>
-</p>
-<h3 id="agones.dev/v1.SdkServer">SdkServer
+<h3 id="multicluster.agones.dev/v1.GameServerAllocationPolicySpec">GameServerAllocationPolicySpec
 </h3>
 <p>
 (<em>Appears on:</em>
-<a href="#agones.dev/v1.GameServerSpec">GameServerSpec</a>)
+<a href="#multicluster.agones.dev/v1.GameServerAllocationPolicy">GameServerAllocationPolicy</a>)
 </p>
 <p>
-<p>SdkServer specifies parameters for the Agones SDK Server sidecar container</p>
+<p>GameServerAllocationPolicySpec defines the desired state of GameServerAllocationPolicy</p>
 </p>
 <table>
 <thead>
@@ -1818,64 +1792,55 @@ <h3 id="agones.dev/v1.SdkServer">SdkServer
 <tbody>
 <tr>
 <td>
-<code>logLevel</code></br>
+<code>priority</code></br>
 <em>
-<a href="#agones.dev/v1.SdkServerLogLevel">
-SdkServerLogLevel
-</a>
+int32
 </em>
 </td>
 <td>
-<p>LogLevel for SDK server (sidecar) logs. Defaults to &ldquo;Info&rdquo;</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>grpcPort</code></br>
+<code>weight</code></br>
 <em>
-int32
+int
 </em>
 </td>
 <td>
-<p>GRPCPort is the port on which the SDK Server binds the gRPC server to accept incoming connections</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>httpPort</code></br>
+<code>connectionInfo</code></br>
 <em>
-int32
+<a href="#multicluster.agones.dev/v1.ClusterConnectionInfo">
+ClusterConnectionInfo
+</a>
 </em>
 </td>
 <td>
-<p>HTTPPort is the port on which the SDK Server binds the HTTP gRPC gateway server to accept incoming connections</p>
 </td>
 </tr>
 </tbody>
 </table>
-<h3 id="agones.dev/v1.SdkServerLogLevel">SdkServerLogLevel
-(<code>string</code> alias)</p></h3>
-<p>
-(<em>Appears on:</em>
-<a href="#agones.dev/v1.SdkServer">SdkServer</a>)
-</p>
-<p>
-<p>SdkServerLogLevel is the log level for SDK server (sidecar) logs</p>
-</p>
 <hr/>
-<h2 id="allocation.agones.dev/v1">allocation.agones.dev/v1</h2>
+<h2 id="agones.dev/v1">agones.dev/v1</h2>
 <p>
 <p>Package v1 is the v1 version of the API.</p>
 </p>
 Resource Types:
 <ul><li>
-<a href="#allocation.agones.dev/v1.GameServerAllocation">GameServerAllocation</a>
+<a href="#agones.dev/v1.Fleet">Fleet</a>
+</li><li>
+<a href="#agones.dev/v1.GameServer">GameServer</a>
+</li><li>
+<a href="#agones.dev/v1.GameServerSet">GameServerSet</a>
 </li></ul>
-<h3 id="allocation.agones.dev/v1.GameServerAllocation">GameServerAllocation
+<h3 id="agones.dev/v1.Fleet">Fleet
 </h3>
 <p>
-<p>GameServerAllocation is the data structure for allocating against a set of
-GameServers, defined <code>selectors</code> selectors</p>
+<p>Fleet is the data structure for a Fleet resource</p>
 </p>
 <table>
 <thead>
@@ -1891,7 +1856,7 @@ <h3 id="allocation.agones.dev/v1.GameServerAllocation">GameServerAllocation
 string</td>
 <td>
 <code>
-allocation.agones.dev/v1
+agones.dev/v1
 </code>
 </td>
 </tr>
@@ -1900,13 +1865,13 @@ <h3 id="allocation.agones.dev/v1.GameServerAllocation">GameServerAllocation
 <code>kind</code></br>
 string
 </td>
-<td><code>GameServerAllocation</code></td>
+<td><code>Fleet</code></td>
 </tr>
 <tr>
 <td>
 <code>metadata</code></br>
 <em>
-<a href="https://v1-24.docs.kubernetes.io/docs/reference/generated/kubernetes-api/v1.24/#objectmeta-v1-meta">
+<a href="https://v1-25.docs.kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
 Kubernetes meta/v1.ObjectMeta
 </a>
 </em>
@@ -1920,8 +1885,8 @@ <h3 id="allocation.agones.dev/v1.GameServerAllocation">GameServerAllocation
 <td>
 <code>spec</code></br>
 <em>
-<a href="#allocation.agones.dev/v1.GameServerAllocationSpec">
-GameServerAllocationSpec
+<a href="#agones.dev/v1.FleetSpec">
+FleetSpec
 </a>
 </em>
 </td>
@@ -1931,70 +1896,48 @@ <h3 id="allocation.agones.dev/v1.GameServerAllocation">GameServerAllocation
 <table>
 <tr>
 <td>
-<code>multiClusterSetting</code></br>
+<code>replicas</code></br>
 <em>
-<a href="#allocation.agones.dev/v1.MultiClusterSetting">
-MultiClusterSetting
-</a>
+int32
 </em>
 </td>
 <td>
-<p>MultiClusterPolicySelector if specified, multi-cluster policies are applied.
-Otherwise, allocation will happen locally.</p>
+<p>Replicas are the number of GameServers that should be in this set. Defaults to 0.</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>required</code></br>
+<code>allocationOverflow</code></br>
 <em>
-<a href="#allocation.agones.dev/v1.GameServerSelector">
-GameServerSelector
+<a href="#agones.dev/v1.AllocationOverflow">
+AllocationOverflow
 </a>
 </em>
 </td>
 <td>
-<p>Deprecated: use field Selectors instead. If Selectors is set, this field is ignored.
-Required is the GameServer selector from which to choose GameServers from.
-Defaults to all GameServers.</p>
+<em>(Optional)</em>
+<p>[Stage: Alpha]
+[FeatureFlag:FleetAllocationOverflow]
+Labels and Annotations to apply to GameServers when the number of Allocated GameServers drops below
+the desired replicas on the underlying <code>GameServerSet</code></p>
 </td>
 </tr>
 <tr>
 <td>
-<code>preferred</code></br>
+<code>strategy</code></br>
 <em>
-<a href="#allocation.agones.dev/v1.GameServerSelector">
-[]GameServerSelector
+<a href="https://v1-25.docs.kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#deploymentstrategy-v1-apps">
+Kubernetes apps/v1.DeploymentStrategy
 </a>
 </em>
 </td>
 <td>
-<p>Deprecated: use field Selectors instead. If Selectors is set, this field is ignored.
-Preferred is an ordered list of preferred GameServer selectors
-that are optional to be fulfilled, but will be searched before the <code>required</code> selector.
-If the first selector is not matched, the selection attempts the second selector, and so on.
-If any of the preferred selectors are matched, the required selector is not considered.
-This is useful for things like smoke testing of new game servers.</p>
+<p>Deployment strategy</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>selectors</code></br>
-<em>
-<a href="#allocation.agones.dev/v1.GameServerSelector">
-[]GameServerSelector
-</a>
-</em>
-</td>
-<td>
-<p>Ordered list of GameServer label selectors.
-If the first selector is not matched, the selection attempts the second selector, and so on.
-This is useful for things like smoke testing of new game servers.
-Note: This field can only be set if neither Required or Preferred is set.</p>
-</td>
-</tr>
-<tr>
-<td>
-<code>scheduling</code></br>
+<code>scheduling</code></br>
 <em>
 agones.dev/agones/pkg/apis.SchedulingStrategy
 </em>
@@ -2005,16 +1948,15 @@ <h3 id="allocation.agones.dev/v1.GameServerAllocation">GameServerAllocation
 </tr>
 <tr>
 <td>
-<code>metadata</code></br>
+<code>template</code></br>
 <em>
-<a href="#allocation.agones.dev/v1.MetaPatch">
-MetaPatch
+<a href="#agones.dev/v1.GameServerTemplateSpec">
+GameServerTemplateSpec
 </a>
 </em>
 </td>
 <td>
-<p>MetaPatch is optional custom metadata that is added to the game server at allocation
-You can use this to tell the server necessary session data</p>
+<p>Template the GameServer template to apply for this Fleet</p>
 </td>
 </tr>
 </table>
@@ -2024,8 +1966,8 @@ <h3 id="allocation.agones.dev/v1.GameServerAllocation">GameServerAllocation
 <td>
 <code>status</code></br>
 <em>
-<a href="#allocation.agones.dev/v1.GameServerAllocationStatus">
-GameServerAllocationStatus
+<a href="#agones.dev/v1.FleetStatus">
+FleetStatus
 </a>
 </em>
 </td>
@@ -2034,14 +1976,14 @@ <h3 id="allocation.agones.dev/v1.GameServerAllocation">GameServerAllocation
 </tr>
 </tbody>
 </table>
-<h3 id="allocation.agones.dev/v1.GameServerAllocationSpec">GameServerAllocationSpec
+<h3 id="agones.dev/v1.GameServer">GameServer
 </h3>
 <p>
-(<em>Appears on:</em>
-<a href="#allocation.agones.dev/v1.GameServerAllocation">GameServerAllocation</a>)
-</p>
-<p>
-<p>GameServerAllocationSpec is the spec for a GameServerAllocation</p>
+<p>GameServer is the data structure for a GameServer resource.
+It is worth noting that while there is a <code>GameServerStatus</code> Status entry for the <code>GameServer</code>, it is not
+defined as a subresource - unlike <code>Fleet</code> and other Agones resources.
+This is so that we can retain the ability to change multiple aspects of a <code>GameServer</code> in a single atomic operation,
+which is particularly useful for operations such as allocation.</p>
 </p>
 <table>
 <thead>
@@ -2053,65 +1995,84 @@ <h3 id="allocation.agones.dev/v1.GameServerAllocationSpec">GameServerAllocationS
 <tbody>
 <tr>
 <td>
-<code>multiClusterSetting</code></br>
+<code>apiVersion</code></br>
+string</td>
+<td>
+<code>
+agones.dev/v1
+</code>
+</td>
+</tr>
+<tr>
+<td>
+<code>kind</code></br>
+string
+</td>
+<td><code>GameServer</code></td>
+</tr>
+<tr>
+<td>
+<code>metadata</code></br>
 <em>
-<a href="#allocation.agones.dev/v1.MultiClusterSetting">
-MultiClusterSetting
+<a href="https://v1-25.docs.kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
+Kubernetes meta/v1.ObjectMeta
 </a>
 </em>
 </td>
 <td>
-<p>MultiClusterPolicySelector if specified, multi-cluster policies are applied.
-Otherwise, allocation will happen locally.</p>
+Refer to the Kubernetes API documentation for the fields of the
+<code>metadata</code> field.
 </td>
 </tr>
 <tr>
 <td>
-<code>required</code></br>
+<code>spec</code></br>
 <em>
-<a href="#allocation.agones.dev/v1.GameServerSelector">
-GameServerSelector
+<a href="#agones.dev/v1.GameServerSpec">
+GameServerSpec
 </a>
 </em>
 </td>
 <td>
-<p>Deprecated: use field Selectors instead. If Selectors is set, this field is ignored.
-Required is the GameServer selector from which to choose GameServers from.
-Defaults to all GameServers.</p>
+<br/>
+<br/>
+<table>
+<tr>
+<td>
+<code>container</code></br>
+<em>
+string
+</em>
+</td>
+<td>
+<p>Container specifies which Pod container is the game server. Only required if there is more than one
+container defined</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>preferred</code></br>
+<code>ports</code></br>
 <em>
-<a href="#allocation.agones.dev/v1.GameServerSelector">
-[]GameServerSelector
+<a href="#agones.dev/v1.GameServerPort">
+[]GameServerPort
 </a>
 </em>
 </td>
 <td>
-<p>Deprecated: use field Selectors instead. If Selectors is set, this field is ignored.
-Preferred is an ordered list of preferred GameServer selectors
-that are optional to be fulfilled, but will be searched before the <code>required</code> selector.
-If the first selector is not matched, the selection attempts the second selector, and so on.
-If any of the preferred selectors are matched, the required selector is not considered.
-This is useful for things like smoke testing of new game servers.</p>
+<p>Ports are the array of ports that can be exposed via the game server</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>selectors</code></br>
+<code>health</code></br>
 <em>
-<a href="#allocation.agones.dev/v1.GameServerSelector">
-[]GameServerSelector
+<a href="#agones.dev/v1.Health">
+Health
 </a>
 </em>
 </td>
 <td>
-<p>Ordered list of GameServer label selectors.
-If the first selector is not matched, the selection attempts the second selector, and so on.
-This is useful for things like smoke testing of new game servers.
-Note: This field can only be set if neither Required or Preferred is set.</p>
+<p>Health configures health checking</p>
 </td>
 </tr>
 <tr>
@@ -2122,91 +2083,70 @@ <h3 id="allocation.agones.dev/v1.GameServerAllocationSpec">GameServerAllocationS
 </em>
 </td>
 <td>
-<p>Scheduling strategy. Defaults to &ldquo;Packed&rdquo;.</p>
+<p>Scheduling strategy. Defaults to &ldquo;Packed&rdquo;</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>metadata</code></br>
+<code>sdkServer</code></br>
 <em>
-<a href="#allocation.agones.dev/v1.MetaPatch">
-MetaPatch
+<a href="#agones.dev/v1.SdkServer">
+SdkServer
 </a>
 </em>
 </td>
 <td>
-<p>MetaPatch is optional custom metadata that is added to the game server at allocation
-You can use this to tell the server necessary session data</p>
+<p>SdkServer specifies parameters for the Agones SDK Server sidecar container</p>
 </td>
 </tr>
-</tbody>
-</table>
-<h3 id="allocation.agones.dev/v1.GameServerAllocationState">GameServerAllocationState
-(<code>string</code> alias)</p></h3>
-<p>
-(<em>Appears on:</em>
-<a href="#allocation.agones.dev/v1.GameServerAllocationStatus">GameServerAllocationStatus</a>)
-</p>
-<p>
-<p>GameServerAllocationState is the Allocation state</p>
-</p>
-<h3 id="allocation.agones.dev/v1.GameServerAllocationStatus">GameServerAllocationStatus
-</h3>
-<p>
-(<em>Appears on:</em>
-<a href="#allocation.agones.dev/v1.GameServerAllocation">GameServerAllocation</a>)
-</p>
-<p>
-<p>GameServerAllocationStatus is the status for an GameServerAllocation resource</p>
-</p>
-<table>
-<thead>
-<tr>
-<th>Field</th>
-<th>Description</th>
-</tr>
-</thead>
-<tbody>
 <tr>
 <td>
-<code>state</code></br>
+<code>template</code></br>
 <em>
-<a href="#allocation.agones.dev/v1.GameServerAllocationState">
-GameServerAllocationState
+<a href="https://v1-25.docs.kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#podtemplatespec-v1-core">
+Kubernetes core/v1.PodTemplateSpec
 </a>
 </em>
 </td>
 <td>
-<p>GameServerState is the current state of an GameServerAllocation, e.g. Allocated, or UnAllocated</p>
+<p>Template describes the Pod that will be created for the GameServer</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>gameServerName</code></br>
+<code>players</code></br>
 <em>
-string
+<a href="#agones.dev/v1.PlayersSpec">
+PlayersSpec
+</a>
 </em>
 </td>
 <td>
+<em>(Optional)</em>
+<p>(Alpha, PlayerTracking feature flag) Players provides the configuration for player tracking features.</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>ports</code></br>
+<code>counters</code></br>
 <em>
-<a href="#agones.dev/v1.GameServerStatusPort">
-[]GameServerStatusPort
+<a href="#agones.dev/v1.CounterStatus">
+map[string]agones.dev/agones/pkg/apis/agones/v1.CounterStatus
 </a>
 </em>
 </td>
 <td>
+<em>(Optional)</em>
+<p>(Alpha, CountsAndLists feature flag) Counters and Lists provides the configuration for generic tracking features.</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>address</code></br>
+<code>lists</code></br>
 <em>
-string
+<a href="#agones.dev/v1.ListStatus">
+map[string]agones.dev/agones/pkg/apis/agones/v1.ListStatus
+</a>
 </em>
 </td>
 <td>
@@ -2214,37 +2154,41 @@ <h3 id="allocation.agones.dev/v1.GameServerAllocationStatus">GameServerAllocatio
 </tr>
 <tr>
 <td>
-<code>nodeName</code></br>
+<code>eviction</code></br>
 <em>
-string
+<a href="#agones.dev/v1.Eviction">
+Eviction
+</a>
 </em>
 </td>
 <td>
+<em>(Optional)</em>
+<p>(Alpha, SafeToEvict feature flag) Eviction specifies the eviction tolerance of the GameServer. Defaults to &ldquo;Never&rdquo;.</p>
+</td>
+</tr>
+</table>
 </td>
 </tr>
 <tr>
 <td>
-<code>source</code></br>
+<code>status</code></br>
 <em>
-string
+<a href="#agones.dev/v1.GameServerStatus">
+GameServerStatus
+</a>
 </em>
 </td>
 <td>
-<p>If the allocation is from a remote cluster, Source is the endpoint of the remote agones-allocator.
-Otherwise, Source is &ldquo;local&rdquo;</p>
 </td>
 </tr>
 </tbody>
 </table>
-<h3 id="allocation.agones.dev/v1.GameServerSelector">GameServerSelector
+<h3 id="agones.dev/v1.GameServerSet">GameServerSet
 </h3>
 <p>
-(<em>Appears on:</em>
-<a href="#allocation.agones.dev/v1.GameServerAllocationSpec">GameServerAllocationSpec</a>)
-</p>
-<p>
-<p>GameServerSelector contains all the filter options for selecting
-a GameServer for allocation.</p>
+<p>GameServerSet is the data structure for a set of GameServers.
+This matches philosophically with the relationship between
+Deployments and ReplicaSets</p>
 </p>
 <table>
 <thead>
@@ -2256,65 +2200,126 @@ <h3 id="allocation.agones.dev/v1.GameServerSelector">GameServerSelector
 <tbody>
 <tr>
 <td>
-<code>LabelSelector</code></br>
-<em>
-<a href="https://v1-24.docs.kubernetes.io/docs/reference/generated/kubernetes-api/v1.24/#labelselector-v1-meta">
-Kubernetes meta/v1.LabelSelector
-</a>
-</em>
+<code>apiVersion</code></br>
+string</td>
+<td>
+<code>
+agones.dev/v1
+</code>
 </td>
+</tr>
+<tr>
 <td>
-<p>
-(Members of <code>LabelSelector</code> are embedded into this type.)
-</p>
-<p>See: <a href="https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/">https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/</a></p>
+<code>kind</code></br>
+string
 </td>
+<td><code>GameServerSet</code></td>
 </tr>
 <tr>
 <td>
-<code>gameServerState</code></br>
+<code>metadata</code></br>
 <em>
-<a href="#agones.dev/v1.GameServerState">
-GameServerState
+<a href="https://v1-25.docs.kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
+Kubernetes meta/v1.ObjectMeta
 </a>
 </em>
 </td>
 <td>
-<em>(Optional)</em>
-<p>[Stage:Beta]
-[FeatureFlag:StateAllocationFilter]
-GameServerState specifies which State is the filter to be used when attempting to retrieve a GameServer
-via Allocation. Defaults to &ldquo;Ready&rdquo;. The only other option is &ldquo;Allocated&rdquo;, which can be used in conjunction with
-label/annotation/player selectors to retrieve an already Allocated GameServer.</p>
+Refer to the Kubernetes API documentation for the fields of the
+<code>metadata</code> field.
 </td>
 </tr>
 <tr>
 <td>
-<code>players</code></br>
+<code>spec</code></br>
 <em>
-<a href="#allocation.agones.dev/v1.PlayerSelector">
-PlayerSelector
+<a href="#agones.dev/v1.GameServerSetSpec">
+GameServerSetSpec
 </a>
 </em>
 </td>
 <td>
-<em>(Optional)</em>
-<p>[Stage:Alpha]
-[FeatureFlag:PlayerAllocationFilter]
-Players provides a filter on minimum and maximum values for player capacity when retrieving a GameServer
-through Allocation. Defaults to no limits.</p>
-</td>
+<br/>
+<br/>
+<table>
+<tr>
+<td>
+<code>replicas</code></br>
+<em>
+int32
+</em>
+</td>
+<td>
+<p>Replicas are the number of GameServers that should be in this set</p>
+</td>
+</tr>
+<tr>
+<td>
+<code>allocationOverflow</code></br>
+<em>
+<a href="#agones.dev/v1.AllocationOverflow">
+AllocationOverflow
+</a>
+</em>
+</td>
+<td>
+<em>(Optional)</em>
+<p>[Stage: Alpha]
+[FeatureFlag:FleetAllocationOverflow]
+Labels and Annotations to apply to GameServers when the number of Allocated GameServers drops below
+the desired replicas on the underlying <code>GameServerSet</code></p>
+</td>
+</tr>
+<tr>
+<td>
+<code>scheduling</code></br>
+<em>
+agones.dev/agones/pkg/apis.SchedulingStrategy
+</em>
+</td>
+<td>
+<p>Scheduling strategy. Defaults to &ldquo;Packed&rdquo;.</p>
+</td>
+</tr>
+<tr>
+<td>
+<code>template</code></br>
+<em>
+<a href="#agones.dev/v1.GameServerTemplateSpec">
+GameServerTemplateSpec
+</a>
+</em>
+</td>
+<td>
+<p>Template the GameServer template to apply for this GameServerSet</p>
+</td>
+</tr>
+</table>
+</td>
+</tr>
+<tr>
+<td>
+<code>status</code></br>
+<em>
+<a href="#agones.dev/v1.GameServerSetStatus">
+GameServerSetStatus
+</a>
+</em>
+</td>
+<td>
+</td>
 </tr>
 </tbody>
 </table>
-<h3 id="allocation.agones.dev/v1.MetaPatch">MetaPatch
+<h3 id="agones.dev/v1.AggregatedPlayerStatus">AggregatedPlayerStatus
 </h3>
 <p>
 (<em>Appears on:</em>
-<a href="#allocation.agones.dev/v1.GameServerAllocationSpec">GameServerAllocationSpec</a>)
+<a href="#agones.dev/v1.FleetStatus">FleetStatus</a>, 
+<a href="#agones.dev/v1.GameServerSetStatus">GameServerSetStatus</a>)
 </p>
 <p>
-<p>MetaPatch is the metadata used to patch the GameServer metadata on allocation</p>
+<p>AggregatedPlayerStatus stores total player tracking values</p>
 </p>
 <table>
 <thead>
@@ -2326,9 +2331,9 @@ <h3 id="allocation.agones.dev/v1.MetaPatch">MetaPatch
 <tbody>
 <tr>
 <td>
-<code>labels</code></br>
+<code>count</code></br>
 <em>
-map[string]string
+int64
 </em>
 </td>
 <td>
@@ -2336,9 +2341,9 @@ <h3 id="allocation.agones.dev/v1.MetaPatch">MetaPatch
 </tr>
 <tr>
 <td>
-<code>annotations</code></br>
+<code>capacity</code></br>
 <em>
-map[string]string
+int64
 </em>
 </td>
 <td>
@@ -2346,14 +2351,17 @@ <h3 id="allocation.agones.dev/v1.MetaPatch">MetaPatch
 </tr>
 </tbody>
 </table>
-<h3 id="allocation.agones.dev/v1.MultiClusterSetting">MultiClusterSetting
+<h3 id="agones.dev/v1.AllocationOverflow">AllocationOverflow
 </h3>
 <p>
 (<em>Appears on:</em>
-<a href="#allocation.agones.dev/v1.GameServerAllocationSpec">GameServerAllocationSpec</a>)
+<a href="#agones.dev/v1.FleetSpec">FleetSpec</a>, 
+<a href="#agones.dev/v1.GameServerSetSpec">GameServerSetSpec</a>)
 </p>
 <p>
-<p>MultiClusterSetting specifies settings for multi-cluster allocation.</p>
+<p>AllocationOverflow specifies what labels and/or annotations to apply on Allocated GameServers
+if the desired number of the underlying <code>GameServerSet</code> drops below the number of Allocated GameServers
+attached to it.</p>
 </p>
 <table>
 <thead>
@@ -2365,36 +2373,39 @@ <h3 id="allocation.agones.dev/v1.MultiClusterSetting">MultiClusterSetting
 <tbody>
 <tr>
 <td>
-<code>enabled</code></br>
+<code>labels</code></br>
 <em>
-bool
+map[string]string
 </em>
 </td>
 <td>
+<em>(Optional)</em>
+<p>Labels to be applied to the <code>GameServer</code></p>
 </td>
 </tr>
 <tr>
 <td>
-<code>policySelector</code></br>
+<code>annotations</code></br>
 <em>
-<a href="https://v1-24.docs.kubernetes.io/docs/reference/generated/kubernetes-api/v1.24/#labelselector-v1-meta">
-Kubernetes meta/v1.LabelSelector
-</a>
+map[string]string
 </em>
 </td>
 <td>
+<em>(Optional)</em>
+<p>Annotations to be applied to the <code>GameServer</code></p>
 </td>
 </tr>
 </tbody>
 </table>
-<h3 id="allocation.agones.dev/v1.PlayerSelector">PlayerSelector
+<h3 id="agones.dev/v1.CounterStatus">CounterStatus
 </h3>
 <p>
 (<em>Appears on:</em>
-<a href="#allocation.agones.dev/v1.GameServerSelector">GameServerSelector</a>)
+<a href="#agones.dev/v1.GameServerSpec">GameServerSpec</a>, 
+<a href="#agones.dev/v1.GameServerStatus">GameServerStatus</a>)
 </p>
 <p>
-<p>PlayerSelector is the filter options for a GameServer based on player counts</p>
+<p>CounterStatus stores the current counter values</p>
 </p>
 <table>
 <thead>
@@ -2406,7 +2417,7 @@ <h3 id="allocation.agones.dev/v1.PlayerSelector">PlayerSelector
 <tbody>
 <tr>
 <td>
-<code>minAvailable</code></br>
+<code>count</code></br>
 <em>
 int64
 </em>
@@ -2416,7 +2427,7 @@ <h3 id="allocation.agones.dev/v1.PlayerSelector">PlayerSelector
 </tr>
 <tr>
 <td>
-<code>maxAvailable</code></br>
+<code>capacity</code></br>
 <em>
 int64
 </em>
@@ -2426,19 +2437,15 @@ <h3 id="allocation.agones.dev/v1.PlayerSelector">PlayerSelector
 </tr>
 </tbody>
 </table>
-<hr/>
-<h2 id="autoscaling.agones.dev/v1">autoscaling.agones.dev/v1</h2>
+<h3 id="agones.dev/v1.Eviction">Eviction
+</h3>
 <p>
-<p>Package v1 is the v1 version of the API.</p>
+(<em>Appears on:</em>
+<a href="#agones.dev/v1.GameServerSpec">GameServerSpec</a>, 
+<a href="#agones.dev/v1.GameServerStatus">GameServerStatus</a>)
 </p>
-Resource Types:
-<ul><li>
-<a href="#autoscaling.agones.dev/v1.FleetAutoscaler">FleetAutoscaler</a>
-</li></ul>
-<h3 id="autoscaling.agones.dev/v1.FleetAutoscaler">FleetAutoscaler
-</h3>
 <p>
-<p>FleetAutoscaler is the data structure for a FleetAutoscaler resource</p>
+<p>Eviction specifies the eviction tolerance of the GameServer</p>
 </p>
 <table>
 <thead>
@@ -2450,112 +2457,125 @@ <h3 id="autoscaling.agones.dev/v1.FleetAutoscaler">FleetAutoscaler
 <tbody>
 <tr>
 <td>
-<code>apiVersion</code></br>
-string</td>
+<code>safe</code></br>
+<em>
+<a href="#agones.dev/v1.EvictionSafe">
+EvictionSafe
+</a>
+</em>
+</td>
 <td>
-<code>
-autoscaling.agones.dev/v1
-</code>
+<p>(Alpha, SafeToEvict feature flag)
+Game server supports termination via SIGTERM:
+- Always: Allow eviction for both Cluster Autoscaler and node drain for upgrades
+- OnUpgrade: Allow eviction for upgrades alone
+- Never (default): Pod should run to completion</p>
 </td>
 </tr>
+</tbody>
+</table>
+<h3 id="agones.dev/v1.EvictionSafe">EvictionSafe
+(<code>string</code> alias)</p></h3>
+<p>
+(<em>Appears on:</em>
+<a href="#agones.dev/v1.Eviction">Eviction</a>)
+</p>
+<p>
+<p>EvictionSafe specified whether the game server supports termination via SIGTERM</p>
+</p>
+<h3 id="agones.dev/v1.FleetSpec">FleetSpec
+</h3>
+<p>
+(<em>Appears on:</em>
+<a href="#agones.dev/v1.Fleet">Fleet</a>)
+</p>
+<p>
+<p>FleetSpec is the spec for a Fleet</p>
+</p>
+<table>
+<thead>
 <tr>
-<td>
-<code>kind</code></br>
-string
-</td>
-<td><code>FleetAutoscaler</code></td>
+<th>Field</th>
+<th>Description</th>
 </tr>
+</thead>
+<tbody>
 <tr>
 <td>
-<code>metadata</code></br>
+<code>replicas</code></br>
 <em>
-<a href="https://v1-24.docs.kubernetes.io/docs/reference/generated/kubernetes-api/v1.24/#objectmeta-v1-meta">
-Kubernetes meta/v1.ObjectMeta
-</a>
+int32
 </em>
 </td>
 <td>
-Refer to the Kubernetes API documentation for the fields of the
-<code>metadata</code> field.
+<p>Replicas are the number of GameServers that should be in this set. Defaults to 0.</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>spec</code></br>
+<code>allocationOverflow</code></br>
 <em>
-<a href="#autoscaling.agones.dev/v1.FleetAutoscalerSpec">
-FleetAutoscalerSpec
+<a href="#agones.dev/v1.AllocationOverflow">
+AllocationOverflow
 </a>
 </em>
 </td>
 <td>
-<br/>
-<br/>
-<table>
-<tr>
-<td>
-<code>fleetName</code></br>
-<em>
-string
-</em>
-</td>
-<td>
+<em>(Optional)</em>
+<p>[Stage: Alpha]
+[FeatureFlag:FleetAllocationOverflow]
+Labels and Annotations to apply to GameServers when the number of Allocated GameServers drops below
+the desired replicas on the underlying <code>GameServerSet</code></p>
 </td>
 </tr>
 <tr>
 <td>
-<code>policy</code></br>
+<code>strategy</code></br>
 <em>
-<a href="#autoscaling.agones.dev/v1.FleetAutoscalerPolicy">
-FleetAutoscalerPolicy
+<a href="https://v1-25.docs.kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#deploymentstrategy-v1-apps">
+Kubernetes apps/v1.DeploymentStrategy
 </a>
 </em>
 </td>
 <td>
-<p>Autoscaling policy</p>
+<p>Deployment strategy</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>sync</code></br>
+<code>scheduling</code></br>
 <em>
-<a href="#autoscaling.agones.dev/v1.FleetAutoscalerSync">
-FleetAutoscalerSync
-</a>
+agones.dev/agones/pkg/apis.SchedulingStrategy
 </em>
 </td>
 <td>
-<em>(Optional)</em>
-<p>[Stage:Beta]
-[FeatureFlag:CustomFasSyncInterval]
-Sync defines when FleetAutoscalers runs autoscaling</p>
-</td>
-</tr>
-</table>
+<p>Scheduling strategy. Defaults to &ldquo;Packed&rdquo;.</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>status</code></br>
+<code>template</code></br>
 <em>
-<a href="#autoscaling.agones.dev/v1.FleetAutoscalerStatus">
-FleetAutoscalerStatus
+<a href="#agones.dev/v1.GameServerTemplateSpec">
+GameServerTemplateSpec
 </a>
 </em>
 </td>
 <td>
+<p>Template the GameServer template to apply for this Fleet</p>
 </td>
 </tr>
 </tbody>
 </table>
-<h3 id="autoscaling.agones.dev/v1.BufferPolicy">BufferPolicy
+<h3 id="agones.dev/v1.FleetStatus">FleetStatus
 </h3>
 <p>
 (<em>Appears on:</em>
-<a href="#autoscaling.agones.dev/v1.FleetAutoscalerPolicy">FleetAutoscalerPolicy</a>)
+<a href="#agones.dev/v1.Fleet">Fleet</a>, 
+<a href="#autoscaling.agones.dev/v1.FleetAutoscaleRequest">FleetAutoscaleRequest</a>)
 </p>
 <p>
-<p>BufferPolicy controls the desired behavior of the buffer policy.</p>
+<p>FleetStatus is the status of a Fleet</p>
 </p>
 <table>
 <thead>
@@ -2567,89 +2587,76 @@ <h3 id="autoscaling.agones.dev/v1.BufferPolicy">BufferPolicy
 <tbody>
 <tr>
 <td>
-<code>maxReplicas</code></br>
+<code>replicas</code></br>
 <em>
 int32
 </em>
 </td>
 <td>
-<p>MaxReplicas is the maximum amount of replicas that the fleet may have.
-It must be bigger than both MinReplicas and BufferSize</p>
+<p>Replicas the total number of current GameServer replicas</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>minReplicas</code></br>
+<code>readyReplicas</code></br>
 <em>
 int32
 </em>
 </td>
 <td>
-<p>MinReplicas is the minimum amount of replicas that the fleet must have
-If zero, it is ignored.
-If non zero, it must be smaller than MaxReplicas and bigger than BufferSize</p>
+<p>ReadyReplicas are the number of Ready GameServer replicas</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>bufferSize</code></br>
+<code>reservedReplicas</code></br>
 <em>
-k8s.io/apimachinery/pkg/util/intstr.IntOrString
+int32
 </em>
 </td>
 <td>
-<p>BufferSize defines how many replicas the autoscaler tries to have ready all the time
-Value can be an absolute number (ex: 5) or a percentage of desired gs instances (ex: 15%)
-Absolute number is calculated from percentage by rounding up.
-Example: when this is set to 20%, the autoscaler will make sure that 20%
-of the fleet&rsquo;s game server replicas are ready. When this is set to 20,
-the autoscaler will make sure that there are 20 available game servers
-Must be bigger than 0
-Note: by &ldquo;ready&rdquo; we understand in this case &ldquo;non-allocated&rdquo;; this is done to ensure robustness
-and computation stability in different edge case (fleet just created, not enough
-capacity in the cluster etc)</p>
+<p>ReservedReplicas are the total number of Reserved GameServer replicas in this fleet.
+Reserved instances won&rsquo;t be deleted on scale down, but won&rsquo;t cause an autoscaler to scale up.</p>
 </td>
 </tr>
-</tbody>
-</table>
-<h3 id="autoscaling.agones.dev/v1.FixedIntervalSync">FixedIntervalSync
-</h3>
-<p>
-(<em>Appears on:</em>
-<a href="#autoscaling.agones.dev/v1.FleetAutoscalerSync">FleetAutoscalerSync</a>)
-</p>
-<p>
-<p>FixedIntervalSync controls the desired behavior of the fixed interval based sync.</p>
-</p>
-<table>
-<thead>
 <tr>
-<th>Field</th>
-<th>Description</th>
+<td>
+<code>allocatedReplicas</code></br>
+<em>
+int32
+</em>
+</td>
+<td>
+<p>AllocatedReplicas are the number of Allocated GameServer replicas</p>
+</td>
 </tr>
-</thead>
-<tbody>
 <tr>
 <td>
-<code>seconds</code></br>
+<code>players</code></br>
 <em>
-int32
+<a href="#agones.dev/v1.AggregatedPlayerStatus">
+AggregatedPlayerStatus
+</a>
 </em>
 </td>
 <td>
-<p>Seconds defines how often we run fleet autoscaling in seconds</p>
+<em>(Optional)</em>
+<p>[Stage:Alpha]
+[FeatureFlag:PlayerTracking]
+Players are the current total player capacity and count for this Fleet</p>
 </td>
 </tr>
 </tbody>
 </table>
-<h3 id="autoscaling.agones.dev/v1.FleetAutoscaleRequest">FleetAutoscaleRequest
+<h3 id="agones.dev/v1.GameServerPort">GameServerPort
 </h3>
 <p>
 (<em>Appears on:</em>
-<a href="#autoscaling.agones.dev/v1.FleetAutoscaleReview">FleetAutoscaleReview</a>)
+<a href="#agones.dev/v1.GameServerSpec">GameServerSpec</a>)
 </p>
 <p>
-<p>FleetAutoscaleRequest defines the request to webhook autoscaler endpoint</p>
+<p>GameServerPort defines a set of Ports that
+are to be exposed via the GameServer</p>
 </p>
 <table>
 <thead>
@@ -2661,63 +2668,89 @@ <h3 id="autoscaling.agones.dev/v1.FleetAutoscaleRequest">FleetAutoscaleRequest
 <tbody>
 <tr>
 <td>
-<code>uid</code></br>
+<code>name</code></br>
 <em>
-k8s.io/apimachinery/pkg/types.UID
+string
 </em>
 </td>
 <td>
-<p>UID is an identifier for the individual request/response. It allows us to distinguish instances of requests which are
-otherwise identical (parallel requests, requests when earlier requests did not modify etc)
-The UID is meant to track the round trip (request/response) between the Autoscaler and the WebHook, not the user request.
-It is suitable for correlating log entries between the webhook and apiserver, for either auditing or debugging.</p>
+<p>Name is the descriptive name of the port</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>name</code></br>
+<code>portPolicy</code></br>
 <em>
-string
+<a href="#agones.dev/v1.PortPolicy">
+PortPolicy
+</a>
 </em>
 </td>
 <td>
-<p>Name is the name of the Fleet being scaled</p>
+<p>PortPolicy defines the policy for how the HostPort is populated.
+Dynamic port will allocate a HostPort within the selected MIN_PORT and MAX_PORT range passed to the controller
+at installation time.
+When <code>Static</code> portPolicy is specified, <code>HostPort</code> is required, to specify the port that game clients will
+connect to</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>namespace</code></br>
+<code>container</code></br>
 <em>
 string
 </em>
 </td>
 <td>
-<p>Namespace is the namespace associated with the request (if any).</p>
+<em>(Optional)</em>
+<p>Container is the name of the container on which to open the port. Defaults to the game server container.</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>status</code></br>
+<code>containerPort</code></br>
 <em>
-<a href="#agones.dev/v1.FleetStatus">
-FleetStatus
+int32
+</em>
+</td>
+<td>
+<p>ContainerPort is the port that is being opened on the specified container&rsquo;s process</p>
+</td>
+</tr>
+<tr>
+<td>
+<code>hostPort</code></br>
+<em>
+int32
+</em>
+</td>
+<td>
+<p>HostPort the port exposed on the host for clients to connect to</p>
+</td>
+</tr>
+<tr>
+<td>
+<code>protocol</code></br>
+<em>
+<a href="https://v1-25.docs.kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#protocol-v1-core">
+Kubernetes core/v1.Protocol
 </a>
 </em>
 </td>
 <td>
-<p>The Fleet&rsquo;s status values</p>
+<p>Protocol is the network protocol being used. Defaults to UDP. TCP and TCPUDP are other options.</p>
 </td>
 </tr>
 </tbody>
 </table>
-<h3 id="autoscaling.agones.dev/v1.FleetAutoscaleResponse">FleetAutoscaleResponse
+<h3 id="agones.dev/v1.GameServerSetSpec">GameServerSetSpec
 </h3>
 <p>
 (<em>Appears on:</em>
-<a href="#autoscaling.agones.dev/v1.FleetAutoscaleReview">FleetAutoscaleReview</a>)
+<a href="#agones.dev/v1.GameServerSet">GameServerSet</a>)
 </p>
 <p>
-<p>FleetAutoscaleResponse defines the response of webhook autoscaler endpoint</p>
+<p>GameServerSetSpec the specification for GameServerSet</p>
 </p>
 <table>
 <thead>
@@ -2729,45 +2762,66 @@ <h3 id="autoscaling.agones.dev/v1.FleetAutoscaleResponse">FleetAutoscaleResponse
 <tbody>
 <tr>
 <td>
-<code>uid</code></br>
+<code>replicas</code></br>
 <em>
-k8s.io/apimachinery/pkg/types.UID
+int32
 </em>
 </td>
 <td>
-<p>UID is an identifier for the individual request/response.
-This should be copied over from the corresponding FleetAutoscaleRequest.</p>
+<p>Replicas are the number of GameServers that should be in this set</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>scale</code></br>
+<code>allocationOverflow</code></br>
 <em>
-bool
+<a href="#agones.dev/v1.AllocationOverflow">
+AllocationOverflow
+</a>
 </em>
 </td>
 <td>
-<p>Set to false if no scaling should occur to the Fleet</p>
+<em>(Optional)</em>
+<p>[Stage: Alpha]
+[FeatureFlag:FleetAllocationOverflow]
+Labels and Annotations to apply to GameServers when the number of Allocated GameServers drops below
+the desired replicas on the underlying <code>GameServerSet</code></p>
 </td>
 </tr>
 <tr>
 <td>
-<code>replicas</code></br>
+<code>scheduling</code></br>
 <em>
-int32
+agones.dev/agones/pkg/apis.SchedulingStrategy
 </em>
 </td>
 <td>
-<p>The targeted replica count</p>
+<p>Scheduling strategy. Defaults to &ldquo;Packed&rdquo;.</p>
+</td>
+</tr>
+<tr>
+<td>
+<code>template</code></br>
+<em>
+<a href="#agones.dev/v1.GameServerTemplateSpec">
+GameServerTemplateSpec
+</a>
+</em>
+</td>
+<td>
+<p>Template the GameServer template to apply for this GameServerSet</p>
 </td>
 </tr>
 </tbody>
 </table>
-<h3 id="autoscaling.agones.dev/v1.FleetAutoscaleReview">FleetAutoscaleReview
+<h3 id="agones.dev/v1.GameServerSetStatus">GameServerSetStatus
 </h3>
 <p>
-<p>FleetAutoscaleReview is passed to the webhook with a populated Request value,
-and then returned with a populated Response.</p>
+(<em>Appears on:</em>
+<a href="#agones.dev/v1.GameServerSet">GameServerSet</a>)
+</p>
+<p>
+<p>GameServerSetStatus is the status of a GameServerSet</p>
 </p>
 <table>
 <thead>
@@ -2779,108 +2833,86 @@ <h3 id="autoscaling.agones.dev/v1.FleetAutoscaleReview">FleetAutoscaleReview
 <tbody>
 <tr>
 <td>
-<code>request</code></br>
+<code>replicas</code></br>
 <em>
-<a href="#autoscaling.agones.dev/v1.FleetAutoscaleRequest">
-FleetAutoscaleRequest
-</a>
+int32
 </em>
 </td>
 <td>
+<p>Replicas is the total number of current GameServer replicas</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>response</code></br>
+<code>readyReplicas</code></br>
 <em>
-<a href="#autoscaling.agones.dev/v1.FleetAutoscaleResponse">
-FleetAutoscaleResponse
-</a>
+int32
 </em>
 </td>
 <td>
+<p>ReadyReplicas is the number of Ready GameServer replicas</p>
 </td>
 </tr>
-</tbody>
-</table>
-<h3 id="autoscaling.agones.dev/v1.FleetAutoscalerPolicy">FleetAutoscalerPolicy
-</h3>
-<p>
-(<em>Appears on:</em>
-<a href="#autoscaling.agones.dev/v1.FleetAutoscalerSpec">FleetAutoscalerSpec</a>)
-</p>
-<p>
-<p>FleetAutoscalerPolicy describes how to scale a fleet</p>
-</p>
-<table>
-<thead>
 <tr>
-<th>Field</th>
-<th>Description</th>
+<td>
+<code>reservedReplicas</code></br>
+<em>
+int32
+</em>
+</td>
+<td>
+<p>ReservedReplicas is the number of Reserved GameServer replicas</p>
+</td>
 </tr>
-</thead>
-<tbody>
 <tr>
 <td>
-<code>type</code></br>
+<code>allocatedReplicas</code></br>
 <em>
-<a href="#autoscaling.agones.dev/v1.FleetAutoscalerPolicyType">
-FleetAutoscalerPolicyType
-</a>
+int32
 </em>
 </td>
 <td>
-<p>Type of autoscaling policy.</p>
+<p>AllocatedReplicas is the number of Allocated GameServer replicas</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>buffer</code></br>
+<code>shutdownReplicas</code></br>
 <em>
-<a href="#autoscaling.agones.dev/v1.BufferPolicy">
-BufferPolicy
-</a>
+int32
 </em>
 </td>
 <td>
-<em>(Optional)</em>
-<p>Buffer policy config params. Present only if FleetAutoscalerPolicyType = Buffer.</p>
+<p>ShutdownReplicas is the number of Shutdown GameServers replicas</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>webhook</code></br>
+<code>players</code></br>
 <em>
-<a href="#autoscaling.agones.dev/v1.WebhookPolicy">
-WebhookPolicy
+<a href="#agones.dev/v1.AggregatedPlayerStatus">
+AggregatedPlayerStatus
 </a>
 </em>
 </td>
 <td>
 <em>(Optional)</em>
-<p>Webhook policy config params. Present only if FleetAutoscalerPolicyType = Webhook.</p>
+<p>[Stage:Alpha]
+[FeatureFlag:PlayerTracking]
+Players is the current total player capacity and count for this GameServerSet</p>
 </td>
 </tr>
 </tbody>
 </table>
-<h3 id="autoscaling.agones.dev/v1.FleetAutoscalerPolicyType">FleetAutoscalerPolicyType
-(<code>string</code> alias)</p></h3>
-<p>
-(<em>Appears on:</em>
-<a href="#autoscaling.agones.dev/v1.FleetAutoscalerPolicy">FleetAutoscalerPolicy</a>)
-</p>
-<p>
-<p>FleetAutoscalerPolicyType is the policy for autoscaling
-for a given Fleet</p>
-</p>
-<h3 id="autoscaling.agones.dev/v1.FleetAutoscalerSpec">FleetAutoscalerSpec
+<h3 id="agones.dev/v1.GameServerSpec">GameServerSpec
 </h3>
 <p>
 (<em>Appears on:</em>
-<a href="#autoscaling.agones.dev/v1.FleetAutoscaler">FleetAutoscaler</a>)
+<a href="#agones.dev/v1.GameServer">GameServer</a>, 
+<a href="#agones.dev/v1.GameServerTemplateSpec">GameServerTemplateSpec</a>)
 </p>
 <p>
-<p>FleetAutoscalerSpec is the spec for a Fleet Scaler</p>
+<p>GameServerSpec is the spec for a GameServer resource</p>
 </p>
 <table>
 <thead>
@@ -2892,53 +2924,153 @@ <h3 id="autoscaling.agones.dev/v1.FleetAutoscalerSpec">FleetAutoscalerSpec
 <tbody>
 <tr>
 <td>
-<code>fleetName</code></br>
+<code>container</code></br>
 <em>
 string
 </em>
 </td>
 <td>
+<p>Container specifies which Pod container is the game server. Only required if there is more than one
+container defined</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>policy</code></br>
+<code>ports</code></br>
 <em>
-<a href="#autoscaling.agones.dev/v1.FleetAutoscalerPolicy">
-FleetAutoscalerPolicy
+<a href="#agones.dev/v1.GameServerPort">
+[]GameServerPort
 </a>
 </em>
 </td>
 <td>
-<p>Autoscaling policy</p>
+<p>Ports are the array of ports that can be exposed via the game server</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>sync</code></br>
+<code>health</code></br>
 <em>
-<a href="#autoscaling.agones.dev/v1.FleetAutoscalerSync">
-FleetAutoscalerSync
+<a href="#agones.dev/v1.Health">
+Health
+</a>
+</em>
+</td>
+<td>
+<p>Health configures health checking</p>
+</td>
+</tr>
+<tr>
+<td>
+<code>scheduling</code></br>
+<em>
+agones.dev/agones/pkg/apis.SchedulingStrategy
+</em>
+</td>
+<td>
+<p>Scheduling strategy. Defaults to &ldquo;Packed&rdquo;</p>
+</td>
+</tr>
+<tr>
+<td>
+<code>sdkServer</code></br>
+<em>
+<a href="#agones.dev/v1.SdkServer">
+SdkServer
+</a>
+</em>
+</td>
+<td>
+<p>SdkServer specifies parameters for the Agones SDK Server sidecar container</p>
+</td>
+</tr>
+<tr>
+<td>
+<code>template</code></br>
+<em>
+<a href="https://v1-25.docs.kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#podtemplatespec-v1-core">
+Kubernetes core/v1.PodTemplateSpec
+</a>
+</em>
+</td>
+<td>
+<p>Template describes the Pod that will be created for the GameServer</p>
+</td>
+</tr>
+<tr>
+<td>
+<code>players</code></br>
+<em>
+<a href="#agones.dev/v1.PlayersSpec">
+PlayersSpec
 </a>
 </em>
 </td>
 <td>
 <em>(Optional)</em>
-<p>[Stage:Beta]
-[FeatureFlag:CustomFasSyncInterval]
-Sync defines when FleetAutoscalers runs autoscaling</p>
+<p>(Alpha, PlayerTracking feature flag) Players provides the configuration for player tracking features.</p>
+</td>
+</tr>
+<tr>
+<td>
+<code>counters</code></br>
+<em>
+<a href="#agones.dev/v1.CounterStatus">
+map[string]agones.dev/agones/pkg/apis/agones/v1.CounterStatus
+</a>
+</em>
+</td>
+<td>
+<em>(Optional)</em>
+<p>(Alpha, CountsAndLists feature flag) Counters and Lists provides the configuration for generic tracking features.</p>
+</td>
+</tr>
+<tr>
+<td>
+<code>lists</code></br>
+<em>
+<a href="#agones.dev/v1.ListStatus">
+map[string]agones.dev/agones/pkg/apis/agones/v1.ListStatus
+</a>
+</em>
+</td>
+<td>
+</td>
+</tr>
+<tr>
+<td>
+<code>eviction</code></br>
+<em>
+<a href="#agones.dev/v1.Eviction">
+Eviction
+</a>
+</em>
+</td>
+<td>
+<em>(Optional)</em>
+<p>(Alpha, SafeToEvict feature flag) Eviction specifies the eviction tolerance of the GameServer. Defaults to &ldquo;Never&rdquo;.</p>
 </td>
 </tr>
 </tbody>
 </table>
-<h3 id="autoscaling.agones.dev/v1.FleetAutoscalerStatus">FleetAutoscalerStatus
+<h3 id="agones.dev/v1.GameServerState">GameServerState
+(<code>string</code> alias)</p></h3>
+<p>
+(<em>Appears on:</em>
+<a href="#allocation.agones.dev/v1.GameServerSelector">GameServerSelector</a>, 
+<a href="#agones.dev/v1.GameServerStatus">GameServerStatus</a>)
+</p>
+<p>
+<p>GameServerState is the state for the GameServer</p>
+</p>
+<h3 id="agones.dev/v1.GameServerStatus">GameServerStatus
 </h3>
 <p>
 (<em>Appears on:</em>
-<a href="#autoscaling.agones.dev/v1.FleetAutoscaler">FleetAutoscaler</a>)
+<a href="#agones.dev/v1.GameServer">GameServer</a>)
 </p>
 <p>
-<p>FleetAutoscalerStatus defines the current status of a FleetAutoscaler</p>
+<p>GameServerStatus is the status for a GameServer resource</p>
 </p>
 <table>
 <thead>
@@ -2950,75 +3082,129 @@ <h3 id="autoscaling.agones.dev/v1.FleetAutoscalerStatus">FleetAutoscalerStatus
 <tbody>
 <tr>
 <td>
-<code>currentReplicas</code></br>
+<code>state</code></br>
 <em>
-int32
+<a href="#agones.dev/v1.GameServerState">
+GameServerState
+</a>
 </em>
 </td>
 <td>
-<p>CurrentReplicas is the current number of gameserver replicas
-of the fleet managed by this autoscaler, as last seen by the autoscaler</p>
+<p>GameServerState is the current state of a GameServer, e.g. Creating, Starting, Ready, etc</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>desiredReplicas</code></br>
+<code>ports</code></br>
 <em>
-int32
+<a href="#agones.dev/v1.GameServerStatusPort">
+[]GameServerStatusPort
+</a>
 </em>
 </td>
 <td>
-<p>DesiredReplicas is the desired number of gameserver replicas
-of the fleet managed by this autoscaler, as last calculated by the autoscaler</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>lastScaleTime</code></br>
+<code>address</code></br>
+<em>
+string
+</em>
+</td>
+<td>
+</td>
+</tr>
+<tr>
+<td>
+<code>nodeName</code></br>
+<em>
+string
+</em>
+</td>
+<td>
+</td>
+</tr>
+<tr>
+<td>
+<code>reservedUntil</code></br>
 <em>
-<a href="https://v1-24.docs.kubernetes.io/docs/reference/generated/kubernetes-api/v1.24/#time-v1-meta">
+<a href="https://v1-25.docs.kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#time-v1-meta">
 Kubernetes meta/v1.Time
 </a>
 </em>
 </td>
 <td>
+</td>
+</tr>
+<tr>
+<td>
+<code>players</code></br>
+<em>
+<a href="#agones.dev/v1.PlayerStatus">
+PlayerStatus
+</a>
+</em>
+</td>
+<td>
 <em>(Optional)</em>
-<p>lastScaleTime is the last time the FleetAutoscaler scaled the attached fleet,</p>
+<p>[Stage:Alpha]
+[FeatureFlag:PlayerTracking]</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>ableToScale</code></br>
+<code>counters</code></br>
 <em>
-bool
+<a href="#agones.dev/v1.CounterStatus">
+map[string]agones.dev/agones/pkg/apis/agones/v1.CounterStatus
+</a>
 </em>
 </td>
 <td>
-<p>AbleToScale indicates that we can access the target fleet</p>
+<em>(Optional)</em>
+<p>(Alpha, CountsAndLists feature flag) Counters and Lists provides the configuration for generic tracking features.</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>scalingLimited</code></br>
+<code>lists</code></br>
 <em>
-bool
+<a href="#agones.dev/v1.ListStatus">
+map[string]agones.dev/agones/pkg/apis/agones/v1.ListStatus
+</a>
 </em>
 </td>
 <td>
-<p>ScalingLimited indicates that the calculated scale would be above or below the range
-defined by MinReplicas and MaxReplicas, and has thus been capped.</p>
+<em>(Optional)</em>
+</td>
+</tr>
+<tr>
+<td>
+<code>eviction</code></br>
+<em>
+<a href="#agones.dev/v1.Eviction">
+Eviction
+</a>
+</em>
+</td>
+<td>
+<em>(Optional)</em>
+<p>(Alpha, SafeToEvict feature flag) Eviction specifies the eviction tolerance of the GameServer.</p>
 </td>
 </tr>
 </tbody>
 </table>
-<h3 id="autoscaling.agones.dev/v1.FleetAutoscalerSync">FleetAutoscalerSync
+<h3 id="agones.dev/v1.GameServerStatusPort">GameServerStatusPort
 </h3>
 <p>
 (<em>Appears on:</em>
-<a href="#autoscaling.agones.dev/v1.FleetAutoscalerSpec">FleetAutoscalerSpec</a>)
+<a href="#allocation.agones.dev/v1.GameServerAllocationStatus">GameServerAllocationStatus</a>, 
+<a href="#agones.dev/v1.GameServerStatus">GameServerStatus</a>)
 </p>
 <p>
-<p>FleetAutoscalerSync describes when to sync a fleet</p>
+<p>GameServerStatusPort shows the port that was allocated to a
+GameServer.</p>
 </p>
 <table>
 <thead>
@@ -3030,52 +3216,35 @@ <h3 id="autoscaling.agones.dev/v1.FleetAutoscalerSync">FleetAutoscalerSync
 <tbody>
 <tr>
 <td>
-<code>type</code></br>
+<code>name</code></br>
 <em>
-<a href="#autoscaling.agones.dev/v1.FleetAutoscalerSyncType">
-FleetAutoscalerSyncType
-</a>
+string
 </em>
 </td>
 <td>
-<p>Type of autoscaling sync.</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>fixedInterval</code></br>
+<code>port</code></br>
 <em>
-<a href="#autoscaling.agones.dev/v1.FixedIntervalSync">
-FixedIntervalSync
-</a>
+int32
 </em>
 </td>
 <td>
-<em>(Optional)</em>
-<p>FixedInterval config params. Present only if FleetAutoscalerSyncType = FixedInterval.</p>
 </td>
 </tr>
 </tbody>
 </table>
-<h3 id="autoscaling.agones.dev/v1.FleetAutoscalerSyncType">FleetAutoscalerSyncType
-(<code>string</code> alias)</p></h3>
-<p>
-(<em>Appears on:</em>
-<a href="#autoscaling.agones.dev/v1.FleetAutoscalerSync">FleetAutoscalerSync</a>)
-</p>
-<p>
-<p>FleetAutoscalerSyncType is the sync strategy for a given Fleet</p>
-</p>
-<h3 id="autoscaling.agones.dev/v1.WebhookPolicy">WebhookPolicy
+<h3 id="agones.dev/v1.GameServerTemplateSpec">GameServerTemplateSpec
 </h3>
 <p>
 (<em>Appears on:</em>
-<a href="#autoscaling.agones.dev/v1.FleetAutoscalerPolicy">FleetAutoscalerPolicy</a>)
+<a href="#agones.dev/v1.FleetSpec">FleetSpec</a>, 
+<a href="#agones.dev/v1.GameServerSetSpec">GameServerSetSpec</a>)
 </p>
 <p>
-<p>WebhookPolicy controls the desired behavior of the webhook policy.
-It contains the description of the webhook autoscaler service
-used to form url which is accessible inside the cluster</p>
+<p>GameServerTemplateSpec is a template for GameServers</p>
 </p>
 <table>
 <thead>
@@ -3087,147 +3256,141 @@ <h3 id="autoscaling.agones.dev/v1.WebhookPolicy">WebhookPolicy
 <tbody>
 <tr>
 <td>
-<code>url</code></br>
+<code>metadata</code></br>
 <em>
-string
+<a href="https://v1-25.docs.kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
+Kubernetes meta/v1.ObjectMeta
+</a>
 </em>
 </td>
 <td>
-<em>(Optional)</em>
-<p><code>url</code> gives the location of the webhook, in standard URL form
-(<code>scheme://host:port/path</code>). Exactly one of <code>url</code> or <code>service</code>
-must be specified.</p>
-<p>The <code>host</code> should not refer to a service running in the cluster; use
-the <code>service</code> field instead. The host might be resolved via external
-DNS in some apiservers (e.g., <code>kube-apiserver</code> cannot resolve
-in-cluster DNS as that would be a layering violation). <code>host</code> may
-also be an IP address.</p>
-<p>Please note that using <code>localhost</code> or <code>127.0.0.1</code> as a <code>host</code> is
-risky unless you take great care to run this webhook on all hosts
-which run an apiserver which might need to make calls to this
-webhook. Such installs are likely to be non-portable, i.e., not easy
-to turn up in a new cluster.</p>
-<p>The scheme must be &ldquo;https&rdquo;; the URL must begin with &ldquo;https://&rdquo;.</p>
-<p>A path is optional, and if present may be any string permissible in
-a URL. You may use the path to pass an arbitrary string to the
-webhook, for example, a cluster identifier.</p>
-<p>Attempting to use a user or basic auth e.g. &ldquo;user:password@&rdquo; is not
-allowed. Fragments (&ldquo;#&hellip;&rdquo;) and query parameters (&ldquo;?&hellip;&rdquo;) are not
-allowed, either.</p>
+Refer to the Kubernetes API documentation for the fields of the
+<code>metadata</code> field.
 </td>
 </tr>
 <tr>
 <td>
-<code>service</code></br>
+<code>spec</code></br>
 <em>
-<a href="https://v1-24.docs.kubernetes.io/docs/reference/generated/kubernetes-api/v1.24/#servicereference-v1-admissionregistration">
-Kubernetes admissionregistration/v1.ServiceReference
+<a href="#agones.dev/v1.GameServerSpec">
+GameServerSpec
 </a>
 </em>
 </td>
 <td>
-<em>(Optional)</em>
-<p><code>service</code> is a reference to the service for this webhook. Either
-<code>service</code> or <code>url</code> must be specified.</p>
-<p>If the webhook is running within the cluster, then you should use <code>service</code>.</p>
+<br/>
+<br/>
+<table>
+<tr>
+<td>
+<code>container</code></br>
+<em>
+string
+</em>
+</td>
+<td>
+<p>Container specifies which Pod container is the game server. Only required if there is more than one
+container defined</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>caBundle</code></br>
+<code>ports</code></br>
 <em>
-[]byte
+<a href="#agones.dev/v1.GameServerPort">
+[]GameServerPort
+</a>
 </em>
 </td>
 <td>
-<em>(Optional)</em>
-<p><code>caBundle</code> is a PEM encoded CA bundle which will be used to validate the webhook&rsquo;s server certificate.
-If unspecified, system trust roots on the apiserver are used.</p>
+<p>Ports are the array of ports that can be exposed via the game server</p>
 </td>
 </tr>
-</tbody>
-</table>
-<hr/>
-<h2 id="multicluster.agones.dev/v1">multicluster.agones.dev/v1</h2>
-<p>
-<p>Package v1 is the v1 version of the API.</p>
-</p>
-Resource Types:
-<ul><li>
-<a href="#multicluster.agones.dev/v1.GameServerAllocationPolicy">GameServerAllocationPolicy</a>
-</li></ul>
-<h3 id="multicluster.agones.dev/v1.GameServerAllocationPolicy">GameServerAllocationPolicy
-</h3>
-<p>
-<p>GameServerAllocationPolicy is the Schema for the gameserverallocationpolicies API</p>
-</p>
-<table>
-<thead>
 <tr>
-<th>Field</th>
-<th>Description</th>
+<td>
+<code>health</code></br>
+<em>
+<a href="#agones.dev/v1.Health">
+Health
+</a>
+</em>
+</td>
+<td>
+<p>Health configures health checking</p>
+</td>
 </tr>
-</thead>
-<tbody>
 <tr>
 <td>
-<code>apiVersion</code></br>
-string</td>
+<code>scheduling</code></br>
+<em>
+agones.dev/agones/pkg/apis.SchedulingStrategy
+</em>
+</td>
 <td>
-<code>
-multicluster.agones.dev/v1
-</code>
+<p>Scheduling strategy. Defaults to &ldquo;Packed&rdquo;</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>kind</code></br>
-string
+<code>sdkServer</code></br>
+<em>
+<a href="#agones.dev/v1.SdkServer">
+SdkServer
+</a>
+</em>
+</td>
+<td>
+<p>SdkServer specifies parameters for the Agones SDK Server sidecar container</p>
 </td>
-<td><code>GameServerAllocationPolicy</code></td>
 </tr>
 <tr>
 <td>
-<code>metadata</code></br>
+<code>template</code></br>
 <em>
-<a href="https://v1-24.docs.kubernetes.io/docs/reference/generated/kubernetes-api/v1.24/#objectmeta-v1-meta">
-Kubernetes meta/v1.ObjectMeta
+<a href="https://v1-25.docs.kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#podtemplatespec-v1-core">
+Kubernetes core/v1.PodTemplateSpec
 </a>
 </em>
 </td>
 <td>
-Refer to the Kubernetes API documentation for the fields of the
-<code>metadata</code> field.
+<p>Template describes the Pod that will be created for the GameServer</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>spec</code></br>
+<code>players</code></br>
 <em>
-<a href="#multicluster.agones.dev/v1.GameServerAllocationPolicySpec">
-GameServerAllocationPolicySpec
+<a href="#agones.dev/v1.PlayersSpec">
+PlayersSpec
 </a>
 </em>
 </td>
 <td>
-<br/>
-<br/>
-<table>
+<em>(Optional)</em>
+<p>(Alpha, PlayerTracking feature flag) Players provides the configuration for player tracking features.</p>
+</td>
+</tr>
 <tr>
 <td>
-<code>priority</code></br>
+<code>counters</code></br>
 <em>
-int32
+<a href="#agones.dev/v1.CounterStatus">
+map[string]agones.dev/agones/pkg/apis/agones/v1.CounterStatus
+</a>
 </em>
 </td>
 <td>
+<em>(Optional)</em>
+<p>(Alpha, CountsAndLists feature flag) Counters and Lists provides the configuration for generic tracking features.</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>weight</code></br>
+<code>lists</code></br>
 <em>
-int
+<a href="#agones.dev/v1.ListStatus">
+map[string]agones.dev/agones/pkg/apis/agones/v1.ListStatus
+</a>
 </em>
 </td>
 <td>
@@ -3235,14 +3398,16 @@ <h3 id="multicluster.agones.dev/v1.GameServerAllocationPolicy">GameServerAllocat
 </tr>
 <tr>
 <td>
-<code>connectionInfo</code></br>
+<code>eviction</code></br>
 <em>
-<a href="#multicluster.agones.dev/v1.ClusterConnectionInfo">
-ClusterConnectionInfo
+<a href="#agones.dev/v1.Eviction">
+Eviction
 </a>
 </em>
 </td>
 <td>
+<em>(Optional)</em>
+<p>(Alpha, SafeToEvict feature flag) Eviction specifies the eviction tolerance of the GameServer. Defaults to &ldquo;Never&rdquo;.</p>
 </td>
 </tr>
 </table>
@@ -3250,14 +3415,14 @@ <h3 id="multicluster.agones.dev/v1.GameServerAllocationPolicy">GameServerAllocat
 </tr>
 </tbody>
 </table>
-<h3 id="multicluster.agones.dev/v1.ClusterConnectionInfo">ClusterConnectionInfo
+<h3 id="agones.dev/v1.Health">Health
 </h3>
 <p>
 (<em>Appears on:</em>
-<a href="#multicluster.agones.dev/v1.GameServerAllocationPolicySpec">GameServerAllocationPolicySpec</a>)
+<a href="#agones.dev/v1.GameServerSpec">GameServerSpec</a>)
 </p>
 <p>
-<p>ClusterConnectionInfo defines the connection information for a cluster</p>
+<p>Health configures health checking on the GameServer</p>
 </p>
 <table>
 <thead>
@@ -3269,67 +3434,98 @@ <h3 id="multicluster.agones.dev/v1.ClusterConnectionInfo">ClusterConnectionInfo
 <tbody>
 <tr>
 <td>
-<code>clusterName</code></br>
+<code>disabled</code></br>
 <em>
-string
+bool
 </em>
 </td>
 <td>
-<p>Optional: the name of the targeted cluster</p>
+<p>Disabled is whether health checking is disabled or not</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>allocationEndpoints</code></br>
+<code>periodSeconds</code></br>
 <em>
-[]string
+int32
 </em>
 </td>
 <td>
-<p>The endpoints for the allocator service in the targeted cluster.
-If the AllocationEndpoints is not set, the allocation happens on local cluster.
-If there are multiple endpoints any of the endpoints that can handle allocation request should suffice</p>
+<p>PeriodSeconds is the number of seconds each health ping has to occur in</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>secretName</code></br>
+<code>failureThreshold</code></br>
 <em>
-string
+int32
 </em>
 </td>
 <td>
-<p>The name of the secret that contains TLS client certificates to connect the allocator server in the targeted cluster</p>
+<p>FailureThreshold how many failures in a row constitutes unhealthy</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>namespace</code></br>
+<code>initialDelaySeconds</code></br>
 <em>
-string
+int32
+</em>
+</td>
+<td>
+<p>InitialDelaySeconds initial delay before checking health</p>
+</td>
+</tr>
+</tbody>
+</table>
+<h3 id="agones.dev/v1.ListStatus">ListStatus
+</h3>
+<p>
+(<em>Appears on:</em>
+<a href="#agones.dev/v1.GameServerSpec">GameServerSpec</a>, 
+<a href="#agones.dev/v1.GameServerStatus">GameServerStatus</a>)
+</p>
+<p>
+<p>ListStatus stores the current list values</p>
+</p>
+<table>
+<thead>
+<tr>
+<th>Field</th>
+<th>Description</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td>
+<code>capacity</code></br>
+<em>
+int64
 </em>
 </td>
 <td>
-<p>The cluster namespace from which to allocate gameservers</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>serverCa</code></br>
+<code>values</code></br>
 <em>
-[]byte
+[]string
 </em>
 </td>
 <td>
-<p>The PEM encoded server CA, used by the allocator client to authenticate the remote server.</p>
 </td>
 </tr>
 </tbody>
 </table>
-<h3 id="multicluster.agones.dev/v1.ConnectionInfoIterator">ConnectionInfoIterator
+<h3 id="agones.dev/v1.PlayerStatus">PlayerStatus
 </h3>
 <p>
-<p>ConnectionInfoIterator an iterator on ClusterConnectionInfo</p>
+(<em>Appears on:</em>
+<a href="#agones.dev/v1.GameServerStatus">GameServerStatus</a>)
+</p>
+<p>
+<p>PlayerStatus stores the current player capacity values</p>
 </p>
 <table>
 <thead>
@@ -3341,58 +3537,82 @@ <h3 id="multicluster.agones.dev/v1.ConnectionInfoIterator">ConnectionInfoIterato
 <tbody>
 <tr>
 <td>
-<code>currPriority</code></br>
+<code>count</code></br>
 <em>
-int
+int64
 </em>
 </td>
 <td>
-<p>currPriority Current priority index from the orderedPriorities</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>orderedPriorities</code></br>
+<code>capacity</code></br>
 <em>
-[]int32
+int64
 </em>
 </td>
 <td>
-<p>orderedPriorities list of ordered priorities</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>priorityToCluster</code></br>
+<code>ids</code></br>
 <em>
-map[int32]map[string][]*agones.dev/agones/pkg/apis/multicluster/v1.GameServerAllocationPolicy
+[]string
 </em>
 </td>
 <td>
-<p>priorityToCluster Map of priority to cluster-policies map</p>
 </td>
 </tr>
+</tbody>
+</table>
+<h3 id="agones.dev/v1.PlayersSpec">PlayersSpec
+</h3>
+<p>
+(<em>Appears on:</em>
+<a href="#agones.dev/v1.GameServerSpec">GameServerSpec</a>)
+</p>
+<p>
+<p>PlayersSpec tracks the initial player capacity</p>
+</p>
+<table>
+<thead>
+<tr>
+<th>Field</th>
+<th>Description</th>
+</tr>
+</thead>
+<tbody>
 <tr>
 <td>
-<code>clusterBlackList</code></br>
+<code>initialCapacity</code></br>
 <em>
-map[string]bool
+int64
 </em>
 </td>
 <td>
-<p>clusterBlackList the cluster blacklist for the clusters that has already returned</p>
 </td>
 </tr>
 </tbody>
 </table>
-<h3 id="multicluster.agones.dev/v1.GameServerAllocationPolicySpec">GameServerAllocationPolicySpec
+<h3 id="agones.dev/v1.PortPolicy">PortPolicy
+(<code>string</code> alias)</p></h3>
+<p>
+(<em>Appears on:</em>
+<a href="#agones.dev/v1.GameServerPort">GameServerPort</a>)
+</p>
+<p>
+<p>PortPolicy is the port policy for the GameServer</p>
+</p>
+<h3 id="agones.dev/v1.SdkServer">SdkServer
 </h3>
 <p>
 (<em>Appears on:</em>
-<a href="#multicluster.agones.dev/v1.GameServerAllocationPolicy">GameServerAllocationPolicy</a>)
+<a href="#agones.dev/v1.GameServerSpec">GameServerSpec</a>)
 </p>
 <p>
-<p>GameServerAllocationPolicySpec defines the desired state of GameServerAllocationPolicy</p>
+<p>SdkServer specifies parameters for the Agones SDK Server sidecar container</p>
 </p>
 <table>
 <thead>
@@ -3404,47 +3624,62 @@ <h3 id="multicluster.agones.dev/v1.GameServerAllocationPolicySpec">GameServerAll
 <tbody>
 <tr>
 <td>
-<code>priority</code></br>
+<code>logLevel</code></br>
 <em>
-int32
+<a href="#agones.dev/v1.SdkServerLogLevel">
+SdkServerLogLevel
+</a>
 </em>
 </td>
 <td>
+<p>LogLevel for SDK server (sidecar) logs. Defaults to &ldquo;Info&rdquo;</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>weight</code></br>
+<code>grpcPort</code></br>
 <em>
-int
+int32
 </em>
 </td>
 <td>
+<p>GRPCPort is the port on which the SDK Server binds the gRPC server to accept incoming connections</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>connectionInfo</code></br>
+<code>httpPort</code></br>
 <em>
-<a href="#multicluster.agones.dev/v1.ClusterConnectionInfo">
-ClusterConnectionInfo
-</a>
+int32
 </em>
 </td>
 <td>
+<p>HTTPPort is the port on which the SDK Server binds the HTTP gRPC gateway server to accept incoming connections</p>
 </td>
 </tr>
 </tbody>
 </table>
+<h3 id="agones.dev/v1.SdkServerLogLevel">SdkServerLogLevel
+(<code>string</code> alias)</p></h3>
+<p>
+(<em>Appears on:</em>
+<a href="#agones.dev/v1.SdkServer">SdkServer</a>)
+</p>
+<p>
+<p>SdkServerLogLevel is the log level for SDK server (sidecar) logs</p>
+</p>
 <hr/>
 <p><em>
 Generated with <code>gen-crd-api-reference-docs</code>.
 </em></p>
 {{% /feature %}}
-{{% feature publishVersion="1.31.0" %}}
+{{% feature publishVersion="1.32.0" %}}
 <p>Packages:</p>
 <ul>
 <li>
+<a href="#agones.dev%2fv1">agones.dev/v1</a>
+</li>
+<li>
 <a href="#allocation.agones.dev%2fv1">allocation.agones.dev/v1</a>
 </li>
 <li>
@@ -3453,23 +3688,23 @@ <h3 id="multicluster.agones.dev/v1.GameServerAllocationPolicySpec">GameServerAll
 <li>
 <a href="#multicluster.agones.dev%2fv1">multicluster.agones.dev/v1</a>
 </li>
-<li>
-<a href="#agones.dev%2fv1">agones.dev/v1</a>
-</li>
 </ul>
-<h2 id="allocation.agones.dev/v1">allocation.agones.dev/v1</h2>
+<h2 id="agones.dev/v1">agones.dev/v1</h2>
 <p>
 <p>Package v1 is the v1 version of the API.</p>
 </p>
 Resource Types:
 <ul><li>
-<a href="#allocation.agones.dev/v1.GameServerAllocation">GameServerAllocation</a>
+<a href="#agones.dev/v1.Fleet">Fleet</a>
+</li><li>
+<a href="#agones.dev/v1.GameServer">GameServer</a>
+</li><li>
+<a href="#agones.dev/v1.GameServerSet">GameServerSet</a>
 </li></ul>
-<h3 id="allocation.agones.dev/v1.GameServerAllocation">GameServerAllocation
+<h3 id="agones.dev/v1.Fleet">Fleet
 </h3>
 <p>
-<p>GameServerAllocation is the data structure for allocating against a set of
-GameServers, defined <code>selectors</code> selectors</p>
+<p>Fleet is the data structure for a Fleet resource</p>
 </p>
 <table>
 <thead>
@@ -3485,7 +3720,7 @@ <h3 id="allocation.agones.dev/v1.GameServerAllocation">GameServerAllocation
 string</td>
 <td>
 <code>
-allocation.agones.dev/v1
+agones.dev/v1
 </code>
 </td>
 </tr>
@@ -3494,7 +3729,7 @@ <h3 id="allocation.agones.dev/v1.GameServerAllocation">GameServerAllocation
 <code>kind</code></br>
 string
 </td>
-<td><code>GameServerAllocation</code></td>
+<td><code>Fleet</code></td>
 </tr>
 <tr>
 <td>
@@ -3514,8 +3749,8 @@ <h3 id="allocation.agones.dev/v1.GameServerAllocation">GameServerAllocation
 <td>
 <code>spec</code></br>
 <em>
-<a href="#allocation.agones.dev/v1.GameServerAllocationSpec">
-GameServerAllocationSpec
+<a href="#agones.dev/v1.FleetSpec">
+FleetSpec
 </a>
 </em>
 </td>
@@ -3525,82 +3760,43 @@ <h3 id="allocation.agones.dev/v1.GameServerAllocation">GameServerAllocation
 <table>
 <tr>
 <td>
-<code>multiClusterSetting</code></br>
-<em>
-<a href="#allocation.agones.dev/v1.MultiClusterSetting">
-MultiClusterSetting
-</a>
-</em>
-</td>
-<td>
-<p>MultiClusterPolicySelector if specified, multi-cluster policies are applied.
-Otherwise, allocation will happen locally.</p>
-</td>
-</tr>
-<tr>
-<td>
-<code>required</code></br>
-<em>
-<a href="#allocation.agones.dev/v1.GameServerSelector">
-GameServerSelector
-</a>
-</em>
-</td>
-<td>
-<p>Deprecated: use field Selectors instead. If Selectors is set, this field is ignored.
-Required is the GameServer selector from which to choose GameServers from.
-Defaults to all GameServers.</p>
-</td>
-</tr>
-<tr>
-<td>
-<code>preferred</code></br>
+<code>replicas</code></br>
 <em>
-<a href="#allocation.agones.dev/v1.GameServerSelector">
-[]GameServerSelector
-</a>
+int32
 </em>
 </td>
 <td>
-<p>Deprecated: use field Selectors instead. If Selectors is set, this field is ignored.
-Preferred is an ordered list of preferred GameServer selectors
-that are optional to be fulfilled, but will be searched before the <code>required</code> selector.
-If the first selector is not matched, the selection attempts the second selector, and so on.
-If any of the preferred selectors are matched, the required selector is not considered.
-This is useful for things like smoke testing of new game servers.</p>
+<p>Replicas are the number of GameServers that should be in this set. Defaults to 0.</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>priorities</code></br>
+<code>allocationOverflow</code></br>
 <em>
-<a href="#allocation.agones.dev/v1.Priority">
-[]Priority
+<a href="#agones.dev/v1.AllocationOverflow">
+AllocationOverflow
 </a>
 </em>
 </td>
 <td>
 <em>(Optional)</em>
-<p>(Alpha, CountsAndLists feature flag) The first Priority on the array of Priorities is the most
-important for sorting. The allocator will use the first priority for sorting GameServers in the
-Selector set, and will only use any following priority for tie-breaking during sort.
-Impacts which GameServer is checked first.</p>
+<p>[Stage: Alpha]
+[FeatureFlag:FleetAllocationOverflow]
+Labels and/or Annotations to apply to GameServers when the number of Allocated GameServers drops below
+the desired replicas on the underlying <code>GameServerSet</code></p>
 </td>
 </tr>
 <tr>
 <td>
-<code>selectors</code></br>
+<code>strategy</code></br>
 <em>
-<a href="#allocation.agones.dev/v1.GameServerSelector">
-[]GameServerSelector
+<a href="https://v1-25.docs.kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#deploymentstrategy-v1-apps">
+Kubernetes apps/v1.DeploymentStrategy
 </a>
 </em>
 </td>
 <td>
-<p>Ordered list of GameServer label selectors.
-If the first selector is not matched, the selection attempts the second selector, and so on.
-This is useful for things like smoke testing of new game servers.
-Note: This field can only be set if neither Required or Preferred is set.</p>
+<p>Deployment strategy</p>
 </td>
 </tr>
 <tr>
@@ -3616,16 +3812,15 @@ <h3 id="allocation.agones.dev/v1.GameServerAllocation">GameServerAllocation
 </tr>
 <tr>
 <td>
-<code>metadata</code></br>
+<code>template</code></br>
 <em>
-<a href="#allocation.agones.dev/v1.MetaPatch">
-MetaPatch
+<a href="#agones.dev/v1.GameServerTemplateSpec">
+GameServerTemplateSpec
 </a>
 </em>
 </td>
 <td>
-<p>MetaPatch is optional custom metadata that is added to the game server at allocation
-You can use this to tell the server necessary session data</p>
+<p>Template the GameServer template to apply for this Fleet</p>
 </td>
 </tr>
 </table>
@@ -3635,8 +3830,8 @@ <h3 id="allocation.agones.dev/v1.GameServerAllocation">GameServerAllocation
 <td>
 <code>status</code></br>
 <em>
-<a href="#allocation.agones.dev/v1.GameServerAllocationStatus">
-GameServerAllocationStatus
+<a href="#agones.dev/v1.FleetStatus">
+FleetStatus
 </a>
 </em>
 </td>
@@ -3645,15 +3840,14 @@ <h3 id="allocation.agones.dev/v1.GameServerAllocation">GameServerAllocation
 </tr>
 </tbody>
 </table>
-<h3 id="allocation.agones.dev/v1.CounterSelector">CounterSelector
+<h3 id="agones.dev/v1.GameServer">GameServer
 </h3>
 <p>
-(<em>Appears on:</em>
-<a href="#allocation.agones.dev/v1.GameServerSelector">GameServerSelector</a>)
-</p>
-<p>
-<p>CounterSelector is the filter options for a GameServer based on the count and/or available capacity.
-0 for MaxCount or MaxAvailable means unlimited maximum. Default for all fields: 0</p>
+<p>GameServer is the data structure for a GameServer resource.
+It is worth noting that while there is a <code>GameServerStatus</code> Status entry for the <code>GameServer</code>, it is not
+defined as a subresource - unlike <code>Fleet</code> and other Agones resources.
+This is so that we can retain the ability to change multiple aspects of a <code>GameServer</code> in a single atomic operation,
+which is particularly useful for operations such as allocation.</p>
 </p>
 <table>
 <thead>
@@ -3665,187 +3859,200 @@ <h3 id="allocation.agones.dev/v1.CounterSelector">CounterSelector
 <tbody>
 <tr>
 <td>
-<code>minCount</code></br>
+<code>apiVersion</code></br>
+string</td>
+<td>
+<code>
+agones.dev/v1
+</code>
+</td>
+</tr>
+<tr>
+<td>
+<code>kind</code></br>
+string
+</td>
+<td><code>GameServer</code></td>
+</tr>
+<tr>
+<td>
+<code>metadata</code></br>
 <em>
-int64
+<a href="https://v1-25.docs.kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
+Kubernetes meta/v1.ObjectMeta
+</a>
 </em>
 </td>
 <td>
+Refer to the Kubernetes API documentation for the fields of the
+<code>metadata</code> field.
 </td>
 </tr>
 <tr>
 <td>
-<code>maxCount</code></br>
+<code>spec</code></br>
 <em>
-int64
+<a href="#agones.dev/v1.GameServerSpec">
+GameServerSpec
+</a>
 </em>
 </td>
 <td>
+<br/>
+<br/>
+<table>
+<tr>
+<td>
+<code>container</code></br>
+<em>
+string
+</em>
+</td>
+<td>
+<p>Container specifies which Pod container is the game server. Only required if there is more than one
+container defined</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>minAvailable</code></br>
+<code>ports</code></br>
 <em>
-int64
+<a href="#agones.dev/v1.GameServerPort">
+[]GameServerPort
+</a>
 </em>
 </td>
 <td>
+<p>Ports are the array of ports that can be exposed via the game server</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>maxAvailable</code></br>
+<code>health</code></br>
 <em>
-int64
+<a href="#agones.dev/v1.Health">
+Health
+</a>
 </em>
 </td>
 <td>
+<p>Health configures health checking</p>
 </td>
 </tr>
-</tbody>
-</table>
-<h3 id="allocation.agones.dev/v1.GameServerAllocationSpec">GameServerAllocationSpec
-</h3>
-<p>
-(<em>Appears on:</em>
-<a href="#allocation.agones.dev/v1.GameServerAllocation">GameServerAllocation</a>)
-</p>
-<p>
-<p>GameServerAllocationSpec is the spec for a GameServerAllocation</p>
-</p>
-<table>
-<thead>
 <tr>
-<th>Field</th>
-<th>Description</th>
+<td>
+<code>scheduling</code></br>
+<em>
+agones.dev/agones/pkg/apis.SchedulingStrategy
+</em>
+</td>
+<td>
+<p>Scheduling strategy. Defaults to &ldquo;Packed&rdquo;</p>
+</td>
 </tr>
-</thead>
-<tbody>
 <tr>
 <td>
-<code>multiClusterSetting</code></br>
+<code>sdkServer</code></br>
 <em>
-<a href="#allocation.agones.dev/v1.MultiClusterSetting">
-MultiClusterSetting
+<a href="#agones.dev/v1.SdkServer">
+SdkServer
 </a>
 </em>
 </td>
 <td>
-<p>MultiClusterPolicySelector if specified, multi-cluster policies are applied.
-Otherwise, allocation will happen locally.</p>
+<p>SdkServer specifies parameters for the Agones SDK Server sidecar container</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>required</code></br>
+<code>template</code></br>
 <em>
-<a href="#allocation.agones.dev/v1.GameServerSelector">
-GameServerSelector
+<a href="https://v1-25.docs.kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#podtemplatespec-v1-core">
+Kubernetes core/v1.PodTemplateSpec
 </a>
 </em>
 </td>
 <td>
-<p>Deprecated: use field Selectors instead. If Selectors is set, this field is ignored.
-Required is the GameServer selector from which to choose GameServers from.
-Defaults to all GameServers.</p>
+<p>Template describes the Pod that will be created for the GameServer</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>preferred</code></br>
+<code>players</code></br>
 <em>
-<a href="#allocation.agones.dev/v1.GameServerSelector">
-[]GameServerSelector
+<a href="#agones.dev/v1.PlayersSpec">
+PlayersSpec
 </a>
 </em>
 </td>
 <td>
-<p>Deprecated: use field Selectors instead. If Selectors is set, this field is ignored.
-Preferred is an ordered list of preferred GameServer selectors
-that are optional to be fulfilled, but will be searched before the <code>required</code> selector.
-If the first selector is not matched, the selection attempts the second selector, and so on.
-If any of the preferred selectors are matched, the required selector is not considered.
-This is useful for things like smoke testing of new game servers.</p>
+<em>(Optional)</em>
+<p>(Alpha, PlayerTracking feature flag) Players provides the configuration for player tracking features.</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>priorities</code></br>
+<code>counters</code></br>
 <em>
-<a href="#allocation.agones.dev/v1.Priority">
-[]Priority
+<a href="#agones.dev/v1.CounterStatus">
+map[string]agones.dev/agones/pkg/apis/agones/v1.CounterStatus
 </a>
 </em>
 </td>
 <td>
 <em>(Optional)</em>
-<p>(Alpha, CountsAndLists feature flag) The first Priority on the array of Priorities is the most
-important for sorting. The allocator will use the first priority for sorting GameServers in the
-Selector set, and will only use any following priority for tie-breaking during sort.
-Impacts which GameServer is checked first.</p>
+<p>(Alpha, CountsAndLists feature flag) Counters and Lists provides the configuration for generic tracking features.</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>selectors</code></br>
+<code>lists</code></br>
 <em>
-<a href="#allocation.agones.dev/v1.GameServerSelector">
-[]GameServerSelector
+<a href="#agones.dev/v1.ListStatus">
+map[string]agones.dev/agones/pkg/apis/agones/v1.ListStatus
 </a>
 </em>
 </td>
 <td>
-<p>Ordered list of GameServer label selectors.
-If the first selector is not matched, the selection attempts the second selector, and so on.
-This is useful for things like smoke testing of new game servers.
-Note: This field can only be set if neither Required or Preferred is set.</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>scheduling</code></br>
+<code>eviction</code></br>
 <em>
-agones.dev/agones/pkg/apis.SchedulingStrategy
+<a href="#agones.dev/v1.Eviction">
+Eviction
+</a>
 </em>
 </td>
 <td>
-<p>Scheduling strategy. Defaults to &ldquo;Packed&rdquo;.</p>
+<em>(Optional)</em>
+<p>(Alpha, SafeToEvict feature flag) Eviction specifies the eviction tolerance of the GameServer. Defaults to &ldquo;Never&rdquo;.</p>
+</td>
+</tr>
+</table>
 </td>
 </tr>
 <tr>
 <td>
-<code>metadata</code></br>
+<code>status</code></br>
 <em>
-<a href="#allocation.agones.dev/v1.MetaPatch">
-MetaPatch
+<a href="#agones.dev/v1.GameServerStatus">
+GameServerStatus
 </a>
 </em>
 </td>
 <td>
-<p>MetaPatch is optional custom metadata that is added to the game server at allocation
-You can use this to tell the server necessary session data</p>
 </td>
 </tr>
 </tbody>
 </table>
-<h3 id="allocation.agones.dev/v1.GameServerAllocationState">GameServerAllocationState
-(<code>string</code> alias)</p></h3>
-<p>
-(<em>Appears on:</em>
-<a href="#allocation.agones.dev/v1.GameServerAllocationStatus">GameServerAllocationStatus</a>)
-</p>
-<p>
-<p>GameServerAllocationState is the Allocation state</p>
-</p>
-<h3 id="allocation.agones.dev/v1.GameServerAllocationStatus">GameServerAllocationStatus
+<h3 id="agones.dev/v1.GameServerSet">GameServerSet
 </h3>
 <p>
-(<em>Appears on:</em>
-<a href="#allocation.agones.dev/v1.GameServerAllocation">GameServerAllocation</a>)
-</p>
-<p>
-<p>GameServerAllocationStatus is the status for an GameServerAllocation resource</p>
+<p>GameServerSet is the data structure for a set of GameServers.
+This matches philosophically with the relationship between
+Deployments and ReplicaSets</p>
 </p>
 <table>
 <thead>
@@ -3853,86 +4060,130 @@ <h3 id="allocation.agones.dev/v1.GameServerAllocationStatus">GameServerAllocatio
 <th>Field</th>
 <th>Description</th>
 </tr>
-</thead>
-<tbody>
+</thead>
+<tbody>
+<tr>
+<td>
+<code>apiVersion</code></br>
+string</td>
+<td>
+<code>
+agones.dev/v1
+</code>
+</td>
+</tr>
+<tr>
+<td>
+<code>kind</code></br>
+string
+</td>
+<td><code>GameServerSet</code></td>
+</tr>
+<tr>
+<td>
+<code>metadata</code></br>
+<em>
+<a href="https://v1-25.docs.kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
+Kubernetes meta/v1.ObjectMeta
+</a>
+</em>
+</td>
+<td>
+Refer to the Kubernetes API documentation for the fields of the
+<code>metadata</code> field.
+</td>
+</tr>
 <tr>
 <td>
-<code>state</code></br>
+<code>spec</code></br>
 <em>
-<a href="#allocation.agones.dev/v1.GameServerAllocationState">
-GameServerAllocationState
+<a href="#agones.dev/v1.GameServerSetSpec">
+GameServerSetSpec
 </a>
 </em>
 </td>
 <td>
-<p>GameServerState is the current state of an GameServerAllocation, e.g. Allocated, or UnAllocated</p>
-</td>
-</tr>
+<br/>
+<br/>
+<table>
 <tr>
 <td>
-<code>gameServerName</code></br>
+<code>replicas</code></br>
 <em>
-string
+int32
 </em>
 </td>
 <td>
+<p>Replicas are the number of GameServers that should be in this set</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>ports</code></br>
+<code>allocationOverflow</code></br>
 <em>
-<a href="#agones.dev/v1.GameServerStatusPort">
-[]GameServerStatusPort
+<a href="#agones.dev/v1.AllocationOverflow">
+AllocationOverflow
 </a>
 </em>
 </td>
 <td>
+<em>(Optional)</em>
+<p>[Stage: Alpha]
+[FeatureFlag:FleetAllocationOverflow]
+Labels and Annotations to apply to GameServers when the number of Allocated GameServers drops below
+the desired replicas on the underlying <code>GameServerSet</code></p>
 </td>
 </tr>
 <tr>
 <td>
-<code>address</code></br>
+<code>scheduling</code></br>
 <em>
-string
+agones.dev/agones/pkg/apis.SchedulingStrategy
 </em>
 </td>
 <td>
+<p>Scheduling strategy. Defaults to &ldquo;Packed&rdquo;.</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>nodeName</code></br>
+<code>template</code></br>
 <em>
-string
+<a href="#agones.dev/v1.GameServerTemplateSpec">
+GameServerTemplateSpec
+</a>
 </em>
 </td>
 <td>
+<p>Template the GameServer template to apply for this GameServerSet</p>
+</td>
+</tr>
+</table>
 </td>
 </tr>
 <tr>
 <td>
-<code>source</code></br>
+<code>status</code></br>
 <em>
-string
+<a href="#agones.dev/v1.GameServerSetStatus">
+GameServerSetStatus
+</a>
 </em>
 </td>
 <td>
-<p>If the allocation is from a remote cluster, Source is the endpoint of the remote agones-allocator.
-Otherwise, Source is &ldquo;local&rdquo;</p>
 </td>
 </tr>
 </tbody>
 </table>
-<h3 id="allocation.agones.dev/v1.GameServerSelector">GameServerSelector
+<h3 id="agones.dev/v1.AggregatedPlayerStatus">AggregatedPlayerStatus
 </h3>
 <p>
 (<em>Appears on:</em>
-<a href="#allocation.agones.dev/v1.GameServerAllocationSpec">GameServerAllocationSpec</a>)
+<a href="#agones.dev/v1.FleetStatus">FleetStatus</a>, 
+<a href="#agones.dev/v1.GameServerSetStatus">GameServerSetStatus</a>)
 </p>
 <p>
-<p>GameServerSelector contains all the filter options for selecting
-a GameServer for allocation.</p>
+<p>AggregatedPlayerStatus stores total player tracking values</p>
 </p>
 <table>
 <thead>
@@ -3944,100 +4195,81 @@ <h3 id="allocation.agones.dev/v1.GameServerSelector">GameServerSelector
 <tbody>
 <tr>
 <td>
-<code>LabelSelector</code></br>
+<code>count</code></br>
 <em>
-<a href="https://v1-25.docs.kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#labelselector-v1-meta">
-Kubernetes meta/v1.LabelSelector
-</a>
+int64
 </em>
 </td>
 <td>
-<p>
-(Members of <code>LabelSelector</code> are embedded into this type.)
-</p>
-<p>See: <a href="https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/">https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/</a></p>
 </td>
 </tr>
 <tr>
 <td>
-<code>gameServerState</code></br>
+<code>capacity</code></br>
 <em>
-<a href="#agones.dev/v1.GameServerState">
-GameServerState
-</a>
+int64
 </em>
 </td>
 <td>
-<em>(Optional)</em>
-<p>[Stage:Beta]
-[FeatureFlag:StateAllocationFilter]
-GameServerState specifies which State is the filter to be used when attempting to retrieve a GameServer
-via Allocation. Defaults to &ldquo;Ready&rdquo;. The only other option is &ldquo;Allocated&rdquo;, which can be used in conjunction with
-label/annotation/player selectors to retrieve an already Allocated GameServer.</p>
 </td>
 </tr>
+</tbody>
+</table>
+<h3 id="agones.dev/v1.AllocationOverflow">AllocationOverflow
+</h3>
+<p>
+(<em>Appears on:</em>
+<a href="#agones.dev/v1.FleetSpec">FleetSpec</a>, 
+<a href="#agones.dev/v1.GameServerSetSpec">GameServerSetSpec</a>)
+</p>
+<p>
+<p>AllocationOverflow specifies what labels and/or annotations to apply on Allocated GameServers
+if the desired number of the underlying <code>GameServerSet</code> drops below the number of Allocated GameServers
+attached to it.</p>
+</p>
+<table>
+<thead>
 <tr>
-<td>
-<code>players</code></br>
-<em>
-<a href="#allocation.agones.dev/v1.PlayerSelector">
-PlayerSelector
-</a>
-</em>
-</td>
-<td>
-<em>(Optional)</em>
-<p>[Stage:Alpha]
-[FeatureFlag:PlayerAllocationFilter]
-Players provides a filter on minimum and maximum values for player capacity when retrieving a GameServer
-through Allocation. Defaults to no limits.</p>
-</td>
+<th>Field</th>
+<th>Description</th>
 </tr>
+</thead>
+<tbody>
 <tr>
 <td>
-<code>counters</code></br>
+<code>labels</code></br>
 <em>
-<a href="#allocation.agones.dev/v1.CounterSelector">
-map[string]agones.dev/agones/pkg/apis/allocation/v1.CounterSelector
-</a>
+map[string]string
 </em>
 </td>
 <td>
 <em>(Optional)</em>
-<p>(Alpha, CountsAndLists feature flag) Counters provides filters on minimum and maximum values
-for a Counter&rsquo;s count and available capacity when retrieving a GameServer through Allocation.
-Defaults to no limits.</p>
+<p>Labels to be applied to the <code>GameServer</code></p>
 </td>
 </tr>
 <tr>
 <td>
-<code>lists</code></br>
+<code>annotations</code></br>
 <em>
-<a href="#allocation.agones.dev/v1.ListSelector">
-map[string]agones.dev/agones/pkg/apis/allocation/v1.ListSelector
-</a>
+map[string]string
 </em>
 </td>
 <td>
 <em>(Optional)</em>
-<p>(Alpha, CountsAndLists feature flag) Lists provides filters on minimum and maximum values
-for List capacity, and for the existence of a value in a List, when retrieving a GameServer
-through Allocation. Defaults to no limits.</p>
+<p>Annotations to be applied to the <code>GameServer</code></p>
 </td>
 </tr>
 </tbody>
 </table>
-<h3 id="allocation.agones.dev/v1.ListSelector">ListSelector
+<h3 id="agones.dev/v1.CounterStatus">CounterStatus
 </h3>
 <p>
 (<em>Appears on:</em>
-<a href="#allocation.agones.dev/v1.GameServerSelector">GameServerSelector</a>)
+<a href="#agones.dev/v1.GameServerSpec">GameServerSpec</a>, 
+<a href="#agones.dev/v1.GameServerStatus">GameServerStatus</a>)
 </p>
 <p>
-<p>ListSelector is the filter options for a GameServer based on List available capacity and/or the
-existence of a value in a List.
-0 for MaxAvailable means unlimited maximum. Default for integer fields: 0
-&ldquo;&rdquo; for ContainsValue means ignore field. Default for string field: &ldquo;&rdquo;</p>
+<p>CounterStatus stores the current counter values</p>
 </p>
 <table>
 <thead>
@@ -4049,17 +4281,7 @@ <h3 id="allocation.agones.dev/v1.ListSelector">ListSelector
 <tbody>
 <tr>
 <td>
-<code>containsValue</code></br>
-<em>
-string
-</em>
-</td>
-<td>
-</td>
-</tr>
-<tr>
-<td>
-<code>minAvailable</code></br>
+<code>count</code></br>
 <em>
 int64
 </em>
@@ -4069,7 +4291,7 @@ <h3 id="allocation.agones.dev/v1.ListSelector">ListSelector
 </tr>
 <tr>
 <td>
-<code>maxAvailable</code></br>
+<code>capacity</code></br>
 <em>
 int64
 </em>
@@ -4079,14 +4301,15 @@ <h3 id="allocation.agones.dev/v1.ListSelector">ListSelector
 </tr>
 </tbody>
 </table>
-<h3 id="allocation.agones.dev/v1.MetaPatch">MetaPatch
+<h3 id="agones.dev/v1.Eviction">Eviction
 </h3>
 <p>
 (<em>Appears on:</em>
-<a href="#allocation.agones.dev/v1.GameServerAllocationSpec">GameServerAllocationSpec</a>)
+<a href="#agones.dev/v1.GameServerSpec">GameServerSpec</a>, 
+<a href="#agones.dev/v1.GameServerStatus">GameServerStatus</a>)
 </p>
 <p>
-<p>MetaPatch is the metadata used to patch the GameServer metadata on allocation</p>
+<p>Eviction specifies the eviction tolerance of the GameServer</p>
 </p>
 <table>
 <thead>
@@ -4098,34 +4321,40 @@ <h3 id="allocation.agones.dev/v1.MetaPatch">MetaPatch
 <tbody>
 <tr>
 <td>
-<code>labels</code></br>
-<em>
-map[string]string
-</em>
-</td>
-<td>
-</td>
-</tr>
-<tr>
-<td>
-<code>annotations</code></br>
+<code>safe</code></br>
 <em>
-map[string]string
+<a href="#agones.dev/v1.EvictionSafe">
+EvictionSafe
+</a>
 </em>
 </td>
 <td>
+<p>(Alpha, SafeToEvict feature flag)
+Game server supports termination via SIGTERM:
+- Always: Allow eviction for both Cluster Autoscaler and node drain for upgrades
+- OnUpgrade: Allow eviction for upgrades alone
+- Never (default): Pod should run to completion</p>
 </td>
 </tr>
 </tbody>
 </table>
-<h3 id="allocation.agones.dev/v1.MultiClusterSetting">MultiClusterSetting
+<h3 id="agones.dev/v1.EvictionSafe">EvictionSafe
+(<code>string</code> alias)</p></h3>
+<p>
+(<em>Appears on:</em>
+<a href="#agones.dev/v1.Eviction">Eviction</a>)
+</p>
+<p>
+<p>EvictionSafe specified whether the game server supports termination via SIGTERM</p>
+</p>
+<h3 id="agones.dev/v1.FleetSpec">FleetSpec
 </h3>
 <p>
 (<em>Appears on:</em>
-<a href="#allocation.agones.dev/v1.GameServerAllocationSpec">GameServerAllocationSpec</a>)
+<a href="#agones.dev/v1.Fleet">Fleet</a>)
 </p>
 <p>
-<p>MultiClusterSetting specifies settings for multi-cluster allocation.</p>
+<p>FleetSpec is the spec for a Fleet</p>
 </p>
 <table>
 <thead>
@@ -4137,36 +4366,80 @@ <h3 id="allocation.agones.dev/v1.MultiClusterSetting">MultiClusterSetting
 <tbody>
 <tr>
 <td>
-<code>enabled</code></br>
+<code>replicas</code></br>
 <em>
-bool
+int32
 </em>
 </td>
 <td>
+<p>Replicas are the number of GameServers that should be in this set. Defaults to 0.</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>policySelector</code></br>
+<code>allocationOverflow</code></br>
 <em>
-<a href="https://v1-25.docs.kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#labelselector-v1-meta">
-Kubernetes meta/v1.LabelSelector
+<a href="#agones.dev/v1.AllocationOverflow">
+AllocationOverflow
+</a>
+</em>
+</td>
+<td>
+<em>(Optional)</em>
+<p>[Stage: Alpha]
+[FeatureFlag:FleetAllocationOverflow]
+Labels and/or Annotations to apply to GameServers when the number of Allocated GameServers drops below
+the desired replicas on the underlying <code>GameServerSet</code></p>
+</td>
+</tr>
+<tr>
+<td>
+<code>strategy</code></br>
+<em>
+<a href="https://v1-25.docs.kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#deploymentstrategy-v1-apps">
+Kubernetes apps/v1.DeploymentStrategy
+</a>
+</em>
+</td>
+<td>
+<p>Deployment strategy</p>
+</td>
+</tr>
+<tr>
+<td>
+<code>scheduling</code></br>
+<em>
+agones.dev/agones/pkg/apis.SchedulingStrategy
+</em>
+</td>
+<td>
+<p>Scheduling strategy. Defaults to &ldquo;Packed&rdquo;.</p>
+</td>
+</tr>
+<tr>
+<td>
+<code>template</code></br>
+<em>
+<a href="#agones.dev/v1.GameServerTemplateSpec">
+GameServerTemplateSpec
 </a>
 </em>
 </td>
 <td>
+<p>Template the GameServer template to apply for this Fleet</p>
 </td>
 </tr>
 </tbody>
 </table>
-<h3 id="allocation.agones.dev/v1.PlayerSelector">PlayerSelector
+<h3 id="agones.dev/v1.FleetStatus">FleetStatus
 </h3>
 <p>
 (<em>Appears on:</em>
-<a href="#allocation.agones.dev/v1.GameServerSelector">GameServerSelector</a>)
+<a href="#agones.dev/v1.Fleet">Fleet</a>, 
+<a href="#autoscaling.agones.dev/v1.FleetAutoscaleRequest">FleetAutoscaleRequest</a>)
 </p>
 <p>
-<p>PlayerSelector is the filter options for a GameServer based on player counts</p>
+<p>FleetStatus is the status of a Fleet</p>
 </p>
 <table>
 <thead>
@@ -4178,93 +4451,76 @@ <h3 id="allocation.agones.dev/v1.PlayerSelector">PlayerSelector
 <tbody>
 <tr>
 <td>
-<code>minAvailable</code></br>
+<code>replicas</code></br>
 <em>
-int64
+int32
 </em>
 </td>
 <td>
+<p>Replicas the total number of current GameServer replicas</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>maxAvailable</code></br>
+<code>readyReplicas</code></br>
 <em>
-int64
+int32
 </em>
 </td>
 <td>
+<p>ReadyReplicas are the number of Ready GameServer replicas</p>
 </td>
 </tr>
-</tbody>
-</table>
-<h3 id="allocation.agones.dev/v1.Priority">Priority
-</h3>
-<p>
-(<em>Appears on:</em>
-<a href="#allocation.agones.dev/v1.GameServerAllocationSpec">GameServerAllocationSpec</a>)
-</p>
-<p>
-<p>Priority is a sorting option for GameServers with Counters or Lists based on the count or
-number of items in a List.
-PriorityType: Sort by a &ldquo;Counter&rdquo; or a &ldquo;List&rdquo;.
-Key: The name of the Counter or List. If not found on the GameServer, has no impact.
-Order: Sort by &ldquo;Ascending&rdquo; or &ldquo;Descending&rdquo;. Default is &ldquo;Descending&rdquo; so bigger count is preferred.
-&ldquo;Ascending&rdquo; would be smaller count is preferred.</p>
-</p>
-<table>
-<thead>
-<tr>
-<th>Field</th>
-<th>Description</th>
-</tr>
-</thead>
-<tbody>
 <tr>
 <td>
-<code>priorityType</code></br>
+<code>reservedReplicas</code></br>
 <em>
-string
+int32
 </em>
 </td>
 <td>
+<p>ReservedReplicas are the total number of Reserved GameServer replicas in this fleet.
+Reserved instances won&rsquo;t be deleted on scale down, but won&rsquo;t cause an autoscaler to scale up.</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>key</code></br>
+<code>allocatedReplicas</code></br>
 <em>
-string
+int32
 </em>
 </td>
 <td>
+<p>AllocatedReplicas are the number of Allocated GameServer replicas</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>order</code></br>
+<code>players</code></br>
 <em>
-string
+<a href="#agones.dev/v1.AggregatedPlayerStatus">
+AggregatedPlayerStatus
+</a>
 </em>
 </td>
 <td>
+<em>(Optional)</em>
+<p>[Stage:Alpha]
+[FeatureFlag:PlayerTracking]
+Players are the current total player capacity and count for this Fleet</p>
 </td>
 </tr>
 </tbody>
 </table>
-<hr/>
-<h2 id="autoscaling.agones.dev/v1">autoscaling.agones.dev/v1</h2>
+<h3 id="agones.dev/v1.GameServerPort">GameServerPort
+</h3>
 <p>
-<p>Package v1 is the v1 version of the API.</p>
+(<em>Appears on:</em>
+<a href="#agones.dev/v1.GameServerSpec">GameServerSpec</a>)
 </p>
-Resource Types:
-<ul><li>
-<a href="#autoscaling.agones.dev/v1.FleetAutoscaler">FleetAutoscaler</a>
-</li></ul>
-<h3 id="autoscaling.agones.dev/v1.FleetAutoscaler">FleetAutoscaler
-</h3>
 <p>
-<p>FleetAutoscaler is the data structure for a FleetAutoscaler resource</p>
+<p>GameServerPort defines a set of Ports that
+are to be exposed via the GameServer</p>
 </p>
 <table>
 <thead>
@@ -4276,112 +4532,89 @@ <h3 id="autoscaling.agones.dev/v1.FleetAutoscaler">FleetAutoscaler
 <tbody>
 <tr>
 <td>
-<code>apiVersion</code></br>
-string</td>
-<td>
-<code>
-autoscaling.agones.dev/v1
-</code>
-</td>
-</tr>
-<tr>
-<td>
-<code>kind</code></br>
-string
-</td>
-<td><code>FleetAutoscaler</code></td>
-</tr>
-<tr>
-<td>
-<code>metadata</code></br>
+<code>name</code></br>
 <em>
-<a href="https://v1-25.docs.kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
-Kubernetes meta/v1.ObjectMeta
-</a>
+string
 </em>
 </td>
 <td>
-Refer to the Kubernetes API documentation for the fields of the
-<code>metadata</code> field.
+<p>Name is the descriptive name of the port</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>spec</code></br>
+<code>portPolicy</code></br>
 <em>
-<a href="#autoscaling.agones.dev/v1.FleetAutoscalerSpec">
-FleetAutoscalerSpec
+<a href="#agones.dev/v1.PortPolicy">
+PortPolicy
 </a>
 </em>
 </td>
 <td>
-<br/>
-<br/>
-<table>
+<p>PortPolicy defines the policy for how the HostPort is populated.
+Dynamic port will allocate a HostPort within the selected MIN_PORT and MAX_PORT range passed to the controller
+at installation time.
+When <code>Static</code> portPolicy is specified, <code>HostPort</code> is required, to specify the port that game clients will
+connect to</p>
+</td>
+</tr>
 <tr>
 <td>
-<code>fleetName</code></br>
+<code>container</code></br>
 <em>
 string
 </em>
 </td>
 <td>
+<em>(Optional)</em>
+<p>Container is the name of the container on which to open the port. Defaults to the game server container.</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>policy</code></br>
+<code>containerPort</code></br>
 <em>
-<a href="#autoscaling.agones.dev/v1.FleetAutoscalerPolicy">
-FleetAutoscalerPolicy
-</a>
+int32
 </em>
 </td>
 <td>
-<p>Autoscaling policy</p>
+<p>ContainerPort is the port that is being opened on the specified container&rsquo;s process</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>sync</code></br>
+<code>hostPort</code></br>
 <em>
-<a href="#autoscaling.agones.dev/v1.FleetAutoscalerSync">
-FleetAutoscalerSync
-</a>
+int32
 </em>
 </td>
 <td>
-<em>(Optional)</em>
-<p>[Stage:Beta]
-[FeatureFlag:CustomFasSyncInterval]
-Sync defines when FleetAutoscalers runs autoscaling</p>
-</td>
-</tr>
-</table>
+<p>HostPort the port exposed on the host for clients to connect to</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>status</code></br>
+<code>protocol</code></br>
 <em>
-<a href="#autoscaling.agones.dev/v1.FleetAutoscalerStatus">
-FleetAutoscalerStatus
+<a href="https://v1-25.docs.kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#protocol-v1-core">
+Kubernetes core/v1.Protocol
 </a>
 </em>
 </td>
 <td>
+<p>Protocol is the network protocol being used. Defaults to UDP. TCP and TCPUDP are other options.</p>
 </td>
 </tr>
 </tbody>
 </table>
-<h3 id="autoscaling.agones.dev/v1.BufferPolicy">BufferPolicy
+<h3 id="agones.dev/v1.GameServerSetSpec">GameServerSetSpec
 </h3>
 <p>
 (<em>Appears on:</em>
-<a href="#autoscaling.agones.dev/v1.FleetAutoscalerPolicy">FleetAutoscalerPolicy</a>)
+<a href="#agones.dev/v1.GameServerSet">GameServerSet</a>)
 </p>
 <p>
-<p>BufferPolicy controls the desired behavior of the buffer policy.</p>
+<p>GameServerSetSpec the specification for GameServerSet</p>
 </p>
 <table>
 <thead>
@@ -4393,59 +4626,66 @@ <h3 id="autoscaling.agones.dev/v1.BufferPolicy">BufferPolicy
 <tbody>
 <tr>
 <td>
-<code>maxReplicas</code></br>
+<code>replicas</code></br>
 <em>
 int32
 </em>
 </td>
 <td>
-<p>MaxReplicas is the maximum amount of replicas that the fleet may have.
-It must be bigger than both MinReplicas and BufferSize</p>
+<p>Replicas are the number of GameServers that should be in this set</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>minReplicas</code></br>
+<code>allocationOverflow</code></br>
 <em>
-int32
+<a href="#agones.dev/v1.AllocationOverflow">
+AllocationOverflow
+</a>
 </em>
 </td>
 <td>
-<p>MinReplicas is the minimum amount of replicas that the fleet must have
-If zero, it is ignored.
-If non zero, it must be smaller than MaxReplicas and bigger than BufferSize</p>
+<em>(Optional)</em>
+<p>[Stage: Alpha]
+[FeatureFlag:FleetAllocationOverflow]
+Labels and Annotations to apply to GameServers when the number of Allocated GameServers drops below
+the desired replicas on the underlying <code>GameServerSet</code></p>
 </td>
 </tr>
 <tr>
 <td>
-<code>bufferSize</code></br>
+<code>scheduling</code></br>
 <em>
-k8s.io/apimachinery/pkg/util/intstr.IntOrString
+agones.dev/agones/pkg/apis.SchedulingStrategy
 </em>
 </td>
 <td>
-<p>BufferSize defines how many replicas the autoscaler tries to have ready all the time
-Value can be an absolute number (ex: 5) or a percentage of desired gs instances (ex: 15%)
-Absolute number is calculated from percentage by rounding up.
-Example: when this is set to 20%, the autoscaler will make sure that 20%
-of the fleet&rsquo;s game server replicas are ready. When this is set to 20,
-the autoscaler will make sure that there are 20 available game servers
-Must be bigger than 0
-Note: by &ldquo;ready&rdquo; we understand in this case &ldquo;non-allocated&rdquo;; this is done to ensure robustness
-and computation stability in different edge case (fleet just created, not enough
-capacity in the cluster etc)</p>
+<p>Scheduling strategy. Defaults to &ldquo;Packed&rdquo;.</p>
+</td>
+</tr>
+<tr>
+<td>
+<code>template</code></br>
+<em>
+<a href="#agones.dev/v1.GameServerTemplateSpec">
+GameServerTemplateSpec
+</a>
+</em>
+</td>
+<td>
+<p>Template the GameServer template to apply for this GameServerSet</p>
 </td>
 </tr>
 </tbody>
 </table>
-<h3 id="autoscaling.agones.dev/v1.FixedIntervalSync">FixedIntervalSync
+<h3 id="agones.dev/v1.GameServerSetStatus">GameServerSetStatus
 </h3>
 <p>
 (<em>Appears on:</em>
-<a href="#autoscaling.agones.dev/v1.FleetAutoscalerSync">FleetAutoscalerSync</a>)
+<a href="#agones.dev/v1.GameServerSet">GameServerSet</a>)
 </p>
 <p>
-<p>FixedIntervalSync controls the desired behavior of the fixed interval based sync.</p>
+<p>GameServerSetStatus is the status of a GameServerSet</p>
 </p>
 <table>
 <thead>
@@ -4457,93 +4697,86 @@ <h3 id="autoscaling.agones.dev/v1.FixedIntervalSync">FixedIntervalSync
 <tbody>
 <tr>
 <td>
-<code>seconds</code></br>
+<code>replicas</code></br>
 <em>
 int32
 </em>
 </td>
 <td>
-<p>Seconds defines how often we run fleet autoscaling in seconds</p>
+<p>Replicas is the total number of current GameServer replicas</p>
 </td>
 </tr>
-</tbody>
-</table>
-<h3 id="autoscaling.agones.dev/v1.FleetAutoscaleRequest">FleetAutoscaleRequest
-</h3>
-<p>
-(<em>Appears on:</em>
-<a href="#autoscaling.agones.dev/v1.FleetAutoscaleReview">FleetAutoscaleReview</a>)
-</p>
-<p>
-<p>FleetAutoscaleRequest defines the request to webhook autoscaler endpoint</p>
-</p>
-<table>
-<thead>
 <tr>
-<th>Field</th>
-<th>Description</th>
+<td>
+<code>readyReplicas</code></br>
+<em>
+int32
+</em>
+</td>
+<td>
+<p>ReadyReplicas is the number of Ready GameServer replicas</p>
+</td>
 </tr>
-</thead>
-<tbody>
 <tr>
 <td>
-<code>uid</code></br>
+<code>reservedReplicas</code></br>
 <em>
-k8s.io/apimachinery/pkg/types.UID
+int32
 </em>
 </td>
 <td>
-<p>UID is an identifier for the individual request/response. It allows us to distinguish instances of requests which are
-otherwise identical (parallel requests, requests when earlier requests did not modify etc)
-The UID is meant to track the round trip (request/response) between the Autoscaler and the WebHook, not the user request.
-It is suitable for correlating log entries between the webhook and apiserver, for either auditing or debugging.</p>
+<p>ReservedReplicas is the number of Reserved GameServer replicas</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>name</code></br>
+<code>allocatedReplicas</code></br>
 <em>
-string
+int32
 </em>
 </td>
 <td>
-<p>Name is the name of the Fleet being scaled</p>
+<p>AllocatedReplicas is the number of Allocated GameServer replicas</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>namespace</code></br>
+<code>shutdownReplicas</code></br>
 <em>
-string
+int32
 </em>
 </td>
 <td>
-<p>Namespace is the namespace associated with the request (if any).</p>
+<p>ShutdownReplicas is the number of Shutdown GameServers replicas</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>status</code></br>
+<code>players</code></br>
 <em>
-<a href="#agones.dev/v1.FleetStatus">
-FleetStatus
+<a href="#agones.dev/v1.AggregatedPlayerStatus">
+AggregatedPlayerStatus
 </a>
 </em>
 </td>
 <td>
-<p>The Fleet&rsquo;s status values</p>
+<em>(Optional)</em>
+<p>[Stage:Alpha]
+[FeatureFlag:PlayerTracking]
+Players is the current total player capacity and count for this GameServerSet</p>
 </td>
 </tr>
 </tbody>
 </table>
-<h3 id="autoscaling.agones.dev/v1.FleetAutoscaleResponse">FleetAutoscaleResponse
+<h3 id="agones.dev/v1.GameServerSpec">GameServerSpec
 </h3>
 <p>
 (<em>Appears on:</em>
-<a href="#autoscaling.agones.dev/v1.FleetAutoscaleReview">FleetAutoscaleReview</a>)
+<a href="#agones.dev/v1.GameServer">GameServer</a>, 
+<a href="#agones.dev/v1.GameServerTemplateSpec">GameServerTemplateSpec</a>)
 </p>
 <p>
-<p>FleetAutoscaleResponse defines the response of webhook autoscaler endpoint</p>
+<p>GameServerSpec is the spec for a GameServer resource</p>
 </p>
 <table>
 <thead>
@@ -4555,158 +4788,153 @@ <h3 id="autoscaling.agones.dev/v1.FleetAutoscaleResponse">FleetAutoscaleResponse
 <tbody>
 <tr>
 <td>
-<code>uid</code></br>
+<code>container</code></br>
 <em>
-k8s.io/apimachinery/pkg/types.UID
+string
 </em>
 </td>
 <td>
-<p>UID is an identifier for the individual request/response.
-This should be copied over from the corresponding FleetAutoscaleRequest.</p>
+<p>Container specifies which Pod container is the game server. Only required if there is more than one
+container defined</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>scale</code></br>
+<code>ports</code></br>
 <em>
-bool
+<a href="#agones.dev/v1.GameServerPort">
+[]GameServerPort
+</a>
 </em>
 </td>
 <td>
-<p>Set to false if no scaling should occur to the Fleet</p>
+<p>Ports are the array of ports that can be exposed via the game server</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>replicas</code></br>
+<code>health</code></br>
 <em>
-int32
+<a href="#agones.dev/v1.Health">
+Health
+</a>
 </em>
 </td>
 <td>
-<p>The targeted replica count</p>
+<p>Health configures health checking</p>
 </td>
 </tr>
-</tbody>
-</table>
-<h3 id="autoscaling.agones.dev/v1.FleetAutoscaleReview">FleetAutoscaleReview
-</h3>
-<p>
-<p>FleetAutoscaleReview is passed to the webhook with a populated Request value,
-and then returned with a populated Response.</p>
-</p>
-<table>
-<thead>
 <tr>
-<th>Field</th>
-<th>Description</th>
+<td>
+<code>scheduling</code></br>
+<em>
+agones.dev/agones/pkg/apis.SchedulingStrategy
+</em>
+</td>
+<td>
+<p>Scheduling strategy. Defaults to &ldquo;Packed&rdquo;</p>
+</td>
 </tr>
-</thead>
-<tbody>
 <tr>
 <td>
-<code>request</code></br>
+<code>sdkServer</code></br>
 <em>
-<a href="#autoscaling.agones.dev/v1.FleetAutoscaleRequest">
-FleetAutoscaleRequest
+<a href="#agones.dev/v1.SdkServer">
+SdkServer
 </a>
 </em>
 </td>
 <td>
+<p>SdkServer specifies parameters for the Agones SDK Server sidecar container</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>response</code></br>
+<code>template</code></br>
 <em>
-<a href="#autoscaling.agones.dev/v1.FleetAutoscaleResponse">
-FleetAutoscaleResponse
+<a href="https://v1-25.docs.kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#podtemplatespec-v1-core">
+Kubernetes core/v1.PodTemplateSpec
 </a>
 </em>
 </td>
 <td>
+<p>Template describes the Pod that will be created for the GameServer</p>
 </td>
 </tr>
-</tbody>
-</table>
-<h3 id="autoscaling.agones.dev/v1.FleetAutoscalerPolicy">FleetAutoscalerPolicy
-</h3>
-<p>
-(<em>Appears on:</em>
-<a href="#autoscaling.agones.dev/v1.FleetAutoscalerSpec">FleetAutoscalerSpec</a>)
-</p>
-<p>
-<p>FleetAutoscalerPolicy describes how to scale a fleet</p>
-</p>
-<table>
-<thead>
 <tr>
-<th>Field</th>
-<th>Description</th>
+<td>
+<code>players</code></br>
+<em>
+<a href="#agones.dev/v1.PlayersSpec">
+PlayersSpec
+</a>
+</em>
+</td>
+<td>
+<em>(Optional)</em>
+<p>(Alpha, PlayerTracking feature flag) Players provides the configuration for player tracking features.</p>
+</td>
 </tr>
-</thead>
-<tbody>
 <tr>
 <td>
-<code>type</code></br>
+<code>counters</code></br>
 <em>
-<a href="#autoscaling.agones.dev/v1.FleetAutoscalerPolicyType">
-FleetAutoscalerPolicyType
+<a href="#agones.dev/v1.CounterStatus">
+map[string]agones.dev/agones/pkg/apis/agones/v1.CounterStatus
 </a>
 </em>
 </td>
 <td>
-<p>Type of autoscaling policy.</p>
+<em>(Optional)</em>
+<p>(Alpha, CountsAndLists feature flag) Counters and Lists provides the configuration for generic tracking features.</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>buffer</code></br>
+<code>lists</code></br>
 <em>
-<a href="#autoscaling.agones.dev/v1.BufferPolicy">
-BufferPolicy
+<a href="#agones.dev/v1.ListStatus">
+map[string]agones.dev/agones/pkg/apis/agones/v1.ListStatus
 </a>
 </em>
 </td>
 <td>
-<em>(Optional)</em>
-<p>Buffer policy config params. Present only if FleetAutoscalerPolicyType = Buffer.</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>webhook</code></br>
+<code>eviction</code></br>
 <em>
-<a href="#autoscaling.agones.dev/v1.WebhookPolicy">
-WebhookPolicy
+<a href="#agones.dev/v1.Eviction">
+Eviction
 </a>
 </em>
 </td>
 <td>
 <em>(Optional)</em>
-<p>Webhook policy config params. Present only if FleetAutoscalerPolicyType = Webhook.</p>
+<p>(Alpha, SafeToEvict feature flag) Eviction specifies the eviction tolerance of the GameServer. Defaults to &ldquo;Never&rdquo;.</p>
 </td>
 </tr>
 </tbody>
 </table>
-<h3 id="autoscaling.agones.dev/v1.FleetAutoscalerPolicyType">FleetAutoscalerPolicyType
+<h3 id="agones.dev/v1.GameServerState">GameServerState
 (<code>string</code> alias)</p></h3>
 <p>
 (<em>Appears on:</em>
-<a href="#autoscaling.agones.dev/v1.FleetAutoscalerPolicy">FleetAutoscalerPolicy</a>)
+<a href="#allocation.agones.dev/v1.GameServerSelector">GameServerSelector</a>, 
+<a href="#agones.dev/v1.GameServerStatus">GameServerStatus</a>)
 </p>
 <p>
-<p>FleetAutoscalerPolicyType is the policy for autoscaling
-for a given Fleet</p>
+<p>GameServerState is the state for the GameServer</p>
 </p>
-<h3 id="autoscaling.agones.dev/v1.FleetAutoscalerSpec">FleetAutoscalerSpec
+<h3 id="agones.dev/v1.GameServerStatus">GameServerStatus
 </h3>
 <p>
 (<em>Appears on:</em>
-<a href="#autoscaling.agones.dev/v1.FleetAutoscaler">FleetAutoscaler</a>)
+<a href="#agones.dev/v1.GameServer">GameServer</a>)
 </p>
 <p>
-<p>FleetAutoscalerSpec is the spec for a Fleet Scaler</p>
+<p>GameServerStatus is the status for a GameServer resource</p>
 </p>
 <table>
 <thead>
@@ -4718,133 +4946,129 @@ <h3 id="autoscaling.agones.dev/v1.FleetAutoscalerSpec">FleetAutoscalerSpec
 <tbody>
 <tr>
 <td>
-<code>fleetName</code></br>
+<code>state</code></br>
 <em>
-string
+<a href="#agones.dev/v1.GameServerState">
+GameServerState
+</a>
 </em>
 </td>
 <td>
+<p>GameServerState is the current state of a GameServer, e.g. Creating, Starting, Ready, etc</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>policy</code></br>
+<code>ports</code></br>
 <em>
-<a href="#autoscaling.agones.dev/v1.FleetAutoscalerPolicy">
-FleetAutoscalerPolicy
+<a href="#agones.dev/v1.GameServerStatusPort">
+[]GameServerStatusPort
 </a>
 </em>
 </td>
 <td>
-<p>Autoscaling policy</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>sync</code></br>
+<code>address</code></br>
 <em>
-<a href="#autoscaling.agones.dev/v1.FleetAutoscalerSync">
-FleetAutoscalerSync
-</a>
+string
 </em>
 </td>
 <td>
-<em>(Optional)</em>
-<p>[Stage:Beta]
-[FeatureFlag:CustomFasSyncInterval]
-Sync defines when FleetAutoscalers runs autoscaling</p>
 </td>
 </tr>
-</tbody>
-</table>
-<h3 id="autoscaling.agones.dev/v1.FleetAutoscalerStatus">FleetAutoscalerStatus
-</h3>
-<p>
-(<em>Appears on:</em>
-<a href="#autoscaling.agones.dev/v1.FleetAutoscaler">FleetAutoscaler</a>)
-</p>
-<p>
-<p>FleetAutoscalerStatus defines the current status of a FleetAutoscaler</p>
-</p>
-<table>
-<thead>
 <tr>
-<th>Field</th>
-<th>Description</th>
+<td>
+<code>nodeName</code></br>
+<em>
+string
+</em>
+</td>
+<td>
+</td>
 </tr>
-</thead>
-<tbody>
 <tr>
 <td>
-<code>currentReplicas</code></br>
+<code>reservedUntil</code></br>
 <em>
-int32
+<a href="https://v1-25.docs.kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#time-v1-meta">
+Kubernetes meta/v1.Time
+</a>
 </em>
 </td>
 <td>
-<p>CurrentReplicas is the current number of gameserver replicas
-of the fleet managed by this autoscaler, as last seen by the autoscaler</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>desiredReplicas</code></br>
+<code>players</code></br>
 <em>
-int32
+<a href="#agones.dev/v1.PlayerStatus">
+PlayerStatus
+</a>
 </em>
 </td>
 <td>
-<p>DesiredReplicas is the desired number of gameserver replicas
-of the fleet managed by this autoscaler, as last calculated by the autoscaler</p>
+<em>(Optional)</em>
+<p>[Stage:Alpha]
+[FeatureFlag:PlayerTracking]</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>lastScaleTime</code></br>
+<code>counters</code></br>
 <em>
-<a href="https://v1-25.docs.kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#time-v1-meta">
-Kubernetes meta/v1.Time
+<a href="#agones.dev/v1.CounterStatus">
+map[string]agones.dev/agones/pkg/apis/agones/v1.CounterStatus
 </a>
 </em>
 </td>
 <td>
 <em>(Optional)</em>
-<p>lastScaleTime is the last time the FleetAutoscaler scaled the attached fleet,</p>
+<p>(Alpha, CountsAndLists feature flag) Counters and Lists provides the configuration for generic tracking features.</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>ableToScale</code></br>
+<code>lists</code></br>
 <em>
-bool
+<a href="#agones.dev/v1.ListStatus">
+map[string]agones.dev/agones/pkg/apis/agones/v1.ListStatus
+</a>
 </em>
 </td>
 <td>
-<p>AbleToScale indicates that we can access the target fleet</p>
+<em>(Optional)</em>
 </td>
 </tr>
 <tr>
 <td>
-<code>scalingLimited</code></br>
+<code>eviction</code></br>
 <em>
-bool
+<a href="#agones.dev/v1.Eviction">
+Eviction
+</a>
 </em>
 </td>
 <td>
-<p>ScalingLimited indicates that the calculated scale would be above or below the range
-defined by MinReplicas and MaxReplicas, and has thus been capped.</p>
+<em>(Optional)</em>
+<p>(Alpha, SafeToEvict feature flag) Eviction specifies the eviction tolerance of the GameServer.</p>
 </td>
 </tr>
 </tbody>
 </table>
-<h3 id="autoscaling.agones.dev/v1.FleetAutoscalerSync">FleetAutoscalerSync
+<h3 id="agones.dev/v1.GameServerStatusPort">GameServerStatusPort
 </h3>
 <p>
 (<em>Appears on:</em>
-<a href="#autoscaling.agones.dev/v1.FleetAutoscalerSpec">FleetAutoscalerSpec</a>)
+<a href="#allocation.agones.dev/v1.GameServerAllocationStatus">GameServerAllocationStatus</a>, 
+<a href="#agones.dev/v1.GameServerStatus">GameServerStatus</a>)
 </p>
 <p>
-<p>FleetAutoscalerSync describes when to sync a fleet</p>
+<p>GameServerStatusPort shows the port that was allocated to a
+GameServer.</p>
 </p>
 <table>
 <thead>
@@ -4856,52 +5080,35 @@ <h3 id="autoscaling.agones.dev/v1.FleetAutoscalerSync">FleetAutoscalerSync
 <tbody>
 <tr>
 <td>
-<code>type</code></br>
+<code>name</code></br>
 <em>
-<a href="#autoscaling.agones.dev/v1.FleetAutoscalerSyncType">
-FleetAutoscalerSyncType
-</a>
+string
 </em>
 </td>
 <td>
-<p>Type of autoscaling sync.</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>fixedInterval</code></br>
+<code>port</code></br>
 <em>
-<a href="#autoscaling.agones.dev/v1.FixedIntervalSync">
-FixedIntervalSync
-</a>
+int32
 </em>
 </td>
 <td>
-<em>(Optional)</em>
-<p>FixedInterval config params. Present only if FleetAutoscalerSyncType = FixedInterval.</p>
 </td>
 </tr>
 </tbody>
 </table>
-<h3 id="autoscaling.agones.dev/v1.FleetAutoscalerSyncType">FleetAutoscalerSyncType
-(<code>string</code> alias)</p></h3>
-<p>
-(<em>Appears on:</em>
-<a href="#autoscaling.agones.dev/v1.FleetAutoscalerSync">FleetAutoscalerSync</a>)
-</p>
-<p>
-<p>FleetAutoscalerSyncType is the sync strategy for a given Fleet</p>
-</p>
-<h3 id="autoscaling.agones.dev/v1.WebhookPolicy">WebhookPolicy
+<h3 id="agones.dev/v1.GameServerTemplateSpec">GameServerTemplateSpec
 </h3>
 <p>
 (<em>Appears on:</em>
-<a href="#autoscaling.agones.dev/v1.FleetAutoscalerPolicy">FleetAutoscalerPolicy</a>)
+<a href="#agones.dev/v1.FleetSpec">FleetSpec</a>, 
+<a href="#agones.dev/v1.GameServerSetSpec">GameServerSetSpec</a>)
 </p>
 <p>
-<p>WebhookPolicy controls the desired behavior of the webhook policy.
-It contains the description of the webhook autoscaler service
-used to form url which is accessible inside the cluster</p>
+<p>GameServerTemplateSpec is a template for GameServers</p>
 </p>
 <table>
 <thead>
@@ -4913,147 +5120,141 @@ <h3 id="autoscaling.agones.dev/v1.WebhookPolicy">WebhookPolicy
 <tbody>
 <tr>
 <td>
-<code>url</code></br>
+<code>metadata</code></br>
 <em>
-string
+<a href="https://v1-25.docs.kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
+Kubernetes meta/v1.ObjectMeta
+</a>
 </em>
 </td>
 <td>
-<em>(Optional)</em>
-<p><code>url</code> gives the location of the webhook, in standard URL form
-(<code>scheme://host:port/path</code>). Exactly one of <code>url</code> or <code>service</code>
-must be specified.</p>
-<p>The <code>host</code> should not refer to a service running in the cluster; use
-the <code>service</code> field instead. The host might be resolved via external
-DNS in some apiservers (e.g., <code>kube-apiserver</code> cannot resolve
-in-cluster DNS as that would be a layering violation). <code>host</code> may
-also be an IP address.</p>
-<p>Please note that using <code>localhost</code> or <code>127.0.0.1</code> as a <code>host</code> is
-risky unless you take great care to run this webhook on all hosts
-which run an apiserver which might need to make calls to this
-webhook. Such installs are likely to be non-portable, i.e., not easy
-to turn up in a new cluster.</p>
-<p>The scheme must be &ldquo;https&rdquo;; the URL must begin with &ldquo;https://&rdquo;.</p>
-<p>A path is optional, and if present may be any string permissible in
-a URL. You may use the path to pass an arbitrary string to the
-webhook, for example, a cluster identifier.</p>
-<p>Attempting to use a user or basic auth e.g. &ldquo;user:password@&rdquo; is not
-allowed. Fragments (&ldquo;#&hellip;&rdquo;) and query parameters (&ldquo;?&hellip;&rdquo;) are not
-allowed, either.</p>
+Refer to the Kubernetes API documentation for the fields of the
+<code>metadata</code> field.
 </td>
 </tr>
 <tr>
 <td>
-<code>service</code></br>
+<code>spec</code></br>
 <em>
-<a href="https://v1-25.docs.kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#servicereference-v1-admissionregistration">
-Kubernetes admissionregistration/v1.ServiceReference
+<a href="#agones.dev/v1.GameServerSpec">
+GameServerSpec
 </a>
 </em>
 </td>
 <td>
-<em>(Optional)</em>
-<p><code>service</code> is a reference to the service for this webhook. Either
-<code>service</code> or <code>url</code> must be specified.</p>
-<p>If the webhook is running within the cluster, then you should use <code>service</code>.</p>
+<br/>
+<br/>
+<table>
+<tr>
+<td>
+<code>container</code></br>
+<em>
+string
+</em>
+</td>
+<td>
+<p>Container specifies which Pod container is the game server. Only required if there is more than one
+container defined</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>caBundle</code></br>
+<code>ports</code></br>
 <em>
-[]byte
+<a href="#agones.dev/v1.GameServerPort">
+[]GameServerPort
+</a>
 </em>
 </td>
 <td>
-<em>(Optional)</em>
-<p><code>caBundle</code> is a PEM encoded CA bundle which will be used to validate the webhook&rsquo;s server certificate.
-If unspecified, system trust roots on the apiserver are used.</p>
+<p>Ports are the array of ports that can be exposed via the game server</p>
 </td>
 </tr>
-</tbody>
-</table>
-<hr/>
-<h2 id="multicluster.agones.dev/v1">multicluster.agones.dev/v1</h2>
-<p>
-<p>Package v1 is the v1 version of the API.</p>
-</p>
-Resource Types:
-<ul><li>
-<a href="#multicluster.agones.dev/v1.GameServerAllocationPolicy">GameServerAllocationPolicy</a>
-</li></ul>
-<h3 id="multicluster.agones.dev/v1.GameServerAllocationPolicy">GameServerAllocationPolicy
-</h3>
-<p>
-<p>GameServerAllocationPolicy is the Schema for the gameserverallocationpolicies API</p>
-</p>
-<table>
-<thead>
 <tr>
-<th>Field</th>
-<th>Description</th>
+<td>
+<code>health</code></br>
+<em>
+<a href="#agones.dev/v1.Health">
+Health
+</a>
+</em>
+</td>
+<td>
+<p>Health configures health checking</p>
+</td>
 </tr>
-</thead>
-<tbody>
 <tr>
 <td>
-<code>apiVersion</code></br>
-string</td>
+<code>scheduling</code></br>
+<em>
+agones.dev/agones/pkg/apis.SchedulingStrategy
+</em>
+</td>
 <td>
-<code>
-multicluster.agones.dev/v1
-</code>
+<p>Scheduling strategy. Defaults to &ldquo;Packed&rdquo;</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>kind</code></br>
-string
+<code>sdkServer</code></br>
+<em>
+<a href="#agones.dev/v1.SdkServer">
+SdkServer
+</a>
+</em>
+</td>
+<td>
+<p>SdkServer specifies parameters for the Agones SDK Server sidecar container</p>
 </td>
-<td><code>GameServerAllocationPolicy</code></td>
 </tr>
 <tr>
 <td>
-<code>metadata</code></br>
+<code>template</code></br>
 <em>
-<a href="https://v1-25.docs.kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
-Kubernetes meta/v1.ObjectMeta
+<a href="https://v1-25.docs.kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#podtemplatespec-v1-core">
+Kubernetes core/v1.PodTemplateSpec
 </a>
 </em>
 </td>
 <td>
-Refer to the Kubernetes API documentation for the fields of the
-<code>metadata</code> field.
+<p>Template describes the Pod that will be created for the GameServer</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>spec</code></br>
+<code>players</code></br>
 <em>
-<a href="#multicluster.agones.dev/v1.GameServerAllocationPolicySpec">
-GameServerAllocationPolicySpec
+<a href="#agones.dev/v1.PlayersSpec">
+PlayersSpec
 </a>
 </em>
 </td>
 <td>
-<br/>
-<br/>
-<table>
+<em>(Optional)</em>
+<p>(Alpha, PlayerTracking feature flag) Players provides the configuration for player tracking features.</p>
+</td>
+</tr>
 <tr>
 <td>
-<code>priority</code></br>
+<code>counters</code></br>
 <em>
-int32
+<a href="#agones.dev/v1.CounterStatus">
+map[string]agones.dev/agones/pkg/apis/agones/v1.CounterStatus
+</a>
 </em>
 </td>
 <td>
+<em>(Optional)</em>
+<p>(Alpha, CountsAndLists feature flag) Counters and Lists provides the configuration for generic tracking features.</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>weight</code></br>
+<code>lists</code></br>
 <em>
-int
+<a href="#agones.dev/v1.ListStatus">
+map[string]agones.dev/agones/pkg/apis/agones/v1.ListStatus
+</a>
 </em>
 </td>
 <td>
@@ -5061,14 +5262,16 @@ <h3 id="multicluster.agones.dev/v1.GameServerAllocationPolicy">GameServerAllocat
 </tr>
 <tr>
 <td>
-<code>connectionInfo</code></br>
+<code>eviction</code></br>
 <em>
-<a href="#multicluster.agones.dev/v1.ClusterConnectionInfo">
-ClusterConnectionInfo
+<a href="#agones.dev/v1.Eviction">
+Eviction
 </a>
 </em>
 </td>
 <td>
+<em>(Optional)</em>
+<p>(Alpha, SafeToEvict feature flag) Eviction specifies the eviction tolerance of the GameServer. Defaults to &ldquo;Never&rdquo;.</p>
 </td>
 </tr>
 </table>
@@ -5076,14 +5279,14 @@ <h3 id="multicluster.agones.dev/v1.GameServerAllocationPolicy">GameServerAllocat
 </tr>
 </tbody>
 </table>
-<h3 id="multicluster.agones.dev/v1.ClusterConnectionInfo">ClusterConnectionInfo
+<h3 id="agones.dev/v1.Health">Health
 </h3>
 <p>
 (<em>Appears on:</em>
-<a href="#multicluster.agones.dev/v1.GameServerAllocationPolicySpec">GameServerAllocationPolicySpec</a>)
+<a href="#agones.dev/v1.GameServerSpec">GameServerSpec</a>)
 </p>
 <p>
-<p>ClusterConnectionInfo defines the connection information for a cluster</p>
+<p>Health configures health checking on the GameServer</p>
 </p>
 <table>
 <thead>
@@ -5095,67 +5298,98 @@ <h3 id="multicluster.agones.dev/v1.ClusterConnectionInfo">ClusterConnectionInfo
 <tbody>
 <tr>
 <td>
-<code>clusterName</code></br>
+<code>disabled</code></br>
 <em>
-string
+bool
 </em>
 </td>
 <td>
-<p>Optional: the name of the targeted cluster</p>
+<p>Disabled is whether health checking is disabled or not</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>allocationEndpoints</code></br>
+<code>periodSeconds</code></br>
 <em>
-[]string
+int32
 </em>
 </td>
 <td>
-<p>The endpoints for the allocator service in the targeted cluster.
-If the AllocationEndpoints is not set, the allocation happens on local cluster.
-If there are multiple endpoints any of the endpoints that can handle allocation request should suffice</p>
+<p>PeriodSeconds is the number of seconds each health ping has to occur in</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>secretName</code></br>
+<code>failureThreshold</code></br>
 <em>
-string
+int32
 </em>
 </td>
 <td>
-<p>The name of the secret that contains TLS client certificates to connect the allocator server in the targeted cluster</p>
+<p>FailureThreshold how many failures in a row constitutes unhealthy</p>
+</td>
+</tr>
+<tr>
+<td>
+<code>initialDelaySeconds</code></br>
+<em>
+int32
+</em>
+</td>
+<td>
+<p>InitialDelaySeconds initial delay before checking health</p>
 </td>
 </tr>
+</tbody>
+</table>
+<h3 id="agones.dev/v1.ListStatus">ListStatus
+</h3>
+<p>
+(<em>Appears on:</em>
+<a href="#agones.dev/v1.GameServerSpec">GameServerSpec</a>, 
+<a href="#agones.dev/v1.GameServerStatus">GameServerStatus</a>)
+</p>
+<p>
+<p>ListStatus stores the current list values</p>
+</p>
+<table>
+<thead>
+<tr>
+<th>Field</th>
+<th>Description</th>
+</tr>
+</thead>
+<tbody>
 <tr>
 <td>
-<code>namespace</code></br>
+<code>capacity</code></br>
 <em>
-string
+int64
 </em>
 </td>
 <td>
-<p>The cluster namespace from which to allocate gameservers</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>serverCa</code></br>
+<code>values</code></br>
 <em>
-[]byte
+[]string
 </em>
 </td>
 <td>
-<p>The PEM encoded server CA, used by the allocator client to authenticate the remote server.</p>
 </td>
 </tr>
 </tbody>
 </table>
-<h3 id="multicluster.agones.dev/v1.ConnectionInfoIterator">ConnectionInfoIterator
+<h3 id="agones.dev/v1.PlayerStatus">PlayerStatus
 </h3>
 <p>
-<p>ConnectionInfoIterator an iterator on ClusterConnectionInfo</p>
+(<em>Appears on:</em>
+<a href="#agones.dev/v1.GameServerStatus">GameServerStatus</a>)
+</p>
+<p>
+<p>PlayerStatus stores the current player capacity values</p>
 </p>
 <table>
 <thead>
@@ -5167,58 +5401,82 @@ <h3 id="multicluster.agones.dev/v1.ConnectionInfoIterator">ConnectionInfoIterato
 <tbody>
 <tr>
 <td>
-<code>currPriority</code></br>
+<code>count</code></br>
 <em>
-int
+int64
 </em>
 </td>
 <td>
-<p>currPriority Current priority index from the orderedPriorities</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>orderedPriorities</code></br>
+<code>capacity</code></br>
 <em>
-[]int32
+int64
 </em>
 </td>
 <td>
-<p>orderedPriorities list of ordered priorities</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>priorityToCluster</code></br>
+<code>ids</code></br>
 <em>
-map[int32]map[string][]*agones.dev/agones/pkg/apis/multicluster/v1.GameServerAllocationPolicy
+[]string
 </em>
 </td>
 <td>
-<p>priorityToCluster Map of priority to cluster-policies map</p>
 </td>
 </tr>
+</tbody>
+</table>
+<h3 id="agones.dev/v1.PlayersSpec">PlayersSpec
+</h3>
+<p>
+(<em>Appears on:</em>
+<a href="#agones.dev/v1.GameServerSpec">GameServerSpec</a>)
+</p>
+<p>
+<p>PlayersSpec tracks the initial player capacity</p>
+</p>
+<table>
+<thead>
+<tr>
+<th>Field</th>
+<th>Description</th>
+</tr>
+</thead>
+<tbody>
 <tr>
 <td>
-<code>clusterBlackList</code></br>
+<code>initialCapacity</code></br>
 <em>
-map[string]bool
+int64
 </em>
 </td>
 <td>
-<p>clusterBlackList the cluster blacklist for the clusters that has already returned</p>
 </td>
 </tr>
 </tbody>
 </table>
-<h3 id="multicluster.agones.dev/v1.GameServerAllocationPolicySpec">GameServerAllocationPolicySpec
+<h3 id="agones.dev/v1.PortPolicy">PortPolicy
+(<code>string</code> alias)</p></h3>
+<p>
+(<em>Appears on:</em>
+<a href="#agones.dev/v1.GameServerPort">GameServerPort</a>)
+</p>
+<p>
+<p>PortPolicy is the port policy for the GameServer</p>
+</p>
+<h3 id="agones.dev/v1.SdkServer">SdkServer
 </h3>
 <p>
 (<em>Appears on:</em>
-<a href="#multicluster.agones.dev/v1.GameServerAllocationPolicy">GameServerAllocationPolicy</a>)
+<a href="#agones.dev/v1.GameServerSpec">GameServerSpec</a>)
 </p>
 <p>
-<p>GameServerAllocationPolicySpec defines the desired state of GameServerAllocationPolicy</p>
+<p>SdkServer specifies parameters for the Agones SDK Server sidecar container</p>
 </p>
 <table>
 <thead>
@@ -5230,55 +5488,64 @@ <h3 id="multicluster.agones.dev/v1.GameServerAllocationPolicySpec">GameServerAll
 <tbody>
 <tr>
 <td>
-<code>priority</code></br>
+<code>logLevel</code></br>
 <em>
-int32
+<a href="#agones.dev/v1.SdkServerLogLevel">
+SdkServerLogLevel
+</a>
 </em>
 </td>
 <td>
+<p>LogLevel for SDK server (sidecar) logs. Defaults to &ldquo;Info&rdquo;</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>weight</code></br>
+<code>grpcPort</code></br>
 <em>
-int
+int32
 </em>
 </td>
 <td>
+<p>GRPCPort is the port on which the SDK Server binds the gRPC server to accept incoming connections</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>connectionInfo</code></br>
+<code>httpPort</code></br>
 <em>
-<a href="#multicluster.agones.dev/v1.ClusterConnectionInfo">
-ClusterConnectionInfo
-</a>
+int32
 </em>
 </td>
 <td>
+<p>HTTPPort is the port on which the SDK Server binds the HTTP gRPC gateway server to accept incoming connections</p>
 </td>
 </tr>
 </tbody>
 </table>
+<h3 id="agones.dev/v1.SdkServerLogLevel">SdkServerLogLevel
+(<code>string</code> alias)</p></h3>
+<p>
+(<em>Appears on:</em>
+<a href="#agones.dev/v1.SdkServer">SdkServer</a>)
+</p>
+<p>
+<p>SdkServerLogLevel is the log level for SDK server (sidecar) logs</p>
+</p>
 <hr/>
-<h2 id="agones.dev/v1">agones.dev/v1</h2>
+<h2 id="allocation.agones.dev/v1">allocation.agones.dev/v1</h2>
 <p>
 <p>Package v1 is the v1 version of the API.</p>
 </p>
 Resource Types:
 <ul><li>
-<a href="#agones.dev/v1.Fleet">Fleet</a>
-</li><li>
-<a href="#agones.dev/v1.GameServer">GameServer</a>
-</li><li>
-<a href="#agones.dev/v1.GameServerSet">GameServerSet</a>
+<a href="#allocation.agones.dev/v1.GameServerAllocation">GameServerAllocation</a>
 </li></ul>
-<h3 id="agones.dev/v1.Fleet">Fleet
+<h3 id="allocation.agones.dev/v1.GameServerAllocation">GameServerAllocation
 </h3>
 <p>
-<p>Fleet is the data structure for a Fleet resource</p>
+<p>GameServerAllocation is the data structure for allocating against a set of
+GameServers, defined <code>selectors</code> selectors</p>
 </p>
 <table>
 <thead>
@@ -5294,7 +5561,7 @@ <h3 id="agones.dev/v1.Fleet">Fleet
 string</td>
 <td>
 <code>
-agones.dev/v1
+allocation.agones.dev/v1
 </code>
 </td>
 </tr>
@@ -5303,7 +5570,7 @@ <h3 id="agones.dev/v1.Fleet">Fleet
 <code>kind</code></br>
 string
 </td>
-<td><code>Fleet</code></td>
+<td><code>GameServerAllocation</code></td>
 </tr>
 <tr>
 <td>
@@ -5323,8 +5590,8 @@ <h3 id="agones.dev/v1.Fleet">Fleet
 <td>
 <code>spec</code></br>
 <em>
-<a href="#agones.dev/v1.FleetSpec">
-FleetSpec
+<a href="#allocation.agones.dev/v1.GameServerAllocationSpec">
+GameServerAllocationSpec
 </a>
 </em>
 </td>
@@ -5334,43 +5601,65 @@ <h3 id="agones.dev/v1.Fleet">Fleet
 <table>
 <tr>
 <td>
-<code>replicas</code></br>
+<code>multiClusterSetting</code></br>
 <em>
-int32
+<a href="#allocation.agones.dev/v1.MultiClusterSetting">
+MultiClusterSetting
+</a>
 </em>
 </td>
 <td>
-<p>Replicas are the number of GameServers that should be in this set. Defaults to 0.</p>
+<p>MultiClusterPolicySelector if specified, multi-cluster policies are applied.
+Otherwise, allocation will happen locally.</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>allocationOverflow</code></br>
+<code>required</code></br>
 <em>
-<a href="#agones.dev/v1.AllocationOverflow">
-AllocationOverflow
+<a href="#allocation.agones.dev/v1.GameServerSelector">
+GameServerSelector
 </a>
 </em>
 </td>
 <td>
-<em>(Optional)</em>
-<p>[Stage: Alpha]
-[FeatureFlag:FleetAllocationOverflow]
-Labels and Annotations to apply to GameServers when the number of Allocated GameServers drops below
-the desired replicas on the underlying <code>GameServerSet</code></p>
+<p>Deprecated: use field Selectors instead. If Selectors is set, this field is ignored.
+Required is the GameServer selector from which to choose GameServers from.
+Defaults to all GameServers.</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>strategy</code></br>
+<code>preferred</code></br>
 <em>
-<a href="https://v1-25.docs.kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#deploymentstrategy-v1-apps">
-Kubernetes apps/v1.DeploymentStrategy
+<a href="#allocation.agones.dev/v1.GameServerSelector">
+[]GameServerSelector
 </a>
 </em>
 </td>
 <td>
-<p>Deployment strategy</p>
+<p>Deprecated: use field Selectors instead. If Selectors is set, this field is ignored.
+Preferred is an ordered list of preferred GameServer selectors
+that are optional to be fulfilled, but will be searched before the <code>required</code> selector.
+If the first selector is not matched, the selection attempts the second selector, and so on.
+If any of the preferred selectors are matched, the required selector is not considered.
+This is useful for things like smoke testing of new game servers.</p>
+</td>
+</tr>
+<tr>
+<td>
+<code>selectors</code></br>
+<em>
+<a href="#allocation.agones.dev/v1.GameServerSelector">
+[]GameServerSelector
+</a>
+</em>
+</td>
+<td>
+<p>Ordered list of GameServer label selectors.
+If the first selector is not matched, the selection attempts the second selector, and so on.
+This is useful for things like smoke testing of new game servers.
+Note: This field can only be set if neither Required or Preferred is set.</p>
 </td>
 </tr>
 <tr>
@@ -5386,15 +5675,16 @@ <h3 id="agones.dev/v1.Fleet">Fleet
 </tr>
 <tr>
 <td>
-<code>template</code></br>
+<code>metadata</code></br>
 <em>
-<a href="#agones.dev/v1.GameServerTemplateSpec">
-GameServerTemplateSpec
+<a href="#allocation.agones.dev/v1.MetaPatch">
+MetaPatch
 </a>
 </em>
 </td>
 <td>
-<p>Template the GameServer template to apply for this Fleet</p>
+<p>MetaPatch is optional custom metadata that is added to the game server at allocation
+You can use this to tell the server necessary session data</p>
 </td>
 </tr>
 </table>
@@ -5404,8 +5694,8 @@ <h3 id="agones.dev/v1.Fleet">Fleet
 <td>
 <code>status</code></br>
 <em>
-<a href="#agones.dev/v1.FleetStatus">
-FleetStatus
+<a href="#allocation.agones.dev/v1.GameServerAllocationStatus">
+GameServerAllocationStatus
 </a>
 </em>
 </td>
@@ -5414,14 +5704,15 @@ <h3 id="agones.dev/v1.Fleet">Fleet
 </tr>
 </tbody>
 </table>
-<h3 id="agones.dev/v1.GameServer">GameServer
+<h3 id="allocation.agones.dev/v1.CounterSelector">CounterSelector
 </h3>
 <p>
-<p>GameServer is the data structure for a GameServer resource.
-It is worth noting that while there is a <code>GameServerStatus</code> Status entry for the <code>GameServer</code>, it is not
-defined as a subresource - unlike <code>Fleet</code> and other Agones resources.
-This is so that we can retain the ability to change multiple aspects of a <code>GameServer</code> in a single atomic operation,
-which is particularly useful for operations such as allocation.</p>
+(<em>Appears on:</em>
+<a href="#allocation.agones.dev/v1.GameServerSelector">GameServerSelector</a>)
+</p>
+<p>
+<p>CounterSelector is the filter options for a GameServer based on the count and/or available capacity.
+0 for MaxCount or MaxAvailable means unlimited maximum. Default for all fields: 0</p>
 </p>
 <table>
 <thead>
@@ -5430,203 +5721,173 @@ <h3 id="agones.dev/v1.GameServer">GameServer
 <th>Description</th>
 </tr>
 </thead>
-<tbody>
-<tr>
-<td>
-<code>apiVersion</code></br>
-string</td>
-<td>
-<code>
-agones.dev/v1
-</code>
-</td>
-</tr>
-<tr>
-<td>
-<code>kind</code></br>
-string
-</td>
-<td><code>GameServer</code></td>
-</tr>
-<tr>
-<td>
-<code>metadata</code></br>
-<em>
-<a href="https://v1-25.docs.kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
-Kubernetes meta/v1.ObjectMeta
-</a>
-</em>
-</td>
-<td>
-Refer to the Kubernetes API documentation for the fields of the
-<code>metadata</code> field.
-</td>
-</tr>
-<tr>
-<td>
-<code>spec</code></br>
-<em>
-<a href="#agones.dev/v1.GameServerSpec">
-GameServerSpec
-</a>
-</em>
-</td>
-<td>
-<br/>
-<br/>
-<table>
-<tr>
-<td>
-<code>container</code></br>
-<em>
-string
-</em>
-</td>
-<td>
-<p>Container specifies which Pod container is the game server. Only required if there is more than one
-container defined</p>
-</td>
-</tr>
+<tbody>
 <tr>
 <td>
-<code>ports</code></br>
+<code>minCount</code></br>
 <em>
-<a href="#agones.dev/v1.GameServerPort">
-[]GameServerPort
-</a>
+int64
 </em>
 </td>
 <td>
-<p>Ports are the array of ports that can be exposed via the game server</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>health</code></br>
+<code>maxCount</code></br>
 <em>
-<a href="#agones.dev/v1.Health">
-Health
-</a>
+int64
 </em>
 </td>
 <td>
-<p>Health configures health checking</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>scheduling</code></br>
+<code>minAvailable</code></br>
 <em>
-agones.dev/agones/pkg/apis.SchedulingStrategy
+int64
 </em>
 </td>
 <td>
-<p>Scheduling strategy. Defaults to &ldquo;Packed&rdquo;</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>sdkServer</code></br>
+<code>maxAvailable</code></br>
 <em>
-<a href="#agones.dev/v1.SdkServer">
-SdkServer
-</a>
+int64
 </em>
 </td>
 <td>
-<p>SdkServer specifies parameters for the Agones SDK Server sidecar container</p>
 </td>
 </tr>
+</tbody>
+</table>
+<h3 id="allocation.agones.dev/v1.GameServerAllocationSpec">GameServerAllocationSpec
+</h3>
+<p>
+(<em>Appears on:</em>
+<a href="#allocation.agones.dev/v1.GameServerAllocation">GameServerAllocation</a>)
+</p>
+<p>
+<p>GameServerAllocationSpec is the spec for a GameServerAllocation</p>
+</p>
+<table>
+<thead>
+<tr>
+<th>Field</th>
+<th>Description</th>
+</tr>
+</thead>
+<tbody>
 <tr>
 <td>
-<code>template</code></br>
+<code>multiClusterSetting</code></br>
 <em>
-<a href="https://v1-25.docs.kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#podtemplatespec-v1-core">
-Kubernetes core/v1.PodTemplateSpec
+<a href="#allocation.agones.dev/v1.MultiClusterSetting">
+MultiClusterSetting
 </a>
 </em>
 </td>
 <td>
-<p>Template describes the Pod that will be created for the GameServer</p>
+<p>MultiClusterPolicySelector if specified, multi-cluster policies are applied.
+Otherwise, allocation will happen locally.</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>players</code></br>
+<code>required</code></br>
 <em>
-<a href="#agones.dev/v1.PlayersSpec">
-PlayersSpec
+<a href="#allocation.agones.dev/v1.GameServerSelector">
+GameServerSelector
 </a>
 </em>
 </td>
 <td>
-<em>(Optional)</em>
-<p>(Alpha, PlayerTracking feature flag) Players provides the configuration for player tracking features.</p>
+<p>Deprecated: use field Selectors instead. If Selectors is set, this field is ignored.
+Required is the GameServer selector from which to choose GameServers from.
+Defaults to all GameServers.</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>counters</code></br>
+<code>preferred</code></br>
 <em>
-<a href="#agones.dev/v1.CounterStatus">
-map[string]agones.dev/agones/pkg/apis/agones/v1.CounterStatus
+<a href="#allocation.agones.dev/v1.GameServerSelector">
+[]GameServerSelector
 </a>
 </em>
 </td>
 <td>
-<em>(Optional)</em>
-<p>(Alpha, CountsAndLists feature flag) Counters and Lists provides the configuration for generic tracking features.</p>
+<p>Deprecated: use field Selectors instead. If Selectors is set, this field is ignored.
+Preferred is an ordered list of preferred GameServer selectors
+that are optional to be fulfilled, but will be searched before the <code>required</code> selector.
+If the first selector is not matched, the selection attempts the second selector, and so on.
+If any of the preferred selectors are matched, the required selector is not considered.
+This is useful for things like smoke testing of new game servers.</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>lists</code></br>
+<code>selectors</code></br>
 <em>
-<a href="#agones.dev/v1.ListStatus">
-map[string]agones.dev/agones/pkg/apis/agones/v1.ListStatus
+<a href="#allocation.agones.dev/v1.GameServerSelector">
+[]GameServerSelector
 </a>
 </em>
 </td>
 <td>
+<p>Ordered list of GameServer label selectors.
+If the first selector is not matched, the selection attempts the second selector, and so on.
+This is useful for things like smoke testing of new game servers.
+Note: This field can only be set if neither Required or Preferred is set.</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>eviction</code></br>
+<code>scheduling</code></br>
 <em>
-<a href="#agones.dev/v1.Eviction">
-Eviction
-</a>
+agones.dev/agones/pkg/apis.SchedulingStrategy
 </em>
 </td>
 <td>
-<em>(Optional)</em>
-<p>(Alpha, SafeToEvict feature flag) Eviction specifies the eviction tolerance of the GameServer. Defaults to &ldquo;Never&rdquo;.</p>
-</td>
-</tr>
-</table>
+<p>Scheduling strategy. Defaults to &ldquo;Packed&rdquo;.</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>status</code></br>
+<code>metadata</code></br>
 <em>
-<a href="#agones.dev/v1.GameServerStatus">
-GameServerStatus
+<a href="#allocation.agones.dev/v1.MetaPatch">
+MetaPatch
 </a>
 </em>
 </td>
 <td>
+<p>MetaPatch is optional custom metadata that is added to the game server at allocation
+You can use this to tell the server necessary session data</p>
 </td>
 </tr>
 </tbody>
 </table>
-<h3 id="agones.dev/v1.GameServerSet">GameServerSet
+<h3 id="allocation.agones.dev/v1.GameServerAllocationState">GameServerAllocationState
+(<code>string</code> alias)</p></h3>
+<p>
+(<em>Appears on:</em>
+<a href="#allocation.agones.dev/v1.GameServerAllocationStatus">GameServerAllocationStatus</a>)
+</p>
+<p>
+<p>GameServerAllocationState is the Allocation state</p>
+</p>
+<h3 id="allocation.agones.dev/v1.GameServerAllocationStatus">GameServerAllocationStatus
 </h3>
 <p>
-<p>GameServerSet is the data structure for a set of GameServers.
-This matches philosophically with the relationship between
-Deployments and ReplicaSets</p>
+(<em>Appears on:</em>
+<a href="#allocation.agones.dev/v1.GameServerAllocation">GameServerAllocation</a>)
+</p>
+<p>
+<p>GameServerAllocationStatus is the status for an GameServerAllocation resource</p>
 </p>
 <table>
 <thead>
@@ -5638,126 +5899,82 @@ <h3 id="agones.dev/v1.GameServerSet">GameServerSet
 <tbody>
 <tr>
 <td>
-<code>apiVersion</code></br>
-string</td>
-<td>
-<code>
-agones.dev/v1
-</code>
-</td>
-</tr>
-<tr>
-<td>
-<code>kind</code></br>
-string
-</td>
-<td><code>GameServerSet</code></td>
-</tr>
-<tr>
-<td>
-<code>metadata</code></br>
+<code>state</code></br>
 <em>
-<a href="https://v1-25.docs.kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
-Kubernetes meta/v1.ObjectMeta
+<a href="#allocation.agones.dev/v1.GameServerAllocationState">
+GameServerAllocationState
 </a>
 </em>
 </td>
 <td>
-Refer to the Kubernetes API documentation for the fields of the
-<code>metadata</code> field.
+<p>GameServerState is the current state of an GameServerAllocation, e.g. Allocated, or UnAllocated</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>spec</code></br>
-<em>
-<a href="#agones.dev/v1.GameServerSetSpec">
-GameServerSetSpec
-</a>
-</em>
-</td>
-<td>
-<br/>
-<br/>
-<table>
-<tr>
-<td>
-<code>replicas</code></br>
+<code>gameServerName</code></br>
 <em>
-int32
+string
 </em>
 </td>
 <td>
-<p>Replicas are the number of GameServers that should be in this set</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>allocationOverflow</code></br>
+<code>ports</code></br>
 <em>
-<a href="#agones.dev/v1.AllocationOverflow">
-AllocationOverflow
+<a href="#agones.dev/v1.GameServerStatusPort">
+[]GameServerStatusPort
 </a>
 </em>
 </td>
 <td>
-<em>(Optional)</em>
-<p>[Stage: Alpha]
-[FeatureFlag:FleetAllocationOverflow]
-Labels and Annotations to apply to GameServers when the number of Allocated GameServers drops below
-the desired replicas on the underlying <code>GameServerSet</code></p>
 </td>
 </tr>
 <tr>
 <td>
-<code>scheduling</code></br>
+<code>address</code></br>
 <em>
-agones.dev/agones/pkg/apis.SchedulingStrategy
+string
 </em>
 </td>
 <td>
-<p>Scheduling strategy. Defaults to &ldquo;Packed&rdquo;.</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>template</code></br>
+<code>nodeName</code></br>
 <em>
-<a href="#agones.dev/v1.GameServerTemplateSpec">
-GameServerTemplateSpec
-</a>
+string
 </em>
 </td>
 <td>
-<p>Template the GameServer template to apply for this GameServerSet</p>
-</td>
-</tr>
-</table>
 </td>
 </tr>
 <tr>
 <td>
-<code>status</code></br>
+<code>source</code></br>
 <em>
-<a href="#agones.dev/v1.GameServerSetStatus">
-GameServerSetStatus
-</a>
+string
 </em>
 </td>
 <td>
+<p>If the allocation is from a remote cluster, Source is the endpoint of the remote agones-allocator.
+Otherwise, Source is &ldquo;local&rdquo;</p>
 </td>
 </tr>
 </tbody>
 </table>
-<h3 id="agones.dev/v1.AggregatedPlayerStatus">AggregatedPlayerStatus
+<h3 id="allocation.agones.dev/v1.GameServerSelector">GameServerSelector
 </h3>
 <p>
 (<em>Appears on:</em>
-<a href="#agones.dev/v1.FleetStatus">FleetStatus</a>, 
-<a href="#agones.dev/v1.GameServerSetStatus">GameServerSetStatus</a>)
+<a href="#allocation.agones.dev/v1.GameServerAllocationSpec">GameServerAllocationSpec</a>)
 </p>
 <p>
-<p>AggregatedPlayerStatus stores total player tracking values</p>
+<p>GameServerSelector contains all the filter options for selecting
+a GameServer for allocation.</p>
 </p>
 <table>
 <thead>
@@ -5769,81 +5986,100 @@ <h3 id="agones.dev/v1.AggregatedPlayerStatus">AggregatedPlayerStatus
 <tbody>
 <tr>
 <td>
-<code>count</code></br>
+<code>LabelSelector</code></br>
 <em>
-int64
+<a href="https://v1-25.docs.kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#labelselector-v1-meta">
+Kubernetes meta/v1.LabelSelector
+</a>
 </em>
 </td>
 <td>
+<p>
+(Members of <code>LabelSelector</code> are embedded into this type.)
+</p>
+<p>See: <a href="https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/">https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/</a></p>
 </td>
 </tr>
 <tr>
 <td>
-<code>capacity</code></br>
+<code>gameServerState</code></br>
 <em>
-int64
+<a href="#agones.dev/v1.GameServerState">
+GameServerState
+</a>
 </em>
 </td>
 <td>
+<em>(Optional)</em>
+<p>[Stage:Beta]
+[FeatureFlag:StateAllocationFilter]
+GameServerState specifies which State is the filter to be used when attempting to retrieve a GameServer
+via Allocation. Defaults to &ldquo;Ready&rdquo;. The only other option is &ldquo;Allocated&rdquo;, which can be used in conjunction with
+label/annotation/player selectors to retrieve an already Allocated GameServer.</p>
 </td>
 </tr>
-</tbody>
-</table>
-<h3 id="agones.dev/v1.AllocationOverflow">AllocationOverflow
-</h3>
-<p>
-(<em>Appears on:</em>
-<a href="#agones.dev/v1.FleetSpec">FleetSpec</a>, 
-<a href="#agones.dev/v1.GameServerSetSpec">GameServerSetSpec</a>)
-</p>
-<p>
-<p>AllocationOverflow specifies what labels and/or annotations to apply on Allocated GameServers
-if the desired number of the underlying <code>GameServerSet</code> drops below the number of Allocated GameServers
-attached to it.</p>
-</p>
-<table>
-<thead>
-<tr>
-<th>Field</th>
-<th>Description</th>
+<tr>
+<td>
+<code>players</code></br>
+<em>
+<a href="#allocation.agones.dev/v1.PlayerSelector">
+PlayerSelector
+</a>
+</em>
+</td>
+<td>
+<em>(Optional)</em>
+<p>[Stage:Alpha]
+[FeatureFlag:PlayerAllocationFilter]
+Players provides a filter on minimum and maximum values for player capacity when retrieving a GameServer
+through Allocation. Defaults to no limits.</p>
+</td>
 </tr>
-</thead>
-<tbody>
 <tr>
 <td>
-<code>labels</code></br>
+<code>counters</code></br>
 <em>
-map[string]string
+<a href="#allocation.agones.dev/v1.CounterSelector">
+map[string]agones.dev/agones/pkg/apis/allocation/v1.CounterSelector
+</a>
 </em>
 </td>
 <td>
 <em>(Optional)</em>
-<p>Labels to be applied to the <code>GameServer</code></p>
+<p>(Alpha, CountsAndLists feature flag) Counters provides filters on minimum and maximum values
+for a Counter&rsquo;s count and available capacity when retrieving a GameServer through Allocation.
+Defaults to no limits.</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>annotations</code></br>
+<code>lists</code></br>
 <em>
-map[string]string
+<a href="#allocation.agones.dev/v1.ListSelector">
+map[string]agones.dev/agones/pkg/apis/allocation/v1.ListSelector
+</a>
 </em>
 </td>
 <td>
 <em>(Optional)</em>
-<p>Annotations to be applied to the <code>GameServer</code></p>
+<p>(Alpha, CountsAndLists feature flag) Lists provides filters on minimum and maximum values
+for List capacity, and for the existence of a value in a List, when retrieving a GameServer
+through Allocation. Defaults to no limits.</p>
 </td>
 </tr>
 </tbody>
 </table>
-<h3 id="agones.dev/v1.CounterStatus">CounterStatus
+<h3 id="allocation.agones.dev/v1.ListSelector">ListSelector
 </h3>
 <p>
 (<em>Appears on:</em>
-<a href="#agones.dev/v1.GameServerSpec">GameServerSpec</a>, 
-<a href="#agones.dev/v1.GameServerStatus">GameServerStatus</a>)
+<a href="#allocation.agones.dev/v1.GameServerSelector">GameServerSelector</a>)
 </p>
 <p>
-<p>CounterStatus stores the current counter values</p>
+<p>ListSelector is the filter options for a GameServer based on List available capacity and/or the
+existence of a value in a List.
+0 for MaxAvailable means unlimited maximum. Default for integer fields: 0
+&ldquo;&rdquo; for ContainsValue means ignore field. Default for string field: &ldquo;&rdquo;</p>
 </p>
 <table>
 <thead>
@@ -5855,9 +6091,9 @@ <h3 id="agones.dev/v1.CounterStatus">CounterStatus
 <tbody>
 <tr>
 <td>
-<code>count</code></br>
+<code>containsValue</code></br>
 <em>
-int64
+string
 </em>
 </td>
 <td>
@@ -5865,7 +6101,7 @@ <h3 id="agones.dev/v1.CounterStatus">CounterStatus
 </tr>
 <tr>
 <td>
-<code>capacity</code></br>
+<code>minAvailable</code></br>
 <em>
 int64
 </em>
@@ -5873,62 +6109,26 @@ <h3 id="agones.dev/v1.CounterStatus">CounterStatus
 <td>
 </td>
 </tr>
-</tbody>
-</table>
-<h3 id="agones.dev/v1.Eviction">Eviction
-</h3>
-<p>
-(<em>Appears on:</em>
-<a href="#agones.dev/v1.GameServerSpec">GameServerSpec</a>, 
-<a href="#agones.dev/v1.GameServerStatus">GameServerStatus</a>)
-</p>
-<p>
-<p>Eviction specifies the eviction tolerance of the GameServer</p>
-</p>
-<table>
-<thead>
-<tr>
-<th>Field</th>
-<th>Description</th>
-</tr>
-</thead>
-<tbody>
 <tr>
 <td>
-<code>safe</code></br>
+<code>maxAvailable</code></br>
 <em>
-<a href="#agones.dev/v1.EvictionSafe">
-EvictionSafe
-</a>
+int64
 </em>
 </td>
 <td>
-<p>(Alpha, SafeToEvict feature flag)
-Game server supports termination via SIGTERM:
-- Always: Allow eviction for both Cluster Autoscaler and node drain for upgrades
-- OnUpgrade: Allow eviction for upgrades alone
-- Never (default): Pod should run to completion</p>
 </td>
 </tr>
 </tbody>
 </table>
-<h3 id="agones.dev/v1.EvictionSafe">EvictionSafe
-(<code>string</code> alias)</p></h3>
-<p>
-(<em>Appears on:</em>
-<a href="#agones.dev/v1.Eviction">Eviction</a>)
-</p>
-<p>
-<p>EvictionSafe specified whether the game server supports termination via SIGTERM</p>
-</p>
-<h3 id="agones.dev/v1.FleetSpec">FleetSpec
+<h3 id="allocation.agones.dev/v1.MetaPatch">MetaPatch
 </h3>
 <p>
 (<em>Appears on:</em>
-<a href="#agones.dev/v1.Fleet">Fleet</a>)
+<a href="#allocation.agones.dev/v1.GameServerAllocationSpec">GameServerAllocationSpec</a>)
 </p>
 <p>
-<p>FleetSpec is the spec for a Fleet</p>
+<p>MetaPatch is the metadata used to patch the GameServer metadata on allocation</p>
 </p>
 <table>
 <thead>
@@ -5940,80 +6140,75 @@ <h3 id="agones.dev/v1.FleetSpec">FleetSpec
 <tbody>
 <tr>
 <td>
-<code>replicas</code></br>
+<code>labels</code></br>
 <em>
-int32
+map[string]string
 </em>
 </td>
 <td>
-<p>Replicas are the number of GameServers that should be in this set. Defaults to 0.</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>allocationOverflow</code></br>
+<code>annotations</code></br>
 <em>
-<a href="#agones.dev/v1.AllocationOverflow">
-AllocationOverflow
-</a>
+map[string]string
 </em>
 </td>
 <td>
-<em>(Optional)</em>
-<p>[Stage: Alpha]
-[FeatureFlag:FleetAllocationOverflow]
-Labels and Annotations to apply to GameServers when the number of Allocated GameServers drops below
-the desired replicas on the underlying <code>GameServerSet</code></p>
 </td>
 </tr>
+</tbody>
+</table>
+<h3 id="allocation.agones.dev/v1.MultiClusterSetting">MultiClusterSetting
+</h3>
+<p>
+(<em>Appears on:</em>
+<a href="#allocation.agones.dev/v1.GameServerAllocationSpec">GameServerAllocationSpec</a>)
+</p>
+<p>
+<p>MultiClusterSetting specifies settings for multi-cluster allocation.</p>
+</p>
+<table>
+<thead>
 <tr>
-<td>
-<code>strategy</code></br>
-<em>
-<a href="https://v1-25.docs.kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#deploymentstrategy-v1-apps">
-Kubernetes apps/v1.DeploymentStrategy
-</a>
-</em>
-</td>
-<td>
-<p>Deployment strategy</p>
-</td>
+<th>Field</th>
+<th>Description</th>
 </tr>
+</thead>
+<tbody>
 <tr>
 <td>
-<code>scheduling</code></br>
+<code>enabled</code></br>
 <em>
-agones.dev/agones/pkg/apis.SchedulingStrategy
+bool
 </em>
 </td>
 <td>
-<p>Scheduling strategy. Defaults to &ldquo;Packed&rdquo;.</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>template</code></br>
+<code>policySelector</code></br>
 <em>
-<a href="#agones.dev/v1.GameServerTemplateSpec">
-GameServerTemplateSpec
+<a href="https://v1-25.docs.kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#labelselector-v1-meta">
+Kubernetes meta/v1.LabelSelector
 </a>
 </em>
 </td>
 <td>
-<p>Template the GameServer template to apply for this Fleet</p>
 </td>
 </tr>
 </tbody>
 </table>
-<h3 id="agones.dev/v1.FleetStatus">FleetStatus
+<h3 id="allocation.agones.dev/v1.PlayerSelector">PlayerSelector
 </h3>
 <p>
 (<em>Appears on:</em>
-<a href="#agones.dev/v1.Fleet">Fleet</a>, 
-<a href="#autoscaling.agones.dev/v1.FleetAutoscaleRequest">FleetAutoscaleRequest</a>)
+<a href="#allocation.agones.dev/v1.GameServerSelector">GameServerSelector</a>)
 </p>
 <p>
-<p>FleetStatus is the status of a Fleet</p>
+<p>PlayerSelector is the filter options for a GameServer based on player counts</p>
 </p>
 <table>
 <thead>
@@ -6025,76 +6220,39 @@ <h3 id="agones.dev/v1.FleetStatus">FleetStatus
 <tbody>
 <tr>
 <td>
-<code>replicas</code></br>
-<em>
-int32
-</em>
-</td>
-<td>
-<p>Replicas the total number of current GameServer replicas</p>
-</td>
-</tr>
-<tr>
-<td>
-<code>readyReplicas</code></br>
-<em>
-int32
-</em>
-</td>
-<td>
-<p>ReadyReplicas are the number of Ready GameServer replicas</p>
-</td>
-</tr>
-<tr>
-<td>
-<code>reservedReplicas</code></br>
-<em>
-int32
-</em>
-</td>
-<td>
-<p>ReservedReplicas are the total number of Reserved GameServer replicas in this fleet.
-Reserved instances won&rsquo;t be deleted on scale down, but won&rsquo;t cause an autoscaler to scale up.</p>
-</td>
-</tr>
-<tr>
-<td>
-<code>allocatedReplicas</code></br>
+<code>minAvailable</code></br>
 <em>
-int32
+int64
 </em>
 </td>
 <td>
-<p>AllocatedReplicas are the number of Allocated GameServer replicas</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>players</code></br>
+<code>maxAvailable</code></br>
 <em>
-<a href="#agones.dev/v1.AggregatedPlayerStatus">
-AggregatedPlayerStatus
-</a>
+int64
 </em>
 </td>
 <td>
-<em>(Optional)</em>
-<p>[Stage:Alpha]
-[FeatureFlag:PlayerTracking]
-Players are the current total player capacity and count for this Fleet</p>
 </td>
 </tr>
 </tbody>
 </table>
-<h3 id="agones.dev/v1.GameServerPort">GameServerPort
-</h3>
+<hr/>
+<h2 id="autoscaling.agones.dev/v1">autoscaling.agones.dev/v1</h2>
 <p>
-(<em>Appears on:</em>
-<a href="#agones.dev/v1.GameServerSpec">GameServerSpec</a>)
+<p>Package v1 is the v1 version of the API.</p>
 </p>
+Resource Types:
+<ul><li>
+<a href="#autoscaling.agones.dev/v1.FleetAutoscaler">FleetAutoscaler</a>
+</li></ul>
+<h3 id="autoscaling.agones.dev/v1.FleetAutoscaler">FleetAutoscaler
+</h3>
 <p>
-<p>GameServerPort defines a set of Ports that
-are to be exposed via the GameServer</p>
+<p>FleetAutoscaler is the data structure for a FleetAutoscaler resource</p>
 </p>
 <table>
 <thead>
@@ -6106,89 +6264,112 @@ <h3 id="agones.dev/v1.GameServerPort">GameServerPort
 <tbody>
 <tr>
 <td>
-<code>name</code></br>
-<em>
+<code>apiVersion</code></br>
+string</td>
+<td>
+<code>
+autoscaling.agones.dev/v1
+</code>
+</td>
+</tr>
+<tr>
+<td>
+<code>kind</code></br>
 string
+</td>
+<td><code>FleetAutoscaler</code></td>
+</tr>
+<tr>
+<td>
+<code>metadata</code></br>
+<em>
+<a href="https://v1-25.docs.kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
+Kubernetes meta/v1.ObjectMeta
+</a>
 </em>
 </td>
 <td>
-<p>Name is the descriptive name of the port</p>
+Refer to the Kubernetes API documentation for the fields of the
+<code>metadata</code> field.
 </td>
 </tr>
 <tr>
 <td>
-<code>portPolicy</code></br>
+<code>spec</code></br>
 <em>
-<a href="#agones.dev/v1.PortPolicy">
-PortPolicy
+<a href="#autoscaling.agones.dev/v1.FleetAutoscalerSpec">
+FleetAutoscalerSpec
 </a>
 </em>
 </td>
 <td>
-<p>PortPolicy defines the policy for how the HostPort is populated.
-Dynamic port will allocate a HostPort within the selected MIN_PORT and MAX_PORT range passed to the controller
-at installation time.
-When <code>Static</code> portPolicy is specified, <code>HostPort</code> is required, to specify the port that game clients will
-connect to</p>
-</td>
-</tr>
+<br/>
+<br/>
+<table>
 <tr>
 <td>
-<code>container</code></br>
+<code>fleetName</code></br>
 <em>
 string
 </em>
 </td>
 <td>
-<em>(Optional)</em>
-<p>Container is the name of the container on which to open the port. Defaults to the game server container.</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>containerPort</code></br>
+<code>policy</code></br>
 <em>
-int32
+<a href="#autoscaling.agones.dev/v1.FleetAutoscalerPolicy">
+FleetAutoscalerPolicy
+</a>
 </em>
 </td>
 <td>
-<p>ContainerPort is the port that is being opened on the specified container&rsquo;s process</p>
+<p>Autoscaling policy</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>hostPort</code></br>
+<code>sync</code></br>
 <em>
-int32
+<a href="#autoscaling.agones.dev/v1.FleetAutoscalerSync">
+FleetAutoscalerSync
+</a>
 </em>
 </td>
 <td>
-<p>HostPort the port exposed on the host for clients to connect to</p>
+<em>(Optional)</em>
+<p>[Stage:Beta]
+[FeatureFlag:CustomFasSyncInterval]
+Sync defines when FleetAutoscalers runs autoscaling</p>
+</td>
+</tr>
+</table>
 </td>
 </tr>
 <tr>
 <td>
-<code>protocol</code></br>
+<code>status</code></br>
 <em>
-<a href="https://v1-25.docs.kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#protocol-v1-core">
-Kubernetes core/v1.Protocol
+<a href="#autoscaling.agones.dev/v1.FleetAutoscalerStatus">
+FleetAutoscalerStatus
 </a>
 </em>
 </td>
 <td>
-<p>Protocol is the network protocol being used. Defaults to UDP. TCP and TCPUDP are other options.</p>
 </td>
 </tr>
 </tbody>
 </table>
-<h3 id="agones.dev/v1.GameServerSetSpec">GameServerSetSpec
+<h3 id="autoscaling.agones.dev/v1.BufferPolicy">BufferPolicy
 </h3>
 <p>
 (<em>Appears on:</em>
-<a href="#agones.dev/v1.GameServerSet">GameServerSet</a>)
+<a href="#autoscaling.agones.dev/v1.FleetAutoscalerPolicy">FleetAutoscalerPolicy</a>)
 </p>
 <p>
-<p>GameServerSetSpec the specification for GameServerSet</p>
+<p>BufferPolicy controls the desired behavior of the buffer policy.</p>
 </p>
 <table>
 <thead>
@@ -6200,66 +6381,59 @@ <h3 id="agones.dev/v1.GameServerSetSpec">GameServerSetSpec
 <tbody>
 <tr>
 <td>
-<code>replicas</code></br>
+<code>maxReplicas</code></br>
 <em>
 int32
 </em>
 </td>
 <td>
-<p>Replicas are the number of GameServers that should be in this set</p>
-</td>
-</tr>
-<tr>
-<td>
-<code>allocationOverflow</code></br>
-<em>
-<a href="#agones.dev/v1.AllocationOverflow">
-AllocationOverflow
-</a>
-</em>
-</td>
-<td>
-<em>(Optional)</em>
-<p>[Stage: Alpha]
-[FeatureFlag:FleetAllocationOverflow]
-Labels and Annotations to apply to GameServers when the number of Allocated GameServers drops below
-the desired replicas on the underlying <code>GameServerSet</code></p>
+<p>MaxReplicas is the maximum amount of replicas that the fleet may have.
+It must be bigger than both MinReplicas and BufferSize</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>scheduling</code></br>
+<code>minReplicas</code></br>
 <em>
-agones.dev/agones/pkg/apis.SchedulingStrategy
+int32
 </em>
 </td>
 <td>
-<p>Scheduling strategy. Defaults to &ldquo;Packed&rdquo;.</p>
+<p>MinReplicas is the minimum amount of replicas that the fleet must have
+If zero, it is ignored.
+If non zero, it must be smaller than MaxReplicas and bigger than BufferSize</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>template</code></br>
+<code>bufferSize</code></br>
 <em>
-<a href="#agones.dev/v1.GameServerTemplateSpec">
-GameServerTemplateSpec
-</a>
+k8s.io/apimachinery/pkg/util/intstr.IntOrString
 </em>
 </td>
 <td>
-<p>Template the GameServer template to apply for this GameServerSet</p>
+<p>BufferSize defines how many replicas the autoscaler tries to have ready all the time
+Value can be an absolute number (ex: 5) or a percentage of desired gs instances (ex: 15%)
+Absolute number is calculated from percentage by rounding up.
+Example: when this is set to 20%, the autoscaler will make sure that 20%
+of the fleet&rsquo;s game server replicas are ready. When this is set to 20,
+the autoscaler will make sure that there are 20 available game servers
+Must be bigger than 0
+Note: by &ldquo;ready&rdquo; we understand in this case &ldquo;non-allocated&rdquo;; this is done to ensure robustness
+and computation stability in different edge case (fleet just created, not enough
+capacity in the cluster etc)</p>
 </td>
 </tr>
 </tbody>
 </table>
-<h3 id="agones.dev/v1.GameServerSetStatus">GameServerSetStatus
+<h3 id="autoscaling.agones.dev/v1.FixedIntervalSync">FixedIntervalSync
 </h3>
 <p>
 (<em>Appears on:</em>
-<a href="#agones.dev/v1.GameServerSet">GameServerSet</a>)
+<a href="#autoscaling.agones.dev/v1.FleetAutoscalerSync">FleetAutoscalerSync</a>)
 </p>
 <p>
-<p>GameServerSetStatus is the status of a GameServerSet</p>
+<p>FixedIntervalSync controls the desired behavior of the fixed interval based sync.</p>
 </p>
 <table>
 <thead>
@@ -6271,86 +6445,93 @@ <h3 id="agones.dev/v1.GameServerSetStatus">GameServerSetStatus
 <tbody>
 <tr>
 <td>
-<code>replicas</code></br>
+<code>seconds</code></br>
 <em>
 int32
 </em>
 </td>
 <td>
-<p>Replicas is the total number of current GameServer replicas</p>
+<p>Seconds defines how often we run fleet autoscaling in seconds</p>
 </td>
 </tr>
+</tbody>
+</table>
+<h3 id="autoscaling.agones.dev/v1.FleetAutoscaleRequest">FleetAutoscaleRequest
+</h3>
+<p>
+(<em>Appears on:</em>
+<a href="#autoscaling.agones.dev/v1.FleetAutoscaleReview">FleetAutoscaleReview</a>)
+</p>
+<p>
+<p>FleetAutoscaleRequest defines the request to webhook autoscaler endpoint</p>
+</p>
+<table>
+<thead>
 <tr>
-<td>
-<code>readyReplicas</code></br>
-<em>
-int32
-</em>
-</td>
-<td>
-<p>ReadyReplicas is the number of Ready GameServer replicas</p>
-</td>
+<th>Field</th>
+<th>Description</th>
 </tr>
+</thead>
+<tbody>
 <tr>
 <td>
-<code>reservedReplicas</code></br>
+<code>uid</code></br>
 <em>
-int32
+k8s.io/apimachinery/pkg/types.UID
 </em>
 </td>
 <td>
-<p>ReservedReplicas is the number of Reserved GameServer replicas</p>
+<p>UID is an identifier for the individual request/response. It allows us to distinguish instances of requests which are
+otherwise identical (parallel requests, requests when earlier requests did not modify etc)
+The UID is meant to track the round trip (request/response) between the Autoscaler and the WebHook, not the user request.
+It is suitable for correlating log entries between the webhook and apiserver, for either auditing or debugging.</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>allocatedReplicas</code></br>
+<code>name</code></br>
 <em>
-int32
+string
 </em>
 </td>
 <td>
-<p>AllocatedReplicas is the number of Allocated GameServer replicas</p>
+<p>Name is the name of the Fleet being scaled</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>shutdownReplicas</code></br>
+<code>namespace</code></br>
 <em>
-int32
+string
 </em>
 </td>
 <td>
-<p>ShutdownReplicas is the number of Shutdown GameServers replicas</p>
+<p>Namespace is the namespace associated with the request (if any).</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>players</code></br>
+<code>status</code></br>
 <em>
-<a href="#agones.dev/v1.AggregatedPlayerStatus">
-AggregatedPlayerStatus
+<a href="#agones.dev/v1.FleetStatus">
+FleetStatus
 </a>
 </em>
 </td>
 <td>
-<em>(Optional)</em>
-<p>[Stage:Alpha]
-[FeatureFlag:PlayerTracking]
-Players is the current total player capacity and count for this GameServerSet</p>
+<p>The Fleet&rsquo;s status values</p>
 </td>
 </tr>
 </tbody>
 </table>
-<h3 id="agones.dev/v1.GameServerSpec">GameServerSpec
+<h3 id="autoscaling.agones.dev/v1.FleetAutoscaleResponse">FleetAutoscaleResponse
 </h3>
 <p>
 (<em>Appears on:</em>
-<a href="#agones.dev/v1.GameServer">GameServer</a>, 
-<a href="#agones.dev/v1.GameServerTemplateSpec">GameServerTemplateSpec</a>)
+<a href="#autoscaling.agones.dev/v1.FleetAutoscaleReview">FleetAutoscaleReview</a>)
 </p>
 <p>
-<p>GameServerSpec is the spec for a GameServer resource</p>
+<p>FleetAutoscaleResponse defines the response of webhook autoscaler endpoint</p>
 </p>
 <table>
 <thead>
@@ -6362,153 +6543,158 @@ <h3 id="agones.dev/v1.GameServerSpec">GameServerSpec
 <tbody>
 <tr>
 <td>
-<code>container</code></br>
+<code>uid</code></br>
 <em>
-string
+k8s.io/apimachinery/pkg/types.UID
 </em>
 </td>
 <td>
-<p>Container specifies which Pod container is the game server. Only required if there is more than one
-container defined</p>
+<p>UID is an identifier for the individual request/response.
+This should be copied over from the corresponding FleetAutoscaleRequest.</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>ports</code></br>
+<code>scale</code></br>
 <em>
-<a href="#agones.dev/v1.GameServerPort">
-[]GameServerPort
-</a>
+bool
 </em>
 </td>
 <td>
-<p>Ports are the array of ports that can be exposed via the game server</p>
+<p>Set to false if no scaling should occur to the Fleet</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>health</code></br>
+<code>replicas</code></br>
 <em>
-<a href="#agones.dev/v1.Health">
-Health
-</a>
+int32
 </em>
 </td>
 <td>
-<p>Health configures health checking</p>
+<p>The targeted replica count</p>
 </td>
 </tr>
+</tbody>
+</table>
+<h3 id="autoscaling.agones.dev/v1.FleetAutoscaleReview">FleetAutoscaleReview
+</h3>
+<p>
+<p>FleetAutoscaleReview is passed to the webhook with a populated Request value,
+and then returned with a populated Response.</p>
+</p>
+<table>
+<thead>
 <tr>
-<td>
-<code>scheduling</code></br>
-<em>
-agones.dev/agones/pkg/apis.SchedulingStrategy
-</em>
-</td>
-<td>
-<p>Scheduling strategy. Defaults to &ldquo;Packed&rdquo;</p>
-</td>
+<th>Field</th>
+<th>Description</th>
 </tr>
+</thead>
+<tbody>
 <tr>
 <td>
-<code>sdkServer</code></br>
+<code>request</code></br>
 <em>
-<a href="#agones.dev/v1.SdkServer">
-SdkServer
+<a href="#autoscaling.agones.dev/v1.FleetAutoscaleRequest">
+FleetAutoscaleRequest
 </a>
 </em>
 </td>
 <td>
-<p>SdkServer specifies parameters for the Agones SDK Server sidecar container</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>template</code></br>
+<code>response</code></br>
 <em>
-<a href="https://v1-25.docs.kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#podtemplatespec-v1-core">
-Kubernetes core/v1.PodTemplateSpec
+<a href="#autoscaling.agones.dev/v1.FleetAutoscaleResponse">
+FleetAutoscaleResponse
 </a>
 </em>
 </td>
 <td>
-<p>Template describes the Pod that will be created for the GameServer</p>
 </td>
 </tr>
-<tr>
-<td>
-<code>players</code></br>
-<em>
-<a href="#agones.dev/v1.PlayersSpec">
-PlayersSpec
-</a>
-</em>
-</td>
-<td>
-<em>(Optional)</em>
-<p>(Alpha, PlayerTracking feature flag) Players provides the configuration for player tracking features.</p>
-</td>
+</tbody>
+</table>
+<h3 id="autoscaling.agones.dev/v1.FleetAutoscalerPolicy">FleetAutoscalerPolicy
+</h3>
+<p>
+(<em>Appears on:</em>
+<a href="#autoscaling.agones.dev/v1.FleetAutoscalerSpec">FleetAutoscalerSpec</a>)
+</p>
+<p>
+<p>FleetAutoscalerPolicy describes how to scale a fleet</p>
+</p>
+<table>
+<thead>
+<tr>
+<th>Field</th>
+<th>Description</th>
 </tr>
+</thead>
+<tbody>
 <tr>
 <td>
-<code>counters</code></br>
+<code>type</code></br>
 <em>
-<a href="#agones.dev/v1.CounterStatus">
-map[string]agones.dev/agones/pkg/apis/agones/v1.CounterStatus
+<a href="#autoscaling.agones.dev/v1.FleetAutoscalerPolicyType">
+FleetAutoscalerPolicyType
 </a>
 </em>
 </td>
 <td>
-<em>(Optional)</em>
-<p>(Alpha, CountsAndLists feature flag) Counters and Lists provides the configuration for generic tracking features.</p>
+<p>Type of autoscaling policy.</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>lists</code></br>
+<code>buffer</code></br>
 <em>
-<a href="#agones.dev/v1.ListStatus">
-map[string]agones.dev/agones/pkg/apis/agones/v1.ListStatus
+<a href="#autoscaling.agones.dev/v1.BufferPolicy">
+BufferPolicy
 </a>
 </em>
 </td>
 <td>
+<em>(Optional)</em>
+<p>Buffer policy config params. Present only if FleetAutoscalerPolicyType = Buffer.</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>eviction</code></br>
+<code>webhook</code></br>
 <em>
-<a href="#agones.dev/v1.Eviction">
-Eviction
+<a href="#autoscaling.agones.dev/v1.WebhookPolicy">
+WebhookPolicy
 </a>
 </em>
 </td>
 <td>
 <em>(Optional)</em>
-<p>(Alpha, SafeToEvict feature flag) Eviction specifies the eviction tolerance of the GameServer. Defaults to &ldquo;Never&rdquo;.</p>
+<p>Webhook policy config params. Present only if FleetAutoscalerPolicyType = Webhook.</p>
 </td>
 </tr>
 </tbody>
 </table>
-<h3 id="agones.dev/v1.GameServerState">GameServerState
+<h3 id="autoscaling.agones.dev/v1.FleetAutoscalerPolicyType">FleetAutoscalerPolicyType
 (<code>string</code> alias)</p></h3>
 <p>
 (<em>Appears on:</em>
-<a href="#allocation.agones.dev/v1.GameServerSelector">GameServerSelector</a>, 
-<a href="#agones.dev/v1.GameServerStatus">GameServerStatus</a>)
+<a href="#autoscaling.agones.dev/v1.FleetAutoscalerPolicy">FleetAutoscalerPolicy</a>)
 </p>
 <p>
-<p>GameServerState is the state for the GameServer</p>
+<p>FleetAutoscalerPolicyType is the policy for autoscaling
+for a given Fleet</p>
 </p>
-<h3 id="agones.dev/v1.GameServerStatus">GameServerStatus
+<h3 id="autoscaling.agones.dev/v1.FleetAutoscalerSpec">FleetAutoscalerSpec
 </h3>
 <p>
 (<em>Appears on:</em>
-<a href="#agones.dev/v1.GameServer">GameServer</a>)
+<a href="#autoscaling.agones.dev/v1.FleetAutoscaler">FleetAutoscaler</a>)
 </p>
 <p>
-<p>GameServerStatus is the status for a GameServer resource</p>
+<p>FleetAutoscalerSpec is the spec for a Fleet Scaler</p>
 </p>
 <table>
 <thead>
@@ -6520,129 +6706,133 @@ <h3 id="agones.dev/v1.GameServerStatus">GameServerStatus
 <tbody>
 <tr>
 <td>
-<code>state</code></br>
+<code>fleetName</code></br>
 <em>
-<a href="#agones.dev/v1.GameServerState">
-GameServerState
-</a>
+string
 </em>
 </td>
 <td>
-<p>GameServerState is the current state of a GameServer, e.g. Creating, Starting, Ready, etc</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>ports</code></br>
+<code>policy</code></br>
 <em>
-<a href="#agones.dev/v1.GameServerStatusPort">
-[]GameServerStatusPort
+<a href="#autoscaling.agones.dev/v1.FleetAutoscalerPolicy">
+FleetAutoscalerPolicy
 </a>
 </em>
 </td>
 <td>
+<p>Autoscaling policy</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>address</code></br>
+<code>sync</code></br>
 <em>
-string
+<a href="#autoscaling.agones.dev/v1.FleetAutoscalerSync">
+FleetAutoscalerSync
+</a>
 </em>
 </td>
 <td>
+<em>(Optional)</em>
+<p>[Stage:Beta]
+[FeatureFlag:CustomFasSyncInterval]
+Sync defines when FleetAutoscalers runs autoscaling</p>
 </td>
 </tr>
+</tbody>
+</table>
+<h3 id="autoscaling.agones.dev/v1.FleetAutoscalerStatus">FleetAutoscalerStatus
+</h3>
+<p>
+(<em>Appears on:</em>
+<a href="#autoscaling.agones.dev/v1.FleetAutoscaler">FleetAutoscaler</a>)
+</p>
+<p>
+<p>FleetAutoscalerStatus defines the current status of a FleetAutoscaler</p>
+</p>
+<table>
+<thead>
 <tr>
-<td>
-<code>nodeName</code></br>
-<em>
-string
-</em>
-</td>
-<td>
-</td>
+<th>Field</th>
+<th>Description</th>
 </tr>
+</thead>
+<tbody>
 <tr>
 <td>
-<code>reservedUntil</code></br>
+<code>currentReplicas</code></br>
 <em>
-<a href="https://v1-25.docs.kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#time-v1-meta">
-Kubernetes meta/v1.Time
-</a>
+int32
 </em>
 </td>
 <td>
+<p>CurrentReplicas is the current number of gameserver replicas
+of the fleet managed by this autoscaler, as last seen by the autoscaler</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>players</code></br>
+<code>desiredReplicas</code></br>
 <em>
-<a href="#agones.dev/v1.PlayerStatus">
-PlayerStatus
-</a>
+int32
 </em>
 </td>
 <td>
-<em>(Optional)</em>
-<p>[Stage:Alpha]
-[FeatureFlag:PlayerTracking]</p>
+<p>DesiredReplicas is the desired number of gameserver replicas
+of the fleet managed by this autoscaler, as last calculated by the autoscaler</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>counters</code></br>
+<code>lastScaleTime</code></br>
 <em>
-<a href="#agones.dev/v1.CounterStatus">
-map[string]agones.dev/agones/pkg/apis/agones/v1.CounterStatus
+<a href="https://v1-25.docs.kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#time-v1-meta">
+Kubernetes meta/v1.Time
 </a>
 </em>
 </td>
 <td>
 <em>(Optional)</em>
-<p>(Alpha, CountsAndLists feature flag) Counters and Lists provides the configuration for generic tracking features.</p>
+<p>lastScaleTime is the last time the FleetAutoscaler scaled the attached fleet,</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>lists</code></br>
+<code>ableToScale</code></br>
 <em>
-<a href="#agones.dev/v1.ListStatus">
-map[string]agones.dev/agones/pkg/apis/agones/v1.ListStatus
-</a>
+bool
 </em>
 </td>
 <td>
-<em>(Optional)</em>
+<p>AbleToScale indicates that we can access the target fleet</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>eviction</code></br>
+<code>scalingLimited</code></br>
 <em>
-<a href="#agones.dev/v1.Eviction">
-Eviction
-</a>
+bool
 </em>
 </td>
 <td>
-<em>(Optional)</em>
-<p>(Alpha, SafeToEvict feature flag) Eviction specifies the eviction tolerance of the GameServer.</p>
+<p>ScalingLimited indicates that the calculated scale would be above or below the range
+defined by MinReplicas and MaxReplicas, and has thus been capped.</p>
 </td>
 </tr>
 </tbody>
 </table>
-<h3 id="agones.dev/v1.GameServerStatusPort">GameServerStatusPort
+<h3 id="autoscaling.agones.dev/v1.FleetAutoscalerSync">FleetAutoscalerSync
 </h3>
 <p>
 (<em>Appears on:</em>
-<a href="#allocation.agones.dev/v1.GameServerAllocationStatus">GameServerAllocationStatus</a>, 
-<a href="#agones.dev/v1.GameServerStatus">GameServerStatus</a>)
+<a href="#autoscaling.agones.dev/v1.FleetAutoscalerSpec">FleetAutoscalerSpec</a>)
 </p>
 <p>
-<p>GameServerStatusPort shows the port that was allocated to a
-GameServer.</p>
+<p>FleetAutoscalerSync describes when to sync a fleet</p>
 </p>
 <table>
 <thead>
@@ -6654,35 +6844,52 @@ <h3 id="agones.dev/v1.GameServerStatusPort">GameServerStatusPort
 <tbody>
 <tr>
 <td>
-<code>name</code></br>
+<code>type</code></br>
 <em>
-string
+<a href="#autoscaling.agones.dev/v1.FleetAutoscalerSyncType">
+FleetAutoscalerSyncType
+</a>
 </em>
 </td>
 <td>
+<p>Type of autoscaling sync.</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>port</code></br>
+<code>fixedInterval</code></br>
 <em>
-int32
+<a href="#autoscaling.agones.dev/v1.FixedIntervalSync">
+FixedIntervalSync
+</a>
 </em>
 </td>
 <td>
+<em>(Optional)</em>
+<p>FixedInterval config params. Present only if FleetAutoscalerSyncType = FixedInterval.</p>
 </td>
 </tr>
 </tbody>
 </table>
-<h3 id="agones.dev/v1.GameServerTemplateSpec">GameServerTemplateSpec
+<h3 id="autoscaling.agones.dev/v1.FleetAutoscalerSyncType">FleetAutoscalerSyncType
+(<code>string</code> alias)</p></h3>
+<p>
+(<em>Appears on:</em>
+<a href="#autoscaling.agones.dev/v1.FleetAutoscalerSync">FleetAutoscalerSync</a>)
+</p>
+<p>
+<p>FleetAutoscalerSyncType is the sync strategy for a given Fleet</p>
+</p>
+<h3 id="autoscaling.agones.dev/v1.WebhookPolicy">WebhookPolicy
 </h3>
 <p>
 (<em>Appears on:</em>
-<a href="#agones.dev/v1.FleetSpec">FleetSpec</a>, 
-<a href="#agones.dev/v1.GameServerSetSpec">GameServerSetSpec</a>)
+<a href="#autoscaling.agones.dev/v1.FleetAutoscalerPolicy">FleetAutoscalerPolicy</a>)
 </p>
 <p>
-<p>GameServerTemplateSpec is a template for GameServers</p>
+<p>WebhookPolicy controls the desired behavior of the webhook policy.
+It contains the description of the webhook autoscaler service
+used to form url which is accessible inside the cluster</p>
 </p>
 <table>
 <thead>
@@ -6694,141 +6901,147 @@ <h3 id="agones.dev/v1.GameServerTemplateSpec">GameServerTemplateSpec
 <tbody>
 <tr>
 <td>
-<code>metadata</code></br>
-<em>
-<a href="https://v1-25.docs.kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
-Kubernetes meta/v1.ObjectMeta
-</a>
-</em>
-</td>
-<td>
-Refer to the Kubernetes API documentation for the fields of the
-<code>metadata</code> field.
-</td>
-</tr>
-<tr>
-<td>
-<code>spec</code></br>
-<em>
-<a href="#agones.dev/v1.GameServerSpec">
-GameServerSpec
-</a>
-</em>
-</td>
-<td>
-<br/>
-<br/>
-<table>
-<tr>
-<td>
-<code>container</code></br>
+<code>url</code></br>
 <em>
 string
 </em>
 </td>
 <td>
-<p>Container specifies which Pod container is the game server. Only required if there is more than one
-container defined</p>
-</td>
-</tr>
-<tr>
-<td>
-<code>ports</code></br>
-<em>
-<a href="#agones.dev/v1.GameServerPort">
-[]GameServerPort
-</a>
-</em>
-</td>
-<td>
-<p>Ports are the array of ports that can be exposed via the game server</p>
+<em>(Optional)</em>
+<p><code>url</code> gives the location of the webhook, in standard URL form
+(<code>scheme://host:port/path</code>). Exactly one of <code>url</code> or <code>service</code>
+must be specified.</p>
+<p>The <code>host</code> should not refer to a service running in the cluster; use
+the <code>service</code> field instead. The host might be resolved via external
+DNS in some apiservers (e.g., <code>kube-apiserver</code> cannot resolve
+in-cluster DNS as that would be a layering violation). <code>host</code> may
+also be an IP address.</p>
+<p>Please note that using <code>localhost</code> or <code>127.0.0.1</code> as a <code>host</code> is
+risky unless you take great care to run this webhook on all hosts
+which run an apiserver which might need to make calls to this
+webhook. Such installs are likely to be non-portable, i.e., not easy
+to turn up in a new cluster.</p>
+<p>The scheme must be &ldquo;https&rdquo;; the URL must begin with &ldquo;https://&rdquo;.</p>
+<p>A path is optional, and if present may be any string permissible in
+a URL. You may use the path to pass an arbitrary string to the
+webhook, for example, a cluster identifier.</p>
+<p>Attempting to use a user or basic auth e.g. &ldquo;user:password@&rdquo; is not
+allowed. Fragments (&ldquo;#&hellip;&rdquo;) and query parameters (&ldquo;?&hellip;&rdquo;) are not
+allowed, either.</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>health</code></br>
+<code>service</code></br>
 <em>
-<a href="#agones.dev/v1.Health">
-Health
+<a href="https://v1-25.docs.kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#servicereference-v1-admissionregistration">
+Kubernetes admissionregistration/v1.ServiceReference
 </a>
 </em>
 </td>
 <td>
-<p>Health configures health checking</p>
+<em>(Optional)</em>
+<p><code>service</code> is a reference to the service for this webhook. Either
+<code>service</code> or <code>url</code> must be specified.</p>
+<p>If the webhook is running within the cluster, then you should use <code>service</code>.</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>scheduling</code></br>
+<code>caBundle</code></br>
 <em>
-agones.dev/agones/pkg/apis.SchedulingStrategy
+[]byte
 </em>
 </td>
 <td>
-<p>Scheduling strategy. Defaults to &ldquo;Packed&rdquo;</p>
+<em>(Optional)</em>
+<p><code>caBundle</code> is a PEM encoded CA bundle which will be used to validate the webhook&rsquo;s server certificate.
+If unspecified, system trust roots on the apiserver are used.</p>
 </td>
 </tr>
+</tbody>
+</table>
+<hr/>
+<h2 id="multicluster.agones.dev/v1">multicluster.agones.dev/v1</h2>
+<p>
+<p>Package v1 is the v1 version of the API.</p>
+</p>
+Resource Types:
+<ul><li>
+<a href="#multicluster.agones.dev/v1.GameServerAllocationPolicy">GameServerAllocationPolicy</a>
+</li></ul>
+<h3 id="multicluster.agones.dev/v1.GameServerAllocationPolicy">GameServerAllocationPolicy
+</h3>
+<p>
+<p>GameServerAllocationPolicy is the Schema for the gameserverallocationpolicies API</p>
+</p>
+<table>
+<thead>
+<tr>
+<th>Field</th>
+<th>Description</th>
+</tr>
+</thead>
+<tbody>
 <tr>
 <td>
-<code>sdkServer</code></br>
-<em>
-<a href="#agones.dev/v1.SdkServer">
-SdkServer
-</a>
-</em>
+<code>apiVersion</code></br>
+string</td>
+<td>
+<code>
+multicluster.agones.dev/v1
+</code>
 </td>
+</tr>
+<tr>
 <td>
-<p>SdkServer specifies parameters for the Agones SDK Server sidecar container</p>
+<code>kind</code></br>
+string
 </td>
+<td><code>GameServerAllocationPolicy</code></td>
 </tr>
 <tr>
 <td>
-<code>template</code></br>
+<code>metadata</code></br>
 <em>
-<a href="https://v1-25.docs.kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#podtemplatespec-v1-core">
-Kubernetes core/v1.PodTemplateSpec
+<a href="https://v1-25.docs.kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta">
+Kubernetes meta/v1.ObjectMeta
 </a>
 </em>
 </td>
 <td>
-<p>Template describes the Pod that will be created for the GameServer</p>
+Refer to the Kubernetes API documentation for the fields of the
+<code>metadata</code> field.
 </td>
 </tr>
 <tr>
 <td>
-<code>players</code></br>
+<code>spec</code></br>
 <em>
-<a href="#agones.dev/v1.PlayersSpec">
-PlayersSpec
+<a href="#multicluster.agones.dev/v1.GameServerAllocationPolicySpec">
+GameServerAllocationPolicySpec
 </a>
 </em>
 </td>
 <td>
-<em>(Optional)</em>
-<p>(Alpha, PlayerTracking feature flag) Players provides the configuration for player tracking features.</p>
-</td>
-</tr>
+<br/>
+<br/>
+<table>
 <tr>
 <td>
-<code>counters</code></br>
+<code>priority</code></br>
 <em>
-<a href="#agones.dev/v1.CounterStatus">
-map[string]agones.dev/agones/pkg/apis/agones/v1.CounterStatus
-</a>
+int32
 </em>
 </td>
 <td>
-<em>(Optional)</em>
-<p>(Alpha, CountsAndLists feature flag) Counters and Lists provides the configuration for generic tracking features.</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>lists</code></br>
+<code>weight</code></br>
 <em>
-<a href="#agones.dev/v1.ListStatus">
-map[string]agones.dev/agones/pkg/apis/agones/v1.ListStatus
-</a>
+int
 </em>
 </td>
 <td>
@@ -6836,16 +7049,14 @@ <h3 id="agones.dev/v1.GameServerTemplateSpec">GameServerTemplateSpec
 </tr>
 <tr>
 <td>
-<code>eviction</code></br>
+<code>connectionInfo</code></br>
 <em>
-<a href="#agones.dev/v1.Eviction">
-Eviction
+<a href="#multicluster.agones.dev/v1.ClusterConnectionInfo">
+ClusterConnectionInfo
 </a>
 </em>
 </td>
 <td>
-<em>(Optional)</em>
-<p>(Alpha, SafeToEvict feature flag) Eviction specifies the eviction tolerance of the GameServer. Defaults to &ldquo;Never&rdquo;.</p>
 </td>
 </tr>
 </table>
@@ -6853,14 +7064,14 @@ <h3 id="agones.dev/v1.GameServerTemplateSpec">GameServerTemplateSpec
 </tr>
 </tbody>
 </table>
-<h3 id="agones.dev/v1.Health">Health
+<h3 id="multicluster.agones.dev/v1.ClusterConnectionInfo">ClusterConnectionInfo
 </h3>
 <p>
 (<em>Appears on:</em>
-<a href="#agones.dev/v1.GameServerSpec">GameServerSpec</a>)
+<a href="#multicluster.agones.dev/v1.GameServerAllocationPolicySpec">GameServerAllocationPolicySpec</a>)
 </p>
 <p>
-<p>Health configures health checking on the GameServer</p>
+<p>ClusterConnectionInfo defines the connection information for a cluster</p>
 </p>
 <table>
 <thead>
@@ -6872,98 +7083,67 @@ <h3 id="agones.dev/v1.Health">Health
 <tbody>
 <tr>
 <td>
-<code>disabled</code></br>
-<em>
-bool
-</em>
-</td>
-<td>
-<p>Disabled is whether health checking is disabled or not</p>
-</td>
-</tr>
-<tr>
-<td>
-<code>periodSeconds</code></br>
+<code>clusterName</code></br>
 <em>
-int32
+string
 </em>
 </td>
 <td>
-<p>PeriodSeconds is the number of seconds each health ping has to occur in</p>
+<p>Optional: the name of the targeted cluster</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>failureThreshold</code></br>
+<code>allocationEndpoints</code></br>
 <em>
-int32
+[]string
 </em>
 </td>
 <td>
-<p>FailureThreshold how many failures in a row constitutes unhealthy</p>
+<p>The endpoints for the allocator service in the targeted cluster.
+If the AllocationEndpoints is not set, the allocation happens on local cluster.
+If there are multiple endpoints any of the endpoints that can handle allocation request should suffice</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>initialDelaySeconds</code></br>
+<code>secretName</code></br>
 <em>
-int32
+string
 </em>
 </td>
 <td>
-<p>InitialDelaySeconds initial delay before checking health</p>
+<p>The name of the secret that contains TLS client certificates to connect the allocator server in the targeted cluster</p>
 </td>
 </tr>
-</tbody>
-</table>
-<h3 id="agones.dev/v1.ListStatus">ListStatus
-</h3>
-<p>
-(<em>Appears on:</em>
-<a href="#agones.dev/v1.GameServerSpec">GameServerSpec</a>, 
-<a href="#agones.dev/v1.GameServerStatus">GameServerStatus</a>)
-</p>
-<p>
-<p>ListStatus stores the current list values</p>
-</p>
-<table>
-<thead>
-<tr>
-<th>Field</th>
-<th>Description</th>
-</tr>
-</thead>
-<tbody>
 <tr>
 <td>
-<code>capacity</code></br>
+<code>namespace</code></br>
 <em>
-int64
+string
 </em>
 </td>
 <td>
+<p>The cluster namespace from which to allocate gameservers</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>values</code></br>
+<code>serverCa</code></br>
 <em>
-[]string
+[]byte
 </em>
 </td>
 <td>
+<p>The PEM encoded server CA, used by the allocator client to authenticate the remote server.</p>
 </td>
 </tr>
 </tbody>
 </table>
-<h3 id="agones.dev/v1.PlayerStatus">PlayerStatus
+<h3 id="multicluster.agones.dev/v1.ConnectionInfoIterator">ConnectionInfoIterator
 </h3>
 <p>
-(<em>Appears on:</em>
-<a href="#agones.dev/v1.GameServerStatus">GameServerStatus</a>)
-</p>
-<p>
-<p>PlayerStatus stores the current player capacity values</p>
+<p>ConnectionInfoIterator an iterator on ClusterConnectionInfo</p>
 </p>
 <table>
 <thead>
@@ -6975,82 +7155,58 @@ <h3 id="agones.dev/v1.PlayerStatus">PlayerStatus
 <tbody>
 <tr>
 <td>
-<code>count</code></br>
+<code>currPriority</code></br>
 <em>
-int64
+int
 </em>
 </td>
 <td>
+<p>currPriority Current priority index from the orderedPriorities</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>capacity</code></br>
+<code>orderedPriorities</code></br>
 <em>
-int64
+[]int32
 </em>
 </td>
 <td>
+<p>orderedPriorities list of ordered priorities</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>ids</code></br>
+<code>priorityToCluster</code></br>
 <em>
-[]string
+map[int32]map[string][]*agones.dev/agones/pkg/apis/multicluster/v1.GameServerAllocationPolicy
 </em>
 </td>
 <td>
+<p>priorityToCluster Map of priority to cluster-policies map</p>
 </td>
 </tr>
-</tbody>
-</table>
-<h3 id="agones.dev/v1.PlayersSpec">PlayersSpec
-</h3>
-<p>
-(<em>Appears on:</em>
-<a href="#agones.dev/v1.GameServerSpec">GameServerSpec</a>)
-</p>
-<p>
-<p>PlayersSpec tracks the initial player capacity</p>
-</p>
-<table>
-<thead>
-<tr>
-<th>Field</th>
-<th>Description</th>
-</tr>
-</thead>
-<tbody>
 <tr>
 <td>
-<code>initialCapacity</code></br>
+<code>clusterBlackList</code></br>
 <em>
-int64
+map[string]bool
 </em>
 </td>
 <td>
+<p>clusterBlackList the cluster blacklist for the clusters that has already returned</p>
 </td>
 </tr>
 </tbody>
 </table>
-<h3 id="agones.dev/v1.PortPolicy">PortPolicy
-(<code>string</code> alias)</p></h3>
-<p>
-(<em>Appears on:</em>
-<a href="#agones.dev/v1.GameServerPort">GameServerPort</a>)
-</p>
-<p>
-<p>PortPolicy is the port policy for the GameServer</p>
-</p>
-<h3 id="agones.dev/v1.SdkServer">SdkServer
+<h3 id="multicluster.agones.dev/v1.GameServerAllocationPolicySpec">GameServerAllocationPolicySpec
 </h3>
 <p>
 (<em>Appears on:</em>
-<a href="#agones.dev/v1.GameServerSpec">GameServerSpec</a>)
+<a href="#multicluster.agones.dev/v1.GameServerAllocationPolicy">GameServerAllocationPolicy</a>)
 </p>
 <p>
-<p>SdkServer specifies parameters for the Agones SDK Server sidecar container</p>
+<p>GameServerAllocationPolicySpec defines the desired state of GameServerAllocationPolicy</p>
 </p>
 <table>
 <thead>
@@ -7062,50 +7218,38 @@ <h3 id="agones.dev/v1.SdkServer">SdkServer
 <tbody>
 <tr>
 <td>
-<code>logLevel</code></br>
+<code>priority</code></br>
 <em>
-<a href="#agones.dev/v1.SdkServerLogLevel">
-SdkServerLogLevel
-</a>
+int32
 </em>
 </td>
 <td>
-<p>LogLevel for SDK server (sidecar) logs. Defaults to &ldquo;Info&rdquo;</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>grpcPort</code></br>
+<code>weight</code></br>
 <em>
-int32
+int
 </em>
 </td>
 <td>
-<p>GRPCPort is the port on which the SDK Server binds the gRPC server to accept incoming connections</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>httpPort</code></br>
+<code>connectionInfo</code></br>
 <em>
-int32
+<a href="#multicluster.agones.dev/v1.ClusterConnectionInfo">
+ClusterConnectionInfo
+</a>
 </em>
 </td>
 <td>
-<p>HTTPPort is the port on which the SDK Server binds the HTTP gRPC gateway server to accept incoming connections</p>
 </td>
 </tr>
 </tbody>
 </table>
-<h3 id="agones.dev/v1.SdkServerLogLevel">SdkServerLogLevel
-(<code>string</code> alias)</p></h3>
-<p>
-(<em>Appears on:</em>
-<a href="#agones.dev/v1.SdkServer">SdkServer</a>)
-</p>
-<p>
-<p>SdkServerLogLevel is the log level for SDK server (sidecar) logs</p>
-</p>
 <hr/>
 <p><em>
 Generated with <code>gen-crd-api-reference-docs</code>.
diff --git a/site/content/en/docs/Reference/fleet.md b/site/content/en/docs/Reference/fleet.md
index 4297c6c0b9..214c557da1 100644
--- a/site/content/en/docs/Reference/fleet.md
+++ b/site/content/en/docs/Reference/fleet.md
@@ -43,6 +43,16 @@ spec:
       maxSurge: 25%
       # the amount to decrements GameServers by. Defaults to 25%
       maxUnavailable: 25%
+  # [Stage:Alpha]
+  # [FeatureFlag:FleetAllocationOverflow]
+  # Labels and/or Annotations to apply to GameServers when the number of Allocated GameServers drops below
+  # the desired replicas on the underlying `GameServerSet`.
+  allocationOverflow: # applied to the GameServerSet's number Allocated GameServers that are over the desired replicas
+    labels:
+      mykey: myvalue
+      version: "" # empty an existing label value
+    annotations:
+      otherkey: setthisvalue
   template:
     # GameServer metadata
     metadata:
@@ -98,6 +108,11 @@ The `spec` field is the actual `Fleet` specification and it is composed as follo
   - `rollingUpdate` is only relevant when `type: RollingUpdate`
     - `maxSurge` is the amount to increment the new GameServers by. Defaults to 25%
     - `maxUnavailable` is the amount to decrements GameServers by. Defaults to 25%
+- `allocationOverflow` (Alpha, requires `FleetAllocationOverflow` flag) The labels and/or Annotations to apply to 
+  GameServers when the number of Allocated GameServers drops below the desired replicas on the underlying 
+  `GameServerSet`.
+  - `labels` the map of labels to be applied
+  - `annotations` the map of annotations to be applied
 - `template` a full `GameServer` configuration template.
    See the [GameServer]({{< relref "gameserver.md" >}}) reference for all available fields.
 
diff --git a/test/e2e/fleet_test.go b/test/e2e/fleet_test.go
index dffe17ce32..f6ef287e88 100644
--- a/test/e2e/fleet_test.go
+++ b/test/e2e/fleet_test.go
@@ -1528,6 +1528,103 @@ func TestFleetAggregatedPlayerStatus(t *testing.T) {
 	})
 }
 
+func TestFleetAllocationOverflow(t *testing.T) {
+	if !runtime.FeatureEnabled(runtime.FeatureFleetAllocateOverflow) {
+		t.SkipNow()
+	}
+	t.Parallel()
+	ctx := context.Background()
+	client := framework.AgonesClient.AgonesV1()
+	fleets := client.Fleets(framework.Namespace)
+
+	setup := func() *agonesv1.Fleet {
+		flt := defaultFleet(framework.Namespace)
+		flt.Spec.AllocationOverflow = &agonesv1.AllocationOverflow{Labels: map[string]string{"colour": "green"}, Annotations: map[string]string{"action": "update"}}
+		flt, err := fleets.Create(ctx, flt.DeepCopy(), metav1.CreateOptions{})
+		require.NoError(t, err)
+		framework.AssertFleetCondition(t, flt, e2e.FleetReadyCount(flt.Spec.Replicas))
+
+		// allocate two of them.
+		framework.CreateAndApplyAllocation(t, flt)
+		framework.CreateAndApplyAllocation(t, flt)
+		framework.AssertFleetCondition(t, flt, func(entry *logrus.Entry, fleet *agonesv1.Fleet) bool {
+			return fleet.Status.AllocatedReplicas == 2
+		})
+
+		flt, err = fleets.Get(ctx, flt.ObjectMeta.Name, metav1.GetOptions{})
+		require.NoError(t, err)
+		return flt
+	}
+
+	assertCount := func(t *testing.T, log *logrus.Entry, flt *agonesv1.Fleet, expected int) {
+		require.Eventuallyf(t, func() bool {
+			log.Info("Checking GameServers")
+			list, err := framework.ListGameServersFromFleet(flt)
+			require.NoError(t, err)
+			count := 0
+
+			for _, gs := range list {
+				if gs.ObjectMeta.Labels["colour"] != "green" {
+					log.WithField("gs", gs).Info("Label not set")
+					continue
+				}
+				if gs.ObjectMeta.Annotations["action"] != "update" {
+					log.WithField("gs", gs).Info("Annotation not set")
+					continue
+				}
+				count++
+			}
+
+			return count == expected
+		}, 5*time.Minute, time.Second, "Labels and annotations not set")
+	}
+
+	t.Run("scale down", func(t *testing.T) {
+		log := e2e.TestLogger(t)
+		flt := setup()
+		defer fleets.Delete(ctx, flt.ObjectMeta.Name, metav1.DeleteOptions{}) // nolint: errcheck
+
+		framework.ScaleFleet(t, log, flt, 0)
+
+		// wait for scale down
+		framework.AssertFleetCondition(t, flt, func(entry *logrus.Entry, fleet *agonesv1.Fleet) bool {
+			return fleet.Status.AllocatedReplicas == 2 && fleet.Status.ReadyReplicas == 0
+		})
+
+		assertCount(t, log, flt, 2)
+	})
+
+	t.Run("rolling update", func(t *testing.T) {
+		log := e2e.TestLogger(t)
+		flt := setup()
+		defer fleets.Delete(ctx, flt.ObjectMeta.Name, metav1.DeleteOptions{}) // nolint: errcheck
+
+		fltCopy := flt.DeepCopy()
+		if fltCopy.Spec.Template.ObjectMeta.Labels == nil {
+			fltCopy.Spec.Template.ObjectMeta.Labels = map[string]string{}
+		}
+		fltCopy.Spec.Template.ObjectMeta.Labels["version"] = "2.0"
+		flt, err := fleets.Update(ctx, fltCopy, metav1.UpdateOptions{})
+		require.NoError(t, err)
+
+		// wait for rolling update to finish
+		require.Eventuallyf(t, func() bool {
+			list, err := framework.ListGameServersFromFleet(flt)
+			assert.NoError(t, err)
+			for _, gs := range list {
+				log.WithField("gs", gs).Info("checking game server")
+				if gs.Status.State == agonesv1.GameServerStateReady && gs.ObjectMeta.Labels["version"] == "2.0" {
+					return true
+				}
+			}
+
+			return false
+		}, 5*time.Minute, time.Second, "Rolling update did not complete")
+
+		assertCount(t, log, flt, 1)
+	})
+}
+
 func assertCausesContainsString(t *testing.T, causes []metav1.StatusCause, expected string) {
 	found := false
 	for _, v := range causes {
diff --git a/test/e2e/framework/framework.go b/test/e2e/framework/framework.go
index 424962aed9..58225458f7 100644
--- a/test/e2e/framework/framework.go
+++ b/test/e2e/framework/framework.go
@@ -315,6 +315,30 @@ func (f *Framework) CycleAllocations(ctx context.Context, t *testing.T, flt *ago
 	}
 }
 
+// ScaleFleet will scale a Fleet with retries to a specified replica size.
+func (f *Framework) ScaleFleet(t *testing.T, log *logrus.Entry, flt *agonesv1.Fleet, replicas int32) {
+	fleets := f.AgonesClient.AgonesV1().Fleets(f.Namespace)
+	ctx := context.Background()
+
+	require.Eventuallyf(t, func() bool {
+		flt, err := fleets.Get(ctx, flt.ObjectMeta.Name, metav1.GetOptions{})
+		if err != nil {
+			log.WithError(err).Info("Could not get Fleet")
+			return false
+		}
+
+		fltCopy := flt.DeepCopy()
+		fltCopy.Spec.Replicas = replicas
+		_, err = fleets.Update(ctx, fltCopy, metav1.UpdateOptions{})
+		if err != nil {
+			log.WithError(err).Info("Could not scale Fleet")
+			return false
+		}
+
+		return true
+	}, 5*time.Minute, time.Second, "Could not scale Fleet %s", flt.ObjectMeta.Name)
+}
+
 // AssertFleetCondition waits for the Fleet to be in a specific condition or fails the test if the condition can't be met in 5 minutes.
 func (f *Framework) AssertFleetCondition(t *testing.T, flt *agonesv1.Fleet, condition func(*logrus.Entry, *agonesv1.Fleet) bool) {
 	err := f.WaitForFleetCondition(t, flt, condition)