Plugin Minecraft skript-placeholders

🔌 O skript-placeholders

skript-placeholders to dodatek do pluginu Skript, który zapewnia integrację placeholderów: pozwala rejestrować placeholdery ze Skript i udostępniać je PlaceholderAPI oraz MVdWPlaceholderAPI, aby inne pluginy mogły odczytywać zmienne Skript.

🎯 Cel

Plugin rozwiązuje problem udostępniania dynamicznych wartości zarządzanych przez Skript (zmiennych, obliczonych danych) innym pluginom obsługującym placeholdery. Jest to przydatne, gdy chcesz, aby stan sterowany przez Skript lub własne wartości pojawiały się na scoreboardach, w formatach czatu, boss barach, listach tab lub w dowolnym pluginie, który odczytuje placeholdery PlaceholderAPI / MVdWPlaceholderAPI.

⚙️ Funkcje

• Rejestruj i udostępniaj placeholdery ze Skript do PlaceholderAPI.
• Opcjonalna obsługa MVdWPlaceholderAPI (wymaga pluginu zgodnego z MVdW, aby MVdWPlaceholderAPI działał).
• Pobieraj wartości placeholderów ze Skript wewnątrz skryptów (zobacz wiki projektu po przykłady).
• Fork/kontynuacja projektu Ersatz, zaktualizowana tak, aby działać z systemem PlaceholderExpansion PlaceholderAPI.

🧩 Dla kogo jest ten plugin

• Dla właścicieli i administratorów serwerów, którzy używają Skript do tworzenia własnej logiki i potrzebują, aby te wartości były dostępne dla innych pluginów.
• Dla serwerów korzystających z PlaceholderAPI lub MVdWPlaceholderAPI oraz modyfikacji opartych na Skript.

🏗️ Przykładowe zastosowania

• Udostępnienie zmiennej Skript zawierającej statystykę gracza, aby plugin scoreboard mógł wyświetlać ją przez placeholder.
• Tworzenie własnych placeholderów w Skript używanych przez pluginy czatu/tab/bossbar obsługujące PlaceholderAPI.

⚙️ Instalacja

📥 Konfiguracja

• Pobierz plik JAR pluginu i umieść go w katalogu plugins/ swojego serwera.
• Upewnij się, że Skript (w wersji 2.7.3 lub nowszej) jest zainstalowany i obecny.
• Zainstaluj PlaceholderAPI lub MVdWPlaceholderAPI, zależnie od systemu placeholderów, którego chcesz używać.
• Uruchom lub zrestartuj serwer i sprawdź konsolę, aby potwierdzić, że dodatek został poprawnie załadowany.

📦 Zależności

• Skript (wymaga wersji 2.7.3 lub nowszej)
• PlaceholderAPI lub MVdWPlaceholderAPI (jeden z nich musi być zainstalowany, aby udostępniać placeholdery)

🧠 Uwagi techniczne

• Dodatek jest forkiem projektu Ersatz i został zaktualizowany do pracy z systemem PlaceholderExpansion w PlaceholderAPI.
• Autor pluginu podaje na stronie projektu zakres przetestowanych wersji Minecrafta.

🤝 Kiedy ten plugin jest przydatny

Jeśli zarządzasz serwerem, który opiera się na Skript do własnych mechanik i potrzebujesz, aby wartości zarządzane przez skrypty były dostępne dla innych pluginów przez ujednolicony system placeholderów, skript-placeholders zapewnia prosty pomost do PlaceholderAPI i MVdWPlaceholderAPI.