BKCommonLib

BKCommonLib nie jest już aktualizowany na dev.bukkit.org.

Jeśli chcesz użyć najnowszej wersji, użyj Spigot.

Najnowsza wersja: 1.57

Wersje kompilacyjne: CB 1.6.4 R1.0 / CB 1.6.4 R2.1 / Spigot 1.7

Dostępne starsze kompilacje: CB 1.5.2-R1.0 / CB 1.6.2-R1.0

Tekkit: Nieprzetestowany i tym samym nieobsługiwany, niektóre funkcje mogą nie działać zgodnie z oczekiwaniami

Opis

Ta biblioteka narzędzi udostępnia wszystkie wspólne fragmenty kodu potrzebne dla różnych wtyczek, a umieszczenie ich w jednej bibliotece znacznie redukuje ilość duplikowanego kodu. Funkcje wyróżnione są różnorodne, a gdy czegoś brakuje w Bukkit, dodawane jest to w BKCommonLib. To jeden z powodów, dla których stała się tak obszerna: po prostu jest wiele rzeczy, których Bukkit nie oferuje (ani nie chce oferować).

BKCommonLib ma wersjonowanie na poziomie każdej wtyczki, więc gdy określona wtyczka potrzebuje wersji 2, a wersja 1 jest zainstalowana, administrator serwera zostaje automatycznie powiadomiony i wtyczka nie zostanie włączona. Zapobiega to powszechnym problemom z nieaktualnymi wersjami BKCommonLib.

Poza narzędziami i usługami, ta biblioteka oferuje szeroki zestaw refleksji i łatwych w użyciu sposobów dostępu do net.minecraft.server. Jeśli Twoja wtyczka wymaga użycia wewnętrzności, a nie chcesz ryzykować zmiany nazw pól i metod, możesz polegać na BKCommonLib, aby je dla Ciebie zapewnić. Dzięki temu automatycznie zachowasz kompatybilność między wersjami CraftBukkit i zredukujesz ryzyko cichych błędów.

Powody, dla których warto polegać na tej bibliotece

• Musisz uzyskać dostęp do wewnętrznych elementów Minecrafta w swojej wtyczce, a Bukkit nie ma API do tego
• Masz dość ponownego przesyłania tej samej wersji z powodu zmian w wewnętrznych elementach
• Chcesz pracować z logiką wektorów/matematyki lub potrzebujesz innych klas narzędziowych
• YAML Bukkit nie lubi Cię i chcesz, aby to było łatwiejsze
• Chcesz łatwo odczytywać i zapisywać pliki konfiguracyjne/dane
• Chcesz łatwego dostępu do narzędzi konwersji danych, aby konwertować dane wejściowe użytkownika
• Chcesz pracować z inwentarzami w zaawansowany sposób
• Chcesz pracować z unikalnymi zdarzeniami serwera
• Chcesz modyfikować zachowanie encji (np. obsługa kolizji bloków, niestandardowy ruch itp.)
• Chcesz, aby komunikaty i uprawnienia wtyczek były konfigurowalne
• Chcesz pracować z zadaniami (asynchronicznymi) bez przechowywania identyfikatorów
• Chcesz wysyłać i manipulować pakietami

Funkcje

• Ogólne
  • PluginBase dla łatwego dostępu do metryk, uprawnień, lokalizacji i innych
  • Permission defaults dla przechowywania domyślnych uprawnień używanych przez wtyczkę
  • Localization dla konfigurowania komunikatów wtyczki
• Narzędzia
  • General utilities dla operacji String, Logic, BlockFace i Math
  • Block utilities dla operacji związanych z blokami (stany, dane, itp.)
  • ItemUtil dla operacji inwentarza, przedmiotów i transferu przedmiotów
  • RecipeUtil do pracy z recepturami craftingu i pieca
  • Różne Kolekcje do automatycznego filtrowania, konwersji i interpolacji
• Dane
  • API konfiguracji z węzłami, nagłówkami i innymi dodatkami
  • API NBT zaprojektowane na wzór API konfiguracji
  • (Kompresowane) DataReader/DataWriter do odczytu i zapisu danych z/do pliku
• Encje
  • CommonEntity implementacje z dodatkowymi narzędziami
  • EntityController do modyfikowania zachowania encji
  • EntityNetworkController do modyfikowania logiki sieci encji
• Usługi
  • Metrics do śledzenia statystyk wtyczek
  • Conversion do konwersji między wszystkimi typami danych
  • Events and Listeners do śledzenia zmian na serwerze
  • Packet usługi i API do śledzenia pakietów
  • Task klasa ułatwiająca planowanie zadań
  • Scoreboard usługi do tworzenia tablic wyników bez kryteriów
  • Tab View usługa do zmiany tego, co jest pokazywane, gdy gracze naciskają Tab

Rozpoczęcie pracy

Aby zacząć używać BKCommonLib, masz dwie opcje (po dodaniu BKCommonLib jako zależności w pliku plugin.yml):

Dołącz plik jar jako zależność

Podobnie jak każdą zależność, przechowuj plik jar gdzieś na komputerze i dodaj go do swojej ścieżki klas. Tutaj nic specjalnego.

Utwórz (nowy) projekt Maven i dodaj go

Dodaj następujące repozytorium:

<repository>
    <id>dj-tcraft repository</id>
    <url>http://ci.dj-tcraft.nl/plugin/repository/everything/</url>
</repository>

Aby dodać następującą zależność (może być konieczna aktualizacja wersji):

<dependency>
    <groupId>com.bergerkiller.bukkit</groupId>
    <artifactId>BKCommonLib</artifactId>
    <version>1.54-SNAPSHOT</version>
    <scope>provided</scope>
</dependency>

Zależności BKCommonLib używane

BKCommonLib obsługuje różne inne wtyczki i projekty. Poniżej wymieniono wszystkie z nich:

• Vault - do obsługi wtyczek uprawnień
• ProtocolLib - aby uniknąć konfliktów nasłuchiwania pakietów
• Showcase(Standalone) - aby ignorować pokazywane przedmioty
• HyperConomy - aby ignorować przedmioty sklepu
• BleedingMobs - aby ignorować cząstki
• CGLib - do generowania klas nms.Entity na bieżąco w celu dostarczenia Kontrolerów Encji
• Objenesis - do generowania klas bez wywoływania konstruktorów (potrzebne do różnych poprawek w konstruktorach klas)

Wtyczki wymagające zainstalowania BKCommonLib:

• NoLagg
• TrainCarts
• SignLink
• MyWorlds
• RedstoneMania
• Statues
• EasyMobArmory

Zastrzeżenie

Ta wtyczka korzysta z systemu metryk Hidendra, co oznacza, że następujące informacje są gromadzone i wysyłane do mcstats.org:

• Unikalny identyfikator
• Wersja Javy serwera
• Czy serwer działa w trybie offline czy online
• Wersja wtyczki
• Wersja serwera
• Wersja/nazwa systemu operacyjnego i architektury
• Liczba rdzeni CPU
• Liczba graczy online
• Wersja metryk. Rezygnacja z tej usługi może być dokonana przez edycję plugins/Plugin Metrics/config.yml i ustawienie opt-out na true.

Licencja

Ta biblioteka używa otwartej licencji. Śmiało możesz używać dowolnego kodu z niej; nie musisz o to pytać. Jeśli chcesz, żebym dodał określone funkcje, również w porządku. Każdy może używać tej biblioteki jako zależności. Zalecam raczej rozszerzanie 'PluginBase' zamiast 'JavaPlugin', ponieważ pozwala to automatycznie obsługiwać sprawdzanie wersjonowania BKCommonLib. Zobacz także: plik licencji BKCommonLib

Ten produkt zawiera oprogramowanie opracowane przez Apache Software Foundation (http://www.apache.org/)

Linki:

• BKCommonLib na GitHub (dla kodu źródłowego)
• Javadocs (1.57)

Zgodność

BKCommonLib obsługuje ProtocolLib gdy jest włączony, ale jeśli nie, połączenie gracza jest zastępowane, co skutkuje kilkoma niekompatybilnościami. Aby rozwiązać te problemy z niekompatybilnością, zainstaluj ProtocolLib obok BKCommonLib. Nie można tego podkreślać wystarczająco. Gdy wystąpi niekompatybilność, BKCommonLib poinformuje Cię w konsoli i wyłączy się. Następujące wtyczki są znane z bycia niekompatybilnymi, gdy ProtocolLib NIE jest zainstalowany:

• Spout Plugin

Metryki

Ta wtyczka wysyła licznik serwera i statystyki zależności do MCStats.org. Możesz (globalnie) zrezygnować z tej usługi w pliku PluginMetrics/config.yml.

Baner

Używam banera w moich zależnych wtyczkach. Baner ten jest automatycznie aktualizowany, gdy pojawi się nowa wersja BKCommonLib. To szybki i skuteczny sposób na śledzenie aktualizacji tej biblioteki. Było to również potrzebne, ponieważ wiele osób używało przestarzałych wersji BKCommonLib, co prowadziło do zgłaszania błędów...za dużo z nich. Nie chcę również marnować twojego czasu na nieprawidłowe zgłoszenia. Masz wtyczkę, która korzysta z BKCommonLib? Śmiało użyj banera na swojej stronie z pobieraniem.

[[http://dev.bukkit.org/bukkit-plugins/bkcommonlib/|{{http://ci.dj-tcraft.nl/job/BKCommonLib/lastSuccessfulBuild/artifact/target/BKCommonLibVersion.png|Go to the BKCommonLib Dev-bukkit page}}]]

Buildy deweloperskie

Kliknij tutaj, aby pobrać buildy deweloperskie tej wtyczki