adds ENDGAME v1.0

.gitignore

@@ -158,3 +158,7 @@ cython_debug/
 #  and can be added to the global gitignore or merged into this file.  For a more nuclear
 #  option (not recommended) you can uncomment the following to ignore the entire idea folder.
 #.idea/
+
+# ignore ENDGAME build files
+shellcode
+/ENDGAME

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Markus Gaasedelen
+
+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.

README.md

@@ -0,0 +1,99 @@
+# ENDGAME - A Dashboard Exploit for the Original Xbox
+
+<p align="center">
+  <img src="https://github.com/XboxDev/endgame-exploit/assets/9522648/84c9890a-0d57-4d32-bcd6-d43ff8738ebf">
+</p>
+
+## Overview
+
+ENDGAME is a universal dashboard exploit for the original [Microsoft Xbox](https://en.wikipedia.org/wiki/Xbox_(console)). This exploit has been carefully engineered to be compatible across all retail kernel and dashboard versions released for the original Xbox. It does not require a game, or even a working DVD drive -- *only a memory card.*
+
+Special credit belongs to [@shutterbug2000](https://twitter.com/shutterbug20002) for the initial discovery of this vector within the dash and the first to demonstrate code execution against it. With further research, ENDGAME was developed by [@gaasedelen](https://twitter.com/gaasedelen) leveraging an adjacent vulnerability that offered greater control and facilitated a more ubiquitous exploitation strategy.
+
+## Disclaimer
+
+**This project does NOT use any copyrighted code, or help circumvent security mechanisms of an Xbox console.** Upon success, ENDGAME will launch a [habibi](http://toogam.bespin.org/xboxmod/site/signxbe.htm)-signed XBE from the root of the memory card. It does not patch kernel code or allow you to launch retail-signed executables.
+
+By using this software, you accept the risk of experiencing total loss or destruction of data on the console in question.
+
+## Building
+
+The exploit files can be generated from scratch using Python 3 + NASM on Windows.
+
+Example usage is provided below:
+
+```bash
+python main.py
+```
+
+Successful output should look something like the following:
+
+```
+[*] Generating ENDGAME v1.0 exploit files -- by Markus Gaasedelen & shutterbug2000
+[*] Assembling shellcode... done
+[*] Un-swizzling payload... done
+[*] Compressing payload... done
+[*] Saving helper files... done
+[*] Saving trigger files... done
+[+] Success, exploit files available in ENDGAME/ directory
+```
+
+A pre-built zip of the exploit and sample payload XBE is available on the [releases](https://github.com/XboxDev/endgame-exploit/releases) page of this repository.
+
+## Usage
+
+Copy the contents of the generated `ENDGAME/` directory to a Xbox memory card such that the root directory of the memory card has the following structure, where `payload.xbe` can be any [habibi](http://toogam.bespin.org/xboxmod/site/signxbe.htm)-signed XBE of your choosing:
+
+```bash
+/helper/
+/trigger/
+/payload.xbe
+```
+
+To trigger the exploit, plug the memory card into a controller and navigate to it while in the dashboard.
+
+<p align="center">
+  <img src="https://github.com/XboxDev/endgame-exploit/assets/9522648/d4701947-8174-4186-ae27-affd8a7778b8">
+</p>
+
+After a few seconds, the system should begin cycling the front LED to green/orange/red to indicate success. This is followed by it launching the `payload.xbe` placed on the memory card.
+
+# FAQ
+
+#### Q: Is this a softmod?
+
+* *A: No, by itself, ENDGAME is not a softmod. But it will make softmodding significantly more accessible as the community integrates it into existing softmod solutions.*
+
+#### Q: What is new about this exploit?
+
+* *A: This exploit will enable people to softmod any revision of the original Xbox without needing a specific game. It will also allow people to easily launch a homebrew XBE (such as the [Insignia setup assistant](https://insignia.live/connect), or content scanning tools) by simply inserting a memory card into an unmodded Xbox.*
+
+#### Q: I don't have a memory card, can I use something else?
+
+* *A: Yes, any FATX-formatted compatible USB device and controller port dongle should work.*
+
+#### Q: Why am I getting Error 21 after placing my own XBE on the memory card?
+
+* *A: Your XBE must be signed using the [habibi](http://toogam.bespin.org/xboxmod/site/signxbe.htm) key. Several tools can do this, `xbedump` being the most popular.*
+
+#### Q: Why does my habibi-signed XBE result in a black screen with ENDGAME but not on a modded xbox?
+
+* *A: The most common explanation is that your XBE may be using the Debug/XDK __kernel thunk__ & __entry point__ [XOR keys](https://xboxdevwiki.net/Xbe) rather than the retail ones, resulting in a crash.*
+
+#### Q: I triggered ENDGAME but my system quickly rebooted to the dash rather than my XBE...
+
+* *A: While this should be uncommon, it means the exploit probably crashed. It's recommended to navigate straight to the memory card on a cold boot for successful exploitation.*
+
+#### Q: My XBE requires multiple files and external assets to run, will it work with ENDGAME?
+
+* *A: No. Currently, ENDGAME is only structured to copy & execute a standalone XBE.*
+
+#### Q: How does this exploit work?
+
+* *A: The exploit targets an integer overflow in the dashboard's handling of savegame images. When the dash attempts to parse the specially crafted images on the memory card, ENDGAME obtains arbitrary code execution.*
+
+# Authors
+
+* shutterbug ([@shutterbug2000](https://twitter.com/shutterbug20002)), discovery and initial exploitation efforts
+* Markus Gaasedelen ([@gaasedelen](https://twitter.com/gaasedelen)), root-cause-analysis & ENDGAME development
+* xbox7887 ([@xbox7887](https://twitter.com/xbox7887)), minor contributions and assistance with testing