diff --git a/go.mod b/go.mod
index 32b90464b0..9143925f2a 100644
--- a/go.mod
+++ b/go.mod
@@ -20,6 +20,7 @@ require (
 	github.com/joonix/log v0.0.0-20180502111528-d2d3f2f4a806
 	github.com/mattbaird/jsonpatch v0.0.0-20171005235357-81af80346b1a
 	github.com/mennanov/fmutils v0.2.0
+	github.com/mitchellh/hashstructure/v2 v2.0.2
 	github.com/munnerz/goautoneg v0.0.0-20191010083416-a7dc8b61c822
 	github.com/pkg/errors v0.9.1
 	github.com/prometheus/client_golang v1.14.0
diff --git a/go.sum b/go.sum
index 91709f832c..3f43b1a96f 100644
--- a/go.sum
+++ b/go.sum
@@ -312,6 +312,8 @@ github.com/mitchellh/cli v1.0.0/go.mod h1:hNIlj7HEI86fIcpObd7a0FcrxTWetlwJDGcceT
 github.com/mitchellh/go-homedir v1.0.0/go.mod h1:SfyaCUpYCn1Vlf4IUYiD9fPX4A5wJrkLzIz1N1q0pr0=
 github.com/mitchellh/go-testing-interface v1.0.0/go.mod h1:kRemZodwjscx+RGhAo8eIhFbs2+BFgRtFPeD/KE+zxI=
 github.com/mitchellh/gox v0.4.0/go.mod h1:Sd9lOJ0+aimLBi73mGofS1ycjY8lL3uZM3JPS42BGNg=
+github.com/mitchellh/hashstructure/v2 v2.0.2 h1:vGKWl0YJqUNxE8d+h8f6NJLcCJrgbhC4NcD46KavDd4=
+github.com/mitchellh/hashstructure/v2 v2.0.2/go.mod h1:MG3aRVU/N29oo/V/IhBX8GR/zz4kQkprJgF2EVszyDE=
 github.com/mitchellh/iochan v1.0.0/go.mod h1:JwYml1nuB7xOzsp52dPpHFffvOCDupsG0QubkSMEySY=
 github.com/mitchellh/mapstructure v0.0.0-20160808181253-ca63d7c062ee/go.mod h1:FVVH3fgwuzCH5S8UJGiWEs2h04kUh9fWfEaFds41c1Y=
 github.com/mitchellh/mapstructure v1.1.2/go.mod h1:FVVH3fgwuzCH5S8UJGiWEs2h04kUh9fWfEaFds41c1Y=
diff --git a/pkg/apis/allocation/v1/gameserverallocation.go b/pkg/apis/allocation/v1/gameserverallocation.go
index 5926e79fd3..e10e0342a0 100644
--- a/pkg/apis/allocation/v1/gameserverallocation.go
+++ b/pkg/apis/allocation/v1/gameserverallocation.go
@@ -21,7 +21,7 @@ import (
 	"agones.dev/agones/pkg/apis"
 	agonesv1 "agones.dev/agones/pkg/apis/agones/v1"
 	"agones.dev/agones/pkg/util/runtime"
-	apimachineryvalidation "k8s.io/apimachinery/pkg/api/validation"
+	hashstructure "github.com/mitchellh/hashstructure/v2"
 	apivalidation "k8s.io/apimachinery/pkg/api/validation"
 	metav1 "k8s.io/apimachinery/pkg/apis/meta/v1"
 	metav1validation "k8s.io/apimachinery/pkg/apis/meta/v1/validation"
@@ -69,12 +69,12 @@ type GameServerAllocationList struct {
 type GameServerAllocationSpec struct {
 	// MultiClusterPolicySelector if specified, multi-cluster policies are applied.
 	// Otherwise, allocation will happen locally.
-	MultiClusterSetting MultiClusterSetting `json:"multiClusterSetting,omitempty"`
+	MultiClusterSetting MultiClusterSetting `json:"multiClusterSetting,omitempty" hash:"ignore"`
 
 	// 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.
-	Required GameServerSelector `json:"required,omitempty"`
+	Required GameServerSelector `json:"required,omitempty" hash:"ignore"`
 
 	// Deprecated: use field Selectors instead. If Selectors is set, this field is ignored.
 	// Preferred is an ordered list of preferred GameServer selectors
@@ -82,12 +82,12 @@ type GameServerAllocationSpec struct {
 	// 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.
-	Preferred []GameServerSelector `json:"preferred,omitempty"`
+	Preferred []GameServerSelector `json:"preferred,omitempty" hash:"ignore"`
 
 	// (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 by
-	// available Capacity in the Selector set and acts as a tie-breaker after sorting the game servers
-	// by State and Strategy. Impacts which GameServer is checked first.
+	// available Capacity in the Selector set. Acts as a tie-breaker after sorting the game servers
+	// by State and Strategy Packed. Impacts which GameServer is checked first.
 	// +optional
 	Priorities []agonesv1.Priority `json:"priorities,omitempty"`
 
@@ -95,20 +95,20 @@ type GameServerAllocationSpec struct {
 	// 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.
-	Selectors []GameServerSelector `json:"selectors,omitempty"`
+	Selectors []GameServerSelector `json:"selectors,omitempty" hash:"ignore"`
 
 	// Scheduling strategy. Defaults to "Packed".
 	Scheduling apis.SchedulingStrategy `json:"scheduling"`
 
 	// 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
-	MetaPatch MetaPatch `json:"metadata,omitempty"`
+	MetaPatch MetaPatch `json:"metadata,omitempty" hash:"ignore"`
 
 	// (Alpha, CountsAndLists feature flag) Counters and Lists provide a set of actions to perform
 	// on Counters and Lists during allocation.
 	// +optional
-	Counters map[string]CounterAction `json:"counters,omitempty"`
-	Lists    map[string]ListAction    `json:"lists,omitempty"`
+	Counters map[string]CounterAction `json:"counters,omitempty" hash:"ignore"`
+	Lists    map[string]ListAction    `json:"lists,omitempty" hash:"ignore"`
 }
 
 // GameServerSelector contains all the filter options for selecting
@@ -378,11 +378,11 @@ func (s *GameServerSelector) Validate(fldPath *field.Path) field.ErrorList {
 
 	if runtime.FeatureEnabled(runtime.FeaturePlayerAllocationFilter) && s.Players != nil {
 		if s.Players.MinAvailable < 0 {
-			allErrs = append(allErrs, field.Invalid(fldPath.Child("players").Child("minAvailable"), s.Players.MinAvailable, apimachineryvalidation.IsNegativeErrorMsg))
+			allErrs = append(allErrs, field.Invalid(fldPath.Child("players").Child("minAvailable"), s.Players.MinAvailable, apivalidation.IsNegativeErrorMsg))
 		}
 
 		if s.Players.MaxAvailable < 0 {
-			allErrs = append(allErrs, field.Invalid(fldPath.Child("players").Child("maxAvailable"), s.Players.MaxAvailable, apimachineryvalidation.IsNegativeErrorMsg))
+			allErrs = append(allErrs, field.Invalid(fldPath.Child("players").Child("maxAvailable"), s.Players.MaxAvailable, apivalidation.IsNegativeErrorMsg))
 		}
 
 		if s.Players.MinAvailable > s.Players.MaxAvailable {
@@ -415,19 +415,19 @@ func validateCounters(counters map[string]CounterSelector, fldPath *field.Path)
 	for key, counterSelector := range counters {
 		keyPath := fldPath.Key(key)
 		if counterSelector.MinCount < 0 {
-			allErrs = append(allErrs, field.Invalid(keyPath.Child("minCount"), counterSelector.MinCount, apimachineryvalidation.IsNegativeErrorMsg))
+			allErrs = append(allErrs, field.Invalid(keyPath.Child("minCount"), counterSelector.MinCount, apivalidation.IsNegativeErrorMsg))
 		}
 		if counterSelector.MaxCount < 0 {
-			allErrs = append(allErrs, field.Invalid(keyPath.Child("maxCount"), counterSelector.MaxCount, apimachineryvalidation.IsNegativeErrorMsg))
+			allErrs = append(allErrs, field.Invalid(keyPath.Child("maxCount"), counterSelector.MaxCount, apivalidation.IsNegativeErrorMsg))
 		}
 		if (counterSelector.MaxCount < counterSelector.MinCount) && (counterSelector.MaxCount != 0) {
 			allErrs = append(allErrs, field.Invalid(keyPath, counterSelector.MaxCount, fmt.Sprintf("maxCount must zero or greater than minCount %d", counterSelector.MinCount)))
 		}
 		if counterSelector.MinAvailable < 0 {
-			allErrs = append(allErrs, field.Invalid(keyPath.Child("minAvailable"), counterSelector.MinAvailable, apimachineryvalidation.IsNegativeErrorMsg))
+			allErrs = append(allErrs, field.Invalid(keyPath.Child("minAvailable"), counterSelector.MinAvailable, apivalidation.IsNegativeErrorMsg))
 		}
 		if counterSelector.MaxAvailable < 0 {
-			allErrs = append(allErrs, field.Invalid(keyPath.Child("maxAvailable"), counterSelector.MaxAvailable, apimachineryvalidation.IsNegativeErrorMsg))
+			allErrs = append(allErrs, field.Invalid(keyPath.Child("maxAvailable"), counterSelector.MaxAvailable, apivalidation.IsNegativeErrorMsg))
 		}
 		if (counterSelector.MaxAvailable < counterSelector.MinAvailable) && (counterSelector.MaxAvailable != 0) {
 			allErrs = append(allErrs, field.Invalid(keyPath, counterSelector.MaxAvailable, fmt.Sprintf("maxAvailable must zero or greater than minAvailable %d", counterSelector.MinAvailable)))
@@ -443,10 +443,10 @@ func validateLists(lists map[string]ListSelector, fldPath *field.Path) field.Err
 	for key, listSelector := range lists {
 		keyPath := fldPath.Key(key)
 		if listSelector.MinAvailable < 0 {
-			allErrs = append(allErrs, field.Invalid(keyPath.Child("minAvailable"), listSelector.MinAvailable, apimachineryvalidation.IsNegativeErrorMsg))
+			allErrs = append(allErrs, field.Invalid(keyPath.Child("minAvailable"), listSelector.MinAvailable, apivalidation.IsNegativeErrorMsg))
 		}
 		if listSelector.MaxAvailable < 0 {
-			allErrs = append(allErrs, field.Invalid(keyPath.Child("maxAvailable"), listSelector.MaxAvailable, apimachineryvalidation.IsNegativeErrorMsg))
+			allErrs = append(allErrs, field.Invalid(keyPath.Child("maxAvailable"), listSelector.MaxAvailable, apivalidation.IsNegativeErrorMsg))
 		}
 		if (listSelector.MaxAvailable < listSelector.MinAvailable) && (listSelector.MaxAvailable != 0) {
 			allErrs = append(allErrs, field.Invalid(keyPath, listSelector.MaxAvailable, fmt.Sprintf("maxAvailable must zero or greater than minAvailable %d", listSelector.MinAvailable)))
@@ -549,3 +549,15 @@ func (gsa *GameServerAllocation) Converter() {
 		gsa.Spec.Selectors = selectors
 	}
 }
+
+// SortKey generates and returns the hash of the GameServerAllocationSpec []Priority and Scheduling.
+// Note: The hash:"ignore" in GameServerAllocationSpec means that these fields will not be considered
+// in hashing. The hash is used for determining when GameServerAllocations have equal or different
+// []Priority and Scheduling.
+func (gsa *GameServerAllocation) SortKey() (uint64, error) {
+	hash, err := hashstructure.Hash(gsa.Spec, hashstructure.FormatV2, nil)
+	if err != nil {
+		return 0, err
+	}
+	return hash, nil
+}
diff --git a/pkg/apis/allocation/v1/gameserverallocation_test.go b/pkg/apis/allocation/v1/gameserverallocation_test.go
index 9a26274e45..e8899b34e3 100644
--- a/pkg/apis/allocation/v1/gameserverallocation_test.go
+++ b/pkg/apis/allocation/v1/gameserverallocation_test.go
@@ -1132,3 +1132,117 @@ func TestGameServerAllocationConverter(t *testing.T) {
 	gsa.Converter()
 	assert.Equal(t, gsaExpected, gsa)
 }
+
+func TestSortKey(t *testing.T) {
+	t.Parallel()
+
+	runtime.FeatureTestMutex.Lock()
+	defer runtime.FeatureTestMutex.Unlock()
+	assert.NoError(t, runtime.ParseFeatures(fmt.Sprintf("%s=true", runtime.FeatureCountsAndLists)))
+
+	gameServerAllocation1 := &GameServerAllocation{
+		Spec: GameServerAllocationSpec{
+			Scheduling: "Packed",
+			Priorities: []agonesv1.Priority{
+				{
+					Type:  "List",
+					Key:   "foo",
+					Order: "Descending",
+				},
+			},
+		},
+	}
+
+	gameServerAllocation2 := &GameServerAllocation{
+		Spec: GameServerAllocationSpec{
+			Selectors: []GameServerSelector{
+				{LabelSelector: metav1.LabelSelector{MatchLabels: map[string]string{"foo": "bar"}}},
+			},
+			Scheduling: "Packed",
+			Priorities: []agonesv1.Priority{
+				{
+					Type:  "List",
+					Key:   "foo",
+					Order: "Descending",
+				},
+			},
+		},
+	}
+
+	gameServerAllocation3 := &GameServerAllocation{
+		Spec: GameServerAllocationSpec{
+			Scheduling: "Packed",
+			Priorities: []agonesv1.Priority{
+				{
+					Type:  "Counter",
+					Key:   "foo",
+					Order: "Descending",
+				},
+			},
+		},
+	}
+
+	gameServerAllocation4 := &GameServerAllocation{
+		Spec: GameServerAllocationSpec{
+			Scheduling: "Distributed",
+			Priorities: []agonesv1.Priority{
+				{
+					Type:  "List",
+					Key:   "foo",
+					Order: "Descending",
+				},
+			},
+		},
+	}
+
+	gameServerAllocation5 := &GameServerAllocation{}
+
+	gameServerAllocation6 := &GameServerAllocation{
+		Spec: GameServerAllocationSpec{
+			Priorities: []agonesv1.Priority{},
+		},
+	}
+
+	testScenarios := map[string]struct {
+		gsa1      *GameServerAllocation
+		gsa2      *GameServerAllocation
+		wantEqual bool
+	}{
+		"equivalent GameServerAllocation": {
+			gsa1:      gameServerAllocation1,
+			gsa2:      gameServerAllocation2,
+			wantEqual: true,
+		},
+		"different Scheduling GameServerAllocation": {
+			gsa1:      gameServerAllocation1,
+			gsa2:      gameServerAllocation4,
+			wantEqual: false,
+		},
+		"equivalent empty GameServerAllocation": {
+			gsa1:      gameServerAllocation5,
+			gsa2:      gameServerAllocation6,
+			wantEqual: true,
+		},
+		"different Priorities GameServerAllocation": {
+			gsa1:      gameServerAllocation1,
+			gsa2:      gameServerAllocation3,
+			wantEqual: false,
+		},
+	}
+
+	for test, testScenario := range testScenarios {
+		t.Run(test, func(t *testing.T) {
+			key1, err := testScenario.gsa1.SortKey()
+			assert.NoError(t, err)
+			key2, err := testScenario.gsa2.SortKey()
+			assert.NoError(t, err)
+
+			if testScenario.wantEqual {
+				assert.Equal(t, key1, key2)
+			} else {
+				assert.NotEqual(t, key1, key2)
+			}
+		})
+	}
+
+}
diff --git a/pkg/gameserverallocations/allocation_cache.go b/pkg/gameserverallocations/allocation_cache.go
index 7d9b45669a..73bb692c84 100644
--- a/pkg/gameserverallocations/allocation_cache.go
+++ b/pkg/gameserverallocations/allocation_cache.go
@@ -262,7 +262,8 @@ func (c *AllocationCache) ListSortedGameServers(gsa *allocationv1.GameServerAllo
 	return list
 }
 
-// compareGameServers compares two game servers based on a CountsAndLists Priority
+// compareGameServers compares two game servers based on a CountsAndLists Priority using available
+// capacity (Capacity - Count for Counters, and Capacity - len(Values) for Lists) as the comparison.
 // Returns -1 if gs1 < gs2; 1 if gs1 > gs2; 0 if gs1 == gs2; 0 if neither gamer server has the Priority.
 // If only one game server has the Priority, prefer that server. I.e. nil < gsX when Priority
 // Order is Descending (3, 2, 1, 0, nil), and nil > gsX when Order is Ascending (0, 1, 2, 3, nil).
@@ -275,13 +276,15 @@ func compareGameServers(p *agonesv1.Priority, gs1, gs2 *agonesv1.GameServer) int
 		counter2, ok2 := gs2.Status.Counters[p.Key]
 		// If both game servers have the Counter
 		if ok1 && ok2 {
-			if counter1.Count < counter2.Count {
+			availCapacity1 := counter1.Capacity - counter1.Count
+			availCapacity2 := counter2.Capacity - counter2.Count
+			if availCapacity1 < availCapacity2 {
 				return -1
 			}
-			if counter1.Count > counter2.Count {
+			if availCapacity1 > availCapacity2 {
 				return 1
 			}
-			if counter1.Count == counter2.Count {
+			if availCapacity1 == availCapacity2 {
 				return 0
 			}
 		}
@@ -293,13 +296,15 @@ func compareGameServers(p *agonesv1.Priority, gs1, gs2 *agonesv1.GameServer) int
 		list2, ok2 := gs2.Status.Lists[p.Key]
 		// If both game servers have the List
 		if ok1 && ok2 {
-			if len(list1.Values) < len(list2.Values) {
+			availCapacity1 := list1.Capacity - int64(len(list1.Values))
+			availCapacity2 := list2.Capacity - int64(len(list2.Values))
+			if availCapacity1 < availCapacity2 {
 				return -1
 			}
-			if len(list1.Values) > len(list2.Values) {
+			if availCapacity1 > availCapacity2 {
 				return 1
 			}
-			if len(list1.Values) == len(list2.Values) {
+			if availCapacity1 == availCapacity2 {
 				return 0
 			}
 		}
@@ -309,13 +314,11 @@ func compareGameServers(p *agonesv1.Priority, gs1, gs2 *agonesv1.GameServer) int
 	// If only one game server has the Priority, prefer that server. I.e. nil < gsX when Order is
 	// Descending (3, 2, 1, 0, nil), and nil > gsX when Order is Ascending (0, 1, 2, 3, nil).
 	if (gs1ok && p.Order == agonesv1.GameServerPriorityDescending) ||
-		(gs1ok && p.Order == "") ||
 		(gs2ok && p.Order == agonesv1.GameServerPriorityAscending) {
 		return 1
 	}
 	if (gs1ok && p.Order == agonesv1.GameServerPriorityAscending) ||
-		(gs2ok && p.Order == agonesv1.GameServerPriorityDescending) ||
-		(gs2ok && p.Order == "") {
+		(gs2ok && p.Order == agonesv1.GameServerPriorityDescending) {
 		return -1
 	}
 	// If neither game server has the Priority
diff --git a/pkg/gameserverallocations/allocation_cache_test.go b/pkg/gameserverallocations/allocation_cache_test.go
index 733dd55d7e..a6071f57a4 100644
--- a/pkg/gameserverallocations/allocation_cache_test.go
+++ b/pkg/gameserverallocations/allocation_cache_test.go
@@ -57,7 +57,7 @@ func TestAllocationCacheListSortedGameServers(t *testing.T) {
 			Counters: map[string]agonesv1.CounterStatus{
 				"players": {
 					Count:    4,
-					Capacity: 40,
+					Capacity: 40, // Available Capacity == 36
 				},
 			}},
 	}
@@ -69,7 +69,7 @@ func TestAllocationCacheListSortedGameServers(t *testing.T) {
 			Counters: map[string]agonesv1.CounterStatus{
 				"players": {
 					Count:    14,
-					Capacity: 40,
+					Capacity: 40, // Available Capacity == 26
 				},
 			}},
 	}
@@ -154,7 +154,7 @@ func TestAllocationCacheListSortedGameServers(t *testing.T) {
 			},
 			test: func(t *testing.T, list []*agonesv1.GameServer) {
 				assert.Len(t, list, 6)
-				if !assert.Equal(t, []*agonesv1.GameServer{&gs3, &gs6, &gs5, &gs1, &gs2, &gs4}, list) {
+				if !assert.Equal(t, []*agonesv1.GameServer{&gs3, &gs5, &gs6, &gs1, &gs2, &gs4}, list) {
 					for _, gs := range list {
 						logrus.WithField("game", gs.Name).Info("game server")
 					}
@@ -177,7 +177,7 @@ func TestAllocationCacheListSortedGameServers(t *testing.T) {
 			},
 			test: func(t *testing.T, list []*agonesv1.GameServer) {
 				assert.Len(t, list, 6)
-				if !assert.Equal(t, []*agonesv1.GameServer{&gs3, &gs5, &gs6, &gs1, &gs2, &gs4}, list) {
+				if !assert.Equal(t, []*agonesv1.GameServer{&gs3, &gs6, &gs5, &gs1, &gs2, &gs4}, list) {
 					for _, gs := range list {
 						logrus.WithField("game", gs.Name).Info("game server")
 					}
@@ -232,24 +232,24 @@ func TestAllocationCacheCompareGameServers(t *testing.T) {
 			Lists: map[string]agonesv1.ListStatus{
 				"players": {
 					Values:   []string{"player1"},
-					Capacity: 100,
+					Capacity: 100, // Available Capacity == 99
 				},
 				"layers": {
 					Values:   []string{"layer1", "layer2", "layer3"},
-					Capacity: 100,
+					Capacity: 100, // Available Capacity == 97
 				}}}}
 	gs2 := agonesv1.GameServer{ObjectMeta: metav1.ObjectMeta{Name: "gs2", Namespace: defaultNs, UID: "2"},
 		Status: agonesv1.GameServerStatus{NodeName: "node1", State: agonesv1.GameServerStateReady,
 			Lists: map[string]agonesv1.ListStatus{
 				"players": {
 					Values:   []string{},
-					Capacity: 100,
+					Capacity: 100, // Available Capacity == 100
 				},
 			},
 			Counters: map[string]agonesv1.CounterStatus{
 				"assets": {
 					Count:    101,
-					Capacity: 1000,
+					Capacity: 1000, // Available Capacity = 899
 				},
 			}}}
 	gs3 := agonesv1.GameServer{ObjectMeta: metav1.ObjectMeta{Name: "gs3", Namespace: defaultNs, UID: "3"},
@@ -257,16 +257,16 @@ func TestAllocationCacheCompareGameServers(t *testing.T) {
 			Lists: map[string]agonesv1.ListStatus{
 				"players": {
 					Values:   []string{"player2", "player3"},
-					Capacity: 100,
+					Capacity: 100, // Available Capacity == 98
 				}},
 			Counters: map[string]agonesv1.CounterStatus{
 				"sessions": {
 					Count:    9,
-					Capacity: 1000,
+					Capacity: 1000, // Available Capacity == 991
 				},
 				"assets": {
 					Count:    100,
-					Capacity: 1000,
+					Capacity: 1000, // Available Capacity == 900
 				},
 			}}}
 	gs4 := agonesv1.GameServer{ObjectMeta: metav1.ObjectMeta{Name: "gs4", Namespace: defaultNs, UID: "4"},
@@ -274,41 +274,41 @@ func TestAllocationCacheCompareGameServers(t *testing.T) {
 			Counters: map[string]agonesv1.CounterStatus{
 				"sessions": {
 					Count:    99,
-					Capacity: 1000,
+					Capacity: 1000, // Available Capacity == 901
 				},
 			},
 			Lists: map[string]agonesv1.ListStatus{
 				"players": {
 					Values:   []string{"player4"},
-					Capacity: 100,
+					Capacity: 100, // Available Capacity == 99
 				},
 				"layers": {
 					Values:   []string{"layer4, layer5"},
-					Capacity: 100,
+					Capacity: 100, // Available Capacity == 98
 				}}}}
 	gs5 := agonesv1.GameServer{ObjectMeta: metav1.ObjectMeta{Name: "gs5", Namespace: defaultNs, UID: "5"},
 		Status: agonesv1.GameServerStatus{NodeName: "node1", State: agonesv1.GameServerStateReady,
 			Counters: map[string]agonesv1.CounterStatus{
 				"sessions": {
 					Count:    9,
-					Capacity: 1000,
+					Capacity: 1000, // Available Capacity == 991
 				},
 				"assets": {
 					Count:    99,
-					Capacity: 1000,
+					Capacity: 1000, // Available Capacity == 901
 				},
 			},
 			Lists: map[string]agonesv1.ListStatus{
 				"layers": {
 					Values:   []string{},
-					Capacity: 100,
+					Capacity: 100, // Available Capacity == 100
 				}}}}
 	gs6 := agonesv1.GameServer{ObjectMeta: metav1.ObjectMeta{Name: "gs6", Namespace: defaultNs, UID: "6"},
 		Status: agonesv1.GameServerStatus{NodeName: "node1", State: agonesv1.GameServerStateReady,
 			Counters: map[string]agonesv1.CounterStatus{
 				"sessions": {
 					Count:    999,
-					Capacity: 1000,
+					Capacity: 1000, // Available Capacity == 1
 				},
 			}}}
 
@@ -330,7 +330,7 @@ func TestAllocationCacheCompareGameServers(t *testing.T) {
 					},
 				},
 			},
-			want: []*agonesv1.GameServer{&gs5, &gs4, &gs6},
+			want: []*agonesv1.GameServer{&gs6, &gs4, &gs5},
 		},
 		"Sort by one Priority Counter Descending": {
 			list: []agonesv1.GameServer{gs4, gs5, gs6},
@@ -345,7 +345,7 @@ func TestAllocationCacheCompareGameServers(t *testing.T) {
 					},
 				},
 			},
-			want: []*agonesv1.GameServer{&gs6, &gs4, &gs5},
+			want: []*agonesv1.GameServer{&gs5, &gs4, &gs6},
 		},
 		"Sort by two Priority Counter Ascending and Ascending": {
 			list: []agonesv1.GameServer{gs3, gs5, gs6, gs4, gs1, gs2},
@@ -365,7 +365,7 @@ func TestAllocationCacheCompareGameServers(t *testing.T) {
 					},
 				},
 			},
-			want: []*agonesv1.GameServer{&gs5, &gs3, &gs4, &gs6, &gs2, &gs1},
+			want: []*agonesv1.GameServer{&gs6, &gs4, &gs3, &gs5, &gs2, &gs1},
 		},
 		"Sort by two Priority Counter Ascending and Descending": {
 			list: []agonesv1.GameServer{gs3, gs5, gs6, gs4, gs1, gs2},
@@ -385,7 +385,7 @@ func TestAllocationCacheCompareGameServers(t *testing.T) {
 					},
 				},
 			},
-			want: []*agonesv1.GameServer{&gs3, &gs5, &gs4, &gs6, &gs2, &gs1},
+			want: []*agonesv1.GameServer{&gs6, &gs4, &gs5, &gs3, &gs2, &gs1},
 		},
 		"Sort by one Priority Counter game server without Counter": {
 			list: []agonesv1.GameServer{gs1, gs5, gs6, gs4},
@@ -400,7 +400,7 @@ func TestAllocationCacheCompareGameServers(t *testing.T) {
 					},
 				},
 			},
-			want: []*agonesv1.GameServer{&gs5, &gs4, &gs6, &gs1},
+			want: []*agonesv1.GameServer{&gs6, &gs4, &gs5, &gs1},
 		},
 		"Sort by one Priority List Ascending": {
 			list: []agonesv1.GameServer{gs3, gs2, gs1},
@@ -415,7 +415,7 @@ func TestAllocationCacheCompareGameServers(t *testing.T) {
 					},
 				},
 			},
-			want: []*agonesv1.GameServer{&gs2, &gs1, &gs3},
+			want: []*agonesv1.GameServer{&gs3, &gs1, &gs2},
 		},
 		"Sort by one Priority List Descending": {
 			list: []agonesv1.GameServer{gs3, gs2, gs1},
@@ -430,7 +430,7 @@ func TestAllocationCacheCompareGameServers(t *testing.T) {
 					},
 				},
 			},
-			want: []*agonesv1.GameServer{&gs3, &gs1, &gs2},
+			want: []*agonesv1.GameServer{&gs2, &gs1, &gs3},
 		},
 		"Sort by two Priority List Descending and Ascending": {
 			list: []agonesv1.GameServer{gs1, gs2, gs3, gs4},
@@ -450,7 +450,7 @@ func TestAllocationCacheCompareGameServers(t *testing.T) {
 					},
 				},
 			},
-			want: []*agonesv1.GameServer{&gs3, &gs4, &gs1, &gs2},
+			want: []*agonesv1.GameServer{&gs2, &gs1, &gs4, &gs3},
 		},
 		"Sort by two Priority List Descending and Descending": {
 			list: []agonesv1.GameServer{gs6, gs5, gs4, gs3, gs2, gs1},
@@ -470,7 +470,7 @@ func TestAllocationCacheCompareGameServers(t *testing.T) {
 					},
 				},
 			},
-			want: []*agonesv1.GameServer{&gs3, &gs1, &gs4, &gs2, &gs5, &gs6},
+			want: []*agonesv1.GameServer{&gs2, &gs4, &gs1, &gs3, &gs5, &gs6},
 		},
 	}
 
diff --git a/pkg/gameserverallocations/allocator.go b/pkg/gameserverallocations/allocator.go
index 5d85305e78..67db3bdb69 100644
--- a/pkg/gameserverallocations/allocator.go
+++ b/pkg/gameserverallocations/allocator.go
@@ -496,18 +496,40 @@ func (c *Allocator) ListenAndAllocate(ctx context.Context, updateWorkerCount int
 	// continued.
 
 	var list []*agonesv1.GameServer
+	var sortKey uint64
 	requestCount := 0
 
 	for {
 		select {
 		case req := <-c.pendingRequests:
 			// refresh the list after every 100 allocations made in a single batch
-			requestCount++
 			if requestCount >= maxBatchBeforeRefresh {
 				list = nil
 				requestCount = 0
 			}
 
+			if runtime.FeatureEnabled(runtime.FeatureCountsAndLists) {
+				// SortKey returns the sorting values (list of Priorities) as a determinstic key.
+				// In case gsa.Spec.Priorities is nil this will still return a sortKey.
+				// In case of error this will return 0 for the sortKey.
+				newSortKey, err := req.gsa.SortKey()
+				if err != nil {
+					c.baseLogger.WithError(err).Warn("error getting sortKey for GameServerAllocationSpec", err)
+				}
+				// Set sortKey if this is the first request, or the previous request errored on creating a sortKey.
+				if sortKey == uint64(0) {
+					sortKey = newSortKey
+				}
+
+				if newSortKey != sortKey {
+					sortKey = newSortKey
+					list = nil
+					requestCount = 0
+				}
+			}
+
+			requestCount++
+
 			if list == nil {
 				list = c.allocationCache.ListSortedGameServers(req.gsa)
 			}
diff --git a/pkg/gameserverallocations/allocator_test.go b/pkg/gameserverallocations/allocator_test.go
index 83d0b806b3..19b922ad7f 100644
--- a/pkg/gameserverallocations/allocator_test.go
+++ b/pkg/gameserverallocations/allocator_test.go
@@ -280,6 +280,7 @@ func TestAllocatorApplyAllocationToGameServer(t *testing.T) {
 
 func TestAllocatorApplyAllocationToGameServerCountsListsActions(t *testing.T) {
 	t.Parallel()
+
 	m := agtesting.NewMocks()
 	ctx := context.Background()
 	mp := allocationv1.MetaPatch{}
@@ -618,6 +619,117 @@ func TestAllocatorRunLocalAllocations(t *testing.T) {
 	})
 }
 
+func TestAllocatorRunLocalAllocationsCountsAndLists(t *testing.T) {
+	t.Parallel()
+
+	runtime.FeatureTestMutex.Lock()
+	defer runtime.FeatureTestMutex.Unlock()
+	assert.NoError(t, runtime.ParseFeatures(string(runtime.FeatureCountsAndLists)+"=true"))
+
+	a, m := newFakeAllocator()
+
+	gs1 := agonesv1.GameServer{ObjectMeta: metav1.ObjectMeta{Name: "gs1", Namespace: defaultNs, UID: "1"},
+		Status: agonesv1.GameServerStatus{NodeName: "node1", State: agonesv1.GameServerStateReady,
+			Counters: map[string]agonesv1.CounterStatus{
+				"foo": { // Available Capacity == 1000
+					Count:    0,
+					Capacity: 1000,
+				}}}}
+	gs2 := agonesv1.GameServer{ObjectMeta: metav1.ObjectMeta{Name: "gs2", Namespace: defaultNs, UID: "2"},
+		Status: agonesv1.GameServerStatus{NodeName: "node1", State: agonesv1.GameServerStateReady,
+			Counters: map[string]agonesv1.CounterStatus{
+				"foo": { // Available Capacity == 900
+					Count:    100,
+					Capacity: 1000,
+				}}}}
+	gs3 := agonesv1.GameServer{ObjectMeta: metav1.ObjectMeta{Name: "gs3", Namespace: defaultNs, UID: "3"},
+		Status: agonesv1.GameServerStatus{NodeName: "node1", State: agonesv1.GameServerStateReady,
+			Counters: map[string]agonesv1.CounterStatus{
+				"foo": { // Available Capacity == 1
+					Count:    999,
+					Capacity: 1000,
+				}}}}
+
+	gsList := []agonesv1.GameServer{gs1, gs2, gs3}
+
+	m.AgonesClient.AddReactor("list", "gameservers", func(action k8stesting.Action) (bool, k8sruntime.Object, error) {
+		return true, &agonesv1.GameServerList{Items: gsList}, nil
+	})
+
+	m.AgonesClient.AddReactor("update", "gameservers", func(action k8stesting.Action) (bool, k8sruntime.Object, error) {
+		uo := action.(k8stesting.UpdateAction)
+		gs := uo.GetObject().(*agonesv1.GameServer)
+		return true, gs, nil
+	})
+
+	ctx, cancel := agtesting.StartInformers(m, a.allocationCache.gameServerSynced)
+	defer cancel()
+
+	// This call initializes the cache
+	err := a.allocationCache.syncCache()
+	assert.Nil(t, err)
+
+	err = a.allocationCache.counter.Run(ctx, 0)
+	assert.Nil(t, err)
+
+	READY := agonesv1.GameServerStateReady
+
+	gsa1 := &allocationv1.GameServerAllocation{
+		ObjectMeta: metav1.ObjectMeta{Namespace: defaultNs},
+		Spec: allocationv1.GameServerAllocationSpec{
+			Scheduling: apis.Packed,
+			Selectors: []allocationv1.GameServerSelector{{
+				GameServerState: &READY,
+			}},
+			Priorities: []agonesv1.Priority{
+				{Type: agonesv1.GameServerPriorityCounter,
+					Key:   "foo",
+					Order: agonesv1.GameServerPriorityAscending},
+			},
+		}}
+	gsa2 := &allocationv1.GameServerAllocation{
+		ObjectMeta: metav1.ObjectMeta{Namespace: defaultNs},
+		Spec: allocationv1.GameServerAllocationSpec{
+			Scheduling: apis.Packed,
+			Selectors: []allocationv1.GameServerSelector{{
+				GameServerState: &READY,
+			}},
+			Priorities: []agonesv1.Priority{
+				{Type: agonesv1.GameServerPriorityCounter,
+					Key:   "foo",
+					Order: agonesv1.GameServerPriorityDescending},
+			},
+		}}
+
+	// line up 3 in a batch (first sort by Ascending then Descending then Ascending)
+	j1 := request{gsa: gsa1.DeepCopy(), response: make(chan response)}
+	a.pendingRequests <- j1
+	j2 := request{gsa: gsa2.DeepCopy(), response: make(chan response)}
+	a.pendingRequests <- j2
+	j3 := request{gsa: gsa1.DeepCopy(), response: make(chan response)}
+	a.pendingRequests <- j3
+
+	go a.ListenAndAllocate(ctx, 3)
+
+	res1 := <-j1.response
+	assert.NoError(t, res1.err)
+	assert.NotNil(t, res1.gs)
+	assert.Equal(t, agonesv1.GameServerStateAllocated, res1.gs.Status.State)
+	assert.Equal(t, gs3.ObjectMeta.Name, res1.gs.ObjectMeta.Name)
+
+	res2 := <-j2.response
+	assert.NoError(t, res2.err)
+	assert.NotNil(t, res2.gs)
+	assert.Equal(t, agonesv1.GameServerStateAllocated, res2.gs.Status.State)
+	assert.Equal(t, gs1.ObjectMeta.Name, res2.gs.ObjectMeta.Name)
+
+	res3 := <-j3.response
+	assert.NoError(t, res3.err)
+	assert.NotNil(t, res3.gs)
+	assert.Equal(t, agonesv1.GameServerStateAllocated, res3.gs.Status.State)
+	assert.Equal(t, gs2.ObjectMeta.Name, res3.gs.ObjectMeta.Name)
+}
+
 func TestControllerAllocationUpdateWorkers(t *testing.T) {
 	t.Run("no error", func(t *testing.T) {
 		a, m := newFakeAllocator()
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 6702dae8d3..8d96bac63f 100644
--- a/site/content/en/docs/Reference/agones_crd_api_reference.html
+++ b/site/content/en/docs/Reference/agones_crd_api_reference.html
@@ -4180,30 +4180,34 @@ <h3 id="multicluster.agones.dev/v1.GameServerAllocationPolicySpec">GameServerAll
 <p>Packages:</p>
 <ul>
 <li>
-<a href="#autoscaling.agones.dev%2fv1">autoscaling.agones.dev/v1</a>
+<a href="#agones.dev%2fv1">agones.dev/v1</a>
 </li>
 <li>
-<a href="#multicluster.agones.dev%2fv1">multicluster.agones.dev/v1</a>
+<a href="#allocation.agones.dev%2fv1">allocation.agones.dev/v1</a>
 </li>
 <li>
-<a href="#agones.dev%2fv1">agones.dev/v1</a>
+<a href="#autoscaling.agones.dev%2fv1">autoscaling.agones.dev/v1</a>
 </li>
 <li>
-<a href="#allocation.agones.dev%2fv1">allocation.agones.dev/v1</a>
+<a href="#multicluster.agones.dev%2fv1">multicluster.agones.dev/v1</a>
 </li>
 </ul>
-<h2 id="autoscaling.agones.dev/v1">autoscaling.agones.dev/v1</h2>
+<h2 id="agones.dev/v1">agones.dev/v1</h2>
 <p>
 <p>Package v1 is the v1 version of the API.</p>
 </p>
 Resource Types:
 <ul><li>
-<a href="#autoscaling.agones.dev/v1.FleetAutoscaler">FleetAutoscaler</a>
+<a href="#agones.dev/v1.Fleet">Fleet</a>
+</li><li>
+<a href="#agones.dev/v1.GameServer">GameServer</a>
+</li><li>
+<a href="#agones.dev/v1.GameServerSet">GameServerSet</a>
 </li></ul>
-<h3 id="autoscaling.agones.dev/v1.FleetAutoscaler">FleetAutoscaler
+<h3 id="agones.dev/v1.Fleet">Fleet
 </h3>
 <p>
-<p>FleetAutoscaler is the data structure for a FleetAutoscaler resource</p>
+<p>Fleet is the data structure for a Fleet resource</p>
 </p>
 <table>
 <thead>
@@ -4219,7 +4223,7 @@ <h3 id="autoscaling.agones.dev/v1.FleetAutoscaler">FleetAutoscaler
 string</td>
 <td>
 <code>
-autoscaling.agones.dev/v1
+agones.dev/v1
 </code>
 </td>
 </tr>
@@ -4228,7 +4232,7 @@ <h3 id="autoscaling.agones.dev/v1.FleetAutoscaler">FleetAutoscaler
 <code>kind</code></br>
 string
 </td>
-<td><code>FleetAutoscaler</code></td>
+<td><code>Fleet</code></td>
 </tr>
 <tr>
 <td>
@@ -4248,8 +4252,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="#agones.dev/v1.FleetSpec">
+FleetSpec
 </a>
 </em>
 </td>
@@ -4259,130 +4263,111 @@ <h3 id="autoscaling.agones.dev/v1.FleetAutoscaler">FleetAutoscaler
 <table>
 <tr>
 <td>
-<code>fleetName</code></br>
+<code>replicas</code></br>
 <em>
-string
+int32
 </em>
 </td>
 <td>
+<p>Replicas are the number of GameServers that should be in this set. Defaults to 0.</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>policy</code></br>
+<code>allocationOverflow</code></br>
 <em>
-<a href="#autoscaling.agones.dev/v1.FleetAutoscalerPolicy">
-FleetAutoscalerPolicy
+<a href="#agones.dev/v1.AllocationOverflow">
+AllocationOverflow
 </a>
 </em>
 </td>
 <td>
-<p>Autoscaling policy</p>
+<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>
 </td>
 </tr>
 <tr>
 <td>
-<code>sync</code></br>
+<code>strategy</code></br>
 <em>
-<a href="#autoscaling.agones.dev/v1.FleetAutoscalerSync">
-FleetAutoscalerSync
+<a href="https://v1-26.docs.kubernetes.io/docs/reference/generated/kubernetes-api/v1.26/#deploymentstrategy-v1-apps">
+Kubernetes apps/v1.DeploymentStrategy
 </a>
 </em>
 </td>
 <td>
-<em>(Optional)</em>
-<p>Sync defines when FleetAutoscalers runs autoscaling</p>
-</td>
-</tr>
-</table>
+<p>Deployment strategy</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>status</code></br>
+<code>scheduling</code></br>
 <em>
-<a href="#autoscaling.agones.dev/v1.FleetAutoscalerStatus">
-FleetAutoscalerStatus
-</a>
+agones.dev/agones/pkg/apis.SchedulingStrategy
 </em>
 </td>
 <td>
+<p>Scheduling strategy. Defaults to &ldquo;Packed&rdquo;.</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>maxReplicas</code></br>
+<code>priorities</code></br>
 <em>
-int32
+<a href="#agones.dev/v1.Priority">
+[]Priority
+</a>
 </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>
+<em>(Optional)</em>
+<p>(Alpha, CountsAndLists feature flag) The first Priority on the array of Priorities is the most
+important for sorting. The Fleetautoscaler will use the first priority for sorting GameServers
+by total Capacity in the Fleet and acts as a tie-breaker after sorting the game servers by
+State and Strategy. Impacts scale down logic.</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>minReplicas</code></br>
+<code>template</code></br>
 <em>
-int32
+<a href="#agones.dev/v1.GameServerTemplateSpec">
+GameServerTemplateSpec
+</a>
 </em>
 </td>
 <td>
-<p>MinReplicas is the minimum amount of replicas that the fleet must have
-If zero, it is ignored.
-If non zero, it must be smaller than MaxReplicas and bigger than BufferSize</p>
+<p>Template the GameServer template to apply for this Fleet</p>
+</td>
+</tr>
+</table>
 </td>
 </tr>
 <tr>
 <td>
-<code>bufferSize</code></br>
+<code>status</code></br>
 <em>
-k8s.io/apimachinery/pkg/util/intstr.IntOrString
+<a href="#agones.dev/v1.FleetStatus">
+FleetStatus
+</a>
 </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.CounterPolicy">CounterPolicy
+<h3 id="agones.dev/v1.GameServer">GameServer
 </h3>
 <p>
-(<em>Appears on:</em>
-<a href="#autoscaling.agones.dev/v1.FleetAutoscalerPolicy">FleetAutoscalerPolicy</a>)
-</p>
-<p>
-<p>CounterPolicy controls the desired behavior of the Counter autoscaler policy.</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>
@@ -4394,239 +4379,186 @@ <h3 id="autoscaling.agones.dev/v1.CounterPolicy">CounterPolicy
 <tbody>
 <tr>
 <td>
-<code>key</code></br>
-<em>
-string
-</em>
-</td>
+<code>apiVersion</code></br>
+string</td>
 <td>
-<p>Key is the name of the Counter. Required field.</p>
+<code>
+agones.dev/v1
+</code>
 </td>
 </tr>
 <tr>
 <td>
-<code>maxCapacity</code></br>
-<em>
-int64
-</em>
-</td>
-<td>
-<p>MaxCapacity is the maximum aggregate Counter total capacity across the fleet.
-MaxCapacity must be bigger than both MinCapacity and BufferSize. Required field.</p>
+<code>kind</code></br>
+string
 </td>
+<td><code>GameServer</code></td>
 </tr>
 <tr>
 <td>
-<code>minCapacity</code></br>
+<code>metadata</code></br>
 <em>
-int64
+<a href="https://v1-26.docs.kubernetes.io/docs/reference/generated/kubernetes-api/v1.26/#objectmeta-v1-meta">
+Kubernetes meta/v1.ObjectMeta
+</a>
 </em>
 </td>
 <td>
-<p>MinCapacity is the minimum aggregate Counter total capacity across the fleet.
-If zero, MinCapacity is ignored.
-If non zero, MinCapacity must be smaller than MaxCapacity and bigger than BufferSize.</p>
+Refer to the Kubernetes API documentation for the fields of the
+<code>metadata</code> field.
 </td>
 </tr>
 <tr>
 <td>
-<code>bufferSize</code></br>
+<code>spec</code></br>
 <em>
-k8s.io/apimachinery/pkg/util/intstr.IntOrString
+<a href="#agones.dev/v1.GameServerSpec">
+GameServerSpec
+</a>
 </em>
 </td>
 <td>
-<p>BufferSize is the size of a buffer of counted items that are available in the Fleet (available
-capacity). Value can be an absolute number (ex: 5) or a percentage of desired gs instances
-(ex: 5%). An absolute number is calculated from percentage by rounding up.
-Must be bigger than 0. Required field.</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>
+<br/>
+<br/>
 <table>
-<thead>
-<tr>
-<th>Field</th>
-<th>Description</th>
-</tr>
-</thead>
-<tbody>
 <tr>
 <td>
-<code>seconds</code></br>
+<code>container</code></br>
 <em>
-int32
+string
 </em>
 </td>
 <td>
-<p>Seconds defines how often we run fleet autoscaling in seconds</p>
+<p>Container specifies which Pod container is the game server. Only required if there is more than one
+container defined</p>
 </td>
 </tr>
-</tbody>
-</table>
-<h3 id="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>
+<code>ports</code></br>
 <em>
-k8s.io/apimachinery/pkg/types.UID
+<a href="#agones.dev/v1.GameServerPort">
+[]GameServerPort
+</a>
 </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>Ports are the array of ports that can be exposed via the game server</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>name</code></br>
+<code>health</code></br>
 <em>
-string
+<a href="#agones.dev/v1.Health">
+Health
+</a>
 </em>
 </td>
 <td>
-<p>Name is the name of the Fleet being scaled</p>
+<p>Health configures health checking</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>namespace</code></br>
+<code>scheduling</code></br>
 <em>
-string
+agones.dev/agones/pkg/apis.SchedulingStrategy
 </em>
 </td>
 <td>
-<p>Namespace is the namespace associated with the request (if any).</p>
+<p>Scheduling strategy. Defaults to &ldquo;Packed&rdquo;</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>status</code></br>
+<code>sdkServer</code></br>
 <em>
-<a href="#agones.dev/v1.FleetStatus">
-FleetStatus
+<a href="#agones.dev/v1.SdkServer">
+SdkServer
 </a>
 </em>
 </td>
 <td>
-<p>The Fleet&rsquo;s status values</p>
+<p>SdkServer specifies parameters for the Agones SDK Server sidecar container</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>
+<code>template</code></br>
 <em>
-k8s.io/apimachinery/pkg/types.UID
+<a href="https://v1-26.docs.kubernetes.io/docs/reference/generated/kubernetes-api/v1.26/#podtemplatespec-v1-core">
+Kubernetes core/v1.PodTemplateSpec
+</a>
 </em>
 </td>
 <td>
-<p>UID is an identifier for the individual request/response.
-This should be copied over from the corresponding FleetAutoscaleRequest.</p>
+<p>Template describes the Pod that will be created for the GameServer</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>scale</code></br>
+<code>players</code></br>
 <em>
-bool
+<a href="#agones.dev/v1.PlayersSpec">
+PlayersSpec
+</a>
 </em>
 </td>
 <td>
-<p>Set to false if no scaling should occur to the Fleet</p>
+<em>(Optional)</em>
+<p>(Alpha, PlayerTracking feature flag) Players provides the configuration for player tracking features.</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>replicas</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>The targeted replica count</p>
+<em>(Optional)</em>
+<p>(Alpha, CountsAndLists feature flag) Counters and Lists provides the configuration for generic tracking features.</p>
 </td>
 </tr>
-</tbody>
-</table>
-<h3 id="autoscaling.agones.dev/v1.FleetAutoscaleReview">FleetAutoscaleReview
-</h3>
-<p>
-<p>FleetAutoscaleReview is passed to the webhook with a populated Request value,
-and then returned with a populated Response.</p>
-</p>
-<table>
-<thead>
 <tr>
-<th>Field</th>
-<th>Description</th>
+<td>
+<code>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>
-</thead>
-<tbody>
 <tr>
 <td>
-<code>request</code></br>
+<code>eviction</code></br>
 <em>
-<a href="#autoscaling.agones.dev/v1.FleetAutoscaleRequest">
-FleetAutoscaleRequest
+<a href="#agones.dev/v1.Eviction">
+Eviction
 </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>
 <tr>
 <td>
-<code>response</code></br>
+<code>status</code></br>
 <em>
-<a href="#autoscaling.agones.dev/v1.FleetAutoscaleResponse">
-FleetAutoscaleResponse
+<a href="#agones.dev/v1.GameServerStatus">
+GameServerStatus
 </a>
 </em>
 </td>
@@ -4635,14 +4567,12 @@ <h3 id="autoscaling.agones.dev/v1.FleetAutoscaleReview">FleetAutoscaleReview
 </tr>
 </tbody>
 </table>
-<h3 id="autoscaling.agones.dev/v1.FleetAutoscalerPolicy">FleetAutoscalerPolicy
+<h3 id="agones.dev/v1.GameServerSet">GameServerSet
 </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>GameServerSet is the data structure for a set of GameServers.
+This matches philosophically with the relationship between
+Deployments and ReplicaSets</p>
 </p>
 <table>
 <thead>
@@ -4654,153 +4584,143 @@ <h3 id="autoscaling.agones.dev/v1.FleetAutoscalerPolicy">FleetAutoscalerPolicy
 <tbody>
 <tr>
 <td>
-<code>type</code></br>
-<em>
-<a href="#autoscaling.agones.dev/v1.FleetAutoscalerPolicyType">
-FleetAutoscalerPolicyType
-</a>
-</em>
+<code>apiVersion</code></br>
+string</td>
+<td>
+<code>
+agones.dev/v1
+</code>
 </td>
+</tr>
+<tr>
 <td>
-<p>Type of autoscaling policy.</p>
+<code>kind</code></br>
+string
 </td>
+<td><code>GameServerSet</code></td>
 </tr>
 <tr>
 <td>
-<code>buffer</code></br>
+<code>metadata</code></br>
 <em>
-<a href="#autoscaling.agones.dev/v1.BufferPolicy">
-BufferPolicy
+<a href="https://v1-26.docs.kubernetes.io/docs/reference/generated/kubernetes-api/v1.26/#objectmeta-v1-meta">
+Kubernetes meta/v1.ObjectMeta
 </a>
 </em>
 </td>
 <td>
-<em>(Optional)</em>
-<p>Buffer policy config params. Present only if FleetAutoscalerPolicyType = Buffer.</p>
+Refer to the Kubernetes API documentation for the fields of the
+<code>metadata</code> field.
 </td>
 </tr>
 <tr>
 <td>
-<code>webhook</code></br>
+<code>spec</code></br>
 <em>
-<a href="#autoscaling.agones.dev/v1.WebhookPolicy">
-WebhookPolicy
+<a href="#agones.dev/v1.GameServerSetSpec">
+GameServerSetSpec
 </a>
 </em>
 </td>
 <td>
-<em>(Optional)</em>
-<p>Webhook policy config params. Present only if FleetAutoscalerPolicyType = Webhook.</p>
-</td>
-</tr>
+<br/>
+<br/>
+<table>
 <tr>
 <td>
-<code>counter</code></br>
+<code>replicas</code></br>
 <em>
-<a href="#autoscaling.agones.dev/v1.CounterPolicy">
-CounterPolicy
-</a>
+int32
 </em>
 </td>
 <td>
-<em>(Optional)</em>
-<p>[Stage:Alpha]
-[FeatureFlag:CountsAndLists]
-Counter policy config params. Present only if FleetAutoscalerPolicyType = Counter.</p>
+<p>Replicas are the number of GameServers that should be in this set</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>list</code></br>
+<code>allocationOverflow</code></br>
 <em>
-<a href="#autoscaling.agones.dev/v1.ListPolicy">
-ListPolicy
+<a href="#agones.dev/v1.AllocationOverflow">
+AllocationOverflow
 </a>
 </em>
 </td>
 <td>
 <em>(Optional)</em>
-<p>[Stage:Alpha]
-[FeatureFlag:CountsAndLists]
-List policy config params. Present only if FleetAutoscalerPolicyType = List.</p>
+<p>[Stage: Alpha]
+[FeatureFlag:FleetAllocationOverflow]
+Labels and Annotations to apply to GameServers when the number of Allocated GameServers drops below
+the desired replicas on the underlying <code>GameServerSet</code></p>
 </td>
 </tr>
-</tbody>
-</table>
-<h3 id="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>
+<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>fleetName</code></br>
+<code>priorities</code></br>
 <em>
-string
+<a href="#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 Fleetautoscaler will use the first priority for sorting GameServers
+by total Capacity in the Fleet and acts as a tie-breaker after sorting the game servers by
+State and Strategy. Impacts scale down logic.</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 GameServerSet</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.GameServerSetStatus">
+GameServerSetStatus
 </a>
 </em>
 </td>
 <td>
-<em>(Optional)</em>
-<p>Sync defines when FleetAutoscalers runs autoscaling</p>
 </td>
 </tr>
 </tbody>
 </table>
-<h3 id="autoscaling.agones.dev/v1.FleetAutoscalerStatus">FleetAutoscalerStatus
+<h3 id="agones.dev/v1.AggregatedCounterStatus">AggregatedCounterStatus
 </h3>
 <p>
 (<em>Appears on:</em>
-<a href="#autoscaling.agones.dev/v1.FleetAutoscaler">FleetAutoscaler</a>)
+<a href="#agones.dev/v1.FleetStatus">FleetStatus</a>, 
+<a href="#agones.dev/v1.GameServerSetStatus">GameServerSetStatus</a>)
 </p>
 <p>
-<p>FleetAutoscalerStatus defines the current status of a FleetAutoscaler</p>
+<p>AggregatedCounterStatus stores total and allocated Counter tracking values</p>
 </p>
 <table>
 <thead>
@@ -4812,75 +4732,55 @@ <h3 id="autoscaling.agones.dev/v1.FleetAutoscalerStatus">FleetAutoscalerStatus
 <tbody>
 <tr>
 <td>
-<code>currentReplicas</code></br>
+<code>allocatedCount</code></br>
 <em>
-int32
+int64
 </em>
 </td>
 <td>
-<p>CurrentReplicas is the current number of gameserver replicas
-of the fleet managed by this autoscaler, as last seen by the autoscaler</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>desiredReplicas</code></br>
+<code>allocatedCapacity</code></br>
 <em>
-int32
+int64
 </em>
 </td>
 <td>
-<p>DesiredReplicas is the desired number of gameserver replicas
-of the fleet managed by this autoscaler, as last calculated by the autoscaler</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>lastScaleTime</code></br>
+<code>count</code></br>
 <em>
-<a href="https://v1-26.docs.kubernetes.io/docs/reference/generated/kubernetes-api/v1.26/#time-v1-meta">
-Kubernetes meta/v1.Time
-</a>
-</em>
-</td>
-<td>
-<em>(Optional)</em>
-<p>lastScaleTime is the last time the FleetAutoscaler scaled the attached fleet,</p>
-</td>
-</tr>
-<tr>
-<td>
-<code>ableToScale</code></br>
-<em>
-bool
+int64
 </em>
 </td>
 <td>
-<p>AbleToScale indicates that we can access the target fleet</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>scalingLimited</code></br>
+<code>capacity</code></br>
 <em>
-bool
+int64
 </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>
 </td>
 </tr>
 </tbody>
 </table>
-<h3 id="autoscaling.agones.dev/v1.FleetAutoscalerSync">FleetAutoscalerSync
+<h3 id="agones.dev/v1.AggregatedListStatus">AggregatedListStatus
 </h3>
 <p>
 (<em>Appears on:</em>
-<a href="#autoscaling.agones.dev/v1.FleetAutoscalerSpec">FleetAutoscalerSpec</a>)
+<a href="#agones.dev/v1.FleetStatus">FleetStatus</a>, 
+<a href="#agones.dev/v1.GameServerSetStatus">GameServerSetStatus</a>)
 </p>
 <p>
-<p>FleetAutoscalerSync describes when to sync a fleet</p>
+<p>AggregatedListStatus stores total and allocated List tracking values</p>
 </p>
 <table>
 <thead>
@@ -4892,50 +4792,55 @@ <h3 id="autoscaling.agones.dev/v1.FleetAutoscalerSync">FleetAutoscalerSync
 <tbody>
 <tr>
 <td>
-<code>type</code></br>
+<code>allocatedCount</code></br>
 <em>
-<a href="#autoscaling.agones.dev/v1.FleetAutoscalerSyncType">
-FleetAutoscalerSyncType
-</a>
+int64
 </em>
 </td>
 <td>
-<p>Type of autoscaling sync.</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>fixedInterval</code></br>
+<code>allocatedCapacity</code></br>
 <em>
-<a href="#autoscaling.agones.dev/v1.FixedIntervalSync">
-FixedIntervalSync
-</a>
+int64
+</em>
+</td>
+<td>
+</td>
+</tr>
+<tr>
+<td>
+<code>count</code></br>
+<em>
+int64
+</em>
+</td>
+<td>
+</td>
+</tr>
+<tr>
+<td>
+<code>capacity</code></br>
+<em>
+int64
 </em>
 </td>
 <td>
-<em>(Optional)</em>
-<p>FixedInterval config params. Present only if FleetAutoscalerSyncType = FixedInterval.</p>
 </td>
 </tr>
 </tbody>
 </table>
-<h3 id="autoscaling.agones.dev/v1.FleetAutoscalerSyncType">FleetAutoscalerSyncType
-(<code>string</code> alias)</p></h3>
-<p>
-(<em>Appears on:</em>
-<a href="#autoscaling.agones.dev/v1.FleetAutoscalerSync">FleetAutoscalerSync</a>)
-</p>
-<p>
-<p>FleetAutoscalerSyncType is the sync strategy for a given Fleet</p>
-</p>
-<h3 id="autoscaling.agones.dev/v1.ListPolicy">ListPolicy
+<h3 id="agones.dev/v1.AggregatedPlayerStatus">AggregatedPlayerStatus
 </h3>
 <p>
 (<em>Appears on:</em>
-<a href="#autoscaling.agones.dev/v1.FleetAutoscalerPolicy">FleetAutoscalerPolicy</a>)
+<a href="#agones.dev/v1.FleetStatus">FleetStatus</a>, 
+<a href="#agones.dev/v1.GameServerSetStatus">GameServerSetStatus</a>)
 </p>
 <p>
-<p>ListPolicy controls the desired behavior of the List autoscaler policy.</p>
+<p>AggregatedPlayerStatus stores total player tracking values</p>
 </p>
 <table>
 <thead>
@@ -4947,66 +4852,81 @@ <h3 id="autoscaling.agones.dev/v1.ListPolicy">ListPolicy
 <tbody>
 <tr>
 <td>
-<code>key</code></br>
+<code>count</code></br>
 <em>
-string
+int64
 </em>
 </td>
 <td>
-<p>Key is the name of the List. Required field.</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>maxCapacity</code></br>
+<code>capacity</code></br>
 <em>
 int64
 </em>
 </td>
 <td>
-<p>MaxCapacity is the maximum aggregate List total capacity across the fleet.
-MaxCapacity must be bigger than both MinCapacity and BufferSize. Required field.</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>minCapacity</code></br>
+<code>labels</code></br>
 <em>
-int64
+map[string]string
 </em>
 </td>
 <td>
-<p>MinCapacity is the minimum aggregate List total capacity across the fleet.
-If zero, it is ignored.
-If non zero, it must be smaller than MaxCapacity and bigger than BufferSize.</p>
+<em>(Optional)</em>
+<p>Labels to be applied to the <code>GameServer</code></p>
 </td>
 </tr>
 <tr>
 <td>
-<code>bufferSize</code></br>
+<code>annotations</code></br>
 <em>
-k8s.io/apimachinery/pkg/util/intstr.IntOrString
+map[string]string
 </em>
 </td>
 <td>
-<p>BufferSize is the size of a buffer based on the List capacity that is available over the
-current aggregate List length in the Fleet (available capacity). It can be specified either
-as an absolute value (i.e. 5) or percentage format (i.e. 5%).
-Must be bigger than 0. Required field.</p>
+<em>(Optional)</em>
+<p>Annotations to be applied to the <code>GameServer</code></p>
 </td>
 </tr>
 </tbody>
 </table>
-<h3 id="autoscaling.agones.dev/v1.WebhookPolicy">WebhookPolicy
+<h3 id="agones.dev/v1.CounterStatus">CounterStatus
 </h3>
 <p>
 (<em>Appears on:</em>
-<a href="#autoscaling.agones.dev/v1.FleetAutoscalerPolicy">FleetAutoscalerPolicy</a>)
+<a href="#agones.dev/v1.GameServerSpec">GameServerSpec</a>, 
+<a href="#agones.dev/v1.GameServerStatus">GameServerStatus</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>CounterStatus stores the current counter values</p>
 </p>
 <table>
 <thead>
@@ -5018,79 +4938,79 @@ <h3 id="autoscaling.agones.dev/v1.WebhookPolicy">WebhookPolicy
 <tbody>
 <tr>
 <td>
-<code>url</code></br>
+<code>count</code></br>
 <em>
-string
+int64
 </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>service</code></br>
+<code>capacity</code></br>
 <em>
-<a href="https://v1-26.docs.kubernetes.io/docs/reference/generated/kubernetes-api/v1.26/#servicereference-v1-admissionregistration">
-Kubernetes admissionregistration/v1.ServiceReference
-</a>
+int64
 </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>
+</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>caBundle</code></br>
+<code>safe</code></br>
 <em>
-[]byte
+<a href="#agones.dev/v1.EvictionSafe">
+EvictionSafe
+</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>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="multicluster.agones.dev/v1">multicluster.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="#multicluster.agones.dev/v1.GameServerAllocationPolicy">GameServerAllocationPolicy</a>
-</li></ul>
-<h3 id="multicluster.agones.dev/v1.GameServerAllocationPolicy">GameServerAllocationPolicy
+<p>
+<p>EvictionSafe specified whether the game server supports termination via SIGTERM</p>
+</p>
+<h3 id="agones.dev/v1.FleetSpec">FleetSpec
 </h3>
 <p>
-<p>GameServerAllocationPolicy is the Schema for the gameserverallocationpolicies API</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>
@@ -5102,93 +5022,97 @@ <h3 id="multicluster.agones.dev/v1.GameServerAllocationPolicy">GameServerAllocat
 <tbody>
 <tr>
 <td>
-<code>apiVersion</code></br>
-string</td>
-<td>
-<code>
-multicluster.agones.dev/v1
-</code>
+<code>replicas</code></br>
+<em>
+int32
+</em>
 </td>
-</tr>
-<tr>
 <td>
-<code>kind</code></br>
-string
+<p>Replicas are the number of GameServers that should be in this set. Defaults to 0.</p>
 </td>
-<td><code>GameServerAllocationPolicy</code></td>
 </tr>
 <tr>
 <td>
-<code>metadata</code></br>
+<code>allocationOverflow</code></br>
 <em>
-<a href="https://v1-26.docs.kubernetes.io/docs/reference/generated/kubernetes-api/v1.26/#objectmeta-v1-meta">
-Kubernetes meta/v1.ObjectMeta
+<a href="#agones.dev/v1.AllocationOverflow">
+AllocationOverflow
 </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>(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>
+</td>
+</tr>
+<tr>
+<td>
+<code>strategy</code></br>
 <em>
-<a href="#multicluster.agones.dev/v1.GameServerAllocationPolicySpec">
-GameServerAllocationPolicySpec
+<a href="https://v1-26.docs.kubernetes.io/docs/reference/generated/kubernetes-api/v1.26/#deploymentstrategy-v1-apps">
+Kubernetes apps/v1.DeploymentStrategy
 </a>
 </em>
 </td>
 <td>
-<br/>
-<br/>
-<table>
+<p>Deployment strategy</p>
+</td>
+</tr>
 <tr>
 <td>
-<code>priority</code></br>
+<code>scheduling</code></br>
 <em>
-int32
+agones.dev/agones/pkg/apis.SchedulingStrategy
 </em>
 </td>
 <td>
+<p>Scheduling strategy. Defaults to &ldquo;Packed&rdquo;.</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>weight</code></br>
+<code>priorities</code></br>
 <em>
-int
+<a href="#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 Fleetautoscaler will use the first priority for sorting GameServers
+by total Capacity in the Fleet and acts as a tie-breaker after sorting the game servers by
+State and Strategy. Impacts scale down logic.</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>connectionInfo</code></br>
+<code>template</code></br>
 <em>
-<a href="#multicluster.agones.dev/v1.ClusterConnectionInfo">
-ClusterConnectionInfo
+<a href="#agones.dev/v1.GameServerTemplateSpec">
+GameServerTemplateSpec
 </a>
 </em>
 </td>
 <td>
-</td>
-</tr>
-</table>
+<p>Template the GameServer template to apply for this Fleet</p>
 </td>
 </tr>
 </tbody>
 </table>
-<h3 id="multicluster.agones.dev/v1.ClusterConnectionInfo">ClusterConnectionInfo
+<h3 id="agones.dev/v1.FleetStatus">FleetStatus
 </h3>
 <p>
 (<em>Appears on:</em>
-<a href="#multicluster.agones.dev/v1.GameServerAllocationPolicySpec">GameServerAllocationPolicySpec</a>)
+<a href="#agones.dev/v1.Fleet">Fleet</a>, 
+<a href="#autoscaling.agones.dev/v1.FleetAutoscaleRequest">FleetAutoscaleRequest</a>)
 </p>
 <p>
-<p>ClusterConnectionInfo defines the connection information for a cluster</p>
+<p>FleetStatus is the status of a Fleet</p>
 </p>
 <table>
 <thead>
@@ -5200,67 +5124,106 @@ <h3 id="multicluster.agones.dev/v1.ClusterConnectionInfo">ClusterConnectionInfo
 <tbody>
 <tr>
 <td>
-<code>clusterName</code></br>
+<code>replicas</code></br>
 <em>
-string
+int32
 </em>
 </td>
 <td>
-<p>Optional: the name of the targeted cluster</p>
+<p>Replicas the total number of current GameServer replicas</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>allocationEndpoints</code></br>
+<code>readyReplicas</code></br>
 <em>
-[]string
+int32
 </em>
 </td>
 <td>
-<p>The endpoints for the allocator service in the targeted cluster.
-If the AllocationEndpoints is not set, the allocation happens on local cluster.
-If there are multiple endpoints any of the endpoints that can handle allocation request should suffice</p>
+<p>ReadyReplicas are the number of Ready GameServer replicas</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>secretName</code></br>
+<code>reservedReplicas</code></br>
 <em>
-string
+int32
 </em>
 </td>
 <td>
-<p>The name of the secret that contains TLS client certificates to connect the allocator server in the targeted cluster</p>
+<p>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>namespace</code></br>
+<code>allocatedReplicas</code></br>
 <em>
-string
+int32
 </em>
 </td>
 <td>
-<p>The cluster namespace from which to allocate gameservers</p>
+<p>AllocatedReplicas are the number of Allocated GameServer replicas</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>serverCa</code></br>
+<code>players</code></br>
 <em>
-[]byte
+<a href="#agones.dev/v1.AggregatedPlayerStatus">
+AggregatedPlayerStatus
+</a>
 </em>
 </td>
 <td>
-<p>The PEM encoded server CA, used by the allocator client to authenticate the remote server.</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>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 Fleet.</p>
+</td>
+</tr>
+<tr>
+<td>
+<code>lists</code></br>
+<em>
+<a href="#agones.dev/v1.AggregatedListStatus">
+map[string]agones.dev/agones/pkg/apis/agones/v1.AggregatedListStatus
+</a>
+</em>
+</td>
+<td>
+<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="multicluster.agones.dev/v1.ConnectionInfoIterator">ConnectionInfoIterator
+<h3 id="agones.dev/v1.GameServerPort">GameServerPort
 </h3>
 <p>
-<p>ConnectionInfoIterator an iterator on ClusterConnectionInfo</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>
@@ -5272,118 +5235,89 @@ <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>
+<code>name</code></br>
 <em>
-[]int32
+string
 </em>
 </td>
 <td>
-<p>orderedPriorities list of ordered priorities</p>
+<p>Name is the descriptive name of the port</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>priorityToCluster</code></br>
+<code>portPolicy</code></br>
 <em>
-map[int32]map[string][]*agones.dev/agones/pkg/apis/multicluster/v1.GameServerAllocationPolicy
+<a href="#agones.dev/v1.PortPolicy">
+PortPolicy
+</a>
 </em>
 </td>
 <td>
-<p>priorityToCluster Map of priority to cluster-policies map</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>clusterBlackList</code></br>
+<code>container</code></br>
 <em>
-map[string]bool
+string
 </em>
 </td>
 <td>
-<p>clusterBlackList the cluster blacklist for the clusters that has already returned</p>
+<em>(Optional)</em>
+<p>Container is the name of the container on which to open the port. Defaults to the game server container.</p>
 </td>
 </tr>
-</tbody>
-</table>
-<h3 id="multicluster.agones.dev/v1.GameServerAllocationPolicySpec">GameServerAllocationPolicySpec
-</h3>
-<p>
-(<em>Appears on:</em>
-<a href="#multicluster.agones.dev/v1.GameServerAllocationPolicy">GameServerAllocationPolicy</a>)
-</p>
-<p>
-<p>GameServerAllocationPolicySpec defines the desired state of GameServerAllocationPolicy</p>
-</p>
-<table>
-<thead>
-<tr>
-<th>Field</th>
-<th>Description</th>
-</tr>
-</thead>
-<tbody>
 <tr>
 <td>
-<code>priority</code></br>
+<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>weight</code></br>
+<code>hostPort</code></br>
 <em>
-int
+int32
 </em>
 </td>
 <td>
+<p>HostPort the port exposed on the host for clients to connect to</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>connectionInfo</code></br>
+<code>protocol</code></br>
 <em>
-<a href="#multicluster.agones.dev/v1.ClusterConnectionInfo">
-ClusterConnectionInfo
+<a href="https://v1-26.docs.kubernetes.io/docs/reference/generated/kubernetes-api/v1.26/#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>
-<hr/>
-<h2 id="agones.dev/v1">agones.dev/v1</h2>
+<h3 id="agones.dev/v1.GameServerSetSpec">GameServerSetSpec
+</h3>
 <p>
-<p>Package v1 is the v1 version of the API.</p>
+(<em>Appears on:</em>
+<a href="#agones.dev/v1.GameServerSet">GameServerSet</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>GameServerSetSpec the specification for GameServerSet</p>
 </p>
 <table>
 <thead>
@@ -5395,208 +5329,213 @@ <h3 id="agones.dev/v1.Fleet">Fleet
 <tbody>
 <tr>
 <td>
-<code>apiVersion</code></br>
-string</td>
-<td>
-<code>
-agones.dev/v1
-</code>
+<code>replicas</code></br>
+<em>
+int32
+</em>
 </td>
-</tr>
-<tr>
 <td>
-<code>kind</code></br>
-string
+<p>Replicas are the number of GameServers that should be in this set</p>
 </td>
-<td><code>Fleet</code></td>
 </tr>
 <tr>
 <td>
-<code>metadata</code></br>
+<code>allocationOverflow</code></br>
 <em>
-<a href="https://v1-26.docs.kubernetes.io/docs/reference/generated/kubernetes-api/v1.26/#objectmeta-v1-meta">
-Kubernetes meta/v1.ObjectMeta
+<a href="#agones.dev/v1.AllocationOverflow">
+AllocationOverflow
 </a>
 </em>
 </td>
 <td>
-Refer to the Kubernetes API documentation for the fields of the
-<code>metadata</code> field.
+<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>spec</code></br>
+<code>scheduling</code></br>
 <em>
-<a href="#agones.dev/v1.FleetSpec">
-FleetSpec
-</a>
+agones.dev/agones/pkg/apis.SchedulingStrategy
 </em>
 </td>
 <td>
-<br/>
-<br/>
-<table>
+<p>Scheduling strategy. Defaults to &ldquo;Packed&rdquo;.</p>
+</td>
+</tr>
 <tr>
 <td>
-<code>replicas</code></br>
+<code>priorities</code></br>
 <em>
-int32
+<a href="#agones.dev/v1.Priority">
+[]Priority
+</a>
 </em>
 </td>
 <td>
-<p>Replicas are the number of GameServers that should be in this set. Defaults to 0.</p>
+<em>(Optional)</em>
+<p>(Alpha, CountsAndLists feature flag) The first Priority on the array of Priorities is the most
+important for sorting. The Fleetautoscaler will use the first priority for sorting GameServers
+by total Capacity in the Fleet and acts as a tie-breaker after sorting the game servers by
+State and Strategy. Impacts scale down logic.</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>allocationOverflow</code></br>
+<code>template</code></br>
 <em>
-<a href="#agones.dev/v1.AllocationOverflow">
-AllocationOverflow
+<a href="#agones.dev/v1.GameServerTemplateSpec">
+GameServerTemplateSpec
 </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>Template the GameServer template to apply for this GameServerSet</p>
 </td>
 </tr>
+</tbody>
+</table>
+<h3 id="agones.dev/v1.GameServerSetStatus">GameServerSetStatus
+</h3>
+<p>
+(<em>Appears on:</em>
+<a href="#agones.dev/v1.GameServerSet">GameServerSet</a>)
+</p>
+<p>
+<p>GameServerSetStatus is the status of a GameServerSet</p>
+</p>
+<table>
+<thead>
+<tr>
+<th>Field</th>
+<th>Description</th>
+</tr>
+</thead>
+<tbody>
 <tr>
 <td>
-<code>strategy</code></br>
+<code>replicas</code></br>
 <em>
-<a href="https://v1-26.docs.kubernetes.io/docs/reference/generated/kubernetes-api/v1.26/#deploymentstrategy-v1-apps">
-Kubernetes apps/v1.DeploymentStrategy
-</a>
+int32
 </em>
 </td>
 <td>
-<p>Deployment strategy</p>
+<p>Replicas is the total number of current GameServer replicas</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>scheduling</code></br>
+<code>readyReplicas</code></br>
 <em>
-agones.dev/agones/pkg/apis.SchedulingStrategy
+int32
 </em>
 </td>
 <td>
-<p>Scheduling strategy. Defaults to &ldquo;Packed&rdquo;.</p>
+<p>ReadyReplicas is the number of Ready GameServer replicas</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>priorities</code></br>
+<code>reservedReplicas</code></br>
 <em>
-<a href="#agones.dev/v1.Priority">
-[]Priority
-</a>
+int32
 </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 Fleetautoscaler will use the first priority for sorting GameServers
-by total Capacity in the Fleet and acts as a tie-breaker after sorting the game servers by
-State and Strategy. Impacts scale down logic.</p>
+<p>ReservedReplicas is the number of Reserved GameServer replicas</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>template</code></br>
+<code>allocatedReplicas</code></br>
 <em>
-<a href="#agones.dev/v1.GameServerTemplateSpec">
-GameServerTemplateSpec
-</a>
+int32
 </em>
 </td>
 <td>
-<p>Template the GameServer template to apply for this Fleet</p>
-</td>
-</tr>
-</table>
+<p>AllocatedReplicas is the number of Allocated GameServer replicas</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>status</code></br>
+<code>shutdownReplicas</code></br>
 <em>
-<a href="#agones.dev/v1.FleetStatus">
-FleetStatus
-</a>
+int32
 </em>
 </td>
 <td>
+<p>ShutdownReplicas is the number of Shutdown GameServers 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>
+<code>players</code></br>
+<em>
+<a href="#agones.dev/v1.AggregatedPlayerStatus">
+AggregatedPlayerStatus
+</a>
+</em>
 </td>
-</tr>
-<tr>
 <td>
-<code>kind</code></br>
-string
+<em>(Optional)</em>
+<p>[Stage:Alpha]
+[FeatureFlag:PlayerTracking]
+Players is the current total player capacity and count for this GameServerSet</p>
 </td>
-<td><code>GameServer</code></td>
 </tr>
 <tr>
 <td>
-<code>metadata</code></br>
+<code>counters</code></br>
 <em>
-<a href="https://v1-26.docs.kubernetes.io/docs/reference/generated/kubernetes-api/v1.26/#objectmeta-v1-meta">
-Kubernetes meta/v1.ObjectMeta
+<a href="#agones.dev/v1.AggregatedCounterStatus">
+map[string]agones.dev/agones/pkg/apis/agones/v1.AggregatedCounterStatus
 </a>
 </em>
 </td>
 <td>
-Refer to the Kubernetes API documentation for the fields of the
-<code>metadata</code> field.
+<em>(Optional)</em>
+<p>(Alpha, CountsAndLists feature flag) Counters provides aggregated Counter capacity and Counter
+count for this GameServerSet.</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>spec</code></br>
+<code>lists</code></br>
 <em>
-<a href="#agones.dev/v1.GameServerSpec">
-GameServerSpec
+<a href="#agones.dev/v1.AggregatedListStatus">
+map[string]agones.dev/agones/pkg/apis/agones/v1.AggregatedListStatus
 </a>
 </em>
 </td>
 <td>
-<br/>
-<br/>
+<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.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>
 <table>
+<thead>
+<tr>
+<th>Field</th>
+<th>Description</th>
+</tr>
+</thead>
+<tbody>
 <tr>
 <td>
 <code>container</code></br>
@@ -5726,29 +5665,26 @@ <h3 id="agones.dev/v1.GameServer">GameServer
 <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>
-<h3 id="agones.dev/v1.GameServerSet">GameServerSet
+<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>
-<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.GameServer">GameServer</a>)
+</p>
+<p>
+<p>GameServerStatus is the status for a GameServer resource</p>
 </p>
 <table>
 <thead>
@@ -5760,143 +5696,129 @@ <h3 id="agones.dev/v1.GameServerSet">GameServerSet
 <tbody>
 <tr>
 <td>
-<code>apiVersion</code></br>
-string</td>
-<td>
-<code>
-agones.dev/v1
-</code>
+<code>state</code></br>
+<em>
+<a href="#agones.dev/v1.GameServerState">
+GameServerState
+</a>
+</em>
 </td>
-</tr>
-<tr>
 <td>
-<code>kind</code></br>
-string
+<p>GameServerState is the current state of a GameServer, e.g. Creating, Starting, Ready, etc</p>
 </td>
-<td><code>GameServerSet</code></td>
 </tr>
 <tr>
 <td>
-<code>metadata</code></br>
+<code>ports</code></br>
 <em>
-<a href="https://v1-26.docs.kubernetes.io/docs/reference/generated/kubernetes-api/v1.26/#objectmeta-v1-meta">
-Kubernetes meta/v1.ObjectMeta
+<a href="#agones.dev/v1.GameServerStatusPort">
+[]GameServerStatusPort
 </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>
+<code>address</code></br>
 <em>
-<a href="#agones.dev/v1.GameServerSetSpec">
-GameServerSetSpec
-</a>
+string
 </em>
 </td>
 <td>
-<br/>
-<br/>
-<table>
+</td>
+</tr>
 <tr>
 <td>
-<code>replicas</code></br>
+<code>nodeName</code></br>
 <em>
-int32
+string
 </em>
 </td>
 <td>
-<p>Replicas are the number of GameServers that should be in this set</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>allocationOverflow</code></br>
+<code>reservedUntil</code></br>
 <em>
-<a href="#agones.dev/v1.AllocationOverflow">
-AllocationOverflow
+<a href="https://v1-26.docs.kubernetes.io/docs/reference/generated/kubernetes-api/v1.26/#time-v1-meta">
+Kubernetes meta/v1.Time
 </a>
 </em>
 </td>
 <td>
-<em>(Optional)</em>
-<p>[Stage: Alpha]
-[FeatureFlag:FleetAllocationOverflow]
-Labels and Annotations to apply to GameServers when the number of Allocated GameServers drops below
-the desired replicas on the underlying <code>GameServerSet</code></p>
 </td>
 </tr>
 <tr>
 <td>
-<code>scheduling</code></br>
+<code>players</code></br>
 <em>
-agones.dev/agones/pkg/apis.SchedulingStrategy
+<a href="#agones.dev/v1.PlayerStatus">
+PlayerStatus
+</a>
 </em>
 </td>
 <td>
-<p>Scheduling strategy. Defaults to &ldquo;Packed&rdquo;.</p>
+<em>(Optional)</em>
+<p>[Stage:Alpha]
+[FeatureFlag:PlayerTracking]</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>priorities</code></br>
+<code>counters</code></br>
 <em>
-<a href="#agones.dev/v1.Priority">
-[]Priority
+<a href="#agones.dev/v1.CounterStatus">
+map[string]agones.dev/agones/pkg/apis/agones/v1.CounterStatus
 </a>
 </em>
 </td>
 <td>
 <em>(Optional)</em>
-<p>(Alpha, CountsAndLists feature flag) The first Priority on the array of Priorities is the most
-important for sorting. The Fleetautoscaler will use the first priority for sorting GameServers
-by total Capacity in the Fleet and acts as a tie-breaker after sorting the game servers by
-State and Strategy. Impacts scale down logic.</p>
+<p>(Alpha, CountsAndLists feature flag) Counters and Lists provides the configuration for generic tracking features.</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>template</code></br>
+<code>lists</code></br>
 <em>
-<a href="#agones.dev/v1.GameServerTemplateSpec">
-GameServerTemplateSpec
+<a href="#agones.dev/v1.ListStatus">
+map[string]agones.dev/agones/pkg/apis/agones/v1.ListStatus
 </a>
 </em>
 </td>
 <td>
-<p>Template the GameServer template to apply for this GameServerSet</p>
-</td>
-</tr>
-</table>
+<em>(Optional)</em>
 </td>
 </tr>
 <tr>
 <td>
-<code>status</code></br>
+<code>eviction</code></br>
 <em>
-<a href="#agones.dev/v1.GameServerSetStatus">
-GameServerSetStatus
+<a href="#agones.dev/v1.Eviction">
+Eviction
 </a>
 </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.AggregatedCounterStatus">AggregatedCounterStatus
+<h3 id="agones.dev/v1.GameServerStatusPort">GameServerStatusPort
 </h3>
 <p>
 (<em>Appears on:</em>
-<a href="#agones.dev/v1.FleetStatus">FleetStatus</a>, 
-<a href="#agones.dev/v1.GameServerSetStatus">GameServerSetStatus</a>)
+<a href="#allocation.agones.dev/v1.GameServerAllocationStatus">GameServerAllocationStatus</a>, 
+<a href="#agones.dev/v1.GameServerStatus">GameServerStatus</a>)
 </p>
 <p>
-<p>AggregatedCounterStatus stores total and allocated Counter tracking values</p>
+<p>GameServerStatusPort shows the port that was allocated to a
+GameServer.</p>
 </p>
 <table>
 <thead>
@@ -5908,29 +5830,9 @@ <h3 id="agones.dev/v1.AggregatedCounterStatus">AggregatedCounterStatus
 <tbody>
 <tr>
 <td>
-<code>allocatedCount</code></br>
-<em>
-int64
-</em>
-</td>
-<td>
-</td>
-</tr>
-<tr>
-<td>
-<code>allocatedCapacity</code></br>
-<em>
-int64
-</em>
-</td>
-<td>
-</td>
-</tr>
-<tr>
-<td>
-<code>count</code></br>
+<code>name</code></br>
 <em>
-int64
+string
 </em>
 </td>
 <td>
@@ -5938,9 +5840,9 @@ <h3 id="agones.dev/v1.AggregatedCounterStatus">AggregatedCounterStatus
 </tr>
 <tr>
 <td>
-<code>capacity</code></br>
+<code>port</code></br>
 <em>
-int64
+int32
 </em>
 </td>
 <td>
@@ -5948,15 +5850,15 @@ <h3 id="agones.dev/v1.AggregatedCounterStatus">AggregatedCounterStatus
 </tr>
 </tbody>
 </table>
-<h3 id="agones.dev/v1.AggregatedListStatus">AggregatedListStatus
+<h3 id="agones.dev/v1.GameServerTemplateSpec">GameServerTemplateSpec
 </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.FleetSpec">FleetSpec</a>, 
+<a href="#agones.dev/v1.GameServerSetSpec">GameServerSetSpec</a>)
 </p>
 <p>
-<p>AggregatedListStatus stores total and allocated List tracking values</p>
+<p>GameServerTemplateSpec is a template for GameServers</p>
 </p>
 <table>
 <thead>
@@ -5968,155 +5870,141 @@ <h3 id="agones.dev/v1.AggregatedListStatus">AggregatedListStatus
 <tbody>
 <tr>
 <td>
-<code>allocatedCount</code></br>
+<code>metadata</code></br>
 <em>
-int64
+<a href="https://v1-26.docs.kubernetes.io/docs/reference/generated/kubernetes-api/v1.26/#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>allocatedCapacity</code></br>
+<code>spec</code></br>
 <em>
-int64
+<a href="#agones.dev/v1.GameServerSpec">
+GameServerSpec
+</a>
 </em>
 </td>
 <td>
-</td>
-</tr>
+<br/>
+<br/>
+<table>
 <tr>
 <td>
-<code>count</code></br>
+<code>container</code></br>
 <em>
-int64
+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>capacity</code></br>
+<code>ports</code></br>
 <em>
-int64
+<a href="#agones.dev/v1.GameServerPort">
+[]GameServerPort
+</a>
 </em>
 </td>
 <td>
+<p>Ports are the array of ports that can be exposed via the game server</p>
 </td>
 </tr>
-</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>
+<td>
+<code>health</code></br>
+<em>
+<a href="#agones.dev/v1.Health">
+Health
+</a>
+</em>
+</td>
+<td>
+<p>Health configures health checking</p>
+</td>
 </tr>
-</thead>
-<tbody>
 <tr>
 <td>
-<code>count</code></br>
+<code>scheduling</code></br>
 <em>
-int64
+agones.dev/agones/pkg/apis.SchedulingStrategy
 </em>
 </td>
 <td>
+<p>Scheduling strategy. Defaults to &ldquo;Packed&rdquo;</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>capacity</code></br>
+<code>sdkServer</code></br>
 <em>
-int64
+<a href="#agones.dev/v1.SdkServer">
+SdkServer
+</a>
 </em>
 </td>
 <td>
+<p>SdkServer specifies parameters for the Agones SDK Server sidecar container</p>
 </td>
 </tr>
-</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>
+<td>
+<code>template</code></br>
+<em>
+<a href="https://v1-26.docs.kubernetes.io/docs/reference/generated/kubernetes-api/v1.26/#podtemplatespec-v1-core">
+Kubernetes core/v1.PodTemplateSpec
+</a>
+</em>
+</td>
+<td>
+<p>Template describes the Pod that will be created for the GameServer</p>
+</td>
 </tr>
-</thead>
-<tbody>
 <tr>
 <td>
-<code>labels</code></br>
+<code>players</code></br>
 <em>
-map[string]string
+<a href="#agones.dev/v1.PlayersSpec">
+PlayersSpec
+</a>
 </em>
 </td>
 <td>
 <em>(Optional)</em>
-<p>Labels to be applied to the <code>GameServer</code></p>
+<p>(Alpha, PlayerTracking feature flag) Players provides the configuration for player tracking features.</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>annotations</code></br>
+<code>counters</code></br>
 <em>
-map[string]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>Annotations to be applied to the <code>GameServer</code></p>
+<p>(Alpha, CountsAndLists feature flag) Counters and Lists provides the configuration for generic tracking features.</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>lists</code></br>
 <em>
-int64
+<a href="#agones.dev/v1.ListStatus">
+map[string]agones.dev/agones/pkg/apis/agones/v1.ListStatus
+</a>
 </em>
 </td>
 <td>
@@ -6124,25 +6012,31 @@ <h3 id="agones.dev/v1.CounterStatus">CounterStatus
 </tr>
 <tr>
 <td>
-<code>capacity</code></br>
+<code>eviction</code></br>
 <em>
-int64
+<a href="#agones.dev/v1.Eviction">
+Eviction
+</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.Eviction">Eviction
+<h3 id="agones.dev/v1.Health">Health
 </h3>
 <p>
 (<em>Appears on:</em>
-<a href="#agones.dev/v1.GameServerSpec">GameServerSpec</a>, 
-<a href="#agones.dev/v1.GameServerStatus">GameServerStatus</a>)
+<a href="#agones.dev/v1.GameServerSpec">GameServerSpec</a>)
 </p>
 <p>
-<p>Eviction specifies the eviction tolerance of the GameServer</p>
+<p>Health configures health checking on the GameServer</p>
 </p>
 <table>
 <thead>
@@ -6154,141 +6048,98 @@ <h3 id="agones.dev/v1.Eviction">Eviction
 <tbody>
 <tr>
 <td>
-<code>safe</code></br>
+<code>disabled</code></br>
 <em>
-<a href="#agones.dev/v1.EvictionSafe">
-EvictionSafe
-</a>
+bool
 </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>
+<p>Disabled is whether health checking is disabled or not</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>
+<code>periodSeconds</code></br>
 <em>
 int32
 </em>
 </td>
 <td>
-<p>Replicas are the number of GameServers that should be in this set. Defaults to 0.</p>
+<p>PeriodSeconds is the number of seconds each health ping has to occur in</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>allocationOverflow</code></br>
+<code>failureThreshold</code></br>
 <em>
-<a href="#agones.dev/v1.AllocationOverflow">
-AllocationOverflow
-</a>
+int32
 </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>FailureThreshold how many failures in a row constitutes unhealthy</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>strategy</code></br>
+<code>initialDelaySeconds</code></br>
 <em>
-<a href="https://v1-26.docs.kubernetes.io/docs/reference/generated/kubernetes-api/v1.26/#deploymentstrategy-v1-apps">
-Kubernetes apps/v1.DeploymentStrategy
-</a>
+int32
 </em>
 </td>
 <td>
-<p>Deployment strategy</p>
+<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>scheduling</code></br>
-<em>
-agones.dev/agones/pkg/apis.SchedulingStrategy
-</em>
-</td>
-<td>
-<p>Scheduling strategy. Defaults to &ldquo;Packed&rdquo;.</p>
-</td>
+<th>Field</th>
+<th>Description</th>
 </tr>
+</thead>
+<tbody>
 <tr>
 <td>
-<code>priorities</code></br>
+<code>capacity</code></br>
 <em>
-<a href="#agones.dev/v1.Priority">
-[]Priority
-</a>
+int64
 </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 Fleetautoscaler will use the first priority for sorting GameServers
-by total Capacity in the Fleet and acts as a tie-breaker after sorting the game servers by
-State and Strategy. Impacts scale down logic.</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>template</code></br>
+<code>values</code></br>
 <em>
-<a href="#agones.dev/v1.GameServerTemplateSpec">
-GameServerTemplateSpec
-</a>
+[]string
 </em>
 </td>
 <td>
-<p>Template the GameServer template to apply for this Fleet</p>
 </td>
 </tr>
 </tbody>
 </table>
-<h3 id="agones.dev/v1.FleetStatus">FleetStatus
+<h3 id="agones.dev/v1.PlayerStatus">PlayerStatus
 </h3>
 <p>
 (<em>Appears on:</em>
-<a href="#agones.dev/v1.Fleet">Fleet</a>, 
-<a href="#autoscaling.agones.dev/v1.FleetAutoscaleRequest">FleetAutoscaleRequest</a>)
+<a href="#agones.dev/v1.GameServerStatus">GameServerStatus</a>)
 </p>
 <p>
-<p>FleetStatus is the status of a Fleet</p>
+<p>PlayerStatus stores the current player capacity values</p>
 </p>
 <table>
 <thead>
@@ -6300,106 +6151,137 @@ <h3 id="agones.dev/v1.FleetStatus">FleetStatus
 <tbody>
 <tr>
 <td>
-<code>replicas</code></br>
+<code>count</code></br>
 <em>
-int32
+int64
 </em>
 </td>
 <td>
-<p>Replicas the total number of current GameServer replicas</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>readyReplicas</code></br>
+<code>capacity</code></br>
 <em>
-int32
+int64
 </em>
 </td>
 <td>
-<p>ReadyReplicas are the number of Ready GameServer replicas</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>reservedReplicas</code></br>
+<code>ids</code></br>
 <em>
-int32
+[]string
 </em>
 </td>
 <td>
-<p>ReservedReplicas are the total number of Reserved GameServer replicas in this fleet.
-Reserved instances won&rsquo;t be deleted on scale down, but won&rsquo;t cause an autoscaler to scale up.</p>
 </td>
 </tr>
+</tbody>
+</table>
+<h3 id="agones.dev/v1.PlayersSpec">PlayersSpec
+</h3>
+<p>
+(<em>Appears on:</em>
+<a href="#agones.dev/v1.GameServerSpec">GameServerSpec</a>)
+</p>
+<p>
+<p>PlayersSpec tracks the initial player capacity</p>
+</p>
+<table>
+<thead>
+<tr>
+<th>Field</th>
+<th>Description</th>
+</tr>
+</thead>
+<tbody>
 <tr>
 <td>
-<code>allocatedReplicas</code></br>
+<code>initialCapacity</code></br>
 <em>
-int32
+int64
 </em>
 </td>
 <td>
-<p>AllocatedReplicas are the number of Allocated GameServer replicas</p>
 </td>
 </tr>
+</tbody>
+</table>
+<h3 id="agones.dev/v1.PortPolicy">PortPolicy
+(<code>string</code> alias)</p></h3>
+<p>
+(<em>Appears on:</em>
+<a href="#agones.dev/v1.GameServerPort">GameServerPort</a>)
+</p>
+<p>
+<p>PortPolicy is the port policy for the GameServer</p>
+</p>
+<h3 id="agones.dev/v1.Priority">Priority
+</h3>
+<p>
+(<em>Appears on:</em>
+<a href="#agones.dev/v1.FleetSpec">FleetSpec</a>, 
+<a href="#allocation.agones.dev/v1.GameServerAllocationSpec">GameServerAllocationSpec</a>, 
+<a href="#agones.dev/v1.GameServerSetSpec">GameServerSetSpec</a>)
+</p>
+<p>
+<p>Priority is a sorting option for GameServers with Counters or Lists based on the Capacity.
+Type: 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;. &ldquo;Descending&rdquo; a bigger Capacity is preferred.
+&ldquo;Ascending&rdquo; would be smaller Capacity is preferred.</p>
+</p>
+<table>
+<thead>
+<tr>
+<th>Field</th>
+<th>Description</th>
+</tr>
+</thead>
+<tbody>
 <tr>
 <td>
-<code>players</code></br>
+<code>type</code></br>
 <em>
-<a href="#agones.dev/v1.AggregatedPlayerStatus">
-AggregatedPlayerStatus
-</a>
+string
 </em>
 </td>
 <td>
-<em>(Optional)</em>
-<p>[Stage:Alpha]
-[FeatureFlag:PlayerTracking]
-Players are the current total player capacity and count for this Fleet</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>counters</code></br>
+<code>key</code></br>
 <em>
-<a href="#agones.dev/v1.AggregatedCounterStatus">
-map[string]agones.dev/agones/pkg/apis/agones/v1.AggregatedCounterStatus
-</a>
+string
 </em>
 </td>
 <td>
-<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>lists</code></br>
+<code>order</code></br>
 <em>
-<a href="#agones.dev/v1.AggregatedListStatus">
-map[string]agones.dev/agones/pkg/apis/agones/v1.AggregatedListStatus
-</a>
+string
 </em>
 </td>
 <td>
-<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 id="agones.dev/v1.SdkServer">SdkServer
 </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>SdkServer specifies parameters for the Agones SDK Server sidecar container</p>
 </p>
 <table>
 <thead>
@@ -6411,89 +6293,64 @@ <h3 id="agones.dev/v1.GameServerPort">GameServerPort
 <tbody>
 <tr>
 <td>
-<code>name</code></br>
-<em>
-string
-</em>
-</td>
-<td>
-<p>Name is the descriptive name of the port</p>
-</td>
-</tr>
-<tr>
-<td>
-<code>portPolicy</code></br>
+<code>logLevel</code></br>
 <em>
-<a href="#agones.dev/v1.PortPolicy">
-PortPolicy
+<a href="#agones.dev/v1.SdkServerLogLevel">
+SdkServerLogLevel
 </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>
+<p>LogLevel for SDK server (sidecar) logs. Defaults to &ldquo;Info&rdquo;</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>container</code></br>
+<code>grpcPort</code></br>
 <em>
-string
+int32
 </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>
+<p>GRPCPort is the port on which the SDK Server binds the gRPC server to accept incoming connections</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>containerPort</code></br>
+<code>httpPort</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>
-<em>
-int32
-</em>
-</td>
-<td>
-<p>HostPort the port exposed on the host for clients to connect to</p>
-</td>
-</tr>
-<tr>
-<td>
-<code>protocol</code></br>
-<em>
-<a href="https://v1-26.docs.kubernetes.io/docs/reference/generated/kubernetes-api/v1.26/#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>
+<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.GameServerSetSpec">GameServerSetSpec
-</h3>
+<h3 id="agones.dev/v1.SdkServerLogLevel">SdkServerLogLevel
+(<code>string</code> alias)</p></h3>
 <p>
 (<em>Appears on:</em>
-<a href="#agones.dev/v1.GameServerSet">GameServerSet</a>)
+<a href="#agones.dev/v1.SdkServer">SdkServer</a>)
 </p>
 <p>
-<p>GameServerSetSpec the specification for GameServerSet</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>
@@ -6505,204 +6362,208 @@ <h3 id="agones.dev/v1.GameServerSetSpec">GameServerSetSpec
 <tbody>
 <tr>
 <td>
-<code>replicas</code></br>
-<em>
-int32
-</em>
+<code>apiVersion</code></br>
+string</td>
+<td>
+<code>
+allocation.agones.dev/v1
+</code>
 </td>
+</tr>
+<tr>
 <td>
-<p>Replicas are the number of GameServers that should be in this set</p>
+<code>kind</code></br>
+string
 </td>
+<td><code>GameServerAllocation</code></td>
 </tr>
 <tr>
 <td>
-<code>allocationOverflow</code></br>
+<code>metadata</code></br>
 <em>
-<a href="#agones.dev/v1.AllocationOverflow">
-AllocationOverflow
+<a href="https://v1-26.docs.kubernetes.io/docs/reference/generated/kubernetes-api/v1.26/#objectmeta-v1-meta">
+Kubernetes meta/v1.ObjectMeta
 </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>
+Refer to the Kubernetes API documentation for the fields of the
+<code>metadata</code> field.
 </td>
 </tr>
 <tr>
 <td>
-<code>scheduling</code></br>
+<code>spec</code></br>
 <em>
-agones.dev/agones/pkg/apis.SchedulingStrategy
+<a href="#allocation.agones.dev/v1.GameServerAllocationSpec">
+GameServerAllocationSpec
+</a>
 </em>
 </td>
 <td>
-<p>Scheduling strategy. Defaults to &ldquo;Packed&rdquo;.</p>
-</td>
-</tr>
+<br/>
+<br/>
+<table>
 <tr>
 <td>
-<code>priorities</code></br>
+<code>multiClusterSetting</code></br>
 <em>
-<a href="#agones.dev/v1.Priority">
-[]Priority
+<a href="#allocation.agones.dev/v1.MultiClusterSetting">
+MultiClusterSetting
 </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 Fleetautoscaler will use the first priority for sorting GameServers
-by total Capacity in the Fleet and acts as a tie-breaker after sorting the game servers by
-State and Strategy. Impacts scale down logic.</p>
+<p>MultiClusterPolicySelector if specified, multi-cluster policies are applied.
+Otherwise, allocation will happen locally.</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>template</code></br>
+<code>required</code></br>
 <em>
-<a href="#agones.dev/v1.GameServerTemplateSpec">
-GameServerTemplateSpec
+<a href="#allocation.agones.dev/v1.GameServerSelector">
+GameServerSelector
 </a>
 </em>
 </td>
 <td>
-<p>Template the GameServer template to apply for this GameServerSet</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>
-</tbody>
-</table>
-<h3 id="agones.dev/v1.GameServerSetStatus">GameServerSetStatus
-</h3>
-<p>
-(<em>Appears on:</em>
-<a href="#agones.dev/v1.GameServerSet">GameServerSet</a>)
-</p>
-<p>
-<p>GameServerSetStatus is the status of a GameServerSet</p>
-</p>
-<table>
-<thead>
-<tr>
-<th>Field</th>
-<th>Description</th>
-</tr>
-</thead>
-<tbody>
 <tr>
 <td>
-<code>replicas</code></br>
+<code>preferred</code></br>
 <em>
-int32
+<a href="#allocation.agones.dev/v1.GameServerSelector">
+[]GameServerSelector
+</a>
 </em>
 </td>
 <td>
-<p>Replicas is the total number of current GameServer replicas</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>readyReplicas</code></br>
+<code>priorities</code></br>
 <em>
-int32
+<a href="#agones.dev/v1.Priority">
+[]Priority
+</a>
 </em>
 </td>
 <td>
-<p>ReadyReplicas is the number of Ready GameServer replicas</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 by
+available Capacity in the Selector set. Acts as a tie-breaker after sorting the game servers
+by State and Strategy Packed. Impacts which GameServer is checked first.</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>reservedReplicas</code></br>
+<code>selectors</code></br>
 <em>
-int32
+<a href="#allocation.agones.dev/v1.GameServerSelector">
+[]GameServerSelector
+</a>
 </em>
 </td>
 <td>
-<p>ReservedReplicas is the number of Reserved GameServer replicas</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>allocatedReplicas</code></br>
+<code>scheduling</code></br>
 <em>
-int32
+agones.dev/agones/pkg/apis.SchedulingStrategy
 </em>
 </td>
 <td>
-<p>AllocatedReplicas is the number of Allocated GameServer replicas</p>
+<p>Scheduling strategy. Defaults to &ldquo;Packed&rdquo;.</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>shutdownReplicas</code></br>
+<code>metadata</code></br>
 <em>
-int32
+<a href="#allocation.agones.dev/v1.MetaPatch">
+MetaPatch
+</a>
 </em>
 </td>
 <td>
-<p>ShutdownReplicas is the number of Shutdown GameServers replicas</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>players</code></br>
+<code>counters</code></br>
 <em>
-<a href="#agones.dev/v1.AggregatedPlayerStatus">
-AggregatedPlayerStatus
+<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>[Stage:Alpha]
-[FeatureFlag:PlayerTracking]
-Players is the current total player capacity and count for this GameServerSet</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>counters</code></br>
+<code>lists</code></br>
 <em>
-<a href="#agones.dev/v1.AggregatedCounterStatus">
-map[string]agones.dev/agones/pkg/apis/agones/v1.AggregatedCounterStatus
+<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>(Alpha, CountsAndLists feature flag) Counters provides aggregated Counter capacity and Counter
-count for this GameServerSet.</p>
+</td>
+</tr>
+</table>
 </td>
 </tr>
 <tr>
 <td>
-<code>lists</code></br>
+<code>status</code></br>
 <em>
-<a href="#agones.dev/v1.AggregatedListStatus">
-map[string]agones.dev/agones/pkg/apis/agones/v1.AggregatedListStatus
+<a href="#allocation.agones.dev/v1.GameServerAllocationStatus">
+GameServerAllocationStatus
 </a>
 </em>
 </td>
 <td>
-<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.GameServerSpec">GameServerSpec
+<h3 id="allocation.agones.dev/v1.CounterAction">CounterAction
 </h3>
 <p>
 (<em>Appears on:</em>
-<a href="#agones.dev/v1.GameServer">GameServer</a>, 
-<a href="#agones.dev/v1.GameServerTemplateSpec">GameServerTemplateSpec</a>)
+<a href="#allocation.agones.dev/v1.GameServerAllocationSpec">GameServerAllocationSpec</a>)
 </p>
 <p>
-<p>GameServerSpec is the spec for a GameServer resource</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>
@@ -6714,114 +6575,79 @@ <h3 id="agones.dev/v1.GameServerSpec">GameServerSpec
 <tbody>
 <tr>
 <td>
-<code>container</code></br>
+<code>action</code></br>
 <em>
 string
 </em>
 </td>
 <td>
-<p>Container specifies which Pod container is the game server. Only required if there is more than one
-container defined</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>ports</code></br>
+<code>amount</code></br>
 <em>
-<a href="#agones.dev/v1.GameServerPort">
-[]GameServerPort
-</a>
+int64
 </em>
 </td>
 <td>
-<p>Ports are the array of ports that can be exposed via the game server</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>health</code></br>
+<code>capacity</code></br>
 <em>
-<a href="#agones.dev/v1.Health">
-Health
-</a>
+int64
 </em>
 </td>
 <td>
-<p>Health configures health checking</p>
 </td>
 </tr>
+</tbody>
+</table>
+<h3 id="allocation.agones.dev/v1.CounterSelector">CounterSelector
+</h3>
+<p>
+(<em>Appears on:</em>
+<a href="#allocation.agones.dev/v1.GameServerSelector">GameServerSelector</a>)
+</p>
+<p>
+<p>CounterSelector is the filter options for a GameServer based on the count and/or available capacity.
+0 for MaxCount or MaxAvailable means unlimited maximum. Default for all fields: 0</p>
+</p>
+<table>
+<thead>
 <tr>
-<td>
-<code>scheduling</code></br>
-<em>
-agones.dev/agones/pkg/apis.SchedulingStrategy
-</em>
-</td>
-<td>
-<p>Scheduling strategy. Defaults to &ldquo;Packed&rdquo;</p>
-</td>
-</tr>
-<tr>
-<td>
-<code>sdkServer</code></br>
-<em>
-<a href="#agones.dev/v1.SdkServer">
-SdkServer
-</a>
-</em>
-</td>
-<td>
-<p>SdkServer specifies parameters for the Agones SDK Server sidecar container</p>
-</td>
-</tr>
-<tr>
-<td>
-<code>template</code></br>
-<em>
-<a href="https://v1-26.docs.kubernetes.io/docs/reference/generated/kubernetes-api/v1.26/#podtemplatespec-v1-core">
-Kubernetes core/v1.PodTemplateSpec
-</a>
-</em>
-</td>
-<td>
-<p>Template describes the Pod that will be created for the GameServer</p>
-</td>
+<th>Field</th>
+<th>Description</th>
 </tr>
+</thead>
+<tbody>
 <tr>
 <td>
-<code>players</code></br>
+<code>minCount</code></br>
 <em>
-<a href="#agones.dev/v1.PlayersSpec">
-PlayersSpec
-</a>
+int64
 </em>
 </td>
 <td>
-<em>(Optional)</em>
-<p>(Alpha, PlayerTracking feature flag) Players provides the configuration for player tracking features.</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>counters</code></br>
+<code>maxCount</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>minAvailable</code></br>
 <em>
-<a href="#agones.dev/v1.ListStatus">
-map[string]agones.dev/agones/pkg/apis/agones/v1.ListStatus
-</a>
+int64
 </em>
 </td>
 <td>
@@ -6829,38 +6655,24 @@ <h3 id="agones.dev/v1.GameServerSpec">GameServerSpec
 </tr>
 <tr>
 <td>
-<code>eviction</code></br>
+<code>maxAvailable</code></br>
 <em>
-<a href="#agones.dev/v1.Eviction">
-Eviction
-</a>
+int64
 </em>
 </td>
 <td>
-<em>(Optional)</em>
-<p>Eviction specifies the eviction tolerance of the GameServer. Defaults to &ldquo;Never&rdquo;.</p>
 </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="allocation.agones.dev/v1.GameServerAllocationSpec">GameServerAllocationSpec
 </h3>
 <p>
 (<em>Appears on:</em>
-<a href="#agones.dev/v1.GameServer">GameServer</a>)
+<a href="#allocation.agones.dev/v1.GameServerAllocation">GameServerAllocation</a>)
 </p>
 <p>
-<p>GameServerStatus is the status for a GameServer resource</p>
+<p>GameServerAllocationSpec is the spec for a GameServerAllocation</p>
 </p>
 <table>
 <thead>
@@ -6872,129 +6684,155 @@ <h3 id="agones.dev/v1.GameServerStatus">GameServerStatus
 <tbody>
 <tr>
 <td>
-<code>state</code></br>
+<code>multiClusterSetting</code></br>
 <em>
-<a href="#agones.dev/v1.GameServerState">
-GameServerState
+<a href="#allocation.agones.dev/v1.MultiClusterSetting">
+MultiClusterSetting
 </a>
 </em>
 </td>
 <td>
-<p>GameServerState is the current state of a GameServer, e.g. Creating, Starting, Ready, etc</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.GameServerStatusPort">
-[]GameServerStatusPort
+<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>address</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>
 <tr>
 <td>
-<code>nodeName</code></br>
+<code>priorities</code></br>
 <em>
-string
+<a href="#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 by
+available Capacity in the Selector set. Acts as a tie-breaker after sorting the game servers
+by State and Strategy Packed. Impacts which GameServer is checked first.</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>reservedUntil</code></br>
+<code>selectors</code></br>
 <em>
-<a href="https://v1-26.docs.kubernetes.io/docs/reference/generated/kubernetes-api/v1.26/#time-v1-meta">
-Kubernetes meta/v1.Time
+<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>players</code></br>
+<code>scheduling</code></br>
 <em>
-<a href="#agones.dev/v1.PlayerStatus">
-PlayerStatus
-</a>
+agones.dev/agones/pkg/apis.SchedulingStrategy
 </em>
 </td>
 <td>
-<em>(Optional)</em>
-<p>[Stage:Alpha]
-[FeatureFlag:PlayerTracking]</p>
+<p>Scheduling strategy. Defaults to &ldquo;Packed&rdquo;.</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>counters</code></br>
+<code>metadata</code></br>
 <em>
-<a href="#agones.dev/v1.CounterStatus">
-map[string]agones.dev/agones/pkg/apis/agones/v1.CounterStatus
+<a href="#allocation.agones.dev/v1.MetaPatch">
+MetaPatch
 </a>
 </em>
 </td>
 <td>
-<em>(Optional)</em>
-<p>(Alpha, CountsAndLists feature flag) Counters and Lists provides the configuration for generic tracking features.</p>
+<p>MetaPatch is optional custom metadata that is added to the game server at allocation
+You can use this to tell the server necessary session data</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>lists</code></br>
+<code>counters</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.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>eviction</code></br>
+<code>lists</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.</p>
 </td>
 </tr>
 </tbody>
 </table>
-<h3 id="agones.dev/v1.GameServerStatusPort">GameServerStatusPort
+<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.GameServerAllocationStatus">GameServerAllocationStatus</a>, 
-<a href="#agones.dev/v1.GameServerStatus">GameServerStatus</a>)
+<a href="#allocation.agones.dev/v1.GameServerAllocation">GameServerAllocation</a>)
 </p>
 <p>
-<p>GameServerStatusPort shows the port that was allocated to a
-GameServer.</p>
+<p>GameServerAllocationStatus is the status for an GameServerAllocation resource</p>
 </p>
 <table>
 <thead>
@@ -7006,213 +6844,237 @@ <h3 id="agones.dev/v1.GameServerStatusPort">GameServerStatusPort
 <tbody>
 <tr>
 <td>
-<code>name</code></br>
+<code>state</code></br>
 <em>
-string
+<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>port</code></br>
+<code>gameServerName</code></br>
 <em>
-int32
+string
 </em>
 </td>
 <td>
 </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>
-<th>Field</th>
-<th>Description</th>
-</tr>
-</thead>
-<tbody>
 <tr>
 <td>
-<code>metadata</code></br>
+<code>ports</code></br>
 <em>
-<a href="https://v1-26.docs.kubernetes.io/docs/reference/generated/kubernetes-api/v1.26/#objectmeta-v1-meta">
-Kubernetes meta/v1.ObjectMeta
+<a href="#agones.dev/v1.GameServerStatusPort">
+[]GameServerStatusPort
 </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>
+<code>address</code></br>
 <em>
-<a href="#agones.dev/v1.GameServerSpec">
-GameServerSpec
-</a>
+string
 </em>
 </td>
 <td>
-<br/>
-<br/>
-<table>
+</td>
+</tr>
 <tr>
 <td>
-<code>container</code></br>
+<code>nodeName</code></br>
 <em>
 string
 </em>
 </td>
 <td>
-<p>Container specifies which Pod container is the game server. Only required if there is more than one
-container defined</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>ports</code></br>
+<code>source</code></br>
 <em>
-<a href="#agones.dev/v1.GameServerPort">
-[]GameServerPort
-</a>
+string
 </em>
 </td>
 <td>
-<p>Ports are the array of ports that can be exposed via the game server</p>
+<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>
 <tr>
 <td>
-<code>health</code></br>
+<code>metadata</code></br>
 <em>
-<a href="#agones.dev/v1.Health">
-Health
+<a href="#allocation.agones.dev/v1.GameServerMetadata">
+GameServerMetadata
 </a>
 </em>
 </td>
 <td>
-<p>Health configures health checking</p>
 </td>
 </tr>
-<tr>
-<td>
-<code>scheduling</code></br>
+</tbody>
+</table>
+<h3 id="allocation.agones.dev/v1.GameServerMetadata">GameServerMetadata
+</h3>
+<p>
+(<em>Appears on:</em>
+<a href="#allocation.agones.dev/v1.GameServerAllocationStatus">GameServerAllocationStatus</a>)
+</p>
+<p>
+<p>GameServerMetadata is the metadata from the allocated game server at allocation time</p>
+</p>
+<table>
+<thead>
+<tr>
+<th>Field</th>
+<th>Description</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td>
+<code>labels</code></br>
 <em>
-agones.dev/agones/pkg/apis.SchedulingStrategy
+map[string]string
 </em>
 </td>
 <td>
-<p>Scheduling strategy. Defaults to &ldquo;Packed&rdquo;</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>sdkServer</code></br>
+<code>annotations</code></br>
 <em>
-<a href="#agones.dev/v1.SdkServer">
-SdkServer
-</a>
+map[string]string
 </em>
 </td>
 <td>
-<p>SdkServer specifies parameters for the Agones SDK Server sidecar container</p>
 </td>
 </tr>
+</tbody>
+</table>
+<h3 id="allocation.agones.dev/v1.GameServerSelector">GameServerSelector
+</h3>
+<p>
+(<em>Appears on:</em>
+<a href="#allocation.agones.dev/v1.GameServerAllocationSpec">GameServerAllocationSpec</a>)
+</p>
+<p>
+<p>GameServerSelector contains all the filter options for selecting
+a GameServer for allocation.</p>
+</p>
+<table>
+<thead>
+<tr>
+<th>Field</th>
+<th>Description</th>
+</tr>
+</thead>
+<tbody>
 <tr>
 <td>
-<code>template</code></br>
+<code>LabelSelector</code></br>
 <em>
-<a href="https://v1-26.docs.kubernetes.io/docs/reference/generated/kubernetes-api/v1.26/#podtemplatespec-v1-core">
-Kubernetes core/v1.PodTemplateSpec
+<a href="https://v1-26.docs.kubernetes.io/docs/reference/generated/kubernetes-api/v1.26/#labelselector-v1-meta">
+Kubernetes meta/v1.LabelSelector
 </a>
 </em>
 </td>
 <td>
-<p>Template describes the Pod that will be created for the GameServer</p>
+<p>
+(Members of <code>LabelSelector</code> are embedded into this type.)
+</p>
+<p>See: <a href="https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/">https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/</a></p>
 </td>
 </tr>
 <tr>
 <td>
-<code>players</code></br>
+<code>gameServerState</code></br>
 <em>
-<a href="#agones.dev/v1.PlayersSpec">
-PlayersSpec
+<a href="#agones.dev/v1.GameServerState">
+GameServerState
 </a>
 </em>
 </td>
 <td>
 <em>(Optional)</em>
-<p>(Alpha, PlayerTracking feature flag) Players provides the configuration for player tracking features.</p>
+<p>[Stage:Beta]
+[FeatureFlag:StateAllocationFilter]
+GameServerState specifies which State is the filter to be used when attempting to retrieve a GameServer
+via Allocation. Defaults to &ldquo;Ready&rdquo;. The only other option is &ldquo;Allocated&rdquo;, which can be used in conjunction with
+label/annotation/player selectors to retrieve an already Allocated GameServer.</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>counters</code></br>
+<code>players</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.PlayerSelector">
+PlayerSelector
 </a>
 </em>
 </td>
 <td>
 <em>(Optional)</em>
-<p>(Alpha, CountsAndLists feature flag) Counters and Lists provides the configuration for generic tracking features.</p>
+<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>lists</code></br>
+<code>counters</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.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>eviction</code></br>
+<code>lists</code></br>
 <em>
-<a href="#agones.dev/v1.Eviction">
-Eviction
+<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>Eviction specifies the eviction tolerance of the GameServer. Defaults to &ldquo;Never&rdquo;.</p>
-</td>
-</tr>
-</table>
+<p>(Alpha, CountsAndLists feature flag) Lists provides filters on minimum and maximum values
+for List capacity, and for the existence of a value in a List, when retrieving a GameServer
+through Allocation. Defaults to no limits.</p>
 </td>
 </tr>
 </tbody>
 </table>
-<h3 id="agones.dev/v1.Health">Health
+<h3 id="allocation.agones.dev/v1.ListAction">ListAction
 </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>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>
@@ -7224,59 +7086,37 @@ <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>
-<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>
+<code>addValues</code></br>
 <em>
-int32
+[]string
 </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.ListSelector">ListSelector
 </h3>
 <p>
 (<em>Appears on:</em>
-<a href="#agones.dev/v1.GameServerSpec">GameServerSpec</a>, 
-<a href="#agones.dev/v1.GameServerStatus">GameServerStatus</a>)
+<a href="#allocation.agones.dev/v1.GameServerSelector">GameServerSelector</a>)
 </p>
 <p>
-<p>ListStatus stores the current list values</p>
+<p>ListSelector is the filter options for a GameServer based on List available capacity and/or the
+existence of a value in a List.
+0 for MaxAvailable means unlimited maximum. Default for integer fields: 0
+&ldquo;&rdquo; for ContainsValue means ignore field. Default for string field: &ldquo;&rdquo;</p>
 </p>
 <table>
 <thead>
@@ -7288,7 +7128,17 @@ <h3 id="agones.dev/v1.ListStatus">ListStatus
 <tbody>
 <tr>
 <td>
-<code>capacity</code></br>
+<code>containsValue</code></br>
+<em>
+string
+</em>
+</td>
+<td>
+</td>
+</tr>
+<tr>
+<td>
+<code>minAvailable</code></br>
 <em>
 int64
 </em>
@@ -7298,9 +7148,9 @@ <h3 id="agones.dev/v1.ListStatus">ListStatus
 </tr>
 <tr>
 <td>
-<code>values</code></br>
+<code>maxAvailable</code></br>
 <em>
-[]string
+int64
 </em>
 </td>
 <td>
@@ -7308,14 +7158,14 @@ <h3 id="agones.dev/v1.ListStatus">ListStatus
 </tr>
 </tbody>
 </table>
-<h3 id="agones.dev/v1.PlayerStatus">PlayerStatus
+<h3 id="allocation.agones.dev/v1.MetaPatch">MetaPatch
 </h3>
 <p>
 (<em>Appears on:</em>
-<a href="#agones.dev/v1.GameServerStatus">GameServerStatus</a>)
+<a href="#allocation.agones.dev/v1.GameServerAllocationSpec">GameServerAllocationSpec</a>)
 </p>
 <p>
-<p>PlayerStatus stores the current player capacity values</p>
+<p>MetaPatch is the metadata used to patch the GameServer metadata on allocation</p>
 </p>
 <table>
 <thead>
@@ -7327,19 +7177,9 @@ <h3 id="agones.dev/v1.PlayerStatus">PlayerStatus
 <tbody>
 <tr>
 <td>
-<code>count</code></br>
-<em>
-int64
-</em>
-</td>
-<td>
-</td>
-</tr>
-<tr>
-<td>
-<code>capacity</code></br>
+<code>labels</code></br>
 <em>
-int64
+map[string]string
 </em>
 </td>
 <td>
@@ -7347,9 +7187,9 @@ <h3 id="agones.dev/v1.PlayerStatus">PlayerStatus
 </tr>
 <tr>
 <td>
-<code>ids</code></br>
+<code>annotations</code></br>
 <em>
-[]string
+map[string]string
 </em>
 </td>
 <td>
@@ -7357,14 +7197,14 @@ <h3 id="agones.dev/v1.PlayerStatus">PlayerStatus
 </tr>
 </tbody>
 </table>
-<h3 id="agones.dev/v1.PlayersSpec">PlayersSpec
+<h3 id="allocation.agones.dev/v1.MultiClusterSetting">MultiClusterSetting
 </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>PlayersSpec tracks the initial player capacity</p>
+<p>MultiClusterSetting specifies settings for multi-cluster allocation.</p>
 </p>
 <table>
 <thead>
@@ -7376,9 +7216,21 @@ <h3 id="agones.dev/v1.PlayersSpec">PlayersSpec
 <tbody>
 <tr>
 <td>
-<code>initialCapacity</code></br>
+<code>enabled</code></br>
 <em>
-int64
+bool
+</em>
+</td>
+<td>
+</td>
+</tr>
+<tr>
+<td>
+<code>policySelector</code></br>
+<em>
+<a href="https://v1-26.docs.kubernetes.io/docs/reference/generated/kubernetes-api/v1.26/#labelselector-v1-meta">
+Kubernetes meta/v1.LabelSelector
+</a>
 </em>
 </td>
 <td>
@@ -7386,29 +7238,14 @@ <h3 id="agones.dev/v1.PlayersSpec">PlayersSpec
 </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.Priority">Priority
+<h3 id="allocation.agones.dev/v1.PlayerSelector">PlayerSelector
 </h3>
 <p>
 (<em>Appears on:</em>
-<a href="#agones.dev/v1.FleetSpec">FleetSpec</a>, 
-<a href="#allocation.agones.dev/v1.GameServerAllocationSpec">GameServerAllocationSpec</a>, 
-<a href="#agones.dev/v1.GameServerSetSpec">GameServerSetSpec</a>)
+<a href="#allocation.agones.dev/v1.GameServerSelector">GameServerSelector</a>)
 </p>
 <p>
-<p>Priority is a sorting option for GameServers with Counters or Lists based on the Capacity.
-Type: 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;. &ldquo;Descending&rdquo; a bigger Capacity is preferred.
-&ldquo;Ascending&rdquo; would be smaller Capacity is preferred.</p>
+<p>PlayerSelector is the filter options for a GameServer based on player counts</p>
 </p>
 <table>
 <thead>
@@ -7420,9 +7257,9 @@ <h3 id="agones.dev/v1.Priority">Priority
 <tbody>
 <tr>
 <td>
-<code>type</code></br>
+<code>minAvailable</code></br>
 <em>
-string
+int64
 </em>
 </td>
 <td>
@@ -7430,19 +7267,129 @@ <h3 id="agones.dev/v1.Priority">Priority
 </tr>
 <tr>
 <td>
-<code>key</code></br>
+<code>maxAvailable</code></br>
 <em>
-string
+int64
 </em>
 </td>
 <td>
 </td>
 </tr>
-<tr>
-<td>
-<code>order</code></br>
-<em>
-string
+</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-26.docs.kubernetes.io/docs/reference/generated/kubernetes-api/v1.26/#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>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>
@@ -7450,14 +7397,14 @@ <h3 id="agones.dev/v1.Priority">Priority
 </tr>
 </tbody>
 </table>
-<h3 id="agones.dev/v1.SdkServer">SdkServer
+<h3 id="autoscaling.agones.dev/v1.BufferPolicy">BufferPolicy
 </h3>
 <p>
 (<em>Appears on:</em>
-<a href="#agones.dev/v1.GameServerSpec">GameServerSpec</a>)
+<a href="#autoscaling.agones.dev/v1.FleetAutoscalerPolicy">FleetAutoscalerPolicy</a>)
 </p>
 <p>
-<p>SdkServer specifies parameters for the Agones SDK Server sidecar container</p>
+<p>BufferPolicy controls the desired behavior of the buffer policy.</p>
 </p>
 <table>
 <thead>
@@ -7469,64 +7416,59 @@ <h3 id="agones.dev/v1.SdkServer">SdkServer
 <tbody>
 <tr>
 <td>
-<code>logLevel</code></br>
+<code>maxReplicas</code></br>
 <em>
-<a href="#agones.dev/v1.SdkServerLogLevel">
-SdkServerLogLevel
-</a>
+int32
 </em>
 </td>
 <td>
-<p>LogLevel for SDK server (sidecar) logs. Defaults to &ldquo;Info&rdquo;</p>
+<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>grpcPort</code></br>
+<code>minReplicas</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>
+<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>httpPort</code></br>
+<code>bufferSize</code></br>
 <em>
-int32
+k8s.io/apimachinery/pkg/util/intstr.IntOrString
 </em>
 </td>
 <td>
-<p>HTTPPort is the port on which the SDK Server binds the HTTP gRPC gateway server to accept incoming connections</p>
+<p>BufferSize defines how many replicas the autoscaler tries to have ready all the time
+Value can be an absolute number (ex: 5) or a percentage of desired gs instances (ex: 15%)
+Absolute number is calculated from percentage by rounding up.
+Example: when this is set to 20%, the autoscaler will make sure that 20%
+of the fleet&rsquo;s game server replicas are ready. When this is set to 20,
+the autoscaler will make sure that there are 20 available game servers
+Must be bigger than 0
+Note: by &ldquo;ready&rdquo; we understand in this case &ldquo;non-allocated&rdquo;; this is done to ensure robustness
+and computation stability in different edge case (fleet just created, not enough
+capacity in the cluster etc)</p>
 </td>
 </tr>
 </tbody>
 </table>
-<h3 id="agones.dev/v1.SdkServerLogLevel">SdkServerLogLevel
-(<code>string</code> alias)</p></h3>
+<h3 id="autoscaling.agones.dev/v1.CounterPolicy">CounterPolicy
+</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="#autoscaling.agones.dev/v1.FleetAutoscalerPolicy">FleetAutoscalerPolicy</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>CounterPolicy controls the desired behavior of the Counter autoscaler policy.</p>
 </p>
 <table>
 <thead>
@@ -7538,189 +7480,239 @@ <h3 id="allocation.agones.dev/v1.GameServerAllocation">GameServerAllocation
 <tbody>
 <tr>
 <td>
-<code>apiVersion</code></br>
-string</td>
+<code>key</code></br>
+<em>
+string
+</em>
+</td>
 <td>
-<code>
-allocation.agones.dev/v1
-</code>
+<p>Key is the name of the Counter. Required field.</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>kind</code></br>
-string
+<code>maxCapacity</code></br>
+<em>
+int64
+</em>
+</td>
+<td>
+<p>MaxCapacity is the maximum aggregate Counter total capacity across the fleet.
+MaxCapacity must be bigger than both MinCapacity and BufferSize. Required field.</p>
 </td>
-<td><code>GameServerAllocation</code></td>
 </tr>
 <tr>
 <td>
-<code>metadata</code></br>
+<code>minCapacity</code></br>
 <em>
-<a href="https://v1-26.docs.kubernetes.io/docs/reference/generated/kubernetes-api/v1.26/#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.
+<p>MinCapacity is the minimum aggregate Counter total capacity across the fleet.
+If zero, MinCapacity is ignored.
+If non zero, MinCapacity must be smaller than MaxCapacity and bigger than BufferSize.</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>spec</code></br>
+<code>bufferSize</code></br>
 <em>
-<a href="#allocation.agones.dev/v1.GameServerAllocationSpec">
-GameServerAllocationSpec
-</a>
+k8s.io/apimachinery/pkg/util/intstr.IntOrString
 </em>
 </td>
 <td>
-<br/>
-<br/>
+<p>BufferSize is the size of a buffer of counted items that are available in the Fleet (available
+capacity). Value can be an absolute number (ex: 5) or a percentage of desired gs instances
+(ex: 5%). An absolute number is calculated from percentage by rounding up.
+Must be bigger than 0. Required field.</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>multiClusterSetting</code></br>
+<code>seconds</code></br>
 <em>
-<a href="#allocation.agones.dev/v1.MultiClusterSetting">
-MultiClusterSetting
-</a>
+int32
 </em>
 </td>
 <td>
-<p>MultiClusterPolicySelector if specified, multi-cluster policies are applied.
-Otherwise, allocation will happen locally.</p>
+<p>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>required</code></br>
+<code>uid</code></br>
 <em>
-<a href="#allocation.agones.dev/v1.GameServerSelector">
-GameServerSelector
-</a>
+k8s.io/apimachinery/pkg/types.UID
 </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>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>preferred</code></br>
+<code>name</code></br>
 <em>
-<a href="#allocation.agones.dev/v1.GameServerSelector">
-[]GameServerSelector
-</a>
+string
 </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>Name is the name of the Fleet being scaled</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>priorities</code></br>
+<code>namespace</code></br>
 <em>
-<a href="#agones.dev/v1.Priority">
-[]Priority
-</a>
+string
 </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 by
-available Capacity in the Selector set and acts as a tie-breaker after sorting the game servers
-by State and Strategy. Impacts which GameServer is checked first.</p>
+<p>Namespace is the namespace associated with the request (if any).</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>selectors</code></br>
+<code>status</code></br>
 <em>
-<a href="#allocation.agones.dev/v1.GameServerSelector">
-[]GameServerSelector
+<a href="#agones.dev/v1.FleetStatus">
+FleetStatus
 </a>
 </em>
 </td>
 <td>
-<p>Ordered list of GameServer label selectors.
-If the first selector is not matched, the selection attempts the second selector, and so on.
-This is useful for things like smoke testing of new game servers.
-Note: This field can only be set if neither Required or Preferred is set.</p>
+<p>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>scheduling</code></br>
+<code>uid</code></br>
 <em>
-agones.dev/agones/pkg/apis.SchedulingStrategy
+k8s.io/apimachinery/pkg/types.UID
 </em>
 </td>
 <td>
-<p>Scheduling strategy. Defaults to &ldquo;Packed&rdquo;.</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>metadata</code></br>
+<code>scale</code></br>
 <em>
-<a href="#allocation.agones.dev/v1.MetaPatch">
-MetaPatch
-</a>
+bool
 </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>Set to false if no scaling should occur to the Fleet</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>counters</code></br>
+<code>replicas</code></br>
 <em>
-<a href="#allocation.agones.dev/v1.CounterAction">
-map[string]agones.dev/agones/pkg/apis/allocation/v1.CounterAction
-</a>
+int32
 </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>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>lists</code></br>
+<code>request</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.FleetAutoscaleRequest">
+FleetAutoscaleRequest
 </a>
 </em>
 </td>
 <td>
 </td>
 </tr>
-</table>
-</td>
-</tr>
 <tr>
 <td>
-<code>status</code></br>
+<code>response</code></br>
 <em>
-<a href="#allocation.agones.dev/v1.GameServerAllocationStatus">
-GameServerAllocationStatus
+<a href="#autoscaling.agones.dev/v1.FleetAutoscaleResponse">
+FleetAutoscaleResponse
 </a>
 </em>
 </td>
@@ -7729,17 +7721,14 @@ <h3 id="allocation.agones.dev/v1.GameServerAllocation">GameServerAllocation
 </tr>
 </tbody>
 </table>
-<h3 id="allocation.agones.dev/v1.CounterAction">CounterAction
+<h3 id="autoscaling.agones.dev/v1.FleetAutoscalerPolicy">FleetAutoscalerPolicy
 </h3>
 <p>
 (<em>Appears on:</em>
-<a href="#allocation.agones.dev/v1.GameServerAllocationSpec">GameServerAllocationSpec</a>)
+<a href="#autoscaling.agones.dev/v1.FleetAutoscalerSpec">FleetAutoscalerSpec</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>FleetAutoscalerPolicy describes how to scale a fleet</p>
 </p>
 <table>
 <thead>
@@ -7751,45 +7740,97 @@ <h3 id="allocation.agones.dev/v1.CounterAction">CounterAction
 <tbody>
 <tr>
 <td>
-<code>action</code></br>
+<code>type</code></br>
 <em>
-string
+<a href="#autoscaling.agones.dev/v1.FleetAutoscalerPolicyType">
+FleetAutoscalerPolicyType
+</a>
 </em>
 </td>
 <td>
+<p>Type of autoscaling policy.</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>amount</code></br>
+<code>buffer</code></br>
 <em>
-int64
+<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>capacity</code></br>
+<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>
+<tr>
+<td>
+<code>counter</code></br>
+<em>
+<a href="#autoscaling.agones.dev/v1.CounterPolicy">
+CounterPolicy
+</a>
+</em>
+</td>
+<td>
+<em>(Optional)</em>
+<p>[Stage:Alpha]
+[FeatureFlag:CountsAndLists]
+Counter policy config params. Present only if FleetAutoscalerPolicyType = Counter.</p>
+</td>
+</tr>
+<tr>
+<td>
+<code>list</code></br>
+<em>
+<a href="#autoscaling.agones.dev/v1.ListPolicy">
+ListPolicy
+</a>
+</em>
+</td>
+<td>
+<em>(Optional)</em>
+<p>[Stage:Alpha]
+[FeatureFlag:CountsAndLists]
+List policy config params. Present only if FleetAutoscalerPolicyType = List.</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>
@@ -7801,19 +7842,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>
@@ -7821,34 +7852,41 @@ <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>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>
@@ -7860,155 +7898,130 @@ <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="#agones.dev/v1.Priority">
-[]Priority
+<a href="https://v1-26.docs.kubernetes.io/docs/reference/generated/kubernetes-api/v1.26/#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 by
-available Capacity in the Selector set and acts as a tie-breaker after sorting the game servers
-by State and Strategy. 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.ListPolicy">ListPolicy
 </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>ListPolicy controls the desired behavior of the List autoscaler policy.</p>
 </p>
 <table>
 <thead>
@@ -8020,93 +8033,150 @@ <h3 id="allocation.agones.dev/v1.GameServerAllocationStatus">GameServerAllocatio
 <tbody>
 <tr>
 <td>
-<code>state</code></br>
+<code>key</code></br>
 <em>
-<a href="#allocation.agones.dev/v1.GameServerAllocationState">
-GameServerAllocationState
-</a>
+string
 </em>
 </td>
 <td>
-<p>GameServerState is the current state of an GameServerAllocation, e.g. Allocated, or UnAllocated</p>
+<p>Key is the name of the List. Required field.</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>gameServerName</code></br>
+<code>maxCapacity</code></br>
 <em>
-string
+int64
 </em>
 </td>
 <td>
+<p>MaxCapacity is the maximum aggregate List total capacity across the fleet.
+MaxCapacity must be bigger than both MinCapacity and BufferSize. Required field.</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>ports</code></br>
+<code>minCapacity</code></br>
 <em>
-<a href="#agones.dev/v1.GameServerStatusPort">
-[]GameServerStatusPort
-</a>
+int64
 </em>
 </td>
 <td>
+<p>MinCapacity is the minimum aggregate List total capacity across the fleet.
+If zero, it is ignored.
+If non zero, it must be smaller than MaxCapacity and bigger than BufferSize.</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>address</code></br>
+<code>bufferSize</code></br>
 <em>
-string
+k8s.io/apimachinery/pkg/util/intstr.IntOrString
 </em>
 </td>
 <td>
+<p>BufferSize is the size of a buffer based on the List capacity that is available over the
+current aggregate List length in the Fleet (available capacity). It can be specified either
+as an absolute value (i.e. 5) or percentage format (i.e. 5%).
+Must be bigger than 0. Required field.</p>
 </td>
 </tr>
+</tbody>
+</table>
+<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>
+</tr>
+</thead>
+<tbody>
 <tr>
 <td>
-<code>nodeName</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>source</code></br>
+<code>service</code></br>
 <em>
-string
+<a href="https://v1-26.docs.kubernetes.io/docs/reference/generated/kubernetes-api/v1.26/#servicereference-v1-admissionregistration">
+Kubernetes admissionregistration/v1.ServiceReference
+</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><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>metadata</code></br>
+<code>caBundle</code></br>
 <em>
-<a href="#allocation.agones.dev/v1.GameServerMetadata">
-GameServerMetadata
-</a>
+[]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>
-<h3 id="allocation.agones.dev/v1.GameServerMetadata">GameServerMetadata
-</h3>
+<hr/>
+<h2 id="multicluster.agones.dev/v1">multicluster.agones.dev/v1</h2>
 <p>
-(<em>Appears on:</em>
-<a href="#allocation.agones.dev/v1.GameServerAllocationStatus">GameServerAllocationStatus</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>GameServerMetadata is the metadata from the allocated game server at allocation time</p>
+<p>GameServerAllocationPolicy is the Schema for the gameserverallocationpolicies API</p>
 </p>
 <table>
 <thead>
@@ -8118,139 +8188,93 @@ <h3 id="allocation.agones.dev/v1.GameServerMetadata">GameServerMetadata
 <tbody>
 <tr>
 <td>
-<code>labels</code></br>
-<em>
-map[string]string
-</em>
-</td>
+<code>apiVersion</code></br>
+string</td>
 <td>
+<code>
+multicluster.agones.dev/v1
+</code>
 </td>
 </tr>
 <tr>
 <td>
-<code>annotations</code></br>
-<em>
-map[string]string
-</em>
-</td>
-<td>
+<code>kind</code></br>
+string
 </td>
+<td><code>GameServerAllocationPolicy</code></td>
 </tr>
-</tbody>
-</table>
-<h3 id="allocation.agones.dev/v1.GameServerSelector">GameServerSelector
-</h3>
-<p>
-(<em>Appears on:</em>
-<a href="#allocation.agones.dev/v1.GameServerAllocationSpec">GameServerAllocationSpec</a>)
-</p>
-<p>
-<p>GameServerSelector contains all the filter options for selecting
-a GameServer for allocation.</p>
-</p>
-<table>
-<thead>
-<tr>
-<th>Field</th>
-<th>Description</th>
-</tr>
-</thead>
-<tbody>
 <tr>
 <td>
-<code>LabelSelector</code></br>
+<code>metadata</code></br>
 <em>
-<a href="https://v1-26.docs.kubernetes.io/docs/reference/generated/kubernetes-api/v1.26/#labelselector-v1-meta">
-Kubernetes meta/v1.LabelSelector
+<a href="https://v1-26.docs.kubernetes.io/docs/reference/generated/kubernetes-api/v1.26/#objectmeta-v1-meta">
+Kubernetes meta/v1.ObjectMeta
 </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>
+Refer to the Kubernetes API documentation for the fields of the
+<code>metadata</code> field.
 </td>
 </tr>
 <tr>
 <td>
-<code>gameServerState</code></br>
+<code>spec</code></br>
 <em>
-<a href="#agones.dev/v1.GameServerState">
-GameServerState
+<a href="#multicluster.agones.dev/v1.GameServerAllocationPolicySpec">
+GameServerAllocationPolicySpec
 </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>
+<br/>
+<br/>
+<table>
 <tr>
 <td>
-<code>players</code></br>
+<code>priority</code></br>
 <em>
-<a href="#allocation.agones.dev/v1.PlayerSelector">
-PlayerSelector
-</a>
+int32
 </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>
+<code>weight</code></br>
 <em>
-<a href="#allocation.agones.dev/v1.CounterSelector">
-map[string]agones.dev/agones/pkg/apis/allocation/v1.CounterSelector
-</a>
+int
 </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>
+<code>connectionInfo</code></br>
 <em>
-<a href="#allocation.agones.dev/v1.ListSelector">
-map[string]agones.dev/agones/pkg/apis/allocation/v1.ListSelector
+<a href="#multicluster.agones.dev/v1.ClusterConnectionInfo">
+ClusterConnectionInfo
 </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>
+</table>
 </td>
 </tr>
 </tbody>
 </table>
-<h3 id="allocation.agones.dev/v1.ListAction">ListAction
+<h3 id="multicluster.agones.dev/v1.ClusterConnectionInfo">ClusterConnectionInfo
 </h3>
 <p>
 (<em>Appears on:</em>
-<a href="#allocation.agones.dev/v1.GameServerAllocationSpec">GameServerAllocationSpec</a>)
+<a href="#multicluster.agones.dev/v1.GameServerAllocationPolicySpec">GameServerAllocationPolicySpec</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>ClusterConnectionInfo defines the connection information for a cluster</p>
 </p>
 <table>
 <thead>
@@ -8262,86 +8286,67 @@ <h3 id="allocation.agones.dev/v1.ListAction">ListAction
 <tbody>
 <tr>
 <td>
-<code>addValues</code></br>
+<code>clusterName</code></br>
 <em>
-[]string
+string
 </em>
 </td>
 <td>
+<p>Optional: the name of the targeted cluster</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>capacity</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>
-</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>
+<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>
 </tr>
 <tr>
 <td>
-<code>minAvailable</code></br>
+<code>namespace</code></br>
 <em>
-int64
+string
 </em>
 </td>
 <td>
+<p>The cluster namespace from which to allocate gameservers</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>maxAvailable</code></br>
+<code>serverCa</code></br>
 <em>
-int64
+[]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.MetaPatch">MetaPatch
+<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>MetaPatch is the metadata used to patch the GameServer metadata on allocation</p>
+<p>ConnectionInfoIterator an iterator on ClusterConnectionInfo</p>
 </p>
 <table>
 <thead>
@@ -8353,75 +8358,58 @@ <h3 id="allocation.agones.dev/v1.MetaPatch">MetaPatch
 <tbody>
 <tr>
 <td>
-<code>labels</code></br>
+<code>currPriority</code></br>
 <em>
-map[string]string
+int
 </em>
 </td>
 <td>
+<p>currPriority Current priority index from the orderedPriorities</p>
 </td>
 </tr>
 <tr>
 <td>
-<code>annotations</code></br>
+<code>orderedPriorities</code></br>
 <em>
-map[string]string
+[]int32
 </em>
 </td>
 <td>
+<p>orderedPriorities list of ordered priorities</p>
 </td>
 </tr>
-</tbody>
-</table>
-<h3 id="allocation.agones.dev/v1.MultiClusterSetting">MultiClusterSetting
-</h3>
-<p>
-(<em>Appears on:</em>
-<a href="#allocation.agones.dev/v1.GameServerAllocationSpec">GameServerAllocationSpec</a>)
-</p>
-<p>
-<p>MultiClusterSetting specifies settings for multi-cluster allocation.</p>
-</p>
-<table>
-<thead>
-<tr>
-<th>Field</th>
-<th>Description</th>
-</tr>
-</thead>
-<tbody>
 <tr>
 <td>
-<code>enabled</code></br>
+<code>priorityToCluster</code></br>
 <em>
-bool
+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>policySelector</code></br>
+<code>clusterBlackList</code></br>
 <em>
-<a href="https://v1-26.docs.kubernetes.io/docs/reference/generated/kubernetes-api/v1.26/#labelselector-v1-meta">
-Kubernetes meta/v1.LabelSelector
-</a>
+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.PlayerSelector">PlayerSelector
+<h3 id="multicluster.agones.dev/v1.GameServerAllocationPolicySpec">GameServerAllocationPolicySpec
 </h3>
 <p>
 (<em>Appears on:</em>
-<a href="#allocation.agones.dev/v1.GameServerSelector">GameServerSelector</a>)
+<a href="#multicluster.agones.dev/v1.GameServerAllocationPolicy">GameServerAllocationPolicy</a>)
 </p>
 <p>
-<p>PlayerSelector is the filter options for a GameServer based on player counts</p>
+<p>GameServerAllocationPolicySpec defines the desired state of GameServerAllocationPolicy</p>
 </p>
 <table>
 <thead>
@@ -8433,9 +8421,9 @@ <h3 id="allocation.agones.dev/v1.PlayerSelector">PlayerSelector
 <tbody>
 <tr>
 <td>
-<code>minAvailable</code></br>
+<code>priority</code></br>
 <em>
-int64
+int32
 </em>
 </td>
 <td>
@@ -8443,9 +8431,21 @@ <h3 id="allocation.agones.dev/v1.PlayerSelector">PlayerSelector
 </tr>
 <tr>
 <td>
-<code>maxAvailable</code></br>
+<code>weight</code></br>
 <em>
-int64
+int
+</em>
+</td>
+<td>
+</td>
+</tr>
+<tr>
+<td>
+<code>connectionInfo</code></br>
+<em>
+<a href="#multicluster.agones.dev/v1.ClusterConnectionInfo">
+ClusterConnectionInfo
+</a>
 </em>
 </td>
 <td>
diff --git a/vendor/github.com/mitchellh/hashstructure/v2/LICENSE b/vendor/github.com/mitchellh/hashstructure/v2/LICENSE
new file mode 100644
index 0000000000..a3866a291f
--- /dev/null
+++ b/vendor/github.com/mitchellh/hashstructure/v2/LICENSE
@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2016 Mitchell Hashimoto
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.
diff --git a/vendor/github.com/mitchellh/hashstructure/v2/README.md b/vendor/github.com/mitchellh/hashstructure/v2/README.md
new file mode 100644
index 0000000000..21f36be193
--- /dev/null
+++ b/vendor/github.com/mitchellh/hashstructure/v2/README.md
@@ -0,0 +1,76 @@
+# hashstructure [![GoDoc](https://godoc.org/github.com/mitchellh/hashstructure?status.svg)](https://godoc.org/github.com/mitchellh/hashstructure)
+
+hashstructure is a Go library for creating a unique hash value
+for arbitrary values in Go.
+
+This can be used to key values in a hash (for use in a map, set, etc.)
+that are complex. The most common use case is comparing two values without
+sending data across the network, caching values locally (de-dup), and so on.
+
+## Features
+
+  * Hash any arbitrary Go value, including complex types.
+
+  * Tag a struct field to ignore it and not affect the hash value.
+
+  * Tag a slice type struct field to treat it as a set where ordering
+    doesn't affect the hash code but the field itself is still taken into
+    account to create the hash value.
+
+  * Optionally, specify a custom hash function to optimize for speed, collision
+    avoidance for your data set, etc.
+
+  * Optionally, hash the output of `.String()` on structs that implement fmt.Stringer,
+    allowing effective hashing of time.Time
+
+  * Optionally, override the hashing process by implementing `Hashable`.
+
+## Installation
+
+Standard `go get`:
+
+```
+$ go get github.com/mitchellh/hashstructure/v2
+```
+
+**Note on v2:** It is highly recommended you use the "v2" release since this
+fixes some significant hash collisions issues from v1. In practice, we used
+v1 for many years in real projects at HashiCorp and never had issues, but it
+is highly dependent on the shape of the data you're hashing and how you use
+those hashes.
+
+When using v2+, you can still generate weaker v1 hashes by using the
+`FormatV1` format when calling `Hash`.
+
+## Usage & Example
+
+For usage and examples see the [Godoc](http://godoc.org/github.com/mitchellh/hashstructure).
+
+A quick code example is shown below:
+
+```go
+type ComplexStruct struct {
+    Name     string
+    Age      uint
+    Metadata map[string]interface{}
+}
+
+v := ComplexStruct{
+    Name: "mitchellh",
+    Age:  64,
+    Metadata: map[string]interface{}{
+        "car":      true,
+        "location": "California",
+        "siblings": []string{"Bob", "John"},
+    },
+}
+
+hash, err := hashstructure.Hash(v, hashstructure.FormatV2, nil)
+if err != nil {
+    panic(err)
+}
+
+fmt.Printf("%d", hash)
+// Output:
+// 2307517237273902113
+```
diff --git a/vendor/github.com/mitchellh/hashstructure/v2/errors.go b/vendor/github.com/mitchellh/hashstructure/v2/errors.go
new file mode 100644
index 0000000000..44b8951478
--- /dev/null
+++ b/vendor/github.com/mitchellh/hashstructure/v2/errors.go
@@ -0,0 +1,22 @@
+package hashstructure
+
+import (
+	"fmt"
+)
+
+// ErrNotStringer is returned when there's an error with hash:"string"
+type ErrNotStringer struct {
+	Field string
+}
+
+// Error implements error for ErrNotStringer
+func (ens *ErrNotStringer) Error() string {
+	return fmt.Sprintf("hashstructure: %s has hash:\"string\" set, but does not implement fmt.Stringer", ens.Field)
+}
+
+// ErrFormat is returned when an invalid format is given to the Hash function.
+type ErrFormat struct{}
+
+func (*ErrFormat) Error() string {
+	return "format must be one of the defined Format values in the hashstructure library"
+}
diff --git a/vendor/github.com/mitchellh/hashstructure/v2/hashstructure.go b/vendor/github.com/mitchellh/hashstructure/v2/hashstructure.go
new file mode 100644
index 0000000000..3dc0eb74e0
--- /dev/null
+++ b/vendor/github.com/mitchellh/hashstructure/v2/hashstructure.go
@@ -0,0 +1,482 @@
+package hashstructure
+
+import (
+	"encoding/binary"
+	"fmt"
+	"hash"
+	"hash/fnv"
+	"reflect"
+	"time"
+)
+
+// HashOptions are options that are available for hashing.
+type HashOptions struct {
+	// Hasher is the hash function to use. If this isn't set, it will
+	// default to FNV.
+	Hasher hash.Hash64
+
+	// TagName is the struct tag to look at when hashing the structure.
+	// By default this is "hash".
+	TagName string
+
+	// ZeroNil is flag determining if nil pointer should be treated equal
+	// to a zero value of pointed type. By default this is false.
+	ZeroNil bool
+
+	// IgnoreZeroValue is determining if zero value fields should be
+	// ignored for hash calculation.
+	IgnoreZeroValue bool
+
+	// SlicesAsSets assumes that a `set` tag is always present for slices.
+	// Default is false (in which case the tag is used instead)
+	SlicesAsSets bool
+
+	// UseStringer will attempt to use fmt.Stringer always. If the struct
+	// doesn't implement fmt.Stringer, it'll fall back to trying usual tricks.
+	// If this is true, and the "string" tag is also set, the tag takes
+	// precedence (meaning that if the type doesn't implement fmt.Stringer, we
+	// panic)
+	UseStringer bool
+}
+
+// Format specifies the hashing process used. Different formats typically
+// generate different hashes for the same value and have different properties.
+type Format uint
+
+const (
+	// To disallow the zero value
+	formatInvalid Format = iota
+
+	// FormatV1 is the format used in v1.x of this library. This has the
+	// downsides noted in issue #18 but allows simultaneous v1/v2 usage.
+	FormatV1
+
+	// FormatV2 is the current recommended format and fixes the issues
+	// noted in FormatV1.
+	FormatV2
+
+	formatMax // so we can easily find the end
+)
+
+// Hash returns the hash value of an arbitrary value.
+//
+// If opts is nil, then default options will be used. See HashOptions
+// for the default values. The same *HashOptions value cannot be used
+// concurrently. None of the values within a *HashOptions struct are
+// safe to read/write while hashing is being done.
+//
+// The "format" is required and must be one of the format values defined
+// by this library. You should probably just use "FormatV2". This allows
+// generated hashes uses alternate logic to maintain compatibility with
+// older versions.
+//
+// Notes on the value:
+//
+//   * Unexported fields on structs are ignored and do not affect the
+//     hash value.
+//
+//   * Adding an exported field to a struct with the zero value will change
+//     the hash value.
+//
+// For structs, the hashing can be controlled using tags. For example:
+//
+//    struct {
+//        Name string
+//        UUID string `hash:"ignore"`
+//    }
+//
+// The available tag values are:
+//
+//   * "ignore" or "-" - The field will be ignored and not affect the hash code.
+//
+//   * "set" - The field will be treated as a set, where ordering doesn't
+//             affect the hash code. This only works for slices.
+//
+//   * "string" - The field will be hashed as a string, only works when the
+//                field implements fmt.Stringer
+//
+func Hash(v interface{}, format Format, opts *HashOptions) (uint64, error) {
+	// Validate our format
+	if format <= formatInvalid || format >= formatMax {
+		return 0, &ErrFormat{}
+	}
+
+	// Create default options
+	if opts == nil {
+		opts = &HashOptions{}
+	}
+	if opts.Hasher == nil {
+		opts.Hasher = fnv.New64()
+	}
+	if opts.TagName == "" {
+		opts.TagName = "hash"
+	}
+
+	// Reset the hash
+	opts.Hasher.Reset()
+
+	// Create our walker and walk the structure
+	w := &walker{
+		format:          format,
+		h:               opts.Hasher,
+		tag:             opts.TagName,
+		zeronil:         opts.ZeroNil,
+		ignorezerovalue: opts.IgnoreZeroValue,
+		sets:            opts.SlicesAsSets,
+		stringer:        opts.UseStringer,
+	}
+	return w.visit(reflect.ValueOf(v), nil)
+}
+
+type walker struct {
+	format          Format
+	h               hash.Hash64
+	tag             string
+	zeronil         bool
+	ignorezerovalue bool
+	sets            bool
+	stringer        bool
+}
+
+type visitOpts struct {
+	// Flags are a bitmask of flags to affect behavior of this visit
+	Flags visitFlag
+
+	// Information about the struct containing this field
+	Struct      interface{}
+	StructField string
+}
+
+var timeType = reflect.TypeOf(time.Time{})
+
+func (w *walker) visit(v reflect.Value, opts *visitOpts) (uint64, error) {
+	t := reflect.TypeOf(0)
+
+	// Loop since these can be wrapped in multiple layers of pointers
+	// and interfaces.
+	for {
+		// If we have an interface, dereference it. We have to do this up
+		// here because it might be a nil in there and the check below must
+		// catch that.
+		if v.Kind() == reflect.Interface {
+			v = v.Elem()
+			continue
+		}
+
+		if v.Kind() == reflect.Ptr {
+			if w.zeronil {
+				t = v.Type().Elem()
+			}
+			v = reflect.Indirect(v)
+			continue
+		}
+
+		break
+	}
+
+	// If it is nil, treat it like a zero.
+	if !v.IsValid() {
+		v = reflect.Zero(t)
+	}
+
+	// Binary writing can use raw ints, we have to convert to
+	// a sized-int, we'll choose the largest...
+	switch v.Kind() {
+	case reflect.Int:
+		v = reflect.ValueOf(int64(v.Int()))
+	case reflect.Uint:
+		v = reflect.ValueOf(uint64(v.Uint()))
+	case reflect.Bool:
+		var tmp int8
+		if v.Bool() {
+			tmp = 1
+		}
+		v = reflect.ValueOf(tmp)
+	}
+
+	k := v.Kind()
+
+	// We can shortcut numeric values by directly binary writing them
+	if k >= reflect.Int && k <= reflect.Complex64 {
+		// A direct hash calculation
+		w.h.Reset()
+		err := binary.Write(w.h, binary.LittleEndian, v.Interface())
+		return w.h.Sum64(), err
+	}
+
+	switch v.Type() {
+	case timeType:
+		w.h.Reset()
+		b, err := v.Interface().(time.Time).MarshalBinary()
+		if err != nil {
+			return 0, err
+		}
+
+		err = binary.Write(w.h, binary.LittleEndian, b)
+		return w.h.Sum64(), err
+	}
+
+	switch k {
+	case reflect.Array:
+		var h uint64
+		l := v.Len()
+		for i := 0; i < l; i++ {
+			current, err := w.visit(v.Index(i), nil)
+			if err != nil {
+				return 0, err
+			}
+
+			h = hashUpdateOrdered(w.h, h, current)
+		}
+
+		return h, nil
+
+	case reflect.Map:
+		var includeMap IncludableMap
+		if opts != nil && opts.Struct != nil {
+			if v, ok := opts.Struct.(IncludableMap); ok {
+				includeMap = v
+			}
+		}
+
+		// Build the hash for the map. We do this by XOR-ing all the key
+		// and value hashes. This makes it deterministic despite ordering.
+		var h uint64
+		for _, k := range v.MapKeys() {
+			v := v.MapIndex(k)
+			if includeMap != nil {
+				incl, err := includeMap.HashIncludeMap(
+					opts.StructField, k.Interface(), v.Interface())
+				if err != nil {
+					return 0, err
+				}
+				if !incl {
+					continue
+				}
+			}
+
+			kh, err := w.visit(k, nil)
+			if err != nil {
+				return 0, err
+			}
+			vh, err := w.visit(v, nil)
+			if err != nil {
+				return 0, err
+			}
+
+			fieldHash := hashUpdateOrdered(w.h, kh, vh)
+			h = hashUpdateUnordered(h, fieldHash)
+		}
+
+		if w.format != FormatV1 {
+			// Important: read the docs for hashFinishUnordered
+			h = hashFinishUnordered(w.h, h)
+		}
+
+		return h, nil
+
+	case reflect.Struct:
+		parent := v.Interface()
+		var include Includable
+		if impl, ok := parent.(Includable); ok {
+			include = impl
+		}
+
+		if impl, ok := parent.(Hashable); ok {
+			return impl.Hash()
+		}
+
+		// If we can address this value, check if the pointer value
+		// implements our interfaces and use that if so.
+		if v.CanAddr() {
+			vptr := v.Addr()
+			parentptr := vptr.Interface()
+			if impl, ok := parentptr.(Includable); ok {
+				include = impl
+			}
+
+			if impl, ok := parentptr.(Hashable); ok {
+				return impl.Hash()
+			}
+		}
+
+		t := v.Type()
+		h, err := w.visit(reflect.ValueOf(t.Name()), nil)
+		if err != nil {
+			return 0, err
+		}
+
+		l := v.NumField()
+		for i := 0; i < l; i++ {
+			if innerV := v.Field(i); v.CanSet() || t.Field(i).Name != "_" {
+				var f visitFlag
+				fieldType := t.Field(i)
+				if fieldType.PkgPath != "" {
+					// Unexported
+					continue
+				}
+
+				tag := fieldType.Tag.Get(w.tag)
+				if tag == "ignore" || tag == "-" {
+					// Ignore this field
+					continue
+				}
+
+				if w.ignorezerovalue {
+					if innerV.IsZero() {
+						continue
+					}
+				}
+
+				// if string is set, use the string value
+				if tag == "string" || w.stringer {
+					if impl, ok := innerV.Interface().(fmt.Stringer); ok {
+						innerV = reflect.ValueOf(impl.String())
+					} else if tag == "string" {
+						// We only show this error if the tag explicitly
+						// requests a stringer.
+						return 0, &ErrNotStringer{
+							Field: v.Type().Field(i).Name,
+						}
+					}
+				}
+
+				// Check if we implement includable and check it
+				if include != nil {
+					incl, err := include.HashInclude(fieldType.Name, innerV)
+					if err != nil {
+						return 0, err
+					}
+					if !incl {
+						continue
+					}
+				}
+
+				switch tag {
+				case "set":
+					f |= visitFlagSet
+				}
+
+				kh, err := w.visit(reflect.ValueOf(fieldType.Name), nil)
+				if err != nil {
+					return 0, err
+				}
+
+				vh, err := w.visit(innerV, &visitOpts{
+					Flags:       f,
+					Struct:      parent,
+					StructField: fieldType.Name,
+				})
+				if err != nil {
+					return 0, err
+				}
+
+				fieldHash := hashUpdateOrdered(w.h, kh, vh)
+				h = hashUpdateUnordered(h, fieldHash)
+			}
+
+			if w.format != FormatV1 {
+				// Important: read the docs for hashFinishUnordered
+				h = hashFinishUnordered(w.h, h)
+			}
+		}
+
+		return h, nil
+
+	case reflect.Slice:
+		// We have two behaviors here. If it isn't a set, then we just
+		// visit all the elements. If it is a set, then we do a deterministic
+		// hash code.
+		var h uint64
+		var set bool
+		if opts != nil {
+			set = (opts.Flags & visitFlagSet) != 0
+		}
+		l := v.Len()
+		for i := 0; i < l; i++ {
+			current, err := w.visit(v.Index(i), nil)
+			if err != nil {
+				return 0, err
+			}
+
+			if set || w.sets {
+				h = hashUpdateUnordered(h, current)
+			} else {
+				h = hashUpdateOrdered(w.h, h, current)
+			}
+		}
+
+		if set && w.format != FormatV1 {
+			// Important: read the docs for hashFinishUnordered
+			h = hashFinishUnordered(w.h, h)
+		}
+
+		return h, nil
+
+	case reflect.String:
+		// Directly hash
+		w.h.Reset()
+		_, err := w.h.Write([]byte(v.String()))
+		return w.h.Sum64(), err
+
+	default:
+		return 0, fmt.Errorf("unknown kind to hash: %s", k)
+	}
+
+}
+
+func hashUpdateOrdered(h hash.Hash64, a, b uint64) uint64 {
+	// For ordered updates, use a real hash function
+	h.Reset()
+
+	// We just panic if the binary writes fail because we are writing
+	// an int64 which should never be fail-able.
+	e1 := binary.Write(h, binary.LittleEndian, a)
+	e2 := binary.Write(h, binary.LittleEndian, b)
+	if e1 != nil {
+		panic(e1)
+	}
+	if e2 != nil {
+		panic(e2)
+	}
+
+	return h.Sum64()
+}
+
+func hashUpdateUnordered(a, b uint64) uint64 {
+	return a ^ b
+}
+
+// After mixing a group of unique hashes with hashUpdateUnordered, it's always
+// necessary to call hashFinishUnordered. Why? Because hashUpdateUnordered
+// is a simple XOR, and calling hashUpdateUnordered on hashes produced by
+// hashUpdateUnordered can effectively cancel out a previous change to the hash
+// result if the same hash value appears later on. For example, consider:
+//
+//   hashUpdateUnordered(hashUpdateUnordered("A", "B"), hashUpdateUnordered("A", "C")) =
+//   H("A") ^ H("B")) ^ (H("A") ^ H("C")) =
+//   (H("A") ^ H("A")) ^ (H("B") ^ H(C)) =
+//   H(B) ^ H(C) =
+//   hashUpdateUnordered(hashUpdateUnordered("Z", "B"), hashUpdateUnordered("Z", "C"))
+//
+// hashFinishUnordered "hardens" the result, so that encountering partially
+// overlapping input data later on in a different context won't cancel out.
+func hashFinishUnordered(h hash.Hash64, a uint64) uint64 {
+	h.Reset()
+
+	// We just panic if the writes fail
+	e1 := binary.Write(h, binary.LittleEndian, a)
+	if e1 != nil {
+		panic(e1)
+	}
+
+	return h.Sum64()
+}
+
+// visitFlag is used as a bitmask for affecting visit behavior
+type visitFlag uint
+
+const (
+	visitFlagInvalid visitFlag = iota
+	visitFlagSet               = iota << 1
+)
diff --git a/vendor/github.com/mitchellh/hashstructure/v2/include.go b/vendor/github.com/mitchellh/hashstructure/v2/include.go
new file mode 100644
index 0000000000..702d35415d
--- /dev/null
+++ b/vendor/github.com/mitchellh/hashstructure/v2/include.go
@@ -0,0 +1,22 @@
+package hashstructure
+
+// Includable is an interface that can optionally be implemented by
+// a struct. It will be called for each field in the struct to check whether
+// it should be included in the hash.
+type Includable interface {
+	HashInclude(field string, v interface{}) (bool, error)
+}
+
+// IncludableMap is an interface that can optionally be implemented by
+// a struct. It will be called when a map-type field is found to ask the
+// struct if the map item should be included in the hash.
+type IncludableMap interface {
+	HashIncludeMap(field string, k, v interface{}) (bool, error)
+}
+
+// Hashable is an interface that can optionally be implemented by a struct
+// to override the hash value. This value will override the hash value for
+// the entire struct. Entries in the struct will not be hashed.
+type Hashable interface {
+	Hash() (uint64, error)
+}
diff --git a/vendor/modules.txt b/vendor/modules.txt
index 7328e592ef..7896189027 100644
--- a/vendor/modules.txt
+++ b/vendor/modules.txt
@@ -243,6 +243,9 @@ github.com/matttproud/golang_protobuf_extensions/pbutil
 # github.com/mennanov/fmutils v0.2.0
 ## explicit; go 1.15
 github.com/mennanov/fmutils
+# github.com/mitchellh/hashstructure/v2 v2.0.2
+## explicit; go 1.14
+github.com/mitchellh/hashstructure/v2
 # github.com/mitchellh/mapstructure v1.4.1
 ## explicit; go 1.14
 github.com/mitchellh/mapstructure