- Viestit
- 36
- Reaktiopisteet
- 34
Tervehdys! Tänään opetan teille, kuinka voit tehdä ensimmäisen Bukkit/Spigot-pluginisi. Spigotin ja Bukkitin documentaatiot/Javadocit löytää nopeasti Spigotin Developers Hubista (https://hub.spigotmc.org/).
Nyt alkuun, tarvitset Spigotin tai Bukkitin palvelintiedoston (spigotin tiedosto usein muotoa spigot-1.xx.x.jar) sekä jonkun IDEn jolla ohjelmoimme. Tässä tutoriaalissa käytämme Eclipseä jonka voit ladata osoitteesta https://www.eclipse.org/downloads/.
Kun olet saanut Eclipsen käyntiin ja uuden työympäristön (Workspacen) luotua, voimme luoda ensimmäisen projektimme.
Sinulla pitäisi olla auki Welcome-ikkuna jonka pitäisi näyttää tältä:
Paina Create a new Java project painiketta.
Sinulla kuuluisi avautua tämän näköinen ikkuna
Kirjoita Project name: kohtaan haluamasi nimi. Minä kirjoitan siihen Tutoriaali.
Nyt meidän täytyy luoda "package" johon kirjoitamme Classimme.
Sen voit tehdä oikeaklikkaamalla projektistasi src -> New -> Package .
Nyt sinulla kuuluisi olla tälläinen ikkuna:
Nyt Name: kohtaan kirjoitetaan packagen nimi.
Hyvä nimi on esimerkiksi me.<nimesi>.<plugininnimi>.
Minä laitan nytten packagen nimeksi me.raikas.tutoriaali.
Noin, olemme saaneet luotua packagen, tarvitsemme enään "Classin" tai luokan.
"Classin" voit luoda oikeaklikkaamalla luomastamme packagesta ja painaa New -> Class.
Sinulle kuuluisi avautua tälläinen ikkuna:
Nyt voit kirjoittaa Name: kohtaan vaikka Main.
Itse laitan siihen Main.
Näin! Nyt meillä on Luokka tai Class.
Nyt meidän täytyy lisätä palvelintiedosto projektiimme.
Se tehdään oikeaklikkaamalla ja valitsemalla Build Path -> Add External Archives ja valitse palvelimesi tiedosto.
Näin, nyt sinulla pitäisi olla Spigotin/Bukkitin API käytössäsi. Nyt sinun täytyy kirjoittaa Main-classiisi seuraava:
Näin, nyt Spigot tietää että tämä on JavaPlugin Classi.
Nyt lisäämme onEnable() ja onDisable() funktiot.
Noin, nyt varmasti haluat tehdä komennon?
Noh, minä opetan. Lisäämme onCommand() funktion, jonka Spigot laukaisee joka kerta kun sinun pluginisi rekisteröimä komento tehdään.
Näin, nyt olemme saaneet komennon, joka toimii /testi. Nyt meidän täytyy tehdä plugin.yml että Spigot/Bukkit osaa ymmärtää, että tämä on lisäosa.
Oikeaklikkaa projektiasi ja mene New -> File kirjoita File name: kohtaan plugin.yml
Kirjoita nyt plugin.yml tiedostoon seuraava, ja muokkaa tarvittaessa:
Näin, nyt voimme viedä pluginimme .jar tiedostoksi.
Oikeaklikkaa projektiasi ja mene kohtaan Export. Sinulle avautuu uusi valikko, avaa kohta Java ja valitse JAR file.
Nyt pitäisi avautua seuraava ikkuna:
Paina Brose... nappia ja valitse palvelimesi plugins kansio ja kirjoita pluginin nimi (Pluginin nimi).jar
Nyt paina Finish.
Näin, käynnistä palvelimesi uudelleen ja uusi pluginisi pitäisi toimia.
Jos tuli kysyttävää niin ilman muuta vastaan! Ota rohkeasti yhteys!
Nyt alkuun, tarvitset Spigotin tai Bukkitin palvelintiedoston (spigotin tiedosto usein muotoa spigot-1.xx.x.jar) sekä jonkun IDEn jolla ohjelmoimme. Tässä tutoriaalissa käytämme Eclipseä jonka voit ladata osoitteesta https://www.eclipse.org/downloads/.
Kun olet saanut Eclipsen käyntiin ja uuden työympäristön (Workspacen) luotua, voimme luoda ensimmäisen projektimme.
Sinulla pitäisi olla auki Welcome-ikkuna jonka pitäisi näyttää tältä:
Paina Create a new Java project painiketta.
Sinulla kuuluisi avautua tämän näköinen ikkuna
Kirjoita Project name: kohtaan haluamasi nimi. Minä kirjoitan siihen Tutoriaali.
Nyt meidän täytyy luoda "package" johon kirjoitamme Classimme.
Sen voit tehdä oikeaklikkaamalla projektistasi src -> New -> Package .
Nyt sinulla kuuluisi olla tälläinen ikkuna:
Nyt Name: kohtaan kirjoitetaan packagen nimi.
Hyvä nimi on esimerkiksi me.<nimesi>.<plugininnimi>.
Minä laitan nytten packagen nimeksi me.raikas.tutoriaali.
Noin, olemme saaneet luotua packagen, tarvitsemme enään "Classin" tai luokan.
"Classin" voit luoda oikeaklikkaamalla luomastamme packagesta ja painaa New -> Class.
Sinulle kuuluisi avautua tälläinen ikkuna:
Nyt voit kirjoittaa Name: kohtaan vaikka Main.
Itse laitan siihen Main.
Näin! Nyt meillä on Luokka tai Class.
Nyt meidän täytyy lisätä palvelintiedosto projektiimme.
Se tehdään oikeaklikkaamalla ja valitsemalla Build Path -> Add External Archives ja valitse palvelimesi tiedosto.
Näin, nyt sinulla pitäisi olla Spigotin/Bukkitin API käytössäsi. Nyt sinun täytyy kirjoittaa Main-classiisi seuraava:
Main.java:
package me.<nimi>.<pluginin nimi>;
import org.bukkit.plugin.java.JavaPlugin;
public class Main extends JavaPlugin {
}
Nyt lisäämme onEnable() ja onDisable() funktiot.
Java:
package me.<nimi>.<pluginin nimi>;
import org.bukkit.plugin.java.JavaPlugin;
public class Main extends JavaPlugin{
public void onEnable() {
getLogger().info("Plugin on nyt päällä");
}
public void onDisable() {
getLogger().info("Plugin on nyt sammutettu");
}
}
Noin, nyt varmasti haluat tehdä komennon?
Noh, minä opetan. Lisäämme onCommand() funktion, jonka Spigot laukaisee joka kerta kun sinun pluginisi rekisteröimä komento tehdään.
Java:
package me.<nimi>.<pluginin nimi>;
import org.bukkit.command.Command;
import org.bukkit.command.CommandSender;
import org.bukkit.entity.Player;
import org.bukkit.plugin.java.JavaPlugin;
public class Main extends JavaPlugin{
public void onEnable() {
getLogger().info("Plugin on nyt päällä");
}
public void onDisable() {
getLogger().info("Plugin on nyt sammutettu");
}
@Override
public boolean onCommand(CommandSender sender, Command cmd, String label, String args[]) {
if(!(sender instanceof Player)) {
sender.sendMessage("Konsoli ei voi suorittaa komentoja!");
return false;
}
if (cmd.getName().equalsIgnoreCase("testi")) {
Player player = (Player) sender;
player.sendMessage("Teit juuri testikomennon.");
}
return false;
}
}
Näin, nyt olemme saaneet komennon, joka toimii /testi. Nyt meidän täytyy tehdä plugin.yml että Spigot/Bukkit osaa ymmärtää, että tämä on lisäosa.
Oikeaklikkaa projektiasi ja mene New -> File kirjoita File name: kohtaan plugin.yml
Kirjoita nyt plugin.yml tiedostoon seuraava, ja muokkaa tarvittaessa:
YAML:
name: Tutoriaaliplugin
description: Tämä on plugini!
version: 1.0
main: me.<nimi>.<pluginin nimi>.Main
commands:
testi:
description: Testikomento
Oikeaklikkaa projektiasi ja mene kohtaan Export. Sinulle avautuu uusi valikko, avaa kohta Java ja valitse JAR file.
Nyt pitäisi avautua seuraava ikkuna:
Paina Brose... nappia ja valitse palvelimesi plugins kansio ja kirjoita pluginin nimi (Pluginin nimi).jar
Nyt paina Finish.
Näin, käynnistä palvelimesi uudelleen ja uusi pluginisi pitäisi toimia.
Jos tuli kysyttävää niin ilman muuta vastaan! Ota rohkeasti yhteys!