GachaVerse es un sistema interactivo donde:

• Donas dinero para crear participantes y ganar tiradas (1 dólar = 1 tirada).
• Usas esas tiradas para obtener ítems personalizados con rarezas únicas.
• Configuras ítems, restricciones y más desde un Dashboard accesible para todos los usuarios.
• Monitoreas estadísticas y premios en tiempo real.

Nota clave: Si eres nuevo, el sistema estará vacío hasta que configures ítems en el Dashboard (6.1). Sin ítems, no podrás tirar, así que es el primer paso esencial.

2.1 Registro e Inicio de Sesión

1. Página Principal (/): Al llegar, verás un banner grande con "Bienvenido a GachaVerse" y un botón:
   • Si no tienes cuenta, haz clic en "Ir a Login" para ir a /login.
2. En /login:
   • Iniciar Sesión: Ingresa tu usuario (ej. "Demo") y contraseña (ej. "demo"), luego haz clic en "Iniciar Sesión".
   • Registrarte: Haz clic en "¿No tienes cuenta? Regístrate aquí", escribe un usuario y contraseña nuevos, y presiona "Registrarse".
   • Errores: Si algo falla (ej. contraseña incorrecta), un mensaje rojo aparecerá arriba del formulario (ej. "Credenciales inválidas").
3. Tras loguearte, irás a /gacha, la página principal del juego.

2.2 Configuración Inicial (Usuarios Nuevos)

• Sin ítems no hay juego: Al empezar, no tendrás ítems configurados. Ve a /dashboard y añade al menos un ítem (ver 6.1).
• Cuenta Demo: Usa las credenciales demo/demo para explorar un ejemplo con 5 ítems preconfigurados y $500 donados. Es ideal para practicar antes de crear tu propio GachaVerse.

La página /gacha es donde ocurre la acción. Aquí está lo que encontrarás:

3.1 Banner Superior

Un banner personalizado (imagen o video) aparece en la parte superior con el texto "Gacha de [tu usuario]". Ejemplo: "Gacha de Demo". Personalízalo en el Dashboard (6.6).

3.2 Sección de Tiradas (Gachapon)

• Contador: Si seleccionas un participante, verás algo como: "Participante: Demo | Donaciones: $500.00 | Tiradas Usadas: 22 | Tiradas Disponibles: 478". Esto muestra el estado del participante activo.
• Animación: Al tirar, un cuadro cambia de color según la rareza:
  • Gris: Común (★)
  • Verde: Poco Común (★★)
  • Azul: Raro (★★★)
  • Morado: Épico (★★★★)
  • Dorado: Legendario (★★★★★)
• Tarjeta de Ítem: Muestra el último ítem ganado con su imagen, nombre (ej. "Espada Mágica") y estrellas (★ a ★★★★★). Si no has tirado, aparece "?????" con una imagen misteriosa.
• Botones:
  • "¡Tira el Gacha!": Realiza una tirada manual. Desactivado si no hay tiradas disponibles o ítems configurados.
  • "Tirar 10 Veces": Ejecuta hasta 10 tiradas automáticas (o las disponibles si son menos). Durante el proceso, aparecen "Pausar" (para detener) y "Continuar" (para reanudar).

3.3 Donaciones

• Formulario:
  • "Nombre del participante": Escribe un nombre único (ej. "Jugador1") para crear un nuevo participante o usar uno existente.
  • "Cantidad (USD)": Ingresa al menos $1.00 por tirada (ej. $5.00).
  • Botón "Añadir Donación": Registra la donación y suma tiradas al participante.
• Error: Si algo falla (ej. cantidad menor a $1 o nombre vacío), un mensaje rojo aparece arriba (ej. "Cantidad inválida").

3.4 Estadísticas

• Total Donado: Muestra la suma de todas tus donaciones en dólares (ej. "$500.00").
• Top Donadores: Lista de participantes con sus nombres y montos (ej. "Demo - $500"). Haz clic en un nombre para hacerlo activo y ver sus ítems/tiradas.

3.5 Tus Premios

• Lista de ítems ganados por el participante activo, cada uno en una tarjeta con:
  • Imagen (ej. "Espada Mágica").
  • Nombre y estrellas (ej. "★★★★").
  • Estado: "No Canjeado" o "Canjeado".
• Selector: "Mostrar: [1, 5, 10, 25, 50]" cambia cuántos ítems ves por página.
• Paginación: Botones "Anterior" y "Siguiente" para navegar entre páginas.
• Modal: Haz clic en un ítem para abrir un cuadro:
  • "Obtener Recompensa": Marca el ítem como "Canjeado" (no se puede deshacer).
  • Si ya está canjeado, aparece un sello "Recompensa Canjeada".

1. En el formulario de /gacha:
   • Nombre: Ej. "Jugador1".
   • Cantidad: Ej. $5.00.
   • Clic en "Añadir Donación".
2. Resultado:
   • Cada $1 = 1 tirada. Ejemplo: $5 = 5 tiradas disponibles.
   • Las donaciones son permanentes (no se pueden eliminar).
3. Cómo funciona:
   • Total Donado: Suma todo el dinero donado por el participante (ej. $5).
   • Tiradas Disponibles: Refleja cuántas tiradas quedan tras usarlas. Ejemplo: Donas $5, tiras 1 vez, te quedan 4 tiradas.
   • Nota técnica: El sistema usa un valor interno (effective_donation) para calcular esto, pero no lo ves; solo ves "Tiradas Disponibles".

Ejemplo: Donas $25 más a "Jugador1" (total $30), tiras 2 veces, "Donaciones: $30.00 | Tiradas Usadas: 2 | Tiradas Disponibles: 28".

Nota: Cada participante es independiente, con sus propias donaciones y tiradas, todo ligado a tu cuenta.

1. Manual:
   • Elige un participante con tiradas (ej. "Demo" con 478 disponibles).
   • Clic en "¡Tira el Gacha!".
   • Ves la animación y el ítem ganado (ej. "Cetro Épico ★★★★").
2. Automático:
   • Clic en "Tirar 10 Veces".
   • Realiza hasta 10 tiradas (o las disponibles). Ejemplo: Si tienes 7, solo tira 7.
   • Controla con "Pausar" (detiene) y "Continuar" (reanuda).

Errores:

• Sin ítems: Aparece "No hay ítems configurados" (antes "Assignment to constant variable"). Solución: Añade ítems en /dashboard (6.1).
• Sin tiradas: Botones "¡Tira el Gacha!" y "Tirar 10 Veces" estarán grises y desactivados.

Personaliza tu GachaVerse aquí. Todos los usuarios tienen control total. En la parte superior, botones como "Items", "Restricciones", etc., cambian de sección. Cada sección muestra una cuadrícula con paginación y un selector "Mostrar: [5, 10, 15, 50]".

6.1 Ítems

• Añadir:
  • Clic en "Añadir Nuevo Ítem". Se abre un modal:
  • Nombre: Ej. "Espada Mágica".
  • Rareza: Elige entre Común (★), Poco Común (★★), Raro (★★★), Épico (★★★★), Legendario (★★★★★).
  • Imagen: Sube un archivo (.webp, .jpg, .png, .gif, máx. 3MB). Si excede 3MB, aparece un error (ej. "Archivo demasiado grande") y no se guarda.
  • Previsualización: A la derecha, ves cómo quedará la tarjeta (ej. "Espada Mágica ★★★").
  • Clic en "Añadir Ítem" para guardar.
• Editar: Botón en cada tarjeta para cambiar nombre, rareza o imagen.
• Eliminar: Botón para borrar el ítem.
• Nota: Debes tener al menos 1 ítem para que el Gacha funcione.

6.2 Restricciones

• Añadir:
  • Clic en "Añadir Nueva Restricción":
  • Ítem: Selecciona uno (ej. "Cetro Épico").
  • Cantidad Total: Cantidad de ítems totales.
  • Único: "Sí" = solo 1 vez por participante; "No" = repetible hasta el límite.
  • Período de cooldown: Tipo de espera del cooldown (minutos, horas, días, semanas, meses).
  • Valor del cooldown: Tiempo de espera (ej. "1 hora" tras ganarlo).
  • Donación Mínima: Cantidad requerida para ser elegible (ej. $25).
  • Cantidad Global: Campo no editable (lo dejas como está), ya que lo toma restricciones.
  • Peso de prioridad: Campo no editable (lo dejas como está).
  • Guarda con "Añadir Restricción".
• Editar/Eliminar: Botones en cada tarjeta.

6.3 Preferencias

• Individual:
  • Clic en "Añadir Preferencia Individual":
  • Participante (ej. "Jugador1") + ítem (ej. "Espada Mágica") + % (0-100).
  • Ejemplo: "Jugador1, 80% Espada Mágica".
  • 0% = ese participante no lo gana nunca.
  • Prioridad alta sobre otras reglas.
• Global:
  • Clic en "Añadir Preferencia Global":
  • Ítem + % para todos. Ejemplo: "Cetro Épico, 100%" (lo ganas si cumples la donación mínima).
  • 0% = nadie lo gana.
• Ejemplo práctico:
  • "Jugador1" dona $5 (Tiradas Disponibles: 5). "Cetro Épico" requiere $25 mínimo. No lo gana.
  • Dona $25 más (Donaciones: $30, Tiradas Disponibles: 29). Si "Cetro Épico" tiene 100% global, lo ganas en la próxima tirada (quedan 28 tiradas).

6.4 Restricciones de Rareza

• Añadir:
  • Clic en "Añadir Restricción de Rareza":
  • Ámbito: "Global" (todos) o un participante (ej. "Jugador1").
  • Ítem o Rareza: Elige uno, no ambos (recomendado). Ej. "Legendario" o "Espada Mágica".
  • Intervalo: Tiradas (ej. 5) o tiempo (ej. "30 minutos").
  • Legendario cada 5 tiradas: Después de ganar un legendario, el jugador debe esperar 5 tiradas antes de poder ganar otro.
• Editar/Eliminar: En cada tarjeta.

6.5 Probabilidades

• Formulario:
  • Ajusta % por rareza (total = 100%):
  • Ejemplo: Común 50%, Poco Común 25%, Raro 15%, Épico 7%, Legendario 3%.
  • Por defecto: 50%, 25%, 15%, 7%, 3% (si no cambias nada).
• Clic en "Guardar Probabilidades".

6.6 Banners

• Añadir:
  • Clic en "Añadir Nuevo Banner":
  • Sube (.webp, .webm, .jpg, .png, .gif, máx. 5MB). Error si excede 5MB (ej. "Archivo excede 5MB").
  • Límite: Máximo 5 banners por usuario.
• Activar: Botón en cada tarjeta. Solo 1 activo a la vez; activar uno desactiva el anterior automáticamente.
• Eliminar: Borra banners inactivos.

6.7 Guías

Información detallada sobre cada sección, accesible desde el Dashboard. Estás viendo esta guía ahora.

• Error sin ítems: "No hay ítems configurados". Solución: Añade ítems (6.1).
• Cuenta Demo: Usa demo/demo para practicar (ej. $500 donados, 478 tiradas).
• Participantes: Cada nombre es un perfil separado con sus datos.
• Donaciones: Mínimo $1 por tirada, no eliminables.
• Errores en Dashboard: Mensajes específicos si subes archivos grandes (ej. "Archivo excede 3MB" para ítems, "Archivo excede 5MB" para banners).

¿Por qué no puedo realizar una tirada?

Asegúrate de que haya ítems configurados en el sistema (6.1) y que tengas tiradas disponibles. Si donaste pero no hay ítems, las tiradas se acumulan para cuando se añadan.

¿Qué sucede si dono y no hay ítems en el sistema?

Tus tiradas se guardan y estarán disponibles una vez que se añadan ítems al GachaVerse (6.1). No se pierden.

¿Cómo accedo a la demo del GachaVerse?

Usa las credenciales demo/demo para iniciar sesión y explorar las funciones básicas.

¿Para qué sirve una restricción de rareza?

Limita la frecuencia con la que tú (o todos los usuarios, si es global) puedes ganar ítems de una rareza específica (ej. Legendario) o un ítem concreto. Esto mantiene el juego equilibrado y los ítems raros más valiosos (6.4).

¿Qué es un intervalo de tiradas?

Es el número de tiradas que debes realizar después de ganar un ítem restringido (como un Legendario) antes de que puedas volver a ganarlo. Por ejemplo, si ganas un ítem con un intervalo de 5 tiradas, no podrás ganar otro igual hasta que hagas 5 tiradas más (6.4).

¿Qué es un intervalo de tiempo?

Es el tiempo de espera (en minutos, horas o días) que debe pasar después de que ganas un ítem restringido antes de que puedas volver a ganarlo. Por ejemplo, si el intervalo es 30 minutos para un Legendario, no podrás ganar otro hasta que pasen 30 minutos desde tu última victoria (6.4).

¿Quién se ve afectado por los intervalos de tiradas o tiempo?

Si la restricción es individual, solo tú (el usuario que ganó el ítem) debes esperar las tiradas o el tiempo configurado. Si es Global, todos los usuarios quedan restringidos hasta que se cumpla la condición (6.4).

¿Puedo cambiar las probabilidades de un ítem después de crearlo?

Sí, puedes ajustar las probabilidades base de las rarezas en la sección de probabilidades (6.5) o usar preferencias para modificarlas por usuario o globalmente (6.3).

¿Qué pasa si un banner no se carga en la página principal?

Verifica que el archivo (ej. .webp, .mp4) no supere el tamaño recomendado (3MB) y que esté activado correctamente en el dashboard (6.6).

¿Por qué no veo mis tiradas acumuladas?

Las tiradas se guardan en el sistema, pero solo se reflejan cuando hay ítems disponibles. Revisa tu historial de donaciones o consulta al administrador (6.1).