RPMG v1.0.1

Changelog

All notable changes to ResourcePackEnforcer will be documented in this file.

The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

---

[1.1.0-SNAPSHOT] - 2026-06-11

⚠️ Snapshot release — not recommended for production use.

Added

• ViaVersionHook — soft dependency integration for ViaVersion; detects client protocol version at runtime
• Resource pack sending is skipped automatically for clients below Minecraft 1.7 (no pack support)
• Prompt message is skipped automatically for clients below Minecraft 1.17 (no prompt support)
• PackValidator — asynchronously validates the resource pack URL on startup via HTTP HEAD request
• fallback-url config option — secondary URL used automatically if the primary URL is unreachable
• Warning banner in console if neither primary nor fallback URL is reachable on startup
• ReconnectManager — grants players a configurable number of retries before kicking on decline
• reconnect.max-retries config option — number of attempts before kick (0 = disabled, kick immediately)
• reconnect.retry-delay config option — seconds to wait before resending the pack after a decline
• messages.retry-message — shown to the player on each failed attempt (placeholders: %retries%, %delay%)
• messages.retry-expired-message — shown when all retries are exhausted before the kick

Changed

• ResourcePackListener — kick logic now routed through ReconnectManager; direct kick only if retries are disabled or exhausted
• ResourcePackListener — PlayerQuitEvent now cleans up any pending retry tasks for the leaving player
• ResourcePackManager — now reads fallback-url from config and exposes setActiveUrl() for runtime URL switching
• ResourcePackManager — pack sending respects ViaVersion client version; prompt is omitted for unsupported clients
• ResourcePackPlugin — wires ViaVersionHook, ReconnectManager and PackValidator on startup
• ResourcePackPlugin — PackValidator result switches active URL to fallback automatically if needed

For upcoming changes see the [GitHub Releases](https://github.com/Shvquu/RPMG/releases) page.

1.0.0-SNAPSHOT

📦 ResourcePackEnforcer v1.0.0-SNAPSHOT

⚠️ Dies ist eine Snapshot-Version — nicht für den produktiven Einsatz empfohlen.
Feedback und Bugreports sind ausdrücklich erwünscht!

---

🎉 Erste Veröffentlichung

Dies ist die erste öffentliche Snapshot-Version von ResourcePackEnforcer —
einem Spigot-Plugin das Resourcepacks auf Minecraft-Servern erzwingt.

---

✨ Features

• Automatisches Senden des Resourcepacks beim Joinen des Servers
• Kick bei Ablehnung mit vollständig anpassbarer Nachricht
• Prompt-Nachricht beim Anfordern des Packs (ab Minecraft 1.17+)
• SHA-1 Hash Validierung (optional konfigurierbar)
• Bypass-Permission (resourcepack.bypass) für Admins & Moderatoren
• Farbcodes (&) und Hex-Farben (&#RRGGBB) in allen Nachrichten
• Konfigurierbarer Send-Delay in Ticks

⚙️ ConfigManager

• config.yml wird beim ersten Start automatisch generiert — inklusive Kommentaren
• Fehlende Schlüssel werden bei bestehender Config automatisch ergänzt
• Unterstützt /rp reload ohne Serverneustart

🔔 Konsolen-Banner

• Start-Banner (Gold) mit Version, Enforce-Status und Pack-URL
• Stop-Banner (Rot) beim Deaktivieren des Plugins
• Update-Banner (Gelb) wenn eine neuere Version auf GitHub verfügbar ist

🔄 Update-Checker

• Prüft asynchron beim Start gegen die GitHub Releases API
• Admins erhalten beim Joinen eine Chat-Benachrichtigung bei verfügbarem Update
• Kein externer JSON-Parser notwendig

💬 Befehle

Befehl	Beschreibung
/rp reload	Config neu laden
/rp send [Spieler]	Pack an einen Spieler senden
/rp sendall	Pack an alle Spieler senden
/rp info	Plugin-Status anzeigen

---

⚠️ Bekannte Einschränkungen

• Der Update-Checker benötigt eine aktive Internetverbindung beim Serverstart
• Hex-Farben in der Kick-Nachricht werden von älteren Clients (< 1.16) nicht dargestellt
• resourcepack.prompt wird erst ab Minecraft 1.17 angezeigt

---

📥 Installation

1. .jar Datei herunterladen
2. In den plugins/ Ordner des Servers legen
3. Server starten — config.yml wird automatisch erstellt
4. Resourcepack-URL in der config.yml eintragen
5. /rp reload ausführen oder Server neu starten

---

🔗 Links

• 📖 Dokumentation / README
• 🐛 Bug melden
• 💬 Frage stellen

---

Automatisch gebaut mit GitHub Actions • Java 21 • Spigot 1.20.4

# 📦 ResourcePackEnforcer v1.0.0-SNAPSHOT

⚠️ Dies ist eine Snapshot-Version — nicht für den produktiven Einsatz empfohlen.
Feedback und Bugreports sind ausdrücklich erwünscht!

---

🎉 Erste Veröffentlichung

Dies ist die erste öffentliche Snapshot-Version von ResourcePackEnforcer —
einem Spigot-Plugin das Resourcepacks auf Minecraft-Servern erzwingt.

---

✨ Features

• Automatisches Senden des Resourcepacks beim Joinen des Servers
• Kick bei Ablehnung mit vollständig anpassbarer Nachricht
• Prompt-Nachricht beim Anfordern des Packs (ab Minecraft 1.17+)
• SHA-1 Hash Validierung (optional konfigurierbar)
• Bypass-Permission (resourcepack.bypass) für Admins & Moderatoren
• Farbcodes (&) und Hex-Farben (&#RRGGBB) in allen Nachrichten
• Konfigurierbarer Send-Delay in Ticks

⚙️ ConfigManager

• config.yml wird beim ersten Start automatisch generiert — inklusive Kommentaren
• Fehlende Schlüssel werden bei bestehender Config automatisch ergänzt
• Unterstützt /rp reload ohne Serverneustart

🔔 Konsolen-Banner

• Start-Banner (Gold) mit Version, Enforce-Status und Pack-URL
• Stop-Banner (Rot) beim Deaktivieren des Plugins
• Update-Banner (Gelb) wenn eine neuere Version auf GitHub verfügbar ist

🔄 Update-Checker

• Prüft asynchron beim Start gegen die GitHub Releases API
• Admins erhalten beim Joinen eine Chat-Benachrichtigung bei verfügbarem Update
• Kein externer JSON-Parser notwendig

💬 Befehle

Befehl	Beschreibung
/rp reload	Config neu laden
/rp send [Spieler]	Pack an einen Spieler senden
/rp sendall	Pack an alle Spieler senden
/rp info	Plugin-Status anzeigen

---

🖥️ Kompatibilität

	Version
Minecraft	1.20+
Java	21
API	Spigot 1.20.4

---

⚠️ Bekannte Einschränkungen

• Der Update-Checker benötigt eine aktive Internetverbindung beim Serverstart
• Hex-Farben in der Kick-Nachricht werden von älteren Clients (< 1.16) nicht dargestellt
• resourcepack.prompt wird erst ab Minecraft 1.17 angezeigt

---

📥 Installation

1. .jar Datei herunterladen
2. In den plugins/ Ordner des Servers legen
3. Server starten — config.yml wird automatisch erstellt
4. Resourcepack-URL in der config.yml eintragen
5. /rp reload ausführen oder Server neu starten

---

🔗 Links

• 📖 Dokumentation / README
• 🐛 Bug melden
• 💬 Frage stellen

---

Automatisch gebaut mit GitHub Actions • Java 21 • Spigot 1.20.4

Full Changelog: https://github.com/Shvquu/RPMG/commits/v1.0.0-SNAPSHOT