{"id":29099290,"url":"https://github.com/luminakraft/luminakraftlauncher","last_synced_at":"2026-05-06T01:05:47.455Z","repository":{"id":301462124,"uuid":"1000454807","full_name":"LuminaKraft/LuminaKraftLauncher","owner":"LuminaKraft","description":"A modern, cross-platform Minecraft launcher built with Tauri and React. Features Microsoft authentication, modpack management, automatic updates, and multi-language support. Native builds for Windows, macOS, and Linux.","archived":false,"fork":false,"pushed_at":"2025-06-27T02:11:39.000Z","size":2785,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-06-27T02:25:20.031Z","etag":null,"topics":["automatic-updates","cross-platform","curseforge","desktop-app","game-launcher","linux","macos","microsoft-authentication","minecraft","minecraft-launcher","modpack-manager","multilingual","native-app","react","rust","tailwindcss","tauri","typescript","vite","windows"],"latest_commit_sha":null,"homepage":"https://www.luminakraft.com","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/LuminaKraft.png","metadata":{"files":{"readme":"README.es.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"COPYING.md","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-06-11T20:09:24.000Z","updated_at":"2025-06-27T02:11:42.000Z","dependencies_parsed_at":"2025-06-27T02:25:25.937Z","dependency_job_id":"5f849dcc-0761-453b-a260-b6258b8ae7cc","html_url":"https://github.com/LuminaKraft/LuminaKraftLauncher","commit_stats":null,"previous_names":["luminakraft/luminakraftlauncher"],"tags_count":6,"template":false,"template_full_name":null,"purl":"pkg:github/LuminaKraft/LuminaKraftLauncher","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LuminaKraft%2FLuminaKraftLauncher","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LuminaKraft%2FLuminaKraftLauncher/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LuminaKraft%2FLuminaKraftLauncher/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LuminaKraft%2FLuminaKraftLauncher/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/LuminaKraft","download_url":"https://codeload.github.com/LuminaKraft/LuminaKraftLauncher/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LuminaKraft%2FLuminaKraftLauncher/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":262457931,"owners_count":23314288,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["automatic-updates","cross-platform","curseforge","desktop-app","game-launcher","linux","macos","microsoft-authentication","minecraft","minecraft-launcher","modpack-manager","multilingual","native-app","react","rust","tailwindcss","tauri","typescript","vite","windows"],"created_at":"2025-06-28T16:02:14.802Z","updated_at":"2025-12-30T19:34:34.318Z","avatar_url":"https://github.com/LuminaKraft.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 💎 LuminaKraft Launcher\n\n[![en](https://img.shields.io/badge/lang-en-red.svg)](https://github.com/LuminaKraft/LuminakraftLauncher/blob/main/README.md)\n[![es](https://img.shields.io/badge/lang-es-yellow.svg)](https://github.com/LuminaKraft/LuminakraftLauncher/blob/main/README.es.md)\n\n[![Descargas](https://img.shields.io/github/downloads/LuminaKraft/LuminakraftLauncher/total.svg)](https://github.com/LuminaKraft/LuminakraftLauncher/releases)\n[![Versión](https://img.shields.io/github/release/LuminaKraft/LuminakraftLauncher.svg)](https://github.com/LuminaKraft/LuminakraftLauncher/releases/latest)\n[![Licencia](https://img.shields.io/github/license/LuminaKraft/LuminakraftLauncher.svg)](LICENSE)\n[![Estado de Compilación](https://img.shields.io/badge/build-passing-brightgreen.svg)](https://github.com/LuminaKraft/LuminakraftLauncher/actions)\n\nUn launcher moderno y multiplataforma para Minecraft construido con **Tauri** y **React**, que incluye actualizaciones automáticas, autenticación de Microsoft y gestión de modpacks usando la librería **Lyceris**.\n\n![Captura de LuminaKraft Launcher](assets/images/launcher-main.png)\n\n## ✨ Características\n\n- 🔐 **Autenticación de Microsoft**: Inicio de sesión seguro con tu cuenta de Microsoft\n- 📦 **Gestión de Modpacks**: Navega e instala modpacks desde CurseForge\n- 🔄 **Actualizaciones Automáticas**: Launcher con auto-actualización y gestión de versiones\n- 🌍 **Soporte Multi-idioma**: Disponible en inglés y español\n- 🖥️ **Multiplataforma**: Soporte nativo para Windows, macOS y Linux\n- ⚡ **Interfaz Moderna**: Interfaz hermosa y responsiva construida con React y Tailwind CSS\n- 🎮 **Integración con Minecraft**: Potenciado por la librería Lyceris para gestión robusta del juego\n- 🔧 **Instalación Fácil**: Instalación y gestión de modpacks con un clic\n- 📊 **Seguimiento de Progreso**: Progreso de descarga e instalación en tiempo real\n- 🎨 **Temas Personalizados**: Soporte para modo claro y oscuro\n\n## 📸 Capturas de Pantalla\n\n| Interfaz Principal | Características del Launcher | Instalación en macOS |\n|:---:|:---:|:---:|\n| ![Interfaz Principal](assets/images/launcher-main.png) | ![Características](assets/images/launcher-main.png) | ![Instalación macOS](assets/images/macos-installation.png) |\n\n## 🎯 Éxito de Compilación Multiplataforma\n\nTodas las plataformas se compilan automáticamente via GitHub Actions:\n\n### ✅ Plataformas Soportadas\n- **Windows**: Ejecutable `.exe` (NSIS) + instalador `.msi` (WiX)\n- **macOS**: Archivos DMG universales (Intel + ARM64) + paquetes `.app`  \n- **Linux**: AppImage + paquetes .deb/.rpm\n\n### 📦 Artefactos de Compilación\nTodas las salidas de compilación se generan automáticamente via GitHub Actions y están disponibles en Releases:\n```\nReleases/\n├── LuminaKraft Launcher_x.x.x_x64-setup.exe          # Instalador NSIS de Windows (RECOMENDADO)\n├── LuminaKraft Launcher_x.x.x_x64_es-ES.msi          # Instalador MSI de Windows\n├── LuminaKraft Launcher_x.x.x_x64.dmg                # DMG de macOS Intel\n├── LuminaKraft Launcher_x.x.x_aarch64.dmg            # DMG de macOS ARM64\n├── LuminaKraft Launcher_x.x.x_amd64.AppImage         # AppImage de Linux\n├── LuminaKraft Launcher_x.x.x_amd64.deb              # Paquete Debian de Linux\n└── LuminaKraft Launcher-x.x.x-1.x86_64.rpm           # Paquete RPM de Linux\n```\n\n## 🚀 Instalación\n\n### 📥 Guía de Instalación Rápida\n\n#### 🪟 **Windows** (Plataforma Recomendada)\n\n1. **Descargar**: Ve a [Versiones](https://github.com/LuminaKraft/LuminakraftLauncher/releases/latest)\n   - **🔥 RECOMENDADO**: `LuminaKraft Launcher_x.x.x_x64-setup.exe` (instalador NSIS - permite limpiar datos al desinstalar)\n   - **Alternativo**: `LuminaKraft Launcher_x.x.x_x64_es-ES.msi` (instalador MSI - para entornos corporativos)\n\n2. **Ejecutar Instalador**: Haz doble clic en el archivo descargado\n\n3. **⚠️ Advertencia de Windows Defender SmartScreen**:\n   - Si ves \"**Windows protegió tu PC**\":\n   - Haz clic en \"**Más información**\"\n   - Haz clic en \"**Ejecutar de todas formas**\"\n   - Esto ocurre porque la aplicación aún no está firmada con un certificado costoso\n\n4. **Instalar**: Sigue las instrucciones del instalador → ¡Lanzar!\n\n\u003e **¿Por qué .exe sobre .msi?** El instalador NSIS `.exe` te da la opción de eliminar datos de usuario al desinstalar, mientras que el `.msi` sigue el comportamiento estándar de Windows de preservar datos de usuario.\n\n#### 🍎 **macOS**\n\n1. **Descargar**: \n   - **Macs Intel**: `LuminaKraft Launcher_x.x.x_x64.dmg`\n   - **Apple Silicon (M1/M2/M3)**: `LuminaKraft Launcher_x.x.x_aarch64.dmg`\n\n2. **Abrir DMG**: Haz doble clic en el archivo `.dmg` descargado\n\n3. **Arrastrar a Aplicaciones**: Arrastra `LuminaKraft Launcher.app` a la carpeta Aplicaciones\n   \n   ![Proceso de Instalación en macOS](assets/images/macos-installation.png)\n\n4. **⚠️ Problemas de Gatekeeper** (Muy Común):\n   \n   **Si obtienes \"La app está dañada\" o \"No se puede verificar el desarrollador\":**\n   \n   **Método 1 - Clic Derecho (Más Fácil):**\n   - Haz clic derecho en la app en Aplicaciones\n   - Selecciona \"Abrir\"\n   - Haz clic en \"Abrir\" cuando se te solicite\n   \n   **Método 2 - Preferencias del Sistema:**\n   - Ve a Menú Apple → Preferencias del Sistema → Seguridad y Privacidad\n   - Haz clic en el candado para hacer cambios\n   - Encuentra el mensaje de la app bloqueada y haz clic en \"Abrir de todas formas\"\n   \n   **Método 3 - Terminal (Si los anteriores fallan):**\n   \n   Abre Terminal (⌘+Espacio, busca \"terminal\"):\n   \n   ![Abrir Terminal](assets/images/macos-spotlight-terminal.png)\n   \n   Ejecuta este comando:\n   ```bash\n   # Eliminar atributo de cuarentena\n   xattr -cr \"/Applications/LuminaKraft Launcher.app\"\n   ```\n   \n   ![Comando Terminal](assets/images/macos-terminal-xattr.png)\n\n5. **Iniciar el Launcher**: Busca \"LuminaKraft Launcher\" en Spotlight (⌘+Espacio):\n\n   ![Buscar Launcher](assets/images/macos-spotlight-launcher.png)\n\n#### 🐧 **Linux**\n\n1. **Descargar**: Elige tu formato:\n   - **AppImage** (Universal): `LuminaKraft Launcher_x.x.x_amd64.AppImage`\n   - **Debian/Ubuntu**: `LuminaKraft Launcher_x.x.x_amd64.deb`\n   - **Fedora/RHEL**: `LuminaKraft Launcher-x.x.x-1.x86_64.rpm`\n\n2. **Instalar**:\n   ```bash\n   # AppImage (No requiere instalación)\n   chmod +x LuminaKraft\\ Launcher_*_amd64.AppImage\n   ./LuminaKraft\\ Launcher_*_amd64.AppImage\n   \n   # Debian/Ubuntu\n   sudo dpkg -i LuminaKraft\\ Launcher_*_amd64.deb\n   \n   # Fedora/RHEL  \n   sudo rpm -i LuminaKraft\\ Launcher-*-1.x86_64.rpm\n   ```\n\n### 📋 Requisitos del Sistema\n- **Windows**: Windows 10 o posterior\n- **macOS**: macOS 10.13 (High Sierra) o posterior\n- **Linux**: Distribución moderna con GTK 3.24+\n- **RAM**: 4GB mínimo, 8GB recomendado\n- **Almacenamiento**: 1GB de espacio libre para el launcher + almacenamiento de modpacks\n\n### 🔧 Solución de Problemas\n\n#### Problemas en Windows\n- **Advertencia SmartScreen**: Comportamiento normal, haz clic en \"Más información\" → \"Ejecutar de todas formas\"\n- **Detección de Antivirus**: Agrega el launcher a la lista blanca del antivirus\n- **Instalación Fallida**: Ejecuta el instalador como Administrador\n\n#### Problemas en macOS  \n- **\"La app está dañada\"**: Elimina la cuarentena con `xattr -cr \"/Applications/LuminaKraft Launcher.app\"` ([ver guía visual](#️-problemas-de-gatekeeper-muy-común))\n- **\"No se puede verificar el desarrollador\"**: Clic derecho en la app → Abrir → Abrir ([ver guía de instalación](#-macos))\n- **Permiso Denegado**: Revisa la configuración de Seguridad y Privacidad\n- **La app no se inicia**: Intenta abrir desde Terminal: `open \"/Applications/LuminaKraft Launcher.app\"`\n\n#### Problemas en Linux\n- **AppImage no se ejecuta**: Hazlo ejecutable con `chmod +x`\n- **Dependencias faltantes**: Instala GTK 3.24+ y WebKit2GTK\n- **Conflictos de paquetes**: Usa AppImage para compatibilidad universal\n\n#### Servidores de Pantalla en Linux (Wayland/X11)\n- El launcher ahora prefiere automáticamente Wayland y cae con gracia a X11 si Wayland no está disponible.\n- También deshabilita la ruta DMABUF de WebKit y selecciona un renderizador GTK compatible para evitar fallos comunes como:\n  - `Gdk-Message: Error 71 (Protocol error) dispatching to Wayland display.`\n  - `Failed to create GBM buffer of size 1200x800: Invalid argument`\n- No se requiere configuración manual de variables de entorno. Para depuración, aún puedes usar:\n  - `GDK_BACKEND=wayland,x11` (preferencia de backend)\n  - `GSK_RENDERER=gl` (renderizador GTK)\n  - `WEBKIT_DISABLE_DMABUF_RENDERER=1` (desactivar ruta dmabuf frágil)\n  - `LIBGL_ALWAYS_SOFTWARE=1` (renderizado por software en X11)\n\n### 🐧 Dependencias de Linux (basadas en Debian/Ubuntu/Kali)\n\nAntes de compilar localmente en Linux, instala los paquetes del sistema requeridos:\n\n```bash\nsudo apt update \u0026\u0026 sudo apt install \\\n  pkg-config \\\n  libgtk-3-dev \\\n  libwebkit2gtk-4.1-dev \\\n  libayatana-appindicator3-dev \\\n  librsvg2-dev \\\n  libglib2.0-dev\n```\n\nNotas:\n- Se prefiere `libwebkit2gtk-4.1-dev`. Si no está disponible en tu distro, `libwebkit2gtk-4.0-dev` puede funcionar.\n- Nuestros scripts de compilación avisan (pero no fallan) si faltan estos paquetes en sistemas basados en APT.\n\n## 🛠 Compilación y Releases\n\n### Compilaciones Automatizadas via GitHub Actions\n\n¡Todas las compilaciones ahora se manejan automáticamente a través de GitHub Actions. No se necesita compilación local!\n\n### Crear un Release\n\n1. **Actualizar Versión**: Actualiza la versión en `package.json` y `src-tauri/tauri.conf.json`\n2. **Crear Git Tag**: \n   ```bash\n   git tag v0.0.7\n   git push origin v0.0.7\n   ```\n3. **Compilación Automática**: GitHub Actions compilará automáticamente todas las plataformas y creará un release\n4. **Trigger Manual**: También puedes disparar compilaciones manualmente desde la pestaña GitHub Actions\n\n### Compilación Local de Desarrollo (Opcional)\n\nSolo para propósitos de desarrollo:\n\n```bash\n# Clonar el repositorio\ngit clone https://github.com/LuminaKraft/LuminakraftLauncher.git\ncd LuminakraftLauncher\n\n# Instalar dependencias\nnpm install\n\n# Compilar solo para la plataforma actual (desarrollo)\nnpm run tauri build\n```\n\n\u003e **Nota**: Los releases de producción siempre deben usar GitHub Actions para consistencia y firma apropiada.\n\n## 📋 Desarrollo\n\n### Desarrollo Local\n```bash\n# Instalar dependencias\nnpm install\n\n# Iniciar servidor de desarrollo\nnpm run tauri:dev\n\n# Ejecutar con puerto estable (mata el puerto 1420 primero)\nnpm run tauri:dev-stable\n\n# Verificar código\nnpm run lint\n\n# Limpiar artefactos de compilación\nnpm run clean\n```\n\n### Estructura del Proyecto\n```\nLuminakraftLauncher/\n├── src/                    # Código fuente del frontend React\n│   ├── components/         # Componentes de UI\n│   ├── services/          # Capas de API y servicios\n│   ├── types/             # Definiciones de tipos TypeScript\n│   ├── contexts/          # Contextos de React\n│   ├── locales/           # Archivos de internacionalización\n│   └── assets/            # Recursos estáticos\n├── src-tauri/             # Código fuente del backend Tauri\n│   ├── src/               # Archivos fuente de Rust\n│   ├── Cargo.toml         # Dependencias de Rust\n│   └── tauri.conf.json    # Configuración de Tauri\n├── public/                # Recursos públicos estáticos\n├── scripts/               # Scripts de compilación y utilidades\n├── docs/                  # Documentación\n└── assets/                # Capturas de pantalla e imágenes\n```\n\n## 🔧 Detalles Técnicos\n\n### Arquitectura\n- **Frontend**: React 18 + TypeScript + Vite + Tailwind CSS\n- **Backend**: Rust + Tauri 2.5.1\n- **Sistema de Compilación**: GitHub Actions con compilación multiplataforma\n- **Empaquetado**: Instaladores nativos (NSIS + MSI) + AppImage para Linux\n- **Librería de Minecraft**: Lyceris para autenticación y gestión del juego\n- **Iconos de UI**: Lucide React para iconografía moderna\n- **Cliente HTTP**: Axios (frontend) + Reqwest (backend)\n\n### Librerías Clave\n- **Lyceris**: Funcionalidad central del launcher de Minecraft\n- **Tauri**: Framework de aplicaciones multiplataforma\n- **React**: Framework de frontend\n- **Tailwind CSS**: Estilizado utility-first\n- **i18next**: Internacionalización\n- **Lucide React**: Librería de iconos\n\n### Optimización de Compilación\n- Compilaciones automatizadas via GitHub Actions\n- Compilación multiplataforma sin configuración local de Docker\n- Pipeline CI/CD optimizado para releases más rápidos\n\n## 🌍 Internacionalización\n\nLuminaKraft Launcher soporta múltiples idiomas:\n- **Inglés** (en) - Por defecto\n- **Español** (es) - Español\n\nPara contribuir con traducciones:\n1. Revisa el directorio `src/locales/`\n2. Agrega o actualiza archivos de traducción\n3. Sigue la estructura de claves existente\n4. Envía un pull request\n\n## 📚 Documentación\n\n- [Resumen de Documentación](docs/README.md) - Guía completa de documentación\n- [Guía de Testing](docs/TESTING_GUIDE.md) - Procedimientos de testing y control de calidad\n- [Integración Lyceris](docs/LYCERIS_INTEGRATION_SUMMARY.md) - Detalles de la librería central del launcher\n- [Pautas de Contribución](CONTRIBUTING.md) - Cómo contribuir al proyecto\n- [Código de Conducta](CODE_OF_CONDUCT.md) - Pautas de la comunidad\n\n## 🤝 Contribuciones\n\n¡Damos la bienvenida a las contribuciones! Por favor revisa nuestras [Pautas de Contribución](CONTRIBUTING.md) para más detalles.\n\n### Inicio Rápido para Contribuidores\n1. Haz un fork del repositorio\n2. Crea una rama de feature (`git checkout -b feature/caracteristica-increible`)\n3. Haz tus cambios siguiendo nuestras [pautas de estilo de código](CONTRIBUTING.md#code-style-and-formatting)\n4. Prueba las compilaciones en tu plataforma objetivo\n5. Confirma tus cambios (`git commit -s -m 'Agregar característica increíble'`)\n6. Push a la rama (`git push origin feature/caracteristica-increible`)\n7. Abre un Pull Request\n\n### Entorno de Desarrollo\n- Sigue nuestro [Código de Conducta](CODE_OF_CONDUCT.md)\n- Firma tus commits ([Certificado de Origen del Desarrollador](CONTRIBUTING.md#signing-your-work))\n- Usa mensajes de commit convencionales\n- Prueba en múltiples plataformas cuando sea posible\n\n## 🐛 Reportes de Errores y Solicitudes de Características\n\n¿Encontraste un error o tienes una solicitud de característica? Por favor revisa nuestra [página de Issues](https://github.com/LuminaKraft/LuminakraftLauncher/issues) y crea un nuevo issue si es necesario.\n\n## 📄 Licencia\n\nEste proyecto está licenciado bajo la **Licencia Pública General GNU v3.0** - revisa el archivo [LICENSE](LICENSE) para más detalles.\n\n### Licencias de Terceros\nRevisa [COPYING.md](COPYING.md) para información detallada sobre dependencias de terceros y sus licencias.\n\n## 🏆 Reconocimientos\n\n- **Librería Lyceris**: Funcionalidad central del launcher de Minecraft\n- **Equipo Tauri**: Framework multiplataforma increíble\n- **Comunidad React**: Excelente ecosistema de frontend\n- **Prism Launcher**: Inspiración para las pautas de la comunidad\n- **Todos los Contribuidores**: ¡Gracias por hacer este proyecto mejor!\n\n## 📞 Soporte\n\n- 📖 **Documentación**: Revisa nuestro directorio [docs](docs/)\n- 🐛 **Reportes de Errores**: [GitHub Issues](https://github.com/LuminaKraft/LuminakraftLauncher/issues)\n- 💬 **Discusiones**: [GitHub Discussions](https://github.com/LuminaKraft/LuminakraftLauncher/discussions)\n- 🌐 **Sitio Web**: ¡Próximamente!\n\n---\n\n**🎉 ¡Listo para distribución multiplataforma automatizada!** LuminaKraft Launcher se compila automáticamente para Windows, macOS y Linux via GitHub Actions con pipelines CI/CD optimizados.\n\n\u003cdiv align=\"center\"\u003e\n  \u003csub\u003eConstruido con ❤️ por el equipo de LuminaKraft Studios\u003c/sub\u003e\n\u003c/div\u003e ","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fluminakraft%2Fluminakraftlauncher","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fluminakraft%2Fluminakraftlauncher","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fluminakraft%2Fluminakraftlauncher/lists"}