LuawardDocs

Loader Universe

Un enlace para un grupo de juegos. Los jugadores lo pegan una vez y Luaward ejecuta el script hecho para el juego en el que están.

Qué es

Un Loader Universe es un enlace que sirve a todo un grupo de juegos. En vez de mantener un script hub con todos los PlaceId y subirlo de nuevo cada vez que añades un juego, eliges el juego al crear cada script. El enlace encuentra el script adecuado para el juego en el que está el jugador, así que nunca cambia y nunca necesita una subida nueva.

https://luaward.com/universe/YOUR_LINK.lua

Puedes crear todos los Loader Universe que quieras, por ejemplo uno por estudio o uno por serie de juegos.

Crear uno

  1. Abre Loader Universe en el panel y elige Nuevo Loader Universe.
  2. Ponle un nombre. Se crea un enlace privado: una dirección larga y aleatoria (como luaward.com/universe/d1417f68…) que nadie puede adivinar. Nunca cambia, así que los jugadores lo siguen usando.
  3. Marca los proyectos de los que tomará scripts. Los scripts que indican sus juegos se unen al instante.
  4. Deja activado Añadir scripts nuevos solo en los proyectos cuyos scripts nuevos deban unirse sin que hagas nada.

Cada Loader Universe es una sección de la página, como un proyecto en la página Proyectos. Cada juego es una fila, con los scripts que responden por él, un interruptor para pausar ese juego y sus ejecuciones de los últimos 30 días.

Lo que pegan los jugadores

script_key = "KEY";
loadstring(game:HttpGet("https://luaward.com/universe/YOUR_LINK.lua"))()

El botón Loader de una sección copia exactamente estas dos líneas. La línea de la clave solo hace falta para scripts con clave.

La página que ven tus jugadores

Abre el enlace sin .lua en un navegador (https://luaward.com/universe/YOUR_LINK) y los jugadores ven una página hecha para ellos, no código:

  • Obtener el script: las dos líneas para pegar, un botón grande de copiar y tres pasos. En el móvil es un toque.
  • Mi clave: el jugador pega su clave y ve cómo está: tiempo restante, si hay un dispositivo vinculado, cuántos restablecimientos, cuántas ejecuciones, el último juego. Puede copiar el script con su clave ya puesta y restablecer su dispositivo por sí mismo (si tu proyecto lo permite y pasaron los días de espera entre restablecimientos). No hace falta cuenta: la clave es la entrada, y la protegen Cloudflare Turnstile y un límite de claves erróneas.
  • Juegos: todos los juegos que admite el Loader Universe, con su imagen, versión y un botón que lo abre en la plataforma. Un jugador que no ve su juego puede pedirlo con un enlace del juego o un place id; los pedidos se cuentan junto a los juegos que los jugadores ejecutaron sin soporte, así ves qué crear a continuación.
  • Ayuda: respuestas cortas sobre dispositivo bloqueado, móviles y errores.

La página habla el idioma del jugador (los mismos seis del panel), está pensada primero para el móvil y no se muestra a los buscadores. Ábrela desde el panel con el botón junto a Loader en un Loader Universe. Un runtime que pida la página por error es enviado al loader .lua.

Elegir el juego de un script

Al añadir un script, el primer paso pregunta para qué juego está hecho: un juego, varios o todos. Escribe un nombre, pega un enlace del juego o introduce un Place ID. Luaward consulta las páginas públicas de la plataforma para obtener el juego, su icono y sus lugares, y guarda el juego por su universo, de modo que cuentan todos los lugares del juego, también los que se añadan después. Un script puede indicar hasta 30 juegos.

El interruptor Solo permitir que se ejecute en este juego bloquea el script. Una ejecución desde cualquier otro juego, incluso por el enlace del propio loader del script, se rechaza con GAME_NOT_SUPPORTED antes de enviar nada.

Un script que no indica ningún juego ("todos los juegos") nunca es elegido por un Loader Universe.

Los scripts se unen solos

  • Marca uno o más Loader Universe en el segundo paso de Nuevo script.
  • O activa Añadir scripts nuevos solo para un proyecto en los ajustes del Loader Universe.

Un Loader Universe muestra al final de su sección los scripts que esperan un juego, para que no se olvide ninguno.

Cómo se elige el script

El enlace pregunta a Luaward qué scripts están hechos para el juego del jugador. Si hay uno, se ejecuta. Si hay varios, por ejemplo un proyecto Premium y otro Freemium que tienen el juego:

  1. La clave del jugador dice a qué proyecto pertenece: se elige primero el script de ese proyecto, luego uno cuyo proyecto también acepte las claves de ese proyecto (el ajuste que tus proyectos ya usan para compartir claves).
  2. Sin clave, o con una clave que no existe en estos proyectos, se elige un script que funcione sin clave y, si no, el primero en el orden que muestra la página.

El loader del script elegido comprueba después la clave, el dispositivo y el plan como siempre, así que el enlace no deja pasar a nadie por encima de esas comprobaciones.

Un juego que nada admite

En los ajustes del Loader Universe elige qué recibe un jugador en un juego para el que no hay ningún script: un mensaje (el tuyo, o el nuestro si no escribes nada) en la consola del runtime y como notificación en el juego, o una expulsión. La página cuenta estas ejecuciones y lista los juegos que pidieron los jugadores, para que sepas qué crear a continuación.

Pausa

Un Loader Universe en pausa avisa a los jugadores de que está en pausa. Pausar un juego solo deja de responder por ese juego. Apagar un script, o sacarlo del Loader Universe, hace que deje de elegirse en pocos segundos.

Diseña la página del jugador

En un Loader Universe, elige Diseñar la página del jugador para decidir cómo se ve esa página y qué ofrece. La imagen junto a los ajustes cambia mientras escribes; Guardar la pone en la página. En un móvil los ajustes son mosaicos que abren una hoja.

  • Página abierta: si la apagas, /universe/… dice que está cerrada. El enlace .lua que los jugadores ejecutan en el juego no se ve afectado.
  • Diseño: Portal (pestañas, la página como siempre fue), Mosaicos (título grande, cuatro botones, tarjeta de clave, script, juegos) o Tienda (primero las tarjetas de plan, para quien vende claves). Cambiar de diseño conserva tus textos, enlaces y planes.
  • Aspecto: colores, un color de acento a tu elección (se comprueba el contraste del texto sobre él), esquinas, fuente y fondo.
  • Cada parte se puede mostrar, ocultar y reordenar: encabezado, título, cuatro botones, casilla de clave, tarjeta de clave, script, juegos, anuncio, planes y compra, preguntas, enlaces y pie.
  • Textos en seis idiomas: insignia, título, subtítulo, nombres de botones, precio, tarjetas de plan, anuncio, preguntas y enlaces. Un idioma vacío muestra el texto en inglés y luego el primero que escribiste.
  • Cuatro botones: Escribir clave, Obtener script, Restablecer dispositivo y Comprar. Cámbiales el nombre, ocúltalos o reordénalos; el de compra puede ocultarse cuando el jugador ya tiene una clave válida.
  • Casilla y tarjeta de clave: elige qué muestra la tarjeta (dispositivo, restablecimientos, ejecuciones, último juego, nombre del paquete por proyecto), cuántas claves guarda un navegador (1 a 10) y si la página comprueba la clave guardada más reciente al abrirse. La lista de claves recordadas se guarda en el navegador del jugador. Los registros de licencia y las comprobaciones de autorización se guardan y procesan en el servidor. El botón de restablecer se puede ocultar; quién puede restablecer y cada cuánto sigue viniendo de los ajustes de cada proyecto.
  • Juegos uno a uno: insignia de estado (automática según los scripts, listo, actualizando, en pausa o nuevo), una línea de nota, ocultar un juego y ordenar por estado, nombre, versión o a mano.
  • Compra y planes: el botón de compra lleva a tu propia tienda (solo https): Luaward no cobra, el jugador te compra a ti y recibe la clave, por ejemplo con el Shop Bridge. Un botón de clave gratis puede apuntar a una de tus páginas de claves. Añade hasta cuatro tarjetas de plan con precio y ventajas.
  • Anuncio: una línea arriba con fecha de fin. Quien la cierra no la vuelve a ver hasta que la cambies.

Nada de lo que escribes se ejecuta como código: la página se dibuja solo con tus elecciones, los enlaces deben empezar con https:// y la verificación humana y los límites de las claves siguen como estén.