[Tutorial] Pisanie pluginów do serwera

[Advix2210]

Witam, jako iż powstał dział właśnie dla modów oraz pluginów, postanowiłem stworzyć poradnik dla początkujących - jak tworzyć pluginy.

Oczywiście jeśli jesteś profesjonalnym developerem to nie musisz czytać tego tematu

ROZDZIAŁY POJAWIAĆ SIĘ BĘDĄ CO 2 DNI !!!

 

SPIS TREŚCI:

 

I. Potrzebne programy i podstawy

 

 

I. Potrzebne programy i podstawy.

 

W pierwszym rozdziale napiszę co powinniście posiadać tworząc pluginy.

 

W moim poradniku będziemy używali programu Eclipse, który możecie pobrać stąd:

To jest ukryta treść, proszę

• Zaloguj się
• lub
• Zarejestruj się

 

Będzie nam potrzebny też plik bukkit-0.0.1-SNAPSHOT.jar który pobierzecie stąd:

To jest ukryta treść, proszę

• Zaloguj się
• lub
• Zarejestruj się

 

Zapisujecie go do folderu gdzie będą wasze pluginu np. C:\Pluginy\

 

No i oczywiście CraftBukkit (Bukkit) najlepiej najnowszy, pobierzecie z bukkit.org

 

Klikacie Download [Germany] RWTH Aachen University (http) i pobieracie.

Wypakowywujecie gdzie chcecie i włączacie program.

 

Teraz klikacie po kolei: Window->Open Perspective->Other i wybieracie Java (default).

Po lewej stronie powinniście mieć coś takiego jak Package Explorer, jeśli nie macie to klikacie Window->Show View->Package Explorer.

 

Klikacie na nim prawym przyciskiem->New->Java Project. W Project Name wpiszcie PluginTutorial, ale potem to będzie po prostu nazwa waszego pluginu, na tutorial będę używał nazwy PluginTutorial.

Następnie klikacie Next, potem Libraries i teraz klikacie Add External JARs i wybieracie plik bukkit-0.0.1-SNAPSHOT.jar który pobraliście wcześniej i na koniec klikacie Finish.

 

Gratulacje! Utworzyłeś katalog swojego pluginu. Czas na przystąpienie do tworzenia innych plików.

 

Otwieracie wasz plugin:

 

 

Klikacie prawym na PluginTutorial i wybieracie New->File i w File name wpisujecie plugin.yml i klikacie Finish

 

 

Teraz powinien wam się włączyć ten plik w Eclipse.

Plik teraz przenosimy do folderu src.

 

Teraz to samo czyli prawym na folderze src i wybieracie New->Package i w Name wpisujecie:

 

pl.wasza_nazwa_na_mpc.minecraft.plugintutorial i klikacie Finish.

 

Teraz prawym na tą paczkę którą teraz utworzyliście i wybieracie New->Class i w Name wpisujecie PluginTutorial. (bez kropki)

 

Teraz w Eclipse powinniście mieć coś takiego:

 

To jest ukryta treść, proszę

• Zaloguj się
• lub
• Zarejestruj się

 

Teraz zaczynamy pisać!

 

po class PluginTutorial wpisujemy 'extends JavaPlugin', jak widzicie JavaPlugin podkreśliło się na czerwono - to oznacza błąd lub niezaimportowaną bibliotekę.

Więc zaznaczamy JavaPlugin i klikamy CTRL+1 i wybieramy Import 'JavaPlugin (org.bukkit.plugin.java)'.

Teraz w kodzie pojawiło nam się

To jest ukryta treść, proszę

• Zaloguj się
• lub
• Zarejestruj się

Tak się właśnie importuje.

 

Teraz podkreśliło się PluginTutorial, więc znowu CTRL+1 i 'Add unimplemented methods', w kodzie pojawiło się coś nowego:

 

To jest ukryta treść, proszę

• Zaloguj się
• lub
• Zarejestruj się

 

To są podstawowe funkcje dzięki którym plugin się włącza.

 

Ja dla wyglądu onEnable() daje sobie jako pierwsze ale wy możecie mieć jako drugie.

 

Teraz w końcu napiszemy sobie sami pierwszą funkcję.

 

Pod zakończeniem funkcji ( } ) robimy sobie z 2-3 entery i piszemy:

 

To jest ukryta treść, proszę

• Zaloguj się
• lub
• Zarejestruj się

 

Wyjaśniam:

 

public void PluginLog(String msg) - tworzymy nową funkcję o nazwie PluginLog z stringiem 'msg' który jest wiadomością.

 

PluginDescriptionFile pdFile = this.getDescription(); - Wczytujemy plik plugin.yml który zrobiliśmy wcześniej.

 

String message - nowy string

pdFile.getname() + " " + pdFile.getVersion() +": " +msg; - Wczytujemy nazwę oraz wersję pluginu i wyświetlamy wiadomość.

this.log.info(message); - Pokazujemy wiadomość

 

Teraz macie błąd z 'log' więc na początku (po extends JavaPlugin {) dodajecie 2 entery i piszecie:

 

To jest ukryta treść, proszę

• Zaloguj się
• lub
• Zarejestruj się

Teraz już nie powinniście mieć błędu z 'log';

 

OK to mamy pierwszą funkcję. Teraz w funkcji onEnable wpisujemy

 

To jest ukryta treść, proszę

• Zaloguj się
• lub
• Zarejestruj się

 

Dlaczego bez polskich znaków? A to dlatego iż konsola niestety nie obsługuje polskich znaków ( ).

 

Zapisujemy (CTRL+S) i przechodzimy do pliku plugin.yml w nim wpisujemy:

 

To jest ukryta treść, proszę

• Zaloguj się
• lub
• Zarejestruj się

 

version - Wersja wyświetlana w konsoli

name - Nazwa pluginu

main - Główny plik w którym są komendy onEnable oraz onDisable.

 

Zapisujemy (CTRL+S) i klikamy prawym na nasz projekt/folder projektu potem Export->Otwieramy folder Java i 2 razy klikamy na JAR File->Odznaczamy pliki .classpath oraz .project->W JAR file wpisujemy ścieżkę gdzie mamy folder plugins z bukkita + nazwa naszego pluginu np. C:\Pluginy\Bukkit\plugins\PluginTutorial.jar i klikamy Finish!

 

Gratulacje! Teraz możesz włączyć bukkita i patrzeć na napis PluginTutorial v0.1: WLACZONO ( ).

 

Koniec rozdziału pierwszego.

 

Jeśli poradnik wam się nie podoba to po prostu wpiszcie sobie na YT Bukkit Plugin Development i słuchajcie po angielsku.

 

Pozdrawiam, Advix2210.

[Geoning]

Super. Piękna kopia mojego tutoriala. Plagiat.

 

To jest ukryta treść, proszę

• Zaloguj się
• lub
• Zarejestruj się

Słabo wyjaśniona, i tylko loguje w konsoli. Bez sens.