Konfiguration

Alle Einstellungen stehen kommentiert in plugins/ReferralTrack/config.yml. Übernimm Änderungen mit /referraltrack reload; eine Änderung der Datenbankeinstellungen erfordert einen Neustart, und der Reload sagt dir das. Bearbeite config-version nicht. Führe nach größeren Änderungen /referraltrack validate aus. Die Konfigurationsreferenz beschreibt die neueren Systeme (Kampagnen, Betrug, Menüs, Themes, Rückmeldungen).

Sprache #

language akzeptiert en, tr, es, de und pt_br. Die Dateien liegen in plugins/ReferralTrack/lang; kopiere eine, um eine eigene Sprache hinzuzufügen. text-formatting schaltet MiniMessage und &-Farbcodes unabhängig voneinander ein oder aus.

Datenbank #

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"

MySQL-8-Server ohne SSL benötigen eventuell &allowPublicKeyRetrieval=true in parameters. Ein Abschnitt pool legt Größe und Zeitlimits des Verbindungspools fest. Halte die Zugangsdaten privat.

Empfehlungsregeln #

Schlüssel	Standard	Bedeutung
`referral.allow-overwrite`	`false`	Ob ein Spieler die bereits angegebene Empfehlung ersetzen kann.
`referral.max-code-length`	`32`	Codes bestehen aus Buchstaben, Ziffern, `.`, `_` und `-`. `friend-invite` und `no-source` sind reserviert.
`referral.max-custom-sources`	`200`	Wie viele verschiedene frei formulierte Quellen akzeptiert werden. `0` ist unbegrenzt.
`referral.command-cooldown-seconds`	`3`	Pause zwischen zwei `/referral`-Versuchen. `0` deaktiviert sie.
`referral.claim-window-hours`	`0`	`/referral` funktioniert nur so lange nach dem ersten Beitritt. `0` hat kein Limit.
`referral.restrict-to-known-sources`	`false`	`true` akzeptiert nur die Codes aus `known-sources`. `false` akzeptiert jeden Code und bereinigt ihn.
`referral.known-sources`	youtube, tiktok, minecraft-server-list	Code zu Anzeigename. Füge für jeden Kanal oder Creator eine Zeile hinzu.
`referral.fuzzy-match-max-distance`	`2`	Tippfehlertoleranz für bekannte Codes. `0` schaltet sie aus.
`referral.ignore-private-addresses`	`true`	Lokale und private Adressen werden bei den Prüfungen auf Zweitkonten ignoriert.
`referral.personal-codes.enabled`	`true`	Jeder Spieler erhält einen dauerhaften Einladungscode.
`referral.personal-codes.prefix`	`RT-`	Präfix der erzeugten Codes.
`referral.personal-codes.random-length`	`7`	Länge des Zufallsteils.
`referral.personal-codes.leaderboard-size`	`10`	Von `/referral top` angezeigte Spieler.
`referral.personal-codes.leaderboard-period-days`	`30`	Ranglistenzeitraum. `0` bedeutet gesamte Zeit.
`referral.validation.enabled`	`false`	Hält Belohnungen und Ranglistengutschrift zurück, bis der neue Spieler beide folgenden Schwellen erreicht. Bestehende Empfehlungen bleiben validiert; nur neue Ansprüche werden zurückgehalten.
`referral.validation.required-playtime-minutes`	`30`	Spielzeit nach dem Anspruch.
`referral.validation.required-joins`	`2`	Anzahl der Beitritte.
`referral.validation.check-interval-seconds`	`30`	Wie oft ausstehende Empfehlungen geprüft werden.
`referral.retention.active-window-days`	`3`	Tage nach der Empfehlung, bevor ein zurückkehrender Spieler als gebunden zählt.

Belohnungen #

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"

Geld wird nur gezahlt, wenn Vault installiert ist. Befehle laufen über die Konsole; %player% ist der Spielername.
max-claims-per-ip verhindert, dass ein neues Konto einen Anspruch erhebt, wenn bereits so viele Willkommensbelohnungen an dieselbe IP gingen. Erhöhe den Wert, wenn mehrere echte Spieler ein Netzwerk teilen. 0 ist unbegrenzt.
milestones sind nach der Anzahl eingeladener Freunde indiziert, und jeder wird pro Spieler nur einmal ausgezahlt.
Die gezeigten Werte sind die ausgelieferten Beispiele; lege Belohnungen fest, die zu deinem Server passen.

Discord #

yaml

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

Discord-Funktionen bleiben aus, bis du eine Webhook-URL einfügst. Sofortbenachrichtigungen, der Tagesbericht (Standard 00:00), der Wochenbericht (Standard Montag 00:05) und die Live-Statistiknachricht (standardmäßig aus) lassen sich jeweils ein- oder ausschalten. Der Abschnitt webhooks leitet Karten, Berichte und das Live-Panel in getrennte Kanäle, und branding und embed ändern das Aussehen. /referraltrack discord preview <type> zeigt jedes Design ohne Testdaten.

Allgemeine Einstellungen #

Schlüssel	Standard	Bedeutung
`settings.join-tracking-enabled`	`true`	`false` verhindert, dass dieser Server neue Spieler erfasst. Siehe Netzwerke auf der Überblicksseite.
`settings.reward-delivery-enabled`	`true`	`false` speichert Belohnungen als ausstehend, statt sie hier zuzustellen.
`settings.ignored-players`	leer	Namen, die von allen Statistiken ausgeschlossen sind. Die Berechtigung `referraltrack.ignore` bewirkt dasselbe.
`settings.data-retention.ip-hash-days`	`90`	Gespeicherte IP-Hashes von Spielern, die so lange abwesend sind, werden gelöscht. `0` behält sie für immer.
`settings.data-retention.delivered-rewards-days`	`0`	Zugestellte Belohnungszeilen, die älter sind, werden gelöscht. Das setzt auch die Limits pro IP und pro Freund zurück, die anhand dieser Zeilen gezählt werden.
`settings.seed-known-players`	`true`	Importiert beim ersten Start die dem Server bereits bekannten Spieler, damit `/referral <friend>` für sie funktioniert.

Update-Prüfung #

integrations.update-checker tut nichts, bevor resource-id auf eine echte Ressourcennummer gesetzt ist.