Essences

Essences

Essences are socketable effects such as trails and helixes. The module also provides a merchant GUI.

Files

• Settings: modules/essences/settings.yml

• Items: light_trail.yml, magic_helix.yml in items/

• Merchant: merchant.yml

• Bundled resources on GitHub

Commands and permissions

• Alias: essence, essences
• essences merchant [player] — divinity.essences.cmd.merchant / .merchant.others
• Socket GUI — divinity.essences.gui.user and .gui.merchant
• Shared item commands and reload — divinity.admin

Configuration and example

socketing.allow-duplicated-items, the animated bar, failure.destroy-target, and merchant settings control the socketing experience. Item target-requirements.socket: default selects the socket category.

Administrator notes

• The bundled socket failure settings can destroy the target item. Confirm socketing.failure before production rollout.
• If the merchant is enabled, verify Vault, the economy provider, prices, and both merchant permissions.
• Decide whether duplicated essence IDs are allowed and test multiple filled sockets on old and new items.
• Back up representative player items before changing socket categories, effects, or failure behavior.

items/light_trail.yml — bundled essence

material: GLOWSTONE_DUST
name: Essence of Trail
socket-display: '&eLight Trail %ITEM_LEVEL_ROMAN%'
enchanted: true
tier: common
level:
  min: 1
  max: 1
uses-by-level:
  '1': 1
effect:
  type: FOOT
  name: DUST:225,225,125
  speed: 0.2
  amount: 15
target-requirements:
  type:
    - ARMOR
  module:
    - '*'
  socket: default

See Modules and Commands and Permissions.