🎮 Trinity Launcher

Entorno gráfico modular para Minecraft Bedrock en Linux

Visita nuestra página web oficial
para guías de instalación paso a paso.

Trinity Launcher es un entorno gráfico moderno y modular para ejecutar y gestionar Minecraft: Bedrock Edition en Linux. Diseñado para funcionar tanto en sistema como dentro de Flatpak, utiliza Qt6 y sigue una arquitectura limpia basada en librerías separadas (core y ui).

Incluye dos aplicaciones complementarias:

trinchete 🚀 → Launcher principal: gestión avanzada de versiones, exportación/importación, accesos directos.
trinito 📦 → Gestor de contenido: instalación, activación/desactivación y eliminación de mods, texturas, packs de desarrollo y mundos.

🛠️ Tecnologías

Stack de desarrollo

Componente	Descripción	Versión
Lenguaje	C++ estándar	C++17
Framework UI	Qt Framework	Qt 6.6+
Build System	CMake	3.17+
Compilador	Clang	16+
Empaquetado	Flatpak
Plataforma	Linux (x86_64, ARM64)	glibc

Arquitectura modular

TrinityCore: lógica de negocio (gestión de versiones, packs, lanzamiento, exportación).
TrinityUI: interfaces gráficas (ventanas, diálogos, widgets).
Separación clara: facilita mantenimiento, pruebas y reutilización.

🎮 Trinchete — Interfaz del launcher

Barra superior

+ Extraer APK: selecciona un .apk, le da un nombre y lo extrae con mcpelauncher-extract.
Importar: restaura una versión guardada en .tar.gz.
Herramientas: abre la aplicación trinito.

Panel derecho (versión seleccionada)

JUGAR: ejecuta mcpelauncher-client -dg <ruta> y cierra el launcher.
Crear Acceso Directo: genera un archivo .desktop en ~/Descargas/.
Editar Configuración: añade variables de entorno (ej: DRI_PRIME=1).
Exportar: guarda la versión + sus datos en .tar.gz.
Eliminar: borra permanentemente la versión.

✅ Interfaz moderna con tema oscuro y soporte para íconos.

🧰 Trinito — Gestor de Contenido

Pestaña	Tipo	Destino
Mods	Archivo	`behavior_packs/`
Texturas	Archivo	`resource_packs/`
Mundos	Carpeta	`minecraftWorlds/`
Desarrollo	Archivo	`development_.../`

Funcionalidades clave

✅ Habilitado: nombre normal.
⬜ Deshabilitado: renombrado a .disabled y comprimido.
Checkboxes interactivos, recarga y eliminación.

⚙️ Compilación e Instalación

# Dar permisos
chmod +x build.sh

# Compilar e instalar
sudo ./build.sh

Instala en /usr/local/bin y registra el ícono y acceso directo.

Una vez instalado, ejecuta desde cualquier terminal:

trinchete
trinito

🔧 Mcpelauncher Requerido

Trinity Launcher requiere los binarios de mcpelauncher-client, mcpelauncher-extract y mcpelauncher-webview.

Usa el fork mantenido en: https://github.com/franckey02/mcpelauncher-patch (Compatible con versiones recientes de Minecraft, incluyendo 1.21.131+ y betas).

Comandos para compilar

git clone https://github.com/franckey02/mcpelauncher-patch.git
cd mcpelauncher-patch
git checkout qt6
git submodule update --init --recursive
mkdir -p build
cd build

CC=clang CXX=clang++ cmake .. \
  -DCMAKE_BUILD_TYPE=Release \
  -DCMAKE_POLICY_DEFAULT_CMP0074=NEW \
  -DCMAKE_C_COMPILER=clang \
  -DCMAKE_CXX_COMPILER=clang++ \
  -DCMAKE_C_FLAGS="-march=x86-64 -mtune=generic -msse4.1 -msse4.2 -mpopcnt" \
  -DCMAKE_CXX_FLAGS="-march=x86-64 -mtune=generic -msse4.1 -msse4.2 -mpopcnt" \
  -Wno-dev

make -j$(getconf _NPROCESSORS_ONLN)
sudo make install

📦 Empaquetado en Flatpak

Requisitos

flatpak install flathub io.qt.qtwebengine.BaseApp//6.9
flatpak install flathub org.kde.Platform//6.9 org.kde.Sdk//6.9

Construcción

flatpak-builder --user --force-clean build-dir com.trench.trinity.launcher.json
flatpak-builder --repo=repo --force-clean build-dir com.trench.trinity.launcher.json
flatpak build-bundle repo trinity.flatpak com.trench.trinity.launcher
flatpak install ./trinity.flatpak

✅ El manifest debe incluir libevdev, libzip y copiar files/ a /app.

🧪 Pruebas

En sistema

trinchete
trinito

En Flatpak

flatpak run com.trench.trinity.launcher
flatpak run --command=trinito com.trench.trinity.launcher

Rutas de datos (automáticas)

Flatpak: ~/.var/app/com.trench.trinity.launcher/data/mcpelauncher/
Local: ~/.local/share/mcpelauncher/

Ambas usan QStandardPaths::GenericDataLocation → total compatibilidad.

📄 Licencia

Trinity Launcher se distribuye bajo la Licencia BSD de 3 cláusulas.

Copyright (c) 2024, Trinity Launcher Authors
All rights reserved.

Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions are met:

1. Redistributions of source code must retain the above copyright notice, this
   list of conditions and the following disclaimer.

2. Redistributions in binary form must reproduce the above copyright notice,
   this list of conditions and the following disclaimer in the documentation
   and/or other materials provided with the distribution.

3. Neither the name of the copyright holder nor the names of its
   contributors may be used to endorse or promote products derived from
   this software without specific prior written permission.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

Ver licencia completa