identify tomes - magemonkeystudio/divinity GitHub Wiki

📜 Identify Tomes

Identify tomes are special items used to reveal the contents of unidentified items. When used, they consume a use charge and transform an unidentified item into its final form from a designated item module.


📂 File Location

Tome definitions are located in:

plugins/Divinity/modules/identify/tomes/

Each file defines a scroll or tome that corresponds with specific unidentified item types.


📘 Example: Common Identify Scroll

material: ENCHANTED_BOOK
name: Identify Scroll
lore:
  - '&7Drop this scroll on an unidentified item'
  - '&7item to reveal its contents'
tier: common
level:
  min: 1
  max: 1
uses-by-level:
  '1': 1
target-requirements:
  type:
    - '*'
  level:
    '1': '1'
  module:
    - '*'

🔑 Key Sections

  • material – The base Minecraft item type used to represent the scroll.
  • name – Display name shown in-game.
  • lore – Text explaining how to use the scroll, shown as tooltip.
  • tier – Used for sorting or restricting item use by rarity.
  • level – Specifies what levels the tome is valid for.
  • uses-by-level – How many times the tome can be used at a given level.
  • target-requirements – Optional restrictions on what types of items can be identified using this scroll:
    • type – Item categories (e.g., ARMOR, WEAPON, or * for all)
    • level – Allowed level range per scroll level.
    • module – Item origin modules the scroll can target.

⬅️ identify — Back to Identify Module Hub