Référence de configuration

config.yml est la surface de contrôle qui appartient à l'opérateur. ReferralTrack ne remplace jamais en silence un fichier personnalisé. Lorsque la version du schéma change, le plugin conserve l'original sous le nom config.yml.bak-v<old>, écrit la nouvelle référence complète dans config.new-v<new>.yml, met à jour uniquement le marqueur de version du fichier actif et signale les chemins manquants au démarrage. Les valeurs par défaut incluses de Bukkit maintiennent les nouvelles options opérationnelles jusqu'à ce que l'opérateur les copie ou les personnalise.

L'accès administrateur utilise des nœuds de permission Bukkit granulaires et fonctionne avec LuckPerms sans OP ni dépendance obligatoire à une API. Voir Commandes et permissions ; referraltrack.admin reste le parent donnant tous les accès.

Systèmes principaux #

• database : connexion SQLite ou MySQL/MariaDB et délais bornés du pool. Gardez les identifiants privés.
• referral : politique de réclamation, sources connues, codes personnels, validation, plafonds de récompense, commandes, paliers et attribution de la rétention.
• campaigns : interrupteur du moteur, fuseau horaire et dates de campagne indépendantes, filtres, codes, multiplicateurs, récompenses et paliers. Voir Campagnes.
• fraud : interrupteur du moteur de risque, seuil de revue par le staff et signaux de compte/temps de jeu. Voir Revue anti-fraude.
• discord : routes de webhook facultatives, rapports, intervalle de mise à jour des statistiques en direct, champs d'embed de marque et URL HTTPS sûres pour les médias/boutons. Un bot Discord complet ne fait pas partie de cette version.
• integrations.developer-api : enregistrement dans le ServicesManager de Bukkit de l'API asynchrone en lecture seule. events.pre-claim et events.claim-result contrôlent indépendamment les deux événements publics de réclamation ; désactiver l'API désactive les deux. Voir API développeur.
• text-formatting : active indépendamment le formatage MiniMessage et les anciens codes avec esperluette. Les dégradés, l'arc-en-ciel, les couleurs RGB et les balises de style MiniMessage reconnus peuvent coexister avec & et &#RRGGBB ; les variables ordinaires entre chevrons restent littérales.
• player-interface : sélectionne AUTO, INVENTORY ou DIALOG. AUTO utilise l'API native de dialogues Java de Paper lorsqu'elle est présente et ouvre sinon l'inventaire autonome. Les largeurs du corps et des boutons du dialogue, les colonnes, le comportement de pause/échappement et la politique de repli sont bornés et configurables. Le texte du dialogue et les quatre libellés de boutons sont localisés sous dashboard.dialog-*. /referral inventory ouvre toujours le menu autonome.
• player-feedback.claim : titre, sous-titre, barre d'action, son et particules de la réclamation. Chaque canal a son propre interrupteur ; les durées du titre, le volume/la hauteur du son et le nombre/décalage/vitesse des particules sont bornés. L'animation de particules prend en charge les formes bornées BURST, RING et HELIX avec images, intervalle, rayon et hauteur configurables. Les valeurs de son, de particule ou d'animation invalides échouent en douceur avec un diagnostic émis une seule fois.
• onboarding : guidage du premier démarrage, validation automatique en lecture seule et nombre maximal de constats signalés. /referraltrack validate vérifie les bornes de la base de données et du pool, l'identité du parrainage et les contraintes de récompense, les seuils de validation et de fraude, les horaires de rapport, les nœuds réseau passifs et Discord activé mais non configuré. Il signale les chemins et les attentes sûres, jamais les valeurs secrètes configurées.
• velogrowth : interrupteur du classement de qualité, échantillon minimal, taille du classement, fenêtre d'évaluation et six pondérations relatives. Le volume brut ne détermine que l'éligibilité. La validation, la sécurité face aux rejets, la sécurité de risque et la rétention mature D1/D7/D30 contribuent au score de 0 à 100 ; les cohortes immatures sont omises et chaque donnée d'entrée est affichée par /referraltrack growth.
• campaign-guard : interrupteur du contrôle préalable à l'activation, fenêtre « se termine bientôt », avertissement sur le multiplicateur de récompense, nombre maximal de commandes, gravité de l'économie manquante et seuils d'argent configurables par réclamation et pour le total estimé. L'estimation du total utilise exposure.expected-claims. Les constats critiques bloquent l'activation de la campagne et la mise en marche du moteur ; les avertissements restent visibles sans modifier la campagne en silence.
• reward-rescue : permission du staff, taille de la liste, seuils d'ancienneté des lignes en attente/bloquées et nombre maximal de tentatives manuelles. /referraltrack rescue est en lecture seule, sauf si retry ou cancel inclut confirm et un motif imprimable. Les lignes en cours de traitement ne sont jamais retentées automatiquement, car Vault ou une commande console a peut-être déjà été exécuté avant un plantage. Voir Reward Rescue.
• settings : propriété du suivi/de la livraison pour les réseaux, identités ignorées et nettoyage de la rétention.
• menu : toutes les tailles d'inventaire livrées, emplacements, matériaux, titres, lore, capacités de page, navigation, affichage de l'heure de l'historique des récompenses et apparence de la barre de progression.

Chaque phrase visible par les joueurs/le staff se trouve dans lang/<language>.yml ; cinq langues complètes sont fournies. Les clés de traduction personnalisée manquantes se rabattent sur l'anglais inclus sans écraser le fichier de langue personnalisé.

Le texte de retour de réclamation est localisé via feedback.claim-title, feedback.claim-subtitle et feedback.claim-action-bar. Les variables prises en charge sont {player}, {source} et {status}. Les mécanismes visuels et sonores restent sous player-feedback.claim afin que les opérateurs puissent modifier la présentation sans éditer les traductions.

Règles de sécurité des menus #

Les tailles d'inventaire doivent être un multiple de 9 compris entre 9 et 54. Les emplacements commencent à zéro et doivent tenir dans l'inventaire configuré. Les champs de matériau acceptent les matériaux Bukkit ainsi que les références HEADDB:<id>, HDB:<id> et hdb-<id> à la manière de DeluxeMenus lorsque HeadDatabase est installé et chargé. Les plugins manquants, les ID inconnus et les matériaux invalides se rabattent sur un matériau intégré sûr avec un avertissement dans la console. Les valeurs numériques hors plage sont bornées et diagnostiquées. Les listes d'emplacements écartent les entrées invalides et en double ; s'il n'en reste aucune, la disposition intégrée sûre est utilisée.

menu.player-dashboard.progress contrôle l'emplacement de progression, le matériau, la longueur (1–40), les glyphes et les couleurs. reward-history-button contrôle son bouton d'accès.

menu.reward-history contrôle sa taille d'inventaire, les emplacements de contenu ordonnés, le nombre maximal de lignes (1–45), les matériaux en file/en traitement/livrée/annulée, les commandes vide/retour/fermer, le motif de date Java et le fuseau horaire. Utilisez SYSTEM pour le fuseau horaire de l'hôte ou un ID IANA tel que Europe/Istanbul.

menu.admin-dashboard et menu.admin-review contrôlent les tailles, les emplacements de page ordonnés, les matériaux d'état/de risque et chaque emplacement de navigation/commande. Leur capacité de page effective est le nombre d'emplacements de contenu valides, de sorte que la pagination reste cohérente avec les dispositions personnalisées.

Évitez d'attribuer deux actions au même emplacement : l'objet écrit en dernier sera visible, ce qui peut rendre une autre action inaccessible. Après toute modification de la disposition, exécutez /referraltrack reload, examinez les diagnostics de la console, puis ouvrez manuellement les menus joueur et staff avant la mise en production.

Préréglages et secrets #

Consultez Préréglages et thèmes avant d'appliquer /referraltrack install <preset> confirm. Les préréglages ne modifient jamais les identifiants de base de données, les jetons ni les URL de webhook. /referraltrack doctor, les exports et les interfaces n'exposent pas ces valeurs. Conservez les sauvegardes en dehors des racines web téléchargeables publiquement et limitez l'accès au système de fichiers au compte de service Minecraft.

Thèmes #

Consultez Préréglages et thèmes avant d'appliquer /referraltrack theme <theme> confirm. L'aperçu d'un thème est en lecture seule ; l'installation confirmée crée une sauvegarde exacte et ne modifie que les chemins de présentation documentés des menus/de la progression/du retour de réclamation. Elle ne modifie jamais les données de récompenses, de campagnes, de permissions, de base de données ni de secrets.