Kit de Herramientas para Portar Juegos de Xbox 360 a PC Nativo
MrMonkeyShopWare es una suite de herramientas diseñada para facilitar el proceso de portar juegos de Xbox 360 a PC nativo. Proporciona una interfaz gráfica moderna y una línea de comandos completa para gestionar todo el flujo de trabajo: desde el dump del disco hasta la organización de archivos para recompilación.
- 🎮 Desarrolladores de ports que trabajan en proyectos de recompilación
- 🔬 Investigadores que analizan ejecutables XEX
- 📦 Preservacionistas que mantienen backups organizados de sus juegos
| Característica | Descripción |
|---|---|
| 📀 Dump de Discos | Crea imágenes ISO desde discos Xbox 360 físicos |
| 📦 Extracción de ISOs | Extrae el contenido completo de imágenes ISO |
| 🔬 Análisis de XEX | Detecta metadata, librerías y entry points |
| 📁 Workspaces Organizados | Carpeta por juego con estructura estandarizada |
| 🔄 Sincronización | Centraliza archivos dispersos en el workspace |
| 💾 Base de Datos | Registro de todos los juegos procesados |
| 💿 USB Xbox 360 | Detecta juegos en pendrives formateados para Xbox |
| 🖥️ Disco Virtual | Trabaja con ISOs montadas directamente |
- Python 3.11+
- Windows 10/11
- Herramientas externas (opcionales):
- DiscImageCreator - Para dump de discos
- extract-xiso - Para extracción de ISOs
- XexTool - Para análisis de XEX
# Clonar repositorio
git clone https://github.com/MrMonkey09/MrMonkeyShopWare.git
cd MrMonkeyShopWare
# Crear entorno virtual
python -m venv venv
.\venv\Scripts\activate
# Instalar dependencias
pip install -r requirements.txtcd src
python -m gui.appLa GUI ofrece:
- Selector de tipo de entrada (Disco, ISO, Carpeta, USB)
- Vista de historial de juegos procesados
- Detalle de juego con checklist de archivos
- Visor de estructura de archivos TOML/JSON
- Configuración de herramientas externas
cd src
python -m cli.main --help| Comando | Descripción |
|---|---|
analyse <xex> |
Analiza un archivo XEX y crea workspace |
extract <iso> |
Extrae contenido de un ISO |
dump <drive> |
Crea ISO desde disco físico |
pipeline <drive> |
Pipeline completo (dump → extract → analyse) |
scan-usb <drive> |
Detecta juegos en USB Xbox 360 |
list |
Lista todos los workspaces |
info <title_id> |
Muestra información de un juego |
sync <title_id> |
Sincroniza archivos al workspace |
db list |
Lista juegos en base de datos |
# Analizar un XEX
python -m cli.main analyse "C:/Games/default.xex"
# Listar workspaces
python -m cli.main list
# Ver info de un juego
python -m cli.main info 4E4D07F5
# Escanear USB Xbox 360
python -m cli.main scan-usb E:Cada juego procesado se organiza automáticamente:
~/MrMonkeyShopWare/ports/
└── GameName [TitleID]/
├── info.json # Metadata del juego
├── notes.md # Notas del port
├── default.xex # XEX principal (si sincronizado)
├── game.iso # ISO original (si sincronizado)
├── analysis/ # Archivos de análisis
│ ├── analysis.toml
│ └── analysis.json
├── extracted/ # Contenido del ISO
├── cleaned/ # XEX limpios
└── recompiled/ # Código recompilado
Para documentación completa, visita:
¡Las contribuciones son bienvenidas! Por favor lee nuestra guía:
- Fork el repositorio
- Crea una rama (
git checkout -b feature/nueva-funcionalidad) - Commit tus cambios (
git commit -m 'Añade nueva funcionalidad') - Push a la rama (
git push origin feature/nueva-funcionalidad) - Abre un Pull Request
| Componente | Estado |
|---|---|
| Core | ✅ Estable |
| CLI | ✅ Completo |
| GUI | ✅ Funcional |
| Documentación | 🔄 En progreso |
| Tests | 🔄 Básicos |
Este proyecto está bajo la licencia MIT. Ver LICENSE para más detalles.
- Comunidad de Xbox 360 modding
- Desarrolladores de herramientas como XexTool, extract-xiso, DiscImageCreator
- Todos los colaboradores del proyecto
Hecho con ❤️ por MrMonkey y la comunidad