README.md aktualisiert

README.md

@@ -1,21 +1,118 @@
-# FurnaceLevels
+# FurnaceLevels Plugin
 
-Ein Minecraft-Plugin, das die Level von Öfen (Furnaces) verwaltet und zusätzliche Features bietet.
+## Überblick
+FurnaceLevels ist ein Minecraft-Plugin, das die Funktionalität von Öfen erweitert, indem Spieler ihre Öfen bis Level 5 verbessern können, um die Schmelzgeschwindigkeit zu erhöhen. Das Plugin ist für Minecraft 1.21.1 ausgelegt und benötigt ProtocolLib als Abhängigkeit, mit optionaler Unterstützung für Vault.
 
-## Features
+## Funktionen
-
+- **Ofen-Upgrades**: Verbessere Öfen bis zu 5 Stufen, jede Stufe erhöht die Schmelzgeschwindigkeit.
-- Anzeige des aktuellen Levels eines Ofens
+- **Anpassbare Kosten**: Konfiguriere Upgrade-Kosten über eine Wirtschaft (Vault) oder benutzerdefinierte Items.
-- Event-Handling für Ofen-Aktionen
+- **Konfigurierbare Schmelzgeschwindigkeit**: Stelle die Ticks-pro-Tick für jedes Level ein, um die Schmelzgeschwindigkeit zu steuern.
-- Leicht erweiterbar für eigene Features
+- **Welten-Blacklist**: Deaktiviere das Plugin in bestimmten Welten (z. B. `world_end`).
+- **Debug-Befehl**: Aktiviere oder deaktiviere Debugging mit dem Befehl `/fldebug`.
+- **Berechtigungssystem**: Detaillierte Berechtigungen für Upgrades und Debugging.
 
 ## Installation
+1. Stelle sicher, dass **ProtocolLib** auf deinem Server installiert ist.
+2. (Optional) Installiere **Vault** für Wirtschafts-basierte Upgrades.
+3. Platziere die `FurnaceLevels.jar`-Datei im `plugins`-Ordner deines Servers.
+4. Starte den Server neu, um die Standard-Konfigurationsdateien zu generieren.
 
-1. Lade die JAR-Datei in deinen `plugins`-Ordner des Servers.
+## Konfiguration
-2. Starte den Server oder führe `/reload` aus.
+### plugin.yml
-3. Prüfe die Konsole auf erfolgreiche Initialisierung.
+Die `plugin.yml`-Datei definiert die Kern-Einstellungen, Befehle und Berechtigungen des Plugins.
+
+- **Hauptklasse**: `vpd.bowandaero12.furnacelv.FurnaceLevels`
+- **Version**: 2.0
+- **Abhängigkeiten**: Erfordert ProtocolLib, optional Vault.
+- **API-Version**: Kompatibel mit Minecraft 1.13 und höher.
+- **Befehle**:
+  - `/fldebug`: Aktiviert oder deaktiviert Debugging.
+- **Berechtigungen**:
+  - `furnacelevels.upgrade.<1-5>`: Erlaubt das Upgraden von Öfen auf die angegebene Stufe (Standard: true).
+  - `furnacelevels.debug`: Erlaubt die Nutzung des Debug-Befehls (Standard: op).
+
+### config.yml
+Die `config.yml`-Datei ermöglicht die Anpassung des Plugin-Verhaltens.
+
+- **Wirtschafts-Nutzung**:
+  - Setze `use-economy: true`, um Vault für Upgrade-Kosten zu verwenden.
+  - Setze `use-economy: false`, um benutzerdefinierte Items (z. B. Sonnenblume) für Upgrades zu nutzen.
+- **Kostenrückerstattung**:
+  - Bei `refund-cost: true` droppt ein zerstörter Ofen einen normalen Ofen und erstattet die gesamten Upgrade-Kosten.
+  - Bei `refund-cost: false` wird stattdessen das benutzerdefinierte Ofen-Item gedroppt.
+- **Upgrade-Stufen**:
+  - Konfiguriere Kosten und Schmelzgeschwindigkeiten (`ticks-per-tick`) für jedes Level (1–5).
+  - Beispiel:
+    ```yaml
+    upgrades:
+      level-1:
+        cost: 400000
+        ticks-per-tick: 10
+      level-2:
+        cost: 700000
+        ticks-per-tick: 20
+       ... bis Level 5
+       
+### Benutzerdefiniertes Item:
+
+Definiere das Item für Upgrades (z. B. minecraft:sunflower).
+Passe den Anzeigenamen und die Beschreibung an:
+```yaml
+item:
+  material-type: 'minecraft:sunflower'
+  displayname: '&6&lOfen-Upgrade-Token'
+  lore:
+  - '&cEin spezieller Token, um deinen Ofen zu verbessern!'
+  ```
+  
+## Welten-Blacklist:
+
+Liste Welten auf, in denen das Plugin deaktiviert ist:
+```yaml
+world-blacklist:
+  - world_end
+  ```
+  
+  
+## Befehle
+
+`/fldebug` - Schaltet den Debug-Modus ein oder aus (erfordert `furnacelevels.debug` -Berechtigung).
+
+## Berechtigungen
+
+`furnacelevels.upgrade.<1-5>` : Erlaubt das Upgraden von Öfen auf die angegebene Stufe (Standard: true).
+`furnacelevels.debug` : Erlaubt den Zugriff auf den `/fldebug` -Befehl (Standard: op).
+
+## Anforderungen
+
+* Minecraft-Version: 1.21.1
+* Abhängigkeiten:
+
+ *  **ProtocolLib**: Erforderlich für die Kernfunktionalität.
+ *  **Vault**: Optional für Wirtschaftsintegration.
+
+
+**Java-Version** : Kompatibel mit der Java-Version, die von Minecraft 1.21.1 verwendet wird.
 
 ## Nutzung
 
-- Platziere einen Ofen und interagiere damit.
+1. Platziere einen Ofen und interagiere mit ihm, um ihn zu verbessern, entweder mit:
-- Die Level und Events werden automatisch vom Plugin verwaltet.
 
+  * In-Game-Währung (wenn use-economy: true).
+  * Einem benutzerdefinierten Item wie dem "Ofen-Upgrade-Token" (wenn use-economy: false).
+
+
+Jedes Upgrade-Level erhöht die Schmelzgeschwindigkeit basierend auf den konfigurierten `ticks-per-tick`.
+Nutze `/fldebug` , um Probleme zu beheben (erfordert Berechtigung).
+
+## Hinweise
+
+Stelle sicher, dass die `ticks-per-tick` -Werte korrekt eingestellt sind, um Probleme zu vermeiden (Öfen setzen bei 200 Ticks zurück).
+Das Plugin ist in den angegebenen Welten der Blacklist (z. B. `world_end`) deaktiviert.
+Für Unterstützung oder Probleme erstelle ein Ticket im GitHub-Repository.
+
+## Mitwirken
+Beiträge sind willkommen! Bitte reiche einen Pull Request ein oder erstelle ein Issue im GitHub-Repository für Fehlerberichte oder Vorschläge.
+
+## Lizenz
+Dieses Projekt ist unter der MIT-Lizenz lizenziert. Siehe die LICENSE-Datei für Details.