Create your power orb

This page will help you create your own enchantments.

First step - Create the orb file

Create a file called <orb_name>.yml into the ./plugins/Nebula/orbs/ folder.

Second step - Edit the properties

Orb name

This is the name of the power orb, it must be lowercase and not contain any space. This will be the name you'll use to find it in game.

orb_name: forceful_orb

Displayed name

This is the name that will be displayed on the item.

displayed_name: "&2&lForceful Orb"


The description will be shown on the Power orb and the item after applying. You can use %level% as a placeholder to replace the orb level(how many times it has been upgraded), you can also compute a formula using the compute formula (the level placeholder can be included in the formula : compute_{%level%*2}. More infos about descriptions can be found here : Description

description: "&fIncrease damages by &ccompute_{%level%*2}%"

Maximum orb level

This is the maximum orb level.Each time the player apply an orb to an object, the level increases by 1 while it doesn't exceed this limit.

level_max: 5

Items type

The items type define the items that can receive this orb, you can write here multiple items, and/or group of items. Items can be found here : and the groups are :

  • all : can be applied to every item (weapons, tools, armor, shield)

  • weapons : all axes, swords and trident

  • distance_weapons : bow, crossbow, trident

  • tools : all pickaxes, shovels, hoes, axes, fishing rod and shears

  • swords : all swords

  • axes : all axes

  • shovels : all shovels

  • hoes : all hoes

  • mana_holders : all weapons, distance_weapons and tools

items_type: bow, crossbow


The trigger is the way the orb will be triggered (see how triggers work here Triggers).

trigger: distance_hit<all>


This defines the chance for the effect to be applied. A chance of 0 mean that the effect will never be applied and 100 will be applied all the time (more infos on Chances).

chance : %level%*2

Conditions to apply

Conditions to apply are conditions that have to be met to apply a power orb. Here is an example of how to avoid a player to apply an orb except in the world called my_world :


- "%player_world%[IS]my_world"

Conditions to activate

Conditions to activate have the same format as Conditons to apply. They must be all verified before effects activation (to learn how to create conditions, see Conditions).


- "@player_item_in_hand@[IS]BOW"


Effects are activated if conditions are met (to learn how to create effects, see Effects).


- "level[all]:ennemy[damage_add_%level%*0.25]"

Items found in chests

You can prevent this orb from spawning in chests (see how chest spawning works here Chest spawning).

chest_found: true

Items sold by villagers

You can prevent this orb from being sold by villagers (see Villagers).

villager_foundable: true

Possibility to fish

You can prevent this orb from being found by fishing with special rod (see Fishing).

possible_to_fish: true

Emerald price

This is the price the orb can be bought on villagers (you can include %level% placeholder).

emerald_price: 40


If this is enabled, the player will need a permission to use the orb (effects won't be activated if the player doesn't have the permission).

permission_needed: false

Last updated