Upload file README.md via GUI

This commit is contained in:
2026-03-17 16:15:13 +01:00
parent 885fd9792d
commit 54414cbc2e

View File

@@ -49,8 +49,8 @@ Ein professionelles Fußball-Plugin für Spigot/Paper 1.21+ mit echtem Ball-Phys
| 🏟 Strafraum | Auto-berechnet aus Tor-Koordinaten oder manuell setzbar |
| 📋 Matchbericht | Tore, Karten, Fouls, Abseits, Ballbesitz und MVP am Spielende |
| 🏆 MVP-System | Bester Torschütze wird nach dem Spiel bekannt gegeben |
| 📈 Persistente Stats | Tore, Eigentore, Vorlagen, Schüsse, Siege, Niederlagen, Siegquote |
| 🪄 Hologramme | Platzierbare Ingame-Hologramme für Top-Tore, Top-Siege und Live-Matchstand |
| 📈 Persistente Stats | Tore, Eigentore, Vorlagen, Schüsse, Siege, Niederlagen, Siegquote; per Admin-Befehl resetbar |
| 🪄 Hologramme | Platzierbare Ingame-Hologramme für Top-Tore, Top-Siege und Live-Matchstand; Texte ingame bearbeitbar, Standard-Farben über `config.yml` anpassbar |
| 📋 Match-History | Letzte 50 Spiele dauerhaft gespeichert, abrufbar per `/fb history` |
| 🔢 Warteschlange | Automatische Queue wenn Arena voll; nächster Spieler rückt nach |
| 👀 Zuschauer-Modus | Sichtbarer Zuschauer-Bereich außerhalb des Feldes mit BossBar und Scoreboard |
@@ -166,11 +166,15 @@ Alle Pflichtfelder müssen **§a✔** zeigen. Erst dann ist die Arena spielberei
| `/fb setgk <arena> <spieler>` | Torwart eines laufenden Spiels manuell neu zuweisen |
| `/fb dropball <arena>` | Schiedsrichterball Ball neutral spawnen, beide Teams dürfen spielen |
| `/fb debug <arena>` | Tor-/Feld-Regionen, Ball-Position und Aus-Seite debuggen |
| `/fb stats reset <spieler\|all>` | Einzelne Spieler-Stats oder alle Statistiken zurücksetzen |
| `/fb hologram set <arena> goals\|wins\|match` | Hologramm für eine Arena an deiner aktuellen Position erstellen |
| `/fb hologram remove` | Nächstes Hologramm im 5-Block-Radius entfernen |
| `/fb hologram delete <arena> goals\|wins\|match` | Hologramm einer Arena gezielt löschen |
| `/fb hologram text <arena> goals\|wins\|match <zeile> <text>` | Einzelne Hologramm-Zeilen bearbeiten |
| `/fb hologram textpreview <arena> goals\|wins\|match` | Aktuell gespeicherte Hologramm-Zeilen anzeigen |
| `/fb hologram textreset <arena> goals\|wins\|match` | Standard-Text eines Hologramms wiederherstellen |
| `/fb hologram list` | Alle Hologramme als `arena → typ` anzeigen |
| `/fb hologram reload` | Alle Hologramme aus `holograms.yml` neu laden |
| `/fb hologram reload` | Hologramme sowie Hologramm-Farben aus `holograms.yml`/`config.yml` neu laden |
Alle Commands unterstützen **Tab-Completion** für Arena-Namen und Optionen.
@@ -201,6 +205,9 @@ Weitere Verwaltung:
```
/fb hologram remove
/fb hologram delete <arena> goals|wins|match
/fb hologram text <arena> goals|wins|match <zeile> <text>
/fb hologram textpreview <arena> goals|wins|match
/fb hologram textreset <arena> goals|wins|match
/fb hologram list
/fb hologram reload
```
@@ -209,6 +216,40 @@ Weitere Verwaltung:
- `<arena>` ist der Arena-Name, nicht die Hologramm-ID.
- `match` zeigt bewusst nur Spielstand + Zeit und aktualisiert sich automatisch bei Toren, Zeitlauf und Nachspielzeit.
- `goals`/`wins` lassen sich per Rechtsklick direkt am Hologramm umschalten.
- Farben und Formatierungen für einzelne Zeilen kannst du über `&`-Codes im `text`-Befehl setzen, z. B. `&6&lTitel`, `&cRot`, `&oKursiv`.
- Standard-Farbschema (Titel, Werte, Trennlinie, Match-Header usw.) stellst du zentral in `config.yml` unter `holograms:` ein und übernimmst es mit `/fb hologram reload`.
- `text` bearbeitet immer genau eine Zeile. Fehlende Zeilen werden bei Bedarf automatisch ergänzt.
- Mit `textreset` wird nur das gewählte Hologramm auf den Standardtext zurückgesetzt.
### Hologramm-Platzhalter
Für `goals` und `wins` stehen in bearbeitbaren Texten diese Platzhalter zur Verfügung:
```
{title} → Standard-Überschrift des Hologramms
{separator} → Trennlinie
{entries} → Dynamische Top-10-Liste
{toggle} → Hinweis zum Umschalten per Rechtsklick
```
Für `match` stehen diese Platzhalter zur Verfügung:
```
{header} → Live-Match Überschrift
{separator} → Trennlinie
{phase} → Aktuelle Spielphase
{score} → Aktueller Spielstand
{time} → Spielzeit oder Nachspielzeit
```
Beispiel:
```
/fb hologram text allianz goals 1 &6&l⚽ Allianz Topscorer
/fb hologram text allianz goals 2 &8{separator}
/fb hologram text allianz goals 3 {entries}
/fb hologram text allianz goals 4 &7{toggle}
```
---
@@ -435,6 +476,8 @@ Das Schild wird automatisch formatiert und mit Live-Status aktualisiert:
```
/fb stats → Eigene Statistiken
/fb stats Notch → Statistiken von "Notch"
/fb stats reset Notch → Statistiken von "Notch" zurücksetzen (Admin)
/fb stats reset all → Alle Statistiken zurücksetzen (Admin)
/fb top goals → Top 10 Torschützen
/fb top wins → Top 10 nach Siegen (inkl. Siegquote)
/fb top kicks → Top 10 nach Anzahl Schüssen
@@ -455,7 +498,7 @@ Das Schild wird automatisch formatiert und mit Live-Status aktualisiert:
| 📊 Gespielte Spiele | Gesamtanzahl Spiele |
| 📈 Siegquote | Siege / Spiele × 100 % |
Alle Daten werden in `plugins/Fussball/stats.yml` dauerhaft gespeichert.
Alle Daten werden in `plugins/Fussball/stats.yml` dauerhaft gespeichert und können über `/fb stats reset <spieler|all>` gezielt zurückgesetzt werden.
---
@@ -486,7 +529,7 @@ Wenn PlaceholderAPI installiert ist, sind folgende Platzhalter verfügbar:
| Permission | Beschreibung | Standard |
|---|---|---|
| `fussball.admin` | Alle Admin-Commands (create, delete, setup, stop, setgk, dropball, debug, Schilder, Global-Chat) | OP |
| `fussball.admin` | Alle Admin-Commands inklusive Stats-Reset, Hologramm-Verwaltung, Schilder und Global-Chat | OP |
| `fussball.play` | Spielen, Zuschauen, Stats anzeigen | Alle |
---
@@ -537,6 +580,21 @@ gameplay:
atmosphere:
enabled: true
goal-fireworks: 5 # Feuerwerke pro Tor (0 = deaktiviert)
holograms:
goals-title-color: "&6&l" # Titel-Farbe Top-Tore
goals-value-color: "&4" # Werte-Farbe Tore
wins-title-color: "&2&l" # Titel-Farbe Top-Siege
wins-value-color: "&2" # Werte-Farbe Siege
name-color: "&0" # Spielername-Farbe
label-color: "&8" # Labels (Tore/Siege/Trenner)
separator-color: "&8&m" # Trennlinien-Stil
toggle-color: "&8&o" # Umschalt-Hinweis
match-header-color: "&e&l" # Match-Header
match-score-red: "&c&l" # Score Rot
match-score-blue: "&9&l" # Score Blau
match-time-color: "&e" # Normale Spielzeit
match-injury-color: "&c" # Nachspielzeit
```
Alle `messages`-Einträge sind ebenfalls vollständig anpassbar. Platzhalter: `{player}`, `{team}`, `{score}`, `{time}`, `{reason}`, `{n}`, `{max}`.
@@ -552,7 +610,7 @@ plugins/Fussball/
├── signs.yml → Gespeicherte Join-/Zuschauer-Schilder (auto-generiert)
├── stats.yml → Spieler-Statistiken (auto-generiert)
├── matchhistory.yml → Letzte 50 Spiele (auto-generiert)
└── holograms.yml → Statistik-Hologramme (auto-generiert)
└── holograms.yml → Statistik-Hologramme inkl. benutzerdefinierter Texte (auto-generiert)
```
---