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"
Description
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 : https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Material.html 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
Trigger
The trigger is the way the orb will be triggered (see how triggers work here Triggers).
trigger: distance_hit<all>
Chance
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 :
conditions_applying_orb:
- "%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).
conditions_activation:
- "@player_item_in_hand@[IS]BOW"
Effects
Effects are activated if conditions are met (to learn how to create effects, see Effects).
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
Permission
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