Xbox One:Dumping Games

Ensure that your network is setup to prevent the Xbox from reaching the internet. It's recommended to block your Xbox's MAC addresses from accessing the WAN in your router settings, to turn off auto-updates, and to set the DNS setting on the Xbox to 127.0.0.1.

This page will walk you through dumping Xbox One/Series games on a compatible firmware device.

Page still WIP. Disc dumping will be added soon. Derf (talk) 07:18, 13 August 2024 (UTC)

Credit to InvoxiPlayGames/Emma and XboxOneResearch for most of these tools, BirdonWheels for the original guide which was used as the basis for this page, and burninrubber0 from the Xbox Scene Discord for the dump.bat script. A video tutorial can be found on KsAmJ Gaming & Tech's YouTube channel.

Dumping Games

Pre-requisites

• Xbox One / Series firmware version 4478.
  • Not working on firmware 4908 or 4909, as the Temp Drive is 0 bytes
  • Edit this if it works for you on other firmware!
• A copy of Warhammer Vermintide 2:
  • Digital copy will allow you to dump a disc OR digital game
  • Disc copy will allow you to dump a digital game
• The game you are dumping must be installed on your Internal Storage.
• The game you are dumping must be able to be launched.
  • "Check your connection" - This error will show if it successfully launched, but the game requires an internet connection. These games can be dumped.
  • "To start this game or app you need to be signed in to the Xbox network." - You do not have a valid license for the game. It either was purchased and never launched or an expired Game Pass game. You cannot dump these games.
  • "Use this Xbox regularly? Make it your home Xbox so you can play games you own, even offline." - Displayed when you attempt to launch a game licensed to an account that does not have this Xbox set as the home Xbox. You cannot dump these games.
• Backup the game you want to dump, as the original copy will break. Copy the game to a USB flash drive via the Xbox dashboard.
• Games that are less than 2GB, or larger than 39GB will not be able to be dumped via this method unless you resize your temp partition, which is not covered here yet.
• Preferably connect your Xbox via ethernet, as Wi-Fi connections have been shown to drop files out of dumps.
• Certain games appear to not be dumpable using this method. The known issue games are:
  • Minecraft
  • Undertale
  • Tony Hawk's Pro Skater 1+2

PC Preparation

1. Download the File:Xbox One Game Dumping Pack v1.0.zip and extract it to your PC. This contains everything you need (except Microsoft .NET) to dump games.
2. Download the .NET 6.0 SDK x86_64 Binary for Windows.
3. Format a USB flash drive as NTFS.
4. Extract dotnet-sdk-6.0.424-win-x64.zip into the \Copy to Flash Drive\dotnet\ folder.
5. Copy the contents of the Copy to Flash Drive folder to the root of your USB flash drive and safely eject the flash drive.
6. Open the OneDumpgame folder and open dumpgame.lua in Notepad. Replace the IP address near the top with the IP of your PC and save.
7. Open the collateral_damage_v1_remote folder and edit gamescript_autosave_network.txt. Replace YOUR IP HERE with the IP address of the PC you are going to run the exploit from.
8. In the LuaFFI-CE folder, edit stage1.lua and replace "YOUR IP HERE" in local serverIp = "YOUR IP HERE" with your PC's IP address.
9. In the LuaFFI-CE folder, edit stage2.lua and replace "YOUR IP HERE" in local serverIp = "YOUR IP HERE" with your PC's IP address.

Game Script Reverse Shell (SystemOS)

A successful execution of Collateral Damage for Xbox One/Series, returning a reverse shell.

Perform the Collateral Damage Game Script exploit as detailed below to obtain a reverse shell.

1. If you haven't already, launch Warhammer Vermintide 2, press A to start game, and choose "Use Offline". This will create a game save on your hard drive.
2. Run miniweb.exe. If it asks for permissions to run, check both boxes and select "Allow Access". A command prompt window should open.
   • Note the IP address and port listed, e.g. 192.168.1.77:8000.
3. On your Xbox, open Microsoft Edge and enter the full IP address and port into the address bar (e.g. 192.168.1.77:8000). It should list the file present in the htdocs folder on your PC.
4. Select gamescript_autosave_network.txt. It should display the contents of the script. Hover your cursor before the very first character, then hold A and drag the left stick down to highlight all of the text. Let go of A and then select "Copy" from the small menu that opens up.
5. Launch the Game Script app. Use the D-PAD to highlight "Paste code" and press A to paste the contents of the file you copied. Press B to close the keyboard.
6. Double-click gamescript_reverse_shell.bat. It will open a window for the server process with the last line being "Server listening..." and a second window running NetCat with the text "listening on [any] 7070 ...".
   • It may ask multiple times for permission to run on the network, check both boxes and select "Allow Access".
7. On your Xbox, open the Game Script app if not already there. Hold X and press RB to select "Windows", then let go of X.
8. Using the D-PAD, select "Show Code Run window" and press A. On the new window that pops up, highlight the "Run code once" button and press A.
   • After about 10-60 seconds, some traffic will appear on the payload and NetCat command windows, and if successful, you will have a reverse shell on the NetCat command window to be able to run commands against the Xbox.
   • If the Game Script app or the NetCat window closes, re-launch them and try again. If after multiple attempts it is still crashing, go to Settings > General > Power Options > Shutdown now, then turn your console back on and try again.

Modifying the Vermintide Game Save

These steps will guide you through modifying your Vermintide game save to be able to run the game dumper.

1. In the reverse shell, enter the following commands:

    set DOTNET_CLI_TELEMETRY_OPTOUT=1
    D:\dotnet\dotnet.exe msbuild D:\mount_connectedstorage.xml 
   

• The previous command will output the Harddisk# where your saves are located (e.g. XVD Mounted to \\?\GLOBALROOT\Device\Harddisk16\Partition1 indicates it is on Harddisk16). The rest of this guide will use Harddisk16 as an example.
2. In the reverse shell, enter the following command, substituting your own Harddisk#, and your game saves and licenses will be dumped:

mklink /j T:\connectedStorage "\\?\GLOBALROOT\Device\Harddisk16\Partition1\"
T:
cd connectedStorage
D:\dump.bat
mkdir D:\Licenses
copy S:\Clip D:\Licenses

3. When it completes, unplug your USB flash drive and plug it into your PC.
4. On the flash drive, navigate to \xb1\saves\connectedStorage\u_################_C05F0100-EAC5-49EB-943F-1A0E3C108361\. This is your save for Warhammer Vermintide 2. Open the sole folder and there should be two files, one of them has a unique ID and the other is named "container". Open the unique ID file with notepad, delete all of the contents, and then paste the entire contents of LuaFFI-CE\stage1.lua into it and save.
5. Write down the path to this game save for future use, e.g. \xb1\saves\connectedStorage\u_1111111111111111_C05F0100-EAC5-49EB-943F-1A0E3C108361\{AABBCCDD-EEFF-GGHH-IIJJ-KKLLMMNNOOPP}.
6. Safely Eject your USB flash drive and plug it into your Xbox.
7. In the reverse shell, enter the following command, substituting your own path, and type "All" when prompted to overwrite:

copy D:\xb1\saves\connectedStorage\{AABBCCDD-EEFF-GGHH-IIJJ-KKLLMMNNOOPP}  T:\connectedStorage\u_1111111111111111_C05F0100-EAC5-49EB-943F-1A0E3C108361\{AABBCCDD-EEFF-GGHH-IIJJ-KKLLMMNNOOPP}

8. Reboot your Xbox. This is required to unlink T:\connectedStorage.

Dumping your Game

The next steps will walk you through setting up the server that will receive the game dump(s).

1. Copy the contents of the Licenses folder on the flash drive into the \LicenseClipFinder\Clips\ folder on your PC.
2. Double click run_license_clip_finder.bat to start LicenseClipFinder. It will output a "Licenses.txt" file which will contain the content ID and license file associated with all of your games.
   • If you do not have a recent enough .NET version, it may prompt you with a link to download it from Microsoft. Install it and try again.
3. If not already done, copy the game you wish to dump to a USB flash drive, as the dumping process will break the game and it will be useful to have a backup.
4. Start Warhammer Vermintide 2. Press the Xbox (home) button, then on the Warhammer icon press Start and choose "Quit".
5. Plug your flash drive into the Xbox.
6. On your PC, run gamescript_reverse_shell.bat again.
7. Open the Game Script app and run the exploit again by holding X and pressing RB to select window, selecting "Show Code Run window", and clicking "Run code once" to obtain a reverse shell again.
8. In the reverse shell, enter:

   D:\dotnet\dotnet.exe msbuild D:\get_tempxvd_owners.xml
   

9. Temporary XVD(s) will be listed. Note the value listed for "Vermintide2", e.g. 00. Avoid launching any games on your system from this point onward, as it may change this value.
10. Plug your flash drive into your PC and edit prepare_gamedump.xml. Search for /* EDIT ME */ and you will find a marked section toward the bottom with three lines that you will need to edit:
    • Replace the 00 in temp00 with the value found in the last step (if it's not 00)
    • Replace PUT-CONTENT-ID-OF-GAME-HERE with the content ID for the game you want to dump listed in your Licenses.txt file
    • Replace PUT-LICENSE-FILE-NAME-HERE with the name of the file of the game you want to dump listed in your Licenses.txt file (numbers and letters following .\Clips\)
11. Plug your USB flash drive back into your Xbox.
12. In the reverse shell, enter:

    D:\dotnet\dotnet.exe msbuild D:\prepare_gamedump.xml
    

13. If successful, it will stream the files into the temp XVD for Warhammer Vermintide 2 and constantly update the status. When complete, it will show "License file loaded".
    • If the game is >39GB, it may fail out and show the error "There is not enough space on the disk".
14. Double-click dump_game.bat. It will open another NetCat instance and a second window showing "Waiting for connection...".
    • It may ask multiple times for permission to run on the network, check both boxes and select "Allow Access".
15. Launch Warhammer Vermintide 2 and press "A" on the title screen. If everything was done correctly, the game should freeze and you should see traffic in one of the command prompt windows and the files being written to .\OneDumpgame\tx\.
    • If anything appears wrong, see the troubleshooting section below. You can always close Warhammer Vermintide 2 and re-open it, repeating this step.
16. It's highly recommended to copy the contents of .\OneDumpgame\tx\ to another folder and dump the game again. Afterwards, check the file size of both folders to make sure they exactly match, verifying that you had a good dump.

Optional Steps

Restoring Games after Dumping

You may notice that your game might not start after successfully running prepare_gamedump.xml, and it will be stuck in an updating state.

1. Uninstall the game from the internal storage. The Xbox may appear to be stuck when attempting to uninstall the game, but be patient and if reboot until the game is gone from Internal Storage.
2. Copy the game over from USB External Storage to the Internal Storage via the Storage Devices option in Settings.
3. Use Game Script to obtain a reverse shell. Copy the license for game from USB flash drive to S:\Clip.
4. Reboot Xbox, then start the game. It will get the game ready and then launch.

Warhammer Reverse Shell (GameOS)

In the event that you want to see what files were streamed to the Warhammer XVD, you can open up a reverse shell into Warhammer.

1. Double-click warhammer_reverse_shell.bat. It will open a NetCat instance and a second window showing "Waiting for connection...".
2. Launch Warhammer Vermintide 2 and press "A" on the title screen. You should now have a reverse shell.
3. Enter T: to change to the T: drive and enter dir to see the contents streamed over from your chosen game. All contents of this folder will be uploaded to your PC if you exit and run the dump_game.bat instead.

Troubleshooting

• Cannot find the file specified error:

  The "PrepareGameDump" task failed unexpectedly. System.IO.FileNotFoundException: The system cannot find the file specified (0x80070002)

  • Make sure the game is installed on the Xbox's Internal Storage.
  • In prepare_gamedump.xml, check if the content ID and license file paths in the "edit me" section match the desired game as specified in your Licenses.txt file.
• There is not enough disk space error:

   D:\prepare_gamedump.xml(529,7): error MSB4018: The "PrepareGamedump" task failed unexpectedly. D:\prepare_gamedump.xml(529,7): error MSB4018: System.Runtime.InteropServices.COMException (0x80070070): There is not enough space on the disk. (0x80070070) 

  • This means that the Temp content partition on your Xbox is too small, it must be resized. Likely, this indicates that the game is >39GB in size. A guide has not yet been written for how to resize this partition.
• Only one file is dumped:
  • This occurs if you do not have a proper license for a game. It will dump a plaintext appxmanifest.xml successfully and then attempt to dump the next file but it will be 0 bytes and hang.
• No files are dumped:
  • Sometimes, it will hang on the first file. Re-run dump_game.bat and open Warhammer Vermintide 2 to try again.
  • Some games, such as Tony Hawk's Pro Skater 1+2 seem to not be compatible. This generally happens if the file streaming portion of the process completes extremely quickly (e.g. 10 seconds), as it did not stream files to the temporary XVD. You can use the Warhammer reverse shell section above to check if any files were loaded into the temporary XVD.
• The Xbox never connects to the PC:
  • If no connection is ever made from your Xbox, check your firewall rules. If you only select "Private network" when prompted to add exclusions for the programs, double check that your network is set to Private instead of Public. Also check that your PC's IP address has not changed from what you configured in the text files.