Paper/README.md

Paper

High performance Spigot fork that aims to fix gameplay and mechanics inconsistencies.

IRC Support and Project Discussion

Documentation

Access the paper docs here: paper.readthedocs.org

How To (Server Admins)

Paperclip is a jar file that you can download and run just like a normal jar file.

Download a copy of Paperclip.jar from our buildserver here: https://ci.destroystokyo.com/job/PaperSpigot/

Run the Paperclip jar directly from your server. Just like old times

Paper requires Java 8 or above.

How To (Compiling Jar From Source)

To compile Paper, you need JDK 8, maven, and an internet connection.

Clone this repo, run ./build.sh --jar from bash, get files.

Leave off --jar if you only wish to resync your checkout and not create a paperclip jar file just yet.

How To (Pull Request)

Clone this repo, run ./build.sh from bash, get files.

Load Paper-API and Paper-Server into your IDE, make changes.

Commit your changes in each retrospective folder.

If you are editing a previous patch, commit, and then use git rebase -i upstream/upstream and then move your commit line to the commit you are editing and use code "f" or "s"

Once your commit is in place, cd back into Paper folder, and type ./rebuildPatches.sh

You should now see either a new patch or an edited patch in your git status

Now, write a commit message for the patch files. For new patches, you can just repeat the commit message used in the patch commit itself, but if editing, explain what the change to the patch is.

now git checkout -b someBranchName, then git remote add myorigin git@github.com:myname/Paper and git push myorigin someBranchName and then proceed to PR.

Special Thanks To:

YourKit, makers of the outstanding java profiler, support open source projects of all kinds with their full featured Java and .NET application profilers. We thank them for granting Paper an OSS license so that we can make our software the best it can be.