diff --git a/PlaceholderAPI.md b/PlaceholderAPI.md
new file mode 100644
index 0000000..282778c
--- /dev/null
+++ b/PlaceholderAPI.md
@@ -0,0 +1,60 @@
+# PlaceholderAPI
+
+Das Fußball-Plugin unterstützt [PlaceholderAPI](https://www.spigotmc.org/resources/placeholderapi.6245/) optional. Ist PAPI installiert, werden die Platzhalter automatisch registriert.
+
+---
+
+## Voraussetzung
+
+PlaceholderAPI muss auf dem Server installiert sein. Das Plugin erkennt es beim Start automatisch:
+
+```
+[Fussball] PlaceholderAPI-Integration aktiviert!
+```
+
+---
+
+## Verfügbare Platzhalter
+
+### Spieler-Statistiken
+
+| Platzhalter | Rückgabe | Beschreibung |
+| --- | --- | --- |
+| `%fussball_goals%` | Zahl | Erzielte Tore gesamt |
+| `%fussball_owngoals%` | Zahl | Eigentore gesamt |
+| `%fussball_assists%` | Zahl | Vorlagen gesamt |
+| `%fussball_kicks%` | Zahl | Schüsse gesamt |
+| `%fussball_wins%` | Zahl | Siege gesamt |
+| `%fussball_losses%` | Zahl | Niederlagen gesamt |
+| `%fussball_draws%` | Zahl | Unentschieden gesamt |
+| `%fussball_games%` | Zahl | Gespielte Spiele gesamt |
+| `%fussball_winrate%` | Dezimalzahl | Siegquote in % (z. B. `67.5`) |
+
+### Aktuelles Spiel
+
+| Platzhalter | Rückgabe | Beschreibung |
+| --- | --- | --- |
+| `%fussball_ingame%` | `true` / `false` | Ob der Spieler gerade im Spiel ist |
+| `%fussball_arena%` | Text / `–` | Name der aktuellen Arena |
+| `%fussball_score%` | Text / `–` | Aktueller Spielstand (z. B. `2 : 1`) |
+| `%fussball_team%` | `Rot` / `Blau` / `–` | Team des Spielers im aktuellen Spiel |
+| `%fussball_injurytime%` | Zahl | Aktuelle Nachspielzeit in Sekunden (`0` wenn keine) |
+
+---
+
+## Beispiele
+
+Scoreboard-Zeile mit aktuellem Spielstand:
+```
+%fussball_arena% → %fussball_score%
+```
+
+Tab-Liste mit Toren:
+```
+⚽ %fussball_goals% Tore | 🏆 %fussball_wins% Siege
+```
+
+Bedingte Anzeige (z. B. mit CMI oder DeluxeMenus):
+```
+%fussball_ingame% == true → Zeige Spielstand
+```