bukkit Tutorial
Empezando con bukkit

Observaciones

Versiones

Creando un Plugin

Prerrequisitos

• JDK 7 o superior (recomendado: JDK 8+)

Añadiendo Bukkit como Dependencia

El método más sencillo para agregar la API de Bukkit a su proyecto es descargar el Bukkit.jar directamente desde el Repositorio Spigot y agregarlo a la ruta de clase de su proyecto. Las versiones heredadas de Bukkit se pueden encontrar en el Repositorio de Bukkit .

El otro es agregarlo como una dependencia de Maven, agregando las siguientes líneas a su 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>

Clase principal

La clase principal del complemento es el punto de entrada para que Bukkit cargue e interactúe con su complemento. Es una clase que extiende JavaPlugin y solo una instancia de ella debe JavaPlugin su complemento. Por convención, es bueno darle a esta clase el mismo nombre que su complemento.

Este es un ejemplo de una clase de complemento principal para el complemento "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!");
    }

}

Para acceder a su instancia de complemento desde otra clase, deberá almacenar la instancia de su clase MyPlugin creada por Bukkit para que sea accesible desde fuera de la clase.

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...
}

Luego, para acceder a su clase principal desde otra clase, simplemente use MyPlugin.getInstance()

public class MyOtherClass {

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

}

Creando un plugin.yml

El archivo plugin.yml se encuentra en la raíz de su archivo jar final y proporciona información esencial a Bukkit para cargar su complemento. El plugin.yml más simple se ve así

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

Por ejemplo, con la clase MyPlugin anterior

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

Crear un servidor de prueba en Windows

Para poder crear un servidor, necesita tener el spigot o el archivo de bukkit jar. Refiérase al tema de las versiones para seleccionar su tarro

1. Primero, crea una nueva carpeta. En esa carpeta, ponga el archivo jar spigot / bukkit.
2. Haga clic derecho en la carpeta y elija Nuevo> Documento de texto.
3. Nombre el nuevo documento start.bat, haga clic derecho sobre él y haga clic en Editar.
4. Agregue el siguiente código:

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

No olvide cambiar {YOUR_JAR.jar} para el archivo jar que descargó antes de comenzar estos temas.

5. Puede editar -Xms para cambiar la RAM mínima permitida (Ej: -Xms1024M = 1024MB, -Xms1G = 1GB). También puede editar -Xmx para cambiar la RAM máxima permitida. Asegúrese de que el máximo sea mayor que el mínimo.
6. Guarde el archivo, cierre la ventana e inicie su archivo start.bat . Su servidor debería estar abierto. Para ejecutar el servidor, debe aceptar el EULA .
7. Si acepta el EULA , abra eula.txt change eula=false a eula=true Haga clic en "Guardar" y luego debería poder iniciar su servidor.
8. Para conectarse a su servidor, ejecute start.bat , abra Minecraft, agregue un servidor y coloque localhost como IP.

BuildTools

¿Qué es?

BuildTools.jar es una solución para crear Bukkit, CraftBukkit, Spigot y Spigot-API. Todo lo cual se hace en tu computadora! Son necesarios algunos programas de requisitos previos, pero las instrucciones a continuación lo guiarán a través de todo lo que necesita hacer.

Prerrequisitos

Hay dos aplicaciones necesarias para usar BuildTools: Git y Java.

Windows

Git

Para que BuildTools se ejecute en Windows, deberá instalar Git. Para Windows se distribuye a través de git-scm, que se puede descargar aquí . Instálalo donde quieras, proporcionará git bash, que se usará para ejecutar el jar de BuildTools. Solo sigue presionando siguiente cuando ejecutes el instalador.

Java

Descarga JRE 8 desde aquí e instala. Solo sigue presionando siguiente cuando ejecutes el instalador.

Linux

Tanto git como Java, así como los comandos util, pueden instalarse usando un solo comando a través de su administrador de paquetes.

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 se puede descargar desde: http://sourceforge.net/projects/git-osx-installer/files/

Es posible que Java deba actualizarse desde la versión distribuida de Apple, e incluso si se ha actualizado anteriormente, puede que deba estar vinculado para el uso de shell. Siga los pasos que se encuentran aquí: https://gist.github.com/johan/10590467

Ejecutando BuildTools

1. Descargue BuildTools.jar desde https://hub.spigotmc.org/jenkins/job/BuildTools/lastSuccessfulBuild/artifact/target/BuildTools.jar .

2. Abra su terminal si está en Linux, o git bash en Windows.

   1. Git bash se puede encontrar en el escritorio o en el menú Inicio bajo el nombre "git bash". También es posible abrirlo haciendo clic con el botón derecho en cualquier cosa, ya que ahora es un elemento en su menú contextual.

3. Navegue hasta donde descargó BuildTools.jar, o use la forma de la línea de comandos para descargar el jar en su directorio actual.

   1. En Windows, puede usar el comando cd para cambiar directorios, o puede hacer clic derecho en el espacio en blanco de la carpeta donde está BuildTools.jar (NO haga clic en BuildTools.jar) y haga clic en "git bash", que lo abrirá en su directorio actual.

4. Ejecute BuildTools.jar desde el terminal (no haga doble clic en BuildTools.jar) haciendo lo siguiente:

   1. En Linux, ejecute git config --global --unset core.autocrlf, luego ejecute java -jar BuildTools.jar en bash u otro shell apropiado.
   2. En Windows, ejecute el siguiente comando dentro de la ventana de git bash que se abrió: java -jar BuildTools.jar Tenga en cuenta que es necesario que tenga BuildTools # 35 o posterior, las versiones anteriores no funcionarán.
   3. En Mac, ejecute los siguientes comandos, exporte MAVEN_OPTS = "- Xmx2G" java -Xmx2G -jar BuildTools.jar
   4. Si necesita una versión anterior, puede especificar la versión usando el argumento --rev para BuildTools, por ejemplo para 1.8.8: java -jar BuildTools.jar --rev 1.8.8

5. Espera ya que construye tus jarras. ¡En unos minutos deberías tener frascos recién compilados!

6. Puede encontrar CraftBukkit y Spigot en el mismo directorio donde ejecutó BuildTools.jar (para la versión 1.10 de Minecraft, serían craftbukkit-1.10.jar y spigot-1.10.jar). Puede encontrar Spigot-API en \ Spigot \ Spigot-API \ target \ (para la versión 1.10 de Minecraft, sería spigot-api-1.10-R0.1-SNAPSHOT.jar).