LuawardDocs

Bot do Discord e painel

Adicione o bot da Luaward a um servidor, deixe o painel e o perfil dele com a cara da sua marca, compartilhe um mesmo visual entre servidores e adicione seus próprios idiomas.

O que o bot faz

Os jogadores apertam um botão de um painel no seu servidor do Discord para obter o script, vincular uma chave, redefinir o dispositivo, ver a própria chave ou receber um cargo. Você decide como o painel e o bot aparecem em cada servidor, e pode reutilizar o mesmo visual em quantos servidores quiser.

Conectar um servidor

  1. Abra Dashboard → Connections e toque em Manage no cartão do Discord.
  2. Toque em Add the bot, escolha o projeto e depois o servidor na própria página do Discord. O Discord devolve você à Luaward e o servidor é vinculado sozinho.
  3. Se preferir digitar, abra Use a code instead, copie o código de uso único e execute /connect com ele no servidor. Um código funciona uma vez e dura 15 minutos.

Somente o proprietário do espaço de trabalho ou um administrador pode vincular um servidor, e um servidor pertence a um único espaço de trabalho por vez. O bot pede só as permissões de que precisa: ver canais, enviar mensagens, incorporar links, mudar o próprio apelido e gerenciar cargos (para o botão de obter cargo). Ele nunca pede Administrador.

Com o servidor vinculado, o cartão do Discord lista seus servidores com os ícones. Abra um para chegar à página de configurações dele. A página não tem um botão "voltar" separado; a barra lateral e a página Connections levam você a outros lugares.

A página do servidor

A página é uma fileira de abas em largura total, com uma prévia ao vivo ao lado (no celular, a prévia é uma aba própria). A prévia é desenhada pelo mesmo código com que o bot publica, então é o que o Discord vai mostrar. Enquanto houver alterações não salvas, aparece uma barra na parte de baixo: Save as mantém e Discard as descarta.

AbaO que você altera
OverviewSe o bot está no servidor, o que ainda falta fazer, qual modelo o servidor segue, o projeto que ele usa e a desconexão.
BotO nome, a imagem, o banner e o texto "sobre" do bot neste servidor.
LookEmbed ou Components V2, as imagens pequena e grande, a cor lateral e quais partes o painel mostra.
WordsO título, o texto, o rodapé, o seu próprio guia rápido e campos extras.
LanguagesQual idioma o painel usa e os idiomas que você adiciona.
Buttons and formA ordem, os nomes e as cores dos botões, os botões de link e o formulário que os jogadores recebem em Redeem key.
PostEnviar o painel a um canal ou atualizar o que já foi publicado.

Toda configuração que você deixar vazia usa o texto padrão da Luaward, então um servidor novo funciona antes de você mudar qualquer coisa.

Nome, imagem e rodapé do bot por plano

No Free, o bot se chama "Luaward" e o rodapé é "Powered by Luaward". A partir do Starter, você define o nome, a imagem, o banner e o texto sobre o bot por servidor e escreve o seu próprio rodapé. Títulos, textos, imagens, cores, botões e idiomas são gratuitos em todos os planos. Se um plano vencer, as partes pagas voltam às padrão na próxima vez que o painel for desenhado; as demais configurações permanecem.

Toque em Apply to the server na aba Bot para enviar ao Discord o nome, a imagem, o banner e o texto. Salvar antes é automático. O Discord exige que o bot seja membro do servidor, e o apelido precisa da permissão "Change Nickname".

Embed ou Components V2

O embed é o cartão clássico com uma barra colorida ao lado. O Components V2 é o layout mais novo do Discord, com seções, imagens grandes e divisórias. Ambos usam as mesmas palavras e os mesmos botões. Uma mensagem publicada como embed pode virar V2 depois que você confirmar, mas uma mensagem V2 nunca volta a ser embed: publique uma mensagem nova.

Modelos: um visual para vários servidores

Um modelo (preset) é um visual que você pode usar em muitos servidores. Um servidor que segue um modelo recebe todas as mudanças feitas nele e mantém apenas as poucas configurações que você alterou para aquele servidor.

  • Crie um na aba Overview: Choose a preset → New preset from this server. O visual atual do servidor é copiado para ele e o servidor passa a segui-lo.
  • Use-o em outro servidor na mesma folha. Ative Keep this server's own changes se o servidor deve manter o que já alterou.
  • Save to: enquanto um servidor segue um modelo, uma barra acima da aba pergunta onde salvar: This server only ou The preset (all servers). Salvar no modelo também remove a cópia própria dessas mesmas configurações neste servidor, que volta a seguir o modelo.
  • Back to the preset: uma aba com configurações diferentes do modelo mostra quantas são, com um botão que as descarta.
  • Stop using a preset mantém o visual atual como próprio do servidor. Excluir um modelo faz o mesmo com todos os servidores que o usavam.

Seus próprios idiomas

Em Languages, Panel language é o idioma do Discord de cada jogador ou um idioma único para todos. Add a language para escrever o painel, os nomes dos botões, o guia rápido, o formulário de Redeem key e as respostas do bot em qualquer idioma do Discord. Você também pode reescrever o tailandês ou o inglês linha por linha. Todo campo vazio usa o tailandês ou o inglês embutidos, conforme o idioma de reserva escolhido. Dá para adicionar até 20 idiomas.

As palavras entre chaves, como o nome do projeto ou o número de dias, são preenchidas sozinhas onde um campo indica que são permitidas.

Botões e formulário da chave

Mova, renomeie, mude a cor ou desligue cada botão, e adicione até cinco botões de link. Cada botão usa um dos ícones próprios do Luaward; digite um emoji no campo de emoji do botão para usar o seu. O bloco Key form define o título, o texto e os nomes dos campos do formulário que os jogadores recebem em Redeem key; essas palavras valem para todos os idiomas, e um campo vazio usa o texto de cada idioma. O campo da chave sempre existe e é sempre obrigatório.

O que o jogador recebe em Obter script

Com um único script, o jogador o recebe na hora, já com a própria chave. Com vários, um menu pergunta primeiro qual deles, então nada longo é enviado até que ele escolha, e o mesmo menu fica sob o script para trocar. Um jogador com mais de uma chave também recebe um menu de chaves; a melhor é escolhida por ele (chave vitalícia primeiro, depois a que dura mais, as encerradas por último). Sob cada script, o botão verde Mobile copy envia o script como texto simples, então no celular basta segurar essa mensagem e escolher Copiar texto para copiar tudo de uma vez. Um script que não precisa de chave é oferecido a todos; os demais, só a quem tem uma chave neste projeto.

No menu, cada script mostra a própria imagem: a que você envia para ele, senão o ícone do jogo, senão a imagem do projeto e, se não houver nenhuma, o ícone do Luaward. O Luaward transforma essas imagens em emojis do próprio app do Discord (a imagem de um script é enviada ao Discord dessa forma) por conta própria: quando um jogador usa Obter script e um script ainda não tem o emoji da sua imagem, e também depois que você publica ou atualiza o painel ou abre a aba Regras. Uma imagem que ainda não está pronta mostra o ícone e a imagem aparece em alguns minutos.

Regras para os jogadores

A aba Regras define o que o bot permite a um jogador neste servidor. Como o resto da página, as regras podem ser compartilhadas por um modelo e alteradas para um único servidor.

  • O que o Obter script entrega: cada script (um menu de loaders), um Loader Universe (um único link que funciona em qualquer jogo e encontra sozinho o script certo) ou ambos em um menu. Você escolhe quais Loader Universe e quais scripts o bot oferece; "Todos os scripts" inclui também os que você adicionar depois. Um Loader Universe só funciona com chaves dos projetos que ele inclui, e a página avisa quando o escolhido não inclui o projeto deste servidor.
  • Chaves que um jogador pode vincular: o máximo de chaves que uma conta do Discord pode vincular com Resgatar chave, de 1 a 10, ou sem limite. Chaves encerradas ou banidas não contam, e as que um administrador entrega com /whitelist não têm limite.
  • Redefinir um dispositivo: regras do botão Redefinir dispositivo somente neste servidor; a configuração do projeto (o painel, a página do jogador de um Loader Universe) não muda. Siga o projeto ou defina as suas: se é permitido, quantos dias esperar, o máximo de redefinições por chave em toda a vida e em qualquer período de 30 dias (só contam as que o próprio jogador fez, não as de um administrador) e se pergunta antes, com um aviso e os botões Redefinir agora e Cancelar. A linha Redefinir dispositivo do painel mostra as regras que o bot usa.

Alterar só as regras não deixa o painel publicado desatualizado, porque nenhuma mensagem muda.

Publicar o painel

Em Post, escolha um canal em que o bot possa escrever e toque em Post. Depois, a mesma página oferece Update the posted panel, que edita a mensagem no lugar. As alterações não salvas são salvas antes. Se o Discord não confirmar uma publicação, a página avisa e espera; confira o canal antes de tentar de novo.

Mover ou desconectar um servidor

Em Overview você pode apontar o servidor para outro projeto do mesmo espaço de trabalho, ou desconectá-lo. Depois de desconectado, a mensagem do painel continua no Discord, mas os botões deixam de funcionar, e as configurações próprias do servidor são apagadas. Seus modelos são mantidos, e você pode conectar o servidor de novo mais tarde.

Limites de uso

Uma pessoa pode usar o bot 30 vezes por minuto e um servidor, no total, 1.200 vezes por minuto; um servidor comum nunca chega perto desse limite. Quem passa do limite recebe uma resposta curta de "muitas solicitações" e pode tentar de novo em um minuto. Se a Luaward não conseguir contar as solicitações por um instante, os botões que só leem (obter o script, ver sua chave) continuam funcionando, enquanto os que alteram algo (redefinir o dispositivo, obter um cargo, resgatar uma chave e os comandos de administração) pedem ao jogador que tente de novo em instantes.

Faça por código

Tudo o que há nesta página também está disponível pela API para desenvolvedores, pelos SDKs e pelas ferramentas MCP.