Hallo zusammen!

Wir freuen uns, euch ein spannendes Update für ArcanumUI vorstellen zu können! Diese Version bringt eine mächtige neue Funktion, mit der ihr eure GUIs noch dynamischer und individueller gestalten könnt: die bedingte Item-Anzeige!

[HR][/HR]

⭐ Das Highlight: Bedingte Item-Anzeige ⭐

Mit diesem neuen Feature könnt ihr nun festlegen, dass bestimmte Items in euren GUIs nur dann angezeigt werden, wenn spezifische Bedingungen für den Spieler erfüllt sind. Und falls die Bedingungen nicht zutreffen, könnt ihr sogar ein alternatives Fallback-Item definieren!

Wie funktioniert's?
Ganz einfach über eure bestehenden GUI-Konfigurationsdateien im `plugins/ArcanumUI/guis/` Ordner. Fügt einem Item einfach den Abschnitt `conditions` und optional ein `condition_fallback_item` hinzu.

Unterstützte Bedingungen (zum Start):

• PERMISSION:<permission.node>: Zeigt das Item nur an, wenn der Spieler die angegebene Permission besitzt.
  
  Beispiel: PERMISSION:arcanum.vipaccess​
• PAPI_STRING_EQUALS:<placeholder>:<erwarteter_text>: Vergleicht den Wert eines PlaceholderAPI-Platzhalters mit einem Text.
  
  Beispiel: PAPI_STRING_EQUALS:%player_world%:survival_welt​
• PAPI_STRING_EQUALS_IGNORECASE:<placeholder>:<erwarteter_text>: Wie oben, ignoriert aber Groß-/Kleinschreibung.
• PAPI_NUMBER_EQUALS:<placeholder>:<erwartete_zahl>: Vergleicht einen numerischen PAPI-Platzhalter.
  
  Beispiel: PAPI_NUMBER_EQUALS:%player_points%:100​
• PAPI_NUMBER_GREATER:<placeholder>:<zahl>: Prüft, ob der PAPI-Wert größer ist.
• PAPI_NUMBER_LESS:<placeholder>:<zahl>: Prüft, ob der PAPI-Wert kleiner ist.
• PAPI_NUMBER_GREATER_OR_EQUALS:<placeholder>:<zahl>: Prüft auf größer oder gleich.
  
  Beispiel: PAPI_NUMBER_GREATER_OR_EQUALS:%player_level%:10​
• PAPI_NUMBER_LESS_OR_EQUALS:<placeholder>:<zahl>: Prüft auf kleiner oder gleich.

Fallback-Item:
Wenn die Bedingungen für ein Item nicht erfüllt sind und ein `condition_fallback_item` definiert wurde, wird dieses stattdessen angezeigt. Ansonsten bleibt der Slot leer (oder wird vom globalen `fill_item` des GUIs gefüllt, falls dieses nicht selbst Bedingungen unterliegt).

Anwendungsbeispiele:

• Items, die nur für Spieler mit bestimmten Rängen/Permissions sichtbar sind (z.B. Admin-Tools, VIP-Belohnungen).
• Angebote oder Informationen, die nur in bestimmten Welten oder Spielmodi angezeigt werden.
• Level- oder Quest-abhängige Items in Fortschrittsmenüs.
• Und vieles mehr – eurer Kreativität sind kaum Grenzen gesetzt!

[HR][/HR]

✨ Verbesserungen ✨

• Verbesserte PAPI-Platzhalter-Verarbeitung: ArcanumUI gibt nun deutlichere Warnungen in der Konsole aus, falls ein PlaceholderAPI-Platzhalter (insbesondere bei numerischen Bedingungen wie %player_level%) nicht korrekt aufgelöst werden kann. Dies hilft euch schneller zu erkennen, ob eventuell eine PAPI-Expansion (wie die "Player"-Expansion) auf eurem Server fehlt oder nicht korrekt funktioniert.

[HR][/HR]

Beispielkonfiguration für ein bedingtes Item

So könnte ein Item mit Bedingungen in eurer `meine_gui.yml` (oder einer anderen GUI-Datei) aussehen:
[HR][/HR]

⬆️ Wie updated ihr? ⬆️

1. Ladet die neueste Version von ArcanumUI herunter (Klicke hier zum Download).
2. Stoppt euren Server.
3. Ersetzt die alte `ArcanumUI-*.jar`-Datei in eurem `plugins`-Ordner durch die neue Version.
4. Startet euren Server.
5. Überprüft eure GUI-Konfigurationsdateien im Ordner `plugins/ArcanumUI/guis/` und fügt nach Belieben die neuen `conditions` und `condition_fallback_item`-Optionen zu euren Items hinzu.
6. Nutzt den Befehl /arcgui reload, nachdem ihr Änderungen an euren GUI-Konfigurationen vorgenommen habt, um diese neuzuladen.

Wichtig für PAPI-Bedingungen:

• Stellt sicher, dass PlaceholderAPI auf eurem Server installiert ist.
• Für die Nutzung von Platzhaltern wie %player_level%, %player_world% etc. müssen die entsprechenden PlaceholderAPI-Expansionen (z.B. "Player", "Server") installiert und funktionsfähig sein. Ihr könnt diese meist einfach über /papi ecloud download Player (und andere Expansionen) herunterladen und mit /papi reload aktivieren.

[HR][/HR]

Feedback & Support

Euer Feedback ist uns sehr wichtig! Teilt uns eure Meinung mit, meldet Fehler oder schlagt neue Funktionen vor

[HR][/HR]


Lasst uns wissen, welche Features ihr euch am meisten wünscht!

[HR][/HR]

Vielen Dank für eure Unterstützung und viel Spaß mit dem neuen ArcanumUI Update!

Beste Grüße,
Graynetic