bukkit Tutorial
Iniziare con bukkit

Osservazioni

Versioni

Creare un plugin

Prerequisiti

• JDK 7 o superiore (consigliato: JDK 8+)

Aggiunta di Bukkit come dipendenza

Il metodo più semplice per aggiungere l'API Bukkit al progetto è scaricare Bukkit.jar direttamente dal repository Spigot e aggiungerlo al classpath del progetto. Le versioni legacy di Bukkit possono essere trovate nel Bukkit Repository .

L'altro è aggiungerlo come dipendenza Maven, aggiungendo le seguenti linee al tuo pom.xml :

<repositories>
    <repository>
        <id>spigot-repo</id>
        <url>https://hub.spigotmc.org/nexus/content/repositories/snapshots/</url>
    </repository>
</repositories>
<dependencies>
    <!--Bukkit API-->
    <dependency>
        <groupId>org.bukkit</groupId>
        <artifactId>bukkit</artifactId>
        <version>{VERSION}</version>
        <scope>provided</scope>
    </dependency>
</dependencies>

Classe principale

La classe principale del plugin è il punto di ingresso per Bukkit per caricare un'interazione con il tuo plug-in. È una classe che estende JavaPlugin e solo una sua istanza dovrebbe essere creata dal tuo plugin. Per convenzione è bene dare a questa classe lo stesso nome del plugin.

Ecco un esempio di una classe plugin principale per il plugin "MyPlugin":

package com.example.myplugin; //{$TopLevelDomain}.{$Domain}.{$PluginName};

import org.bukkit.plugin.java.JavaPlugin;

public final class MyPlugin extends JavaPlugin {

    @Override
    public void onEnable() {
        //Called when the plugin is enabled
        getLogger().info("onEnable has been invoked!");
    }

    @Override
    public void onDisable() {
        //Called when the plugin is disabled
        getLogger().info("onDisable has been invoked!");
    }

}

Per accedere all'istanza del plug-in da un'altra classe, è necessario memorizzare l'istanza della classe MyPlugin creata da Bukkit in modo che sia accessibile dall'esterno della classe.

public class MyPlugin extends JavaPlugin {

    private static MyPlugin instance; //Effectively final variable containing your plugin's instance

    public MyPlugin(){
        if(MyPlugin.instance != null) { //Unnecessary check but ensures your plugin is only initialized once.
            throw new Error("Plugin already initialized!");
        }

        MyPlugin.instance = this; //A plugin's constructor should only be called once
    }

    public static MyPlugin getInstance(){ //Get's your plugin's instance
        return instance;
    }

    //your other code...
}

Quindi, per accedere alla tua classe principale da un'altra classe, usa semplicemente MyPlugin.getInstance()

public class MyOtherClass {

    public void doSomethingWithMainClass(){
        MyPlugin.getInstance().getLogger().info("We just used MyPlugin");
    }

}

Creare un plugin.yml

Il file plugin.yml viene inserito nella radice del file jar finale e fornisce a Bukkit informazioni essenziali per caricare il plug-in. Il plugin.yml più semplice ha questo aspetto

name: {$PluginName}               //The name of the plugin
main: {$PackageName}.{$MainClass} //The fully qualified name of the main class.
version: {$Version}               //The plugin's version

Ad esempio con la classe MyPlugin sopra

name: MyPlugin
main: com.example.myplugin.MyPlugin
version: 1.0

Creare un server di prova su Windows

Per essere in grado di creare un server, è necessario avere il rubinetto o il file jar di bukkit. Riesegui l'accesso all'argomento delle versioni per selezionare il tuo jar

1. Innanzitutto, crea una nuova cartella. In quella cartella, inserisci il file jar di spigot / bukkit.
2. Fare clic con il tasto destro del mouse nella cartella e selezionare Nuovo> Documento di testo.
3. Denominare il nuovo documento start.bat, fare clic con il pulsante destro del mouse e fare clic su Modifica.
4. Aggiungi il seguente codice:

@echo off
java -Xms512M -Xmx1G -XX:+UseConcMarkSweepGC -jar {YOUR_JAR.jar}
pause

Non dimenticare di cambiare {YOUR_JAR.jar} per il barattolo scaricato prima di iniziare questi argomenti.

5. È possibile modificare -Xms per modificare la RAM minima consentita (Es: -Xms1024M = 1024 MB, -Xms1G = 1 GB). È inoltre possibile modificare -Xmx per modificare la RAM massima consentita. Assicurati che il massimo sia più grande del minimo.
6. Salva il file, chiudi la finestra e avvia il file start.bat . Il tuo server dovrebbe ora aprirsi. Per eseguire il server, è necessario accettare l' EULA .
7. Se accetti l' EULA , apri eula.txt cambia eula=false in eula=true Fai clic su "Salva" e ora dovresti essere in grado di avviare il tuo server.
8. Per connettersi al server, eseguire start.bat , aprire Minecraft, aggiungere un server e inserire localhost come IP.

buildtools

Che cos'è?

BuildTools.jar è una soluzione per la creazione di Bukkit, CraftBukkit, Spigot e Spigot-API. Tutto ciò è fatto sul tuo computer! Sono necessari alcuni programmi prerequisiti, ma le istruzioni seguenti ti guideranno attraverso tutto ciò che devi fare.

Prerequisiti

Ci sono due applicazioni necessarie per usare BuildTools: Git e Java.

finestre

Idiota

Affinché BuildTools possa essere eseguito su Windows, è necessario installare Git. Per Windows è distribuito tramite git-scm, che può essere scaricato qui . Installalo dove preferisci, fornirà git bash, che verrà usato per eseguire il jar BuildTools. Continua a colpire quando esegui il programma di installazione.

Giava

Scarica JRE 8 da qui e installa. Continua a colpire quando esegui il programma di installazione.

Linux

Sia git che Java, così come i comandi util, possono essere installati utilizzando un singolo comando tramite il gestore pacchetti.

Debian / Ubuntu: sudo apt-get install git openjdk-7-jre-headless tar

CentOS / RHEL: sudo dnf install git java-1.7.0-openjdk-devel tar

Arco: pacman -S jdk8-openjdk git

Mac

Git può essere scaricato da: http://sourceforge.net/projects/git-osx-installer/files/

Potrebbe essere necessario aggiornare Java dalla versione distribuita di Apple e, anche se precedentemente aggiornato, potrebbe essere necessario collegarsi per l'utilizzo della shell. Si prega di seguire i passaggi trovati qui: https://gist.github.com/johan/10590467

Esecuzione di BuildTools

1. Scarica BuildTools.jar da https://hub.spigotmc.org/jenkins/job/BuildTools/lastSuccessfulBuild/artifact/target/BuildTools.jar .

2. Apri il tuo terminale se sei su Linux o git bash su Windows.

   1. Git bash può essere trovato sul desktop o nel menu Start sotto il nome "git bash". È anche possibile aprirlo facendo clic con il pulsante destro del mouse su qualsiasi cosa, poiché ora è un elemento nel menu di scelta rapida.

3. Passare al punto in cui è stato scaricato BuildTools.jar oppure utilizzare il metodo della riga di comando per scaricare il jar nella directory corrente.

   1. Su Windows, puoi usare il comando cd per cambiare directory, oppure puoi fare clic destro sullo spazio vuoto della cartella dove è BuildTools.jar (NON fare clic su BuildTools.jar) e fare clic su "git bash", che lo aprirà nella tua directory attuale.

4. Esegui BuildTools.jar dal terminale (non fare doppio clic su BuildTools.jar) nel modo seguente:

   1. Su Linux esegui git config --global --unset core.autocrlf, quindi esegui java -jar BuildTools.jar in bash o in un'altra shell appropriata.
   2. Su Windows, esegui il seguente comando all'interno della finestra di git bash che si apre: java -jar BuildTools.jar Tieni presente che è necessario che tu abbia BuildTools # 35 o successivo, le versioni precedenti non funzioneranno.
   3. Su Mac esegui i seguenti comandi, esporta MAVEN_OPTS = "- Xmx2G" java -Xmx2G -jar BuildTools.jar
   4. Se hai bisogno di una versione precedente, puoi specificare la versione usando l'argomento --rev a BuildTools, ad esempio per 1.8.8: java -jar BuildTools.jar --rev 1.8.8

5. Aspetta mentre costruisce i tuoi vasi. In pochi minuti dovresti avere dei vasetti appena compilati!

6. Puoi trovare CraftBukkit e Spigot nella stessa directory in cui hai eseguito BuildTools.jar (per Minecraft versione 1.10, sarebbero craftbukkit-1.10.jar e spigot-1.10.jar). Puoi trovare Spigot-API in \ Spigot \ Spigot-API \ target \ (per minecraft versione 1.10, sarebbe spigot-api-1.10-R0.1-SNAPSHOT.jar).