Konfigurationsreferenz

config.yml ist die Steuerungsoberfläche, die dem Betreiber gehört. ReferralTrack ersetzt eine angepasste Datei nie stillschweigend. Ändert sich die Schemaversion, bewahrt das Plugin das Original als config.yml.bak-v<old> auf, schreibt die vollständige neue Referenz nach config.new-v<new>.yml, aktualisiert nur die Versionsmarkierung in der aktiven Datei und meldet beim Start fehlende Pfade. Die mitgelieferten Standardwerte von Bukkit halten neue Optionen funktionsfähig, bis der Betreiber sie kopiert oder anpasst.

Der administrative Zugriff nutzt fein abgestufte Bukkit-Berechtigungsknoten und funktioniert mit LuckPerms ohne OP oder harte API-Abhängigkeit. Siehe Befehle und Berechtigungen; referraltrack.admin bleibt der übergeordnete Knoten mit Vollzugriff.

Hauptsysteme #

• database: SQLite- oder MySQL/MariaDB-Verbindung und begrenzte Pool-Zeiten. Halte die Zugangsdaten privat.
• referral: Anspruchsrichtlinie, bekannte Quellen, persönliche Codes, Validierung, Belohnungslimits, Befehle, Meilensteine und Bindungszuordnung.
• campaigns: Engine-Schalter, Zeitzone und unabhängige Kampagnendaten, Filter, Codes, Multiplikatoren, Belohnungen und Meilensteine. Siehe Kampagnen.
• fraud: Schalter der Risiko-Engine, Prüfschwelle für das Team und Konto-/Spielzeit-Signale. Siehe Betrugsprüfung.
• discord: optionale Webhook-Routen, Berichte, Aktualisierungsintervall der Live-Statistik, Embed-Felder mit Branding und sichere HTTPS-Medien-/Button-URLs. Ein vollständiger Discord-Bot gehört nicht zu diesem Release.
• integrations.developer-api: Registrierung im ServicesManager von Bukkit für die schreibgeschützte asynchrone API. events.pre-claim und events.claim-result steuern die beiden öffentlichen Anspruchs-Events unabhängig voneinander; das Deaktivieren der API deaktiviert beide. Siehe Entwickler-API.
• text-formatting: aktiviert MiniMessage-Formatierung und alte Ampersand-Codes unabhängig voneinander. Erkannte MiniMessage-Verläufe, Regenbogen, RGB-Farben und Stil-Tags können neben & und &#RRGGBB bestehen; gewöhnliche Platzhalter in spitzen Klammern bleiben wörtlich.
• player-interface: wählt AUTO, INVENTORY oder DIALOG. AUTO nutzt die native Java-Dialog-API von Paper, wenn vorhanden, und öffnet sonst das eigenständige Inventar. Dialog-Körper-/Button-Breiten, Spalten, Pause-/Escape-Verhalten und Ersatzrichtlinie sind begrenzt und konfigurierbar. Dialogtext und alle vier Button-Beschriftungen sind unter dashboard.dialog-* lokalisiert. /referral inventory öffnet immer das eigenständige Menü.
• player-feedback.claim: Titel, Untertitel, Action-Bar, Sound und Partikel beim Anspruch. Jeder Kanal hat einen eigenen Schalter; Titelzeiten, Soundlautstärke/-tonhöhe und Partikelanzahl/-versatz/-geschwindigkeit sind begrenzt. Die Partikelanimation unterstützt begrenzte Formen BURST, RING und HELIX mit konfigurierbaren Frames, Intervall, Radius und Höhe. Ungültige Sound-, Partikel- oder Animationswerte schlagen weich mit einer einmaligen Diagnose fehl.
• onboarding: Hinweise beim ersten Start, automatische schreibgeschützte Validierung und maximal gemeldete Befunde. /referraltrack validate prüft Datenbank-/Pool-Grenzen, Empfehlungsidentität und Belohnungsbeschränkungen, Validierungs-/Betrugsschwellen, Berichtszeitpläne, passive Netzwerkknoten und aktiviertes, aber nicht konfiguriertes Discord. Es meldet Pfade und sichere Erwartungen, nie konfigurierte geheime Werte.
• velogrowth: Schalter der Qualitätsrangliste, Mindeststichprobe, Ranglistengröße, Auswertungsfenster und sechs relative Gewichte. Das Rohvolumen bestimmt nur die Berechtigung. Validierung, Ablehnungssicherheit, Risiko- sicherheit und reife D1/D7/D30-Bindung fließen in die Punktzahl von 0–100 ein; unreife Kohorten werden ausgelassen und jede Eingabe wird von /referraltrack growth angezeigt.
• campaign-guard: Schalter der Aktivierungsprüfung, „Endet bald“-Fenster, Warnung zum Belohnungsmultiplikator, maximale Befehlsanzahl, Schweregrad bei fehlender Wirtschaft und konfigurierbare Geldschwellen pro Anspruch bzw. geschätzter Gesamtsumme. Die Gesamtschätzung nutzt exposure.expected-claims. Kritische Befunde blockieren das Aktivieren der Kampagne und das Einschalten der Engine; Warnungen bleiben sichtbar, ohne die Kampagne stillschweigend zu ändern.
• reward-rescue: Team-Berechtigung, Listengröße, Alterschwellen für ausstehend/festhängend und maximale manuelle Versuche. /referraltrack rescue ist schreibgeschützt, es sei denn, retry oder cancel enthält confirm und einen druckbaren Grund. Zeilen in Bearbeitung werden nie automatisch wiederholt, weil Vault oder ein Konsolenbefehl vor einem Absturz möglicherweise schon ausgeführt wurde. Siehe Reward Rescue.
• settings: Zuständigkeit für Tracking/Zustellung bei Netzwerken, ignorierte Identitäten und Bereinigung der Aufbewahrung.
• menu: alle ausgelieferten Inventargrößen, Slots, Materialien, Titel, Lore, Seitenkapazitäten, Navigation, Zeitanzeige im Belohnungsverlauf und Aussehen der Fortschrittsleiste.

Jeder für Spieler/Team sichtbare Satz steht in lang/<language>.yml; fünf vollständige Sprachen sind mitgeliefert. Fehlende eigene Übersetzungsschlüssel greifen auf das mitgelieferte Englisch zurück, ohne die eigene Sprachdatei zu überschreiben.

Der Rückmeldungstext beim Anspruch wird über feedback.claim-title, feedback.claim-subtitle und feedback.claim-action-bar lokalisiert. Unterstützte Platzhalter sind {player}, {source} und {status}. Visuelle und akustische Mechanik bleibt unter player-feedback.claim, damit Betreiber die Darstellung ändern können, ohne Übersetzungen zu bearbeiten.

Sicherheitsregeln für Menüs #

Inventargrößen müssen ein Vielfaches von 9 zwischen 9 und 54 sein. Slots beginnen bei null und müssen in das konfigurierte Inventar passen. Materialfelder akzeptieren Bukkit-Materialien sowie die Verweise HEADDB:<id>, HDB:<id> und hdb-<id> im Stil von DeluxeMenus, wenn HeadDatabase installiert und geladen ist. Fehlende Plugins, unbekannte IDs und ungültige Materialien fallen mit einer Konsolenwarnung auf ein sicheres eingebautes Material zurück. Zahlenwerte außerhalb des Bereichs werden begrenzt und diagnostiziert. Slotlisten verwerfen ungültige und doppelte Einträge; bleibt keiner übrig, wird das sichere eingebaute Layout verwendet.

menu.player-dashboard.progress steuert den Fortschritts-Slot, das Material, die Länge (1–40), die Zeichen und die Farben. reward-history-button steuert den zugehörigen Einstiegs-Button.

menu.reward-history steuert die Inventargröße, die geordneten Inhalts-Slots, die maximalen Zeilen (1–45), die Materialien für in der Warteschlange/in Bearbeitung/zugestellt/abgebrochen, die Steuerelemente leer/zurück/schließen, das Java-Datumsmuster und die Zeitzone. Verwende SYSTEM für die Zeitzone des Hosts oder eine IANA-ID wie Europe/Istanbul.

menu.admin-dashboard und menu.admin-review steuern Größen, geordnete Seiten-Slots, Status-/Risiko-Materialien und jeden Navigations-/Steuer-Slot. Ihre effektive Seitenkapazität ist die Anzahl der gültigen Inhalts-Slots, sodass die Seitenaufteilung mit eigenen Layouts konsistent bleibt.

Weise nicht zwei Aktionen demselben Slot zu: Der zuletzt geschriebene Gegenstand ist sichtbar, und dadurch kann eine andere Aktion unerreichbar werden. Führe nach jeder Layout-Änderung /referraltrack reload aus, prüfe die Konsolen-Diagnosen und öffne die Spieler- und Team-Menüs manuell, bevor du in Produktion gehst.

Presets und Geheimnisse #

Siehe Presets und Themes, bevor du /referraltrack install <preset> confirm anwendest. Presets ändern nie Datenbank-Zugangsdaten, Token oder Webhook-URLs. /referraltrack doctor, Exporte und Oberflächen legen diese Werte nicht offen. Bewahre Backups außerhalb öffentlich herunterladbarer Web-Wurzelverzeichnisse auf und beschränke den Dateisystemzugriff auf das Minecraft-Dienstkonto.

Themes #

Siehe Presets und Themes, bevor du /referraltrack theme <theme> confirm anwendest. Die Theme-Vorschau ist schreibgeschützt; die bestätigte Installation erstellt ein exaktes Backup und ändert nur die dokumentierten Darstellungspfade für Menüs/Fortschritt/Anspruchs- Rückmeldung. Sie ändert nie Belohnungs-, Kampagnen-, Berechtigungs-, Datenbank- oder Geheimdaten.