Learn How To Setup PaperSpigot on CentOS 7

December 31, 2019

Table of Contents

    If you are using a different system, please check our other tutorials.

    PaperSpigot is a high performance fork of Spigot that aims to fix gameplay and mechanics inconsistencies. Paper contains numerous unique features and changes, including many performance improvements not found in Spigot. In this guide, we will setup PaperSpigot on a CentOS 7 Server.

    Setting up the Server

    It is recommended to run all commands as a user with sudo privileges that is not root.

    Start by ensuring that your server is up to date.

    $ sudo yum update -y
    

    Install the needed packages.

    $ sudo yum install java-1.8.0-openjdk -y
    

    Create a swap file

    Allocate the desired amount of memory. Replace 1G accordingly.

    $ sudo fallocate -l 1G /swapfile
    

    Secure the permissions of your new swap file.

    $ sudo chmod 600 /swapfile
    

    Allocate the swap space.

    $ sudo mkswap /swapfile
    

    Turn on swap.

    $ sudo swapon /swapfile
    

    Make your swap file permanent by modifying the fstab file.

    $ sudo echo "/swap swap swap sw 0 0" >> /etc/fstab
    

    Install PaperSpigot

    Ensure you are in the home directory of the user you are planning to use to install PaperSpigot.

    $ cd ~
    

    Create a folder for PaperSpigot

    $ mkdir paper
    cd paper
    
    $ wget -O paperclip.jar https://ci.destroystokyo.com/job/PaperSpigot/lastSuccessfulBuild/artifact/paperclip.jar
    

    This will download the latest build of PaperSpigot. If you would like to use a different Minecraft version, replace lastSuccessfulBuild with a corresponding build number which you can find here.

    Starting your server

    Create a start up script for your server.

    $ nano start.sh
    

    Make start.sh match the following, replacing 1024M with the amount of RAM installed on your server.

    #!/bin/sh
    
    java -Xms512M -Xmx1024M -XX:MaxPermSize=128M -jar paperclip.jar
    

    Make start.sh executable.

    $ chmod +x start.sh
    

    Start your server.

    $ ./start.sh
    

    The first time you start your server, it will download files necessary to setup PaperSpigot. After the first run, your server will launch faster. You will also need to agree to the Minecraft EULA by replacing eula=false to eula=true in eula.txt

    Optional: Run your server in the background

    Install screen.

    $ sudo yum install screen -y
    

    Open an instance of screen.

    $ screen -S "paper"
    

    Start your server script.

    $ cd ~/paper
    $ ./start.sh
    

    You can now configure your server’s settings and install plugins.

    Troubleshooting

    Make sure to accept the EULA

    As mentioned previously, you will need to agree to the Minecraft EULA by changing eula=false to eula=true in eula.txt

    $ nano eula.txt
    

    Can’t run paperclip.jar

    You may need to purchase a server with more ram or you may need to increase your SWAP file.

    Need help?

    Do you need help setting up this on your own service?
    Please contact us and we’ll provide you the best possible quote!