TemplatePlugin

Description

Get your Mindustry plugin started with this awesome template repository, it features :

• Jitpack support.

• GitHub actions for easier testing (the plugin is built for each commit and pull request).

• Toxopid Gradle plugin for faster Mindustry development.

• Indra Gradle plugin for easier Java development.

  • This template also comes with indra.license-header to apply the project license in every source file.

• Jar bundling and automatic shading with the Shadow gradle plugin.

  • The default shaded dependencies location is (rootpackage).shadow (example: fr.xpdustry.template.shadow).

  • The bundled jar is stripped from every unused classes.

Building

• ./gradlew jar for a simple jar that contains only the plugin code.

• ./gradlew shadowJar for a fatJar that contains the plugin and its dependencies (use this for your server).

Testing

• ./gradlew runMindustryClient: Run Mindustry in desktop with the plugin.

• ./gradlew runMindustryServer: Run Mindustry in a server with the plugin.

Running

This plugin runs on Java 17 and is compatible with Mindustry V6 and V7.

Nice tips

• When using this template, don't forget to :

  • Change plugin.json and gradle.properties.

  • Update LICENSE.md and LICENSE_HEADER.md with your name or replace them with your own license.

    if you do replace the license, change also the license property in the indra configuration of the build script, more info in the Indra wiki.

  • Reset CHANGELOG.md.

• The changelog can be automatically generated to a draft release by the release-drafter workflow using the conventional commit specification. When publishing the release, the changelog will be automatically committed to the CHANGELOG.md file.

• If you want to expose some of your plugin dependencies, or you are using SQL drivers, you will have to shade all your dependencies manually by replacing :

  val relocate = tasks.create<ConfigureShadowRelocation>("relocateShadowJar") {
      target = tasks.shadowJar.get()
      prefix = project.property("props.root-package").toString() + ".shadow"
  }
  
  tasks.shadowJar {
      dependsOn(relocate)
      minimize()
  }

  With :

  tasks.shadowJar {
      val shadowPackage = project.property("props.root-package").toString() + ".shadow"
      // Put the internal dependencies here
      relocate("com.example.artifact1", "$shadowPackage.artifact1")
      relocate("com.example.artifact2", "$shadowPackage.artifact2")
      minimize {
          // Put the exposed dependencies and sql drivers here
          exclude(dependency("com.example:artifact3:.*"))
          exclude(dependency("com.example:some-sql-driver:.*"))
      }
  }