https://docs.microsoft.com/en-us/gaming/playfab/release-notes/#260313

PlayFab SDK Team · PlayFab SDK Team · commit a1a57d318670 · 2026-03-16T21:00:05.000Z
diff --git a/AndroidStudioExample/app/packageMe.ps1 b/AndroidStudioExample/app/packageMe.ps1
@@ -5,4 +5,4 @@ New-Item -ItemType Directory -Force ./builds
 popd
 
 cd target
-Copy-Item  client-sdk-0.255.260227.jar -Destination ../../builds/client-sdk-0.255.260227.jar
+Copy-Item  client-sdk-0.256.260313.jar -Destination ../../builds/client-sdk-0.256.260313.jar
diff --git a/AndroidStudioExample/app/packageMe.sh b/AndroidStudioExample/app/packageMe.sh
@@ -7,4 +7,4 @@ mkdir -p ./builds
 popd
 
 cd target
-cp  client-sdk-0.255.260227.jar ../../builds/client-sdk-0.255.260227.jar
+cp  client-sdk-0.256.260313.jar ../../builds/client-sdk-0.256.260313.jar
diff --git a/AndroidStudioExample/app/src/main/java/com/playfab/PlayFabClientModels.java b/AndroidStudioExample/app/src/main/java/com/playfab/PlayFabClientModels.java
@@ -1471,7 +1471,10 @@ public static class GetFriendsListRequest {
          * the Game Manager "Client Profile Options" tab in the "Settings" section.
          */
         public PlayerProfileViewConstraints ProfileConstraints;
-        /** Xbox token if Xbox friends should be included. Requires Xbox be configured on PlayFab. */
+        /**
+         * Xbox token if Xbox friends should be included. Requires Xbox be configured on PlayFab. When provided, all Xbox Live
+         * users the caller is following are included regardless of whether they follow the caller back.
+         */
         public String XboxToken;
         
     }
@@ -1482,6 +1485,8 @@ public static class GetFriendsListRequest {
      * recently, and only friends who also plays this game will be included. Note: If the user authenticated with
      * AuthenticationToken when calling LoginWithFacebook, instead of AccessToken, an empty list will be returned. For Xbox
      * Live, user has to have logged into the Xbox Live recently, and only friends who also play this game will be included.
+     * Xbox Live friends include all users the caller is following, regardless of whether those users follow the caller back.
+     * This differs from FindFriendLobbies, which only considers mutual Xbox Live friends (where both users follow each other).
      */
     public static class GetFriendsListResult {
         /** Array of friends found. */
diff --git a/AndroidStudioExample/app/src/main/java/com/playfab/PlayFabErrors.java b/AndroidStudioExample/app/src/main/java/com/playfab/PlayFabErrors.java
@@ -746,7 +746,7 @@ public static enum PlayFabErrorCode {
         AsyncExportNotFound(10012),
         AsyncExportRateLimitExceeded(10013),
         AnalyticsSegmentCountOverLimit(10014),
-        GetPlayersInSegmentDeprecated(10015),
+        GetPlayersInSegmentRetired(10015),
         SnapshotNotFound(11000),
         InventoryApiNotImplemented(12000),
         InventoryCollectionDeletionDisallowed(12001),
diff --git a/AndroidStudioExample/app/src/main/java/com/playfab/PlayFabMultiplayerModels.java b/AndroidStudioExample/app/src/main/java/com/playfab/PlayFabMultiplayerModels.java
@@ -1148,7 +1148,11 @@ public static class FindFriendLobbiesRequest {
         public String OrderBy;
         /** Request pagination information. */
         public PaginationRequest Pagination;
-        /** Xbox token if Xbox friends should be included. Requires Xbox be configured on PlayFab. */
+        /**
+         * Xbox token if Xbox friends should be included. Requires Xbox be configured on PlayFab. Only mutual Xbox Live friends
+         * (where both users follow each other) are included, unlike GetFriendsList which includes all users the caller is
+         * following.
+         */
         public String XboxToken;
         
     }
diff --git a/AndroidStudioExample/app/src/main/java/com/playfab/PlayFabSettings.java b/AndroidStudioExample/app/src/main/java/com/playfab/PlayFabSettings.java
@@ -9,9 +9,9 @@
 import com.playfab.PlayFabErrors.ErrorCallback;
 
 public class PlayFabSettings {
-    public static String SdkVersion = "0.255.260227";
+    public static String SdkVersion = "0.256.260313";
     public static String BuildIdentifier = "adobuild_javasdk_117";
-    public static String SdkVersionString = "JavaSDK-0.255.260227";
+    public static String SdkVersionString = "JavaSDK-0.256.260313";
 
     public static Map<String, String> RequestGetParams;
     static {
diff --git a/PlayFabClientSDK/packageMe.ps1 b/PlayFabClientSDK/packageMe.ps1
@@ -5,4 +5,4 @@ New-Item -ItemType Directory -Force ./builds
 popd
 
 cd target
-Copy-Item  client-sdk-0.255.260227.jar -Destination ../../builds/client-sdk-0.255.260227.jar
+Copy-Item  client-sdk-0.256.260313.jar -Destination ../../builds/client-sdk-0.256.260313.jar
diff --git a/PlayFabClientSDK/packageMe.sh b/PlayFabClientSDK/packageMe.sh
@@ -7,4 +7,4 @@ mkdir -p ./builds
 popd
 
 cd target
-cp  client-sdk-0.255.260227.jar ../../builds/client-sdk-0.255.260227.jar
+cp  client-sdk-0.256.260313.jar ../../builds/client-sdk-0.256.260313.jar
diff --git a/PlayFabClientSDK/pom.xml b/PlayFabClientSDK/pom.xml
@@ -14,7 +14,7 @@
     <!-- GAV & Meta -->
     <groupId>com.playfab</groupId>
     <artifactId>client-sdk</artifactId>
-    <version>0.255.260227</version>
+    <version>0.256.260313</version>
     <name>PlayFab Client API</name>
     <description>PlayFab is the unified backend platform for games — everything you need to build and operate your game, all in one place, so you can focus on creating and delivering a great player experience. </description>
     <url>https://docs.microsoft.com/gaming/playfab/</url>
diff --git a/PlayFabClientSDK/src/main/java/com/playfab/PlayFabClientModels.java b/PlayFabClientSDK/src/main/java/com/playfab/PlayFabClientModels.java
@@ -1471,7 +1471,10 @@ public static class GetFriendsListRequest {
          * the Game Manager "Client Profile Options" tab in the "Settings" section.
          */
         public PlayerProfileViewConstraints ProfileConstraints;
-        /** Xbox token if Xbox friends should be included. Requires Xbox be configured on PlayFab. */
+        /**
+         * Xbox token if Xbox friends should be included. Requires Xbox be configured on PlayFab. When provided, all Xbox Live
+         * users the caller is following are included regardless of whether they follow the caller back.
+         */
         public String XboxToken;
         
     }
@@ -1482,6 +1485,8 @@ public static class GetFriendsListRequest {
      * recently, and only friends who also plays this game will be included. Note: If the user authenticated with
      * AuthenticationToken when calling LoginWithFacebook, instead of AccessToken, an empty list will be returned. For Xbox
      * Live, user has to have logged into the Xbox Live recently, and only friends who also play this game will be included.
+     * Xbox Live friends include all users the caller is following, regardless of whether those users follow the caller back.
+     * This differs from FindFriendLobbies, which only considers mutual Xbox Live friends (where both users follow each other).
      */
     public static class GetFriendsListResult {
         /** Array of friends found. */
diff --git a/PlayFabClientSDK/src/main/java/com/playfab/PlayFabErrors.java b/PlayFabClientSDK/src/main/java/com/playfab/PlayFabErrors.java
@@ -746,7 +746,7 @@ public static enum PlayFabErrorCode {
         AsyncExportNotFound(10012),
         AsyncExportRateLimitExceeded(10013),
         AnalyticsSegmentCountOverLimit(10014),
-        GetPlayersInSegmentDeprecated(10015),
+        GetPlayersInSegmentRetired(10015),
         SnapshotNotFound(11000),
         InventoryApiNotImplemented(12000),
         InventoryCollectionDeletionDisallowed(12001),
diff --git a/PlayFabClientSDK/src/main/java/com/playfab/PlayFabMultiplayerModels.java b/PlayFabClientSDK/src/main/java/com/playfab/PlayFabMultiplayerModels.java
@@ -1148,7 +1148,11 @@ public static class FindFriendLobbiesRequest {
         public String OrderBy;
         /** Request pagination information. */
         public PaginationRequest Pagination;
-        /** Xbox token if Xbox friends should be included. Requires Xbox be configured on PlayFab. */
+        /**
+         * Xbox token if Xbox friends should be included. Requires Xbox be configured on PlayFab. Only mutual Xbox Live friends
+         * (where both users follow each other) are included, unlike GetFriendsList which includes all users the caller is
+         * following.
+         */
         public String XboxToken;
         
     }
diff --git a/PlayFabClientSDK/src/main/java/com/playfab/PlayFabSettings.java b/PlayFabClientSDK/src/main/java/com/playfab/PlayFabSettings.java
@@ -8,9 +8,9 @@
 import com.playfab.PlayFabErrors.ErrorCallback;
 
 public class PlayFabSettings {
-    public static String SdkVersion = "0.255.260227";
+    public static String SdkVersion = "0.256.260313";
     public static String BuildIdentifier = "adobuild_javasdk_117";
-    public static String SdkVersionString = "JavaSDK-0.255.260227";
+    public static String SdkVersionString = "JavaSDK-0.256.260313";
 
     public static Map<String, String> RequestGetParams;
     static {
diff --git a/PlayFabSDK/packageMe.ps1 b/PlayFabSDK/packageMe.ps1
@@ -5,4 +5,4 @@ New-Item -ItemType Directory -Force ./builds
 popd
 
 cd target
-Copy-Item  combo-sdk-0.255.260227.jar -Destination ../../builds/combo-sdk-0.255.260227.jar
+Copy-Item  combo-sdk-0.256.260313.jar -Destination ../../builds/combo-sdk-0.256.260313.jar
diff --git a/PlayFabSDK/packageMe.sh b/PlayFabSDK/packageMe.sh
@@ -7,4 +7,4 @@ mkdir -p ./builds
 popd
 
 cd target
-cp  combo-sdk-0.255.260227.jar ../../builds/combo-sdk-0.255.260227.jar
+cp  combo-sdk-0.256.260313.jar ../../builds/combo-sdk-0.256.260313.jar
diff --git a/PlayFabSDK/pom.xml b/PlayFabSDK/pom.xml
@@ -14,7 +14,7 @@
     <!-- GAV & Meta -->
     <groupId>com.playfab</groupId>
     <artifactId>combo-sdk</artifactId>
-    <version>0.255.260227</version>
+    <version>0.256.260313</version>
     <name>PlayFab Combo API</name>
     <description>PlayFab is the unified backend platform for games — everything you need to build and operate your game, all in one place, so you can focus on creating and delivering a great player experience. </description>
     <url>https://docs.microsoft.com/gaming/playfab/</url>
diff --git a/PlayFabSDK/src/main/java/com/playfab/PlayFabAdminModels.java b/PlayFabSDK/src/main/java/com/playfab/PlayFabAdminModels.java
@@ -2328,7 +2328,7 @@ public static enum GenericErrorCodes {
         AsyncExportNotFound,
         AsyncExportRateLimitExceeded,
         AnalyticsSegmentCountOverLimit,
-        GetPlayersInSegmentDeprecated,
+        GetPlayersInSegmentRetired,
         SnapshotNotFound,
         InventoryApiNotImplemented,
         InventoryCollectionDeletionDisallowed,
diff --git a/PlayFabSDK/src/main/java/com/playfab/PlayFabClientModels.java b/PlayFabSDK/src/main/java/com/playfab/PlayFabClientModels.java
@@ -1471,7 +1471,10 @@ public static class GetFriendsListRequest {
          * the Game Manager "Client Profile Options" tab in the "Settings" section.
          */
         public PlayerProfileViewConstraints ProfileConstraints;
-        /** Xbox token if Xbox friends should be included. Requires Xbox be configured on PlayFab. */
+        /**
+         * Xbox token if Xbox friends should be included. Requires Xbox be configured on PlayFab. When provided, all Xbox Live
+         * users the caller is following are included regardless of whether they follow the caller back.
+         */
         public String XboxToken;
         
     }
@@ -1482,6 +1485,8 @@ public static class GetFriendsListRequest {
      * recently, and only friends who also plays this game will be included. Note: If the user authenticated with
      * AuthenticationToken when calling LoginWithFacebook, instead of AccessToken, an empty list will be returned. For Xbox
      * Live, user has to have logged into the Xbox Live recently, and only friends who also play this game will be included.
+     * Xbox Live friends include all users the caller is following, regardless of whether those users follow the caller back.
+     * This differs from FindFriendLobbies, which only considers mutual Xbox Live friends (where both users follow each other).
      */
     public static class GetFriendsListResult {
         /** Array of friends found. */
diff --git a/PlayFabSDK/src/main/java/com/playfab/PlayFabErrors.java b/PlayFabSDK/src/main/java/com/playfab/PlayFabErrors.java
@@ -746,7 +746,7 @@ public static enum PlayFabErrorCode {
         AsyncExportNotFound(10012),
         AsyncExportRateLimitExceeded(10013),
         AnalyticsSegmentCountOverLimit(10014),
-        GetPlayersInSegmentDeprecated(10015),
+        GetPlayersInSegmentRetired(10015),
         SnapshotNotFound(11000),
         InventoryApiNotImplemented(12000),
         InventoryCollectionDeletionDisallowed(12001),
diff --git a/PlayFabSDK/src/main/java/com/playfab/PlayFabMultiplayerModels.java b/PlayFabSDK/src/main/java/com/playfab/PlayFabMultiplayerModels.java
@@ -1148,7 +1148,11 @@ public static class FindFriendLobbiesRequest {
         public String OrderBy;
         /** Request pagination information. */
         public PaginationRequest Pagination;
-        /** Xbox token if Xbox friends should be included. Requires Xbox be configured on PlayFab. */
+        /**
+         * Xbox token if Xbox friends should be included. Requires Xbox be configured on PlayFab. Only mutual Xbox Live friends
+         * (where both users follow each other) are included, unlike GetFriendsList which includes all users the caller is
+         * following.
+         */
         public String XboxToken;
         
     }
diff --git a/PlayFabSDK/src/main/java/com/playfab/PlayFabServerModels.java b/PlayFabSDK/src/main/java/com/playfab/PlayFabServerModels.java
@@ -1924,7 +1924,7 @@ public static enum GenericErrorCodes {
         AsyncExportNotFound,
         AsyncExportRateLimitExceeded,
         AnalyticsSegmentCountOverLimit,
-        GetPlayersInSegmentDeprecated,
+        GetPlayersInSegmentRetired,
         SnapshotNotFound,
         InventoryApiNotImplemented,
         InventoryCollectionDeletionDisallowed,
@@ -2344,7 +2344,10 @@ public static class GetFriendsListRequest {
          * the Game Manager "Client Profile Options" tab in the "Settings" section.
          */
         public PlayerProfileViewConstraints ProfileConstraints;
-        /** Xbox token if Xbox friends should be included. Requires Xbox be configured on PlayFab. */
+        /**
+         * Xbox token if Xbox friends should be included. Requires Xbox be configured on PlayFab. When provided, all Xbox Live
+         * users the caller is following are included regardless of whether they follow the caller back.
+         */
         public String XboxToken;
         
     }
@@ -2353,7 +2356,9 @@ public static class GetFriendsListRequest {
      * If any additional services are queried for the user's friends, those friends who also have a PlayFab account registered
      * for the title will be returned in the results. For Facebook, user has to have logged into the title's Facebook app
      * recently, and only friends who also plays this game will be included. For Xbox Live, user has to have logged into the
-     * Xbox Live recently, and only friends who also play this game will be included.
+     * Xbox Live recently, and only friends who also play this game will be included. Xbox Live friends include all users the
+     * caller is following, regardless of whether those users follow the caller back. This differs from FindFriendLobbies,
+     * which only considers mutual Xbox Live friends (where both users follow each other).
      */
     public static class GetFriendsListResult {
         /** Array of friends found. */
diff --git a/PlayFabSDK/src/main/java/com/playfab/PlayFabSettings.java b/PlayFabSDK/src/main/java/com/playfab/PlayFabSettings.java
@@ -8,9 +8,9 @@
 import com.playfab.PlayFabErrors.ErrorCallback;
 
 public class PlayFabSettings {
-    public static String SdkVersion = "0.255.260227";
+    public static String SdkVersion = "0.256.260313";
     public static String BuildIdentifier = "adobuild_javasdk_117";
-    public static String SdkVersionString = "JavaSDK-0.255.260227";
+    public static String SdkVersionString = "JavaSDK-0.256.260313";
 
     public static Map<String, String> RequestGetParams;
     static {
diff --git a/PlayFabServerSDK/packageMe.ps1 b/PlayFabServerSDK/packageMe.ps1
@@ -5,4 +5,4 @@ New-Item -ItemType Directory -Force ./builds
 popd
 
 cd target
-Copy-Item  server-sdk-0.255.260227.jar -Destination ../../builds/server-sdk-0.255.260227.jar
+Copy-Item  server-sdk-0.256.260313.jar -Destination ../../builds/server-sdk-0.256.260313.jar
diff --git a/PlayFabServerSDK/packageMe.sh b/PlayFabServerSDK/packageMe.sh
@@ -7,4 +7,4 @@ mkdir -p ./builds
 popd
 
 cd target
-cp  server-sdk-0.255.260227.jar ../../builds/server-sdk-0.255.260227.jar
+cp  server-sdk-0.256.260313.jar ../../builds/server-sdk-0.256.260313.jar
diff --git a/PlayFabServerSDK/pom.xml b/PlayFabServerSDK/pom.xml
@@ -14,7 +14,7 @@
     <!-- GAV & Meta -->
     <groupId>com.playfab</groupId>
     <artifactId>server-sdk</artifactId>
-    <version>0.255.260227</version>
+    <version>0.256.260313</version>
     <name>PlayFab Server API</name>
     <description>PlayFab is the unified backend platform for games — everything you need to build and operate your game, all in one place, so you can focus on creating and delivering a great player experience. </description>
     <url>https://docs.microsoft.com/gaming/playfab/</url>
diff --git a/PlayFabServerSDK/src/main/java/com/playfab/PlayFabAdminModels.java b/PlayFabServerSDK/src/main/java/com/playfab/PlayFabAdminModels.java
@@ -2328,7 +2328,7 @@ public static enum GenericErrorCodes {
         AsyncExportNotFound,
         AsyncExportRateLimitExceeded,
         AnalyticsSegmentCountOverLimit,
-        GetPlayersInSegmentDeprecated,
+        GetPlayersInSegmentRetired,
         SnapshotNotFound,
         InventoryApiNotImplemented,
         InventoryCollectionDeletionDisallowed,
diff --git a/PlayFabServerSDK/src/main/java/com/playfab/PlayFabErrors.java b/PlayFabServerSDK/src/main/java/com/playfab/PlayFabErrors.java
@@ -746,7 +746,7 @@ public static enum PlayFabErrorCode {
         AsyncExportNotFound(10012),
         AsyncExportRateLimitExceeded(10013),
         AnalyticsSegmentCountOverLimit(10014),
-        GetPlayersInSegmentDeprecated(10015),
+        GetPlayersInSegmentRetired(10015),
         SnapshotNotFound(11000),
         InventoryApiNotImplemented(12000),
         InventoryCollectionDeletionDisallowed(12001),
diff --git a/PlayFabServerSDK/src/main/java/com/playfab/PlayFabMultiplayerModels.java b/PlayFabServerSDK/src/main/java/com/playfab/PlayFabMultiplayerModels.java
@@ -1148,7 +1148,11 @@ public static class FindFriendLobbiesRequest {
         public String OrderBy;
         /** Request pagination information. */
         public PaginationRequest Pagination;
-        /** Xbox token if Xbox friends should be included. Requires Xbox be configured on PlayFab. */
+        /**
+         * Xbox token if Xbox friends should be included. Requires Xbox be configured on PlayFab. Only mutual Xbox Live friends
+         * (where both users follow each other) are included, unlike GetFriendsList which includes all users the caller is
+         * following.
+         */
         public String XboxToken;
         
     }
diff --git a/PlayFabServerSDK/src/main/java/com/playfab/PlayFabServerModels.java b/PlayFabServerSDK/src/main/java/com/playfab/PlayFabServerModels.java
@@ -1924,7 +1924,7 @@ public static enum GenericErrorCodes {
         AsyncExportNotFound,
         AsyncExportRateLimitExceeded,
         AnalyticsSegmentCountOverLimit,
-        GetPlayersInSegmentDeprecated,
+        GetPlayersInSegmentRetired,
         SnapshotNotFound,
         InventoryApiNotImplemented,
         InventoryCollectionDeletionDisallowed,
@@ -2344,7 +2344,10 @@ public static class GetFriendsListRequest {
          * the Game Manager "Client Profile Options" tab in the "Settings" section.
          */
         public PlayerProfileViewConstraints ProfileConstraints;
-        /** Xbox token if Xbox friends should be included. Requires Xbox be configured on PlayFab. */
+        /**
+         * Xbox token if Xbox friends should be included. Requires Xbox be configured on PlayFab. When provided, all Xbox Live
+         * users the caller is following are included regardless of whether they follow the caller back.
+         */
         public String XboxToken;
         
     }
@@ -2353,7 +2356,9 @@ public static class GetFriendsListRequest {
      * If any additional services are queried for the user's friends, those friends who also have a PlayFab account registered
      * for the title will be returned in the results. For Facebook, user has to have logged into the title's Facebook app
      * recently, and only friends who also plays this game will be included. For Xbox Live, user has to have logged into the
-     * Xbox Live recently, and only friends who also play this game will be included.
+     * Xbox Live recently, and only friends who also play this game will be included. Xbox Live friends include all users the
+     * caller is following, regardless of whether those users follow the caller back. This differs from FindFriendLobbies,
+     * which only considers mutual Xbox Live friends (where both users follow each other).
      */
     public static class GetFriendsListResult {
         /** Array of friends found. */
diff --git a/PlayFabServerSDK/src/main/java/com/playfab/PlayFabSettings.java b/PlayFabServerSDK/src/main/java/com/playfab/PlayFabSettings.java
@@ -8,9 +8,9 @@
 import com.playfab.PlayFabErrors.ErrorCallback;
 
 public class PlayFabSettings {
-    public static String SdkVersion = "0.255.260227";
+    public static String SdkVersion = "0.256.260313";
     public static String BuildIdentifier = "adobuild_javasdk_117";
-    public static String SdkVersionString = "JavaSDK-0.255.260227";
+    public static String SdkVersionString = "JavaSDK-0.256.260313";
 
     public static Map<String, String> RequestGetParams;
     static {
diff --git a/builds/client-sdk-0.256.260313.jar b/builds/client-sdk-0.256.260313.jar
diff --git a/builds/combo-sdk-0.256.260313.jar b/builds/combo-sdk-0.256.260313.jar
diff --git a/builds/server-sdk-0.256.260313.jar b/builds/server-sdk-0.256.260313.jar
