Oraxen
Search…
All mechanics
The different mechanics available by default and their configurations sorted by category

Miscellaneous

Durability

This allows you to change the durability of an item created with Oraxen. Minecraft vanilla wasn't made to handle that kind of modifications, this is why this system is not perfect. You'll not see the good durability on your item, it will just work as a percentage. What that means is that if for example you create a pickaxe based off the wooden pickaxe (which has 59 of durability by default) and you change it to 5900, you'll still see 59 of durability on your item. But you'll need to break 100 blocks in order to lose of one durability. The cool thing is that the displayed bar will be updated correctly.

Per item configuration

There are two options available : ratio and fixed_amount. You can put only one of these two options on the same item. Ratio allows you to repair a percentage of your item (0.15 will repair 15% of maximum durability while 1.0 will repair it to 100%). Fixe amount repairs a fixed amount of your item durability (put 10 if you want to add 10 durability points to your item for example).
1
durability:
2
value: 5000 #diamond sword is 1561 by default
Copied!

Repair

This mechanic allows you to use an item to repair another one (which uses vanilla durability or oraxen custom). By default this mechanic is binded to iron, gold and diamond cogs. To use them you just need to click on the item you want to repair.

Per item configuration

1
repair:
2
ratio: 0.10 # 10%
3
fixed_amount: 10 # or 10 durability points
Copied!

Global configuration

If you enable oraxen_durability_only, this mechanic will only work with items using oraxen Durability mechanic.
1
repair:
2
enabled: true
3
oraxen_durability_only: false
Copied!

Commands

This allows you to execute commands (as the console, a player or op player). If this option is not often the most elegant it has the merit of simplifying a lot of things. You can create a cooldown between usages, check if the player has a specific permission and use the item (understand decrease its amount by one when the command is performed).

Per item configuration

1
commands:
2
cooldown: 5 # example cooldown in seconds. This is optional
3
permission: "my.awesome.perm" # required permission. This is optional
4
one_usage: true # should the amount decrease when used? Default: false
5
console:
6
# e.g. to kill the player
7
- "kill %p%"
8
player:
9
# e.g. the player performs /spawn
10
- "spawn"
11
opped_player:
12
# e.g. the player gives himself a diamond sword
13
- "give diamond_sword 1"
Copied!

PotionEffects

This allows you to bind a Potion Effect to an armor (or a hat) so that when you equip it you'll get the effect.

Per item configuration

Here is a list of all potion effect types available.
1
potioneffects:
2
night_vision: # the potion effect type
3
amplifier: 0
4
ambient: true # Makes potion effect produce more, translucent, particles.
5
particles: true # whether this effect has particles or not
6
icon: true # whether this effect has an icon or not
Copied!

Block and NoteBlock

These mechanic allows you to use an item as block. Since these are quite special mechanics, they have a dedicated tutorial page.

Aura

Do you want to show a cool particle effect when a player holds your item? The Aura mechanic is your way to go. You can find a list of available particles here: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Particle.html

Per item configuration (easy)

1
aura:
2
type: simple # available types: [ simple, ring, helix ]
3
particle: PORTAL
Copied!

Hat

Do you want to create a hat? Use this mechanic so that you'll be able to put any item on your head.

Per item configuration (easy)

1
hat:
2
enabled: true
Copied!

Skinnable

With this mechanic, you can change the texture of an item using an item with Skin mechanic.

Per item configuration

1
skinnable: {}
Copied!

ItemType

With this mechanic, you can change the item type detected by OraxenBlocks. Make sure to use a type declared inside the block mechanic.

Per item configuration

1
skinnable:
2
value: SUPER_MATERIAL # your itemType
Copied!

Soulbound

With this mechanic, you can avoid the players to lose their item when they die.

Per item configuration

1
soulbound:
2
lose_chance: 0
Copied!

Custom mechanic

This mechanic allows you to customize events, conditions and actions. Since it is a quite rspecial mechanic, it has its dedicated tutorial page.

Skin

This mechanic will allow the item to be a skin for Skinnable mechanic, skin and Skinnable item must have the same material to apply the texture.

Per item configuration

1
skin:
2
consume: true #consume 1 skin item
Copied!

Combat

Thor

Have you ever dreamed of being able to throw lightning bolts? This is for you.

Per item configuration

1
thor:
2
lightning_bolts_amount: 5
3
random_location_variation: 1.5
4
delay: 20000 # in milliseconds (20000ms = 20s)
Copied!
    lightning_bolts_amount: how many lightning bolts will be spawned?
    random_location_variation: the random variation range between bolts (in blocks)
    delay: delay between usage in milliseconds (1000ms = 1s)

Lifeleech

Want to steal hearts to your opponents when you hit them?

Per item configuration

1
lifeleech:
2
amount: 2 # the amount of 1/2 hearts that you'll steal to your opponents
Copied!

EnergyBlast

EnergyBlast is a very cool mechanic that creates a cone of particles to attack entities.

Per item configuration

1
energyblast:
2
delay: 20000
3
length: 5
4
damage: 10.0
5
particle:
6
type: REDSTONE #Only REDSTONE particle can change size and color.
7
size: 1
8
color:
9
red: 0
10
green: 255
11
blue: 255
Copied!

Witherskull

Send wither skulls when right clicking!

Per item configuration

1
witherskull:
2
charged: false # a charged skull can break blocks
3
delay: 3000 # in milliseconds (3000ms = 3s)
Copied!

Farming

Harvesting

Harvesting allows you to recolt and replant automatically wheat in a certain radius.

Per item configuration

1
harvesting:
2
cooldown: 10000 # 10 seconds between usages
3
radius: 5 # blocks surrounding the clicked block
4
height: 3 # high
Copied!

BigMining

Bigmining allows you to mine different blocks at the same time. By default this mechanic is used on the hammers and allows you to mine 3x3 square and more.

Per item configuration

1
bigmining:
2
radius: 1 # blocks surrounding the broken block
3
depth: 1
Copied!

Smelting

Smelting allows you to instantly melt iron and gold ores when you mine them. This supports fortune and silktouch.

Per item configuration

1
smelting:
2
enabled: true
3
play_sound: true
Copied!

BottledExp

This allows to transform your experience into bottles of experience with a right click. You can configure a loss percentage.

Per item configuration

The ratio corresponds to the quantity of exp transformed into a bottle for one exp.
1
bottledexp:
2
ratio: 0.95 # So you'll lose 1/20 of your exp by converting it
Copied!

Global configuration

1
bottledexp:
2
enabled: true
3
durability_cost: 1
Copied!

BedrockBreak

This mechanic depends on ProtocolLib, if you can't use ProtocolLib, you need to disable it

Per item configuration

The hardness is the amount of ticks between breaking animation switch and probability is the percentage of chance to get the bedrock (0.10 for 10%, 0.5 for 50% or 1.0 for 100%).
1
bedrockbreak:
2
hardness: 10
3
probability: 1
Copied!

Global configuration

If you set disable_on_first_layer to true, your players will no longer be able to break the ground (layer 0), the durability_cost is the amount of durability the item you've set bedrockbreak
1
bedrockbreak:
2
enabled: true
3
disable_on_first_layer: false
4
durability_cost: 500
Copied!
Last modified 2mo ago