Gradle utilities for easier writing Bukkit plugins.

1. Apply plugin
2. Usage
   1. First steps
   2. Configuring plugin
      1. Quotes around values
   3. Repositories and Dependencies
   4. Running Dev server
      1. Server run configurations

• Automatically applies plugin: java
• Sets up compiler encoding to UTF-8
• Sets archivesBaseName to plugin name
• Supports APIs: Bukkit, CraftBukkit, Spigot, Paper
• Provides short extension functions to add common repositories and dependencies
• Generates plugin.yml from Gradle project information
• Allows running dev server from IDE
• Supports two cores for dev server: Spigot and Paper
• Automatically downloads and updates BuildTools or Paperclip
• Automatically copies your plugin to plugins dir on server running

• Add smart dependency system

BukkitGradle on plugins.gradle.org

NOTE: Gradle 5.0+ required

plugins { id "ru.endlesscode.bukkitgradle" version "0.8.2" }

buildscript { repositories { jcenter() } dependencies { classpath "gradle.plugin.ru.endlesscode:bukkit-gradle:0.8.2" } } apply plugin: "ru.endlesscode.bukkitgradle"

You can clone this example project [OUTDATED], and use it for quick start.

Simple build.gradle file that use BukkitGradle:

plugins { id "ru.endlesscode.bukkitgradle" version "0.8.2" } // Project information group "com.example" description "My first Bukkit plugin with Gradle" version "0.1" // Let's add needed API to project dependencies { compileOnly bukkit() // see section 'Dependencies' for more info }

compileOnly - it's like provided scope in Maven. It means that this dependncy will not included to your final jar. It's enough! Will be hooked latest version of Bukkit and automatically generated plugin.yml with next content:

name: MyPlugin description: My first Bukkit plugin with Gradle main: com.example.myplugin.MyPlugin version: 0.1

Main class build by pattern: <groupId>.<lower case name>.<name>

You can configure attributes that will be placed to plugin.yml:

// Override default configurations bukkit { // Version of API (if you will not set this property, will be used latest available) version = "1.12.2" // Attributes for plugin.yml meta { name = "MyPlugin" description = "My amazing plugin, that doing nothing" main = "com.example.plugin.MyPlugin" version = "1.0" url = "http://www.example.com" // Attribute website authors = ["OsipXD", "Contributors"] } }

Will be generated next plugin.yml file:

name: MyPlugin description: My amazing plugin, that doing nothing main: com.example.plugin.MyPlugin version: 1.0 website: http://www.example.com authors: [OsipXD, Contributors]

Also you can add custom (unsupported by BukkitGradle) attributes like a depend etc. Just create plugin.yml file and put custom attributes into.

In some cases you may need put meta value in quotes. For this you can use q and qq functions.

For example we have meta:

meta { name = qq "Double Quoted Name" description = q "Single quoted description" url = "http://without.quot.es/" }

And will be generated:

name: "Double Quoted Name" description: 'Single quoted description' website: http://without.quot.es/

Note: In Groovy you can use functions in two ways: normal - q("value") and without braces - q "value"

BukkitGradle provides short extension-functions to add common repositories and dependencies. There are list of its.

Usage example:

repositories { spigot() // Adds spigot repo } dependencies { compileOnly paperApi() // Adds paper-api dependency }

Some dependencies also applies repo that needed for them.

Note: $apiVersion - is ${version}-R0.1-SNAPSHOT (where $version is bukkit.version)

If you want more extension-functions - you can write issue.

Before running server you should configure dev server location.

You can define it in local.properties file (that was automatically created in project directory on refresh):

# Absolute path to dev server server.dir=/path/to/buildtools/

If you use Spigot (see bukkit.run.core) you also should specify BuildTools location. For Paper no additional actions needed.

# Absolute path to directory that contains BuildTools.jar buildtools.dir=/path/to/buildtools/

If there no BuildTools.jar it will be automatically downloaded.

TIP: you can define it globally (for all projects that uses BukkitGradle) with environment variables BUKKIT_DEV_SERVER_HOME and BUKKIT_BUILDTOOLS_HOME.

Run :buildIdeaRun task. To your IDE will be added Run Configuration that will dynamically refreshes when you change server configurations.

Run :startServer task.

To accept EULA and change settings use bukkit.run section:

bukkit { // INFO: Here used default values run { // Core type. It can be 'spigot' or 'paper' core = "spigot" // Accept EULA eula = false // Set online-mode flag onlineMode = false // Debug mode (listen 5005 port, if you use running from IDEA this option will be ignored) debug = true // Set server encoding (flag -Dfile.encoding) encoding = "UTF-8" // JVM arguments javaArgs = "-Xmx1G" // Bukkit arguments bukkitArgs = "" } }

EULA and online-mode settings in build.gradle always rewrites settings in eula.txt and server.properties