Skip to content

Instantly share code, notes, and snippets.

@rtm516
Last active January 25, 2026 09:39
Show Gist options
  • Select an option

  • Save rtm516/725fa1e38aafd2600976113ccc45a496 to your computer and use it in GitHub Desktop.

Select an option

Save rtm516/725fa1e38aafd2600976113ccc45a496 to your computer and use it in GitHub Desktop.
Bedrock new XVC download system

Bedrock new XVC download system

As of Bedrock Preview 1.21.120.21 minecraft is using the new Game Development Kit and moving away from UWP. They are nolonger packaged as APPX but instead as MSIXVC which requires a new way of fetching and is far easier than previous methods but requires authentication. This hopefully will explain how to download the new format.

Quick ref

Product PackageId ProductId ContentId
Minecraft Bedrock Microsoft.MinecraftUWP 9NBLGGH2JHXJ 7792d9ce-355a-493c-afbd-768f4a77c3b0
Minecraft Preview Microsoft.MinecraftWindowsBeta 9P5X4QVLC2XR 98bd2335-9b01-4e4c-bd05-ccc01614078b

Get the content ID

Content IDs are static for all versions of an app, there are 2 ways of getting these.

Display Catalog

This gives alot of information about the product on the store likely more than most people need

GET https://displaycatalog.mp.microsoft.com/v7.0/products/9P5X4QVLC2XR?market=US&languages=en-US,en,neutral

For the content ID look for Product.DisplaySkuAvailabilities[0].Sku.Properties.Packages[0].ContentId

Example:

{
  "Product": {
    "DisplaySkuAvailabilities": [
      {
        "Sku": {
          "Properties": {
            "Packages": [
              {
                "ContentId": "98bd2335-9b01-4e4c-bd05-ccc01614078b"
				...
              }
			  ...
            ]
			...
          }
		  ...
        }
		...
      }
	  ...
    ]
	...
  }
}

Xbox Store SDK

This is a much simpler way to get the content ID and returns far less information so likely preferable for most people.

This can also be used to get the content ID for both windows (Windows.Desktop) and xbox one (Windows.Xbox).

Example to get the content ID for Minecraft Preview (9P5X4QVLC2XR) and Windows Desktop device family (Windows.Desktop):

GET https://storesdk.dsx.mp.microsoft.com/v8.0/Sdk/products/contentId?market=neutral&locale=neutral&languages=neutral%2Cen-US&deviceFamily=Windows.Desktop&productIds=9P5X4QVLC2XR
{
  "Items": [
    {
      "ProductId": "9P5X4QVLC2XR",
      "ContentIds": [
        "98bd2335-9b01-4e4c-bd05-ccc01614078b"
      ],
      "KeyIds": [
        "98bd2335-9b01-4e4c-bd05-ccc01614078b"
      ]
    }
  ]
}

Get the latest download URL

This endpoint requires standard Xbox Live authentication, with XSTS using the http://update.xboxlive.com relaying party. See here for more information on how to get the required token.

Example to get the latest version for Minecraft Preview (98bd2335-9b01-4e4c-bd05-ccc01614078b):

GET https://packagespc.xboxlive.com/GetBasePackage/98bd2335-9b01-4e4c-bd05-ccc01614078b
Authorization: XBL3.0 x=<uhs>;<token>
{
  "PackageFound": true,
  "ContentId": "98bd2335-9b01-4e4c-bd05-ccc01614078b",
  "VersionId": "1.21.12021.0.2212524b-5ddc-41da-b1f9-bccef6999bbf",
  "PackageFiles": [
    {
      "ContentId": "98bd2335-9b01-4e4c-bd05-ccc01614078b",
      "VersionId": "1.21.12021.0.2212524b-5ddc-41da-b1f9-bccef6999bbf",
      "FileName": "update-1.21.12060.0.c75661ae-0d7e-4f72-b89f-4ed8bc6c4de2.xsp",
      "FileSize": 6720,
      "FileHash": "",
      "KeyBlob": "",
      "CdnRootPaths": [
        "http://assets1.xboxlive.com/6/3fb6ef30-43ba-4849-b2c1-3f25558ca0f3/",
        "http://assets2.xboxlive.com/6/3fb6ef30-43ba-4849-b2c1-3f25558ca0f3/"
      ],
      "BackgroundCdnRootPaths": [
        "http://d1.xboxlive.com/6/3fb6ef30-43ba-4849-b2c1-3f25558ca0f3/",
        "http://d2.xboxlive.com/6/3fb6ef30-43ba-4849-b2c1-3f25558ca0f3/"
      ],
      "RelativeUrl": "98bd2335-9b01-4e4c-bd05-ccc01614078b/1.21.12021.0.2212524b-5ddc-41da-b1f9-bccef6999bbf/update-1.21.12060.0.c75661ae-0d7e-4f72-b89f-4ed8bc6c4de2.xsp",
      "UpdateType": 0,
      "DeltaVersionId": null,
      "LicenseUsageType": 0,
      "ModifiedDate": "2025-09-09T14:39:25+00:00"
    },
    {
      "ContentId": "98bd2335-9b01-4e4c-bd05-ccc01614078b",
      "VersionId": "1.21.12021.0.2212524b-5ddc-41da-b1f9-bccef6999bbf",
      "FileName": "Microsoft.MinecraftWindowsBeta_1.21.12021.0_x64__8wekyb3d8bbwe.msixvc",
      "FileSize": 1743065088,
      "FileHash": "",
      "KeyBlob": "",
      "CdnRootPaths": [
        "http://assets1.xboxlive.com/12/66b02bc1-c4f1-4986-a183-c23e00cccecb/",
        "http://assets2.xboxlive.com/12/66b02bc1-c4f1-4986-a183-c23e00cccecb/"
      ],
      "BackgroundCdnRootPaths": [
        "http://d1.xboxlive.com/12/66b02bc1-c4f1-4986-a183-c23e00cccecb/",
        "http://d2.xboxlive.com/12/66b02bc1-c4f1-4986-a183-c23e00cccecb/"
      ],
      "RelativeUrl": "98bd2335-9b01-4e4c-bd05-ccc01614078b/1.21.12021.0.e5cfeb9c-2eaa-4959-8a49-e82cde29702a/Microsoft.MinecraftWindowsBeta_1.21.12021.0_x64__8wekyb3d8bbwe.msixvc",
      "UpdateType": 0,
      "DeltaVersionId": null,
      "LicenseUsageType": 0,
      "ModifiedDate": "2025-09-09T14:39:25+00:00"
    }
  ],
  "Version": "1.21.12021.0.2212524b-5ddc-41da-b1f9-bccef6999bbf",
  "PackageMetadata": {
    "EstimatedTotalDownloadSize": 0,
    "BackgroundCdnRootPaths": [
      "http://d1.xboxlive.com/12/66b02bc1-c4f1-4986-a183-c23e00cccecb/",
      "http://d2.xboxlive.com/12/66b02bc1-c4f1-4986-a183-c23e00cccecb/"
    ],
    "CdnRoots": [
      "http://assets1.xboxlive.com/12/66b02bc1-c4f1-4986-a183-c23e00cccecb/",
      "http://assets2.xboxlive.com/12/66b02bc1-c4f1-4986-a183-c23e00cccecb/"
    ],
    "Files": [
      {
        "Name": "update-1.21.12060.0.c75661ae-0d7e-4f72-b89f-4ed8bc6c4de2.xsp",
        "Size": 6720,
        "RelativeUrl": "98bd2335-9b01-4e4c-bd05-ccc01614078b/1.21.12021.0.2212524b-5ddc-41da-b1f9-bccef6999bbf/update-1.21.12060.0.c75661ae-0d7e-4f72-b89f-4ed8bc6c4de2.xsp",
        "License": ""
      },
      {
        "Name": "Microsoft.MinecraftWindowsBeta_1.21.12021.0_x64__8wekyb3d8bbwe.msixvc",
        "Size": 1743065088,
        "RelativeUrl": "98bd2335-9b01-4e4c-bd05-ccc01614078b/1.21.12021.0.e5cfeb9c-2eaa-4959-8a49-e82cde29702a/Microsoft.MinecraftWindowsBeta_1.21.12021.0_x64__8wekyb3d8bbwe.msixvc",
        "License": ""
      }
    ]
  },
  "HashOfHashes": null,
  "UpdatePredownload": false,
  "AvailabilityDate": "2025-09-09T16:00:00"
}

All you need from this response is the PackageMetadata.CdnRootPaths and PackageMetadata.Files[].RelativeUrl to construct the download URL. The file you want to look for is the .msixvc as thats the full package, the other .xsp file is just an update file.

Get a given versions download URL

Like above this needs authentication through Xbox Live with the required XSTS relaying party. The difference is you need to provide the version ID you want to download. This can be found in the previous request for getting the latest version as the VersionId field.

Example to get version 1.21.120.21 (1.21.12021.0.2212524b-5ddc-41da-b1f9-bccef6999bbf) for Minecraft Preview (98bd2335-9b01-4e4c-bd05-ccc01614078b):

GET https://packagespc.xboxlive.com/GetSpecificBasePackage/98bd2335-9b01-4e4c-bd05-ccc01614078b/1.21.12021.0.2212524b-5ddc-41da-b1f9-bccef6999bbf
Authorization: XBL3.0 x=<uhs>;<token>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment