MC Player History – WordPress Plugin

MC Player History ist ein WordPress-Plugin zur Anzeige von Minecraft-Spielern inklusive Prefix, Spielername und Online-/Offline-Status.
Die Daten werden live über eine externe StatusAPI aus deinem Minecraft-Netzwerk bezogen.

---

🔧 Voraussetzungen (SEHR WICHTIG)

⚠️ Ohne korrekt installierte StatusAPI funktioniert dieses Plugin NICHT.

Pflichtvoraussetzung:

• Ein BungeeCord-Server
• Das Plugin StatusAPI
• StatusAPI MUSS im BungeeCord-Ordner /plugins liegen

❗ NICHT auf Spigot / Paper / Velocity
❗ NUR im BungeeCord-Server unter /plugins

BungeeCord/
 ├─ plugins/
 │   └─ StatusAPI.jar   ← PFLICHT
 └─ config.yml

🔗 StatusAPI

Die StatusAPI stellt einen HTTP-Endpunkt bereit (z. B. http://localhost:9191),
der von diesem WordPress-Plugin regelmäßig abgefragt wird, um Spieler- und Online-Daten zu synchronisieren.

⚠️ WICHTIG:
Die StatusAPI MUSS auf dem BungeeCord-Server installiert sein und sich im Ordner
/plugins befinden, sonst funktioniert das Plugin nicht.

---

✨ Features

• Anzeige aller bekannten Spieler
• Live-Online-Status (über StatusAPI)
• Speicherung von:
  • Spielername
  • Prefix (mit Minecraft-Farbcodes)
  • Erstes & letztes Online-Datum
• Automatische Synchronisation (alle 2 Minuten)
• Manueller Sync im Admin-Bereich
• AJAX Live-Updates ohne Seitenreload
• Shortcode-Integration
• Responsives Grid-Layout

---

📦 Installation (WordPress)

1. Plugin-Dateien hochladen nach:

   wp-content/plugins/mc-player-history/
   

2. Plugin im WordPress-Admin aktivieren

3. Unter Einstellungen → MC Player History die StatusAPI URL eintragen
   Beispiel:

   http://localhost:9191
   

4. Einstellungen speichern

---

🔗 Verbindung zur StatusAPI

• Die StatusAPI läuft auf dem BungeeCord-Server
• WordPress ruft diese URL per HTTP ab
• Standard-Fallback:

  http://localhost:9191
  

❗ Stelle sicher, dass:

• der konfigurierte Port erreichbar ist
• keine Firewall den Zugriff blockiert
• die API gültige JSON-Daten zurückliefert

---

🧩 Shortcode

[mc_player_history]

Parameter

Parameter	Beschreibung	Standard
limit	Maximale Spieleranzahl	500
interval	Update-Intervall (Sekunden)	2
only_online	Nur Online-Spieler anzeigen	false

Beispiel

[mc_player_history limit="50" interval="5" only_online="true"]

🎨 Anzeige-Reihenfolge (fix)

Die Struktur ist fest definiert und kann nicht verändert werden:

Avatar
Prefix
Name
──────────
Status (unten)

🛠 Cron & Caching

• WordPress-Cron läuft alle 2 Minuten
• Live-Status wird zusätzlich 5 Sekunden gecacht
• Automatischer Fallback auf den Datenbankstatus bei API-Ausfall

---

❗ Häufige Fehler

❌ Keine Spieler sichtbar?

• StatusAPI nicht erreichbar
• StatusAPI nicht im BungeeCord/plugins/
• Falsche URL (z. B. http:// vergessen)
• Firewall blockiert den API-Port

❌ Status immer offline?

• StatusAPI liefert keine players
• BungeeCord-Server nicht gestartet
• Falscher API-Port konfiguriert