Maven Repository

Essentials can now be acquired from the Essentials Maven repository for developer use.

The repository is located at http://repo.ess3.net/ and is the official Maven repository for Essentials.

Add the repository

To add the Essentials Maven repository to your project, you need to add the following block to your pom.xml.

<repositories>
  ...
  <repository>
    <id>ess-repo</id>
    <url>http://repo.ess3.net/content/groups/essentials</url>
  </repository>
  ...
</repositories>

Other artifacts

The Essentials repository also mirrors some other repositories, such as Bukkit and Vault. If you wish to pull those artifacts from the Essentials repository too, change the URL in the repository block to http://repo.ess3.net/content/groups/public. Please note we do not provide support for any non-Essentials artifacts in our repository.

Adding Essentials as a dependency

To compile against Essentials or an Essentials module, you need to add it as a dependency. Please note that the version numbers may have updated.

If you wish to compile against a different module, replace the artifactId with its name, such as EssentialsChat.

Development Builds

For development builds, for example 2.13.x, use the following block. This will always compile against the latest 2.13.x development build.

<dependencies>
  ...
  <dependency>
    <groupId>net.ess3</groupId>
    <artifactId>Essentials</artifactId>
    <version>2.13-SNAPSHOT</version>
  </dependency>
  ...
</dependencies>

Prerelease Builds

For prerelease builds, for example Pre2.13.1.1, use the following block. This will always compile against the specified prerelease build.

<dependencies>
  ...
  <dependency>
    <groupId>net.ess3</groupId>
    <artifactId>Essentials</artifactId>
    <version>Pre2.13.1.7</version>
  </dependency>
  ...
</dependencies>

Stable Builds

For stable builds, for example 2.13.1, use the following block. This will always compile against the specified stable build.

<dependencies>
  ...
  <dependency>
    <groupId>net.ess3</groupId>
    <artifactId>Essentials</artifactId>
    <version>2.13.1</version>
  </dependency>
  ...
</dependencies>

Help

If you need assistance setting up your Maven project to compile against Essentials, please visit our IRC help chat