Plugin Minecraft SkBee

🔌 O SkBee

SkBee to dodatek do Skript, który rozszerza język Skript o szeroki zestaw elementów udostępniających autorom skryptów wewnętrzne mechanizmy serwera i nowoczesne funkcje Minecrafta. Zapewnia składnie i narzędzia do pracy z NBT, zaawansowanymi komponentami tekstu, scoreboardami, recepturami, danymi bloków, strukturami, tworzeniem światów oraz prostymi regionami/granicami — pozwalając administratorom serwera implementować złożone mechaniki przy użyciu Skript zamiast Java.

🎯 Cel

Głównym celem SkBee jest zapewnienie użytkownikom Skript bezpośredniego dostępu do funkcji API serwera Bukkit/Paper i wewnętrznych mechanizmów Minecrafta, które w zwykłym Skript są trudne lub niemożliwe do osiągnięcia. Jest przeznaczony dla właścicieli serwerów i osób piszących skrypty, które potrzebują dokładniejszej kontroli nad przedmiotami, encjami, formatowaniem tekstu, manipulacją światem i obsługą struktur w skryptach Skript.

⚙️ Funkcje

• Elementy NBT: odczyt/zapis NBT przedmiotów, tile entity (bloków) i encji (zaznaczone jako dostępne dla starszych wersji aż do 1.8.8+ tam, gdzie wspierane).
• FastBoards: implementacja scoreboardu zaprojektowana tak, aby ograniczyć migotanie (dostępna na nowszych wersjach Minecrafta tam, gdzie wspierane).
• Receptury: dodawanie własnych receptur i usuwanie vanilla receptur (funkcje oznaczone jako dostępne od nowszych wersji, np. 1.13+ dla API receptur).
• BlockData: uproszczony dostęp do odczytu/zapisu danych bloku dla nowoczesnych stanów bloków (dostępne na wspieranych wersjach).
• Structures: zapisywanie i wklejanie vanilla struktur Minecrafta z użyciem systemu struktur w grze.
• TextComponents: tworzenie i modyfikowanie wiadomości w stylu JSON/TextComponent z eventami hover i click oraz obsługą podglądu przedmiotu.
• WorldCreator: tworzenie własnych światów z konfigurowalnymi opcjami udostępnionymi Skript.
• Bounds: tworzenie prostych bounds/regionów, podobnych do lekkiej ochrony regionów, do użycia w Skript.
• GameEvents: podłączanie się do systemu GameEvent w Minecraft (używanego przez sensory skulk i powiązane mechaniki).

🧩 Dla kogo

• Administratorów serwerów używających Skript i potrzebujących głębszego dostępu do API bez pisania wtyczek Java.
• Twórców Skript budujących zaawansowane GUI, własne przedmioty, strukturyzowane wiadomości lub narzędzia do światów/struktur.
• Serwerów Survival, SMP i serwerów z własnymi trybami gry, które opierają się na Skript w mechanikach rozgrywki i chcą rozszerzyć funkcjonalność.

🏗️ Przykładowe zastosowania

• Skrypter odczytuje i modyfikuje NBT przedmiotu, aby zaimplementować własne zachowanie i atrybuty przedmiotów w Skript.
• Administrator tworzy własne receptury craftingu i usuwa niechciane vanilla receptury za pomocą składni Skript.
• Projektanci zapisują i wklejają gotowe struktury podczas generowania świata lub przy użyciu narzędzi budowlanych w grze.
• Systemy czatu lub GUI, które potrzebują JSON-owych komponentów tekstu z akcjami hover/click i podglądem przedmiotów.

⚙️ Instalacja

📥 Konfiguracja

• Pobierz plugin SkBee .jar z oficjalnego źródła i umieść go w katalogu plugins/ serwera razem ze Skript.
• Uruchom ponownie serwer, aby Skript i jego dodatki załadowały się poprawnie.
• Sprawdź logi konsoli serwera, aby potwierdzić, że SkBee został poprawnie załadowany i wykrył zainstalowaną wersję Skript.

📦 Zależności

• Skript (SkBee jest dodatkiem do Skript; najnowsze wydania SkBee wymagają nowszych wydań Skript — sprawdź notatki do wydania wtyczki, aby poznać dokładnie wymagane wersje Skript).

🧠 Uwagi techniczne

• SkBee jest rozwijany jako projekt open source na licencji GPL-3.0.
• Różne funkcje mogą być zależne od wersji: niektóre elementy (na przykład obsługa NBT) mają uwagi dotyczące zgodności ze starszymi wydaniami Minecrafta (dokumentacja upstream wskazuje dostępność niektórych funkcji od 1.8.8+, a innych od 1.13+).
• SkBee udostępnia JavaDocs i wiki dla składni; korzystaj z tych materiałów, pisząc pliki Skript używające funkcji SkBee.
• SkBee stara się wspierać nowsze wydania Skript i Minecrafta; konkretne wymagane wersje Skript lub Minecrafta różnią się w zależności od wydania SkBee — sprawdź notatki do wydania pobieranego buildu.

🤝 Kiedy ta wtyczka jest przydatna

Jeśli korzystasz ze Skript jako systemu skryptów swojego serwera i potrzebujesz dostępu do NBT, strukturyzowanych wiadomości tekstowych, własnych receptur, zapisywania/wklejania struktur lub prostych narzędzi do tworzenia regionów i światów bez pisania Java, SkBee oferuje szeroki zestaw potwierdzonych składni i narzędzi, które rozszerzają to, co możesz zaimplementować wyłącznie w Skript.