Configuração

Todas as configurações ficam em plugins/ReferralTrack/config.yml, com comentários. Aplique as alterações com /referraltrack reload; uma mudança nas configurações do banco de dados exige reinicialização e a recarga avisa quando for o caso. Não edite config-version. Execute /referraltrack validate depois de edições maiores. A referência de configuração descreve os sistemas mais novos (campanhas, fraude, menus, temas, retornos).

Idioma #

language aceita en, tr, es, de e pt_br. Os arquivos ficam em plugins/ReferralTrack/lang; copie um para adicionar o seu próprio idioma. text-formatting liga ou desliga de forma independente o MiniMessage e os códigos de cor com &.

Banco de dados #

yaml

database:
  type: SQLITE # or MYSQL
  sqlite:
    file: "data.db"
  mysql:
    host: "localhost"
    port: 3306
    database: "referraltrack"
    username: "root"
    password: ""
    parameters: "?useSSL=false&autoReconnect=true&characterEncoding=utf8&serverTimezone=UTC"

Servidores MySQL 8 sem SSL podem precisar de &allowPublicKeyRetrieval=true em parameters. Uma seção pool define o tamanho do pool de conexões e os tempos limite. Mantenha as credenciais privadas.

Regras de indicação #

Chave	Padrão	Significado
`referral.allow-overwrite`	`false`	Se um jogador pode substituir a indicação que já informou.
`referral.max-code-length`	`32`	Os códigos usam letras, dígitos, `.`, `_` e `-`. `friend-invite` e `no-source` são reservados.
`referral.max-custom-sources`	`200`	Quantas origens livres diferentes são aceitas. `0` é ilimitado.
`referral.command-cooldown-seconds`	`3`	Pausa entre duas tentativas de `/referral`. `0` a desativa.
`referral.claim-window-hours`	`0`	`/referral` só funciona por este tempo após a primeira entrada. `0` não tem limite.
`referral.restrict-to-known-sources`	`false`	`true` aceita apenas os códigos de `known-sources`. `false` aceita qualquer código e o normaliza.
`referral.known-sources`	youtube, tiktok, minecraft-server-list	Código para nome de exibição. Adicione uma linha para cada canal ou criador.
`referral.fuzzy-match-max-distance`	`2`	Tolerância a erros de digitação para códigos conhecidos. `0` a desativa.
`referral.ignore-private-addresses`	`true`	Endereços locais e privados são ignorados pelas verificações de contas alternativas.
`referral.personal-codes.enabled`	`true`	Cada jogador recebe um código de convite permanente.
`referral.personal-codes.prefix`	`RT-`	Prefixo dos códigos gerados.
`referral.personal-codes.random-length`	`7`	Comprimento da parte aleatória.
`referral.personal-codes.leaderboard-size`	`10`	Jogadores mostrados por `/referral top`.
`referral.personal-codes.leaderboard-period-days`	`30`	Período do ranking. `0` significa todo o tempo.
`referral.validation.enabled`	`false`	Retém as recompensas e o crédito do ranking até que o novo jogador atinja os dois limites abaixo. As indicações existentes continuam validadas; apenas os novos resgates ficam retidos.
`referral.validation.required-playtime-minutes`	`30`	Tempo de jogo após o resgate.
`referral.validation.required-joins`	`2`	Número de entradas.
`referral.validation.check-interval-seconds`	`30`	Com que frequência as indicações pendentes são verificadas.
`referral.retention.active-window-days`	`3`	Dias após a indicação antes de um jogador que volta contar como retido.

Recompensas #

yaml

referral:
  rewards:
    enabled: true
    money: 100.0
    commands:
      - "give %player% diamond 2"
    max-claims-per-ip: 3
  friend-invite:
    enabled: true
    reward-money: 100.0
    max-rewards-per-player: 10
    block-same-ip: true
    milestones:
      5:
        money: 250.0
        commands:
          - "give %player% diamond 5"

O dinheiro só é pago se o Vault estiver instalado. Os comandos são executados pelo console; %player% é o nome do jogador.
max-claims-per-ip impede que uma conta nova faça um resgate quando essa quantidade de recompensas de boas-vindas já foi para o mesmo IP. Aumente-o se vários jogadores reais compartilharem a rede. 0 é ilimitado.
Os milestones são indexados pelo número de amigos convidados e cada um é pago uma única vez por jogador.
Os valores mostrados são os exemplos incluídos; defina recompensas adequadas ao seu servidor.

Discord #

yaml

discord:
  enabled: true
  webhook-url: ""
  server-name: "Your Server"

Os recursos do Discord ficam desativados até você colar uma URL de webhook. As notificações instantâneas, o relatório diário (padrão 00:00), o relatório semanal (padrão segunda-feira 00:05) e a mensagem de estatísticas ao vivo (desativada por padrão) podem ser ligados ou desligados individualmente. A seção webhooks direciona cartões, relatórios e o painel ao vivo para canais separados, e branding e embed mudam a aparência. /referraltrack discord preview <type> mostra cada design sem dados de teste.

Configurações gerais #

Chave	Padrão	Significado
`settings.join-tracking-enabled`	`true`	`false` impede que este servidor registre novos jogadores. Veja Redes na página de visão geral.
`settings.reward-delivery-enabled`	`true`	`false` guarda as recompensas como pendentes em vez de entregá-las aqui.
`settings.ignored-players`	vazio	Nomes excluídos de todas as estatísticas. A permissão `referraltrack.ignore` faz o mesmo.
`settings.data-retention.ip-hash-days`	`90`	Os hashes de IP armazenados de jogadores ausentes por esse tempo são excluídos. `0` os mantém para sempre.
`settings.data-retention.delivered-rewards-days`	`0`	As linhas de recompensas entregues mais antigas que isso são excluídas. Isso também zera os limites por IP e por amigo, que são contados a partir delas.
`settings.seed-known-players`	`true`	Na primeira inicialização, importa os jogadores que o servidor já conhece para que `/referral <friend>` funcione com eles.

Verificação de atualizações #

integrations.update-checker não faz nada até que resource-id seja definido com um número de recurso real.