# Instalar el plugin

El plugin conecta tu servidor con la tienda. Es el que entrega las compras, se encarga del
VIP en el juego y lleva anuncios y `/loja` al servidor. Esta sección solo aparece en las
tiendas de Minecraft y Hytale.

El mismo plugin de Minecraft funciona desde la versión 1.8.8 hasta la más nueva, en Spigot,
Paper y Folia.

![Plugin > Cómo funciona: la descarga, lo que hace el plugin y cómo instalarlo](shots/plugins-overview.webp)

## Paso a paso

Vas a necesitar acceso a los archivos del servidor, normalmente desde el panel de tu hosting.

### 1. Crea el servidor en la tienda

1. En **Tienda > Servidores**, haz clic en **Nuevo Servidor**.
2. Dale un nombre, como `Survival`. La foto es opcional.
3. Haz clic en **Crear Servidor**.

![La ventana de nuevo servidor](shots/plugins-server-new.webp)

### 2. Copia el token

Al crearlo, la pantalla muestra el **token**, la contraseña que conecta el plugin con este
servidor. Cópialo ahora: aparece una sola vez en esta ventana. ¿Lo perdiste? Abre el servidor
y usa **Regenerar Token** para generar otro.

![El token del servidor justo después de crearlo](shots/plugins-server-token.webp)

> [!WARNING]
> El token es una contraseña. No lo envíes en un ticket, captura o grupo. Si se filtra, usa
> **Regenerar Token** en la pantalla del servidor: el antiguo deja de funcionar en el momento
> y el plugin solo vuelve con el nuevo.

### 3. Descarga e instala el plugin

1. En **Plugin > Cómo funciona**, haz clic en **Descargar el plugin**.
2. Coloca el archivo en la carpeta `plugins` del servidor.
3. Enciende el servidor una vez. El plugin crea el archivo `plugins/Hystore/config.yml`.

### 4. Pega el token

Abre `plugins/Hystore/config.yml` y pega el token en el campo `token`:

```yaml plugins/Hystore/config.yml
token: "PEGA_TU_TOKEN_AQUI"
```

En Hytale, el archivo es `config.json`, en la carpeta del plugin, con los mismos campos.

### 5. Recarga y verifica

1. En la consola del servidor, escribe `/hystorereload`, o reinicia el servidor.
2. En **Tienda > Servidores**, revisa la **Última conexión del plugin**. Si muestra hace un
   momento, funcionó.

![La lista de servidores con la última conexión de cada uno](shots/plugins-servers.webp)

> [!TIP]
> **Nunca conectado** quiere decir que el plugin todavía no habló con la tienda. Sin token, o
> con un token incorrecto, el plugin queda encendido y los comandos dicen qué falta. Revisa que
> el token se haya pegado completo y entre comillas.

## Opciones del archivo de configuración

Después de cambiar el archivo, usa `/hystorereload` o reinicia el servidor.

| Opción | Predeterminado | Qué hace |
| --- | --- | --- |
| `token` | | La contraseña del servidor |
| `poll-interval-seconds` | `30` | Cada cuántos segundos el plugin busca entregas |
| `require-online` | `true` | `true`: la entrega espera a que el jugador esté en línea. `false`: se ejecuta en el momento, aunque esté desconectado |
| `notify-player` | `true` | Avisa al jugador cuando recibe una entrega |
| `auto-update` | `true` | Descarga versiones nuevas solo |
| `vip.language` | `auto` | Idioma del VIP: `auto` usa el idioma del juego de cada jugador. O fija `pt`, `en` o `es` |
| `vip.announce-activation` | `true` | Anuncia en el chat cuando alguien activa un VIP |
| `vip.warn-every-hours` | `6` | Con el VIP cerca de terminar, avisa cada tantas horas |
| `debug` | `false` | Escribe más detalles en la consola |

## Actualizaciones

Instálalo una vez. Cuando sale una versión nueva, el plugin la descarga solo, verifica la firma
de Hystore y la versión nueva vale en el próximo reinicio del servidor. En **Plugin > Novedades**
ves qué cambió en cada versión.

![Las novedades del plugin, versión por versión](shots/plugins-changelog.webp)

## Revisar el servidor

En **Tienda > Servidores > Ver Detalles**, la tarjeta **En el servidor** muestra lo que informó
el plugin: su versión, si está desactualizado, el software del servidor y los plugins activos.
Hay un aviso cuando falta LuckPerms, que el VIP de producto puede usar.

Sigue en [Vincular y comandos](/es/plugins/linking/).