NightExpress's Plugins Wiki

A good way to create the 'static' items, but with some randomized stats.

You can add any item stat, damage and defense types, hand types, level and class restrictions, leather and potion colors, skull textures, item flags, enchantments, soulbound and more more more.

Or you can create sinple items with only name and lore and without any other things.

Custom Actions:

  • Define what the item will do when player uses it!
  • Execute commands from console, as OP or by a player.
  • Play sounds and particle effects.
  • Select the target by conditions and apply actions on it.
  • Apply potion effects.
  • And a lot more! Check the Actions Guide...

Upon 4th different actions:

  • Define the mouse (left, right) keys with in a shift key combination and assign custom actions and cooldown for each.​

Randomized Stats:

  • Generate Item Stats, Damage and Defense types with random values in a specified range.​​
  • Add enchantments with a random level from a range.

Player Requirements:

  • Add player requirements such as class and level to allow use the item.​

Limit Item Usage:

  • Define the amount of item uses depends on item level before it will disappear.
  • Or make it unlimited!

Media:


Settings.yml

Default module settings are described HERE.

No additional settings.

Items.yml

Default module item settings and placeholders are described HERE.

Lore Placeholders:

  • %SOCKET:TYPE% - Adds empty socket. TYPE = Socket Type.
  • %AMMO_TYPE:TYPE% - Adds specified ammo type (bow). TYPE = Ammo Type.
  • %HAND_TYPE:TYPE% - Adds specified hand type. TYPE = Hand Type.
  • %DAMAGE_TYPE:TYPE:N1-N2:N3-N4% - Adds specified hand type. TYPE = Damage Type. N1,N2 = Min. and Max value for min. damage. N3,N4 = Values for max. damage.
  • %DEFENSE_TYPE:TYPE:N1-N2% - Adds specified hand type. TYPE = Defense Type. N1 = Min. value, N2 = Max value.
  • %ITEM_STAT:N1-N2% - Adds specified hand type. ITEM_STAT = Item Stat. N1 = Min. value, N2 = Max value.
# Default item settings
material: 'BLAZE_ROD:0:1'
name: '&c« Fire Staff »'
lore:
- '&8&m               &f  「 INFO 」  &8&m               '
- '&f» &7Left-Click: &cFire Strike &7(3 sec)'
- '&f» &7Right-Click: &cAoE Explode &7(30 sec)'
- '&f» &7Uses: &f%uses%&7/&f%uses-max%'
- ''
- '&8&m         &f  「 REQUIREMENTS 」  &8&m        '
- '%LEVEL%'
- '%CLASS%'
- '%UNTRADEABLE%'
- ''
- '&8&m               &f 「 STATS 」 &8&m               '
- '%DAMAGE_TYPE:magical:5.45-9.75:12.35-15.75%'
- '%CRITICAL_RATE:7.5-15.0%'
- '%CRITICAL_DAMAGE:1.25-1.5%'
- ''
- '%DURABILITY:750-750%'
- '&8&m             &f 「 SOCKETS 」 &8&m             '
- '%SOCKET:GEM%'
- '%SOCKET:GEM%'
- '%SOCKET:ESSENCE%'
- '%SOCKET:ESSENCE%'
skull-hash: 'eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvNjZkM2E3ZTA3ZjVkYWRkNDdiYWRiMTM4MmE1YjE2Mjc4MThlZTE2YTE5YTdjMGJmMjc2OGFlNjI2MjczN2I2In19fQ==\'
item-flags:
- HIDE_ATTRIBUTES
color: '-1,-1,-1'

# Min. and max. item level
min-level: 1
max-level: 2

# Player requirements
user-requirements:
  level: 10
  classes: 'Mage'

# Item uses amount
uses-by-level:
  1: 500
  2: 750

# Randomized enchants.
# Format: Enchant : LvlMin:LvlMax
enchants:
  knockback: '1:3'

# Custom actions on item use.
# Check the Actions Guide HERE.
usage:
  RIGHT:
    # Usage cooldown in seconds.
    cooldown: 30
    actions:
      target-selectors:
        near:
        - '[RADIUS] ~distance: 7; ~attackable: true; ~party-member: false;'
        self:
        - '[SELF]'
      action-executors:
      - '[PARTICLE_SIMPLE] ~name: EXPLOSION_LARGE; ~offset: 0.5,0.5,0.5; ~speed: 0.05; ~amount: 100; ~target: self;'
      - '[PARTICLE_SIMPLE] ~name: FLAME; ~offset: 1,1,1; ~speed: 0.3; ~amount: 200; ~target: self;'
      - '[SOUND] ~name: ENTITY_GENERIC_EXPLODE; ~target: near;'
      - '[SOUND] ~name: ENTITY_GENERIC_EXPLODE; ~target: self;'
      - '[THROW] ~target: near;'
      - '[IGNITE] ~target: near; ~duration: 100;'
      - '[DAMAGE] ~amount: 70%; ~target: near;'
  LEFT:
    cooldown: 0
    actions:
      target-selectors:
        near:
        - '[FROM_SIGHT] ~distance: 20; ~attackable: true; ~party-member: false;'
        self:
        - '[SELF]'
      action-executors:
      - '[PARTICLE_LINE] ~name: LAVA; ~offset: 0.1,0.1,0.1; ~speed: 0.05; ~amount: 5; ~target: near;'
      - '[PARTICLE_LINE] ~name: FLAME; ~offset: 0.1,0.1,0.1; ~speed: 0; ~amount: 10; ~target: near;'
      - '[SOUND] ~name: ENTITY_LIGHTNING_BOLT_IMPACT; ~target: near;'
      - '[SOUND] ~name: ENTITY_LIGHTNING_BOLT_IMPACT; ~target: self;'
      - '[BURN] ~target: near; ~duration: 100;'
      - '[DAMAGE] ~amount: 70%; ~target: near;'
Navigation