Configuration

Tous les réglages se trouvent dans plugins/ReferralTrack/config.yml, avec des commentaires. Appliquez les changements avec /referraltrack reload ; une modification des réglages de la base de données nécessite un redémarrage et le rechargement vous l'indique. Ne modifiez pas config-version. Exécutez /referraltrack validate après des modifications importantes. La référence de configuration décrit les systèmes plus récents (campagnes, fraude, menus, thèmes, retours).

Langue #

language accepte en, tr, es, de et pt_br. Les fichiers se trouvent dans plugins/ReferralTrack/lang ; copiez-en un pour ajouter votre propre langue. text-formatting active ou désactive indépendamment MiniMessage et les codes de couleur &.

Base de données #

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"

Les serveurs MySQL 8 sans SSL peuvent nécessiter &allowPublicKeyRetrieval=true dans parameters. Une section pool définit la taille du pool de connexions et les délais d'expiration. Gardez les identifiants privés.

Règles de parrainage #

Clé	Par défaut	Signification
`referral.allow-overwrite`	`false`	Indique si un joueur peut remplacer le parrainage qu'il a déjà indiqué.
`referral.max-code-length`	`32`	Les codes utilisent des lettres, des chiffres, `.`, `_` et `-`. `friend-invite` et `no-source` sont réservés.
`referral.max-custom-sources`	`200`	Nombre de sources libres différentes acceptées. `0` signifie illimité.
`referral.command-cooldown-seconds`	`3`	Pause entre deux tentatives de `/referral`. `0` la désactive.
`referral.claim-window-hours`	`0`	`/referral` ne fonctionne que pendant cette durée après la première connexion. `0` n'impose aucune limite.
`referral.restrict-to-known-sources`	`false`	`true` n'accepte que les codes de `known-sources`. `false` accepte n'importe quel code et le normalise.
`referral.known-sources`	youtube, tiktok, minecraft-server-list	Code vers nom affiché. Ajoutez une ligne pour chaque canal ou créateur.
`referral.fuzzy-match-max-distance`	`2`	Tolérance aux fautes de frappe pour les codes connus. `0` la désactive.
`referral.ignore-private-addresses`	`true`	Les adresses locales et privées sont ignorées par les contrôles de comptes alternatifs.
`referral.personal-codes.enabled`	`true`	Chaque joueur reçoit un code d'invitation permanent.
`referral.personal-codes.prefix`	`RT-`	Préfixe des codes générés.
`referral.personal-codes.random-length`	`7`	Longueur de la partie aléatoire.
`referral.personal-codes.leaderboard-size`	`10`	Nombre de joueurs affichés par `/referral top`.
`referral.personal-codes.leaderboard-period-days`	`30`	Période du classement. `0` signifie depuis toujours.
`referral.validation.enabled`	`false`	Retient les récompenses et le crédit du classement jusqu'à ce que le nouveau joueur atteigne les deux seuils ci-dessous. Les parrainages existants restent validés ; seules les nouvelles réclamations sont retenues.
`referral.validation.required-playtime-minutes`	`30`	Temps de jeu après la réclamation.
`referral.validation.required-joins`	`2`	Nombre de connexions.
`referral.validation.check-interval-seconds`	`30`	Fréquence de contrôle des parrainages en attente.
`referral.retention.active-window-days`	`3`	Jours après le parrainage avant qu'un joueur qui revient soit considéré comme fidélisé.

Récompenses #

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"

L'argent n'est versé que si Vault est installé. Les commandes s'exécutent depuis la console ; %player% est le nom du joueur.
max-claims-per-ip empêche un nouveau compte de réclamer lorsque ce nombre de récompenses de bienvenue a déjà été attribué à la même IP. Augmentez-le si plusieurs vrais joueurs partagent un réseau. 0 signifie illimité.
Les milestones sont indexés par le nombre d'amis invités et chacun n'est versé qu'une fois par joueur.
Les valeurs affichées sont les exemples livrés ; définissez des récompenses adaptées à votre serveur.

Discord #

yaml

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

Les fonctions Discord restent désactivées tant que vous n'avez pas collé une URL de webhook. Les notifications instantanées, le rapport quotidien (par défaut 00:00), le rapport hebdomadaire (par défaut lundi 00:05) et le message de statistiques en direct (désactivé par défaut) peuvent chacun être activés ou désactivés. La section webhooks oriente les cartes, les rapports et le panneau en direct vers des canaux distincts, et branding et embed modifient l'apparence. /referraltrack discord preview <type> montre chaque présentation sans données de test.

Réglages généraux #

Clé	Par défaut	Signification
`settings.join-tracking-enabled`	`true`	`false` empêche ce serveur d'enregistrer les nouveaux joueurs. Voir Réseaux sur la page de présentation.
`settings.reward-delivery-enabled`	`true`	`false` stocke les récompenses comme en attente au lieu de les livrer ici.
`settings.ignored-players`	vide	Noms exclus de toutes les statistiques. La permission `referraltrack.ignore` fait de même.
`settings.data-retention.ip-hash-days`	`90`	Les empreintes d'IP stockées des joueurs absents depuis cette durée sont supprimées. `0` les conserve indéfiniment.
`settings.data-retention.delivered-rewards-days`	`0`	Les lignes de récompenses livrées plus anciennes que cette durée sont supprimées. Cela réinitialise aussi les limites par IP et par ami, qui sont comptées à partir d'elles.
`settings.seed-known-players`	`true`	Au premier démarrage, importe les joueurs que le serveur connaît déjà afin que `/referral <friend>` fonctionne pour eux.

Vérification des mises à jour #

integrations.update-checker ne fait rien tant que resource-id n'est pas défini sur un véritable numéro de ressource.