VelorSTUDIO
PT
BuiltByBit

Produtos

PluginsStatusAssetsPlayground

Ferramentas

AssistenteCompararCompatibilidadeDocumentação

Suporte

Obter ajudaPerguntasConfiançaCasos de usoHistórico de alterações
DiscordBuiltByBit

Visão geral

Aguardando aprovação v1.3.0
Plataformas
Paper, Spigot, Folia
Minecraft
1.21 ou mais recente
Java
21
Obrigatório
Nenhum
Opcional
Vault, PlaceholderAPI, HeadDB

O ReferralTrack mostra qual lista de servidores, vídeo, convite do Discord ou amigo trouxe cada jogador ao seu servidor. Os jogadores informam ao servidor de onde vieram com /referral ou digitam o código de convite permanente de um amigo, e podem ganhar uma recompensa por isso. Tudo é armazenado no seu próprio banco de dados (SQLite ou MySQL/MariaDB). Nada sai do servidor, exceto o webhook do Discord que você configurar.

Requisitos #

  • Minecraft 1.21 ou mais recente, Java 21.
  • Paper, Spigot ou Folia.
  • Vault e um plugin de economia compatível com o Vault são opcionais e necessários apenas para recompensas em dinheiro.
  • PlaceholderAPI é opcional.
  • HeadDB e Head Database são opcionais e adicionam cabeças personalizadas aos menus. Sem eles, é usado um material normal do Bukkit.

As bibliotecas do banco de dados estão dentro do jar, então a primeira inicialização não baixa nada.

Instalação #

  1. Coloque ReferralTrack.jar em plugins/ e inicie o servidor.
  2. Edite plugins/ReferralTrack/config.yml: suas origens, as recompensas e o webhook do Discord.
  3. Execute /referraltrack validate e depois /referraltrack reload.
  4. Execute /referraltrack doctor para verificar o banco de dados, as recompensas e as integrações.

O que ele faz #

  • Códigos de origem. Os jogadores digitam /referral youtube (ou qualquer código que você defina). Um código conhecido digitado errado, como yotube, é associado ao mais próximo.
  • Códigos pessoais permanentes. Cada jogador recebe um código de convite à prova de colisões (por exemplo RT-AB12CD3) vinculado ao seu UUID, de modo que sobrevive a uma troca de nome. Os nomes de amigos e os códigos de origem continuam funcionando.
  • Recompensas. Dinheiro pelo Vault e/ou comandos de console, com um limite por endereço IP, uma verificação de mesmo IP nos convites de amigos, tetos de recompensa e marcos de convites.
  • Indicações verificadas (opcional). As recompensas e o crédito do ranking podem ficar retidos até que o novo jogador atinja um limite de tempo de jogo e de entradas. Desativado por padrão.
  • Revisão de fraude (opcional). Sinais de risco explicáveis podem reter uma indicação para que a equipe a aprove ou rejeite.
  • Campanhas (opcional). Campanhas com prazo definido, com datas, códigos, multiplicadores, recompensas e marcos próprios.
  • Hub do jogador. /referral abre um menu pessoal com o código do jogador, a origem, o estado de validação e as recompensas. Em servidores que oferecem suporte, o hub pode abrir como um diálogo Java nativo.
  • Ferramentas da equipe. Painel, análises, ranking de crescimento, Reward Rescue, validação da configuração e um relatório de integridade.
  • Discord. Cartões instantâneos, relatórios diários e semanais e uma mensagem de estatísticas ao vivo, cada um direcionável para o próprio canal.
  • Presets e temas. Sete presets iniciais e três temas visuais, aplicados somente com confirmação e backup.
  • Idiomas. Inglês, turco, espanhol, alemão e português do Brasil.

Redes #

Em uma rede, defina settings.join-tracking-enabled como true em um servidor de entrada (por exemplo o lobby) e como false nos demais, e aponte todos os servidores para o mesmo banco de dados MySQL/MariaDB. Defina settings.reward-delivery-enabled como true apenas no servidor onde está a sua economia real. As recompensas resgatadas em outros lugares ficam armazenadas como pendentes e são entregues no próximo login lá. Cada linha de recompensa tem um único dono de entrega ativo entre os servidores.

Atrás de um BungeeCord ou Velocity, ative o encaminhamento de IP no proxy. Sem ele, todo jogador aparece com o endereço do proxy e as verificações por IP bloqueariam todo mundo. O SQLite não é um armazenamento compartilhado; uma rede precisa de MySQL/MariaDB.

Atualização #

O ReferralTrack nunca substitui em silêncio um config.yml personalizado. Quando a versão da configuração muda, ele mantém o original como config.yml.bak-v<old>, grava a nova referência completa em config.new-v<new>.yml, altera apenas o marcador de versão no seu arquivo e lista os caminhos ausentes na inicialização. Os padrões incluídos mantêm as novas opções funcionando até que você as copie. Os arquivos de idioma que você editou não são sobrescritos; as chaves ausentes recorrem ao texto em inglês incluído.