Presets e temas
Presets #
O ReferralTrack inclui sete perfis iniciais conservadores:
survivallifestealnetworkdiscord-boosterseason-launchcreator-codetebex
Execute /referraltrack install <preset> para pré-visualizar todos os valores que seriam alterados. O modo de pré-visualização é somente leitura. Aplique o perfil apenas com /referraltrack install <preset> confirm.
Antes de uma instalação aprovada, o ReferralTrack grava uma cópia exata do config.yml atual em plugins/ReferralTrack/backups/config-preset-<preset>-<UTC timestamp>.yml. A substituição é gravada por meio de um arquivo temporário e usa uma movimentação atômica quando o sistema operacional oferece suporte. As configurações do banco de dados, as credenciais, os tokens e as URLs de webhook nunca fazem parte de um preset.
Cada perfil ativa os códigos pessoais, a validação adiada e a revisão de fraude e depois escolhe padrões conservadores de tempo de jogo, número de entradas, teto de IP, limite de revisão e recompensa econômica. Ele também adiciona uma origem de atribuição nomeada. Os operadores devem pré-visualizar os valores e ajustá-los à própria economia antes de ativar uma campanha de produção.
Limites das integrações #
O perfil discord-booster é um perfil de atribuição com tema do Discord. Ele não instala um bot do Discord, não cria convites, não concede cargos e não modifica as credenciais do webhook. O transporte por webhook opcional do ReferralTrack continua sendo configurado separadamente pelo operador.
O perfil tebex é um perfil de atribuição de loja. Ele não se conecta à API da Tebex, não consome webhooks da Tebex nem cria cupons. O preset não declara nenhuma integração externa com loja.
O perfil network não transforma o SQLite em armazenamento compartilhado. Uma implantação em rede deve configurar e verificar separadamente o MariaDB/MySQL, o roteamento do proxy e o comportamento entre servidores.
Recuperação #
Para desfazer uma instalação, pare o servidor, preserve o arquivo atual para diagnóstico, copie o backup exato correspondente por cima de config.yml, inicie o servidor e execute /referraltrack doctor. Não restaure apenas um trecho do YAML, porque isso pode combinar configurações incompatíveis de dois perfis.
Temas #
O ReferralTrack inclui três temas de interface independentes:
velor: identidade de produto magenta/ciano e retorno padrão equilibrado.emerald: estilo verde-escuro voltado ao crescimento, com efeitos mais discretos.royal: estilo competitivo azul/dourado com retorno de desafio.
Execute /referraltrack theme para listá-los. /referraltrack theme <name> é uma pré-visualização somente leitura e mostra todos os caminhos de configuração afetados. Aplique apenas com /referraltrack theme <name> confirm.
Uma instalação confirmada grava uma cópia exata com carimbo de data e hora em plugins/ReferralTrack/backups/, aplica o tema por meio de um arquivo temporário e recarrega a configuração ao vivo. Os temas alteram apenas a apresentação visual e sonora: títulos de menus, materiais de preenchimento, estilo de progresso, materiais de progresso/histórico e som/partículas do resgate. Eles nunca alteram recompensas, campanhas, valores do banco de dados, credenciais, URLs de webhook, permissões nem dados de indicações armazenados.
Os temas são configuração comum depois de instalados. Os operadores podem personalizar cada caminho afetado; não há bloqueio em tempo de execução. Pré-visualize outro tema antes de substituir essas personalizações.