Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Sign up
Appearance settings

414ND1N/Mrpack-Installer

Folders and files

NameName
Last commit message
Last commit date

Latest commit

History

76 Commits

Repository files navigation

Mrpack Installer



📋 Descripción

Una herramienta de escritorio simple para instalar modpacks de Minecraft desde archivos .mrpack de Modrinth.

La aplicación se encarga de todo: analiza el archivo, descarga todas las dependencias (mods, loaders), instala la versión correcta de Minecraft y crea automáticamente un nuevo perfil en el launcher oficial.

✨ Características

  • Instalación Sencilla: Arrastra y suelta (o selecciona) tu archivo .mrpack para comenzar.

  • Gestión de Dependencias: Resuelve y descarga todos los mods y loaders (Forge, Fabric, Quilt) necesarios desde Modrinth.

  • Instalación de Versión: Instala la versión correcta de Minecraft si aún no la tienes.

  • Integración Total: Crea un perfil de juego completo en el launcher oficial de Minecraft. No necesitas configurar nada manualmente.

  • Actualizaciones Automáticas: La aplicación (próximamente) buscará e instalará nuevas versiones de sí misma al iniciar.

  • Interfaz Limpia: Una GUI moderna e intuitiva construida con React.

🚀 Instalación (Para Usuarios)

  1. Ve a la página de Releases de este repositorio.
  2. Descarga el archivo Mrpack-Installer-Setup-X.X.X.exe de la última versión.
  3. Ejecuta el instalador. ¡Y listo!

💻 Pila Tecnológica

Este proyecto utiliza una arquitectura híbrida:

  • Frontend (GUI): Electron + React (usando Vite).

  • Backend (Lógica): Python con FastAPI. El backend corre como una API local (http://localhost:8001) para manejar la lógica pesada de descargar archivos y gestionar el launcher de Minecraft.

  • Empaquetado: Electron Builder empaqueta la app de Electron, y PyInstaller compila el script de Python en un backend.exe que se incluye dentro de la app.

🛠️ Desarrollo (Correr Localmente)

¿Quieres contribuir o modificar el proyecto?

Requisitos previos:

  • Node.js (v18+ recomendado)
  • Python (v3.12.X recomendado)
  • npm o pnpm

Pasos:

  1. Clonar el repositorio:
git clone https://github.com/414ND1N/Mrpack-Installer.git
cd Mrpack-Installer
  1. Preparar el Backend (Python):
  • Ve a la carpeta del backend (ej. backend/).
  • Crea un entorno virtual: python -m venv venv
  • Actívalo
    • (Windows): .\venv\Scripts\activate
    • (Linux/Mac): source venv/bin/activate
  • Instala las dependencias: pip install -r requirements.txt
  1. Preparar el Frontend (Electron/React):
  • Regresa a la raíz del proyecto.
  • Instala las dependencias de Node.js:
npm install
  1. Ejecutar

El script dev lanzará el backend de Python y la app de Electron simultáneamente.

npm run dev

📦 Compilación (Build)

Para crear el instalador .exe final:

  1. Compilar el Backend:
  • Activa tu entorno virtual de Python.
python -m venv venv
.\venv\Scripts\activate
  • Ve a la carpeta del backend y ejecuta:
pyinstaller --onefile --name mrpack-installer api.py
  • Mueve el archivo mrpack-installer.exe resultante (de la carpeta dist/) a la carpeta api/ en la carpeta frontend/api.
  1. Compilar y Empaquetar Electron:

Desde la raíz del proyecto, corre:

npx run build

Esto generará el instalador en la carpeta dist/ y el ejecutable en dist/win-unpacked/.

Bibliotecas/Herramientas Utilizadas

Un agradecimiento especial a Modrinth por crear el formato .mrpack y la API que facilita la descarga de mods y modpacks, y a Minecraft Launcher Lib por simplificar la gestión del launcher de Minecraft.

About

Simple desktop application to easily install Minecraft modpacks with modrinth mrpacks format

Topics

Resources

Stars

Watchers

Forks

Contributors

AltStyle によって変換されたページ (->オリジナル) /