SDK Installation

Add ILicence v1.3.0 to your Minecraft plugin project. We support Maven and Gradle.

Requirements

Java Version

17 or later

Paper API

1.21.0 or compatible

Build Tool

Maven 3.6+ or Gradle 7+

Network

HTTPS access to ilicence.ch

Maven Setup

Step 1: Add Repository

Add the IrixiaGroup repository to your pom.xml:

pom.xml

xml

<repositories>
    <repository>
        <id>irixia-releases</id>
        <url>https://repo.irixiagroup.ch/releases</url>
    </repository>
</repositories>

Step 2: Add Dependency

Then add the ILicence SDK dependency:

pom.xml

xml

<dependency>
    <groupId>ch.irixiagroup</groupId>
    <artifactId>ilicence-sdk</artifactId>
    <version>1.3.0</version>
    <scope>compile</scope>
</dependency>

Maven Shade

If you use maven-shade-plugin, ILicence will be shaded into your JAR automatically. No additional configuration needed.

Gradle Setup

Add the repository and dependency to your build.gradle.kts or build.gradle:

build.gradle.kts

kotlin

dependencies {
    implementation 'ch.irixiagroup:ilicence-sdk:1.3.0'
}

repositories {
    maven {
        url = uri("https://repo.irixiagroup.ch/releases")
    }
}

Verify Installation

After building your JAR, verify ILicence was included:

jar tf target/YourPlugin.jar | grep ilicence

# You should see output like:
# ch/irixiagroup/ilicence/ILicence.class
# ch/irixiagroup/ilicence/ILicenceBuilder.class
# ... more classes ...

Size check

ILicence adds approximately 100KB to your JAR. If the SDK doesn't appear, check your pom.xml or build.gradle configuration.

Next Steps

Get Your License Key

Add to config.yml

Store your license key in your plugin's config file (never hardcode it).

Call ILicence.verify()

In your plugin's onEnable(), verify the license and disable if invalid.

Test Locally

Run your plugin on a local server to test the integration.

Troubleshooting

Maven can't find ch.irixiagroup:ilicence-sdk

Ensure the repository is added to pom.xml before the dependency. Clear Maven cache: mvn clean install

ILicence.class not found at runtime

Check that ILicence is shaded into your final JAR. Verify with: jar tf target/YourPlugin.jar | grep ilicence

ClassNotFoundException when loading plugin

Make sure you're using Java 17+. Some Paper versions are built for Java 21. Check your server's Java version.

Plugin won't disable even when license is invalid

Make sure you're calling getServer().getPluginManager().disablePlugin(this) in the onInvalid callback or onEnable if verification fails.

Version Info

Current Version

1.3.0 (stable)

Changelog

v1.3.0: Initial release with heartbeat & grace period
Future: WebHook callbacks, offline mode enhancements

Support

Questions? Open an issue on GitHub or contact [email protected]