Configuración

Todos los ajustes están en plugins/ReferralTrack/config.yml, con comentarios. Aplica los cambios con /referraltrack reload; un cambio en los ajustes de la base de datos necesita un reinicio y la recarga te lo indica. No edites config-version. Ejecuta /referraltrack validate después de ediciones grandes. La referencia de configuración describe los sistemas más recientes (campañas, fraude, menús, temas, reacciones).

Idioma #

language acepta en, tr, es, de y pt_br. Los archivos están en plugins/ReferralTrack/lang; copia uno para añadir tu propio idioma. text-formatting activa o desactiva MiniMessage y los códigos de color con & de forma independiente.

Base de datos #

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"

Los servidores MySQL 8 sin SSL pueden necesitar &allowPublicKeyRetrieval=true en parameters. Una sección pool define el tamaño del pool de conexiones y los tiempos de espera. Mantén las credenciales en privado.

Reglas de referidos #

Clave	Valor por defecto	Significado
`referral.allow-overwrite`	`false`	Si un jugador puede reemplazar el referido que ya indicó.
`referral.max-code-length`	`32`	Los códigos usan letras, dígitos, `.`, `_` y `-`. `friend-invite` y `no-source` están reservados.
`referral.max-custom-sources`	`200`	Cuántos orígenes distintos de texto libre se aceptan. `0` es ilimitado.
`referral.command-cooldown-seconds`	`3`	Pausa entre dos intentos de `/referral`. `0` la desactiva.
`referral.claim-window-hours`	`0`	`/referral` solo funciona durante este tiempo tras la primera conexión. `0` no tiene límite.
`referral.restrict-to-known-sources`	`false`	`true` acepta solo los códigos de `known-sources`. `false` acepta cualquier código y lo normaliza.
`referral.known-sources`	youtube, tiktok, minecraft-server-list	Código a nombre visible. Añade una línea por cada canal o creador.
`referral.fuzzy-match-max-distance`	`2`	Tolerancia a erratas para códigos conocidos. `0` la desactiva.
`referral.ignore-private-addresses`	`true`	Las direcciones locales y privadas se ignoran en las comprobaciones de cuentas alternativas.
`referral.personal-codes.enabled`	`true`	Cada jugador recibe un código de invitación permanente.
`referral.personal-codes.prefix`	`RT-`	Prefijo de los códigos generados.
`referral.personal-codes.random-length`	`7`	Longitud de la parte aleatoria.
`referral.personal-codes.leaderboard-size`	`10`	Jugadores que muestra `/referral top`.
`referral.personal-codes.leaderboard-period-days`	`30`	Periodo de la clasificación. `0` significa todo el tiempo.
`referral.validation.enabled`	`false`	Retiene las recompensas y el crédito de la clasificación hasta que el jugador nuevo alcance los dos umbrales siguientes. Los referidos existentes siguen validados; solo se retienen las reclamaciones nuevas.
`referral.validation.required-playtime-minutes`	`30`	Tiempo de juego tras la reclamación.
`referral.validation.required-joins`	`2`	Número de conexiones.
`referral.validation.check-interval-seconds`	`30`	Cada cuánto se comprueban los referidos pendientes.
`referral.retention.active-window-days`	`3`	Días tras el referido antes de que un jugador que vuelve cuente como retenido.

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"

El dinero solo se paga si Vault está instalado. Los comandos se ejecutan desde la consola; %player% es el nombre del jugador.
max-claims-per-ip impide que una cuenta nueva reclame cuando ya se han entregado esa cantidad de recompensas de bienvenida a la misma IP. Súbelo si varios jugadores reales comparten red. 0 es ilimitado.
Los milestones se identifican por el número de amigos invitados y cada uno se paga una sola vez por jugador.
Los valores mostrados son los ejemplos incluidos; define recompensas que se ajusten a tu servidor.

Discord #

yaml

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

Las funciones de Discord siguen desactivadas hasta que pegues una URL de webhook. Las notificaciones instantáneas, el informe diario (por defecto 00:00), el informe semanal (por defecto lunes 00:05) y el mensaje de estadísticas en vivo (desactivado por defecto) se pueden activar o desactivar por separado. La sección webhooks dirige las tarjetas, los informes y el panel en vivo a canales distintos, y branding y embed cambian el aspecto. /referraltrack discord preview <type> muestra cada diseño sin datos de prueba.

Ajustes generales #

Clave	Valor por defecto	Significado
`settings.join-tracking-enabled`	`true`	`false` impide que este servidor registre jugadores nuevos. Consulta Redes en la página de descripción general.
`settings.reward-delivery-enabled`	`true`	`false` guarda las recompensas como pendientes en lugar de entregarlas aquí.
`settings.ignored-players`	vacío	Nombres excluidos de todas las estadísticas. El permiso `referraltrack.ignore` hace lo mismo.
`settings.data-retention.ip-hash-days`	`90`	Se eliminan los hashes de IP guardados de los jugadores ausentes durante este tiempo. `0` los conserva para siempre.
`settings.data-retention.delivered-rewards-days`	`0`	Se eliminan las filas de recompensas entregadas más antiguas que esto. Esto también reinicia los límites por IP y por amigo, que se cuentan a partir de ellas.
`settings.seed-known-players`	`true`	En el primer arranque, importa los jugadores que el servidor ya conoce para que `/referral <friend>` funcione con ellos.

Comprobación de actualizaciones #

integrations.update-checker no hace nada hasta que resource-id se define con un número de recurso real.