bukkit учебник
Начало работы с bukkit

замечания

Версии

Создание плагина

Предпосылки

• JDK 7 или выше (рекомендуется: JDK 8+)

Добавление Буккита в зависимость

Самый простой способ добавить Bukkit API в ваш проект - загрузить Bukkit.jar непосредственно из репозитория Spigot и добавить его в путь к классу проекта. Устаревшие версии Bukkit можно найти в репозитории Bukkit .

Другой - добавить его как зависимость от Maven, добавив следующие строки в ваш 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>

Основной класс

Основной класс плагина - это точка входа Bukkit для загрузки взаимодействия с вашим плагином. Это класс, который расширяет JavaPlugin и только один его экземпляр должен быть создан вашим плагином. По соглашению хорошо дать этому классу то же имя, что и ваш плагин.

Вот пример основного класса плагина для плагина «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!");
    }

}

Чтобы получить доступ к вашему экземпляру плагина из другого класса, вам нужно будет сохранить экземпляр класса MyPlugin, созданного Bukkit, чтобы он был доступен извне класса.

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

Затем, чтобы получить доступ к вашему основному классу из другого класса, просто используйте MyPlugin.getInstance()

public class MyOtherClass {

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

}

Создание плагина.yml

Файл plugin.yml входит в корень вашего последнего файла jar и предоставляет важную информацию Bukkit для загрузки вашего плагина. Самый простой plugin.yml выглядит так

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

Например, с приведенным выше классом MyPlugin

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

Создание тестового сервера в Windows

Чтобы иметь возможность создавать сервер, вам нужно иметь палец или файл bukkit jar. Переосмыслите тему версий, чтобы выбрать свою банку

1. Сначала создайте новую папку. В этой папке поместите файл бандажа / буккита.
2. Щелкните правой кнопкой мыши в папке и выберите «Создать»> «Текстовый документ».
3. Назовите новый файл start.bat, щелкните его правой кнопкой мыши и нажмите «Изменить».
4. Добавьте следующий код:

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

Не забудьте изменить {YOUR_JAR.jar} для jar, который вы загрузили, прежде чем начинать эти темы.

5. Вы можете редактировать -Xms для изменения минимально допустимой ОЗУ (Ex: -Xms1024M = 1024MB, -Xms1G = 1GB). Вы также можете редактировать -Xmx для изменения максимально допустимой ОЗУ. Убедитесь, что максимальное значение больше минимального.
6. Сохраните файл, закройте окно и запустите файл start.bat . Теперь ваш сервер должен быть открыт. Чтобы запустить сервер, вы должны принять лицензионное соглашение .
7. Если вы согласны с EULA , откройте eula.txt change eula=false для eula=true Нажмите «Сохранить», а затем вы должны теперь запустить свой сервер.
8. Чтобы подключиться к вашему серверу, запустите start.bat , откройте Minecraft, добавьте сервер и поместите localhost в качестве IP.

инструмент сборки

Что это?

BuildTools.jar - это решение для создания Bukkit, CraftBukkit, Spigot и Spigot-API. Все это делается на вашем компьютере! Необходимо несколько предварительных программ, но приведенные ниже инструкции помогут вам в том, что вам нужно сделать.

Предпосылки

Для использования BuildTools необходимы два приложения: Git и Java.

Windows

Гит

Чтобы BuildTools запускался в Windows, вам нужно будет установить Git. Для Windows он распространяется через git-scm, который можно скачать здесь . Установите его там, где вам нравится, он предоставит git bash, который будет использоваться для запуска баннера BuildTools. Просто продолжайте работать, когда запускаете установщик.

Джава

Загрузите JRE 8 отсюда и установите. Просто продолжайте работать, когда запускаете установщик.

Linux

Как git, так и Java, а также команды утилиты могут быть установлены с помощью одной команды через диспетчер пакетов.

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

Arch: pacman -S jdk8-openjdk git

макинтош

Git можно загрузить с сайта: http://sourceforge.net/projects/git-osx-installer/files/

Возможно, Java необходимо обновить из распространенной версии Apple, и даже если она была ранее обновлена, возможно, потребуется связать ее с оболочкой. Следуйте приведенным ниже шагам: https://gist.github.com/johan/10590467

Запуск BuildTools

1. Загрузите BuildTools.jar из https://hub.spigotmc.org/jenkins/job/BuildTools/lastSuccessfulBuild/artifact/target/BuildTools.jar .

2. Откройте ваш терминал, если вы находитесь в Linux, или git bash на Windows.

   1. Git bash можно найти на рабочем столе или в меню «Пуск» под названием «git bash». Также можно открыть его, щелкнув правой кнопкой мыши на чем угодно, так как теперь это элемент в вашем контекстном меню.

3. Перейдите туда, где вы загрузили BuildTools.jar, или воспользуйтесь способом командной строки, чтобы загрузить банку в ваш текущий каталог.

   1. В Windows вы можете либо использовать команду cd для изменения каталогов, либо щелкнуть правой кнопкой мыши пустое место в папке, где находится BuildTools.jar (не нажимайте на CreateTools.jar) и нажмите «git bash», который откроет его в вашем текущем каталоге.

4. Запустите BuildTools.jar с терминала (не дважды щелкните BuildTools.jar), выполнив следующие действия:

   1. В Linux запустите git config --global --unset core.autocrlf, затем запустите java -jar BuildTools.jar в bash или другой соответствующей оболочке.
   2. В Windows запустите следующую команду в открывшемся окне git bash: java -jar BuildTools.jar. Имейте в виду, что требуется, чтобы у вас были BuildTools № 35 или более поздние версии, более старые версии не будут работать.
   3. На Mac выполните приведенные ниже команды, экспортируйте MAVEN_OPTS = "- Xmx2G" java -Xmx2G -jar BuildTools.jar
   4. Если вам нужна более старая версия, вы можете указать версию с аргументом --rev для BuildTools, например, для 1.8.8: java -jar BuildTools.jar --rev 1.8.8

5. Подождите, как он строит ваши банки. Через несколько минут вы должны иметь свежую сборку банок!

6. Вы можете найти CraftBukkit и Spigot в том же каталоге, в котором вы запускали BuildTools.jar (для версии minecraft 1.10 они были бы craftbukkit-1.10.jar и spigot-1.10.jar). Вы можете найти Spigot-API в \ Spigot \ Spigot-API \ target \ (для версии minecraft 1.10 это будет spigot-api-1.10-R0.1-SNAPSHOT.jar).