Epic Enchants

From Songoda Wiki
Jump to navigation Jump to search

Unlock the potential of your weapons, tools, and armor by making your own custom enchants using this highly customizable and versatile enchantment system.

Getting Started[edit | edit source]

To install Epic Enchants you will need to:

  1. Turn your server off.
  2. Add the required dependencies: Vault, Economy Management Plugin.
  3. Add in the latest version of Epic Enchants which you can find in our marketplace.
  4. Turn your server back on.

Plugin Files[edit | edit source]

config.yml

groups.yml

dusts.yml

special-items.yml

alchemist-menu.yml

enchanter-menu.yml

main-info-menu.yml

tinkerer-menu.yml

elite-menu.yml

legendary-menu.yml

simple-menu.yml

ultimate-menu.yml

unique-menu.yml

Example Enchantment


Commands and Permissions[edit | edit source]

Commands Description Permission Node
/ee Displays all available commands within EpicEnchants. Default
/ee list [chat] List all enchants with their description. epicenchants.list
/ee givebook <player> <enchant> [level] [success-rate] [destroy-rate] Gives the specified player a specific enchantment book. epicenchants.givebook
/ee giverandombook <player> <group> Give random enchant books to players. epicenchants.giverandombook
/ee givescroll <whitescroll/blackscroll> <player> [amount] [success-rate] Give enchant scrolls to players. epicenchants.givescroll
/ee apply <enchant> <level> [success-rate] [destroy-rate] Apply an enchant to the item in hand. epicenchants.apply
/ee giveitemdust <player> <group> [type] [percentage] Gives the specified player a piece of dust. epicenchants.giveitemdust
/ee settings Edit the EpicEnchants Settings. epicenchants.admin
/ee reload Reload EpicEnchants and it's configurations.
/enchanter Allows the user to open the enchanter menu. epicenchants.enchanter
/tinkerer Allows the user to open the tinkerer menu. epicenchants.tinkerer
/alchemist Allows the player to open the alchemist menu. epicenchants.alchemist
Set the max amount of enchants on a given item where X is the amount of enchants. epicenchants.maxapply.X

Tutorials[edit | edit source]

Effects[edit | edit source]

Effect Description Applicable to Fields
BURN Sets the entity on fire. ALL who, duration
CONSOLE_COMMAND Performs the given command through the console. ALL command
DROP_HEAD Drops the head of entity. ALL who
DROP_ITEM Drops an item. ALL who, material
DROP_HELD Drops the held item of the entity. ALL who
EXPLODE Create an explosion ALL who, magnitude
EXTINGUISH Extinguishes entity. ALL who
LIGHTNING Strikes lighting at player's location. ALL who
MESSAGE Sends message to player. ALL message, who
MODIFY_EXP Modifies EXP of given player. ALL who, amount (add L after value to make it levels)
MODIFY_FOOD Modifies food levels of player. ALL who, amount
MODIFY_HEALTH Modifies the health of given entity, ALL who, amount
MODIFY_OXYGEN Modifies the oxygen levels of given entity, ALL who, amount
PLAYER_COMMAND Performs the given command as the player. ALL command
POTION Gives the entity the potion effect. ALL potion-type, duration, amplifier, who
REMOVE_EFFECT Removes given potion effect from entity. ALL who, potion-type
STEAL_EXP Steal experience from an opponent. ALL amount
STEAL_FOOD Steal food from an opponent. ALL amount
STEAL_HEALTH Removes health from opponent and adds it to player. ALL amount
SPAWN_TNT Spawns primed TNT at entity location. ALL amount, fuse
REPAIR Fully repairs the item in hand. ALL - (STATIC_EFFECT) -
SPAWN_MOB Spawn a custom mob near the players location. entity-type, amount, health, attack-damage, hostile, display-name, equipment
CANCEL_EVENT Cancels given event. ALL - (STATIC_EFFECT, HELD_ITEM, REPEATING) -
THROW Throws the entity in a certain direction ALL - (STATIC_EFFECT, HELD_ITEM, REPEATING) direction, magnitude, who, relative-to
FLY Enables fly. STATIC_EFFECT, HELD_ITEM -
MODIFY_BLOCK Modify the material of the block. BLOCK_BREAK, RIGHT_CLICK material, break-naturally
MODIFY_DAMAGE Modifies the damage of given event. BOW_ATTACK, DEFENSE, EXPLOSION, FALL_DAMAGE, FIRE modifier
MORE_DROPS Multiplies the amount of drops by amount. BLOCK_BREAK, MOB_DEATH amount
STEAL_HEALTH Removes health from opponent and adds it to player. ATTACK_PLAYER, DEFENSE_PLAYER amount

Triggers[edit | edit source]

Trigger Description
ATTACK_PLAYER_MELEE When attacking a player using a hand held weapon.
ATTACK_MOB_MELEE When attacking a mob using a hand held weapon.
DEFENSE_PLAYER_MELEE When damaged by player using a hand held weapon.
DEFENSE_PLAYER_RANGE When damaged by player using a bow.
ATTACK_PLAYER_RANGE When attacking a player using a bow.
ATTACK_MOB_RANGE When attacking a mob using a bow.
DEFENSE_MOB_MELEE When damaged by mob using a hand held weapon.
DEFENSE_MOB_RANGE When damaged by mob using a bow.
DEATH When killed.
LEFT_CLICK When player left clicks.
KILLED_PLAYER When player killed another player.
KILLED_MOB When player killed a mob.
EXPLOSION_DAMAGE When damaged by an explosion.
FALL_DAMAGE When damaged by fall.
FIRE_DAMAGE When damaged by fire.
LAVA_DAMAGE When damaged by lava.
HELD_ITEM When holding said item.
STATIC_EFFECT When wearing said item.
BLOCK_BREAK When block is broken by player.
EXPERIENCE_BLOCK_BREAK When a block that grants experience is broken by a player.
RIGHT_CLICK_BLOCK When a block is right clicked.
LEFT_CLICK_BLOCK When a block is left clicked.
RIGHT_CLICK When player right clicks.
POISON_DAMAGE When player is damaged by poison.

Fields[edit | edit source]

Field Values Defaults Placeholders
command String "" {level}, {user_name}, {opponent}
who USER, OPPONENT USER -
relative-to USER, OPPONENT USER -
message String "" {level}, {user_name}, {opponent}
modifier JavaScript Expression or Integer 1 {level}
amount JavaScript Expression or Integer 1 {level}
potion-type Read below for values. - -
duration JavaScript Expression or Integer MAX {level}
chance JavaScript Expression or Integer 100 {level}
amplifier JavaScript Expression or Integer 0 {level}
direction UP, DOWN, BACKWARD, FORWARD - -
magnitude JavaScript Expression or Integer 0.1 {level}
material JavaScript Expression or Integer 0.1 {level}
break-naturally Boolean false -

Conditions[edit | edit source]

Conditions are used to determine whether or not an effect should be ran. These conditions are formatted using JavaScript Expressions.

Placeholder Description Replacement
level The level of the enchantment. The level of the enchantment as an integer.
user_health The health of the user. The health of the user as an integer.
opponent_health The health of the opponent. The health of the opponent as an integer.
user_holding The material that the user is holding. The material of the item the user is holding.
opponent_holding The material that the opponent is holding. The material of the item the opponent is holding.
user_food The food level of the user. The food level of the user as an integer.
opponent_food The food level of the opponent. The food level of the opponent as an integer.
user_is_sneaking Whether the user is sneaking. Whether or not the user is sneaking as a boolean.
user_is_swimming Whether the user is swimming. Whether or not the user is swimming as a boolean.
opponent_is_swimming Whether the opponent is swimming. Whether or not the opponent is swimming as a boolean.
world The world that the user is in. The name of the world that the world is in as a string.
players_near Amount of players in a 4x4x4 radius. The amount of players in the 4x4x4 radius as an integer.
user_on_fire Whether the user is on fire. Whether or not the user is on fire as a boolean.
opponent_on_fire Whether the opponent is on fire. Whether or not the opponent is on fire as a boolean.
clicked_type The type of entity that is clicked. The type of entity, for example: SKELETON. If not available, N/A.
block_type The type of the block that is broken, placed or clicked. The material of the block, for example: STONE. If not available, N/A.
random(low=?, up=?) Random Number A random number between the lower bound and upper bound, upper bound is exclusive.

Frequently Asked Questions[edit | edit source]

No enum constant error in console