使用简单的指令构建 CraftBukkit 和 Spigot

发表于 | 分类于

BuildTools

使用简单的指令构建 CraftBukkit 和 Spigot “转载自SpigotWIKI”

索引

什么是BuildTools？(回索引)

BuildTools.jar是在你的计算机上构建Bukkit，CraftBukkit，Spigot和Spigot-API的必要工具！


但是要使用BuildTools还需要几个必备的工具，接下来将指导你完成BuildTools的使用！

前置软件(回索引)

要使用BuildTools，你必须要有两个应用程序，他们分别是 **Git** 和 **Java** 下面会介绍详细的下载地址！

Windows(回索引)

此处介绍的是手动步骤，如果你需要一个自动的方法，请访问这里(工具页面)。

Git——为了让BuildTools在Windows上运行，你需要安装GIt。你可以在这里下载到针对于Windows的分布式 git-scm 。安装它之后它将提供Git Bash，Git Bash将用来运行BuildTools.jar。请务必下载以便进行下面的步骤！

Java——在此处下载Jre8，以用来运行jar。请务必下载以便进行下面的操作！

Linux(回索引)

Linux获得 Git 和 Java 可以使用系统的包管理器，通过一个简单的命令来获取。
Debian/Ubuntu ：

sudo apt-get install git openjdk-7-jre-headless tar

Centos/RHEL ：
sudo yum install git java-1.7.0-openjdk-devel tar

Arch：
pacman -S jdk8-openjdk git

Mac(回索引)

Git下载：这里

Java可能需要从苹果分布式版本更新,即使之前更新,可能需要与外壳使用。

请按照这里的步骤进行操作!


运行BuildTools(回索引)

  1. 下载BuildTools.jar（原址，百度网盘）
  • 保持关注官方的构建站或者关注本站，以获得最新的BUG修复及更新
  • 如果你想要通过命令行下载这个，请使用
     curl -o BuildTools.jar [url]
    或
    wget -O BuildTools.jar [url]
    来下载，Url请使用上文官方的地址！

  • 空格和感叹号可能会影响BuildTools的正常工作，请jar文件名内不要添加空格及感叹号！2. 如果你使用Linux，请打开你的终端，如果是Windows请打开git bash。

  • Git bash可以在你的桌面或者开始菜单中找到！3. 找到BuildTools的位置，或者使用命令行将BuildTools下载到你的当前目录

  • 在Windows，你可以使用 cd 命令来更改目录，也可以右键单击BuildTools.jar并选择“git bash”，这将在当前目录中打开它。4. 使用终端/命令行运行BuildTools。（不要双击jar文件！！！）

  • Linux中在终端使用

    git config –global –unset core.autocrlf
    ,之后再在bash中输入
    java -jar BuildTools.jar

  • 在Windows中，在“git bash”中输入
    java -jar BuildTools.jar
    （需要使用BuildTools#35之后的版本，旧版本无法工作！）
  • 在Mac中，使用以下指令：
    export MAVEN_OPTS=”-Xmx2G” java -Xmx2G -jar BuildTools.jar

  • 可用选项（所有系统通用）：5. （可选）Windows可以使用下面的代码创建一个批处理文件（.bat）以进行自动化安装

    1. @echo off
set startdir=%~dp0
set bashdir="C:\Program Files (x86)\Git\bin\bash.exe"
%bashdir% --login -i -c "java -jar ""%startdir%\BuildTools.jar"""
pause
    2. 这个批处理将在git bash中运行
      java -jar BuildTools.jar
      ,请确保上方批处理中的bashdir变量路径是正确的（他可能根据你的系统不同在不同位置，取决你Git的存放位置）
    3. 如果你要获得其他的版本，请将批处理中的
      %bashdir% –login -i -c “java -jar “”%startdir%\BuildTools.jar
      改变成
      %bashdir% –login -i -c “java -jar “”%startdir%\BuildTools.jar”” –rev

    4. 接下来就是等待~，经过一段时间他就会在你的文件夹内生成新编译的Jar~
  1. 构建完成后，你的BuildTools.jar所在的文件夹将会生成（crafterbukkit1.8.jar和spigot-1.8.jar），以及源码和API。

  2. 享受你的新服务端吧！

    1. 需要帮助？——》如何运行一个服务器：点击这里
    2. 如何更新BuildTools？——》无需打开浏览器：点击这里

版本(回索引)

下面举出使用获取版本的选项栗子

java -jar BuildTools.jar –rev 1.8

  • 这个是获取1.8版本Bukkit和Spigot的方法

    • java -jar BuildTools.jar –rev 1.8.3

  • 这个是获取1.8.3版本Bukkit和Spigot的方法

    • java -jar BuildTools.jar –rev latest

  • 这个是获取最新版本Bukkit和Spigot的方法


    • 常见问题和解决方法(回索引)

    • 有一个错误：acobe.exe or jacobe being missing from BuildData/bin
      • 升级你的BuildTools.jar
    • BuildTools抛出了错误：java.io.FileNotFoundException:BuildData/mappings/bukkit-1.8-cl.csrg
      • 升级到最新的BuildTools来解决错误
    • Exception in thread “main” org.eclipse.jgit.api.errors.TransportException
      • BuildTools无法建立安全的连接到Git，有可能是你的杀毒软件禁止了，请添加https://hub.spigotmc.org 和 BuildTools.jar的文件夹 到你的杀毒软件白名单，或者暂时退出杀毒软件
    • Spigot’s applyPatches.sh says “/bin/bash^M: bad interpreter”

    • Spigot’s applyPatches.sh says “line 2: $’\r’: command not found”

      • 这个错误一般发生在Linux（Windows偶尔发生），原因是你的Git启用了自动编号，请执行
        git config –global –unset core.autocrlf
        来修复错误，之后重新运行BuildTools

    • Spigot’s applyPatches.sh says “fatal: sha1 information is lacking or useless”

    • Spigot’s applyPatches.sh says “Patch failed at …”
      • 这个错误发生在Windows上，如果Git设置自动编号为false，请执行
        git config –global –replace-all core.autocrlf true
        来修复错误，之后重新运行BuildTools
    • Failed to create log file: BuildTools.log.txt
    • Exception in thread “main” org.eclipse.jgit.api.errors.JGitInternalException: Creating directories…
      • 确保你有权限使用和运行BuildTools
    • [ERROR] … The import gnu.trove…. cannot be resolved
      • 有些杀毒软件会导致这个错误！请禁用杀毒软件！
      • 如果禁用后任有问题，请清除本地的Maven资源库中的.m2文件夹,然后将BuildTools放到一个空的文件夹再次执行
    • （针对Windows10用户） fatal error in forked process - fork: can’t reserve memory for parent stack
      • 产生的原因是使用了Git的64位版本，请更换成32位Git并重新运行BuildTools
    • Git bash 的 Windows版本不允许你选择文本
      • 点击左上角的git bash > properties > enable QuickEdit mode > OK 即可

    工具(回索引)

    由DemonWav 提供的 BuildToolsGUI

    BuildToolsGUI是一个在Windows平台上的可运行程序，它兼容Win Vista，7，8，8.1，10。他将会自动运行BuildTools，目前还是实验阶段，但是他可以正常的运行，BuildToolsGUI需要你的电脑安装.NET4.5

    BuildToolsGUI会在每次启动时自动更新，你可以在这里下载到他，可以在这里查看源代码

    ShellBT by Byteflux and __0x277F

    Wanting to get started contributing to Spigot? Want to look through the Minecraft source? Well, this is a shell-script alternative to BuildTools. Simply clone this repo and execute ./build.sh! It’s that easy! All credit for the scripts goes to Byteflux, I (__0x277F) just modified it a bit.


    故障排除和支持(回索引)

    如果在运行BuildTools时产生了其他的错误，请在此帖进行回复！