Skocz do zawartości

  • 👋 Witaj na MPCForum!

    Przeglądasz forum jako gość, co oznacza, że wiele świetnych funkcji jest jeszcze przed Tobą! 😎

    • ✅ Pełny dostęp do działów i ukrytych treści
    • ✅ Możliwość pisania i odpowiadania w tematach
    • ✅ System prywatnych wiadomości
    • ✅ Zbieranie reputacji i rozwijanie swojego profilu
    • ✅ Członkostwo w jednej z największych społeczności graczy

    👉 Dołączenie zajmie Ci mniej niż minutę – a zyskasz znacznie więcej!

    Zarejestruj się teraz

[TuT] Bukkit Plugin Development #1 - IDE, Podstawy.

Gość tolvat

Przez Gość tolvat
w Minecraft - Poradniki

Rekomendowane odpowiedzi

Gość

Gość

Opublikowano

Gość

Opublikowano

UWAGA: Nie wiem dalczego serwery Postimage przestały działać - aktualnie nie ma przez to obrazków!

Info: Zmieniłem hosting obrazków na ImageShack,

 

Siemanko, użytkownicy MPCForum!

 

Jako iż poradnik Geoninga, nie jest zbyt rozbudowany, a niektóre poradniki są na stare wersje Bukkita - ja postanowiłem zrobić całą serię poradników, zastanawiałem się nad Video-Tutorialami, jednak... wolicie nie słuchać mojego głosu, uwierzcie mi.

 

SPIS TREŚCI:

1. Pobieranie oraz instalacja IDE: Eclipse oraz serwera CraftBukkit.

2. Tworzenie projektu, podstawy pisania pluginu.

 

1. Pobieranie oraz instalacja IDE: Eclipse oraz serwera CraftBukkit

 

No więc tak, Eclipse czyli nasze IDE, czyli program w którym będziemy wszystko pisali możemy pobrać stąd (nie jest to oficjalny download, ponieważ na serwerach które u mnie się pokazują - nie ma Eclipse i nie da się go pobrać z oficjalnej strony):

http://gosecure.genuitec.com/pulse/delivery/get/package/6384-abm-4499/installers/eclipse-classic-juno-sr2-offline-installer-windows.exe

Bardzo przydatna będzie również znajomość skrótów klawiszowych Eclipse:

 

http://eclipse.dzone.com/news/effective-eclipse-shortcut-key

 

Gdy mamy już Eclipse na swoim komputerze - instalujemy je (może to potrwać kilka minut).

 

Po poprawnym zainstalowaniu, powinno wyświetlić się coś takiego:

 

68141071.jpg

 

Klikamy "Finish", i czekamy aż Eclipse się włączy.

 

Po jakimś czasie, zauważymy że Eclipse pyta się o nasz Workspace - czyli miejsce gdzie będziemy mieli nasze projekty, ale nie serwer!

Ja wybiorę "C:\TutorialeMPC\BukkitPlugins".

 

84942732.jpg

 

Klikamy OK i czekamy aż Eclipse się załaduje.

Możemy również zaznaczyć "Use this as the default and do not ask again" czyli "Używaj tego miejsca jako domyślnego i nie pytaj o to ponownie", ja tego nie wybieram ponieważ pracuję nie tylko w Javie.

 

Po włączeniu się Eclipse, pokazuje nam się ekran powitalny:

 

90058096.jpg

 

Zamykamy go, naciskając "X" obok nazwy naszej zakładki czyli "Welcome".

Okej, mamy już nasz program, no ale co dalej?

 

Na początku musimy pobrać CraftBukkita, czyli po prostu serwer gry.

W tym celu przechodzimy na stronę:

 

http://dl.bukkit.org

Następnie musimy kliknąć w ten obrazek (chyba nie muszę tłumaczyć że chodzi o obrazek na stronie, a nie tutaj):

 

21110662.jpg

 

No to jedziemy dalej!

Zapisujemy naszego Bukkita gdziekolwiek, ja polecam zapisać go w miejscu gdzie będzie serwer.

Dla mnie jest to "C:\TutorialeMPC\SerwerBukkita".

 

No i to na tyle w pierwszym punkcie! Przejdźmy do punktu kolejnego :)

 

2. Tworzenie projektu, podstawy pisania pluginów.

 

Witajcie ponownie!

W tym punkcie - pokażę wam jak stworzyć projekt, aby był to plugin a nie zwykły projekt Javy, oraz pokażę wam jak wyglądają najważniejsze pliki każdego pluginu.

 

Zacznijmy od tworzenia projektu, jak pewnie pamiętacie w ostatnim punkcie pobraliśmy nasz serwer (CraftBukkit), jest on jednym z NAJWAŻNIEJSZYCH plików projektu.

 

No ale, przejdźmy do Eclipse.

 

Aby stworzyć nasz projekt, klikamy PPM na Package Explorer, wybieramy New -> Java Project.

 

70488199.jpg

 

No i mamy takie oto okno:

 

87214864.jpg

 

Tam gdzie ja wpisałem "TutMPC_01" wpisujemy nazwę naszego projektu, może (ale nie musi!) to być nazwa naszego pluginu.

 

Teraz klikamy "Next >", przechodzimy do Libraries, wybieramy Add External JARs... i dodajemy nasz wcześniej pobrany CraftBukkit, ja zmieniłem jego nazwę na "craftbukkit.jar", ponieważ wolę taką.

 

Powinno to wyglądać mniej-więcej tak:

 

49011745.jpg

 

Gdy już wszystko zrobiliśmy - klikamy Finish.

W naszym Package Explorerze powinien pojawić się nasz projekt.

 

11975549bom.jpg

 

Po rozwinięciu go naciskając na strzałkę obok jego nazwy, powinny być takie pliki jak u mnie: src, JRE System Library, Referenced Libraries (czyli CraftBukkit).

 

Jeśli ich nie ma - to znaczy że coś zrobiłeś źle.

 

No dobra - przejdźmy może do pisania, co?..

Nie tak szybko, przecież nie mamy w czym pisać!

 

Tworzymy paczkę oraz klasę klikając zielone kółko z literą "C" oraz gwiazdką.

 

59623631.jpg

 

Pojawi się okno tworzenia nowej klasy:

 

82630372.jpg

 

1 - nazwa naszej paczki, najczęściej jest to "com.<twój nick>.<nazwa pluginu>", ja używam "me.tolvat.<dla kogo pisze plugin>.<nazwa pluginu>".

2 - nazwa naszej GŁÓWNEJ klasy, wpiszmy tutaj nazwę naszego pluginu.

 

Nie zmieniając nic więcej -> Klikamy FINISH.

 

No i widzimy, że w końcu mamy jakiś kod:

 

22902171.jpg

 

Jest to kod który jest domyślnie ustawiony do pliku Javy.

 

TERAZ TA NAJLEPSZA CZĘŚĆ - KODOWANIE! JEJ!

 

No więc, po nazwie naszej klasy (u mnie jest to TutMPC) - wpisujemy "extends JavaPlugin", następnie zaraz po klamrze "{", wpiszmy:

Logger log = Logger.getLogger("Minecraft");

Logger to... trudno powiedzieć, abyście zrozumieli - jest to klasa dzięki której wysyłamy informacje do konsoli serwera, np. że plugin został włączony, albo że wystąpił jakiś błąd.

 

No dobra, mamy Logger, ale to nic przecież nie robi!

 

Spokojnie... teraz zajmiemy się głównymi funkcjami :)

Ale zanim to zrobimy, widzimy jakieś błędy.. hm... ah!

 

Musimy zaimportować klasę Logger oraz JavaPlugin! W tym celu wciskamy na klawiaturze "CTRL + Shift + O".

 

No ok, teraz jest dobrze.

Zajmijmy się głównymi funkcjami pluginu:

 

po naszym Loggerze wpiszmy:

public void onEnable() {

}

public void onDisable() {

}

public void log(String message) {
 log.info("[TutMPC]: " + message);
}

 

Funkcja "log" nie jest obowiązkowa, jednak jest przydatna :)

 

Więc tak:

 

Funkcja "onEnable" - tutaj jest kod który ma coś robić po włączeniu się pluginu.

Funkcja "onDisable" - tutaj jest kod który ma coś robić po wyłączeniu się pluginu (np. przy restarcie serwera).

Funkcja "log" - ta funkcja ma za zadanie wysyłać informacje do konsoli serwera.

 

Używając funkcji "log" wyświetlmy informację że plugin został wyłączony oraz że został włączony.

 

W funkcji "onEnable", wpiszmy:

log("has been enabled.");

 

W funkcji "onDisable", wpiszmy:

log("has been disabled");

 

Myślę że wiecie co to zrobi :)

 

Ale na wszelki wypadek:

 

log - użyj funkcji "log"

"has been ..." - przekaż do niej taką informację, nazywamy to parametrami.

 

Cała klasa powinna wyglądać tak:

 

23463913.jpg

No dobrze, ale plugin nam się nie włączy... brakuje nam pliku "plugin.yml"!

 

Kliknijmy prawym na folder "src" w Package Explorerze i stwórzmy nowy plik (New -> File), nazwijmy go "plugin.yml".

 

Musimy w nim wpisać ważne informacje:

 

name: TutMPC
main: me.tolvat.mpcforum.mpc01.TutMPC
version: 1.0

 

name - nazwa naszego pluginu

 

main - ścieżka do głównej klasy naszego pluginu.

version - wersja naszego pluginu

 

Popatrzcie jak ja to zrobiłem - i pomyślcie jak powinniście zrobić wy :)

 

No i teraz już wszystko jest dobrze!

Wyeksportujmy nasz plugin do pliku *.jar

 

Robimy to tak:

 

PPM na nazwę naszego projektu -> Export -> Java -> JAR File.

Klikamy NEXT, klikamy Browse i podajemy ścieżkę do folderu "plugins" w naszym folderze z serwerem pobranym w 1. punkcie.

 

 

80692101.jpg

 

Klikamy Finish, i sprawdzamy czy wszystko działa jak powinno - czyli po prostu włączamy nasz serwer!

 

Jak widzicie nie ma żadnych błędów!

No i to by było na razie na tylko, huu, troche się napisałem :D

 

ZAKAZ KOPIOWANIA NA INNE FORA!

PORADNIK STWORZONY PRZEZ: tolvat

 

P.S. Co chcecie w kolejnym poradniku?

Gość

Gość

Opublikowano

Gość

Opublikowano

@Russek14

 

Postaram się w najbliższym czasie zrobić jeszcze kilka tutków i potem przejdę do tworzenia jakiegoś projektu w tutorialach :)

Dzięki za pomysł.

Zarchiwizowany

Ten temat przebywa obecnie w archiwum. Dodawanie nowych odpowiedzi zostało zablokowane.

Tematy
×
×
  • Dodaj nową pozycję...