module runes item rune_absorp - magemonkeystudio/divinity GitHub Wiki

๐Ÿ’  rune_absorp.yml

The rune_absorp.yml file defines the configuration for the Rune of Absorption, a socketable item that grants the Absorption status effect when applied to valid gear.


๐Ÿ”ง File Location

plugins/Divinity/modules/runes/items/rune_absorp.yml

๐Ÿงพ Configuration

material: PLAYER_HEAD
name: Rune of Absorption
lore:
  - '&7Grants &fAbsorption %ITEM_LEVEL_ROMAN% &7effect'
item-flags:
  - '*'
tier: common
level:
  min: 1
  max: 2
uses-by-level:
  '1': 1
success-rate-by-level:
  '1': '75'
  '2': '30 * %ITEM_LEVEL%'
  '3': '30:50'
socket-display: '&bRune: Absorption %ITEM_LEVEL_ROMAN%'
effect: ABSORPTION
skull-hash: 'eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvZmM2YmQ3ZjI1YWMxMzI4YzNmNjViMWVlMDIzZmE2YWUyMzExODg0YjU1MzE3N2Y5ZjI0ZTIxNDY0ZWQzZmYyIn19fQ=='
target-requirements:
  type:
    - chestplate
  level:
    '1': '10'
    '2': '20'
    '3': '30'
  module:
    - '*'
  socket: default

๐Ÿ” Explanation of Settings

Key Description
material The base Minecraft item type; here PLAYER_HEAD is used to represent the rune visually.
name The display name of the rune.
lore Description text shown on hover. %ITEM_LEVEL_ROMAN% auto-fills the item's level.
item-flags Hides all item attributes for a cleaner appearance ('*' means all are hidden).
tier The rarity or tier classification of the item.
level Defines the min and max item levels for scaling effects.
uses-by-level How many uses are granted per level.
success-rate-by-level Socketing success rate per level. Can be fixed ('75'), formula-based ('30 * %ITEM_LEVEL%'), or a range ('30:50').
socket-display What shows in the item's socket display after being applied.
effect The Bukkit potion effect applied (RESISTANCE).โžก A full list of valid effects can be found here.
skull-hash Custom texture applied to the PLAYER_HEAD. See below.
target-requirements Restricts valid items this rune can be applied to: here only chestplates of level 10+ are valid.
socket Defines the socket group this rune belongs to (e.g., default).

๐Ÿง  About skull-hash

The skull-hash value allows a custom head texture to be applied to the item using a base64-encoded texture value.

  • You can get custom skull hashes from: https://minecraft-heads.com
    • Navigate to any head you like.
    • Click "Copy Value" next to Value (Base64) on the page.
    • Paste that value into the skull-hash field.

This allows visual theming of runes using head textures.


๐Ÿ”— Back to Hub

โ† Return to Runes Module