Skip to content

Rename

Por padrão existe a opção de renomear seus jogadores deixando o nome dos jogadores no discord vinculado com seus personagens de último login, porém o sistema é feito para bases MULTI CHARACTER, que é onde faz mais sentido de ser utilizado.

Dica

Se você se sentir a vontade de utiliza-lo em base SINGLE CHARACTER não tem problema!! Só não darei suporte no script por não ser de minha responsabilidade a produção do mesmo, tendo em vista que produzo o seu BOT e não sua BASE DO SERVIDOR.

Script Rename

Você poderá baixar o script abaixo e testar em seu servidor para vincular o seu servidor com o sistema de rename:

Script - FIVEM
VersãoLink
Creative V4Baixar Script
Creative V5Baixar Script
Creative Network 1 (V6)Baixar Script
Creative Network 2 (V7)Baixar Script

Código Base para VRPEX Creative

lua
function RenameCharacter(Passport)
    local Character = vRP.SingleQuery("characters/Person", { Passport = Passport })
    local License = vRP.Identities(Passport)
    local Account = vRP.Account(License)

    if Account and Account.Discord and Character then
        exports["discord"]:Content("Rename", Account.Discord.." "..Passport.." "..Character.Name.." "..Character.Lastname)
    end
end

AddEventHandler("Connect", function(Passport)
    RenameCharacter(Passport)
end)

⚠️ MUITA ATENÇÃO

O código acima não se refere aos meus serviços prestado então não há qualquer tipo de suporte em cima do mesmo. É de total responsabilidade do contratante e sua equipe desenvolver o webhook de envio do rename. Esse código é apenas para ser utilizado de base e se preciso utilizá-lo devido a ofuscação do mesmo (sem necessidade alguma) vindo de quem distribui a base.

Dica

Você é livre para usar esses scritps da forma que quiser. Lembro que se baixado dessa documentação estará seguro sem oferecer nenhum perigo ao seu servidor.

Atenção

Gosto de incentivar também que o desenvolvedor de uma olhada no código e confirme todo o funcionamento antes de qualquer coisa, esses scripts são feito para auxilio e não daremos mais suporte que isso para essa função.

CUIDADO!

Após o download lembre-se de alterar onde tem no script WEBHOOK_LINK para o webhook que você gerou nos primeiros passos no seu canal de log rename.

Lógica do Sistema

Seguindo os passos desse guia, toda vez que um usuário conectar em seu servidor o servidor irá enviar um webhook para o canal de RENAME seguindo o padrão abaixo: id_discord id_in_game nome sobrenome

Exemplo:

1168388462873952256 1 Lucas Lisboa ou discord:1168388462873952256 1 Lucas Lisboa (Qualquer uma das duas opções exemplificada funcionará normalmente, vai de você decidir qual irá usar).

Na hora que o bot receber esse webhook ele altera o nome do usuário seguindo o padrão que você selecionar nas configurações de rename.

Configurando da Forma Correta

Imagine que você irá enviar um webhook normal discord, como se estivesse enviando o de logs, só que ao invés de rodar num link padrão discord, você irá rodar através do link vinculado ao seu bot:

txt
https://[node].lisweb.systems/[porta]/member/rename

node é o node onde o seu bot está vinculado;
porta é a porta em que seu bot está rodando;

Para achar essas infos, o link completo até a porta que seu bot está rodando irá estar no comando !config > Menu Gerenciar Configurações > Infos Atuais e irá aparecer as infos de Websocket do seu bot.

Seguindo a lógica acima, enviando id_discord id_in_game nome sobrenome no content normalmente como se fosse um webhook do discord. O bot irá renomear o usuário, se encontra-lo em qualquer discord que ele estiver presente, seguindo a lógica também de permissões + se o webhook tiver sido enviado de forma correta.

INFO

Lembre-se que o BOT tem que estar presente nesse discord para essas funções funcionarem e também o canal tem que estar visível para o BOT caso contrário o log não será registrado.

Configurar o formato do Rename

Abaixo você pode aprender a configurar os dados do formato em que o seu rename irá ser efetuado pelo bot em AMBOS os sistemas disponíveis acima.

#id nome sobre Tipo 1
nome sobrenome #id Tipo 2
id | nome sobrenome Tipo 3
nome sobrenome | id Tipo 4
id - nome sobrenome Tipo 5
nome sobrenome - id Tipo 6
id • nome sobrenome Tipo 7
nome sobrenome • id Tipo 8

Toda essa lógica é explicada também ao selecionar o tipo pelo comando !config > Gerenciar Sistemas... > Configurar Rename.

Dica

Você pode executar um teste de conexão socket através da maquina do seu servidor configurada no seu bot, enviando um request GET para:

txt
https://[node].lisweb.systems/[porta]/test

Se a conexão for estabelecida o bot irá responder com seus devidos dados. Mas esse request so poderá ser enviado de dentro da maquina do seu servidor configurada em seu bot.


Atenção

O usuário que tiver cargo com permissão Gerenciar Mensagens ativa não receberá a alteração de nome por que o bot tratará ele como STAFF do seu servidor em ambos os métodos.

Lançado sob a Licença MIT.