CubicLauncher

CubicLauncher es un launcher de código abierto para Minecraft: Java Edition. Está pensado para tener varias instalaciones del juego separadas, cada una con su propia versión, configuración y contenido, sin que se pisen entre sí.

Está hecho con Tauri v2, Rust y SvelteKit, y funciona en Windows, Linux y macOS.

Sitio web: https://cubiclauncher.org

Instalación

Las versiones estables están en GitHub Releases.
Estado de las últimas compilaciones: https://github.com/CubicLauncherDevs/CubicLauncher/actions

Plataforma	Archivo
Windows	Instalador NSIS (`.exe`)
Linux	AppImage, `.deb` y `.rpm`
macOS	`.dmg` (Apple Silicon e Intel)

Arch Linux

El paquete cubiclauncher está en el AUR:

yay -S cubiclauncher

También hay un PKGBUILD si prefieres compilarlo localmente. En Arch conviene usar este paquete en lugar del binario de las releases, porque este último se compila en Ubuntu y puede no ser compatible con las bibliotecas de tu sistema.

Nix y NixOS

Con flakes y nix-command activados, configura la caché pública de Cachix para descargar los binarios publicados para Linux x86_64 y ARM64:

nix run nixpkgs#cachix -- use cubiclauncher

En NixOS, incorpora la configuración generada siguiendo las indicaciones del comando y aplica los cambios con sudo nixos-rebuild switch antes de instalar. Si tu configuración usa un flake en Git, agrega también los archivos generados al repositorio con git add para que Nix pueda leerlos.

Elige la versión estable o la beta:

# Última versión estable publicada en la caché
nix profile add github:CubicLauncherDevs/CubicLauncher/latest-release

# Alternativa: última beta publicada en la caché
nix profile add github:CubicLauncherDevs/CubicLauncher/latest-beta

# Ejecutar sin instalar
nix run github:CubicLauncherDevs/CubicLauncher/latest-release

También puedes instalar un tag específico reemplazando TAG por el nombre exacto de la versión en Releases:

nix profile add github:CubicLauncherDevs/CubicLauncher/TAG

Nix usa Cachix automáticamente si está disponible el build de esa revisión y arquitectura; de lo contrario, compila localmente. Los canales latest-release y latest-beta se actualizan cuando termina correctamente su publicación en la caché; si un canal aún no se publicó, su tag puede no existir.

El flake ofrece paquetes para x86_64-linux, aarch64-linux y aarch64-darwin; la caché del proyecto se publica solo para Linux. Más detalles y comandos de actualización en la guía de Nix.

Para ver en qué otras distribuciones está disponible, revisa Repology.

Docker

La imagen se publica en GitHub Packages para linux/amd64 y linux/arm64:

docker pull ghcr.io/cubiclauncherdevs/cubiclauncher:latest

Como CubicLauncher es una aplicación de escritorio, el contenedor necesita acceso al servidor gráfico del host. En X11:

xhost +si:localuser:$(id -un)
docker run --rm -it \
  --user "$(id -u):$(id -g)" \
  -e HOME=/data \
  -e DISPLAY \
  -v /tmp/.X11-unix:/tmp/.X11-unix:ro \
  -v cubic-data:/data \
  --device /dev/dri \
  ghcr.io/cubiclauncherdevs/cubiclauncher:latest

En Wayland:

docker run --rm -it \
  --user "$(id -u):$(id -g)" \
  -e HOME=/data \
  -e XDG_RUNTIME_DIR=/run/user/$(id -u) \
  -e WAYLAND_DISPLAY \
  -e GDK_BACKEND=wayland \
  -v "$XDG_RUNTIME_DIR:/run/user/$(id -u)" \
  -v cubic-data:/data \
  --device /dev/dri \
  ghcr.io/cubiclauncherdevs/cubiclauncher:latest

El volumen cubic-data conserva ~/.cubic (instancias, ajustes y el JRE que descarga el launcher). Para usar los datos del host, monta -v "$HOME/.cubic:/data/.cubic". La imagen funciona con cualquier UID gracias a --user, pero el directorio /data debe ser escribible por ese UID (el volumen se crea con permisos 1777).

Notas:

Con NVIDIA necesitas nvidia-container-toolkit y --gpus all. Si la interfaz aparece en blanco, añade -e WEBKIT_DISABLE_DMABUF_RENDERER=1.
Para audio con PulseAudio monta el socket y define PULSE_SERVER; para ALSA usa --device /dev/snd.
El actualizador integrado no funciona dentro del contenedor: actualiza cambiando la etiqueta de la imagen.
Si WebKit falla al iniciar por el sandbox, prueba --security-opt seccomp=unconfined.

Para compilar la imagen localmente:

docker build -t cubiclauncher .

El workflow .github/workflows/docker.yml publica la imagen al crear un tag v*. Para sembrar la primera versión con el último release publicado, ejecútalo manualmente desde Actions → Docker Image → Run workflow y deja el campo tag vacío: se resolverá automáticamente el último release estable (por ejemplo, v36.0.1) y se compilará el código de ese tag, no el de la rama actual. También puedes indicar un tag concreto; si no es el último release, no se moverá latest.

Las etiquetas publicadas son la versión (36.0.1), 36.0, 36 y latest. latest solo se mueve cuando se publica el release más reciente; las versiones prerelease únicamente reciben su propia etiqueta. Si el paquete aparece privado, cambia su visibilidad a pública en la configuración del paquete en GitHub.

Qué puede hacer

Crear, configurar, importar y exportar instancias.
Instalar Vanilla, Fabric, Forge, Quilt y NeoForge.
Iniciar sesión con Microsoft, Yggdrasil o jugar sin conexión.
Buscar e instalar mods, resource packs y shaders desde Modrinth y CurseForge, e importar modpacks.
Administrar mundos y listas de servidores por instancia.
Elegir la versión de Java y su proveedor (Azul Zulu, Eclipse Temurin, BellSoft Liberica y GraalVM), ajustar la memoria y ver la consola de registros.
Cambiar tema e idioma, y mostrar la actividad en Discord.

Migrar desde otro launcher

Puedes copiar tus instancias desde el launcher oficial o desde MultiMC y sus forks (PolyMC, Prism Launcher, PineconeMC, Freesm Launcher). Los originales no se tocan.

Ve a Crear instancia → Local → Migrar.
Elige el launcher de origen y pulsa Buscar instalaciones. Si usas una instalación portable o una ruta personalizada, usa Elegir carpeta.
Selecciona las instancias que quieras y pulsa Migrar.

Se copian mundos, mods, configuraciones, packs, capturas, servidores y opciones. Las versiones y loaders se instalan después desde la cola de descargas, y las cuentas hay que configurarlas de nuevo en CubicLauncher. Los componentes desconocidos y los parches del juego base no son compatibles, y no se admiten enlaces simbólicos dentro de los datos copiados.

Cómo funciona

CubicLauncher separa la interfaz del trabajo pesado. El frontend SvelteKit envía comandos al backend Tauri y este responde con eventos (app-event) y transmisiones de logs. Cada instancia guarda su configuración en instance.cub, mientras que los archivos compartidos (versiones, librerías, assets y JRE) viven en el directorio shared.

~/.cubic/instances/<nombre>/: datos de la instancia y su archivo instance.cub.
~/.cubic/shared/: versions, libraries, assets, natives y runtimes.
~/.cubic/settings/settings.cub: ajustes, cuentas y preferencias.
~/.cubic/themes/ y ~/.cubic/skins/: temas y skins del usuario.

Flujo general

flowchart TD
    subgraph ARRANQUE["1. Arranque"]
        A(["Inicio"]) --> B["Tauri crea la ventana y asegura<br/>~/.cubic/{instances,shared,settings,themes,skins}"]
        B --> C["Inicializa servicios<br/>PathManager · Settings · DownloadQueue · Launcher<br/>InstanceManager · EventBus · ThemeWatcher"]
        C --> D["Carga settings.cub y los instance.cub"]
        D --> E["SvelteKit: syncSettings, get_instances,<br/>versiones instaladas y preferencias"]
    end

    E --> F{"Acción del usuario"}

    subgraph INSTANCIAS["2. Instancias"]
        F -->|"Crear / importar"| G["create_instance"]
        G --> H["Validar nombre y versión<br/>crear carpeta y escribir instance.cub"]
        H --> I{"¿Versión y dependencias<br/>completas?"}
        I -->|"No"| J["Encolar en DownloadQueue"]
        I -->|"Sí"| K["Instancia lista"]
    end

    subgraph DESCARGAS["3. Descarga de versiones"]
        J --> L["Worker de descarga"]
        L --> M{"Tipo de versión"}
        M -->|"Vanilla"| N["Manifiesto de Mojang"]
        M -->|"Fabric / Quilt"| O["Metadatos del loader + MC base"]
        M -->|"Forge / NeoForge"| P["JRE + MC base + instalador"]
        M -->|"OptiFine"| Q["JRE + MC base + instalador"]
        N --> R["aqua descarga<br/>librerías · assets · JAR · natives"]
        O --> R
        P --> R
        Q --> R
        R --> S["Marcadores .cubic-installing<br/>y .cubic-complete"]
        S --> K
    end

    subgraph AUTH["4. Cuentas"]
        F -->|"Iniciar sesión"| T{"Proveedor"}
        T -->|"Microsoft"| U["Device code o WebView OAuth"]
        T -->|"Yggdrasil"| V["Servidor + authlib-injector"]
        T -->|"Sin conexión"| W["Usuario local"]
        U --> X["Tokens en almacenamiento seguro"]
        V --> X
        W --> Y["Perfil local en settings.cub"]
        X --> E
        Y --> E
    end

    subgraph LANZAR["5. Lanzamiento"]
        K --> Z["Comando launch"]
        Z --> AA["Launcher.launch<br/>lock de archivos + estado Starting"]
        AA --> AB{"¿Faltan dependencias?"}
        AB -->|"Sí"| J
        AB -->|"No"| AC["Leer version.json y resolver herencia<br/>Vanilla → loader"]
        AC --> AD["Resolver Java requerido<br/>manifest → loader → overrides"]
        AD --> AE{"¿JRE disponible?"}
        AE -->|"No"| AF["Pedir / encolar instalación de JRE"]
        AE -->|"Sí"| AG["Refrescar token de la cuenta"]
        AG --> AH["Construir LaunchConfig<br/>RAM · JVM args · env · auth · quickPlay"]
        AH --> AI["Aplicar options.txt y minecraft.jar<br/>si están configurados"]
        AI --> AJ["launchwerk: extraer natives<br/>+ CommandBuilder (zellkern)"]
        AJ --> AK["Lanzar proceso Java<br/>stdout/stderr → logs y UI"]
        AK --> AL["Estado Started<br/>Discord Presence"]
    end

    subgraph EJECUCION["6. Ejecución y cierre"]
        AL --> AM{"¿Cómo termina el proceso?"}
        AM -->|"Salida normal / kill"| AN["Estado Off"]
        AM -->|"Código != 0<br/>sin kill ni Stopping!"| AO["Crash detectado<br/>snapshot de logs + ventana de consola"]
        AN --> E
        AO --> E
    end

    S -.->|"eventos DProgress / DFinish / DError"| E
    AK -.->|"logs y eventos app-event"| E

Ciclo de lanzamiento

sequenceDiagram
    autonumber
    participant UI as Frontend SvelteKit
    participant IPC as Comandos Tauri
    participant L as Launcher
    participant Q as DownloadQueue
    participant A as aqua
    participant Z as zellkern / launchwerk
    participant J as Java / Minecraft
    participant EV as EventBus

    UI->>IPC: invoke("launch")
    IPC->>L: launch(handle)
    L->>L: Bloquear archivos y marcar Starting
    L->>L: Verificar dependencias de la versión
    alt Faltan dependencias
        L->>Q: enqueue(version)
        Q->>A: Descargar versión, loader o JRE
        A-->>Q: Progreso de descarga
        Q->>EV: DProgress / DFinish / DError
        EV-->>UI: app-event
        L-->>UI: Error VersionNotFound
    else Dependencias completas
        L->>L: Leer manifiesto y resolver Java
        L->>L: Refrescar token y construir LaunchConfig
        L->>Z: prepare(manifest, config, instancia)
        Z->>Z: Extraer natives + CommandBuilder
        Z->>J: Spawn del proceso Java
        J-->>L: stdout / stderr
        L->>EV: Logs e InstanceEdited
        EV-->>UI: app-event
        J-->>L: El proceso termina
        alt Salida normal o kill
            L->>EV: Estado Off
        else Crash
            L->>EV: InstanceCrashed + snapshot de logs
        end
        EV-->>UI: app-event
    end

Ayuda y soporte

Si necesitas ayuda, puedes abrir un issue. Si no es un error, probablemente sea más rápido preguntar en Discord.

También tenemos un subreddit donde puedes dejar tus problemas y sugerencias:

Al reportar un error, incluye la versión del launcher, tu sistema operativo y los pasos para reproducirlo.

Desarrollo

Si quieres contribuir, lee antes CONTRIBUTING.md y TESTING.md. Para charlar con el equipo, pasa por el Discord.

Compilar

Necesitas:

Git
Bun
Node.js (una versión LTS)
Rust estable con edición 2024, junto con Cargo, rustfmt y Clippy
Las dependencias del sistema de Tauri v2 para tu plataforma

git clone https://github.com/CubicLauncherDevs/CubicLauncher.git
cd CubicLauncher
bun install --frozen-lockfile
bun run tauri dev

bun run dev levanta solo el frontend con Vite, pero lo que depende del backend no funcionará fuera de Tauri. Si usas Nix, corre nix develop primero.

Comando	Qué hace
`bun run tauri dev`	Abre la app en modo desarrollo
`bun run tauri build`	Compila y empaqueta para tu plataforma
`bun run lint`	ESLint sobre el frontend
`bun run check`	Tipos y diagnósticos de Svelte
`bun run test:all`	Tests del frontend y de Rust
`cargo fmt --all --check`	Revisa el formato de Rust
`cargo clippy --workspace -- -D warnings`	Análisis estático de Rust

Estructura

src/          Frontend (interfaz, estado y servicios)
src-tauri/    Aplicación Tauri, comandos y servicios nativos
crates/       Bibliotecas internas del workspace de Rust
tests/        Tests del frontend
static/       Recursos estáticos
dist/         Archivos de empaquetado para distribuciones
.github/      CI y flujos de publicación

Traducciones

Las traducciones se mantienen en el repositorio Translations. Ahí también está la información para colaborar.

Versiones

El proceso de versionado y publicación está explicado en VERSIONING.md.

Licencia

Todo el código del launcher se distribuye bajo la licencia GPL-3.0-only.

La participación en el proyecto se rige por el Código de conducta.

Name		Name	Last commit message	Last commit date
.github		.github
crates		crates
dist		dist
src-tauri		src-tauri
src		src
static		static
tests/frontend		tests/frontend
.dockerignore		.dockerignore
.gitignore		.gitignore
.prettierrc		.prettierrc
CODE_OF_CONDUCT.md		CODE_OF_CONDUCT.md
CONTRIBUTING.md		CONTRIBUTING.md
Cargo.lock		Cargo.lock
Cargo.toml		Cargo.toml
Dockerfile		Dockerfile
LICENSE		LICENSE
README.md		README.md
TESTING.md		TESTING.md
VERSIONING.md		VERSIONING.md
bun.lock		bun.lock
eslint.config.js		eslint.config.js
flake.lock		flake.lock
flake.nix		flake.nix
oldicon.png		oldicon.png
package.json		package.json
svelte.config.js		svelte.config.js
tsconfig.json		tsconfig.json
vite.config.js		vite.config.js

Navigation Menu

Repository navigation

About

Repository files navigation

CubicLauncher

Instalación

Arch Linux

Nix y NixOS

Docker

Qué puede hacer

Migrar desde otro launcher

Cómo funciona

Flujo general

Ciclo de lanzamiento

Ayuda y soporte

Desarrollo

Compilar

Estructura

Traducciones

Versiones

Licencia

About

Releases

Packages

Contributors

Languages

Latest commit

History

Folders and files

Repository files navigation

CubicLauncher

Instalación

Arch Linux

Nix y NixOS

Docker

Qué puede hacer

Migrar desde otro launcher

Cómo funciona

Flujo general

Ciclo de lanzamiento

Ayuda y soporte

Desarrollo

Compilar

Estructura

Traducciones

Versiones

Licencia

About

Topics

Resources

Code of conduct

Contributing

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages