TuxTwoLib

Ta biblioteka sama w sobie nic nie robi i jest ponownie kompilowana dla każdej wersji Minecrafta, aby zapewnić stabilne API dla kilku moich wtyczek opartych na wewnętrznych elementach CraftBukkit.

Tak, ta wtyczka została zaktualizowana do Spigot dla wersji Minecrafta 1.12!

Pobieranie

Który plik do pobrania potrzebuję?

Wszystkie pliki do pobrania mają wersjonowanie zgodne z wersją CraftBukkit, dla której są przeznaczone, po niej następuje opcjonalny numer rewizji, a następnie numer kompilacji. Jeśli więc korzystasz z CraftBukkit dla serwera Minecraft w wersji 1.4.4, będziesz szukał wersji takiej: 1.4.4-b1, gdzie b1 to numer kompilacji. (Zawsze pobieraj wersję z najwyższym numerem kompilacji dla Twojej wersji Minecrafta) Jeśli w budowie występuje niekompatybilność, także ma numer odpowiadający buildowi, na przykład tak: 1.4.5-R0.2-b1 byłaby kompatybilna ze wszystkimi buildami 1.4.5-R0.2 oraz wyższymi dla tej wersji Minecrafta.

Funkcje

• Wbudowany samoświadomy aktualizator będzie aktualizował wtyczkę tylko wtedy, gdy dostępna będzie aktualizacja dla Twojej wersji Minecrafta.
• Ustaw go tak, aby automatycznie aktualizował się tylko przy zmianie wersji Minecrafta, gdy dostępna jest aktualizacja, lub wcale.
• Będzie ostrzegać podczas logowania i w konsoli, gdy Twoja wersja Minecrafta będzie niezgodna z zainstalowaną wersją.
• Poinformuje Cię o tym, gdy zostaną zainstalowane nowe aktualizacje.
• Zapewnia metodę pobierania danych gracza offline.

Uprawnienia

• tuxtwolib.notices - Użytkownik może otrzymywać powiadomienia o nowych aktualizacjach i błędach niekompatybilności wersji Minecrafta.

Cel

Dla deweloperów

Najnowszy commit do CraftBukkit wymaga teraz od wszelkich wtyczek, które uzyskują dostęp do natywnych klas "net.minecraft.server" lub "org.bukkit.craftbukkit", aby zmodyfikowały importy przy każdej aktualizacji wersji Minecraft.
Ta biblioteka abstrahuje te natywne klasy, dzięki czemu, gdy Minecraft zostanie zaktualizowany, wystarczy zaktualizować tylko tę bibliotekę. Wtyczki, które używają tej biblioteki, mogą być zaprojektowane tak, aby były kompatybilne z wieloma wersjami Minecrafta.

Dla administratorów serwera

Jeśli masz wiele wtyczek, które wykorzystują natywny kod Minecrafta, teraz będziesz musiał zaktualizować każdą z nich przy każdej aktualizacji.
Na szczęście, jeśli używasz jakichkolwiek wtyczek, które wykorzystują tę bibliotekę, wystarczy zaktualizować jedną wtyczkę dla nich. Po prostu pobierz wersję tej biblioteki stworzoną dla Twojej wersji Minecrafta i masz to!

Jak używać:

Dla administratorów serwera

1. Pobierz odpowiednią wersję tej wtyczki dla Twojej wersji Minecrafta. (postępuj zgodnie z powyższymi instrukcjami)
   • Różne wersje tej wtyczki możesz znaleźć, klikając kartę „Pliki” powyżej
   • Upewnij się, że pamiętasz, gdzie pobrałeś plik!
2. Wybierz właśnie pobrany plik i skopiuj go do folderu „/plugins”.
   • Na Windows możesz użyć Ctrl+C lub kliknąć prawym przyciskiem myszy, a następnie wybrać „kopiuj”. Następnie użyj Ctrl+V lub prawym przyciskiem myszy, aby wkleić go do właściwego folderu.
   • Jeśli używasz terminala, powinieneś wiedzieć, jak użyć polecenia „cp” lub Midnight Commander.
   • Jeśli musisz użyć FTP, koniecznie zapoznaj się z dokumentacją. (połącz się z poprawnym IP, przeglądaj katalogi itp.)
3. Uruchom swój serwer tak, jak zwykle to robisz.
   • Zazwyczaj obejmuje to skrypt uruchomieniowy lub panel administracyjny. (ta część jest bardzo ważna)

Dla deweloperów

1. Sprawdź JavaDocs tej biblioteki, aby zobaczyć, czy mamy potrzebne hooki.
   • Ponieważ ta biblioteka jest nowa, prawdopodobnie nie ma jeszcze potrzebnych hooków.
   • Jeśli ich nie mamy, utwórz zgłoszenie wsparcia o ulepszenie. Możemy to dla Ciebie dodać!
2. Jeśli mamy, po prostu przejrzyj JavaDocs i podłącz go do swojego pluginu.
   
   • Nie zapomnij dodać "depend: [TuxTwoLib]" do swojego plugin.yml! (Zapewnia to, że biblioteka jest ładowana przed Twoją wtyczką)
3. W opisie swojej wtyczki upewnij się, że informujesz użytkowników, iż muszą mieć zainstalowaną tę bibliotekę na ich serwerze!

JavaDocs: http://javadocs.yu8.me/tuxtwolib/

Wątek o tym, jak używać API książki: http://forums.bukkit.org/threads/simple-temp-book-api.93562/
Większość klas pochodzi z: http://forums.bukkit.org/threads/lib-prettyscarylib.110164/

Najczęściej zadawane pytania

Pytanie: Pojawia się to w mojej konsoli: INFO java.lang.NoClassDefFoundError
Odpowiedź: Pobrałeś niewłaściwą wersję biblioteki, lub wersja kompatybilna z Twoją wersją Minecrafta jeszcze nie została wydana. Proszę dokładnie sprawdzić i upewnić się, że masz właściwy plik do pobrania.