Action-SpigotMC/README.md

Action-SpigotMC

This Action allows you to easily compile Minecraft Spigot or Paper and install it in your runners local maven repository.

Supported:

• SpigotMC (using official BuildTools or my modified one)
• PaperMC (coming soon #26)

You configure all the versions you want, and it'll compile all the missing versions automatically. By checking for a file in the local maven repository beforehand, build times can be reduces drastically.

By default, this Action uses a fork of the original BuildTools to introduce some improvements in system compatibility and speed.

Usage

Note: Use actions/cache as described here to save some additional time by caching between runs!

All the values already provided below are their default values.

If you don't change them, you can remove them from your workflow, as they are set automatically.

- uses: SpraxDev/Action-SpigotMC@v3
  with:
    # A comma-separated list of Spigot version that should be compiled
    # These values are later given to the BuildTools.jar as '--rev' argument
    #
    # Example: latest, 1.14.4, 1.8.8
    versions: latest # Optional

    # Should sources be generated?
    # If enabled, BuildTools is provided the '--generate-source' argument
    generateSrc: false # Optional

    # Should the documentation be generated?
    # If enabled, BuildTools is provided the '--generate-docs' argument
    generateDoc: false # Optional

    # Should we disable the BuildTools's Java-Version-Check?
    # If enabled, BuildTools is provided the '--disable-java-check' argument
    disableJavaCheck: false # Optional

    # Disables the check for existing files in the local maven repository
    # Normally, a version is skipped if it is already installed
    # in the local maven repository to speed up build time
    forceRun: false # Optional

    # The amount of builds allowed to run at the same time
    # Set to '-1' to use system's cpu core count
    threads: -1 # Optional

    # You can choose between different BuildTools to be used by this action
    # ~~'SpraxDev' is my fork of SpigotMC's that introduces some changes (https://github.com/SpraxDev/Spigot-BuildTools/#breaking-changes)~~
    # My (SpraxDev) provider is causing some builds to fail depending on the build environment
    # Available: SpraxDev, SpigotMC
    buildToolProvider: SpigotMC # Optional