NightExpress's Plugins Wiki

Essences can be socketed in your items to give you cool particle effects.

Socketing:

  • Socketing chance.
  • Socketing GUI.
  • Define the result of unsuccessful socketing (destroy item or essence, clear all the item essences).
  • Requirements for target item such as level and item type.​

Leveling:

  • Define the min. and max. essence level.​
  • Essence effects a bit changes depends on level.​

Particles:

  • Define particle name, speed and amount.
  • Define particle offset by x, y, z.​​

Media:

Settings.yml

Default module settings are described HERE.

cfg_version: 1.0
command-aliases: essence,essences
messages-output: ACTION_BAR

# Socketing settings
socketing:
  # Result of unsuccessful socketing.
  # ITEM - Destroys the item which was used to socket into.
  # SOURCE - Destroys the source item (gem, essence, etc).
  # BOTH - Destroys the item and the source.
  # CLEAR - Clears all filled item sockets of this module.
  destroy-type: ITEM
  # Particle effects on socketing.
  effects:
    enabled: true
    failure: VILLAGER_ANGRY
    success: VILLAGER_HAPPY
  # Sound effects on socketing.
  sounds:
    enabled: true
    failure: BLOCK_ANVIL_DESTROY
    success: ENTITY_EXPERIENCE_ORB_PICKUP

# Item Format
# Default item settings and placeholders are described HERE.
item-format:
  name: '%item_name% %rlevel%'
  lore:
  - '&f» &7Sucess: &a&l%s%% &8| &7Failure: &c&l%d%%'
  - '&8&m               &f  「 INFO 」  &8&m               '
  - '%item_lore%'
  - '&8&m         &f  「 REQUIREMENTS 」  &8&m        '
  - '%item-level%'
  - '%item-types%'
  - '&8&m               &f 「 USAGE 」 &8&m               '
  - '&7Drag & Drop onto item to start socketing.'

# GUI Settings
# Default GUI settings are described HERE
gui:
  title: '&4&l<&4&nEssence Socketing&4&l>'
  size: 9
  # Slot for target item.
  item-slot: 3
  # Slot for source item.
  source-slot: 4
  # Slot for result preview.
  result-slot: 5
  content:
    filler:
      material: BLACK_STAINED_GLASS_PANE:0:1
      skull-hash: ''
      enchanted: false
      name: ''
      lore: []
      slots: 0,1,2,3,4,5,6,7,8
      type: NONE
    accept:
      material: LIME_STAINED_GLASS_PANE:0:1
      skull-hash: ''
      enchanted: false
      name: '&a&l&nAccept'
      lore:
      - '&7You will try to socket the essence'
      - '&7into your item.'
      - ''
      - '&7In case of failure your item'
      - '&7will be &cdestroyed&7.'
      slots: '8'
      type: ACCEPT
    exit:
      material: RED_STAINED_GLASS_PANE:0:1
      skull-hash: ''
      enchanted: false
      name: '&c&l&nCancel'
      lore: []
      slots: '0'
      type: EXIT

Items

Default module item settings and placeholders are described HERE.

Module Item Types: Interactive + Leveled + Socket.

# Default item settings
material: REDSTONE:0:1
name: '&cEssence of Magic'
lore:
- '&7Creates a &cMagic Helix %rlevel%'
- '&7effect around you.'
enchanted: true
item-flags:
- '*'

# Text for filled socket in item. Placeholders are the same as for item lore and name.
socket-display: '&cMagic Helix %rlevel%'

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

# Min. and max. item socket chance.
min-success-rate: 60
max-success-rate: 80

# Target item type requirements.
item-types:
- ARMOR
- WEAPON

# Essence particle effect settings.
effect:
  # Essence effect type.
  # HELIX - Creates helix around you.
  # FOOT - Creates particles under your steps like trail.
  type: HELIX
  # Particle name.
  name: SPELL_WITCH
  # Particle speed.
  speed: 0.0
  # Particles amount.
  amount: 1
  # Offset settings.
  offset-x: 0
  offset-y: 0
  offset-z: 0
Navigation