Exylia Plugins

Actions & Items

Complete guide to all special items and their configurations

Actions & Items

ExyliaSpecials features 36+ unique special items with configurable actions, effects, and abilities.

Item Configuration Structure

All items follow a standard YAML configuration format:

# ===== ITEM =====
material: "MATERIAL_NAME"
name: 'Display Name with Colors'
lore:
  - 'Lore line 1'
  - 'Lore line 2'
glow: true
hide-attributes: true

# ===== CONFIGURATION =====
display-name: 'Clean Display Name'
cancel-event: true
stackable: false
max-uses: 5
cooldown: 30.0

# ===== ACTIONS =====
trigger-type: IMMEDIATE # or ON_HIT_PLAYER, ON_PROJECTILE_HIT, RADIUS, HOLD
action: "action_name"
action-config:
  # Action-specific configuration

# ===== COMMANDS =====
commands:
  - "console: effect give %player_name% minecraft:strength 30 2"
  - "console: effect give %player_name% minecraft:speed 30 1"
  - "player: say Hello!"

# ===== VISUALS =====
effects-on-use:
  particles:
    enabled: true
    particles:
      - "PARTICLE|COUNT|OFFSET_X|OFFSET_Y|OFFSET_Z|EXTRA"
  sounds:
    enabled: true
    sounds:
      - "SOUND|VOLUME|PITCH"
  fireworks:
    enabled: true
    fireworks:
      - "TYPE|COLORS|FADE_COLORS|FLICKER|TRAIL|POWER"

# ===== WORLD-GUARD =====
region:
  type: WHITELIST # WHITELIST | BLACKLIST | NONE
  checker: CONTAINS # CONTAINS | PRIORITY
  list:
    - "region-name"
    - "region-name|specific_world"
  cooldowns:          # Custom cooldowns by region
    "pvp-arena": 10.0
    "combat-zone": 15.5

Global Cooldown System

The global cooldown system prevents players from using any special item for a configured duration after using a single item, providing server-wide cooldown control.

Configuration

Configure the global cooldown in your config.yml:

cooldowns:
  global-cooldown:
    default: 10.0           # Default cooldown in seconds (applies globally)
    worlds:
      world1: 7.0           # Override for specific world
      world2: 7.0
    regions:
      region1: 5.0          # Override for specific region
      region2: 1.0

How It Works

  1. Player uses any special item
  2. Global cooldown is applied to that player for the configured duration
  3. Player cannot use any special item during this cooldown period
  4. After the cooldown expires, player can use items again with the respective cooldowns

The global cooldown system applies across all special items. Once a player uses any item, all items become temporarily unavailable.

Global cooldowns differ from individual item cooldowns. Individual cooldowns apply to specific items, while global cooldowns apply to all items.

Trigger Types

TypeDescriptionUsage
IMMEDIATEActivates on clickMost common items
ON_HIT_PLAYERActivates when hitting a playerCombat items
ON_PROJECTILE_HITActivates when projectile hits, like egg or snowballRanged items
RADIUSAffects players in radiusArea effect items
HOLDActivates while holdingContinuous effects
AFTER_CONSUMEActivates after consuming like appleFood/potion items

Trigger Type Specific Configurations

Each trigger type may require specific configurations in the action-config section:

For radius-based triggers, you must specify the area of effect:

trigger-type: RADIUS
action-config:
  radius: 5.0          # Radius in blocks
  only-players: true   # Target only players

For hold triggers, configure the activation behavior:

trigger-type: HOLD
action-config:
  hold-interval: 20    # Activation interval in ticks (20 ticks = 1 second)
  hold-hand: ANY       # Which hand to check (ANY, MAIN, OFF)

IMMEDIATE, ON_HIT_PLAYER, ON_PROJECTILE_HIT and AFTER_CONSUME trigger types don't require additional specific configurations.

Commands Configuration

Items can execute commands when activated using the commands section. Commands can be executed from the console or as the player who used the item.

commands:
  - "console: effect give %player_name% minecraft:strength 30 2"
  - "console: effect give %player_name% minecraft:speed 30 1"
  - "console: gamemode creative %player_name%"
  - "player: say I used a special item!"
  - "player: warp spawn"

Command Types

TypeDescriptionExample
console:Executes command from console with full permissions"console: give %player_name% diamond 5"
player:Executes command as the player who used the item"player: say Hello world!"

Placeholders

  • %player_name% - The name of the player who used the item
  • Any other placeholders supported by your server's plugin ecosystem

Commands are executed in the order they are listed in the configuration.

Use console commands carefully as they have full server permissions. Always validate the commands work as expected.

Combat Items

Deals area damage to nearby players.

action: "damage"
action-config:
  damage: 5.0
  only-players: true
  normal-damage: true
  radius: 5.0
  
  # Efectos cuando una entidad recibe daño
  damage-effects:
    particles:
      enabled: true
      particles:
        - "DAMAGE_INDICATOR|12|0.5|1.0|0.5|0.1"
        - "REDSTONE|8|0.3|0.8|0.3|0.1"
    sounds:
      enabled: true
      sounds:
        - "ENTITY_PLAYER_HURT|0.8|1.0"
        - "ENTITY_LIGHTNING_BOLT_IMPACT|0.4|2.0"
    fireworks:
      enabled: false
      fireworks: []

Reduces target's armor effectiveness temporarily.

action: "armor_reducer"
action-config:
  reduce-percent: 0.5

Pushes nearby players away from the user.

action: "push"
action-config:
  force: 2.0
  upward-force: true
  upward-multiplier: 0.5
  radius: 5.0
  
  # Efectos cuando una entidad es empujada
  push-effects:
    particles:
      enabled: true
      particles:
        - "EXPLOSION_NORMAL|15|1.0|1.0|1.0|0.3"
        - "CLOUD|10|0.8|0.5|0.8|0.2"
    sounds:
      enabled: true
      sounds:
        - "ENTITY_GENERIC_EXPLODE|0.6|1.5"
        - "BLOCK_PISTON_EXTEND|0.8|1.2"
    fireworks:
      enabled: false
      fireworks: []

Prevents target from placing blocks temporarily.

action: "anti_build"
action-config:
  duration: 10.0
  block_all: false
  blocked_materials:
    - "COBWEB"

  restriction-effects:
    particles:
      enabled: true
      particles:
        - "BARRIER|10|1.0|1.0|1.0|0.1"
        - "BLOCK_CRACK|15|0.8|1.2|0.8|0.1|BEDROCK"
    sounds:
      enabled: true
      sounds:
        - "BLOCK_ANVIL_LAND|0.7|2.0"
        - "ENTITY_IRON_GOLEM_HURT|0.8|1.5"
    fireworks:
      enabled: false
      fireworks: []

  blocked-effects:
    particles:
      enabled: true
      particles:
        - "VILLAGER_ANGRY|5|0.5|1.0|0.5|0.1"
        - "BLOCK_DUST|10|0.5|0.8|0.5|0.1|REDSTONE_BLOCK"
    sounds:
      enabled: true
      sounds:
        - "ENTITY_VILLAGER_NO|0.8|1.2"
        - "BLOCK_STONE_BREAK|0.6|2.0"
    fireworks:
      enabled: false
      fireworks: []

  bossbar:
    enabled: true
    text: "&c🏗 &fBuild Blocked: &e%time_formatted%"
    color: "RED"
    style: "PROGRESS"
    permanent: false
    update-interval: 20

Prevents target from using specific items temporarily.

action: "anti_item"
action-config:
  duration: 10.0
  block_all: false
  blocked_items:
    - "ELYTRA"

  restriction-effects:
    particles:
      enabled: true
      particles:
        - "BARRIER|10|1.0|1.0|1.0|0.1"
        - "BLOCK_CRACK|15|0.8|1.2|0.8|0.1|REDSTONE_BLOCK"
    sounds:
      enabled: true
      sounds:
        - "BLOCK_ANVIL_LAND|0.7|2.0"
        - "ENTITY_ITEM_BREAK|1.0|0.8"
    fireworks:
      enabled: false
      fireworks: []

  blocked-effects:
    particles:
      enabled: true
      particles:
        - "VILLAGER_ANGRY|5|0.5|1.0|0.5|0.1"
        - "SMOKE_NORMAL|8|0.3|0.8|0.3|0.05"
    sounds:
      enabled: true
      sounds:
        - "ENTITY_VILLAGER_NO|0.8|1.2"
        - "BLOCK_NOTE_BLOCK_BASS|0.6|0.5"
    fireworks:
      enabled: false
      fireworks: []

  bossbar:
    enabled: true
    text: "&c🚫 &fItems blocked: &e%time_formatted%"
    color: "RED"
    style: "PROGRESS"
    permanent: false
    update-interval: 20

Shuffles target player's inventory hotbar.

action: "shuffle"
action-config:
  shuffle-type: "hotbar" # inventory | hotbar
  start-slot: 0
  end-slot: 8

Movement Items

Teleports to target location or swaps positions.

action: "teleport"
action-config:
  type: "SWITCH" # TO | BACK | SWITCH | RANDOM
  delay: 0
  teleport-effects:
    particles:
      enabled: true
      particles:
        - "PORTAL|25|1.0|2.0|1.0|0.5"

Grants temporary flight ability.

action: "flight"
action-config:
  duration: 10 # seconds

Batman-style grappling hook for mobility.

action: "grappling_hook"
action-config:
  arrow-speed: 3.0
  pull-force: 2.0
  max-distance: 40.0
  allow-wall-pull: true
  
  launch-effects:
    particles:
      enabled: true
      particles:
        - "SMOKE_NORMAL|10|0.3|0.3|0.3|0.1"
        - "SPARK|5|0.2|0.2|0.2|0.2"
    sounds:
      enabled: true
      sounds:
        - "ENTITY_ARROW_SHOOT|0.8|0.8"
    fireworks:
      enabled: false
      fireworks: []

Utility Items

Repairs damaged equipment.

action: "repair"
action-config:
  type: "ALL" # ALL | ARMOR | HOTBAR | OFFHAND | ARMOR_AND_HOTBAR | HOTBAR_AND_OFFHAND | ARMOR_AND_OFFHAND

Removes negative potion effects.

action: "cleaner"
action-config:
  remove-invulnerability: true
  remove-freeze-from-self: true
  effects-to-remove:
    - "POISON"

Creates temporary block structures.

action: "block_creator"
action-config:
  radius: 5.0 # structure radius
  material: "COBWEB" # block material
  type: "SPHERE" # SPHERE or CUBOID
  position: "CIRCULAR" # CIRCULAR or RECTANGULAR (for floors)
  replace-water: true # replace water
  thickness: 1.0 # wall thickness (for hollow structures)
  remove-duration: 30 # seconds before removing blocks (-1 = permanent)
  
  # Boss bar for destruction countdown
  bossbar:
    enabled: true
    text: "&c⚠ Blocks will be destroyed in &f%time_formatted%s"
    color: "RED"
    style: "SEGMENTED_20"
  
  # Effects when destroying blocks
  destruction-effects:
    particles:
      enabled: true
      particles:
        - "BLOCK_CRACK|5|0.5|0.5|0.5|0.1|%material%"
        - "POOF|3|0.3|0.3|0.3|0.05"
    sounds:
      enabled: true
      sounds:
        - "BLOCK_STONE_BREAK|0.5|1.0"
    fireworks:
      enabled: false
      fireworks: []

Removes specific block types in a radius.

action: "block_cleaner"
action-config:
  radius: 5.0
  drop-items: false
  material: COBWEB
  type: SPHERE
  position: CIRCULAR

Opens target's inventory with a probability chance.

action: "inventory_opener"
action-config:
  inventory: "CRAFTING" # CRAFTING, WORKBENCH, etc.
  duration: 10
  probability: 0.25

  hit-effects:
    particles:
      enabled: true
      particles:
        - "VILLAGER_ANGRY|8|0.5|1.0|0.5|0.1"
        - "CRIT|5|0.3|0.8|0.3|0.05"
    sounds:
      enabled: true
      sounds:
        - "ENTITY_VILLAGER_HURT|0.7|1.5"
    fireworks:
      enabled: false
      fireworks: []

  open-effects:
    particles:
      enabled: true
      particles:
        - "PORTAL|20|1.0|1.0|1.0|0.5"
        - "ENCHANTMENT_TABLE|15|0.8|1.2|0.8|0.3"
    sounds:
      enabled: true
      sounds:
        - "BLOCK_CHEST_OPEN|1.0|0.8"
        - "ENTITY_ENDERMAN_TELEPORT|0.5|1.8"
    fireworks:
      enabled: false
      fireworks: []

  bossbar:
    enabled: true
    text: "&c📦 &fInventory opener: &e%time_formatted%"
    color: "RED"
    style: "PROGRESS"
    permanent: false
    update-interval: 20

Launches a fake projectile with custom velocity.

action: "fake_projectile"
action-config:
  projectile-type: ENDER_PEARL # ENDER_PEARL, SNOWBALL, EGG, etc.
  velocity: 1.0
  lifespan-ticks: 100
  show-trail: false
  trail-effect: "CLOUD"
  trail-interval: 2

Special Items

Creates player clones (requires Citizens plugin).

action: "clone" # THIS ACTION NEED CITIZENS
action-config:
  duration: 30 # clone duration in seconds
  move-interval: 5 # movement interval in seconds
  min-radius: 3 # minimum movement radius
  max-radius: 8 # maximum movement radius
  spawn-offset: 0 # spawn offset (0 = same position as player)
  clone-name: "%player_name%"
  
  # Effects when creating the clone
  spawn-effects:
    particles:
      enabled: true
      particles:
        - "PORTAL|30|1.0|2.0|1.0|0.8"
        - "ENCHANTMENT_TABLE|25|1.5|2.5|1.5|0.5"
    sounds:
      enabled: true
      sounds:
        - "ENTITY_ENDERMAN_TELEPORT|1.0|0.8"
        - "BLOCK_PORTAL_AMBIENT|0.8|1.2"
    fireworks:
      enabled: true
      fireworks:
        - "STAR|138,43,226;75,0,130|255,255,255|true|true|1"
        
  # Effects when swapping position
  swap-effects:
    particles:
      enabled: true
      particles:
        - "PORTAL|20|0.8|1.5|0.8|0.6"
        - "WITCH|15|0.5|1.0|0.5|0.3"
    sounds:
      enabled: true
      sounds:
        - "ENTITY_ENDERMAN_TELEPORT|0.8|1.5"
    fireworks:
      enabled: false
      fireworks: []
        
  # Effects when removing the clone
  remove-effects:
    particles:
      enabled: true
      particles:
        - "POOF|20|1.0|1.0|1.0|0.1"
        - "SMOKE|10|0.8|0.8|0.8|0.05"
    sounds:
      enabled: true
      sounds:
        - "ENTITY_GENERIC_EXTINGUISH_FIRE|0.7|1.0"
    fireworks:
      enabled: false
      fireworks: []

Requires Citizens plugin to be installed.

Summons a defensive iron golem.

action: "defensor"
action-config:
  duration: 60 # golem duration in seconds
  range: 15 # enemy detection range
  shoot-interval: 20 # ticks between shots (1 second)
  damage: 4.0 # damage per projectile
  knockback: 0.5 # knockback force
  health: 50.0 # golem health
  projectile-speed: 2.0 # projectile speed
  defensor-name: "&7⚔ Defender of %player_name%"
  
  # Sound configuration
  spawn-sound: "ENTITY_IRON_GOLEM_HURT"
  shoot-sound: "ENTITY_SNOWBALL_THROW"
  remove-sound: "ENTITY_IRON_GOLEM_DEATH"
  
  # Particle configuration
  enable-particles: true

Grants invisibility with advanced features.

action: "invisible"
action-config:
  duration: 15 # invisibility duration in seconds
  delay: 60 # delay ticks before applying invisibility (3 seconds)
  delay-effect-ticks: 2 # effect interval during delay
  hide-from-all: true # hide from all players
  prevent-damage: true # prevent taking damage while invisible
  effects: # additional potion effects
    - "SPEED|1|15" # SPEED level 1 for 15 seconds
    - "NIGHT_VISION|0|15" # NIGHT VISION for 15 seconds
  
  # Boss bar during delay
  delay-bossbar:
    enabled: true
    text: "&7⏳ Applying invisibility... &8[&f%time_formatted%s&8]"
    color: "PURPLE"
    style: "SOLID"
    
  # Effects during delay
  delay-effects:
    particles:
      enabled: true
      particles:
        - "WITCH|8|0.5|1.0|0.5|0.1"
        - "PORTAL|5|0.3|0.8|0.3|0.05"
    sounds:
      enabled: true
      sounds:
        - "BLOCK_BREWING_STAND_BREW|0.5|1.5"
    fireworks:
      enabled: false
      fireworks: []

Cleaner Items

Removes freeze effect from the player.

action: "freeze_cleaner"
action-config:
  # No additional configuration needed

Removes invulnerability effect from players in a radius.

action: "invulnerability_cleaner"
action-config:
  radius: 5.0
  only-players: true

Effect Types

Freezes players in place temporarily.

action: "freeze"
action-config:
  duration: 3
  radius: 5.0

  freeze-effects:
    particles:
      enabled: true
      particles:
        - "SNOW_SHOVEL|15|1.0|1.5|1.0|0.02"
        - "SPELL|10|0.8|1.2|0.8|0.1"
    sounds:
      enabled: true
      sounds:
        - "BLOCK_GLASS_BREAK|0.8|0.6"
        - "ENTITY_PLAYER_HURT_FREEZE|1.0|1.2"
    fireworks:
      enabled: false
      fireworks: []
  
  bossbar:
    enabled: true
    text: "&b❄ &fFreezed: &e%time_formatted% &f- &7%player_name%"
    color: "BLUE"
    style: "PROGRESS"
    permanent: false
    update-interval: 20

Applies potion effects.

action: "effect"
action-config:
  effects:
    - "STRENGTH|1|30"
    - "SPEED|0|30"
    - "REGENERATION|0|15"
  random: false
  amount: 1
  only-players: true

Clear potion effects.

action: "effect_cleaner"
action-config:
  effects:
    - "POISON"
    - "WITHER"
    - "LEVITATION"

Add immunity to potion effects.

action: "effect_immunity"
action-config:
  duration: 60
  remove-on-death: true
  persist: true
  effects:
    - "POISON"
    - "WITHER"
    - "LEVITATION"
  
  immunity-effects:
    particles:
      enabled: true
      particles:
        - "SPELL_WITCH|20|1.0|1.5|1.0|0.2"
        - "PROTECTION_ENVIRONMENTAL|15|0.8|1.2|0.8|0.1"
    sounds:
      enabled: true
      sounds:
        - "ITEM_BOTTLE_EMPTY|1.0|0.6"
        - "ENTITY_WITCH_DRINK|0.8|1.2"
    fireworks:
      enabled: true
      fireworks:
        - "BALL|128,0,255;255,0,255|255,255,255|true|false|1"
  
  bossbar:
    enabled: true
    text: "&5🧪 &fImmunity for: &e%time_formatted% &f- &7%effects_count% effects"
    color: "PURPLE"
    style: "PROGRESS"
    permanent: false
    update-interval: 20

Grants temporary damage immunity.

action: "invulnerability"
action-config:
  duration: 5
  
  invulnerability-effects:
    particles:
      enabled: true
      particles:
        - "TOTEM|20|1.0|1.5|1.0|0.2"
        - "ENCHANTMENT_TABLE|15|0.8|1.2|0.8|0.1"
    sounds:
      enabled: true
      sounds:
        - "ITEM_TOTEM_USE|1.0|1.2"
        - "ENTITY_PLAYER_LEVELUP|0.8|1.5"
    fireworks:
      enabled: true
      fireworks:
        - "BURST|255,215,0;255,255,255|255,255,255|true|false|1"
  
  bossbar:
    enabled: true
    text: "&6🛡 &fInvulnerability: &e%time_formatted% &f- &7%player_name%"
    color: "YELLOW"
    style: "PROGRESS"
    permanent: false
    update-interval: 20

Initiates a 1v1 duel between two players in a designated arena.

action: "1v1"
action-config:
  # Mode can be "fixed" or "region_mapping"
  mode: "fixed"

  # For fixed mode: specify a single arena
  arena: "example-arena"

  # Mode: region_mapping for location-based arena selection
  # mode: "region_mapping"
  #
  # Map WorldGuard regions to specific arenas
  # region_mapping:
  #   "spawn": "spawn-arena"
  #   "pvp-zone": "main-pvp-arena"
  #   "crystal-area": "crystal-arena"
  #   "pot-area": "pot-arena"
  #   "mazo-area": "mazo-arena"
  #
  # Default arena if player is not in any mapped region
  # default_arena: "default-arena"

  fight-bossbar:
    enabled: true
    text: "⚔ &fTime: %time_formatted% &f| %player1% &fvs %player2%"
    color: "RED"
    style: "PROGRESS"
    permanent: false
    update-interval: 20

  loot-bossbar:
    enabled: true
    text: "💰 &fLoot Time: %time_formatted%"
    color: "GREEN"
    style: "PROGRESS"
    permanent: false
    update-interval: 20

Visual Effects Configuration

Particles

particles:
  enabled: true
  particles:
    - "FLAME|20|0.5|0.5|0.5|0.1"        # Basic particle
    - "REDSTONE|10|0.3|0.8|0.3|0.1|255,0,0" # Colored particle
    - "BLOCK_DUST|15|1.0|1.0|1.0|0.1|STONE" # Block particle

Sounds

sounds:
  enabled: true
  sounds:
    - "ENTITY_LIGHTNING_BOLT_THUNDER|1.0|1.2"
    - "ENTITY_PLAYER_LEVELUP|0.8|1.5"

Fireworks

fireworks:
  enabled: true
  fireworks:
    - "BALL|255,215,0;255,0,0|255,255,255|true|true|2"
    - "STAR|138,43,226;75,0,130|255,255,255|true|false|1"

Region Restrictions

Control where items can be used with WorldGuard integration:

region:
  type: WHITELIST     # WHITELIST, BLACKLIST, or NONE
  checker: CONTAINS   # CONTAINS or PRIORITY
  list:
    - "pvp-arena"
    - "combat-zone|world_nether"  # Specific world
  cooldowns:          # Custom cooldowns by region
    "pvp-arena": 10.0
    "combat-zone": 15.5

All items are fully configurable. Modify the YAML files in /plugins/ExyliaSpecialsV3/items/ to customize behavior.

Creating Custom Items

  1. Copy an existing item YAML file
  2. Modify the material, name, and action properties
  3. Adjust action-config parameters as needed
  4. Customize visual effects
  5. Reload the plugin: /exyliaspecials reload

Some actions require specific dependencies (Citizens for clones, WorldGuard for regions).

Permissions

Permission system for ExyliaSpecials

Default Config

Default Config