FurnaceLevels/README.md

FurnaceLevels Plugin

Ü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.

Funktionen

• Ofen-Upgrades: Verbessere Öfen bis zu 5 Stufen, jede Stufe erhöht die Schmelzgeschwindigkeit.
• Anpassbare Kosten: Konfiguriere Upgrade-Kosten über eine Wirtschaft (Vault) oder benutzerdefinierte Items.
• Konfigurierbare Schmelzgeschwindigkeit: Stelle die Ticks-pro-Tick für jedes Level ein, um die Schmelzgeschwindigkeit zu steuern.
• 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.

Konfiguration

plugin.yml

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:

    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:

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:

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

1. Platziere einen Ofen und interagiere mit ihm, um ihn zu verbessern, entweder mit:

• 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.