Spigot Patcher

Nov 1, 2016
Spigot Patcher
  • Spigot Patcher

    Patching your Spigot build with the latest changes

    Spigot Patcher is no longer required in the official CraftBukkit/Spigot 1.8; 1.9; 10. For instruction on how to compile the latest CraftBukkit/Spigot 1.10, please visit the Spigot Installation Guide.
    These tools are no longer available or supported.
    Spigot Patcher is a tool that is used to update the last public build #1649 with latest updates.
    Spigot updates will come in the form of binary patches. These patches will be issued nightly, based on the day’s current date, and will contain a summary of all changes issued since build #1649.

    What are binary patches?(top)

    Binary patches are a safe method of distributing and applying updates as they do not contain any copyrighted code, and are something which have been pioneered within the ROMhacking / homebrew community for over twenty years. In order to apply these patches you will need the special Spigot specific tool named “SpigotPatcher”, which you may download from the links below. The patching format is currently based on the beat or BPS-1 specification, however this is subject to change, and as such you should always use the official tool we have provided.


    You can check the checksum of your files by uploading them to onlinemd5.com

    How to apply the patches(top)

    Below are instructions for how to apply the patches on your particular operating system.


    1. Download the Spigot Patcher (here) and the patch file (here).
    2. Place all downloaded files into a new folder, for example patcher within your Downloads folder. Ensure that your copy of Spigot build #1649 is placed in the same directory.
    3. Open CMD (easiest way is to press Windows Key + R and type cmd.exe followed by enter)
    4. Type the following command, presuming the files are stored in C:\Users\<user>\Downloads\patcher
      Code (Text):
      cd Downloads/patcher
    5. Now type the following to patch your Spigot build
      Code (Text):
      java -jar SpigotPatcher-1.0.jar spigot-1649.jar spigot-20140909a.bps spigot-patched.jar
      In this case, we've named our Spigot build "spigot-1649.jar" and chosen the output to be "spigot-patched.jar".
    6. Your build will now be patched and saved under the name "spigot-patched.jar". If you see something similar to the below screenshot, you have successfully patched.

    Mac OS X(top)

    1. Download the Spigot Patcher (here) and the patch file (here).
    2. Place all of the files in a new directory dedicated to Spigot.
    3. Open Terminal and enter your directory you made. For example, you can make a folder called "tmp" in the Downloads folder. To enter the folder in Terminal, type the following:
    Code (Text):
    cd Downloads/tmp/
    4. Now, type into Terminal:
    Code (Text):
    java -jar SpigotPatcher-1.0.jar spigot-1649.jar spigot-20140909a.bps spigot-patched.jar
    5. Congratulations! You successfully applied the Spigot patch! The spigot-patched.jar file will appear in "tmp" after you run the above command.



    These instructions assume you have ssh access to your linux server.
    In your shell, create a spigotwork folder under /home , we will use this folder to do our patch work.
    • cd /home
    • mkdir spigotwork
    • cd spigotwork
    Use wget to get the patch jar and patch bps files.
    • Copy the spigot1649.jar into the folder the folder
    • In your spigotwork folder you should now have 3 files:
    • [​IMG]
    • Run the command:
      • Code (Text):
        java -jar /home/spigotwork/SpigotPatcher-1.0.jar /home/spigotwork/spigot1649.jar /home/spigotwork/spigot-20140909b.bps /home/spigotwork/spigot-patched.jar
      • The output should look like this:
      • [​IMG]
      • You will now have spigot-patched.jar in the folder too. This is the file you will now run on your server.
    • Copy spigot-patched.jar to your server folder
    • Rename it to your desired name
    • Stop and Restart your spigot server
    • Type /version and you should get:
      • "This server is running CraftBukkit version git-Spigot-1.7.9-R0.2-204-g534549b"
    If you wish you can put the command into a sh script to make running it multiple times easier.
    Open you favorite editor:

    Example for Vi:
    • vi fixspigot.sh
      • press insert (to start insert mode)
      • Type in the following command line:
      • Code (Text):
         java -jar /home/spigotwork/SpigotPatcher-1.0.jar /home/spigotwork/spigot1649.jar /home/spigotwork/spigot-20140909a.bps /home/spigotwork/spigot-patched.jar
      • press [Esc]
      • press :
      • press x [ENTER]
    Example for Nano:
    • nano fixspigot.sh
      • Type in the following command line:
      • Code (Text):
         java -jar /home/spigotwork/SpigotPatcher-1.0.jar /home/spigotwork/spigot1649.jar /home/spigotwork/spigot-20140909a.bps /home/spigotwork/spigot-patched.jar
      • press ctrl-o and press [ENTER] to save
      • press ctrl-x to exit
    • You should now be back at the command prompt.
    • Make the script runnable by typing: chmod +x fixspigot.sh
    • Now you can run it with this command:
      • ./fixspigot.sh
  • Loading...
  • Loading...