Plugin de Hytale

El plugin HytalePay conecta tu servidor de juego a tu tienda, habilitando la entrega automática de artículos cuando los clientes hacen compras.

Requisitos

• Un servidor Hytale funcionando
• Una tienda HytalePay con clave API
• Acceso de administrador al servidor

Instalación

Paso 1: Descargar el plugin

Descarga el plugin HytalePay desde CurseForge.

Paso 2: Instalar en el servidor

1. Detén tu servidor
2. Copia el archivo del plugin a tu carpeta plugins/
3. Inicia tu servidor
4. El plugin creará sus archivos de configuración

Paso 3: Configurar el plugin

Edita plugins/HytalePay/config.yml:

# Configuración HytalePay

api-key: "tu-clave-api-aqui"

store-id: "tu-id-tienda-aqui"

check-interval: 30

debug: false

Paso 4: Recargar

Ejecuta /hytalepay reload o reinicia tu servidor.

Interfaz de configuración

El plugin incluye una interfaz de configuración integrada para administradores. Accede con el comando /obconfig.

La interfaz muestra:

• Estado - Estado de la conexión API
• Handlers activos - Número de handlers de pedidos registrados
• Configuración API - Ajustes actuales (valores sensibles ocultos)
• Intervalo de polling - Frecuencia de verificación de pedidos

Acciones disponibles:

• Actualizar manualmente - Forzar verificación inmediata
• Recargar config - Recargar configuración sin reiniciar

Comandos

Interfaz de comandos de artículos

El comando /obitems abre una interfaz para configurar qué comandos se ejecutan cuando un jugador compra cada artículo.

Características:

• Menú de categorías - Navegar artículos por categoría
• Búsqueda - Filtrar artículos por nombre
• Editor de comandos - Añadir, eliminar y reordenar comandos
• Botones de variables - Inserción rápida de {player}, {item_name}
• Estado visual - Ver qué artículos tienen comandos configurados

Los artículos configurados se muestran en verde, los no configurados en gris.

Cómo funciona la entrega

1. El cliente completa la compra en tu tienda
2. El pedido se marca como completado
3. El plugin consulta entregas pendientes
4. Los artículos se dan al jugador
5. La entrega se marca como completa

Jugadores en línea

Los artículos se entregan inmediatamente cuando el jugador está en línea.

Jugadores desconectados

Los artículos se ponen en cola y se entregan cuando el jugador se conecta.

Configurar productos

Al crear productos en tu panel, configura lo que el jugador recibe:

Productos de rango

commands:
  - "lp user {player} parent set vip"
  - "broadcast &6{player} &7acaba de comprar &6VIP&7!"

Productos de artículos

commands:
  - "give {player} diamond_sword 1"
  - "give {player} diamond_pickaxe 1"
  - "give {player} diamond 64"

Variables

Solución de problemas

Error "Connection failed"

• Verifica que tu clave API sea correcta
• Verifica que tu servidor pueda alcanzar api.hytalepay.com
• Revisa la configuración del firewall

Artículos no se entregan

• Asegúrate que el nombre de usuario del jugador coincida exactamente
• Verifica que el plugin tenga permiso para ejecutar comandos