LuawardDocs

Loader Universe

Um link para um grupo de jogos. Os jogadores colam uma vez e o Luaward executa o script feito para o jogo em que estão.

O que é

Um Loader Universe é um link que atende todo um grupo de jogos. Em vez de manter um script hub com todos os PlaceId e enviá-lo de novo a cada jogo adicionado, você escolhe o jogo ao criar cada script. O link encontra o script certo para o jogo em que o jogador está, então nunca muda e nunca precisa de novo envio.

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

Você pode criar quantos Loader Universe quiser, por exemplo um por estúdio ou um por série de jogos.

Criar um

  1. Abra Loader Universe no painel e escolha Novo Loader Universe.
  2. Dê um nome. Um link privado é criado para você: um endereço longo e aleatório (como luaward.com/universe/d1417f68…) que ninguém consegue adivinhar. Ele nunca muda, então os jogadores continuam usando.
  3. Marque os projetos de onde ele puxa scripts. Os scripts que informam seus jogos entram na hora.
  4. Deixe Adicionar scripts novos sozinho ligado nos projetos cujos scripts novos devem entrar sem nenhuma ação sua.

Cada Loader Universe é uma seção da página, como um projeto na página Projetos. Cada jogo é uma linha, com os scripts que respondem por ele, um interruptor para pausar aquele jogo e suas execuções nos últimos 30 dias.

O que os jogadores colam

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

O botão Loader de uma seção copia exatamente estas duas linhas. A linha da chave só é necessária para scripts com chave.

A página que seus jogadores veem

Abra o link sem .lua em um navegador (https://luaward.com/universe/YOUR_LINK) e os jogadores veem uma página feita para eles, não código:

  • Pegar o script: as duas linhas para colar, um botão grande de copiar e três passos. No celular é um toque.
  • Minha chave: o jogador cola a chave e vê como ela está: tempo restante, se há dispositivo vinculado, quantas redefinições, quantas execuções, o último jogo. Pode copiar o script já com a chave e redefinir o próprio dispositivo (se seu projeto permitir e os dias de espera entre redefinições já passaram). Não precisa de conta: a chave é a entrada, protegida pelo Cloudflare Turnstile e por um limite de chaves erradas.
  • Jogos: todos os jogos que o Loader Universe suporta, com imagem, versão e um botão que abre na plataforma. Quem não vê seu jogo pode pedi-lo com um link do jogo ou um place id; os pedidos são contados junto com os jogos que os jogadores executaram sem suporte, e você vê o que criar a seguir.
  • Ajuda: respostas curtas sobre dispositivo travado, celulares e erros.

A página fala o idioma do jogador (os mesmos seis do painel), é pensada primeiro para celular e não aparece para buscadores. Abra-a pelo painel com o botão ao lado de Loader em um Loader Universe. Um runtime que pedir a página por engano é enviado ao loader .lua.

Escolher o jogo de um script

Ao adicionar um script, o primeiro passo pergunta para qual jogo ele foi feito: um jogo, vários ou todos. Digite um nome, cole um link do jogo ou informe um Place ID. O Luaward consulta as páginas públicas da plataforma para obter o jogo, seu ícone e seus lugares, e guarda o jogo pelo universo, de modo que todos os lugares do jogo contam, inclusive os adicionados depois. Um script pode informar até 30 jogos.

O interruptor Só permitir que rode neste jogo trava o script. Uma execução de qualquer outro jogo, mesmo pelo link do loader do próprio script, é recusada com GAME_NOT_SUPPORTED antes de enviar qualquer coisa.

Um script que não informa jogo ("todos os jogos") nunca é escolhido por um Loader Universe.

Os scripts entram sozinhos

  • Marque um ou mais Loader Universe no segundo passo de Novo script.
  • Ou ligue Adicionar scripts novos sozinho para um projeto nas configurações do Loader Universe.

Um Loader Universe mostra no fim da seção os scripts que esperam um jogo, para que nenhum seja esquecido.

Como o script é escolhido

O link pergunta ao Luaward quais scripts foram feitos para o jogo do jogador. Se houver um, ele roda. Se houver vários, por exemplo um projeto Premium e outro Freemium que têm o jogo:

  1. A chave do jogador diz a qual projeto ele pertence: o script desse projeto é escolhido primeiro, depois um script cujo projeto também aceita as chaves desse projeto (a configuração que seus projetos já usam para compartilhar chaves).
  2. Sem chave, ou com uma chave que não existe nesses projetos, escolhe-se um script que rode sem chave e, se não houver, o primeiro na ordem que a página mostra.

O loader do script escolhido então confere chave, dispositivo e plano como sempre, então o link não deixa ninguém passar por essas verificações.

Um jogo que nada suporta

Nas configurações do Loader Universe escolha o que o jogador recebe em um jogo para o qual nenhum script foi feito: uma mensagem (a sua, ou a nossa se você não escrever nada) no console do runtime e como notificação no jogo, ou uma expulsão. A página conta essas execuções e lista os jogos que os jogadores pediram, para você saber o que criar a seguir.

Pausa

Um Loader Universe pausado avisa os jogadores de que está pausado. Pausar um jogo só para de responder por aquele jogo. Desligar um script, ou tirá-lo do Loader Universe, faz com que ele deixe de ser escolhido em poucos segundos.

Desenhe a página do jogador

Em um Loader Universe, escolha Desenhar a página do jogador para definir como essa página fica e o que ela oferece. A imagem ao lado das configurações muda enquanto você digita; Salvar a coloca na página. No celular as configurações são blocos que abrem uma folha.

  • Página aberta: se você a desligar, /universe/… diz que está fechada. O link .lua que os jogadores executam no jogo não é afetado.
  • Layout: Portal (abas, a página como sempre foi), Blocos (título grande, quatro botões, cartão da chave, script, jogos) ou Loja (cartões de plano primeiro, para quem vende chaves). Trocar o layout mantém seus textos, links e planos.
  • Aparência: cores, uma cor de destaque à sua escolha (o contraste do texto sobre ela é verificado), cantos, fonte e fundo.
  • Cada parte pode ser mostrada, ocultada e reordenada: cabeçalho, título, quatro botões, caixa de chave, cartão da chave, script, jogos, anúncio, planos e compra, perguntas, links e rodapé.
  • Textos em seis idiomas: selo, título, subtítulo, nomes dos botões, preço, cartões de plano, anúncio, perguntas e links. Um idioma vazio mostra o texto em inglês e depois o primeiro que você escreveu.
  • Quatro botões: Digitar chave, Obter script, Redefinir dispositivo e Comprar. Renomeie, oculte ou reordene; o de compra pode se ocultar quando o jogador já tem uma chave válida.
  • Caixa e cartão da chave: escolha o que o cartão mostra (dispositivo, redefinições, execuções, último jogo, nome do pacote por projeto), quantas chaves um navegador guarda (1 a 10) e se a página verifica a chave salva mais recente ao abrir. A lista de chaves lembradas fica no navegador do jogador. Registros de licença e verificações de autorização são guardados e processados no servidor. O botão de redefinir pode ser ocultado; quem pode redefinir e com que frequência continua vindo das configurações de cada projeto.
  • Jogos um a um: selo de estado (automático pelos scripts, pronto, atualizando, pausado ou novo), uma linha de nota, ocultar um jogo e ordenar por estado, nome, versão ou à mão.
  • Compra e planos: o botão de compra leva à sua própria loja (só https): a Luaward não recebe o dinheiro, o jogador compra de você e recebe a chave, por exemplo pelo Shop Bridge. Um botão de chave grátis pode apontar para uma das suas páginas de chave. Adicione até quatro cartões de plano com preço e vantagens.
  • Anúncio: uma linha no topo com data de término. Quem a fecha não a vê de novo até você mudá-la.

Nada do que você escreve é executado como código: a página é desenhada só com suas escolhas, os links devem começar com https:// e a verificação humana e os limites das chaves continuam como estão.