How to integrate your plugin with Oraxen

Add Oraxen to your plugin

In order to use Oraxen API, you need to add Oraxen to your dependencies. Below are repository and dependency information. Replace VERSION with the Oraxen version you wish to use. The latest release can be found here.\


With Maven

Repository (jitpack)



Because maven decides to be weird, you will need to exclude a lot of imports from Oraxen. This is not an issue when using Gradle

With Gradle Kotlin

Repository (jitpack)




With Groovy

Repository (jitpack)

maven { url 'https://jitpack.io' }


compileOnly 'com.github.oraxen:oraxen:VERSION'
All methods and better explanations of their functionality and parameters can be found in the actual Classes. Simply open them in your IDE to get a full list of them.

Examples of use

Oraxen is built around an ItemsBuilder class that allows you to create items easily. When the plugin starts it parses the configurations to generate builders for each type of items. Each builder can be used to generate itemstacks.

OraxenItems class:

Get an ItemBuilder from an OraxenID

OraxenItems.getItemById(itemID); // where itemID is a section in items configurations

Check if an OraxenID exists


Extract an OraxenID from an ItemStack

You can use to check if an ItemStack is an OraxenItem (it will return null if OraxenID doesn't exist)

Custom Blocks & Furniture

Place an OraxenBlock

Place an OraxenBlock at a given location
OraxenBlocks.place(itemID, location)
Place an OraxenFurniture at a given location, optionally setting a player for rotation purposes
OraxenFurniture.place(itemID, location, @Nullable player)

Add resources to the pack

Get access to the assets/ folder



Oraxen allows you to add your own mechanics to the plugin, it is a little bit more complex than the rest, that's why there is a dedicated tutorial.