config

Konfiguration Aktualisiert: 19.03.2026

Inhalt

defaults
ball
gameplay
atmosphere
holograms
messages

config.yml

Die Hauptkonfiguration befindet sich unter plugins/Fussball/config.yml. Änderungen werden nach einem Server-Neustart oder /fb hologram reload (nur Hologramm-Farben) übernommen.

—

defaults

Standard-Werte für neue Arenen. Können pro Arena mit /fb setup überschrieben werden.

„`yaml
defaults:
min-players: 2 # Mindestspielerzahl für Auto-Start
max-players: 10 # Maximale Spielerzahl
game-duration: 300 # Halbzeit-Dauer in Sekunden (300 = 5 Min)
„`

—

ball

Physik-Parameter des Balls.

„`yaml
ball:
kick-power: 1.1 # Schussstärke (normal)
sprint-kick-power: 1.8 # Schussstärke beim Sprinten
kick-vertical: 0.3 # Vertikale Komponente eines Schusses
charged-min-power: 1.3 # Mindeststärke aufgeladener Schuss
charged-max-power: 3.8 # Maximalstärke aufgeladener Schuss (volle Ladung)
„`

—

gameplay

Spielregeln und Mechaniken.

„`yaml
gameplay:
offside-enabled: true # Abseits-Erkennung an/aus
foul-detection-enabled: true # Foul-System an/aus
freekick-distance: 5.0 # Mindestabstand Gegner beim Freistoß (Blöcke)
freekick-duration: 600 # Ticks bis Freistoß automatisch freigegeben wird

goalkeeper-hold-range: 2.5 # Max. Abstand TW→Ball zum Fangen
goalkeeper-throw-power: 1.8 # Wurfstärke des Torwarts

out-of-bounds-tolerance: 2.0 # Extra-Blöcke außerhalb Feld vor Aus-Erkennung
out-of-bounds-countdown: 5 # Sekunden bis Disqualifikation bei Feldverlassen

penalty-area-depth: 16 # Tiefe des auto-berechneten Strafraums (Blöcke Richtung Feld)
penalty-area-margin: 6 # Seitliche Ausdehnung des Strafraums jenseits der Torpfosten

header-range: 1.8 # Max. Abstand Spieler→Ball für Kopfball
header-min-height: 0.8 # Min. Ballhöhe über Spielerfüßen für Kopfball
header-max-height: 2.3 # Max. Ballhöhe über Spielerfüßen für Kopfball
header-power: 1.3 # Schussstärke eines Kopfballs
header-cooldown: 10 # Ticks Abklingzeit zwischen zwei Kopfbällen (selber Spieler)

afk-warn-seconds: 20 # Sekunden Stillstand bis AFK-Warnung
afk-kick-seconds: 40 # Sekunden Stillstand bis Rauswurf
afk-move-threshold: 0.5 # Mindestbewegung pro Sekunde (Blöcke)

injury-time-enabled: true
injury-time-per-goal: 30 # Sekunden Nachspielzeit pro Tor
injury-time-per-card: 15 # Sekunden pro Karte
injury-time-per-foul: 5 # Sekunden pro Foul
injury-time-per-out: 3 # Sekunden pro Aus-Situation

kickoff-circle-radius: 9.15 # Pflichtabstand Gegner beim Anstoß (Blöcke)
handball-enabled: true # Handspiel-Erkennung an/aus
long-pass-distance: 20.0 # Ab dieser Distanz (Blöcke) gilt ein Pass als Langpass
„`

—

atmosphere

„`yaml
atmosphere:
enabled: true
goal-fireworks: 5 # Anzahl Feuerwerke bei einem Tor (0 = deaktiviert)
„`

—

holograms

Farben der Hologramme. Verwende &-Codes. Änderungen gelten nach /fb hologram reload.

„`yaml
holograms:
goals-title-color: „&6&l“ # Titel Tore-Hologramm (Gold + Fett)
goals-value-color: „&4“ # Tor-Anzahl (Dunkelrot)
wins-title-color: „&2&l“ # Titel Siege-Hologramm (Dunkelgrün + Fett)
wins-value-color: „&2“ # Siege-Anzahl (Dunkelgrün)
name-color: „&0“ # Spielername (Schwarz)
label-color: „&8“ # Beschriftungen (Dunkelgrau)
separator-color: „&8&m“ # Trennlinie (durchgestrichen)
toggle-color: „&8&o“ # Umschalte-Hinweis (Kursiv Dunkelgrau)
match-header-color: „&e&l“ # Match-Header (Gelb + Fett)
match-score-red: „&c&l“ # Rot-Team Spielstand (Rot + Fett)
match-score-blue: „&9&l“ # Blau-Team Spielstand (Blau + Fett)
match-time-color: „&e“ # Spielzeit (Gelb)
match-injury-color: „&c“ # Nachspielzeit (Rot)
„`

—

messages

Alle Broadcast-Texte sind vollständig anpassbar. Standard-Farbcodes (§) werden unterstützt.

Verfügbare Platzhalter je nach Nachricht:

| Platzhalter | Bedeutung |
| — | — |
| {player} | Spielername |
| {team} | Teamname |
| {score} | Spielstand (z. B. 2 : 1) |
| {time} | Minute / Zeit |
| {reason} | Grund (z. B. für Karte) |
| {n} | Zahl |

Wichtige Nachrichten-Keys:

Die vollständige Liste aller Keys befindet sich direkt in der config.yml.