bukkit开始使用bukkit


备注

Bukkit是一个简单的API,允许使用插件修改正常的Minecraft多人游戏体验。

Bukkit现已停产 ,不再适用于较新版本的Minecraft。 Spigot是Bukkit的一个版本,可以提高服务器性能 。 Spigot的API与Bukkit基本相同。

版本

我的世界版 Spigot下载链接发布日期
1.10.2 链接 2016年11月3日
1.10 链接 2016年6月26日
1.9.4 链接 2016年6月9日
1.9.2 链接 2016年3月30日
1.9 链接 2016年2月29日
1.8.8 链接 2015年7月28日
1.8.7 链接 2015年6月5日
1.8.6 链接 2015年5月25日
1.8.5 链接 2015年5月22日
1.8.4 链接 2015年4月17日
1.8.3 链接 二零一五年二月二十零日
1.8 链接 2014年9月2日
1.7.10 链接 2014年6月26日
1.7.9 链接 2014年4月14日
1.7.8 - 2014年4月11日
1.7.5 链接 2014年2月26日
1.7.2 链接 2013年10月25日
1.6.4 链接 2013年9月19日
1.6.2 链接 2013年7月8日
1.5.2 链接 2013年5月2日
1.5.1 链接 2013年3月21日
1.4.7 链接 2013年1月9日
1.4.6 - 二○一二年十二月二十〇日

创建插件

先决条件

  • JDK 7或更高版本(推荐:JDK 8+)

添加Bukkit作为依赖

将Bukkit API添加到项目中的最简单方法是直接从Spigot Repository下载Bukkit.jar并将其添加到项目的类路径中。可以在Bukkit存储库中找到Bukkit的旧版本。

另一种是通过在pom.xml 添加以下行来将其添加为Maven依赖项:

<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!");
    }

}
 

要从另一个类访问您的插件实例,您需要存储由Bukkit创建的MyPlugin类的实例,以便可以从类外部访问。

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");
    }

}
 

创建一个plugin.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
 

编译工具

它是什么?

BuildTools.jar是构建Bukkit,CraftBukkit,Spigot和Spigot-API的解决方案。所有这些都在您的计算机上完成!一些必备程序是必要的,但下面的说明将指导您完成所需的一切。

先决条件

使用BuildTools需要两个应用程序:Git和Java。

视窗

混帐

为了使BuildTools在Windows上运行,您需要安装Git。对于Windows,它通过git-scm分发,可以在这里下载。将它安装在你喜欢的地方,它将提供git bash,它将用于运行BuildTools jar。在运行安装程序时,请继续按下。

Java的

这里下载JRE 8并安装。在运行安装程序时,请继续按下。

Linux的

git和Java以及util命令都可以通过包管理器使用单个命令进行安装。

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分布式版本进行更新,即使以前更新过,也可能需要链接以供shell使用。请按照此处的步骤操作: https//gist.github.com/johan/10590467

运行BuildTools

  1. https://hub.spigotmc.org/jenkins/job/BuildTools/lastSuccessfulBuild/artifact/target/BuildTools.jar下载BuildTools.jar。

  2. 如果你在Linux上打开你的终端,或在Windows上打开你的终端。

    1. 可以在桌面上或“git bash”名称下的“开始”菜单中找到Git bash。也可以通过右键单击任何内容来打开它,因为它现在是上下文菜单中的项目。
  3. 导航到您下载BuildTools.jar的位置,或使用命令行方式将jar下载到当前目录。

    1. 在Windows上,您可以使用cd命令更改目录,也可以右键单击BuildTools.jar所在文件夹的空白区域(不要单击BuildTools.jar本身)并单击“git bash”,这将打开它在您当前的目录中。
  4. 通过执行以下操作从终端运行BuildTools.jar(不要双击BuildTools.jar):

    1. 在Linux上运行git config --global --unset core.autocrlf,然后在bash或其他适当的shell中运行java -jar BuildTools.jar。
    2. 在Windows上,在打开的git bash窗口中运行以下命令:java -jar BuildTools.jar请注意,要求您使用BuildTools#35或更高版本,旧版本将无效。
    3. 在Mac上运行以下命令,导出MAVEN_OPTS =“ - Xmx2G”java -Xmx2G -jar BuildTools.jar
    4. 如果您需要旧版本,可以使用BuildTools的--rev参数指定版本,例如1.8.8:java -jar BuildTools.jar --rev 1.8.8
  1. 等等,因为它建立你的罐子。几分钟后你应该有新编的罐子!

  2. 您可以在运行BuildTools.jar的同一目录中找到CraftBukkit和Spigot(对于Minecraft版本1.10,它们将是craftbukkit-1.10.jar和spigot-1.10.jar)。您可以在\ Spigot \ Spigot-API \ target \中找到Spigot-API(对于Minecraft版本1.10,它将是spigot-api-1.10-R0.1-SNAPSHOT.jar)。

在Windows上创建测试服务器

为了能够创建服务器,您需要具有spigot或bukkit jar文件。冷却到版本主题以选择您的jar

  1. 首先,创建一个新文件夹。在该文件夹中,输入spigot / bukkit jar文件。
  2. 右键单击该文件夹,然后选择“新建”>“文本文档”。
  3. 将新文档命名为start.bat,右键单击它并单击“编辑”。
  4. 添加以下代码:
@echo off
java -Xms512M -Xmx1G -XX:+UseConcMarkSweepGC -jar {YOUR_JAR.jar}
pause
 

在开始这些主题之前,不要忘记为您下载的jar更改{YOUR_JAR.jar}。

  1. 您可以编辑-Xms 以更改允许的最小RAM(例如:-Xms1024M = 1024MB,-Xms1G = 1GB)。您还可以编辑-Xmx 以更改允许的最大RAM。确保最大值大于最小值。
  2. 保存文件,关闭窗口并启动start.bat 文件。您的服务器现在应该打开。要运行服务器,您必须接受EULA
  3. 如果您同意EULA ,请打开eula.txteula=false 更改为eula=true 单击“保存”,然后您应该能够启动服务器。
  4. 要连接到您的服务器,请运行start.bat ,打开Minecraft,添加服务器并将localhost 作为IP。