diff --git a/install/helm/agones/templates/crds/gameserverset.yaml b/install/helm/agones/templates/crds/gameserverset.yaml
index 78b242cd08..c473be35ea 100644
--- a/install/helm/agones/templates/crds/gameserverset.yaml
+++ b/install/helm/agones/templates/crds/gameserverset.yaml
@@ -131,13 +131,12 @@ spec:
                   additionalProperties:
                     type: object
                     properties:
-                      count: # initial count
+                      count: # Aggregated count of the Counter across the GameServerSet
                         type: integer
                         default: 0
                         minimum: 0
-                      capacity: # max capacity of the counter
+                      capacity: # Aggregated maximum capacity of the Counter across the GameServerSet
                         type: integer
-                        default: 1000
                         minimum: 0
                 lists:
                   type: object
@@ -147,18 +146,13 @@ spec:
                   additionalProperties:
                     type: object
                     properties:
-                      capacity: # max capacity of the array (can be less than or equal to value of maxItems)
+                      capacity: # Aggregated maximum capacity of the List across the GameServerSet
                         type: integer
                         minimum: 0
-                        default: 1000
-                        maximum: 1000 # must be equal to values.maxItems
-                      values:
-                        type: array
-                        x-kubernetes-list-type: set # Requires items in the array to be unique
-                        maxItems: 1000 # max possible size of the value array (cannot be updated)
-                        items: # name of the item (player1, session1, room1, etc.)
-                          type: string
-                        default: []
+                      count: # Aggregated number of items in the List across the GameServerSet
+                        type: integer
+                        minimum: 0
+                        default: 0
       subresources:
         # status enables the status subresource.
         status: { }
diff --git a/install/yaml/install.yaml b/install/yaml/install.yaml
index 4006d57469..63236dd7ad 100644
--- a/install/yaml/install.yaml
+++ b/install/yaml/install.yaml
@@ -15517,13 +15517,12 @@ spec:
                   additionalProperties:
                     type: object
                     properties:
-                      count: # initial count
+                      count: # Aggregated count of the Counter across the GameServerSet
                         type: integer
                         default: 0
                         minimum: 0
-                      capacity: # max capacity of the counter
+                      capacity: # Aggregated maximum capacity of the Counter across the GameServerSet
                         type: integer
-                        default: 1000
                         minimum: 0
                 lists:
                   type: object
@@ -15533,18 +15532,13 @@ spec:
                   additionalProperties:
                     type: object
                     properties:
-                      capacity: # max capacity of the array (can be less than or equal to value of maxItems)
+                      capacity: # Aggregated maximum capacity of the List across the GameServerSet
                         type: integer
                         minimum: 0
-                        default: 1000
-                        maximum: 1000 # must be equal to values.maxItems
-                      values:
-                        type: array
-                        x-kubernetes-list-type: set # Requires items in the array to be unique
-                        maxItems: 1000 # max possible size of the value array (cannot be updated)
-                        items: # name of the item (player1, session1, room1, etc.)
-                          type: string
-                        default: []
+                      count: # Aggregated number of items in the List across the GameServerSet
+                        type: integer
+                        minimum: 0
+                        default: 0
       subresources:
         # status enables the status subresource.
         status: { }
diff --git a/pkg/apis/agones/v1/common.go b/pkg/apis/agones/v1/common.go
index 12fcd3d212..8fb4d69d87 100644
--- a/pkg/apis/agones/v1/common.go
+++ b/pkg/apis/agones/v1/common.go
@@ -46,6 +46,18 @@ type AggregatedPlayerStatus struct {
 	Capacity int64 `json:"capacity"`
 }
 
+// AggregatedCounterStatus stores total Counter tracking values
+type AggregatedCounterStatus struct {
+	Count    int64 `json:"count"`
+	Capacity int64 `json:"capacity"`
+}
+
+// AggregatedListStatus stores total List tracking values
+type AggregatedListStatus struct {
+	Count    int64 `json:"count"`
+	Capacity int64 `json:"capacity"`
+}
+
 // crd is an interface to get Name and Kind of CRD
 type crd interface {
 	GetName() string
diff --git a/pkg/apis/agones/v1/fleet.go b/pkg/apis/agones/v1/fleet.go
index db06b7b635..a8a8e42276 100644
--- a/pkg/apis/agones/v1/fleet.go
+++ b/pkg/apis/agones/v1/fleet.go
@@ -90,6 +90,14 @@ type FleetStatus struct {
 	// Players are the current total player capacity and count for this Fleet
 	// +optional
 	Players *AggregatedPlayerStatus `json:"players,omitempty"`
+	// (Alpha, CountsAndLists feature flag) Counters provides aggregated Counter capacity and Counter
+	// count for this Fleet.
+	// +optional
+	Counters map[string]AggregatedCounterStatus `json:"counters,omitempty"`
+	// (Alpha, CountsAndLists feature flag) Lists provides aggregated List capacityv and List values
+	// for this Fleet.
+	// +optional
+	Lists map[string]AggregatedListStatus `json:"lists,omitempty"`
 }
 
 // GameServerSet returns a single GameServerSet for this Fleet definition
diff --git a/pkg/apis/agones/v1/gameserver.go b/pkg/apis/agones/v1/gameserver.go
index 73552ac57f..ede5c4f26e 100644
--- a/pkg/apis/agones/v1/gameserver.go
+++ b/pkg/apis/agones/v1/gameserver.go
@@ -700,6 +700,20 @@ func (gs *GameServer) IsBeforeReady() bool {
 	return false
 }
 
+// IsReady returns true if the GameServer status is Ready, Reserved, or Allocated state.
+func (gs *GameServer) IsReady() bool {
+	switch gs.Status.State {
+	case GameServerStateAllocated:
+		return true
+	case GameServerStateReady:
+		return true
+	case GameServerStateReserved:
+		return true
+	}
+
+	return false
+}
+
 // FindContainer returns the container specified by the name parameter. Returns the index and the value.
 // Returns an error if not found.
 func (gss *GameServerSpec) FindContainer(name string) (int, corev1.Container, error) {
diff --git a/pkg/apis/agones/v1/gameserverset.go b/pkg/apis/agones/v1/gameserverset.go
index 7399e76dc3..a58ab41bb9 100644
--- a/pkg/apis/agones/v1/gameserverset.go
+++ b/pkg/apis/agones/v1/gameserverset.go
@@ -86,6 +86,14 @@ type GameServerSetStatus struct {
 	// Players is the current total player capacity and count for this GameServerSet
 	// +optional
 	Players *AggregatedPlayerStatus `json:"players,omitempty"`
+	// (Alpha, CountsAndLists feature flag) Counters provides aggregated Counter capacity and Counter
+	// count for this GameServerSet.
+	// +optional
+	Counters map[string]AggregatedCounterStatus `json:"counters,omitempty"`
+	// (Alpha, CountsAndLists feature flag) Lists provides aggregated List capacity and List values
+	// for this GameServerSet.
+	// +optional
+	Lists map[string]AggregatedListStatus `json:"lists,omitempty"`
 }
 
 // ValidateUpdate validates when updates occur. The argument
diff --git a/pkg/apis/agones/v1/zz_generated.deepcopy.go b/pkg/apis/agones/v1/zz_generated.deepcopy.go
index ade739b9a7..61ed4452d9 100644
--- a/pkg/apis/agones/v1/zz_generated.deepcopy.go
+++ b/pkg/apis/agones/v1/zz_generated.deepcopy.go
@@ -25,6 +25,38 @@ import (
 	runtime "k8s.io/apimachinery/pkg/runtime"
 )
 
+// DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.
+func (in *AggregatedCounterStatus) DeepCopyInto(out *AggregatedCounterStatus) {
+	*out = *in
+	return
+}
+
+// DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new AggregatedCounterStatus.
+func (in *AggregatedCounterStatus) DeepCopy() *AggregatedCounterStatus {
+	if in == nil {
+		return nil
+	}
+	out := new(AggregatedCounterStatus)
+	in.DeepCopyInto(out)
+	return out
+}
+
+// DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.
+func (in *AggregatedListStatus) DeepCopyInto(out *AggregatedListStatus) {
+	*out = *in
+	return
+}
+
+// DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new AggregatedListStatus.
+func (in *AggregatedListStatus) DeepCopy() *AggregatedListStatus {
+	if in == nil {
+		return nil
+	}
+	out := new(AggregatedListStatus)
+	in.DeepCopyInto(out)
+	return out
+}
+
 // DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.
 func (in *AggregatedPlayerStatus) DeepCopyInto(out *AggregatedPlayerStatus) {
 	*out = *in
@@ -195,6 +227,20 @@ func (in *FleetStatus) DeepCopyInto(out *FleetStatus) {
 		*out = new(AggregatedPlayerStatus)
 		**out = **in
 	}
+	if in.Counters != nil {
+		in, out := &in.Counters, &out.Counters
+		*out = make(map[string]AggregatedCounterStatus, len(*in))
+		for key, val := range *in {
+			(*out)[key] = val
+		}
+	}
+	if in.Lists != nil {
+		in, out := &in.Lists, &out.Lists
+		*out = make(map[string]AggregatedListStatus, len(*in))
+		for key, val := range *in {
+			(*out)[key] = val
+		}
+	}
 	return
 }
 
@@ -381,6 +427,20 @@ func (in *GameServerSetStatus) DeepCopyInto(out *GameServerSetStatus) {
 		*out = new(AggregatedPlayerStatus)
 		**out = **in
 	}
+	if in.Counters != nil {
+		in, out := &in.Counters, &out.Counters
+		*out = make(map[string]AggregatedCounterStatus, len(*in))
+		for key, val := range *in {
+			(*out)[key] = val
+		}
+	}
+	if in.Lists != nil {
+		in, out := &in.Lists, &out.Lists
+		*out = make(map[string]AggregatedListStatus, len(*in))
+		for key, val := range *in {
+			(*out)[key] = val
+		}
+	}
 	return
 }
 
diff --git a/pkg/fleets/controller.go b/pkg/fleets/controller.go
index 213aa1fd81..a97988e4e8 100644
--- a/pkg/fleets/controller.go
+++ b/pkg/fleets/controller.go
@@ -652,12 +652,20 @@ func (c *Controller) updateFleetStatus(ctx context.Context, fleet *agonesv1.Flee
 	fCopy.Status.ReadyReplicas = 0
 	fCopy.Status.ReservedReplicas = 0
 	fCopy.Status.AllocatedReplicas = 0
+	if runtime.FeatureEnabled(runtime.FeatureCountsAndLists) {
+		fCopy.Status.Counters = make(map[string]agonesv1.AggregatedCounterStatus)
+		fCopy.Status.Lists = make(map[string]agonesv1.AggregatedListStatus)
+	}
 
 	for _, gsSet := range list {
 		fCopy.Status.Replicas += gsSet.Status.Replicas
 		fCopy.Status.ReadyReplicas += gsSet.Status.ReadyReplicas
 		fCopy.Status.ReservedReplicas += gsSet.Status.ReservedReplicas
 		fCopy.Status.AllocatedReplicas += gsSet.Status.AllocatedReplicas
+		if runtime.FeatureEnabled(runtime.FeatureCountsAndLists) {
+			fCopy.Status.Counters = mergeCounters(fCopy.Status.Counters, gsSet.Status.Counters)
+			fCopy.Status.Lists = mergeLists(fCopy.Status.Lists, gsSet.Status.Lists)
+		}
 	}
 	if runtime.FeatureEnabled(runtime.FeaturePlayerTracking) {
 		// to make this code simpler, while the feature gate is in place,
@@ -693,3 +701,43 @@ func (c *Controller) filterGameServerSetByActive(fleet *agonesv1.Fleet, list []*
 
 	return active, rest
 }
+
+// mergeCounters adds the contents of AggregatedCounterStatus c2 into c1.
+func mergeCounters(c1, c2 map[string]agonesv1.AggregatedCounterStatus) map[string]agonesv1.AggregatedCounterStatus {
+	if c1 == nil {
+		c1 = make(map[string]agonesv1.AggregatedCounterStatus)
+	}
+
+	for key, val := range c2 {
+		// If the Counter exists in both maps, aggregate the values.
+		if counter, ok := c1[key]; ok {
+			counter.Capacity += val.Capacity
+			counter.Count += val.Count
+			c1[key] = counter
+		} else {
+			c1[key] = *val.DeepCopy()
+		}
+	}
+
+	return c1
+}
+
+// mergeLists adds the contents of AggregatedListStatus l2 into l1.
+func mergeLists(l1, l2 map[string]agonesv1.AggregatedListStatus) map[string]agonesv1.AggregatedListStatus {
+	if l1 == nil {
+		l1 = make(map[string]agonesv1.AggregatedListStatus)
+	}
+
+	for key, val := range l2 {
+		// If the List exists in both maps, aggregate the values.
+		if list, ok := l1[key]; ok {
+			list.Capacity += val.Capacity
+			list.Count += val.Count
+			l1[key] = list
+		} else {
+			l1[key] = *val.DeepCopy()
+		}
+	}
+
+	return l1
+}
diff --git a/pkg/fleets/controller_test.go b/pkg/fleets/controller_test.go
index d607b1bd6f..def58db3f4 100644
--- a/pkg/fleets/controller_test.go
+++ b/pkg/fleets/controller_test.go
@@ -685,6 +685,130 @@ func TestControllerUpdateFleetPlayerStatus(t *testing.T) {
 	assert.True(t, updated)
 }
 
+// nolint:dupl // Linter errors on lines are duplicate of TestControllerUpdateFleetListStatus
+func TestControllerUpdateFleetCounterStatus(t *testing.T) {
+	t.Parallel()
+
+	utilruntime.FeatureTestMutex.Lock()
+	defer utilruntime.FeatureTestMutex.Unlock()
+
+	require.NoError(t, utilruntime.ParseFeatures(string(utilruntime.FeatureCountsAndLists)+"=true"))
+
+	fleet := defaultFixture()
+	c, m := newFakeController()
+
+	gsSet1 := fleet.GameServerSet()
+	gsSet1.ObjectMeta.Name = "gsSet1"
+	gsSet1.Status.Counters = map[string]agonesv1.AggregatedCounterStatus{
+		"fullCounter": {
+			Capacity: 1000,
+			Count:    1000,
+		},
+	}
+
+	gsSet2 := fleet.GameServerSet()
+	gsSet2.ObjectMeta.Name = "gsSet2"
+	gsSet2.Status.Counters = map[string]agonesv1.AggregatedCounterStatus{
+		"fullCounter": {
+			Capacity: 1000,
+			Count:    1000,
+		},
+		"anotherCounter": {
+			Capacity: 10,
+			Count:    0,
+		},
+	}
+
+	m.AgonesClient.AddReactor("list", "gameserversets",
+		func(action k8stesting.Action) (bool, runtime.Object, error) {
+			return true, &agonesv1.GameServerSetList{Items: []agonesv1.GameServerSet{*gsSet1, *gsSet2}}, nil
+		})
+
+	updated := false
+	m.AgonesClient.AddReactor("update", "fleets",
+		func(action k8stesting.Action) (bool, runtime.Object, error) {
+			updated = true
+			ua := action.(k8stesting.UpdateAction)
+			fleet := ua.GetObject().(*agonesv1.Fleet)
+
+			assert.Equal(t, int64(2000), fleet.Status.Counters["fullCounter"].Capacity)
+			assert.Equal(t, int64(2000), fleet.Status.Counters["fullCounter"].Count)
+			assert.Equal(t, int64(10), fleet.Status.Counters["anotherCounter"].Capacity)
+			assert.Equal(t, int64(0), fleet.Status.Counters["anotherCounter"].Count)
+
+			return true, fleet, nil
+		})
+
+	ctx, cancel := agtesting.StartInformers(m, c.fleetSynced, c.gameServerSetSynced)
+	defer cancel()
+
+	err := c.updateFleetStatus(ctx, fleet)
+	assert.Nil(t, err)
+	assert.True(t, updated)
+}
+
+// nolint:dupl // Linter errors on lines are duplicate of TestControllerUpdateFleetCounterStatus
+func TestControllerUpdateFleetListStatus(t *testing.T) {
+	t.Parallel()
+
+	utilruntime.FeatureTestMutex.Lock()
+	defer utilruntime.FeatureTestMutex.Unlock()
+
+	require.NoError(t, utilruntime.ParseFeatures(string(utilruntime.FeatureCountsAndLists)+"=true"))
+
+	fleet := defaultFixture()
+	c, m := newFakeController()
+
+	gsSet1 := fleet.GameServerSet()
+	gsSet1.ObjectMeta.Name = "gsSet1"
+	gsSet1.Status.Lists = map[string]agonesv1.AggregatedListStatus{
+		"fullList": {
+			Capacity: 1000,
+			Count:    1000,
+		},
+	}
+
+	gsSet2 := fleet.GameServerSet()
+	gsSet2.ObjectMeta.Name = "gsSet2"
+	gsSet2.Status.Lists = map[string]agonesv1.AggregatedListStatus{
+		"fullList": {
+			Capacity: 200,
+			Count:    200,
+		},
+		"anotherList": {
+			Capacity: 10,
+			Count:    1,
+		},
+	}
+
+	m.AgonesClient.AddReactor("list", "gameserversets",
+		func(action k8stesting.Action) (bool, runtime.Object, error) {
+			return true, &agonesv1.GameServerSetList{Items: []agonesv1.GameServerSet{*gsSet1, *gsSet2}}, nil
+		})
+
+	updated := false
+	m.AgonesClient.AddReactor("update", "fleets",
+		func(action k8stesting.Action) (bool, runtime.Object, error) {
+			updated = true
+			ua := action.(k8stesting.UpdateAction)
+			fleet := ua.GetObject().(*agonesv1.Fleet)
+
+			assert.Equal(t, int64(1200), fleet.Status.Lists["fullList"].Capacity)
+			assert.Equal(t, int64(1200), fleet.Status.Lists["fullList"].Count)
+			assert.Equal(t, int64(10), fleet.Status.Lists["anotherList"].Capacity)
+			assert.Equal(t, int64(1), fleet.Status.Lists["anotherList"].Count)
+
+			return true, fleet, nil
+		})
+
+	ctx, cancel := agtesting.StartInformers(m, c.fleetSynced, c.gameServerSetSynced)
+	defer cancel()
+
+	err := c.updateFleetStatus(ctx, fleet)
+	assert.Nil(t, err)
+	assert.True(t, updated)
+}
+
 func TestControllerFilterGameServerSetByActive(t *testing.T) {
 	t.Parallel()
 
diff --git a/pkg/gameserversets/controller.go b/pkg/gameserversets/controller.go
index 52cf100899..e0462b0f65 100644
--- a/pkg/gameserversets/controller.go
+++ b/pkg/gameserversets/controller.go
@@ -33,6 +33,7 @@ import (
 	"agones.dev/agones/pkg/util/runtime"
 	"agones.dev/agones/pkg/util/webhooks"
 	"agones.dev/agones/pkg/util/workerqueue"
+	"github.com/google/go-cmp/cmp"
 	"github.com/heptiolabs/healthcheck"
 	"github.com/pkg/errors"
 	"github.com/sirupsen/logrus"
@@ -588,7 +589,7 @@ func (c *Controller) syncGameServerSetStatus(ctx context.Context, gsSet *agonesv
 
 // updateStatusIfChanged updates GameServerSet status if it's different than provided.
 func (c *Controller) updateStatusIfChanged(ctx context.Context, gsSet *agonesv1.GameServerSet, status agonesv1.GameServerSetStatus) error {
-	if gsSet.Status != status {
+	if !cmp.Equal(gsSet.Status, status) {
 		gsSetCopy := gsSet.DeepCopy()
 		gsSetCopy.Status = status
 		_, err := c.gameServerSetGetter.GameServerSets(gsSet.ObjectMeta.Namespace).UpdateStatus(ctx, gsSetCopy, metav1.UpdateOptions{})
@@ -618,6 +619,12 @@ func computeStatus(list []*agonesv1.GameServer) agonesv1.GameServerSetStatus {
 		case agonesv1.GameServerStateReserved:
 			status.ReservedReplicas++
 		}
+
+		// Aggregates all Counters and Lists only for GameServer states Ready, Reserved, or Allocated.
+		if runtime.FeatureEnabled(runtime.FeatureCountsAndLists) && gs.IsReady() {
+			status.Counters = aggregateCounters(status.Counters, gs.Status.Counters)
+			status.Lists = aggregateLists(status.Lists, gs.Status.Lists)
+		}
 	}
 
 	if runtime.FeatureEnabled(runtime.FeaturePlayerTracking) {
@@ -640,3 +647,48 @@ func computeStatus(list []*agonesv1.GameServer) agonesv1.GameServerSetStatus {
 
 	return status
 }
+
+// aggregateCounters adds the contents of a CounterStatus map to an AggregatedCounterStatus map.
+func aggregateCounters(aggCounterStatus map[string]agonesv1.AggregatedCounterStatus, counterStatus map[string]agonesv1.CounterStatus) map[string]agonesv1.AggregatedCounterStatus {
+	if aggCounterStatus == nil {
+		aggCounterStatus = make(map[string]agonesv1.AggregatedCounterStatus)
+	}
+
+	for key, val := range counterStatus {
+		// If the Counter exists in both maps, aggregate the values.
+		if counter, ok := aggCounterStatus[key]; ok {
+			counter.Count += val.Count
+			counter.Capacity += val.Capacity
+			aggCounterStatus[key] = counter
+		} else {
+			aggCounterStatus[key] = agonesv1.AggregatedCounterStatus(*val.DeepCopy())
+		}
+	}
+
+	return aggCounterStatus
+}
+
+// aggregateLists adds the contents of a ListStatus map to an AggregatedListStatus map.
+func aggregateLists(aggListStatus map[string]agonesv1.AggregatedListStatus, listStatus map[string]agonesv1.ListStatus) map[string]agonesv1.AggregatedListStatus {
+	if aggListStatus == nil {
+		aggListStatus = make(map[string]agonesv1.AggregatedListStatus)
+	}
+
+	for key, val := range listStatus {
+		// If the List exists in both maps, aggregate the values.
+		if list, ok := aggListStatus[key]; ok {
+			list.Capacity += val.Capacity
+			// We do include duplicates in the Count.
+			list.Count += int64(len(val.Values))
+			aggListStatus[key] = list
+		} else {
+			tmp := val.DeepCopy()
+			aggListStatus[key] = agonesv1.AggregatedListStatus{
+				Capacity: tmp.Capacity,
+				Count:    int64(len(tmp.Values)),
+			}
+		}
+	}
+
+	return aggListStatus
+}
diff --git a/pkg/gameserversets/controller_test.go b/pkg/gameserversets/controller_test.go
index ab14ef2f72..7fd64accbc 100644
--- a/pkg/gameserversets/controller_test.go
+++ b/pkg/gameserversets/controller_test.go
@@ -335,6 +335,104 @@ func TestComputeStatus(t *testing.T) {
 
 		assert.Equal(t, expected, computeStatus(list))
 	})
+
+	t.Run("counters", func(t *testing.T) {
+		utilruntime.FeatureTestMutex.Lock()
+		defer utilruntime.FeatureTestMutex.Unlock()
+
+		require.NoError(t, utilruntime.ParseFeatures(string(utilruntime.FeatureCountsAndLists)+"=true"))
+
+		var list []*agonesv1.GameServer
+		gs1 := gsWithState(agonesv1.GameServerStateAllocated)
+		gs1.Status.Counters = map[string]agonesv1.CounterStatus{
+			"firstCounter":  {Count: 5, Capacity: 10},
+			"secondCounter": {Count: 100, Capacity: 1000},
+		}
+		gs2 := gsWithState(agonesv1.GameServerStateReserved)
+		gs2.Status.Counters = map[string]agonesv1.CounterStatus{
+			"firstCounter": {Count: 10, Capacity: 15},
+		}
+		gs3 := gsWithState(agonesv1.GameServerStateCreating)
+		gs3.Status.Counters = map[string]agonesv1.CounterStatus{
+			"firstCounter":  {Count: 20, Capacity: 30},
+			"secondCounter": {Count: 100, Capacity: 1000},
+		}
+		gs4 := gsWithState(agonesv1.GameServerStateReady)
+		gs4.Status.Counters = map[string]agonesv1.CounterStatus{
+			"firstCounter":  {Count: 15, Capacity: 30},
+			"secondCounter": {Count: 20, Capacity: 200},
+		}
+		list = append(list, gs1, gs2, gs3, gs4)
+
+		expected := agonesv1.GameServerSetStatus{
+			Replicas:          4,
+			ReadyReplicas:     1,
+			ReservedReplicas:  1,
+			AllocatedReplicas: 1,
+			Counters: map[string]agonesv1.AggregatedCounterStatus{
+				"firstCounter": {
+					Count:    30,
+					Capacity: 55,
+				},
+				"secondCounter": {
+					Count:    120,
+					Capacity: 1200,
+				},
+			},
+			Lists: map[string]agonesv1.AggregatedListStatus{},
+		}
+
+		assert.Equal(t, expected, computeStatus(list))
+	})
+
+	t.Run("lists", func(t *testing.T) {
+		utilruntime.FeatureTestMutex.Lock()
+		defer utilruntime.FeatureTestMutex.Unlock()
+
+		require.NoError(t, utilruntime.ParseFeatures(string(utilruntime.FeatureCountsAndLists)+"=true"))
+
+		var list []*agonesv1.GameServer
+		gs1 := gsWithState(agonesv1.GameServerStateAllocated)
+		gs1.Status.Lists = map[string]agonesv1.ListStatus{
+			"firstList":  {Capacity: 10, Values: []string{"a", "b"}},
+			"secondList": {Capacity: 1000, Values: []string{"1", "2"}},
+		}
+		gs2 := gsWithState(agonesv1.GameServerStateReserved)
+		gs2.Status.Lists = map[string]agonesv1.ListStatus{
+			"firstList": {Capacity: 15, Values: []string{"c"}},
+		}
+		gs3 := gsWithState(agonesv1.GameServerStateCreating)
+		gs3.Status.Lists = map[string]agonesv1.ListStatus{
+			"firstList":  {Capacity: 30, Values: []string{"d"}},
+			"secondList": {Capacity: 1000, Values: []string{"3"}},
+		}
+		gs4 := gsWithState(agonesv1.GameServerStateReady)
+		gs4.Status.Lists = map[string]agonesv1.ListStatus{
+			"firstList":  {Capacity: 30},
+			"secondList": {Capacity: 100, Values: []string{"4", "5", "6"}},
+		}
+		list = append(list, gs1, gs2, gs3, gs4)
+
+		expected := agonesv1.GameServerSetStatus{
+			Replicas:          4,
+			ReadyReplicas:     1,
+			ReservedReplicas:  1,
+			AllocatedReplicas: 1,
+			Counters:          map[string]agonesv1.AggregatedCounterStatus{},
+			Lists: map[string]agonesv1.AggregatedListStatus{
+				"firstList": {
+					Capacity: 55,
+					Count:    3,
+				},
+				"secondList": {
+					Capacity: 1100,
+					Count:    5,
+				},
+			},
+		}
+
+		assert.Equal(t, expected, computeStatus(list))
+	})
 }
 
 func TestControllerWatchGameServers(t *testing.T) {
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 9c9678e63f..209341b0d0 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.32.0" %}}
+{{% feature expiryVersion="1.33.0" %}}
 <p>Packages:</p>
 <ul>
 <li>
-<a href="#allocation.agones.dev%2fv1">allocation.agones.dev/v1</a>
-</li>
-<li>
 <a href="#autoscaling.agones.dev%2fv1">autoscaling.agones.dev/v1</a>
 </li>
 <li>
@@ -18,20 +15,22 @@
 <li>
 <a href="#agones.dev%2fv1">agones.dev/v1</a>
 </li>
+<li>
+<a href="#allocation.agones.dev%2fv1">allocation.agones.dev/v1</a>
+</li>
 </ul>
-<h2 id="allocation.agones.dev/v1">allocation.agones.dev/v1</h2>
+<h2 id="autoscaling.agones.dev/v1">autoscaling.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="#autoscaling.agones.dev/v1.FleetAutoscaler">FleetAutoscaler</a>
 </li></ul>
-<h3 id="allocation.agones.dev/v1.GameServerAllocation">GameServerAllocation
+<h3 id="autoscaling.agones.dev/v1.FleetAutoscaler">FleetAutoscaler
 </h3>
 <p>
-<p>GameServerAllocation is the data structure for allocating against a set of
-GameServers, defined <code>selectors</code> selectors</p>
+<p>FleetAutoscaler is the data structure for a FleetAutoscaler resource</p>
 </p>
 <table>
 <thead>
@@ -47,7 +46,7 @@ <h3 id="allocation.agones.dev/v1.GameServerAllocation">GameServerAllocation
 string</td>
 <td>
 <code>
-allocation.agones.dev/v1
+autoscaling.agones.dev/v1
 </code>
 </td>
 </tr>
@@ -56,7 +55,7 @@ <h3 id="allocation.agones.dev/v1.GameServerAllocation">GameServerAllocation
 <code>kind</code></br>
 string
 </td>
-<td><code>GameServerAllocation</code></td>
+<td><code>FleetAutoscaler</code></td>
 </tr>
 <tr>
 <td>
@@ -76,8 +75,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="#autoscaling.agones.dev/v1.FleetAutoscalerSpec">
+FleetAutoscalerSpec
 </a>
 </em>
 </td>
@@ -87,135 +86,162 @@ <h3 id="allocation.agones.dev/v1.GameServerAllocation">GameServerAllocation
 <table>
 <tr>
 <td>
-<code>multiClusterSetting</code></br>
+<code>fleetName</code></br>
 <em>
-<a href="#allocation.agones.dev/v1.MultiClusterSetting">
-MultiClusterSetting
-</a>
+string
 </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>
+<code>policy</code></br>
 <em>
-<a href="#allocation.agones.dev/v1.GameServerSelector">
-GameServerSelector
+<a href="#autoscaling.agones.dev/v1.FleetAutoscalerPolicy">
+FleetAutoscalerPolicy
 </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>Autoscaling policy</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>preferred</code></br>
+<code>sync</code></br>
 <em>
-<a href="#allocation.agones.dev/v1.GameServerSelector">
-[]GameServerSelector
+<a href="#autoscaling.agones.dev/v1.FleetAutoscalerSync">
+FleetAutoscalerSync
 </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>[Stage:Beta]
+[FeatureFlag:CustomFasSyncInterval]
+Sync defines when FleetAutoscalers runs autoscaling</p>
+</td>
+</tr>
+</table>
 </td>
 </tr>
 <tr>
 <td>
-<code>priorities</code></br>
+<code>status</code></br>
 <em>
-<a href="#allocation.agones.dev/v1.Priority">
-[]Priority
+<a href="#autoscaling.agones.dev/v1.FleetAutoscalerStatus">
+FleetAutoscalerStatus
 </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>
 </td>
 </tr>
+</tbody>
+</table>
+<h3 id="autoscaling.agones.dev/v1.BufferPolicy">BufferPolicy
+</h3>
+<p>
+(<em>Appears on:</em>
+<a href="#autoscaling.agones.dev/v1.FleetAutoscalerPolicy">FleetAutoscalerPolicy</a>)
+</p>
+<p>
+<p>BufferPolicy controls the desired behavior of the buffer policy.</p>
+</p>
+<table>
+<thead>
+<tr>
+<th>Field</th>
+<th>Description</th>
+</tr>
+</thead>
+<tbody>
 <tr>
 <td>
-<code>selectors</code></br>
+<code>maxReplicas</code></br>
 <em>
-<a href="#allocation.agones.dev/v1.GameServerSelector">
-[]GameServerSelector
-</a>
+int32
 </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>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>metadata</code></br>
+<code>bufferSize</code></br>
 <em>
-<a href="#allocation.agones.dev/v1.MetaPatch">
-MetaPatch
-</a>
+k8s.io/apimachinery/pkg/util/intstr.IntOrString
 </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>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>
-</td>
+<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>
 </tr>
+</thead>
+<tbody>
 <tr>
 <td>
-<code>status</code></br>
+<code>seconds</code></br>
 <em>
-<a href="#allocation.agones.dev/v1.GameServerAllocationStatus">
-GameServerAllocationStatus
-</a>
+int32
 </em>
 </td>
 <td>
+<p>Seconds defines how often we run fleet autoscaling in seconds</p>
 </td>
 </tr>
 </tbody>
 </table>
-<h3 id="allocation.agones.dev/v1.CounterSelector">CounterSelector
+<h3 id="autoscaling.agones.dev/v1.FleetAutoscaleRequest">FleetAutoscaleRequest
 </h3>
 <p>
 (<em>Appears on:</em>
-<a href="#allocation.agones.dev/v1.GameServerSelector">GameServerSelector</a>)
+<a href="#autoscaling.agones.dev/v1.FleetAutoscaleReview">FleetAutoscaleReview</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>FleetAutoscaleRequest defines the request to webhook autoscaler endpoint</p>
 </p>
 <table>
 <thead>
@@ -227,54 +253,63 @@ <h3 id="allocation.agones.dev/v1.CounterSelector">CounterSelector
 <tbody>
 <tr>
 <td>
-<code>minCount</code></br>
+<code>uid</code></br>
 <em>
-int64
+k8s.io/apimachinery/pkg/types.UID
 </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>
 </td>
 </tr>
 <tr>
 <td>
-<code>maxCount</code></br>
+<code>name</code></br>
 <em>
-int64
+string
 </em>
 </td>
 <td>
+<p>Name is the name of the Fleet being scaled</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>minAvailable</code></br>
+<code>namespace</code></br>
 <em>
-int64
+string
 </em>
 </td>
 <td>
+<p>Namespace is the namespace associated with the request (if any).</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>maxAvailable</code></br>
+<code>status</code></br>
 <em>
-int64
+<a href="#agones.dev/v1.FleetStatus">
+FleetStatus
+</a>
 </em>
 </td>
 <td>
+<p>The Fleet&rsquo;s status values</p>
 </td>
 </tr>
 </tbody>
 </table>
-<h3 id="allocation.agones.dev/v1.GameServerAllocationSpec">GameServerAllocationSpec
+<h3 id="autoscaling.agones.dev/v1.FleetAutoscaleResponse">FleetAutoscaleResponse
 </h3>
 <p>
 (<em>Appears on:</em>
-<a href="#allocation.agones.dev/v1.GameServerAllocation">GameServerAllocation</a>)
+<a href="#autoscaling.agones.dev/v1.FleetAutoscaleReview">FleetAutoscaleReview</a>)
 </p>
 <p>
-<p>GameServerAllocationSpec is the spec for a GameServerAllocation</p>
+<p>FleetAutoscaleResponse defines the response of webhook autoscaler endpoint</p>
 </p>
 <table>
 <thead>
@@ -286,128 +321,88 @@ <h3 id="allocation.agones.dev/v1.GameServerAllocationSpec">GameServerAllocationS
 <tbody>
 <tr>
 <td>
-<code>multiClusterSetting</code></br>
+<code>uid</code></br>
 <em>
-<a href="#allocation.agones.dev/v1.MultiClusterSetting">
-MultiClusterSetting
-</a>
+k8s.io/apimachinery/pkg/types.UID
 </em>
 </td>
 <td>
-<p>MultiClusterPolicySelector if specified, multi-cluster policies are applied.
-Otherwise, allocation will happen locally.</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>required</code></br>
+<code>scale</code></br>
 <em>
-<a href="#allocation.agones.dev/v1.GameServerSelector">
-GameServerSelector
-</a>
+bool
 </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>Set to false if no scaling should occur to the Fleet</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>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>
+<th>Field</th>
+<th>Description</th>
+</tr>
+</thead>
+<tbody>
 <tr>
 <td>
-<code>priorities</code></br>
+<code>request</code></br>
 <em>
-<a href="#allocation.agones.dev/v1.Priority">
-[]Priority
+<a href="#autoscaling.agones.dev/v1.FleetAutoscaleRequest">
+FleetAutoscaleRequest
 </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>
 </td>
 </tr>
 <tr>
 <td>
-<code>selectors</code></br>
+<code>response</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>
-<em>
-agones.dev/agones/pkg/apis.SchedulingStrategy
-</em>
-</td>
-<td>
-<p>Scheduling strategy. Defaults to &ldquo;Packed&rdquo;.</p>
-</td>
-</tr>
-<tr>
-<td>
-<code>metadata</code></br>
-<em>
-<a href="#allocation.agones.dev/v1.MetaPatch">
-MetaPatch
+<a href="#autoscaling.agones.dev/v1.FleetAutoscaleResponse">
+FleetAutoscaleResponse
 </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="autoscaling.agones.dev/v1.FleetAutoscalerPolicy">FleetAutoscalerPolicy
 </h3>
 <p>
 (<em>Appears on:</em>
-<a href="#allocation.agones.dev/v1.GameServerAllocation">GameServerAllocation</a>)
+<a href="#autoscaling.agones.dev/v1.FleetAutoscalerSpec">FleetAutoscalerSpec</a>)
 </p>
 <p>
-<p>GameServerAllocationStatus is the status for an GameServerAllocation resource</p>
+<p>FleetAutoscalerPolicy describes how to scale a fleet</p>
 </p>
 <table>
 <thead>
@@ -419,42 +414,77 @@ <h3 id="allocation.agones.dev/v1.GameServerAllocationStatus">GameServerAllocatio
 <tbody>
 <tr>
 <td>
-<code>state</code></br>
+<code>type</code></br>
 <em>
-<a href="#allocation.agones.dev/v1.GameServerAllocationState">
-GameServerAllocationState
+<a href="#autoscaling.agones.dev/v1.FleetAutoscalerPolicyType">
+FleetAutoscalerPolicyType
 </a>
 </em>
 </td>
 <td>
-<p>GameServerState is the current state of an GameServerAllocation, e.g. Allocated, or UnAllocated</p>
+<p>Type of autoscaling policy.</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>gameServerName</code></br>
+<code>buffer</code></br>
 <em>
-string
+<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>ports</code></br>
+<code>webhook</code></br>
 <em>
-<a href="#agones.dev/v1.GameServerStatusPort">
-[]GameServerStatusPort
+<a href="#autoscaling.agones.dev/v1.WebhookPolicy">
+WebhookPolicy
 </a>
 </em>
 </td>
 <td>
+<em>(Optional)</em>
+<p>Webhook policy config params. Present only if FleetAutoscalerPolicyType = Webhook.</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>
+<p>
+(<em>Appears on:</em>
+<a href="#autoscaling.agones.dev/v1.FleetAutoscaler">FleetAutoscaler</a>)
+</p>
+<p>
+<p>FleetAutoscalerSpec is the spec for a Fleet Scaler</p>
+</p>
+<table>
+<thead>
+<tr>
+<th>Field</th>
+<th>Description</th>
+</tr>
+</thead>
+<tbody>
 <tr>
 <td>
-<code>address</code></br>
+<code>fleetName</code></br>
 <em>
 string
 </em>
@@ -464,37 +494,43 @@ <h3 id="allocation.agones.dev/v1.GameServerAllocationStatus">GameServerAllocatio
 </tr>
 <tr>
 <td>
-<code>nodeName</code></br>
+<code>policy</code></br>
 <em>
-string
+<a href="#autoscaling.agones.dev/v1.FleetAutoscalerPolicy">
+FleetAutoscalerPolicy
+</a>
 </em>
 </td>
 <td>
+<p>Autoscaling policy</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>source</code></br>
+<code>sync</code></br>
 <em>
-string
+<a href="#autoscaling.agones.dev/v1.FleetAutoscalerSync">
+FleetAutoscalerSync
+</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>
+<em>(Optional)</em>
+<p>[Stage:Beta]
+[FeatureFlag:CustomFasSyncInterval]
+Sync defines when FleetAutoscalers runs autoscaling</p>
 </td>
 </tr>
 </tbody>
 </table>
-<h3 id="allocation.agones.dev/v1.GameServerSelector">GameServerSelector
+<h3 id="autoscaling.agones.dev/v1.FleetAutoscalerStatus">FleetAutoscalerStatus
 </h3>
 <p>
 (<em>Appears on:</em>
-<a href="#allocation.agones.dev/v1.GameServerAllocationSpec">GameServerAllocationSpec</a>)
+<a href="#autoscaling.agones.dev/v1.FleetAutoscaler">FleetAutoscaler</a>)
 </p>
 <p>
-<p>GameServerSelector contains all the filter options for selecting
-a GameServer for allocation.</p>
+<p>FleetAutoscalerStatus defines the current status of a FleetAutoscaler</p>
 </p>
 <table>
 <thead>
@@ -506,100 +542,75 @@ <h3 id="allocation.agones.dev/v1.GameServerSelector">GameServerSelector
 <tbody>
 <tr>
 <td>
-<code>LabelSelector</code></br>
+<code>currentReplicas</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>
+int32
 </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>
+<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>gameServerState</code></br>
+<code>desiredReplicas</code></br>
 <em>
-<a href="#agones.dev/v1.GameServerState">
-GameServerState
-</a>
+int32
 </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>
+<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>players</code></br>
+<code>lastScaleTime</code></br>
 <em>
-<a href="#allocation.agones.dev/v1.PlayerSelector">
-PlayerSelector
+<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>[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>
+<p>lastScaleTime is the last time the FleetAutoscaler scaled the attached fleet,</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>counters</code></br>
+<code>ableToScale</code></br>
 <em>
-<a href="#allocation.agones.dev/v1.CounterSelector">
-map[string]agones.dev/agones/pkg/apis/allocation/v1.CounterSelector
-</a>
+bool
 </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>AbleToScale indicates that we can access the target fleet</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>lists</code></br>
+<code>scalingLimited</code></br>
 <em>
-<a href="#allocation.agones.dev/v1.ListSelector">
-map[string]agones.dev/agones/pkg/apis/allocation/v1.ListSelector
-</a>
+bool
 </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>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="allocation.agones.dev/v1.ListSelector">ListSelector
+<h3 id="autoscaling.agones.dev/v1.FleetAutoscalerSync">FleetAutoscalerSync
 </h3>
 <p>
 (<em>Appears on:</em>
-<a href="#allocation.agones.dev/v1.GameServerSelector">GameServerSelector</a>)
+<a href="#autoscaling.agones.dev/v1.FleetAutoscalerSpec">FleetAutoscalerSpec</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>FleetAutoscalerSync describes when to sync a fleet</p>
 </p>
 <table>
 <thead>
@@ -611,44 +622,52 @@ <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>type</code></br>
 <em>
-int64
+<a href="#autoscaling.agones.dev/v1.FleetAutoscalerSyncType">
+FleetAutoscalerSyncType
+</a>
 </em>
 </td>
 <td>
+<p>Type of autoscaling sync.</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>maxAvailable</code></br>
+<code>fixedInterval</code></br>
 <em>
-int64
+<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="allocation.agones.dev/v1.MetaPatch">MetaPatch
+<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="#allocation.agones.dev/v1.GameServerAllocationSpec">GameServerAllocationSpec</a>)
+<a href="#autoscaling.agones.dev/v1.FleetAutoscalerPolicy">FleetAutoscalerPolicy</a>)
 </p>
 <p>
-<p>MetaPatch is the metadata used to patch the GameServer metadata on allocation</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>
@@ -660,173 +679,79 @@ <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>url</code></br>
 <em>
-map[string]string
-</em>
-</td>
-<td>
-</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>
-<th>Field</th>
-<th>Description</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td>
-<code>enabled</code></br>
-<em>
-bool
+string
 </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>
 </td>
 </tr>
 <tr>
 <td>
-<code>policySelector</code></br>
+<code>service</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="https://v1-25.docs.kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#servicereference-v1-admissionregistration">
+Kubernetes admissionregistration/v1.ServiceReference
 </a>
 </em>
 </td>
 <td>
-</td>
-</tr>
-</tbody>
-</table>
-<h3 id="allocation.agones.dev/v1.PlayerSelector">PlayerSelector
-</h3>
-<p>
-(<em>Appears on:</em>
-<a href="#allocation.agones.dev/v1.GameServerSelector">GameServerSelector</a>)
-</p>
-<p>
-<p>PlayerSelector is the filter options for a GameServer based on player counts</p>
-</p>
-<table>
-<thead>
-<tr>
-<th>Field</th>
-<th>Description</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td>
-<code>minAvailable</code></br>
-<em>
-int64
-</em>
-</td>
-<td>
-</td>
-</tr>
-<tr>
-<td>
-<code>maxAvailable</code></br>
-<em>
-int64
-</em>
-</td>
-<td>
-</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>
-<em>
-string
-</em>
-</td>
-<td>
-</td>
-</tr>
-<tr>
-<td>
-<code>key</code></br>
-<em>
-string
-</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>
 </td>
 </tr>
 <tr>
 <td>
-<code>order</code></br>
+<code>caBundle</code></br>
 <em>
-string
+[]byte
 </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>
 </td>
 </tr>
 </tbody>
 </table>
 <hr/>
-<h2 id="autoscaling.agones.dev/v1">autoscaling.agones.dev/v1</h2>
+<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="#autoscaling.agones.dev/v1.FleetAutoscaler">FleetAutoscaler</a>
+<a href="#multicluster.agones.dev/v1.GameServerAllocationPolicy">GameServerAllocationPolicy</a>
 </li></ul>
-<h3 id="autoscaling.agones.dev/v1.FleetAutoscaler">FleetAutoscaler
+<h3 id="multicluster.agones.dev/v1.GameServerAllocationPolicy">GameServerAllocationPolicy
 </h3>
 <p>
-<p>FleetAutoscaler is the data structure for a FleetAutoscaler resource</p>
+<p>GameServerAllocationPolicy is the Schema for the gameserverallocationpolicies API</p>
 </p>
 <table>
 <thead>
@@ -842,7 +767,7 @@ <h3 id="autoscaling.agones.dev/v1.FleetAutoscaler">FleetAutoscaler
 string</td>
 <td>
 <code>
-autoscaling.agones.dev/v1
+multicluster.agones.dev/v1
 </code>
 </td>
 </tr>
@@ -851,7 +776,7 @@ <h3 id="autoscaling.agones.dev/v1.FleetAutoscaler">FleetAutoscaler
 <code>kind</code></br>
 string
 </td>
-<td><code>FleetAutoscaler</code></td>
+<td><code>GameServerAllocationPolicy</code></td>
 </tr>
 <tr>
 <td>
@@ -871,8 +796,8 @@ <h3 id="autoscaling.agones.dev/v1.FleetAutoscaler">FleetAutoscaler
 <td>
 <code>spec</code></br>
 <em>
-<a href="#autoscaling.agones.dev/v1.FleetAutoscalerSpec">
-FleetAutoscalerSpec
+<a href="#multicluster.agones.dev/v1.GameServerAllocationPolicySpec">
+GameServerAllocationPolicySpec
 </a>
 </em>
 </td>
@@ -882,9 +807,9 @@ <h3 id="autoscaling.agones.dev/v1.FleetAutoscaler">FleetAutoscaler
 <table>
 <tr>
 <td>
-<code>fleetName</code></br>
+<code>priority</code></br>
 <em>
-string
+int32
 </em>
 </td>
 <td>
@@ -892,58 +817,39 @@ <h3 id="autoscaling.agones.dev/v1.FleetAutoscaler">FleetAutoscaler
 </tr>
 <tr>
 <td>
-<code>policy</code></br>
+<code>weight</code></br>
 <em>
-<a href="#autoscaling.agones.dev/v1.FleetAutoscalerPolicy">
-FleetAutoscalerPolicy
-</a>
+int
 </em>
 </td>
 <td>
-<p>Autoscaling policy</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>sync</code></br>
+<code>connectionInfo</code></br>
 <em>
-<a href="#autoscaling.agones.dev/v1.FleetAutoscalerSync">
-FleetAutoscalerSync
+<a href="#multicluster.agones.dev/v1.ClusterConnectionInfo">
+ClusterConnectionInfo
 </a>
 </em>
 </td>
 <td>
-<em>(Optional)</em>
-<p>[Stage:Beta]
-[FeatureFlag:CustomFasSyncInterval]
-Sync defines when FleetAutoscalers runs autoscaling</p>
 </td>
 </tr>
 </table>
 </td>
 </tr>
-<tr>
-<td>
-<code>status</code></br>
-<em>
-<a href="#autoscaling.agones.dev/v1.FleetAutoscalerStatus">
-FleetAutoscalerStatus
-</a>
-</em>
-</td>
-<td>
-</td>
-</tr>
 </tbody>
 </table>
-<h3 id="autoscaling.agones.dev/v1.BufferPolicy">BufferPolicy
+<h3 id="multicluster.agones.dev/v1.ClusterConnectionInfo">ClusterConnectionInfo
 </h3>
 <p>
 (<em>Appears on:</em>
-<a href="#autoscaling.agones.dev/v1.FleetAutoscalerPolicy">FleetAutoscalerPolicy</a>)
+<a href="#multicluster.agones.dev/v1.GameServerAllocationPolicySpec">GameServerAllocationPolicySpec</a>)
 </p>
 <p>
-<p>BufferPolicy controls the desired behavior of the buffer policy.</p>
+<p>ClusterConnectionInfo defines the connection information for a cluster</p>
 </p>
 <table>
 <thead>
@@ -955,89 +861,67 @@ <h3 id="autoscaling.agones.dev/v1.BufferPolicy">BufferPolicy
 <tbody>
 <tr>
 <td>
-<code>maxReplicas</code></br>
+<code>clusterName</code></br>
 <em>
-int32
+string
 </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>Optional: the name of the targeted cluster</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>minReplicas</code></br>
+<code>allocationEndpoints</code></br>
 <em>
-int32
+[]string
 </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>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>bufferSize</code></br>
+<code>secretName</code></br>
 <em>
-k8s.io/apimachinery/pkg/util/intstr.IntOrString
+string
 </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>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="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>
-</tr>
-</thead>
-<tbody>
 <tr>
 <td>
-<code>seconds</code></br>
+<code>namespace</code></br>
 <em>
-int32
+string
 </em>
 </td>
 <td>
-<p>Seconds defines how often we run fleet autoscaling in seconds</p>
+<p>The cluster namespace from which to allocate gameservers</p>
+</td>
+</tr>
+<tr>
+<td>
+<code>serverCa</code></br>
+<em>
+[]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="autoscaling.agones.dev/v1.FleetAutoscaleRequest">FleetAutoscaleRequest
+<h3 id="multicluster.agones.dev/v1.ConnectionInfoIterator">ConnectionInfoIterator
 </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>ConnectionInfoIterator an iterator on ClusterConnectionInfo</p>
 </p>
 <table>
 <thead>
@@ -1049,63 +933,58 @@ <h3 id="autoscaling.agones.dev/v1.FleetAutoscaleRequest">FleetAutoscaleRequest
 <tbody>
 <tr>
 <td>
-<code>uid</code></br>
+<code>currPriority</code></br>
 <em>
-k8s.io/apimachinery/pkg/types.UID
+int
 </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>currPriority Current priority index from the orderedPriorities</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>name</code></br>
+<code>orderedPriorities</code></br>
 <em>
-string
+[]int32
 </em>
 </td>
 <td>
-<p>Name is the name of the Fleet being scaled</p>
+<p>orderedPriorities list of ordered priorities</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>namespace</code></br>
+<code>priorityToCluster</code></br>
 <em>
-string
+map[int32]map[string][]*agones.dev/agones/pkg/apis/multicluster/v1.GameServerAllocationPolicy
 </em>
 </td>
 <td>
-<p>Namespace is the namespace associated with the request (if any).</p>
+<p>priorityToCluster Map of priority to cluster-policies map</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>status</code></br>
+<code>clusterBlackList</code></br>
 <em>
-<a href="#agones.dev/v1.FleetStatus">
-FleetStatus
-</a>
+map[string]bool
 </em>
 </td>
 <td>
-<p>The Fleet&rsquo;s status values</p>
+<p>clusterBlackList the cluster blacklist for the clusters that has already returned</p>
 </td>
 </tr>
 </tbody>
 </table>
-<h3 id="autoscaling.agones.dev/v1.FleetAutoscaleResponse">FleetAutoscaleResponse
+<h3 id="multicluster.agones.dev/v1.GameServerAllocationPolicySpec">GameServerAllocationPolicySpec
 </h3>
 <p>
 (<em>Appears on:</em>
-<a href="#autoscaling.agones.dev/v1.FleetAutoscaleReview">FleetAutoscaleReview</a>)
+<a href="#multicluster.agones.dev/v1.GameServerAllocationPolicy">GameServerAllocationPolicy</a>)
 </p>
 <p>
-<p>FleetAutoscaleResponse defines the response of webhook autoscaler endpoint</p>
+<p>GameServerAllocationPolicySpec defines the desired state of GameServerAllocationPolicy</p>
 </p>
 <table>
 <thead>
@@ -1117,45 +996,55 @@ <h3 id="autoscaling.agones.dev/v1.FleetAutoscaleResponse">FleetAutoscaleResponse
 <tbody>
 <tr>
 <td>
-<code>uid</code></br>
+<code>priority</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>
 </td>
 </tr>
 <tr>
 <td>
-<code>scale</code></br>
+<code>weight</code></br>
 <em>
-bool
+int
 </em>
 </td>
 <td>
-<p>Set to false if no scaling should occur to the Fleet</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>replicas</code></br>
+<code>connectionInfo</code></br>
 <em>
-int32
+<a href="#multicluster.agones.dev/v1.ClusterConnectionInfo">
+ClusterConnectionInfo
+</a>
 </em>
 </td>
 <td>
-<p>The targeted replica count</p>
 </td>
 </tr>
 </tbody>
 </table>
-<h3 id="autoscaling.agones.dev/v1.FleetAutoscaleReview">FleetAutoscaleReview
+<hr/>
+<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="#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="agones.dev/v1.Fleet">Fleet
 </h3>
 <p>
-<p>FleetAutoscaleReview is passed to the webhook with a populated Request value,
-and then returned with a populated Response.</p>
+<p>Fleet is the data structure for a Fleet resource</p>
 </p>
 <table>
 <thead>
@@ -1167,166 +1056,138 @@ <h3 id="autoscaling.agones.dev/v1.FleetAutoscaleReview">FleetAutoscaleReview
 <tbody>
 <tr>
 <td>
-<code>request</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>Fleet</code></td>
+</tr>
+<tr>
+<td>
+<code>metadata</code></br>
 <em>
-<a href="#autoscaling.agones.dev/v1.FleetAutoscaleRequest">
-FleetAutoscaleRequest
+<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>response</code></br>
+<code>spec</code></br>
 <em>
-<a href="#autoscaling.agones.dev/v1.FleetAutoscaleResponse">
-FleetAutoscaleResponse
+<a href="#agones.dev/v1.FleetSpec">
+FleetSpec
 </a>
 </em>
 </td>
 <td>
-</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>
+<br/>
+<br/>
 <table>
-<thead>
-<tr>
-<th>Field</th>
-<th>Description</th>
-</tr>
-</thead>
-<tbody>
 <tr>
 <td>
-<code>type</code></br>
+<code>replicas</code></br>
 <em>
-<a href="#autoscaling.agones.dev/v1.FleetAutoscalerPolicyType">
-FleetAutoscalerPolicyType
-</a>
+int32
 </em>
 </td>
 <td>
-<p>Type of autoscaling policy.</p>
+<p>Replicas are the number of GameServers that should be in this set. Defaults to 0.</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>buffer</code></br>
+<code>allocationOverflow</code></br>
 <em>
-<a href="#autoscaling.agones.dev/v1.BufferPolicy">
-BufferPolicy
+<a href="#agones.dev/v1.AllocationOverflow">
+AllocationOverflow
 </a>
 </em>
 </td>
 <td>
 <em>(Optional)</em>
-<p>Buffer policy config params. Present only if FleetAutoscalerPolicyType = Buffer.</p>
+<p>[Stage: Alpha]
+[FeatureFlag:FleetAllocationOverflow]
+Labels and/or Annotations to apply to overflowing GameServers when the number of Allocated GameServers is more
+than the desired replicas on the underlying <code>GameServerSet</code></p>
 </td>
 </tr>
 <tr>
 <td>
-<code>webhook</code></br>
+<code>strategy</code></br>
 <em>
-<a href="#autoscaling.agones.dev/v1.WebhookPolicy">
-WebhookPolicy
+<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>
-<em>(Optional)</em>
-<p>Webhook policy config params. Present only if FleetAutoscalerPolicyType = Webhook.</p>
+<p>Deployment strategy</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>
-<p>
-(<em>Appears on:</em>
-<a href="#autoscaling.agones.dev/v1.FleetAutoscaler">FleetAutoscaler</a>)
-</p>
-<p>
-<p>FleetAutoscalerSpec is the spec for a Fleet Scaler</p>
-</p>
-<table>
-<thead>
-<tr>
-<th>Field</th>
-<th>Description</th>
-</tr>
-</thead>
-<tbody>
 <tr>
 <td>
-<code>fleetName</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>policy</code></br>
+<code>template</code></br>
 <em>
-<a href="#autoscaling.agones.dev/v1.FleetAutoscalerPolicy">
-FleetAutoscalerPolicy
+<a href="#agones.dev/v1.GameServerTemplateSpec">
+GameServerTemplateSpec
 </a>
 </em>
 </td>
 <td>
-<p>Autoscaling policy</p>
+<p>Template the GameServer template to apply for this Fleet</p>
+</td>
+</tr>
+</table>
 </td>
 </tr>
 <tr>
 <td>
-<code>sync</code></br>
+<code>status</code></br>
 <em>
-<a href="#autoscaling.agones.dev/v1.FleetAutoscalerSync">
-FleetAutoscalerSync
+<a href="#agones.dev/v1.FleetStatus">
+FleetStatus
 </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 id="agones.dev/v1.GameServer">GameServer
 </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>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>
@@ -1338,216 +1199,200 @@ <h3 id="autoscaling.agones.dev/v1.FleetAutoscalerStatus">FleetAutoscalerStatus
 <tbody>
 <tr>
 <td>
-<code>currentReplicas</code></br>
-<em>
-int32
-</em>
+<code>apiVersion</code></br>
+string</td>
+<td>
+<code>
+agones.dev/v1
+</code>
 </td>
+</tr>
+<tr>
 <td>
-<p>CurrentReplicas is the current number of gameserver replicas
-of the fleet managed by this autoscaler, as last seen by the autoscaler</p>
+<code>kind</code></br>
+string
 </td>
+<td><code>GameServer</code></td>
 </tr>
 <tr>
 <td>
-<code>desiredReplicas</code></br>
+<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>DesiredReplicas is the desired number of gameserver replicas
-of the fleet managed by this autoscaler, as last calculated by the autoscaler</p>
+Refer to the Kubernetes API documentation for the fields of the
+<code>metadata</code> field.
 </td>
 </tr>
 <tr>
 <td>
-<code>lastScaleTime</code></br>
+<code>spec</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.GameServerSpec">
+GameServerSpec
 </a>
 </em>
 </td>
 <td>
-<em>(Optional)</em>
-<p>lastScaleTime is the last time the FleetAutoscaler scaled the attached fleet,</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>ableToScale</code></br>
+<code>ports</code></br>
 <em>
-bool
+<a href="#agones.dev/v1.GameServerPort">
+[]GameServerPort
+</a>
 </em>
 </td>
 <td>
-<p>AbleToScale indicates that we can access the target fleet</p>
+<p>Ports are the array of ports that can be exposed via the game server</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>scalingLimited</code></br>
+<code>health</code></br>
 <em>
-bool
+<a href="#agones.dev/v1.Health">
+Health
+</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>
+<p>Health configures health checking</p>
 </td>
 </tr>
-</tbody>
-</table>
-<h3 id="autoscaling.agones.dev/v1.FleetAutoscalerSync">FleetAutoscalerSync
-</h3>
-<p>
-(<em>Appears on:</em>
-<a href="#autoscaling.agones.dev/v1.FleetAutoscalerSpec">FleetAutoscalerSpec</a>)
-</p>
-<p>
-<p>FleetAutoscalerSync describes when to sync a fleet</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>type</code></br>
+<code>sdkServer</code></br>
 <em>
-<a href="#autoscaling.agones.dev/v1.FleetAutoscalerSyncType">
-FleetAutoscalerSyncType
+<a href="#agones.dev/v1.SdkServer">
+SdkServer
 </a>
 </em>
 </td>
 <td>
-<p>Type of autoscaling sync.</p>
+<p>SdkServer specifies parameters for the Agones SDK Server sidecar container</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>fixedInterval</code></br>
+<code>template</code></br>
 <em>
-<a href="#autoscaling.agones.dev/v1.FixedIntervalSync">
-FixedIntervalSync
+<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>
-<em>(Optional)</em>
-<p>FixedInterval config params. Present only if FleetAutoscalerSyncType = FixedInterval.</p>
+<p>Template describes the Pod that will be created for the GameServer</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>
-<p>
-(<em>Appears on:</em>
-<a href="#autoscaling.agones.dev/v1.FleetAutoscalerPolicy">FleetAutoscalerPolicy</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>
-<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>url</code></br>
+<code>counters</code></br>
 <em>
-string
+<a href="#agones.dev/v1.CounterStatus">
+map[string]agones.dev/agones/pkg/apis/agones/v1.CounterStatus
+</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>
+<p>(Alpha, CountsAndLists feature flag) Counters and Lists provides the configuration for generic tracking features.</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>service</code></br>
+<code>lists</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.ListStatus">
+map[string]agones.dev/agones/pkg/apis/agones/v1.ListStatus
 </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>
 </td>
 </tr>
 <tr>
 <td>
-<code>caBundle</code></br>
+<code>eviction</code></br>
 <em>
-[]byte
+<a href="#agones.dev/v1.Eviction">
+Eviction
+</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>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>
+<em>
+<a href="#agones.dev/v1.GameServerStatus">
+GameServerStatus
+</a>
+</em>
+</td>
+<td>
 </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 id="agones.dev/v1.GameServerSet">GameServerSet
 </h3>
 <p>
-<p>GameServerAllocationPolicy is the Schema for the gameserverallocationpolicies API</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>
@@ -1563,7 +1408,7 @@ <h3 id="multicluster.agones.dev/v1.GameServerAllocationPolicy">GameServerAllocat
 string</td>
 <td>
 <code>
-multicluster.agones.dev/v1
+agones.dev/v1
 </code>
 </td>
 </tr>
@@ -1572,7 +1417,7 @@ <h3 id="multicluster.agones.dev/v1.GameServerAllocationPolicy">GameServerAllocat
 <code>kind</code></br>
 string
 </td>
-<td><code>GameServerAllocationPolicy</code></td>
+<td><code>GameServerSet</code></td>
 </tr>
 <tr>
 <td>
@@ -1592,8 +1437,8 @@ <h3 id="multicluster.agones.dev/v1.GameServerAllocationPolicy">GameServerAllocat
 <td>
 <code>spec</code></br>
 <em>
-<a href="#multicluster.agones.dev/v1.GameServerAllocationPolicySpec">
-GameServerAllocationPolicySpec
+<a href="#agones.dev/v1.GameServerSetSpec">
+GameServerSetSpec
 </a>
 </em>
 </td>
@@ -1603,49 +1448,82 @@ <h3 id="multicluster.agones.dev/v1.GameServerAllocationPolicy">GameServerAllocat
 <table>
 <tr>
 <td>
-<code>priority</code></br>
+<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>weight</code></br>
+<code>allocationOverflow</code></br>
 <em>
-int
+<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>connectionInfo</code></br>
+<code>scheduling</code></br>
 <em>
-<a href="#multicluster.agones.dev/v1.ClusterConnectionInfo">
-ClusterConnectionInfo
+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>
-</tbody>
-</table>
-<h3 id="multicluster.agones.dev/v1.ClusterConnectionInfo">ClusterConnectionInfo
-</h3>
-<p>
-(<em>Appears on:</em>
-<a href="#multicluster.agones.dev/v1.GameServerAllocationPolicySpec">GameServerAllocationPolicySpec</a>)
-</p>
-<p>
-<p>ClusterConnectionInfo defines the connection information for a cluster</p>
+<tr>
+<td>
+<code>status</code></br>
+<em>
+<a href="#agones.dev/v1.GameServerSetStatus">
+GameServerSetStatus
+</a>
+</em>
+</td>
+<td>
+</td>
+</tr>
+</tbody>
+</table>
+<h3 id="agones.dev/v1.AggregatedPlayerStatus">AggregatedPlayerStatus
+</h3>
+<p>
+(<em>Appears on:</em>
+<a href="#agones.dev/v1.FleetStatus">FleetStatus</a>, 
+<a href="#agones.dev/v1.GameServerSetStatus">GameServerSetStatus</a>)
+</p>
+<p>
+<p>AggregatedPlayerStatus stores total player tracking values</p>
 </p>
 <table>
 <thead>
@@ -1657,67 +1535,81 @@ <h3 id="multicluster.agones.dev/v1.ClusterConnectionInfo">ClusterConnectionInfo
 <tbody>
 <tr>
 <td>
-<code>clusterName</code></br>
+<code>count</code></br>
 <em>
-string
+int64
 </em>
 </td>
 <td>
-<p>Optional: the name of the targeted cluster</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>allocationEndpoints</code></br>
+<code>capacity</code></br>
 <em>
-[]string
+int64
 </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>
 </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>secretName</code></br>
-<em>
-string
-</em>
-</td>
-<td>
-<p>The name of the secret that contains TLS client certificates to connect the allocator server in the targeted cluster</p>
-</td>
+<th>Field</th>
+<th>Description</th>
 </tr>
+</thead>
+<tbody>
 <tr>
 <td>
-<code>namespace</code></br>
+<code>labels</code></br>
 <em>
-string
+map[string]string
 </em>
 </td>
 <td>
-<p>The cluster namespace from which to allocate gameservers</p>
+<em>(Optional)</em>
+<p>Labels to be applied to the <code>GameServer</code></p>
 </td>
 </tr>
 <tr>
 <td>
-<code>serverCa</code></br>
+<code>annotations</code></br>
 <em>
-[]byte
+map[string]string
 </em>
 </td>
 <td>
-<p>The PEM encoded server CA, used by the allocator client to authenticate the remote server.</p>
+<em>(Optional)</em>
+<p>Annotations to be applied to the <code>GameServer</code></p>
 </td>
 </tr>
 </tbody>
 </table>
-<h3 id="multicluster.agones.dev/v1.ConnectionInfoIterator">ConnectionInfoIterator
+<h3 id="agones.dev/v1.CounterStatus">CounterStatus
 </h3>
 <p>
-<p>ConnectionInfoIterator an iterator on ClusterConnectionInfo</p>
+(<em>Appears on:</em>
+<a href="#agones.dev/v1.GameServerSpec">GameServerSpec</a>, 
+<a href="#agones.dev/v1.GameServerStatus">GameServerStatus</a>)
+</p>
+<p>
+<p>CounterStatus stores the current counter values</p>
 </p>
 <table>
 <thead>
@@ -1729,58 +1621,35 @@ <h3 id="multicluster.agones.dev/v1.ConnectionInfoIterator">ConnectionInfoIterato
 <tbody>
 <tr>
 <td>
-<code>currPriority</code></br>
-<em>
-int
-</em>
-</td>
-<td>
-<p>currPriority Current priority index from the orderedPriorities</p>
-</td>
-</tr>
-<tr>
-<td>
-<code>orderedPriorities</code></br>
-<em>
-[]int32
-</em>
-</td>
-<td>
-<p>orderedPriorities list of ordered priorities</p>
-</td>
-</tr>
-<tr>
-<td>
-<code>priorityToCluster</code></br>
+<code>count</code></br>
 <em>
-map[int32]map[string][]*agones.dev/agones/pkg/apis/multicluster/v1.GameServerAllocationPolicy
+int64
 </em>
 </td>
 <td>
-<p>priorityToCluster Map of priority to cluster-policies map</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>clusterBlackList</code></br>
+<code>capacity</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.Eviction">Eviction
 </h3>
 <p>
 (<em>Appears on:</em>
-<a href="#multicluster.agones.dev/v1.GameServerAllocationPolicy">GameServerAllocationPolicy</a>)
+<a href="#agones.dev/v1.GameServerSpec">GameServerSpec</a>, 
+<a href="#agones.dev/v1.GameServerStatus">GameServerStatus</a>)
 </p>
 <p>
-<p>GameServerAllocationPolicySpec defines the desired state of GameServerAllocationPolicy</p>
+<p>Eviction specifies the eviction tolerance of the GameServer</p>
 </p>
 <table>
 <thead>
@@ -1792,55 +1661,39 @@ <h3 id="multicluster.agones.dev/v1.GameServerAllocationPolicySpec">GameServerAll
 <tbody>
 <tr>
 <td>
-<code>priority</code></br>
-<em>
-int32
-</em>
-</td>
-<td>
-</td>
-</tr>
-<tr>
-<td>
-<code>weight</code></br>
-<em>
-int
-</em>
-</td>
-<td>
-</td>
-</tr>
-<tr>
-<td>
-<code>connectionInfo</code></br>
+<code>safe</code></br>
 <em>
-<a href="#multicluster.agones.dev/v1.ClusterConnectionInfo">
-ClusterConnectionInfo
+<a href="#agones.dev/v1.EvictionSafe">
+EvictionSafe
 </a>
 </em>
 </td>
 <td>
+<p>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>
-<hr/>
-<h2 id="agones.dev/v1">agones.dev/v1</h2>
+<h3 id="agones.dev/v1.EvictionSafe">EvictionSafe
+(<code>string</code> alias)</p></h3>
 <p>
-<p>Package v1 is the v1 version of the API.</p>
+(<em>Appears on:</em>
+<a href="#agones.dev/v1.Eviction">Eviction</a>)
 </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>
-</li></ul>
-<h3 id="agones.dev/v1.Fleet">Fleet
+<p>
+<p>EvictionSafe specified whether the game server supports termination via SIGTERM</p>
+</p>
+<h3 id="agones.dev/v1.FleetSpec">FleetSpec
 </h3>
 <p>
-<p>Fleet is the data structure for a Fleet resource</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>
@@ -1852,50 +1705,6 @@ <h3 id="agones.dev/v1.Fleet">Fleet
 <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>Fleet</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.FleetSpec">
-FleetSpec
-</a>
-</em>
-</td>
-<td>
-<br/>
-<br/>
-<table>
-<tr>
-<td>
 <code>replicas</code></br>
 <em>
 int32
@@ -1918,8 +1727,8 @@ <h3 id="agones.dev/v1.Fleet">Fleet
 <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>
+Labels and/or Annotations to apply to overflowing GameServers when the number of Allocated GameServers is more
+than the desired replicas on the underlying <code>GameServerSet</code></p>
 </td>
 </tr>
 <tr>
@@ -1959,236 +1768,192 @@ <h3 id="agones.dev/v1.Fleet">Fleet
 <p>Template the GameServer template to apply for this Fleet</p>
 </td>
 </tr>
+</tbody>
 </table>
-</td>
+<h3 id="agones.dev/v1.FleetStatus">FleetStatus
+</h3>
+<p>
+(<em>Appears on:</em>
+<a href="#agones.dev/v1.Fleet">Fleet</a>, 
+<a href="#autoscaling.agones.dev/v1.FleetAutoscaleRequest">FleetAutoscaleRequest</a>)
+</p>
+<p>
+<p>FleetStatus is the status of a Fleet</p>
+</p>
+<table>
+<thead>
+<tr>
+<th>Field</th>
+<th>Description</th>
 </tr>
+</thead>
+<tbody>
 <tr>
 <td>
-<code>status</code></br>
+<code>replicas</code></br>
 <em>
-<a href="#agones.dev/v1.FleetStatus">
-FleetStatus
-</a>
+int32
 </em>
 </td>
 <td>
+<p>Replicas the total number of current GameServer replicas</p>
 </td>
 </tr>
-</tbody>
-</table>
-<h3 id="agones.dev/v1.GameServer">GameServer
-</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>
-</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>
-</td>
-</tr>
-<tr>
-<td>
-<code>kind</code></br>
-string
-</td>
-<td><code>GameServer</code></td>
-</tr>
 <tr>
 <td>
-<code>metadata</code></br>
+<code>readyReplicas</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>
+int32
 </em>
 </td>
 <td>
-Refer to the Kubernetes API documentation for the fields of the
-<code>metadata</code> field.
+<p>ReadyReplicas are the number of Ready GameServer replicas</p>
 </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>reservedReplicas</code></br>
 <em>
-string
+int32
 </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>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>ports</code></br>
+<code>allocatedReplicas</code></br>
 <em>
-<a href="#agones.dev/v1.GameServerPort">
-[]GameServerPort
-</a>
+int32
 </em>
 </td>
 <td>
-<p>Ports are the array of ports that can be exposed via the game server</p>
+<p>AllocatedReplicas are the number of Allocated GameServer replicas</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>health</code></br>
+<code>players</code></br>
 <em>
-<a href="#agones.dev/v1.Health">
-Health
+<a href="#agones.dev/v1.AggregatedPlayerStatus">
+AggregatedPlayerStatus
 </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>
+<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>
+<p>
+(<em>Appears on:</em>
+<a href="#agones.dev/v1.GameServerSpec">GameServerSpec</a>)
+</p>
+<p>
+<p>GameServerPort defines a set of Ports that
+are to be exposed via the GameServer</p>
+</p>
+<table>
+<thead>
 <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>
+<th>Field</th>
+<th>Description</th>
 </tr>
+</thead>
+<tbody>
 <tr>
 <td>
-<code>template</code></br>
+<code>name</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>
+string
 </em>
 </td>
 <td>
-<p>Template describes the Pod that will be created for the GameServer</p>
+<p>Name is the descriptive name of the port</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>players</code></br>
+<code>portPolicy</code></br>
 <em>
-<a href="#agones.dev/v1.PlayersSpec">
-PlayersSpec
+<a href="#agones.dev/v1.PortPolicy">
+PortPolicy
 </a>
 </em>
 </td>
 <td>
-<em>(Optional)</em>
-<p>(Alpha, PlayerTracking feature flag) Players provides the configuration for player tracking features.</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>counters</code></br>
+<code>container</code></br>
 <em>
-<a href="#agones.dev/v1.CounterStatus">
-map[string]agones.dev/agones/pkg/apis/agones/v1.CounterStatus
-</a>
+string
 </em>
 </td>
 <td>
 <em>(Optional)</em>
-<p>(Alpha, CountsAndLists feature flag) Counters and Lists provides the configuration for generic tracking features.</p>
+<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>lists</code></br>
+<code>containerPort</code></br>
 <em>
-<a href="#agones.dev/v1.ListStatus">
-map[string]agones.dev/agones/pkg/apis/agones/v1.ListStatus
-</a>
+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>eviction</code></br>
+<code>hostPort</code></br>
 <em>
-<a href="#agones.dev/v1.Eviction">
-Eviction
-</a>
+int32
 </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>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="#agones.dev/v1.GameServerStatus">
-GameServerStatus
+<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="agones.dev/v1.GameServerSet">GameServerSet
+<h3 id="agones.dev/v1.GameServerSetSpec">GameServerSetSpec
 </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="#agones.dev/v1.GameServerSet">GameServerSet</a>)
+</p>
+<p>
+<p>GameServerSetSpec the specification for GameServerSet</p>
 </p>
 <table>
 <thead>
@@ -2200,50 +1965,6 @@ <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>
-<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.GameServerSetSpec">
-GameServerSetSpec
-</a>
-</em>
-</td>
-<td>
-<br/>
-<br/>
-<table>
-<tr>
-<td>
 <code>replicas</code></br>
 <em>
 int32
@@ -2294,32 +2015,16 @@ <h3 id="agones.dev/v1.GameServerSet">GameServerSet
 <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="agones.dev/v1.AggregatedPlayerStatus">AggregatedPlayerStatus
+<h3 id="agones.dev/v1.GameServerSetStatus">GameServerSetStatus
 </h3>
 <p>
 (<em>Appears on:</em>
-<a href="#agones.dev/v1.FleetStatus">FleetStatus</a>, 
-<a href="#agones.dev/v1.GameServerSetStatus">GameServerSetStatus</a>)
+<a href="#agones.dev/v1.GameServerSet">GameServerSet</a>)
 </p>
 <p>
-<p>AggregatedPlayerStatus stores total player tracking values</p>
+<p>GameServerSetStatus is the status of a GameServerSet</p>
 </p>
 <table>
 <thead>
@@ -2331,166 +2036,86 @@ <h3 id="agones.dev/v1.AggregatedPlayerStatus">AggregatedPlayerStatus
 <tbody>
 <tr>
 <td>
-<code>count</code></br>
-<em>
-int64
-</em>
-</td>
-<td>
-</td>
-</tr>
-<tr>
-<td>
-<code>capacity</code></br>
+<code>replicas</code></br>
 <em>
-int64
+int32
 </em>
 </td>
 <td>
+<p>Replicas is the total number of current GameServer replicas</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>
-</thead>
-<tbody>
 <tr>
 <td>
-<code>labels</code></br>
+<code>readyReplicas</code></br>
 <em>
-map[string]string
+int32
 </em>
 </td>
 <td>
-<em>(Optional)</em>
-<p>Labels to be applied to the <code>GameServer</code></p>
+<p>ReadyReplicas is the number of Ready GameServer replicas</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>annotations</code></br>
+<code>reservedReplicas</code></br>
 <em>
-map[string]string
+int32
 </em>
 </td>
 <td>
-<em>(Optional)</em>
-<p>Annotations to be applied to the <code>GameServer</code></p>
+<p>ReservedReplicas is the number of Reserved GameServer replicas</p>
 </td>
 </tr>
-</tbody>
-</table>
-<h3 id="agones.dev/v1.CounterStatus">CounterStatus
-</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>CounterStatus stores the current counter values</p>
-</p>
-<table>
-<thead>
-<tr>
-<th>Field</th>
-<th>Description</th>
-</tr>
-</thead>
-<tbody>
 <tr>
 <td>
-<code>count</code></br>
+<code>allocatedReplicas</code></br>
 <em>
-int64
+int32
 </em>
 </td>
 <td>
+<p>AllocatedReplicas is the number of Allocated GameServer replicas</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>capacity</code></br>
+<code>shutdownReplicas</code></br>
 <em>
-int64
+int32
 </em>
 </td>
 <td>
+<p>ShutdownReplicas is the number of Shutdown GameServers replicas</p>
 </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>players</code></br>
 <em>
-<a href="#agones.dev/v1.EvictionSafe">
-EvictionSafe
+<a href="#agones.dev/v1.AggregatedPlayerStatus">
+AggregatedPlayerStatus
 </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>
+<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="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="agones.dev/v1.GameServerSpec">GameServerSpec
 </h3>
 <p>
 (<em>Appears on:</em>
-<a href="#agones.dev/v1.Fleet">Fleet</a>)
+<a href="#agones.dev/v1.GameServer">GameServer</a>, 
+<a href="#agones.dev/v1.GameServerTemplateSpec">GameServerTemplateSpec</a>)
 </p>
 <p>
-<p>FleetSpec is the spec for a Fleet</p>
+<p>GameServerSpec is the spec for a GameServer resource</p>
 </p>
 <table>
 <thead>
@@ -2502,43 +2127,40 @@ <h3 id="agones.dev/v1.FleetSpec">FleetSpec
 <tbody>
 <tr>
 <td>
-<code>replicas</code></br>
+<code>container</code></br>
 <em>
-int32
+string
 </em>
 </td>
 <td>
-<p>Replicas are the number of GameServers that should be in this set. Defaults to 0.</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>allocationOverflow</code></br>
+<code>ports</code></br>
 <em>
-<a href="#agones.dev/v1.AllocationOverflow">
-AllocationOverflow
+<a href="#agones.dev/v1.GameServerPort">
+[]GameServerPort
 </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>Ports are the array of ports that can be exposed via the game server</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>strategy</code></br>
+<code>health</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="#agones.dev/v1.Health">
+Health
 </a>
 </em>
 </td>
 <td>
-<p>Deployment strategy</p>
+<p>Health configures health checking</p>
 </td>
 </tr>
 <tr>
@@ -2549,114 +2171,109 @@ <h3 id="agones.dev/v1.FleetSpec">FleetSpec
 </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>template</code></br>
+<code>sdkServer</code></br>
 <em>
-<a href="#agones.dev/v1.GameServerTemplateSpec">
-GameServerTemplateSpec
+<a href="#agones.dev/v1.SdkServer">
+SdkServer
 </a>
 </em>
 </td>
 <td>
-<p>Template the GameServer template to apply for this Fleet</p>
+<p>SdkServer specifies parameters for the Agones SDK Server sidecar container</p>
 </td>
 </tr>
-</tbody>
-</table>
-<h3 id="agones.dev/v1.FleetStatus">FleetStatus
-</h3>
-<p>
-(<em>Appears on:</em>
-<a href="#agones.dev/v1.Fleet">Fleet</a>, 
-<a href="#autoscaling.agones.dev/v1.FleetAutoscaleRequest">FleetAutoscaleRequest</a>)
-</p>
-<p>
-<p>FleetStatus is the status of a Fleet</p>
-</p>
-<table>
-<thead>
-<tr>
-<th>Field</th>
-<th>Description</th>
-</tr>
-</thead>
-<tbody>
 <tr>
 <td>
-<code>replicas</code></br>
+<code>template</code></br>
 <em>
-int32
+<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>Replicas the total number of current GameServer replicas</p>
+<p>Template describes the Pod that will be created for the GameServer</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>readyReplicas</code></br>
+<code>players</code></br>
 <em>
-int32
+<a href="#agones.dev/v1.PlayersSpec">
+PlayersSpec
+</a>
 </em>
 </td>
 <td>
-<p>ReadyReplicas are the number of Ready GameServer replicas</p>
+<em>(Optional)</em>
+<p>(Alpha, PlayerTracking feature flag) Players provides the configuration for player tracking features.</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>reservedReplicas</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>
-<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>
+<em>(Optional)</em>
+<p>(Alpha, CountsAndLists feature flag) Counters and Lists provides the configuration for generic tracking features.</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>allocatedReplicas</code></br>
+<code>lists</code></br>
 <em>
-int32
+<a href="#agones.dev/v1.ListStatus">
+map[string]agones.dev/agones/pkg/apis/agones/v1.ListStatus
+</a>
 </em>
 </td>
 <td>
-<p>AllocatedReplicas are the number of Allocated GameServer replicas</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>players</code></br>
+<code>eviction</code></br>
 <em>
-<a href="#agones.dev/v1.AggregatedPlayerStatus">
-AggregatedPlayerStatus
+<a href="#agones.dev/v1.Eviction">
+Eviction
 </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>
+<p>Eviction specifies the eviction tolerance of the GameServer. Defaults to &ldquo;Never&rdquo;.</p>
 </td>
 </tr>
 </tbody>
 </table>
-<h3 id="agones.dev/v1.GameServerPort">GameServerPort
+<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="#agones.dev/v1.GameServerSpec">GameServerSpec</a>)
+<a href="#agones.dev/v1.GameServer">GameServer</a>)
 </p>
 <p>
-<p>GameServerPort defines a set of Ports that
-are to be exposed via the GameServer</p>
+<p>GameServerStatus is the status for a GameServer resource</p>
 </p>
 <table>
 <thead>
@@ -2668,160 +2285,129 @@ <h3 id="agones.dev/v1.GameServerPort">GameServerPort
 <tbody>
 <tr>
 <td>
-<code>name</code></br>
+<code>state</code></br>
 <em>
-string
+<a href="#agones.dev/v1.GameServerState">
+GameServerState
+</a>
 </em>
 </td>
 <td>
-<p>Name is the descriptive name of the port</p>
+<p>GameServerState is the current state of a GameServer, e.g. Creating, Starting, Ready, etc</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>portPolicy</code></br>
+<code>ports</code></br>
 <em>
-<a href="#agones.dev/v1.PortPolicy">
-PortPolicy
+<a href="#agones.dev/v1.GameServerStatusPort">
+[]GameServerStatusPort
 </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>
+<code>address</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>
-<em>
-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>
+<code>nodeName</code></br>
 <em>
-int32
+string
 </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>
+<code>reservedUntil</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="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>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>
-<p>
-(<em>Appears on:</em>
-<a href="#agones.dev/v1.GameServerSet">GameServerSet</a>)
-</p>
-<p>
-<p>GameServerSetSpec the specification for GameServerSet</p>
-</p>
-<table>
-<thead>
-<tr>
-<th>Field</th>
-<th>Description</th>
-</tr>
-</thead>
-<tbody>
 <tr>
 <td>
-<code>replicas</code></br>
+<code>players</code></br>
 <em>
-int32
+<a href="#agones.dev/v1.PlayerStatus">
+PlayerStatus
+</a>
 </em>
 </td>
 <td>
-<p>Replicas are the number of GameServers that should be in this set</p>
+<em>(Optional)</em>
+<p>[Stage:Alpha]
+[FeatureFlag:PlayerTracking]</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>allocationOverflow</code></br>
+<code>counters</code></br>
 <em>
-<a href="#agones.dev/v1.AllocationOverflow">
-AllocationOverflow
+<a href="#agones.dev/v1.CounterStatus">
+map[string]agones.dev/agones/pkg/apis/agones/v1.CounterStatus
 </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) Counters and Lists provides the configuration for generic tracking features.</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>scheduling</code></br>
+<code>lists</code></br>
 <em>
-agones.dev/agones/pkg/apis.SchedulingStrategy
+<a href="#agones.dev/v1.ListStatus">
+map[string]agones.dev/agones/pkg/apis/agones/v1.ListStatus
+</a>
 </em>
 </td>
 <td>
-<p>Scheduling strategy. Defaults to &ldquo;Packed&rdquo;.</p>
+<em>(Optional)</em>
 </td>
 </tr>
 <tr>
 <td>
-<code>template</code></br>
+<code>eviction</code></br>
 <em>
-<a href="#agones.dev/v1.GameServerTemplateSpec">
-GameServerTemplateSpec
+<a href="#agones.dev/v1.Eviction">
+Eviction
 </a>
 </em>
 </td>
 <td>
-<p>Template the GameServer template to apply for this GameServerSet</p>
+<em>(Optional)</em>
+<p>Eviction specifies the eviction tolerance of the GameServer.</p>
 </td>
 </tr>
 </tbody>
 </table>
-<h3 id="agones.dev/v1.GameServerSetStatus">GameServerSetStatus
+<h3 id="agones.dev/v1.GameServerStatusPort">GameServerStatusPort
 </h3>
 <p>
 (<em>Appears on:</em>
-<a href="#agones.dev/v1.GameServerSet">GameServerSet</a>)
+<a href="#allocation.agones.dev/v1.GameServerAllocationStatus">GameServerAllocationStatus</a>, 
+<a href="#agones.dev/v1.GameServerStatus">GameServerStatus</a>)
 </p>
 <p>
-<p>GameServerSetStatus is the status of a GameServerSet</p>
+<p>GameServerStatusPort shows the port that was allocated to a
+GameServer.</p>
 </p>
 <table>
 <thead>
@@ -2833,95 +2419,71 @@ <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>
+<code>name</code></br>
 <em>
-int32
+string
 </em>
 </td>
 <td>
-<p>ReadyReplicas is the number of Ready GameServer replicas</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>reservedReplicas</code></br>
+<code>port</code></br>
 <em>
 int32
 </em>
 </td>
 <td>
-<p>ReservedReplicas is the number of Reserved GameServer replicas</p>
 </td>
 </tr>
+</tbody>
+</table>
+<h3 id="agones.dev/v1.GameServerTemplateSpec">GameServerTemplateSpec
+</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>GameServerTemplateSpec is a template for GameServers</p>
+</p>
+<table>
+<thead>
 <tr>
-<td>
-<code>allocatedReplicas</code></br>
-<em>
-int32
-</em>
-</td>
-<td>
-<p>AllocatedReplicas is the number of Allocated GameServer replicas</p>
-</td>
+<th>Field</th>
+<th>Description</th>
 </tr>
+</thead>
+<tbody>
 <tr>
 <td>
-<code>shutdownReplicas</code></br>
+<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>ShutdownReplicas is the number of Shutdown GameServers replicas</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.AggregatedPlayerStatus">
-AggregatedPlayerStatus
+<a href="#agones.dev/v1.GameServerSpec">
+GameServerSpec
 </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>
-</td>
-</tr>
-</tbody>
-</table>
-<h3 id="agones.dev/v1.GameServerSpec">GameServerSpec
-</h3>
-<p>
-(<em>Appears on:</em>
-<a href="#agones.dev/v1.GameServer">GameServer</a>, 
-<a href="#agones.dev/v1.GameServerTemplateSpec">GameServerTemplateSpec</a>)
-</p>
-<p>
-<p>GameServerSpec is the spec for a GameServer resource</p>
-</p>
+<br/>
+<br/>
 <table>
-<thead>
-<tr>
-<th>Field</th>
-<th>Description</th>
-</tr>
-</thead>
-<tbody>
 <tr>
 <td>
 <code>container</code></br>
@@ -3048,29 +2610,22 @@ <h3 id="agones.dev/v1.GameServerSpec">GameServerSpec
 </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>Eviction specifies the eviction tolerance of the GameServer. Defaults to &ldquo;Never&rdquo;.</p>
+</td>
+</tr>
+</table>
 </td>
 </tr>
 </tbody>
 </table>
-<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 id="agones.dev/v1.Health">Health
 </h3>
 <p>
 (<em>Appears on:</em>
-<a href="#agones.dev/v1.GameServer">GameServer</a>)
+<a href="#agones.dev/v1.GameServerSpec">GameServerSpec</a>)
 </p>
 <p>
-<p>GameServerStatus is the status for a GameServer resource</p>
+<p>Health configures health checking on the GameServer</p>
 </p>
 <table>
 <thead>
@@ -3082,56 +2637,73 @@ <h3 id="agones.dev/v1.GameServerStatus">GameServerStatus
 <tbody>
 <tr>
 <td>
-<code>state</code></br>
+<code>disabled</code></br>
 <em>
-<a href="#agones.dev/v1.GameServerState">
-GameServerState
-</a>
+bool
 </em>
 </td>
 <td>
-<p>GameServerState is the current state of a GameServer, e.g. Creating, Starting, Ready, etc</p>
+<p>Disabled is whether health checking is disabled or not</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>ports</code></br>
+<code>periodSeconds</code></br>
 <em>
-<a href="#agones.dev/v1.GameServerStatusPort">
-[]GameServerStatusPort
-</a>
+int32
 </em>
 </td>
 <td>
+<p>PeriodSeconds is the number of seconds each health ping has to occur in</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>address</code></br>
+<code>failureThreshold</code></br>
 <em>
-string
+int32
 </em>
 </td>
 <td>
+<p>FailureThreshold how many failures in a row constitutes unhealthy</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>nodeName</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>reservedUntil</code></br>
+<code>capacity</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>
+int64
 </em>
 </td>
 <td>
@@ -3139,72 +2711,73 @@ <h3 id="agones.dev/v1.GameServerStatus">GameServerStatus
 </tr>
 <tr>
 <td>
-<code>players</code></br>
+<code>values</code></br>
 <em>
-<a href="#agones.dev/v1.PlayerStatus">
-PlayerStatus
-</a>
+[]string
 </em>
 </td>
 <td>
-<em>(Optional)</em>
-<p>[Stage:Alpha]
-[FeatureFlag:PlayerTracking]</p>
 </td>
 </tr>
+</tbody>
+</table>
+<h3 id="agones.dev/v1.PlayerStatus">PlayerStatus
+</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>
+<table>
+<thead>
+<tr>
+<th>Field</th>
+<th>Description</th>
+</tr>
+</thead>
+<tbody>
 <tr>
 <td>
-<code>counters</code></br>
+<code>count</code></br>
 <em>
-<a href="#agones.dev/v1.CounterStatus">
-map[string]agones.dev/agones/pkg/apis/agones/v1.CounterStatus
-</a>
+int64
 </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>capacity</code></br>
 <em>
-<a href="#agones.dev/v1.ListStatus">
-map[string]agones.dev/agones/pkg/apis/agones/v1.ListStatus
-</a>
+int64
 </em>
 </td>
 <td>
-<em>(Optional)</em>
 </td>
 </tr>
 <tr>
 <td>
-<code>eviction</code></br>
+<code>ids</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.</p>
 </td>
 </tr>
 </tbody>
 </table>
-<h3 id="agones.dev/v1.GameServerStatusPort">GameServerStatusPort
+<h3 id="agones.dev/v1.PlayersSpec">PlayersSpec
 </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="#agones.dev/v1.GameServerSpec">GameServerSpec</a>)
 </p>
 <p>
-<p>GameServerStatusPort shows the port that was allocated to a
-GameServer.</p>
+<p>PlayersSpec tracks the initial player capacity</p>
 </p>
 <table>
 <thead>
@@ -3216,35 +2789,102 @@ <h3 id="agones.dev/v1.GameServerStatusPort">GameServerStatusPort
 <tbody>
 <tr>
 <td>
-<code>name</code></br>
+<code>initialCapacity</code></br>
 <em>
-string
+int64
+</em>
+</td>
+<td>
+</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>
+<p>
+(<em>Appears on:</em>
+<a href="#agones.dev/v1.GameServerSpec">GameServerSpec</a>)
+</p>
+<p>
+<p>SdkServer specifies parameters for the Agones SDK Server sidecar container</p>
+</p>
+<table>
+<thead>
+<tr>
+<th>Field</th>
+<th>Description</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td>
+<code>logLevel</code></br>
+<em>
+<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>port</code></br>
+<code>grpcPort</code></br>
+<em>
+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>httpPort</code></br>
 <em>
 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.GameServerTemplateSpec">GameServerTemplateSpec
-</h3>
+<h3 id="agones.dev/v1.SdkServerLogLevel">SdkServerLogLevel
+(<code>string</code> alias)</p></h3>
 <p>
 (<em>Appears on:</em>
-<a href="#agones.dev/v1.FleetSpec">FleetSpec</a>, 
-<a href="#agones.dev/v1.GameServerSetSpec">GameServerSetSpec</a>)
+<a href="#agones.dev/v1.SdkServer">SdkServer</a>)
 </p>
 <p>
-<p>GameServerTemplateSpec is a template for GameServers</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>
+<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>
+</li></ul>
+<h3 id="allocation.agones.dev/v1.GameServerAllocation">GameServerAllocation
+</h3>
+<p>
+<p>GameServerAllocation is the data structure for allocating against a set of
+GameServers, defined <code>selectors</code> selectors</p>
 </p>
 <table>
 <thead>
@@ -3256,6 +2896,23 @@ <h3 id="agones.dev/v1.GameServerTemplateSpec">GameServerTemplateSpec
 <tbody>
 <tr>
 <td>
+<code>apiVersion</code></br>
+string</td>
+<td>
+<code>
+allocation.agones.dev/v1
+</code>
+</td>
+</tr>
+<tr>
+<td>
+<code>kind</code></br>
+string
+</td>
+<td><code>GameServerAllocation</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">
@@ -3272,8 +2929,8 @@ <h3 id="agones.dev/v1.GameServerTemplateSpec">GameServerTemplateSpec
 <td>
 <code>spec</code></br>
 <em>
-<a href="#agones.dev/v1.GameServerSpec">
-GameServerSpec
+<a href="#allocation.agones.dev/v1.GameServerAllocationSpec">
+GameServerAllocationSpec
 </a>
 </em>
 </td>
@@ -3283,146 +2940,164 @@ <h3 id="agones.dev/v1.GameServerTemplateSpec">GameServerTemplateSpec
 <table>
 <tr>
 <td>
-<code>container</code></br>
+<code>multiClusterSetting</code></br>
 <em>
-string
+<a href="#allocation.agones.dev/v1.MultiClusterSetting">
+MultiClusterSetting
+</a>
 </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>MultiClusterPolicySelector if specified, multi-cluster policies are applied.
+Otherwise, allocation will happen locally.</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>ports</code></br>
+<code>required</code></br>
 <em>
-<a href="#agones.dev/v1.GameServerPort">
-[]GameServerPort
+<a href="#allocation.agones.dev/v1.GameServerSelector">
+GameServerSelector
 </a>
 </em>
 </td>
 <td>
-<p>Ports are the array of ports that can be exposed via the game server</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>health</code></br>
+<code>preferred</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.
+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>scheduling</code></br>
+<code>priorities</code></br>
 <em>
-agones.dev/agones/pkg/apis.SchedulingStrategy
+<a href="#allocation.agones.dev/v1.Priority">
+[]Priority
+</a>
 </em>
 </td>
 <td>
-<p>Scheduling strategy. Defaults to &ldquo;Packed&rdquo;</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>sdkServer</code></br>
+<code>selectors</code></br>
 <em>
-<a href="#agones.dev/v1.SdkServer">
-SdkServer
+<a href="#allocation.agones.dev/v1.GameServerSelector">
+[]GameServerSelector
 </a>
 </em>
 </td>
 <td>
-<p>SdkServer specifies parameters for the Agones SDK Server sidecar container</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>template</code></br>
+<code>scheduling</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>
+agones.dev/agones/pkg/apis.SchedulingStrategy
 </em>
 </td>
 <td>
-<p>Template describes the Pod that will be created for the GameServer</p>
+<p>Scheduling strategy. Defaults to &ldquo;Packed&rdquo;.</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>players</code></br>
+<code>metadata</code></br>
 <em>
-<a href="#agones.dev/v1.PlayersSpec">
-PlayersSpec
+<a href="#allocation.agones.dev/v1.MetaPatch">
+MetaPatch
 </a>
 </em>
 </td>
 <td>
-<em>(Optional)</em>
-<p>(Alpha, PlayerTracking feature flag) Players provides the configuration for player 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>counters</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.CounterAction">
+map[string]agones.dev/agones/pkg/apis/allocation/v1.CounterAction
 </a>
 </em>
 </td>
 <td>
 <em>(Optional)</em>
-<p>(Alpha, CountsAndLists feature flag) Counters and Lists provides the configuration for generic tracking features.</p>
+<p>(Alpha, CountsAndLists feature flag) Counters and Lists provide a set of actions to perform
+on Counters and Lists during allocation.</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 href="#allocation.agones.dev/v1.ListAction">
+map[string]agones.dev/agones/pkg/apis/allocation/v1.ListAction
 </a>
 </em>
 </td>
 <td>
 </td>
 </tr>
+</table>
+</td>
+</tr>
 <tr>
 <td>
-<code>eviction</code></br>
+<code>status</code></br>
 <em>
-<a href="#agones.dev/v1.Eviction">
-Eviction
+<a href="#allocation.agones.dev/v1.GameServerAllocationStatus">
+GameServerAllocationStatus
 </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>
 </tbody>
 </table>
-<h3 id="agones.dev/v1.Health">Health
+<h3 id="allocation.agones.dev/v1.CounterAction">CounterAction
 </h3>
 <p>
 (<em>Appears on:</em>
-<a href="#agones.dev/v1.GameServerSpec">GameServerSpec</a>)
+<a href="#allocation.agones.dev/v1.GameServerAllocationSpec">GameServerAllocationSpec</a>)
 </p>
 <p>
-<p>Health configures health checking on the GameServer</p>
+<p>CounterAction is an optional action that can be performed on a Counter at allocation.
+Action: &ldquo;Increment&rdquo; or &ldquo;Decrement&rdquo; the Counter&rsquo;s Count (optional). Must also define the Amount.
+Amount: The amount to increment or decrement the Count (optional). Must be a positive integer.
+Capacity: Update the maximum capacity of the Counter to this number (optional). Min 0, Max int64.</p>
 </p>
 <table>
 <thead>
@@ -3434,59 +3109,45 @@ <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>action</code></br>
 <em>
-int32
+string
 </em>
 </td>
 <td>
-<p>PeriodSeconds is the number of seconds each health ping has to occur in</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>failureThreshold</code></br>
+<code>amount</code></br>
 <em>
-int32
+int64
 </em>
 </td>
 <td>
-<p>FailureThreshold how many failures in a row constitutes unhealthy</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>initialDelaySeconds</code></br>
+<code>capacity</code></br>
 <em>
-int32
+int64
 </em>
 </td>
 <td>
-<p>InitialDelaySeconds initial delay before checking health</p>
 </td>
 </tr>
 </tbody>
 </table>
-<h3 id="agones.dev/v1.ListStatus">ListStatus
+<h3 id="allocation.agones.dev/v1.CounterSelector">CounterSelector
 </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>ListStatus stores the current list values</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>
@@ -3498,7 +3159,7 @@ <h3 id="agones.dev/v1.ListStatus">ListStatus
 <tbody>
 <tr>
 <td>
-<code>capacity</code></br>
+<code>minCount</code></br>
 <em>
 int64
 </em>
@@ -3508,9 +3169,29 @@ <h3 id="agones.dev/v1.ListStatus">ListStatus
 </tr>
 <tr>
 <td>
-<code>values</code></br>
+<code>maxCount</code></br>
 <em>
-[]string
+int64
+</em>
+</td>
+<td>
+</td>
+</tr>
+<tr>
+<td>
+<code>minAvailable</code></br>
+<em>
+int64
+</em>
+</td>
+<td>
+</td>
+</tr>
+<tr>
+<td>
+<code>maxAvailable</code></br>
+<em>
+int64
 </em>
 </td>
 <td>
@@ -3518,14 +3199,14 @@ <h3 id="agones.dev/v1.ListStatus">ListStatus
 </tr>
 </tbody>
 </table>
-<h3 id="agones.dev/v1.PlayerStatus">PlayerStatus
+<h3 id="allocation.agones.dev/v1.GameServerAllocationSpec">GameServerAllocationSpec
 </h3>
 <p>
 (<em>Appears on:</em>
-<a href="#agones.dev/v1.GameServerStatus">GameServerStatus</a>)
+<a href="#allocation.agones.dev/v1.GameServerAllocation">GameServerAllocation</a>)
 </p>
 <p>
-<p>PlayerStatus stores the current player capacity values</p>
+<p>GameServerAllocationSpec is the spec for a GameServerAllocation</p>
 </p>
 <table>
 <thead>
@@ -3537,58 +3218,131 @@ <h3 id="agones.dev/v1.PlayerStatus">PlayerStatus
 <tbody>
 <tr>
 <td>
-<code>count</code></br>
+<code>multiClusterSetting</code></br>
 <em>
-int64
+<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>capacity</code></br>
+<code>required</code></br>
 <em>
-int64
+<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>ids</code></br>
+<code>preferred</code></br>
 <em>
-[]string
+<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>
-</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>
+<td>
+<code>priorities</code></br>
+<em>
+<a href="#allocation.agones.dev/v1.Priority">
+[]Priority
+</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>
+</td>
 </tr>
-</thead>
-<tbody>
 <tr>
 <td>
-<code>initialCapacity</code></br>
+<code>selectors</code></br>
 <em>
-int64
+<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>
+<em>
+agones.dev/agones/pkg/apis.SchedulingStrategy
+</em>
+</td>
+<td>
+<p>Scheduling strategy. Defaults to &ldquo;Packed&rdquo;.</p>
+</td>
+</tr>
+<tr>
+<td>
+<code>metadata</code></br>
+<em>
+<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>
+<tr>
+<td>
+<code>counters</code></br>
+<em>
+<a href="#allocation.agones.dev/v1.CounterAction">
+map[string]agones.dev/agones/pkg/apis/allocation/v1.CounterAction
+</a>
+</em>
+</td>
+<td>
+<em>(Optional)</em>
+<p>(Alpha, CountsAndLists feature flag) Counters and Lists provide a set of actions to perform
+on Counters and Lists during allocation.</p>
+</td>
+</tr>
+<tr>
+<td>
+<code>lists</code></br>
+<em>
+<a href="#allocation.agones.dev/v1.ListAction">
+map[string]agones.dev/agones/pkg/apis/allocation/v1.ListAction
+</a>
 </em>
 </td>
 <td>
@@ -3596,23 +3350,23 @@ <h3 id="agones.dev/v1.PlayersSpec">PlayersSpec
 </tr>
 </tbody>
 </table>
-<h3 id="agones.dev/v1.PortPolicy">PortPolicy
+<h3 id="allocation.agones.dev/v1.GameServerAllocationState">GameServerAllocationState
 (<code>string</code> alias)</p></h3>
 <p>
 (<em>Appears on:</em>
-<a href="#agones.dev/v1.GameServerPort">GameServerPort</a>)
+<a href="#allocation.agones.dev/v1.GameServerAllocationStatus">GameServerAllocationStatus</a>)
 </p>
 <p>
-<p>PortPolicy is the port policy for the GameServer</p>
+<p>GameServerAllocationState is the Allocation state</p>
 </p>
-<h3 id="agones.dev/v1.SdkServer">SdkServer
+<h3 id="allocation.agones.dev/v1.GameServerAllocationStatus">GameServerAllocationStatus
 </h3>
 <p>
 (<em>Appears on:</em>
-<a href="#agones.dev/v1.GameServerSpec">GameServerSpec</a>)
+<a href="#allocation.agones.dev/v1.GameServerAllocation">GameServerAllocation</a>)
 </p>
 <p>
-<p>SdkServer specifies parameters for the Agones SDK Server sidecar container</p>
+<p>GameServerAllocationStatus is the status for an GameServerAllocation resource</p>
 </p>
 <table>
 <thead>
@@ -3624,83 +3378,82 @@ <h3 id="agones.dev/v1.SdkServer">SdkServer
 <tbody>
 <tr>
 <td>
-<code>logLevel</code></br>
+<code>state</code></br>
 <em>
-<a href="#agones.dev/v1.SdkServerLogLevel">
-SdkServerLogLevel
+<a href="#allocation.agones.dev/v1.GameServerAllocationState">
+GameServerAllocationState
 </a>
 </em>
 </td>
 <td>
-<p>LogLevel for SDK server (sidecar) logs. Defaults to &ldquo;Info&rdquo;</p>
+<p>GameServerState is the current state of an GameServerAllocation, e.g. Allocated, or UnAllocated</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>grpcPort</code></br>
+<code>gameServerName</code></br>
 <em>
-int32
+string
 </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>ports</code></br>
 <em>
-int32
+<a href="#agones.dev/v1.GameServerStatusPort">
+[]GameServerStatusPort
+</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>.
-</em></p>
-{{% /feature %}}
-{{% feature publishVersion="1.32.0" %}}
-<p>Packages:</p>
-<ul>
-<li>
-<a href="#autoscaling.agones.dev%2fv1">autoscaling.agones.dev/v1</a>
-</li>
-<li>
-<a href="#multicluster.agones.dev%2fv1">multicluster.agones.dev/v1</a>
-</li>
-<li>
-<a href="#agones.dev%2fv1">agones.dev/v1</a>
-</li>
-<li>
-<a href="#allocation.agones.dev%2fv1">allocation.agones.dev/v1</a>
-</li>
-</ul>
-<h2 id="autoscaling.agones.dev/v1">autoscaling.agones.dev/v1</h2>
+<tr>
+<td>
+<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>source</code></br>
+<em>
+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="allocation.agones.dev/v1.GameServerSelector">GameServerSelector
+</h3>
 <p>
-<p>Package v1 is the v1 version of the API.</p>
+(<em>Appears on:</em>
+<a href="#allocation.agones.dev/v1.GameServerAllocationSpec">GameServerAllocationSpec</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>GameServerSelector contains all the filter options for selecting
+a GameServer for allocation.</p>
 </p>
 <table>
 <thead>
@@ -3712,97 +3465,123 @@ <h3 id="autoscaling.agones.dev/v1.FleetAutoscaler">FleetAutoscaler
 <tbody>
 <tr>
 <td>
-<code>apiVersion</code></br>
-string</td>
-<td>
-<code>
-autoscaling.agones.dev/v1
-</code>
+<code>LabelSelector</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>
+</em>
 </td>
-</tr>
-<tr>
 <td>
-<code>kind</code></br>
-string
+<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>
-<td><code>FleetAutoscaler</code></td>
 </tr>
 <tr>
 <td>
-<code>metadata</code></br>
+<code>gameServerState</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="#agones.dev/v1.GameServerState">
+GameServerState
 </a>
 </em>
 </td>
 <td>
-Refer to the Kubernetes API documentation for the fields of the
-<code>metadata</code> field.
+<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>
 <tr>
 <td>
-<code>spec</code></br>
+<code>players</code></br>
 <em>
-<a href="#autoscaling.agones.dev/v1.FleetAutoscalerSpec">
-FleetAutoscalerSpec
+<a href="#allocation.agones.dev/v1.PlayerSelector">
+PlayerSelector
 </a>
 </em>
 </td>
 <td>
-<br/>
-<br/>
-<table>
+<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>fleetName</code></br>
+<code>counters</code></br>
 <em>
-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>(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>policy</code></br>
+<code>lists</code></br>
 <em>
-<a href="#autoscaling.agones.dev/v1.FleetAutoscalerPolicy">
-FleetAutoscalerPolicy
+<a href="#allocation.agones.dev/v1.ListSelector">
+map[string]agones.dev/agones/pkg/apis/allocation/v1.ListSelector
 </a>
 </em>
 </td>
 <td>
-<p>Autoscaling policy</p>
+<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="allocation.agones.dev/v1.ListAction">ListAction
+</h3>
+<p>
+(<em>Appears on:</em>
+<a href="#allocation.agones.dev/v1.GameServerAllocationSpec">GameServerAllocationSpec</a>)
+</p>
+<p>
+<p>ListAction is an optional action that can be performed on a List at allocation.
+AddValues: Append values to a List&rsquo;s Values array (optional). Any duplicate values will be ignored.
+Capacity: Update the maximum capacity of the Counter to this number (optional). Min 0, Max 1000.</p>
+</p>
+<table>
+<thead>
+<tr>
+<th>Field</th>
+<th>Description</th>
+</tr>
+</thead>
+<tbody>
 <tr>
 <td>
-<code>sync</code></br>
+<code>addValues</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>
-</table>
 </td>
 </tr>
 <tr>
 <td>
-<code>status</code></br>
+<code>capacity</code></br>
 <em>
-<a href="#autoscaling.agones.dev/v1.FleetAutoscalerStatus">
-FleetAutoscalerStatus
-</a>
+int64
 </em>
 </td>
 <td>
@@ -3810,14 +3589,17 @@ <h3 id="autoscaling.agones.dev/v1.FleetAutoscaler">FleetAutoscaler
 </tr>
 </tbody>
 </table>
-<h3 id="autoscaling.agones.dev/v1.BufferPolicy">BufferPolicy
+<h3 id="allocation.agones.dev/v1.ListSelector">ListSelector
 </h3>
 <p>
 (<em>Appears on:</em>
-<a href="#autoscaling.agones.dev/v1.FleetAutoscalerPolicy">FleetAutoscalerPolicy</a>)
+<a href="#allocation.agones.dev/v1.GameServerSelector">GameServerSelector</a>)
 </p>
 <p>
-<p>BufferPolicy controls the desired behavior of the buffer policy.</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>
@@ -3829,59 +3611,44 @@ <h3 id="autoscaling.agones.dev/v1.BufferPolicy">BufferPolicy
 <tbody>
 <tr>
 <td>
-<code>maxReplicas</code></br>
+<code>containsValue</code></br>
 <em>
-int32
+string
 </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>
 </td>
 </tr>
 <tr>
 <td>
-<code>minReplicas</code></br>
+<code>minAvailable</code></br>
 <em>
-int32
+int64
 </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>
 </td>
 </tr>
 <tr>
 <td>
-<code>bufferSize</code></br>
+<code>maxAvailable</code></br>
 <em>
-k8s.io/apimachinery/pkg/util/intstr.IntOrString
+int64
 </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>
 </td>
 </tr>
 </tbody>
 </table>
-<h3 id="autoscaling.agones.dev/v1.FixedIntervalSync">FixedIntervalSync
+<h3 id="allocation.agones.dev/v1.MetaPatch">MetaPatch
 </h3>
 <p>
 (<em>Appears on:</em>
-<a href="#autoscaling.agones.dev/v1.FleetAutoscalerSync">FleetAutoscalerSync</a>)
+<a href="#allocation.agones.dev/v1.GameServerAllocationSpec">GameServerAllocationSpec</a>)
 </p>
 <p>
-<p>FixedIntervalSync controls the desired behavior of the fixed interval based sync.</p>
+<p>MetaPatch is the metadata used to patch the GameServer metadata on allocation</p>
 </p>
 <table>
 <thead>
@@ -3893,25 +3660,34 @@ <h3 id="autoscaling.agones.dev/v1.FixedIntervalSync">FixedIntervalSync
 <tbody>
 <tr>
 <td>
-<code>seconds</code></br>
+<code>labels</code></br>
 <em>
-int32
+map[string]string
+</em>
+</td>
+<td>
+</td>
+</tr>
+<tr>
+<td>
+<code>annotations</code></br>
+<em>
+map[string]string
 </em>
 </td>
 <td>
-<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 id="allocation.agones.dev/v1.MultiClusterSetting">MultiClusterSetting
 </h3>
 <p>
 (<em>Appears on:</em>
-<a href="#autoscaling.agones.dev/v1.FleetAutoscaleReview">FleetAutoscaleReview</a>)
+<a href="#allocation.agones.dev/v1.GameServerAllocationSpec">GameServerAllocationSpec</a>)
 </p>
 <p>
-<p>FleetAutoscaleRequest defines the request to webhook autoscaler endpoint</p>
+<p>MultiClusterSetting specifies settings for multi-cluster allocation.</p>
 </p>
 <table>
 <thead>
@@ -3923,63 +3699,80 @@ <h3 id="autoscaling.agones.dev/v1.FleetAutoscaleRequest">FleetAutoscaleRequest
 <tbody>
 <tr>
 <td>
-<code>uid</code></br>
+<code>enabled</code></br>
 <em>
-k8s.io/apimachinery/pkg/types.UID
+bool
 </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>
 </td>
 </tr>
 <tr>
 <td>
-<code>name</code></br>
+<code>policySelector</code></br>
 <em>
-string
+<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>Name is the name of the Fleet being scaled</p>
 </td>
 </tr>
-<tr>
-<td>
-<code>namespace</code></br>
+</tbody>
+</table>
+<h3 id="allocation.agones.dev/v1.PlayerSelector">PlayerSelector
+</h3>
+<p>
+(<em>Appears on:</em>
+<a href="#allocation.agones.dev/v1.GameServerSelector">GameServerSelector</a>)
+</p>
+<p>
+<p>PlayerSelector is the filter options for a GameServer based on player counts</p>
+</p>
+<table>
+<thead>
+<tr>
+<th>Field</th>
+<th>Description</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td>
+<code>minAvailable</code></br>
 <em>
-string
+int64
 </em>
 </td>
 <td>
-<p>Namespace is the namespace associated with the request (if any).</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>status</code></br>
+<code>maxAvailable</code></br>
 <em>
-<a href="#agones.dev/v1.FleetStatus">
-FleetStatus
-</a>
+int64
 </em>
 </td>
 <td>
-<p>The Fleet&rsquo;s status values</p>
 </td>
 </tr>
 </tbody>
 </table>
-<h3 id="autoscaling.agones.dev/v1.FleetAutoscaleResponse">FleetAutoscaleResponse
+<h3 id="allocation.agones.dev/v1.Priority">Priority
 </h3>
 <p>
 (<em>Appears on:</em>
-<a href="#autoscaling.agones.dev/v1.FleetAutoscaleReview">FleetAutoscaleReview</a>)
+<a href="#allocation.agones.dev/v1.GameServerAllocationSpec">GameServerAllocationSpec</a>)
 </p>
 <p>
-<p>FleetAutoscaleResponse defines the response of webhook autoscaler endpoint</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>
@@ -3991,45 +3784,73 @@ <h3 id="autoscaling.agones.dev/v1.FleetAutoscaleResponse">FleetAutoscaleResponse
 <tbody>
 <tr>
 <td>
-<code>uid</code></br>
+<code>priorityType</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>
 </td>
 </tr>
 <tr>
 <td>
-<code>scale</code></br>
+<code>key</code></br>
 <em>
-bool
+string
 </em>
 </td>
 <td>
-<p>Set to false if no scaling should occur to the Fleet</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>replicas</code></br>
+<code>order</code></br>
 <em>
-int32
+string
 </em>
 </td>
 <td>
-<p>The targeted replica count</p>
 </td>
 </tr>
 </tbody>
 </table>
-<h3 id="autoscaling.agones.dev/v1.FleetAutoscaleReview">FleetAutoscaleReview
+<hr/>
+<p><em>
+Generated with <code>gen-crd-api-reference-docs</code>.
+</em></p>
+{{% /feature %}}
+{{% feature publishVersion="1.33.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>
+<a href="#autoscaling.agones.dev%2fv1">autoscaling.agones.dev/v1</a>
+</li>
+<li>
+<a href="#multicluster.agones.dev%2fv1">multicluster.agones.dev/v1</a>
+</li>
+</ul>
+<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="#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="agones.dev/v1.Fleet">Fleet
 </h3>
 <p>
-<p>FleetAutoscaleReview is passed to the webhook with a populated Request value,
-and then returned with a populated Response.</p>
+<p>Fleet is the data structure for a Fleet resource</p>
 </p>
 <table>
 <thead>
@@ -4041,166 +3862,138 @@ <h3 id="autoscaling.agones.dev/v1.FleetAutoscaleReview">FleetAutoscaleReview
 <tbody>
 <tr>
 <td>
-<code>request</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>Fleet</code></td>
+</tr>
+<tr>
+<td>
+<code>metadata</code></br>
 <em>
-<a href="#autoscaling.agones.dev/v1.FleetAutoscaleRequest">
-FleetAutoscaleRequest
+<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>response</code></br>
+<code>spec</code></br>
 <em>
-<a href="#autoscaling.agones.dev/v1.FleetAutoscaleResponse">
-FleetAutoscaleResponse
+<a href="#agones.dev/v1.FleetSpec">
+FleetSpec
 </a>
 </em>
 </td>
 <td>
-</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>
+<br/>
+<br/>
 <table>
-<thead>
-<tr>
-<th>Field</th>
-<th>Description</th>
-</tr>
-</thead>
-<tbody>
 <tr>
 <td>
-<code>type</code></br>
+<code>replicas</code></br>
 <em>
-<a href="#autoscaling.agones.dev/v1.FleetAutoscalerPolicyType">
-FleetAutoscalerPolicyType
-</a>
+int32
 </em>
 </td>
 <td>
-<p>Type of autoscaling policy.</p>
+<p>Replicas are the number of GameServers that should be in this set. Defaults to 0.</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>buffer</code></br>
+<code>allocationOverflow</code></br>
 <em>
-<a href="#autoscaling.agones.dev/v1.BufferPolicy">
-BufferPolicy
+<a href="#agones.dev/v1.AllocationOverflow">
+AllocationOverflow
 </a>
 </em>
 </td>
 <td>
 <em>(Optional)</em>
-<p>Buffer policy config params. Present only if FleetAutoscalerPolicyType = Buffer.</p>
+<p>[Stage: Alpha]
+[FeatureFlag:FleetAllocationOverflow]
+Labels and/or Annotations to apply to overflowing GameServers when the number of Allocated GameServers is more
+than the desired replicas on the underlying <code>GameServerSet</code></p>
 </td>
 </tr>
 <tr>
 <td>
-<code>webhook</code></br>
+<code>strategy</code></br>
 <em>
-<a href="#autoscaling.agones.dev/v1.WebhookPolicy">
-WebhookPolicy
+<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>
-<em>(Optional)</em>
-<p>Webhook policy config params. Present only if FleetAutoscalerPolicyType = Webhook.</p>
+<p>Deployment strategy</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>
-<p>
-(<em>Appears on:</em>
-<a href="#autoscaling.agones.dev/v1.FleetAutoscaler">FleetAutoscaler</a>)
-</p>
-<p>
-<p>FleetAutoscalerSpec is the spec for a Fleet Scaler</p>
-</p>
-<table>
-<thead>
-<tr>
-<th>Field</th>
-<th>Description</th>
-</tr>
-</thead>
-<tbody>
 <tr>
 <td>
-<code>fleetName</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>policy</code></br>
+<code>template</code></br>
 <em>
-<a href="#autoscaling.agones.dev/v1.FleetAutoscalerPolicy">
-FleetAutoscalerPolicy
+<a href="#agones.dev/v1.GameServerTemplateSpec">
+GameServerTemplateSpec
 </a>
 </em>
 </td>
 <td>
-<p>Autoscaling policy</p>
+<p>Template the GameServer template to apply for this Fleet</p>
+</td>
+</tr>
+</table>
 </td>
 </tr>
 <tr>
 <td>
-<code>sync</code></br>
+<code>status</code></br>
 <em>
-<a href="#autoscaling.agones.dev/v1.FleetAutoscalerSync">
-FleetAutoscalerSync
+<a href="#agones.dev/v1.FleetStatus">
+FleetStatus
 </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 id="agones.dev/v1.GameServer">GameServer
 </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>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>
@@ -4212,216 +4005,200 @@ <h3 id="autoscaling.agones.dev/v1.FleetAutoscalerStatus">FleetAutoscalerStatus
 <tbody>
 <tr>
 <td>
-<code>currentReplicas</code></br>
-<em>
-int32
-</em>
-</td>
+<code>apiVersion</code></br>
+string</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>
+<code>
+agones.dev/v1
+</code>
+</td>
+</tr>
 <tr>
 <td>
-<code>desiredReplicas</code></br>
+<code>kind</code></br>
+string
+</td>
+<td><code>GameServer</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>DesiredReplicas is the desired number of gameserver replicas
-of the fleet managed by this autoscaler, as last calculated by the autoscaler</p>
+Refer to the Kubernetes API documentation for the fields of the
+<code>metadata</code> field.
 </td>
 </tr>
 <tr>
 <td>
-<code>lastScaleTime</code></br>
+<code>spec</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.GameServerSpec">
+GameServerSpec
 </a>
 </em>
 </td>
 <td>
-<em>(Optional)</em>
-<p>lastScaleTime is the last time the FleetAutoscaler scaled the attached fleet,</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>ableToScale</code></br>
+<code>ports</code></br>
 <em>
-bool
+<a href="#agones.dev/v1.GameServerPort">
+[]GameServerPort
+</a>
 </em>
 </td>
 <td>
-<p>AbleToScale indicates that we can access the target fleet</p>
+<p>Ports are the array of ports that can be exposed via the game server</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>scalingLimited</code></br>
+<code>health</code></br>
 <em>
-bool
+<a href="#agones.dev/v1.Health">
+Health
+</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>
+<p>Health configures health checking</p>
 </td>
 </tr>
-</tbody>
-</table>
-<h3 id="autoscaling.agones.dev/v1.FleetAutoscalerSync">FleetAutoscalerSync
-</h3>
-<p>
-(<em>Appears on:</em>
-<a href="#autoscaling.agones.dev/v1.FleetAutoscalerSpec">FleetAutoscalerSpec</a>)
-</p>
-<p>
-<p>FleetAutoscalerSync describes when to sync a fleet</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>type</code></br>
+<code>sdkServer</code></br>
 <em>
-<a href="#autoscaling.agones.dev/v1.FleetAutoscalerSyncType">
-FleetAutoscalerSyncType
+<a href="#agones.dev/v1.SdkServer">
+SdkServer
 </a>
 </em>
 </td>
 <td>
-<p>Type of autoscaling sync.</p>
+<p>SdkServer specifies parameters for the Agones SDK Server sidecar container</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>fixedInterval</code></br>
+<code>template</code></br>
 <em>
-<a href="#autoscaling.agones.dev/v1.FixedIntervalSync">
-FixedIntervalSync
+<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>
-<em>(Optional)</em>
-<p>FixedInterval config params. Present only if FleetAutoscalerSyncType = FixedInterval.</p>
+<p>Template describes the Pod that will be created for the GameServer</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>
-<p>
-(<em>Appears on:</em>
-<a href="#autoscaling.agones.dev/v1.FleetAutoscalerPolicy">FleetAutoscalerPolicy</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>
-<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>url</code></br>
+<code>counters</code></br>
 <em>
-string
+<a href="#agones.dev/v1.CounterStatus">
+map[string]agones.dev/agones/pkg/apis/agones/v1.CounterStatus
+</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>
+<p>(Alpha, CountsAndLists feature flag) Counters and Lists provides the configuration for generic tracking features.</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>service</code></br>
+<code>lists</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.ListStatus">
+map[string]agones.dev/agones/pkg/apis/agones/v1.ListStatus
 </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>
 </td>
 </tr>
 <tr>
 <td>
-<code>caBundle</code></br>
+<code>eviction</code></br>
 <em>
-[]byte
+<a href="#agones.dev/v1.Eviction">
+Eviction
+</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>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>
+<em>
+<a href="#agones.dev/v1.GameServerStatus">
+GameServerStatus
+</a>
+</em>
+</td>
+<td>
 </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 id="agones.dev/v1.GameServerSet">GameServerSet
 </h3>
 <p>
-<p>GameServerAllocationPolicy is the Schema for the gameserverallocationpolicies API</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>
@@ -4437,7 +4214,7 @@ <h3 id="multicluster.agones.dev/v1.GameServerAllocationPolicy">GameServerAllocat
 string</td>
 <td>
 <code>
-multicluster.agones.dev/v1
+agones.dev/v1
 </code>
 </td>
 </tr>
@@ -4446,7 +4223,7 @@ <h3 id="multicluster.agones.dev/v1.GameServerAllocationPolicy">GameServerAllocat
 <code>kind</code></br>
 string
 </td>
-<td><code>GameServerAllocationPolicy</code></td>
+<td><code>GameServerSet</code></td>
 </tr>
 <tr>
 <td>
@@ -4466,8 +4243,8 @@ <h3 id="multicluster.agones.dev/v1.GameServerAllocationPolicy">GameServerAllocat
 <td>
 <code>spec</code></br>
 <em>
-<a href="#multicluster.agones.dev/v1.GameServerAllocationPolicySpec">
-GameServerAllocationPolicySpec
+<a href="#agones.dev/v1.GameServerSetSpec">
+GameServerSetSpec
 </a>
 </em>
 </td>
@@ -4477,121 +4254,122 @@ <h3 id="multicluster.agones.dev/v1.GameServerAllocationPolicy">GameServerAllocat
 <table>
 <tr>
 <td>
-<code>priority</code></br>
+<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>weight</code></br>
+<code>allocationOverflow</code></br>
 <em>
-int
+<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>connectionInfo</code></br>
+<code>scheduling</code></br>
 <em>
-<a href="#multicluster.agones.dev/v1.ClusterConnectionInfo">
-ClusterConnectionInfo
-</a>
+agones.dev/agones/pkg/apis.SchedulingStrategy
 </em>
 </td>
 <td>
+<p>Scheduling strategy. Defaults to &ldquo;Packed&rdquo;.</p>
 </td>
 </tr>
-</table>
-</td>
-</tr>
-</tbody>
-</table>
-<h3 id="multicluster.agones.dev/v1.ClusterConnectionInfo">ClusterConnectionInfo
-</h3>
-<p>
-(<em>Appears on:</em>
-<a href="#multicluster.agones.dev/v1.GameServerAllocationPolicySpec">GameServerAllocationPolicySpec</a>)
-</p>
-<p>
-<p>ClusterConnectionInfo defines the connection information for a cluster</p>
-</p>
-<table>
-<thead>
-<tr>
-<th>Field</th>
-<th>Description</th>
-</tr>
-</thead>
-<tbody>
 <tr>
 <td>
-<code>clusterName</code></br>
+<code>template</code></br>
 <em>
-string
+<a href="#agones.dev/v1.GameServerTemplateSpec">
+GameServerTemplateSpec
+</a>
 </em>
 </td>
 <td>
-<p>Optional: the name of the targeted cluster</p>
+<p>Template the GameServer template to apply for this GameServerSet</p>
 </td>
 </tr>
-<tr>
-<td>
-<code>allocationEndpoints</code></br>
-<em>
-[]string
-</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>
+</table>
 </td>
 </tr>
 <tr>
 <td>
-<code>secretName</code></br>
+<code>status</code></br>
 <em>
-string
+<a href="#agones.dev/v1.GameServerSetStatus">
+GameServerSetStatus
+</a>
 </em>
 </td>
 <td>
-<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.AggregatedCounterStatus">AggregatedCounterStatus
+</h3>
+<p>
+(<em>Appears on:</em>
+<a href="#agones.dev/v1.FleetStatus">FleetStatus</a>, 
+<a href="#agones.dev/v1.GameServerSetStatus">GameServerSetStatus</a>)
+</p>
+<p>
+<p>AggregatedCounterStatus stores total Counter tracking values</p>
+</p>
+<table>
+<thead>
+<tr>
+<th>Field</th>
+<th>Description</th>
+</tr>
+</thead>
+<tbody>
 <tr>
 <td>
-<code>namespace</code></br>
+<code>count</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>capacity</code></br>
 <em>
-[]byte
+int64
 </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.AggregatedListStatus">AggregatedListStatus
 </h3>
 <p>
-<p>ConnectionInfoIterator an iterator on ClusterConnectionInfo</p>
+(<em>Appears on:</em>
+<a href="#agones.dev/v1.FleetStatus">FleetStatus</a>, 
+<a href="#agones.dev/v1.GameServerSetStatus">GameServerSetStatus</a>)
+</p>
+<p>
+<p>AggregatedListStatus stores total List tracking values</p>
 </p>
 <table>
 <thead>
@@ -4603,58 +4381,77 @@ <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>
+</tbody>
+</table>
+<h3 id="agones.dev/v1.AggregatedPlayerStatus">AggregatedPlayerStatus
+</h3>
+<p>
+(<em>Appears on:</em>
+<a href="#agones.dev/v1.FleetStatus">FleetStatus</a>, 
+<a href="#agones.dev/v1.GameServerSetStatus">GameServerSetStatus</a>)
+</p>
+<p>
+<p>AggregatedPlayerStatus stores total player tracking values</p>
+</p>
+<table>
+<thead>
+<tr>
+<th>Field</th>
+<th>Description</th>
+</tr>
+</thead>
+<tbody>
 <tr>
 <td>
-<code>priorityToCluster</code></br>
+<code>count</code></br>
 <em>
-map[int32]map[string][]*agones.dev/agones/pkg/apis/multicluster/v1.GameServerAllocationPolicy
+int64
 </em>
 </td>
 <td>
-<p>priorityToCluster Map of priority to cluster-policies map</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>clusterBlackList</code></br>
+<code>capacity</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.AllocationOverflow">AllocationOverflow
 </h3>
 <p>
 (<em>Appears on:</em>
-<a href="#multicluster.agones.dev/v1.GameServerAllocationPolicy">GameServerAllocationPolicy</a>)
+<a href="#agones.dev/v1.FleetSpec">FleetSpec</a>, 
+<a href="#agones.dev/v1.GameServerSetSpec">GameServerSetSpec</a>)
 </p>
 <p>
-<p>GameServerAllocationPolicySpec defines the desired state of GameServerAllocationPolicy</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>
@@ -4666,55 +4463,39 @@ <h3 id="multicluster.agones.dev/v1.GameServerAllocationPolicySpec">GameServerAll
 <tbody>
 <tr>
 <td>
-<code>priority</code></br>
-<em>
-int32
-</em>
-</td>
-<td>
-</td>
-</tr>
-<tr>
-<td>
-<code>weight</code></br>
+<code>labels</code></br>
 <em>
-int
+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>connectionInfo</code></br>
+<code>annotations</code></br>
 <em>
-<a href="#multicluster.agones.dev/v1.ClusterConnectionInfo">
-ClusterConnectionInfo
-</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>
-<hr/>
-<h2 id="agones.dev/v1">agones.dev/v1</h2>
+<h3 id="agones.dev/v1.CounterStatus">CounterStatus
+</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="#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="agones.dev/v1.Fleet">Fleet
-</h3>
 <p>
-<p>Fleet is the data structure for a Fleet resource</p>
+<p>CounterStatus stores the current counter values</p>
 </p>
 <table>
 <thead>
@@ -4726,48 +4507,88 @@ <h3 id="agones.dev/v1.Fleet">Fleet
 <tbody>
 <tr>
 <td>
-<code>apiVersion</code></br>
-string</td>
-<td>
-<code>
-agones.dev/v1
-</code>
+<code>count</code></br>
+<em>
+int64
+</em>
 </td>
-</tr>
-<tr>
 <td>
-<code>kind</code></br>
-string
 </td>
-<td><code>Fleet</code></td>
 </tr>
 <tr>
 <td>
-<code>metadata</code></br>
+<code>capacity</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>
+int64
 </em>
 </td>
 <td>
-Refer to the Kubernetes API documentation for the fields of the
-<code>metadata</code> field.
 </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>spec</code></br>
+<code>safe</code></br>
 <em>
-<a href="#agones.dev/v1.FleetSpec">
-FleetSpec
+<a href="#agones.dev/v1.EvictionSafe">
+EvictionSafe
 </a>
 </em>
 </td>
 <td>
-<br/>
-<br/>
+<p>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>
+<th>Field</th>
+<th>Description</th>
+</tr>
+</thead>
+<tbody>
 <tr>
 <td>
 <code>replicas</code></br>
@@ -4833,31 +4654,17 @@ <h3 id="agones.dev/v1.Fleet">Fleet
 <p>Template the GameServer template to apply for this Fleet</p>
 </td>
 </tr>
+</tbody>
 </table>
-</td>
-</tr>
-<tr>
-<td>
-<code>status</code></br>
-<em>
-<a href="#agones.dev/v1.FleetStatus">
-FleetStatus
-</a>
-</em>
-</td>
-<td>
-</td>
-</tr>
-</tbody>
-</table>
-<h3 id="agones.dev/v1.GameServer">GameServer
+<h3 id="agones.dev/v1.FleetStatus">FleetStatus
 </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="#agones.dev/v1.Fleet">Fleet</a>, 
+<a href="#autoscaling.agones.dev/v1.FleetAutoscaleRequest">FleetAutoscaleRequest</a>)
+</p>
+<p>
+<p>FleetStatus is the status of a Fleet</p>
 </p>
 <table>
 <thead>
@@ -4869,200 +4676,200 @@ <h3 id="agones.dev/v1.GameServer">GameServer
 <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>
+<code>replicas</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>
+int32
 </em>
 </td>
 <td>
-Refer to the Kubernetes API documentation for the fields of the
-<code>metadata</code> field.
+<p>Replicas the total number of current GameServer replicas</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>spec</code></br>
+<code>readyReplicas</code></br>
 <em>
-<a href="#agones.dev/v1.GameServerSpec">
-GameServerSpec
-</a>
+int32
 </em>
 </td>
 <td>
-<br/>
-<br/>
-<table>
+<p>ReadyReplicas are the number of Ready GameServer replicas</p>
+</td>
+</tr>
 <tr>
 <td>
-<code>container</code></br>
+<code>reservedReplicas</code></br>
 <em>
-string
+int32
 </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>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>ports</code></br>
+<code>allocatedReplicas</code></br>
 <em>
-<a href="#agones.dev/v1.GameServerPort">
-[]GameServerPort
-</a>
+int32
 </em>
 </td>
 <td>
-<p>Ports are the array of ports that can be exposed via the game server</p>
+<p>AllocatedReplicas are the number of Allocated GameServer replicas</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>health</code></br>
+<code>players</code></br>
 <em>
-<a href="#agones.dev/v1.Health">
-Health
+<a href="#agones.dev/v1.AggregatedPlayerStatus">
+AggregatedPlayerStatus
 </a>
 </em>
 </td>
 <td>
-<p>Health configures health checking</p>
+<em>(Optional)</em>
+<p>[Stage:Alpha]
+[FeatureFlag:PlayerTracking]
+Players are the current total player capacity and count for this Fleet</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>scheduling</code></br>
+<code>counters</code></br>
 <em>
-agones.dev/agones/pkg/apis.SchedulingStrategy
+<a href="#agones.dev/v1.AggregatedCounterStatus">
+map[string]agones.dev/agones/pkg/apis/agones/v1.AggregatedCounterStatus
+</a>
 </em>
 </td>
 <td>
-<p>Scheduling strategy. Defaults to &ldquo;Packed&rdquo;</p>
+<em>(Optional)</em>
+<p>(Alpha, CountsAndLists feature flag) Counters provides aggregated Counter capacity and Counter
+count for this Fleet.</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>sdkServer</code></br>
+<code>lists</code></br>
 <em>
-<a href="#agones.dev/v1.SdkServer">
-SdkServer
+<a href="#agones.dev/v1.AggregatedListStatus">
+map[string]agones.dev/agones/pkg/apis/agones/v1.AggregatedListStatus
 </a>
 </em>
 </td>
 <td>
-<p>SdkServer specifies parameters for the Agones SDK Server sidecar container</p>
+<em>(Optional)</em>
+<p>(Alpha, CountsAndLists feature flag) Lists provides aggregated List capacityv and List values
+for this Fleet.</p>
 </td>
 </tr>
+</tbody>
+</table>
+<h3 id="agones.dev/v1.GameServerPort">GameServerPort
+</h3>
+<p>
+(<em>Appears on:</em>
+<a href="#agones.dev/v1.GameServerSpec">GameServerSpec</a>)
+</p>
+<p>
+<p>GameServerPort defines a set of Ports that
+are to be exposed via the GameServer</p>
+</p>
+<table>
+<thead>
+<tr>
+<th>Field</th>
+<th>Description</th>
+</tr>
+</thead>
+<tbody>
 <tr>
 <td>
-<code>template</code></br>
+<code>name</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>
+string
 </em>
 </td>
 <td>
-<p>Template describes the Pod that will be created for the GameServer</p>
+<p>Name is the descriptive name of the port</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>players</code></br>
+<code>portPolicy</code></br>
 <em>
-<a href="#agones.dev/v1.PlayersSpec">
-PlayersSpec
+<a href="#agones.dev/v1.PortPolicy">
+PortPolicy
 </a>
 </em>
 </td>
 <td>
-<em>(Optional)</em>
-<p>(Alpha, PlayerTracking feature flag) Players provides the configuration for player tracking features.</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>counters</code></br>
+<code>container</code></br>
 <em>
-<a href="#agones.dev/v1.CounterStatus">
-map[string]agones.dev/agones/pkg/apis/agones/v1.CounterStatus
-</a>
+string
 </em>
 </td>
 <td>
 <em>(Optional)</em>
-<p>(Alpha, CountsAndLists feature flag) Counters and Lists provides the configuration for generic tracking features.</p>
+<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>lists</code></br>
+<code>containerPort</code></br>
 <em>
-<a href="#agones.dev/v1.ListStatus">
-map[string]agones.dev/agones/pkg/apis/agones/v1.ListStatus
-</a>
+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>eviction</code></br>
+<code>hostPort</code></br>
 <em>
-<a href="#agones.dev/v1.Eviction">
-Eviction
-</a>
+int32
 </em>
 </td>
 <td>
-<em>(Optional)</em>
-<p>Eviction specifies the eviction tolerance of the GameServer. Defaults to &ldquo;Never&rdquo;.</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="#agones.dev/v1.GameServerStatus">
-GameServerStatus
+<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="agones.dev/v1.GameServerSet">GameServerSet
+<h3 id="agones.dev/v1.GameServerSetSpec">GameServerSetSpec
 </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="#agones.dev/v1.GameServerSet">GameServerSet</a>)
+</p>
+<p>
+<p>GameServerSetSpec the specification for GameServerSet</p>
 </p>
 <table>
 <thead>
@@ -5074,50 +4881,6 @@ <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>
-<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.GameServerSetSpec">
-GameServerSetSpec
-</a>
-</em>
-</td>
-<td>
-<br/>
-<br/>
-<table>
-<tr>
-<td>
 <code>replicas</code></br>
 <em>
 int32
@@ -5168,32 +4931,16 @@ <h3 id="agones.dev/v1.GameServerSet">GameServerSet
 <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="agones.dev/v1.AggregatedPlayerStatus">AggregatedPlayerStatus
+<h3 id="agones.dev/v1.GameServerSetStatus">GameServerSetStatus
 </h3>
 <p>
 (<em>Appears on:</em>
-<a href="#agones.dev/v1.FleetStatus">FleetStatus</a>, 
-<a href="#agones.dev/v1.GameServerSetStatus">GameServerSetStatus</a>)
+<a href="#agones.dev/v1.GameServerSet">GameServerSet</a>)
 </p>
 <p>
-<p>AggregatedPlayerStatus stores total player tracking values</p>
+<p>GameServerSetStatus is the status of a GameServerSet</p>
 </p>
 <table>
 <thead>
@@ -5205,165 +4952,116 @@ <h3 id="agones.dev/v1.AggregatedPlayerStatus">AggregatedPlayerStatus
 <tbody>
 <tr>
 <td>
-<code>count</code></br>
+<code>replicas</code></br>
 <em>
-int64
+int32
 </em>
 </td>
 <td>
+<p>Replicas is the total number of current GameServer replicas</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>capacity</code></br>
+<code>readyReplicas</code></br>
 <em>
-int64
+int32
 </em>
 </td>
 <td>
+<p>ReadyReplicas is the number of Ready GameServer replicas</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>
-</thead>
-<tbody>
 <tr>
 <td>
-<code>labels</code></br>
+<code>reservedReplicas</code></br>
 <em>
-map[string]string
+int32
 </em>
 </td>
 <td>
-<em>(Optional)</em>
-<p>Labels to be applied to the <code>GameServer</code></p>
+<p>ReservedReplicas is the number of Reserved GameServer replicas</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>annotations</code></br>
+<code>allocatedReplicas</code></br>
 <em>
-map[string]string
+int32
 </em>
 </td>
 <td>
-<em>(Optional)</em>
-<p>Annotations to be applied to the <code>GameServer</code></p>
+<p>AllocatedReplicas is the number of Allocated GameServer replicas</p>
 </td>
 </tr>
-</tbody>
-</table>
-<h3 id="agones.dev/v1.CounterStatus">CounterStatus
-</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>CounterStatus stores the current counter values</p>
-</p>
-<table>
-<thead>
-<tr>
-<th>Field</th>
-<th>Description</th>
-</tr>
-</thead>
-<tbody>
 <tr>
 <td>
-<code>count</code></br>
+<code>shutdownReplicas</code></br>
 <em>
-int64
+int32
 </em>
 </td>
 <td>
+<p>ShutdownReplicas is the number of Shutdown GameServers replicas</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>capacity</code></br>
+<code>players</code></br>
 <em>
-int64
+<a href="#agones.dev/v1.AggregatedPlayerStatus">
+AggregatedPlayerStatus
+</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>
 </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>
+<td>
+<code>counters</code></br>
+<em>
+<a href="#agones.dev/v1.AggregatedCounterStatus">
+map[string]agones.dev/agones/pkg/apis/agones/v1.AggregatedCounterStatus
+</a>
+</em>
+</td>
+<td>
+<em>(Optional)</em>
+<p>(Alpha, CountsAndLists feature flag) Counters provides aggregated Counter capacity and Counter
+count for this GameServerSet.</p>
+</td>
 </tr>
-</thead>
-<tbody>
 <tr>
 <td>
-<code>safe</code></br>
+<code>lists</code></br>
 <em>
-<a href="#agones.dev/v1.EvictionSafe">
-EvictionSafe
+<a href="#agones.dev/v1.AggregatedListStatus">
+map[string]agones.dev/agones/pkg/apis/agones/v1.AggregatedListStatus
 </a>
 </em>
 </td>
 <td>
-<p>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>
+<em>(Optional)</em>
+<p>(Alpha, CountsAndLists feature flag) Lists provides aggregated List capacity and List values
+for this GameServerSet.</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="agones.dev/v1.GameServerSpec">GameServerSpec
 </h3>
 <p>
 (<em>Appears on:</em>
-<a href="#agones.dev/v1.Fleet">Fleet</a>)
+<a href="#agones.dev/v1.GameServer">GameServer</a>, 
+<a href="#agones.dev/v1.GameServerTemplateSpec">GameServerTemplateSpec</a>)
 </p>
 <p>
-<p>FleetSpec is the spec for a Fleet</p>
+<p>GameServerSpec is the spec for a GameServer resource</p>
 </p>
 <table>
 <thead>
@@ -5375,43 +5073,40 @@ <h3 id="agones.dev/v1.FleetSpec">FleetSpec
 <tbody>
 <tr>
 <td>
-<code>replicas</code></br>
+<code>container</code></br>
 <em>
-int32
+string
 </em>
 </td>
 <td>
-<p>Replicas are the number of GameServers that should be in this set. Defaults to 0.</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>allocationOverflow</code></br>
+<code>ports</code></br>
 <em>
-<a href="#agones.dev/v1.AllocationOverflow">
-AllocationOverflow
+<a href="#agones.dev/v1.GameServerPort">
+[]GameServerPort
 </a>
 </em>
 </td>
 <td>
-<em>(Optional)</em>
-<p>[Stage: Alpha]
-[FeatureFlag:FleetAllocationOverflow]
-Labels and/or Annotations to apply to overflowing GameServers when the number of Allocated GameServers is more
-than the desired replicas on the underlying <code>GameServerSet</code></p>
+<p>Ports are the array of ports that can be exposed via the game server</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>strategy</code></br>
+<code>health</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="#agones.dev/v1.Health">
+Health
 </a>
 </em>
 </td>
 <td>
-<p>Deployment strategy</p>
+<p>Health configures health checking</p>
 </td>
 </tr>
 <tr>
@@ -5422,114 +5117,109 @@ <h3 id="agones.dev/v1.FleetSpec">FleetSpec
 </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>template</code></br>
+<code>sdkServer</code></br>
 <em>
-<a href="#agones.dev/v1.GameServerTemplateSpec">
-GameServerTemplateSpec
+<a href="#agones.dev/v1.SdkServer">
+SdkServer
 </a>
 </em>
 </td>
 <td>
-<p>Template the GameServer template to apply for this Fleet</p>
+<p>SdkServer specifies parameters for the Agones SDK Server sidecar container</p>
 </td>
 </tr>
-</tbody>
-</table>
-<h3 id="agones.dev/v1.FleetStatus">FleetStatus
-</h3>
-<p>
-(<em>Appears on:</em>
-<a href="#agones.dev/v1.Fleet">Fleet</a>, 
-<a href="#autoscaling.agones.dev/v1.FleetAutoscaleRequest">FleetAutoscaleRequest</a>)
-</p>
-<p>
-<p>FleetStatus is the status of a Fleet</p>
-</p>
-<table>
-<thead>
-<tr>
-<th>Field</th>
-<th>Description</th>
-</tr>
-</thead>
-<tbody>
 <tr>
 <td>
-<code>replicas</code></br>
+<code>template</code></br>
 <em>
-int32
+<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>Replicas the total number of current GameServer replicas</p>
+<p>Template describes the Pod that will be created for the GameServer</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>readyReplicas</code></br>
+<code>players</code></br>
 <em>
-int32
+<a href="#agones.dev/v1.PlayersSpec">
+PlayersSpec
+</a>
 </em>
 </td>
 <td>
-<p>ReadyReplicas are the number of Ready GameServer replicas</p>
+<em>(Optional)</em>
+<p>(Alpha, PlayerTracking feature flag) Players provides the configuration for player tracking features.</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>reservedReplicas</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>
-<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>
+<em>(Optional)</em>
+<p>(Alpha, CountsAndLists feature flag) Counters and Lists provides the configuration for generic tracking features.</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>allocatedReplicas</code></br>
+<code>lists</code></br>
 <em>
-int32
+<a href="#agones.dev/v1.ListStatus">
+map[string]agones.dev/agones/pkg/apis/agones/v1.ListStatus
+</a>
 </em>
 </td>
 <td>
-<p>AllocatedReplicas are the number of Allocated GameServer replicas</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>players</code></br>
+<code>eviction</code></br>
 <em>
-<a href="#agones.dev/v1.AggregatedPlayerStatus">
-AggregatedPlayerStatus
+<a href="#agones.dev/v1.Eviction">
+Eviction
 </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>
+<p>Eviction specifies the eviction tolerance of the GameServer. Defaults to &ldquo;Never&rdquo;.</p>
 </td>
 </tr>
 </tbody>
 </table>
-<h3 id="agones.dev/v1.GameServerPort">GameServerPort
+<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="#agones.dev/v1.GameServerSpec">GameServerSpec</a>)
+<a href="#agones.dev/v1.GameServer">GameServer</a>)
 </p>
 <p>
-<p>GameServerPort defines a set of Ports that
-are to be exposed via the GameServer</p>
+<p>GameServerStatus is the status for a GameServer resource</p>
 </p>
 <table>
 <thead>
@@ -5541,160 +5231,129 @@ <h3 id="agones.dev/v1.GameServerPort">GameServerPort
 <tbody>
 <tr>
 <td>
-<code>name</code></br>
+<code>state</code></br>
 <em>
-string
+<a href="#agones.dev/v1.GameServerState">
+GameServerState
+</a>
 </em>
 </td>
 <td>
-<p>Name is the descriptive name of the port</p>
+<p>GameServerState is the current state of a GameServer, e.g. Creating, Starting, Ready, etc</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>portPolicy</code></br>
+<code>ports</code></br>
 <em>
-<a href="#agones.dev/v1.PortPolicy">
-PortPolicy
+<a href="#agones.dev/v1.GameServerStatusPort">
+[]GameServerStatusPort
 </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>
+<code>address</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>
-<em>
-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>
+<code>nodeName</code></br>
 <em>
-int32
+string
 </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>
+<code>reservedUntil</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="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>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>
-<p>
-(<em>Appears on:</em>
-<a href="#agones.dev/v1.GameServerSet">GameServerSet</a>)
-</p>
-<p>
-<p>GameServerSetSpec the specification for GameServerSet</p>
-</p>
-<table>
-<thead>
-<tr>
-<th>Field</th>
-<th>Description</th>
-</tr>
-</thead>
-<tbody>
 <tr>
 <td>
-<code>replicas</code></br>
+<code>players</code></br>
 <em>
-int32
+<a href="#agones.dev/v1.PlayerStatus">
+PlayerStatus
+</a>
 </em>
 </td>
 <td>
-<p>Replicas are the number of GameServers that should be in this set</p>
+<em>(Optional)</em>
+<p>[Stage:Alpha]
+[FeatureFlag:PlayerTracking]</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>allocationOverflow</code></br>
+<code>counters</code></br>
 <em>
-<a href="#agones.dev/v1.AllocationOverflow">
-AllocationOverflow
+<a href="#agones.dev/v1.CounterStatus">
+map[string]agones.dev/agones/pkg/apis/agones/v1.CounterStatus
 </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) Counters and Lists provides the configuration for generic tracking features.</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>scheduling</code></br>
+<code>lists</code></br>
 <em>
-agones.dev/agones/pkg/apis.SchedulingStrategy
+<a href="#agones.dev/v1.ListStatus">
+map[string]agones.dev/agones/pkg/apis/agones/v1.ListStatus
+</a>
 </em>
 </td>
 <td>
-<p>Scheduling strategy. Defaults to &ldquo;Packed&rdquo;.</p>
+<em>(Optional)</em>
 </td>
 </tr>
 <tr>
 <td>
-<code>template</code></br>
+<code>eviction</code></br>
 <em>
-<a href="#agones.dev/v1.GameServerTemplateSpec">
-GameServerTemplateSpec
+<a href="#agones.dev/v1.Eviction">
+Eviction
 </a>
 </em>
 </td>
 <td>
-<p>Template the GameServer template to apply for this GameServerSet</p>
+<em>(Optional)</em>
+<p>Eviction specifies the eviction tolerance of the GameServer.</p>
 </td>
 </tr>
 </tbody>
 </table>
-<h3 id="agones.dev/v1.GameServerSetStatus">GameServerSetStatus
+<h3 id="agones.dev/v1.GameServerStatusPort">GameServerStatusPort
 </h3>
 <p>
 (<em>Appears on:</em>
-<a href="#agones.dev/v1.GameServerSet">GameServerSet</a>)
+<a href="#allocation.agones.dev/v1.GameServerAllocationStatus">GameServerAllocationStatus</a>, 
+<a href="#agones.dev/v1.GameServerStatus">GameServerStatus</a>)
 </p>
 <p>
-<p>GameServerSetStatus is the status of a GameServerSet</p>
+<p>GameServerStatusPort shows the port that was allocated to a
+GameServer.</p>
 </p>
 <table>
 <thead>
@@ -5706,95 +5365,71 @@ <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>
+<code>name</code></br>
 <em>
-int32
+string
 </em>
 </td>
 <td>
-<p>ReadyReplicas is the number of Ready GameServer replicas</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>reservedReplicas</code></br>
+<code>port</code></br>
 <em>
 int32
 </em>
 </td>
 <td>
-<p>ReservedReplicas is the number of Reserved GameServer replicas</p>
 </td>
 </tr>
+</tbody>
+</table>
+<h3 id="agones.dev/v1.GameServerTemplateSpec">GameServerTemplateSpec
+</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>GameServerTemplateSpec is a template for GameServers</p>
+</p>
+<table>
+<thead>
 <tr>
-<td>
-<code>allocatedReplicas</code></br>
-<em>
-int32
-</em>
-</td>
-<td>
-<p>AllocatedReplicas is the number of Allocated GameServer replicas</p>
-</td>
+<th>Field</th>
+<th>Description</th>
 </tr>
+</thead>
+<tbody>
 <tr>
 <td>
-<code>shutdownReplicas</code></br>
+<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>ShutdownReplicas is the number of Shutdown GameServers replicas</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.AggregatedPlayerStatus">
-AggregatedPlayerStatus
+<a href="#agones.dev/v1.GameServerSpec">
+GameServerSpec
 </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>
-</td>
-</tr>
-</tbody>
-</table>
-<h3 id="agones.dev/v1.GameServerSpec">GameServerSpec
-</h3>
-<p>
-(<em>Appears on:</em>
-<a href="#agones.dev/v1.GameServer">GameServer</a>, 
-<a href="#agones.dev/v1.GameServerTemplateSpec">GameServerTemplateSpec</a>)
-</p>
-<p>
-<p>GameServerSpec is the spec for a GameServer resource</p>
-</p>
+<br/>
+<br/>
 <table>
-<thead>
-<tr>
-<th>Field</th>
-<th>Description</th>
-</tr>
-</thead>
-<tbody>
 <tr>
 <td>
 <code>container</code></br>
@@ -5924,26 +5559,19 @@ <h3 id="agones.dev/v1.GameServerSpec">GameServerSpec
 <p>Eviction specifies the eviction tolerance of the GameServer. Defaults to &ldquo;Never&rdquo;.</p>
 </td>
 </tr>
+</table>
+</td>
+</tr>
 </tbody>
 </table>
-<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 id="agones.dev/v1.Health">Health
 </h3>
 <p>
 (<em>Appears on:</em>
-<a href="#agones.dev/v1.GameServer">GameServer</a>)
+<a href="#agones.dev/v1.GameServerSpec">GameServerSpec</a>)
 </p>
 <p>
-<p>GameServerStatus is the status for a GameServer resource</p>
+<p>Health configures health checking on the GameServer</p>
 </p>
 <table>
 <thead>
@@ -5955,56 +5583,73 @@ <h3 id="agones.dev/v1.GameServerStatus">GameServerStatus
 <tbody>
 <tr>
 <td>
-<code>state</code></br>
+<code>disabled</code></br>
 <em>
-<a href="#agones.dev/v1.GameServerState">
-GameServerState
-</a>
+bool
 </em>
 </td>
 <td>
-<p>GameServerState is the current state of a GameServer, e.g. Creating, Starting, Ready, etc</p>
+<p>Disabled is whether health checking is disabled or not</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>ports</code></br>
+<code>periodSeconds</code></br>
 <em>
-<a href="#agones.dev/v1.GameServerStatusPort">
-[]GameServerStatusPort
-</a>
+int32
 </em>
 </td>
 <td>
+<p>PeriodSeconds is the number of seconds each health ping has to occur in</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>address</code></br>
+<code>failureThreshold</code></br>
 <em>
-string
+int32
 </em>
 </td>
 <td>
+<p>FailureThreshold how many failures in a row constitutes unhealthy</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>nodeName</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>
-<td>
-<code>reservedUntil</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>
+<th>Field</th>
+<th>Description</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td>
+<code>capacity</code></br>
+<em>
+int64
 </em>
 </td>
 <td>
@@ -6012,72 +5657,73 @@ <h3 id="agones.dev/v1.GameServerStatus">GameServerStatus
 </tr>
 <tr>
 <td>
-<code>players</code></br>
+<code>values</code></br>
 <em>
-<a href="#agones.dev/v1.PlayerStatus">
-PlayerStatus
-</a>
+[]string
 </em>
 </td>
 <td>
-<em>(Optional)</em>
-<p>[Stage:Alpha]
-[FeatureFlag:PlayerTracking]</p>
 </td>
 </tr>
+</tbody>
+</table>
+<h3 id="agones.dev/v1.PlayerStatus">PlayerStatus
+</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>
+<table>
+<thead>
+<tr>
+<th>Field</th>
+<th>Description</th>
+</tr>
+</thead>
+<tbody>
 <tr>
 <td>
-<code>counters</code></br>
+<code>count</code></br>
 <em>
-<a href="#agones.dev/v1.CounterStatus">
-map[string]agones.dev/agones/pkg/apis/agones/v1.CounterStatus
-</a>
+int64
 </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>capacity</code></br>
 <em>
-<a href="#agones.dev/v1.ListStatus">
-map[string]agones.dev/agones/pkg/apis/agones/v1.ListStatus
-</a>
+int64
 </em>
 </td>
 <td>
-<em>(Optional)</em>
 </td>
 </tr>
 <tr>
 <td>
-<code>eviction</code></br>
+<code>ids</code></br>
 <em>
-<a href="#agones.dev/v1.Eviction">
-Eviction
-</a>
+[]string
 </em>
 </td>
 <td>
-<em>(Optional)</em>
-<p>Eviction specifies the eviction tolerance of the GameServer.</p>
 </td>
 </tr>
 </tbody>
 </table>
-<h3 id="agones.dev/v1.GameServerStatusPort">GameServerStatusPort
+<h3 id="agones.dev/v1.PlayersSpec">PlayersSpec
 </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="#agones.dev/v1.GameServerSpec">GameServerSpec</a>)
 </p>
 <p>
-<p>GameServerStatusPort shows the port that was allocated to a
-GameServer.</p>
+<p>PlayersSpec tracks the initial player capacity</p>
 </p>
 <table>
 <thead>
@@ -6089,35 +5735,102 @@ <h3 id="agones.dev/v1.GameServerStatusPort">GameServerStatusPort
 <tbody>
 <tr>
 <td>
-<code>name</code></br>
+<code>initialCapacity</code></br>
 <em>
-string
+int64
+</em>
+</td>
+<td>
+</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>
+<p>
+(<em>Appears on:</em>
+<a href="#agones.dev/v1.GameServerSpec">GameServerSpec</a>)
+</p>
+<p>
+<p>SdkServer specifies parameters for the Agones SDK Server sidecar container</p>
+</p>
+<table>
+<thead>
+<tr>
+<th>Field</th>
+<th>Description</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td>
+<code>logLevel</code></br>
+<em>
+<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>port</code></br>
+<code>grpcPort</code></br>
+<em>
+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>httpPort</code></br>
 <em>
 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.GameServerTemplateSpec">GameServerTemplateSpec
-</h3>
+<h3 id="agones.dev/v1.SdkServerLogLevel">SdkServerLogLevel
+(<code>string</code> alias)</p></h3>
 <p>
 (<em>Appears on:</em>
-<a href="#agones.dev/v1.FleetSpec">FleetSpec</a>, 
-<a href="#agones.dev/v1.GameServerSetSpec">GameServerSetSpec</a>)
+<a href="#agones.dev/v1.SdkServer">SdkServer</a>)
 </p>
 <p>
-<p>GameServerTemplateSpec is a template for GameServers</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>
+<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>
+</li></ul>
+<h3 id="allocation.agones.dev/v1.GameServerAllocation">GameServerAllocation
+</h3>
+<p>
+<p>GameServerAllocation is the data structure for allocating against a set of
+GameServers, defined <code>selectors</code> selectors</p>
 </p>
 <table>
 <thead>
@@ -6129,6 +5842,23 @@ <h3 id="agones.dev/v1.GameServerTemplateSpec">GameServerTemplateSpec
 <tbody>
 <tr>
 <td>
+<code>apiVersion</code></br>
+string</td>
+<td>
+<code>
+allocation.agones.dev/v1
+</code>
+</td>
+</tr>
+<tr>
+<td>
+<code>kind</code></br>
+string
+</td>
+<td><code>GameServerAllocation</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">
@@ -6145,8 +5875,8 @@ <h3 id="agones.dev/v1.GameServerTemplateSpec">GameServerTemplateSpec
 <td>
 <code>spec</code></br>
 <em>
-<a href="#agones.dev/v1.GameServerSpec">
-GameServerSpec
+<a href="#allocation.agones.dev/v1.GameServerAllocationSpec">
+GameServerAllocationSpec
 </a>
 </em>
 </td>
@@ -6156,210 +5886,164 @@ <h3 id="agones.dev/v1.GameServerTemplateSpec">GameServerTemplateSpec
 <table>
 <tr>
 <td>
-<code>container</code></br>
+<code>multiClusterSetting</code></br>
 <em>
-string
+<a href="#allocation.agones.dev/v1.MultiClusterSetting">
+MultiClusterSetting
+</a>
 </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>MultiClusterPolicySelector if specified, multi-cluster policies are applied.
+Otherwise, allocation will happen locally.</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>ports</code></br>
+<code>required</code></br>
 <em>
-<a href="#agones.dev/v1.GameServerPort">
-[]GameServerPort
+<a href="#allocation.agones.dev/v1.GameServerSelector">
+GameServerSelector
 </a>
 </em>
 </td>
 <td>
-<p>Ports are the array of ports that can be exposed via the game server</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>health</code></br>
+<code>preferred</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.
+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>scheduling</code></br>
+<code>priorities</code></br>
 <em>
-agones.dev/agones/pkg/apis.SchedulingStrategy
+<a href="#allocation.agones.dev/v1.Priority">
+[]Priority
+</a>
 </em>
 </td>
 <td>
-<p>Scheduling strategy. Defaults to &ldquo;Packed&rdquo;</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>sdkServer</code></br>
+<code>selectors</code></br>
 <em>
-<a href="#agones.dev/v1.SdkServer">
-SdkServer
+<a href="#allocation.agones.dev/v1.GameServerSelector">
+[]GameServerSelector
 </a>
 </em>
 </td>
 <td>
-<p>SdkServer specifies parameters for the Agones SDK Server sidecar container</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>template</code></br>
+<code>scheduling</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>
+agones.dev/agones/pkg/apis.SchedulingStrategy
 </em>
 </td>
 <td>
-<p>Template describes the Pod that will be created for the GameServer</p>
+<p>Scheduling strategy. Defaults to &ldquo;Packed&rdquo;.</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>players</code></br>
+<code>metadata</code></br>
 <em>
-<a href="#agones.dev/v1.PlayersSpec">
-PlayersSpec
+<a href="#allocation.agones.dev/v1.MetaPatch">
+MetaPatch
 </a>
 </em>
 </td>
 <td>
-<em>(Optional)</em>
-<p>(Alpha, PlayerTracking feature flag) Players provides the configuration for player 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>counters</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.CounterAction">
+map[string]agones.dev/agones/pkg/apis/allocation/v1.CounterAction
 </a>
 </em>
 </td>
 <td>
 <em>(Optional)</em>
-<p>(Alpha, CountsAndLists feature flag) Counters and Lists provides the configuration for generic tracking features.</p>
+<p>(Alpha, CountsAndLists feature flag) Counters and Lists provide a set of actions to perform
+on Counters and Lists during allocation.</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 href="#allocation.agones.dev/v1.ListAction">
+map[string]agones.dev/agones/pkg/apis/allocation/v1.ListAction
 </a>
 </em>
 </td>
 <td>
-<em>(Optional)</em>
-<p>Eviction specifies the eviction tolerance of the GameServer. Defaults to &ldquo;Never&rdquo;.</p>
-</td>
-</tr>
-</table>
 </td>
 </tr>
-</tbody>
 </table>
-<h3 id="agones.dev/v1.Health">Health
-</h3>
-<p>
-(<em>Appears on:</em>
-<a href="#agones.dev/v1.GameServerSpec">GameServerSpec</a>)
-</p>
-<p>
-<p>Health configures health checking on the GameServer</p>
-</p>
-<table>
-<thead>
-<tr>
-<th>Field</th>
-<th>Description</th>
-</tr>
-</thead>
-<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>
-<em>
-int32
-</em>
-</td>
-<td>
-<p>PeriodSeconds is the number of seconds each health ping has to occur in</p>
-</td>
-</tr>
-<tr>
-<td>
-<code>failureThreshold</code></br>
-<em>
-int32
-</em>
-</td>
-<td>
-<p>FailureThreshold how many failures in a row constitutes unhealthy</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>initialDelaySeconds</code></br>
+<code>status</code></br>
 <em>
-int32
+<a href="#allocation.agones.dev/v1.GameServerAllocationStatus">
+GameServerAllocationStatus
+</a>
 </em>
 </td>
 <td>
-<p>InitialDelaySeconds initial delay before checking health</p>
 </td>
 </tr>
 </tbody>
 </table>
-<h3 id="agones.dev/v1.ListStatus">ListStatus
+<h3 id="allocation.agones.dev/v1.CounterAction">CounterAction
 </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>ListStatus stores the current list values</p>
+<p>CounterAction is an optional action that can be performed on a Counter at allocation.
+Action: &ldquo;Increment&rdquo; or &ldquo;Decrement&rdquo; the Counter&rsquo;s Count (optional). Must also define the Amount.
+Amount: The amount to increment or decrement the Count (optional). Must be a positive integer.
+Capacity: Update the maximum capacity of the Counter to this number (optional). Min 0, Max int64.</p>
 </p>
 <table>
 <thead>
@@ -6371,46 +6055,17 @@ <h3 id="agones.dev/v1.ListStatus">ListStatus
 <tbody>
 <tr>
 <td>
-<code>capacity</code></br>
-<em>
-int64
-</em>
-</td>
-<td>
-</td>
-</tr>
-<tr>
-<td>
-<code>values</code></br>
+<code>action</code></br>
 <em>
-[]string
+string
 </em>
 </td>
 <td>
 </td>
 </tr>
-</tbody>
-</table>
-<h3 id="agones.dev/v1.PlayerStatus">PlayerStatus
-</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>
-<table>
-<thead>
-<tr>
-<th>Field</th>
-<th>Description</th>
-</tr>
-</thead>
-<tbody>
 <tr>
 <td>
-<code>count</code></br>
+<code>amount</code></br>
 <em>
 int64
 </em>
@@ -6428,26 +6083,17 @@ <h3 id="agones.dev/v1.PlayerStatus">PlayerStatus
 <td>
 </td>
 </tr>
-<tr>
-<td>
-<code>ids</code></br>
-<em>
-[]string
-</em>
-</td>
-<td>
-</td>
-</tr>
 </tbody>
 </table>
-<h3 id="agones.dev/v1.PlayersSpec">PlayersSpec
+<h3 id="allocation.agones.dev/v1.CounterSelector">CounterSelector
 </h3>
 <p>
 (<em>Appears on:</em>
-<a href="#agones.dev/v1.GameServerSpec">GameServerSpec</a>)
+<a href="#allocation.agones.dev/v1.GameServerSelector">GameServerSelector</a>)
 </p>
 <p>
-<p>PlayersSpec tracks the initial player capacity</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>
@@ -6459,7 +6105,7 @@ <h3 id="agones.dev/v1.PlayersSpec">PlayersSpec
 <tbody>
 <tr>
 <td>
-<code>initialCapacity</code></br>
+<code>minCount</code></br>
 <em>
 int64
 </em>
@@ -6467,94 +6113,46 @@ <h3 id="agones.dev/v1.PlayersSpec">PlayersSpec
 <td>
 </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>
-<p>
-(<em>Appears on:</em>
-<a href="#agones.dev/v1.GameServerSpec">GameServerSpec</a>)
-</p>
-<p>
-<p>SdkServer specifies parameters for the Agones SDK Server sidecar container</p>
-</p>
-<table>
-<thead>
-<tr>
-<th>Field</th>
-<th>Description</th>
-</tr>
-</thead>
-<tbody>
 <tr>
 <td>
-<code>logLevel</code></br>
+<code>maxCount</code></br>
 <em>
-<a href="#agones.dev/v1.SdkServerLogLevel">
-SdkServerLogLevel
-</a>
+int64
 </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>minAvailable</code></br>
 <em>
-int32
+int64
 </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>maxAvailable</code></br>
 <em>
-int32
+int64
 </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>
+<h3 id="allocation.agones.dev/v1.GameServerAllocationSpec">GameServerAllocationSpec
+</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>
-<p>
-<p>Package v1 is the v1 version of the API.</p>
+<a href="#allocation.agones.dev/v1.GameServerAllocation">GameServerAllocation</a>)
 </p>
-Resource Types:
-<ul><li>
-<a href="#allocation.agones.dev/v1.GameServerAllocation">GameServerAllocation</a>
-</li></ul>
-<h3 id="allocation.agones.dev/v1.GameServerAllocation">GameServerAllocation
-</h3>
 <p>
-<p>GameServerAllocation is the data structure for allocating against a set of
-GameServers, defined <code>selectors</code> selectors</p>
+<p>GameServerAllocationSpec is the spec for a GameServerAllocation</p>
 </p>
 <table>
 <thead>
@@ -6566,50 +6164,6 @@ <h3 id="allocation.agones.dev/v1.GameServerAllocation">GameServerAllocation
 <tbody>
 <tr>
 <td>
-<code>apiVersion</code></br>
-string</td>
-<td>
-<code>
-allocation.agones.dev/v1
-</code>
-</td>
-</tr>
-<tr>
-<td>
-<code>kind</code></br>
-string
-</td>
-<td><code>GameServerAllocation</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="#allocation.agones.dev/v1.GameServerAllocationSpec">
-GameServerAllocationSpec
-</a>
-</em>
-</td>
-<td>
-<br/>
-<br/>
-<table>
-<tr>
-<td>
 <code>multiClusterSetting</code></br>
 <em>
 <a href="#allocation.agones.dev/v1.MultiClusterSetting">
@@ -6740,34 +6294,112 @@ <h3 id="allocation.agones.dev/v1.GameServerAllocation">GameServerAllocation
 <td>
 </td>
 </tr>
+</tbody>
 </table>
-</td>
-</tr>
-<tr>
+<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>status</code></br>
+<code>state</code></br>
 <em>
-<a href="#allocation.agones.dev/v1.GameServerAllocationStatus">
-GameServerAllocationStatus
+<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>gameServerName</code></br>
+<em>
+string
+</em>
+</td>
+<td>
+</td>
+</tr>
+<tr>
+<td>
+<code>ports</code></br>
+<em>
+<a href="#agones.dev/v1.GameServerStatusPort">
+[]GameServerStatusPort
 </a>
 </em>
 </td>
 <td>
 </td>
 </tr>
+<tr>
+<td>
+<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>source</code></br>
+<em>
+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="allocation.agones.dev/v1.CounterAction">CounterAction
+<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>CounterAction is an optional action that can be performed on a Counter at allocation.
-Action: &ldquo;Increment&rdquo; or &ldquo;Decrement&rdquo; the Counter&rsquo;s Count (optional). Must also define the Amount.
-Amount: The amount to increment or decrement the Count (optional). Must be a positive integer.
-Capacity: Update the maximum capacity of the Counter to this number (optional). Min 0, Max int64.</p>
+<p>GameServerSelector contains all the filter options for selecting
+a GameServer for allocation.</p>
 </p>
 <table>
 <thead>
@@ -6779,7 +6411,153 @@ <h3 id="allocation.agones.dev/v1.CounterAction">CounterAction
 <tbody>
 <tr>
 <td>
-<code>action</code></br>
+<code>LabelSelector</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>
+</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>
+<em>
+<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>
+<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>
+<tr>
+<td>
+<code>counters</code></br>
+<em>
+<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>(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>lists</code></br>
+<em>
+<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="allocation.agones.dev/v1.ListAction">ListAction
+</h3>
+<p>
+(<em>Appears on:</em>
+<a href="#allocation.agones.dev/v1.GameServerAllocationSpec">GameServerAllocationSpec</a>)
+</p>
+<p>
+<p>ListAction is an optional action that can be performed on a List at allocation.
+AddValues: Append values to a List&rsquo;s Values array (optional). Any duplicate values will be ignored.
+Capacity: Update the maximum capacity of the Counter to this number (optional). Min 0, Max 1000.</p>
+</p>
+<table>
+<thead>
+<tr>
+<th>Field</th>
+<th>Description</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td>
+<code>addValues</code></br>
+<em>
+[]string
+</em>
+</td>
+<td>
+</td>
+</tr>
+<tr>
+<td>
+<code>capacity</code></br>
+<em>
+int64
+</em>
+</td>
+<td>
+</td>
+</tr>
+</tbody>
+</table>
+<h3 id="allocation.agones.dev/v1.ListSelector">ListSelector
+</h3>
+<p>
+(<em>Appears on:</em>
+<a href="#allocation.agones.dev/v1.GameServerSelector">GameServerSelector</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>
+<table>
+<thead>
+<tr>
+<th>Field</th>
+<th>Description</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td>
+<code>containsValue</code></br>
 <em>
 string
 </em>
@@ -6789,7 +6567,7 @@ <h3 id="allocation.agones.dev/v1.CounterAction">CounterAction
 </tr>
 <tr>
 <td>
-<code>amount</code></br>
+<code>minAvailable</code></br>
 <em>
 int64
 </em>
@@ -6799,25 +6577,644 @@ <h3 id="allocation.agones.dev/v1.CounterAction">CounterAction
 </tr>
 <tr>
 <td>
-<code>capacity</code></br>
+<code>maxAvailable</code></br>
+<em>
+int64
+</em>
+</td>
+<td>
+</td>
+</tr>
+</tbody>
+</table>
+<h3 id="allocation.agones.dev/v1.MetaPatch">MetaPatch
+</h3>
+<p>
+(<em>Appears on:</em>
+<a href="#allocation.agones.dev/v1.GameServerAllocationSpec">GameServerAllocationSpec</a>)
+</p>
+<p>
+<p>MetaPatch is the metadata used to patch the GameServer metadata on allocation</p>
+</p>
+<table>
+<thead>
+<tr>
+<th>Field</th>
+<th>Description</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td>
+<code>labels</code></br>
+<em>
+map[string]string
+</em>
+</td>
+<td>
+</td>
+</tr>
+<tr>
+<td>
+<code>annotations</code></br>
+<em>
+map[string]string
+</em>
+</td>
+<td>
+</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>
+<th>Field</th>
+<th>Description</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td>
+<code>enabled</code></br>
+<em>
+bool
+</em>
+</td>
+<td>
+</td>
+</tr>
+<tr>
+<td>
+<code>policySelector</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>
+</em>
+</td>
+<td>
+</td>
+</tr>
+</tbody>
+</table>
+<h3 id="allocation.agones.dev/v1.PlayerSelector">PlayerSelector
+</h3>
+<p>
+(<em>Appears on:</em>
+<a href="#allocation.agones.dev/v1.GameServerSelector">GameServerSelector</a>)
+</p>
+<p>
+<p>PlayerSelector is the filter options for a GameServer based on player counts</p>
+</p>
+<table>
+<thead>
+<tr>
+<th>Field</th>
+<th>Description</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td>
+<code>minAvailable</code></br>
+<em>
+int64
+</em>
+</td>
+<td>
+</td>
+</tr>
+<tr>
+<td>
+<code>maxAvailable</code></br>
+<em>
+int64
+</em>
+</td>
+<td>
+</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>
+<em>
+string
+</em>
+</td>
+<td>
+</td>
+</tr>
+<tr>
+<td>
+<code>key</code></br>
+<em>
+string
+</em>
+</td>
+<td>
+</td>
+</tr>
+<tr>
+<td>
+<code>order</code></br>
+<em>
+string
+</em>
+</td>
+<td>
+</td>
+</tr>
+</tbody>
+</table>
+<hr/>
+<h2 id="autoscaling.agones.dev/v1">autoscaling.agones.dev/v1</h2>
+<p>
+<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>FleetAutoscaler is the data structure for a FleetAutoscaler resource</p>
+</p>
+<table>
+<thead>
+<tr>
+<th>Field</th>
+<th>Description</th>
+</tr>
+</thead>
+<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>
+<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="#autoscaling.agones.dev/v1.FleetAutoscalerSpec">
+FleetAutoscalerSpec
+</a>
+</em>
+</td>
+<td>
+<br/>
+<br/>
+<table>
+<tr>
+<td>
+<code>fleetName</code></br>
+<em>
+string
+</em>
+</td>
+<td>
+</td>
+</tr>
+<tr>
+<td>
+<code>policy</code></br>
+<em>
+<a href="#autoscaling.agones.dev/v1.FleetAutoscalerPolicy">
+FleetAutoscalerPolicy
+</a>
+</em>
+</td>
+<td>
+<p>Autoscaling policy</p>
+</td>
+</tr>
+<tr>
+<td>
+<code>sync</code></br>
+<em>
+<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>
+</table>
+</td>
+</tr>
+<tr>
+<td>
+<code>status</code></br>
+<em>
+<a href="#autoscaling.agones.dev/v1.FleetAutoscalerStatus">
+FleetAutoscalerStatus
+</a>
+</em>
+</td>
+<td>
+</td>
+</tr>
+</tbody>
+</table>
+<h3 id="autoscaling.agones.dev/v1.BufferPolicy">BufferPolicy
+</h3>
+<p>
+(<em>Appears on:</em>
+<a href="#autoscaling.agones.dev/v1.FleetAutoscalerPolicy">FleetAutoscalerPolicy</a>)
+</p>
+<p>
+<p>BufferPolicy controls the desired behavior of the buffer policy.</p>
+</p>
+<table>
+<thead>
+<tr>
+<th>Field</th>
+<th>Description</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td>
+<code>maxReplicas</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>
+</td>
+</tr>
+<tr>
+<td>
+<code>minReplicas</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>
+</td>
+</tr>
+<tr>
+<td>
+<code>bufferSize</code></br>
+<em>
+k8s.io/apimachinery/pkg/util/intstr.IntOrString
+</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>
+</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>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td>
+<code>seconds</code></br>
+<em>
+int32
+</em>
+</td>
+<td>
+<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>
+<th>Field</th>
+<th>Description</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td>
+<code>uid</code></br>
+<em>
+k8s.io/apimachinery/pkg/types.UID
+</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>
+</td>
+</tr>
+<tr>
+<td>
+<code>name</code></br>
+<em>
+string
+</em>
+</td>
+<td>
+<p>Name is the name of the Fleet being scaled</p>
+</td>
+</tr>
+<tr>
+<td>
+<code>namespace</code></br>
+<em>
+string
+</em>
+</td>
+<td>
+<p>Namespace is the namespace associated with the request (if any).</p>
+</td>
+</tr>
+<tr>
+<td>
+<code>status</code></br>
+<em>
+<a href="#agones.dev/v1.FleetStatus">
+FleetStatus
+</a>
+</em>
+</td>
+<td>
+<p>The Fleet&rsquo;s status values</p>
+</td>
+</tr>
+</tbody>
+</table>
+<h3 id="autoscaling.agones.dev/v1.FleetAutoscaleResponse">FleetAutoscaleResponse
+</h3>
+<p>
+(<em>Appears on:</em>
+<a href="#autoscaling.agones.dev/v1.FleetAutoscaleReview">FleetAutoscaleReview</a>)
+</p>
+<p>
+<p>FleetAutoscaleResponse defines the response of webhook autoscaler endpoint</p>
+</p>
+<table>
+<thead>
+<tr>
+<th>Field</th>
+<th>Description</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td>
+<code>uid</code></br>
+<em>
+k8s.io/apimachinery/pkg/types.UID
+</em>
+</td>
+<td>
+<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>scale</code></br>
+<em>
+bool
+</em>
+</td>
+<td>
+<p>Set to false if no scaling should occur to the Fleet</p>
+</td>
+</tr>
+<tr>
+<td>
+<code>replicas</code></br>
+<em>
+int32
+</em>
+</td>
+<td>
+<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>
+<th>Field</th>
+<th>Description</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td>
+<code>request</code></br>
+<em>
+<a href="#autoscaling.agones.dev/v1.FleetAutoscaleRequest">
+FleetAutoscaleRequest
+</a>
+</em>
+</td>
+<td>
+</td>
+</tr>
+<tr>
+<td>
+<code>response</code></br>
+<em>
+<a href="#autoscaling.agones.dev/v1.FleetAutoscaleResponse">
+FleetAutoscaleResponse
+</a>
+</em>
+</td>
+<td>
+</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>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td>
+<code>type</code></br>
+<em>
+<a href="#autoscaling.agones.dev/v1.FleetAutoscalerPolicyType">
+FleetAutoscalerPolicyType
+</a>
+</em>
+</td>
+<td>
+<p>Type of autoscaling policy.</p>
+</td>
+</tr>
+<tr>
+<td>
+<code>buffer</code></br>
+<em>
+<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>webhook</code></br>
 <em>
-int64
+<a href="#autoscaling.agones.dev/v1.WebhookPolicy">
+WebhookPolicy
+</a>
 </em>
 </td>
 <td>
+<em>(Optional)</em>
+<p>Webhook policy config params. Present only if FleetAutoscalerPolicyType = Webhook.</p>
 </td>
 </tr>
 </tbody>
 </table>
-<h3 id="allocation.agones.dev/v1.CounterSelector">CounterSelector
+<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>
 <p>
 (<em>Appears on:</em>
-<a href="#allocation.agones.dev/v1.GameServerSelector">GameServerSelector</a>)
+<a href="#autoscaling.agones.dev/v1.FleetAutoscaler">FleetAutoscaler</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>FleetAutoscalerSpec is the spec for a Fleet Scaler</p>
 </p>
 <table>
 <thead>
@@ -6829,19 +7226,9 @@ <h3 id="allocation.agones.dev/v1.CounterSelector">CounterSelector
 <tbody>
 <tr>
 <td>
-<code>minCount</code></br>
-<em>
-int64
-</em>
-</td>
-<td>
-</td>
-</tr>
-<tr>
-<td>
-<code>maxCount</code></br>
+<code>fleetName</code></br>
 <em>
-int64
+string
 </em>
 </td>
 <td>
@@ -6849,34 +7236,43 @@ <h3 id="allocation.agones.dev/v1.CounterSelector">CounterSelector
 </tr>
 <tr>
 <td>
-<code>minAvailable</code></br>
+<code>policy</code></br>
 <em>
-int64
+<a href="#autoscaling.agones.dev/v1.FleetAutoscalerPolicy">
+FleetAutoscalerPolicy
+</a>
 </em>
 </td>
 <td>
+<p>Autoscaling policy</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>maxAvailable</code></br>
+<code>sync</code></br>
 <em>
-int64
+<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="allocation.agones.dev/v1.GameServerAllocationSpec">GameServerAllocationSpec
+<h3 id="autoscaling.agones.dev/v1.FleetAutoscalerStatus">FleetAutoscalerStatus
 </h3>
 <p>
 (<em>Appears on:</em>
-<a href="#allocation.agones.dev/v1.GameServerAllocation">GameServerAllocation</a>)
+<a href="#autoscaling.agones.dev/v1.FleetAutoscaler">FleetAutoscaler</a>)
 </p>
 <p>
-<p>GameServerAllocationSpec is the spec for a GameServerAllocation</p>
+<p>FleetAutoscalerStatus defines the current status of a FleetAutoscaler</p>
 </p>
 <table>
 <thead>
@@ -6888,155 +7284,132 @@ <h3 id="allocation.agones.dev/v1.GameServerAllocationSpec">GameServerAllocationS
 <tbody>
 <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>
+<code>currentReplicas</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.
-Required is the GameServer selector from which to choose GameServers from.
-Defaults to all GameServers.</p>
+<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>preferred</code></br>
+<code>desiredReplicas</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>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>priorities</code></br>
+<code>lastScaleTime</code></br>
 <em>
-<a href="#allocation.agones.dev/v1.Priority">
-[]Priority
+<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) 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>lastScaleTime is the last time the FleetAutoscaler scaled the attached fleet,</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>selectors</code></br>
+<code>ableToScale</code></br>
 <em>
-<a href="#allocation.agones.dev/v1.GameServerSelector">
-[]GameServerSelector
-</a>
+bool
 </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>AbleToScale indicates that we can access the target fleet</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>scheduling</code></br>
+<code>scalingLimited</code></br>
 <em>
-agones.dev/agones/pkg/apis.SchedulingStrategy
+bool
 </em>
 </td>
 <td>
-<p>Scheduling strategy. Defaults to &ldquo;Packed&rdquo;.</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="autoscaling.agones.dev/v1.FleetAutoscalerSync">FleetAutoscalerSync
+</h3>
+<p>
+(<em>Appears on:</em>
+<a href="#autoscaling.agones.dev/v1.FleetAutoscalerSpec">FleetAutoscalerSpec</a>)
+</p>
+<p>
+<p>FleetAutoscalerSync describes when to sync a fleet</p>
+</p>
+<table>
+<thead>
 <tr>
-<td>
-<code>metadata</code></br>
-<em>
-<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>
+<th>Field</th>
+<th>Description</th>
 </tr>
+</thead>
+<tbody>
 <tr>
 <td>
-<code>counters</code></br>
+<code>type</code></br>
 <em>
-<a href="#allocation.agones.dev/v1.CounterAction">
-map[string]agones.dev/agones/pkg/apis/allocation/v1.CounterAction
+<a href="#autoscaling.agones.dev/v1.FleetAutoscalerSyncType">
+FleetAutoscalerSyncType
 </a>
 </em>
 </td>
 <td>
-<em>(Optional)</em>
-<p>(Alpha, CountsAndLists feature flag) Counters and Lists provide a set of actions to perform
-on Counters and Lists during allocation.</p>
+<p>Type of autoscaling sync.</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>lists</code></br>
+<code>fixedInterval</code></br>
 <em>
-<a href="#allocation.agones.dev/v1.ListAction">
-map[string]agones.dev/agones/pkg/apis/allocation/v1.ListAction
+<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="allocation.agones.dev/v1.GameServerAllocationState">GameServerAllocationState
+<h3 id="autoscaling.agones.dev/v1.FleetAutoscalerSyncType">FleetAutoscalerSyncType
 (<code>string</code> alias)</p></h3>
 <p>
 (<em>Appears on:</em>
-<a href="#allocation.agones.dev/v1.GameServerAllocationStatus">GameServerAllocationStatus</a>)
+<a href="#autoscaling.agones.dev/v1.FleetAutoscalerSync">FleetAutoscalerSync</a>)
 </p>
 <p>
-<p>GameServerAllocationState is the Allocation state</p>
+<p>FleetAutoscalerSyncType is the sync strategy for a given Fleet</p>
 </p>
-<h3 id="allocation.agones.dev/v1.GameServerAllocationStatus">GameServerAllocationStatus
+<h3 id="autoscaling.agones.dev/v1.WebhookPolicy">WebhookPolicy
 </h3>
 <p>
 (<em>Appears on:</em>
-<a href="#allocation.agones.dev/v1.GameServerAllocation">GameServerAllocation</a>)
+<a href="#autoscaling.agones.dev/v1.FleetAutoscalerPolicy">FleetAutoscalerPolicy</a>)
 </p>
 <p>
-<p>GameServerAllocationStatus is the status for an GameServerAllocation resource</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>
@@ -7048,82 +7421,79 @@ <h3 id="allocation.agones.dev/v1.GameServerAllocationStatus">GameServerAllocatio
 <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>gameServerName</code></br>
+<code>url</code></br>
 <em>
 string
 </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>
 </td>
 </tr>
 <tr>
 <td>
-<code>ports</code></br>
+<code>service</code></br>
 <em>
-<a href="#agones.dev/v1.GameServerStatusPort">
-[]GameServerStatusPort
+<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>
+<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>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>source</code></br>
+<code>caBundle</code></br>
 <em>
-string
+[]byte
 </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>
+<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>
-<h3 id="allocation.agones.dev/v1.GameServerSelector">GameServerSelector
-</h3>
+<hr/>
+<h2 id="multicluster.agones.dev/v1">multicluster.agones.dev/v1</h2>
 <p>
-(<em>Appears on:</em>
-<a href="#allocation.agones.dev/v1.GameServerAllocationSpec">GameServerAllocationSpec</a>)
+<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>GameServerSelector contains all the filter options for selecting
-a GameServer for allocation.</p>
+<p>GameServerAllocationPolicy is the Schema for the gameserverallocationpolicies API</p>
 </p>
 <table>
 <thead>
@@ -7135,113 +7505,63 @@ <h3 id="allocation.agones.dev/v1.GameServerSelector">GameServerSelector
 <tbody>
 <tr>
 <td>
-<code>LabelSelector</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>
-</em>
-</td>
+<code>apiVersion</code></br>
+string</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>
+<code>
+multicluster.agones.dev/v1
+</code>
 </td>
 </tr>
 <tr>
 <td>
-<code>gameServerState</code></br>
-<em>
-<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>
+<code>kind</code></br>
+string
 </td>
+<td><code>GameServerAllocationPolicy</code></td>
 </tr>
 <tr>
 <td>
-<code>players</code></br>
+<code>metadata</code></br>
 <em>
-<a href="#allocation.agones.dev/v1.PlayerSelector">
-PlayerSelector
+<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: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>
+Refer to the Kubernetes API documentation for the fields of the
+<code>metadata</code> field.
 </td>
 </tr>
 <tr>
 <td>
-<code>counters</code></br>
+<code>spec</code></br>
 <em>
-<a href="#allocation.agones.dev/v1.CounterSelector">
-map[string]agones.dev/agones/pkg/apis/allocation/v1.CounterSelector
+<a href="#multicluster.agones.dev/v1.GameServerAllocationPolicySpec">
+GameServerAllocationPolicySpec
 </a>
 </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>
-</td>
-</tr>
+<br/>
+<br/>
+<table>
 <tr>
 <td>
-<code>lists</code></br>
+<code>priority</code></br>
 <em>
-<a href="#allocation.agones.dev/v1.ListSelector">
-map[string]agones.dev/agones/pkg/apis/allocation/v1.ListSelector
-</a>
+int32
 </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="allocation.agones.dev/v1.ListAction">ListAction
-</h3>
-<p>
-(<em>Appears on:</em>
-<a href="#allocation.agones.dev/v1.GameServerAllocationSpec">GameServerAllocationSpec</a>)
-</p>
-<p>
-<p>ListAction is an optional action that can be performed on a List at allocation.
-AddValues: Append values to a List&rsquo;s Values array (optional). Any duplicate values will be ignored.
-Capacity: Update the maximum capacity of the Counter to this number (optional). Min 0, Max 1000.</p>
-</p>
-<table>
-<thead>
-<tr>
-<th>Field</th>
-<th>Description</th>
-</tr>
-</thead>
-<tbody>
 <tr>
 <td>
-<code>addValues</code></br>
+<code>weight</code></br>
 <em>
-[]string
+int
 </em>
 </td>
 <td>
@@ -7249,27 +7569,29 @@ <h3 id="allocation.agones.dev/v1.ListAction">ListAction
 </tr>
 <tr>
 <td>
-<code>capacity</code></br>
+<code>connectionInfo</code></br>
 <em>
-int64
+<a href="#multicluster.agones.dev/v1.ClusterConnectionInfo">
+ClusterConnectionInfo
+</a>
 </em>
 </td>
 <td>
 </td>
 </tr>
+</table>
+</td>
+</tr>
 </tbody>
 </table>
-<h3 id="allocation.agones.dev/v1.ListSelector">ListSelector
+<h3 id="multicluster.agones.dev/v1.ClusterConnectionInfo">ClusterConnectionInfo
 </h3>
 <p>
 (<em>Appears on:</em>
-<a href="#allocation.agones.dev/v1.GameServerSelector">GameServerSelector</a>)
+<a href="#multicluster.agones.dev/v1.GameServerAllocationPolicySpec">GameServerAllocationPolicySpec</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>ClusterConnectionInfo defines the connection information for a cluster</p>
 </p>
 <table>
 <thead>
@@ -7281,83 +7603,67 @@ <h3 id="allocation.agones.dev/v1.ListSelector">ListSelector
 <tbody>
 <tr>
 <td>
-<code>containsValue</code></br>
+<code>clusterName</code></br>
 <em>
 string
 </em>
 </td>
 <td>
+<p>Optional: the name of the targeted cluster</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>minAvailable</code></br>
+<code>allocationEndpoints</code></br>
 <em>
-int64
+[]string
 </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>
 </td>
 </tr>
 <tr>
 <td>
-<code>maxAvailable</code></br>
+<code>secretName</code></br>
 <em>
-int64
+string
 </em>
 </td>
 <td>
+<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="allocation.agones.dev/v1.MetaPatch">MetaPatch
-</h3>
-<p>
-(<em>Appears on:</em>
-<a href="#allocation.agones.dev/v1.GameServerAllocationSpec">GameServerAllocationSpec</a>)
-</p>
-<p>
-<p>MetaPatch is the metadata used to patch the GameServer metadata on allocation</p>
-</p>
-<table>
-<thead>
-<tr>
-<th>Field</th>
-<th>Description</th>
-</tr>
-</thead>
-<tbody>
 <tr>
 <td>
-<code>labels</code></br>
+<code>namespace</code></br>
 <em>
-map[string]string
+string
 </em>
 </td>
 <td>
+<p>The cluster namespace from which to allocate gameservers</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>annotations</code></br>
+<code>serverCa</code></br>
 <em>
-map[string]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="allocation.agones.dev/v1.MultiClusterSetting">MultiClusterSetting
+<h3 id="multicluster.agones.dev/v1.ConnectionInfoIterator">ConnectionInfoIterator
 </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>ConnectionInfoIterator an iterator on ClusterConnectionInfo</p>
 </p>
 <table>
 <thead>
@@ -7369,80 +7675,58 @@ <h3 id="allocation.agones.dev/v1.MultiClusterSetting">MultiClusterSetting
 <tbody>
 <tr>
 <td>
-<code>enabled</code></br>
+<code>currPriority</code></br>
 <em>
-bool
+int
 </em>
 </td>
 <td>
+<p>currPriority Current priority index from the orderedPriorities</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>policySelector</code></br>
+<code>orderedPriorities</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>
+[]int32
 </em>
 </td>
 <td>
+<p>orderedPriorities list of ordered priorities</p>
 </td>
 </tr>
-</tbody>
-</table>
-<h3 id="allocation.agones.dev/v1.PlayerSelector">PlayerSelector
-</h3>
-<p>
-(<em>Appears on:</em>
-<a href="#allocation.agones.dev/v1.GameServerSelector">GameServerSelector</a>)
-</p>
-<p>
-<p>PlayerSelector is the filter options for a GameServer based on player counts</p>
-</p>
-<table>
-<thead>
-<tr>
-<th>Field</th>
-<th>Description</th>
-</tr>
-</thead>
-<tbody>
 <tr>
 <td>
-<code>minAvailable</code></br>
+<code>priorityToCluster</code></br>
 <em>
-int64
+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>
 <tr>
 <td>
-<code>maxAvailable</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="allocation.agones.dev/v1.Priority">Priority
+<h3 id="multicluster.agones.dev/v1.GameServerAllocationPolicySpec">GameServerAllocationPolicySpec
 </h3>
 <p>
 (<em>Appears on:</em>
-<a href="#allocation.agones.dev/v1.GameServerAllocationSpec">GameServerAllocationSpec</a>)
+<a href="#multicluster.agones.dev/v1.GameServerAllocationPolicy">GameServerAllocationPolicy</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>GameServerAllocationPolicySpec defines the desired state of GameServerAllocationPolicy</p>
 </p>
 <table>
 <thead>
@@ -7454,9 +7738,9 @@ <h3 id="allocation.agones.dev/v1.Priority">Priority
 <tbody>
 <tr>
 <td>
-<code>priorityType</code></br>
+<code>priority</code></br>
 <em>
-string
+int32
 </em>
 </td>
 <td>
@@ -7464,9 +7748,9 @@ <h3 id="allocation.agones.dev/v1.Priority">Priority
 </tr>
 <tr>
 <td>
-<code>key</code></br>
+<code>weight</code></br>
 <em>
-string
+int
 </em>
 </td>
 <td>
@@ -7474,9 +7758,11 @@ <h3 id="allocation.agones.dev/v1.Priority">Priority
 </tr>
 <tr>
 <td>
-<code>order</code></br>
+<code>connectionInfo</code></br>
 <em>
-string
+<a href="#multicluster.agones.dev/v1.ClusterConnectionInfo">
+ClusterConnectionInfo
+</a>
 </em>
 </td>
 <td>