HyFactions Integration

HyperPerms erkennt automatisch HyFactions und aktiviert die Integration des Fraktions-Chats. Keine Konfiguration erforderlich - installiere einfach beide Plugins und sie werden zusammen funktionieren.

Tipp: Diese Integration erfolgt automatisch. Wenn beide Plugins installiert sind, werden die Fraktionsfunktionen sofort beim Serverstart aktiviert.

Funktionen

Automatischer Fraktionspräfix im Chat - Zeigt den Fraktionsnamen vor dem Gruppenpräfix des Spielers an
Optionale Ranganzeige - Zeigt den Fraktionsrang des Spielers an (Besitzer, Offizier, Mitglied)
Chat-Platzhalter - Verwenden Sie Fraktionsdaten überall in Ihrem Chat-Format
Anpassbare Formate - Volle Kontrolle über die Anzeige der Fraktionsdaten

Chat-Beispiele

Standard (mit Fraktionspräfix): [Warriors][Admin] Steve: Hello everyone!

[Warriors] - Fraktion (türkis)
[Admin] - Gruppe (rot)
Steve - Spieler (weiß)
: Hello everyone! - Nachricht (grau)

Mit Fraktionsrang: [Warriors|Owner][Admin] Steve: Hello everyone!

[Warriors|Owner] - Fraktion + Rang (cyan)
[Admin] - Gruppe (rot)
Steve - Spieler (weiß)
: Hello everyone! - Nachricht (grau)

Keine Fraktion: [Admin] Steve: Hello everyone!

[Admin] - Gruppe (rot)
Steve - Spieler (weiß)
: Hello everyone! - Nachricht (grau)

Konfiguration

Die HyFactions-Integration wird in der factions-Sektion Ihrer config.json konfiguriert:

{
  "factions": {
    "enabled": true,
    "prefixEnabled": true,
    "prefixFormat": "&7[&b%s&7] ",
    "showRank": false,
    "prefixWithRankFormat": "&7[&b%s&7|&e%r&7] ",
    "noFactionDefault": ""
  }
}

Konfigurationsoptionen

Option	Typ	Standard	Beschreibung
`enabled`	boolean	true	Aktivieren oder Deaktivieren der gesamten HyFactions-Integration
`prefixEnabled`	boolean	true	Automatisches Hinzufügen des Fraktionspräfixes zu Chatnachrichten
`prefixFormat`	string	"&7[&b%s&7] "	Format für Fraktionspräfix. `%s` = Fraktionsname
`showRank`	boolean	false	Fügt den Fraktionsrang des Spielers in das Präfix ein
`prefixWithRankFormat`	string	"&7[&b%s&7\|&e%r&7] "	Format, wenn showRank true ist. `%s` = Fraktion, `%r` = Rang
`noFactionDefault`	string	""	Text, der angezeigt wird, wenn der Spieler keine Fraktion hat (leer = nichts)

Platzhalter

Die HyFactions-Integration fügt diese Platzhalter zur Verwendung in Ihrem Chat-Format hinzu:

Platzhalter	Beschreibung	Beispielausgabe
`%faction%`	Name der Fraktion des Spielers	Warriors
`%faction_rank%`	Rang des Spielers innerhalb seiner Fraktion	Owner, Officer, Member
`%faction_tag%`	Kurzer Fraktions-Tag (typischerweise 4 Zeichen)	WARR

Verwendung von Platzhaltern im Chat-Format

Sie können diese Platzhalter in Ihrer Chat-Format-Konfiguration verwenden:

{
  "chat": {
    "format": "&7[&b%faction%&7] %prefix%%player%%suffix%&8: &f%message%"
  }
}

Info: Wenn ein Spieler keine Fraktion hat, sind die %faction%-Platzhalter leer, es sei denn, Sie setzen einen noFactionDefault-Wert.

Format Beispiele

Einfacher Faction Tag

{
  "factions": {
    "enabled": true,
    "prefixEnabled": true,
    "prefixFormat": "&8[&a%s&8] ",
    "showRank": false
  }
}

// Result: [Warriors][Admin] Steve: Hello

Faction mit Rang

{
  "factions": {
    "enabled": true,
    "prefixEnabled": true,
    "showRank": true,
    "prefixWithRankFormat": "&7[&b%s &8| &e%r&7] "
  }
}

// Result: [Warriors | Owner][Admin] Steve: Hello

Nur kurzer Tag

{
  "factions": {
    "enabled": true,
    "prefixEnabled": true,
    "prefixFormat": "&8[&6%s&8]"
  }
}

// Then use %faction_tag% in chat format for short tags
// Result: [WARR][Admin] Steve: Hello

Kein Faction-Indikator

{
  "factions": {
    "enabled": true,
    "prefixEnabled": true,
    "prefixFormat": "&7[&b%s&7] ",
    "noFactionDefault": "&7[&8No Faction&7] "
  }
}

// Players without a faction will show:
// [No Faction][Member] Alex: Hello

Erweitertes Chat-Format

Um die vollständige Kontrolle zu haben, deaktivieren Sie das automatische Präfix und verwenden Sie direkt Platzhalter:

{
  "factions": {
    "enabled": true,
    "prefixEnabled": false
  },
  "chat": {
    "format": "&7[&b%faction%&7|&e%faction_rank%&7] %prefix%%player%%suffix%&8: &f%message%"
  }
}

Warnung: Wenn Sie Platzhalter direkt mit prefixEnabled: false verwenden, werden Spieler ohne Fraktion leere Platzhalter haben. Stellen Sie sicher, dass Ihr Format dies korrekt handhabt.

Fehlersuche

Fraktionspräfix wird nicht angezeigt

Überprüfen Sie, ob HyFactions installiert und aktiviert ist
Überprüfen Sie, dass factions.enabled true ist
Prüfen Sie, ob factions.prefixEnabled true ist
Sicherstellen, dass der Spieler tatsächlich in einer Fraktion ist
Lade die Konfiguration mit /hp reload neu

Integration nicht erkannt

Stellen Sie sicher, dass HyFactions vor HyperPerms geladen wird
Konsole auf Erkennungsmeldung beim Start prüfen
Starten Sie den Server neu (nicht nur neu laden)

Platzhalter werden als wörtlicher Text angezeigt

Überprüfen Sie, ob die Integration von HyFactions aktiviert ist
Prüfen Sie die Schreibweise der Platzhalter (%faction% nicht %factions%)
Führen Sie /hp reload nach Konfigurationsänderungen aus

Siehe auch

Alle Integrationen - Übersicht der unterstützten Plugins
Konfiguration - Vollständige Konfigurationsreferenz
Platzhalter - Alle verfügbaren Platzhalter
Farbcodes - Referenz zur Formatierung

Haben Sie Fragen zur HyFactions-Integration oder haben Sie ein Problem gefunden? Senden Sie uns Feedback