> ## Documentation Index
> Fetch the complete documentation index at: https://crystallegacy.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Instala y Conecta el Modpack Cliente de Crystal Legacy

> Descarga el client.mrpack de Crystal Legacy, impórtalo en la App de Modrinth, apúntalo a tu servidor y lanza con Java 21.

El cliente de Crystal Legacy se distribuye como un modpack de Modrinth (`.mrpack`) autocontenido. Incluye cada mod Fabric requerido, todos los paquetes de recursos y una pantalla de título preconfigurada que te conecta a tu servidor de eventos con un solo botón. La configuración solo toma unos minutos: importa el modpack en la App de Modrinth, apúntalo a la dirección de tu servidor y estarás listo para jugar.

> [!NOTE]
>
> La **App de Modrinth** es el launcher recomendado para Crystal Legacy. Gestiona la instalación de Java 21 y el manejo de instancias automáticamente. Otros launchers compatibles con Fabric (MultiMC, Prism Launcher, ATLauncher) también pueden importar archivos `.mrpack`, pero la App de Modrinth ofrece la experiencia más fluida.

## Requisitos

| Recurso | Recomendado |
| - | - |
| Java | 21 |
| RAM | \~8 GB asignados a la instancia |

## Descarga

> **[Descargar client.mrpack](https://drive.google.com/file/d/1pV101vMuXz0ZSYp9qHMTHR-ljZD7uZ8y/view?usp=drive_link)**
>
> Obtén el modpack cliente más reciente de Crystal Legacy desde Google Drive.

## Pasos de Configuración

**1. Importa el modpack en la App de Modrinth**

Abre la **App de Modrinth** y agrega el archivo `client.mrpack` descargado como una nueva instancia:

1. Haz clic en **Agregar Instancia** (o el botón **+** en el panel de instancias).
2. Elige **Importar desde archivo** y selecciona el `client.mrpack` que acabas de descargar.
3. Espera a que el launcher termine de descargar los mods y paquetes de recursos. Cuando finalice, la instancia estará totalmente instalada y lista para lanzar.

> [!TIP]
>
> En la configuración de la instancia, asigna al menos **8 GB de RAM** para la experiencia más fluida.

**2. Apunta el cliente a tu servidor**

El botón **Jugar** de la pantalla de título está preconfigurado para conectarse a una dirección de servidor almacenada en un archivo de diseño de FancyMenu. Necesitas reemplazar el marcador de posición `localhost:25565` por la dirección IP y el puerto reales de tu servidor.

Abre la carpeta de la instancia instalada desde la App de Modrinth (haz clic derecho sobre la instancia y elige **Abrir Carpeta**), luego abre el siguiente archivo en cualquier editor de texto plano:

```text theme={null}
/config/fancymenu/customization/title_screen_layout.txt
```

Busca la línea que contiene `joinserver`. Se ve así:

```text title="title_screen_layout.txt — antes" theme={null}
[executable_action_instance:<uuid>][action_type:joinserver] = localhost:25565
```

Reemplaza la dirección después del `=` con la dirección IP y el puerto de tu servidor:

```text title="title_screen_layout.txt — después" theme={null}
[executable_action_instance:<uuid>][action_type:joinserver] = 203.0.113.42:25565
```

> [!NOTE]
>
> La porción `<uuid>` de la clave es un identificador único generado cuando se construyó el diseño. Déjalo exactamente como está. Solo cambia el valor a la derecha del signo `=`.

Guarda el archivo y cierra tu editor.

**3. Lanza el juego y únete al evento**

Inicia la instancia desde la App de Modrinth. Una vez que cargue la pantalla de título, haz clic en el botón **Jugar** y Crystal Legacy te conectará directamente a la dirección del servidor configurada.

Si el servidor está en la fase `WAITING_PLAYERS`, serás colocado en el lobby automáticamente. Si un evento ya está en curso, el servidor te sincronizará con la fase actual para que puedas unirte sin perder el ritmo.

## Solución de Problemas

> [!WARNING]
>
> Si el botón **Jugar** produce un error de "Conexión rechazada", verifica que la dirección IP y el puerto en `title_screen_layout.txt` sean correctos y que el servidor esté ejecutándose. También puedes agregar el servidor manualmente mediante **Multijugador → Agregar Servidor** como alternativa.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.