identify items

🧾 Identify Items

Unidentified items are placeholder gear that must be revealed using an identification tome. These items can be defined and customized per tier, level range, and visual format.

---

📂 File Location

Unidentified item files are located at:

plugins/Divinity/modules/identify/items/

Each file represents an item that players may find or receive before identifying.

---

🧪 Example: Common Unidentified Item

name: '&kUndentified Item'
lore:
  - '&7Tier: %TIER_NAME%'
  - '&7Level: &f%ITEM_LEVEL%'
  - ''
  - '&4<Stats of this item are not known yet.>'
  - '&7'
  - '&cYou must have one of specified items'
  - '&cto unlock item stats:'
  - '&7â–¸ %tome-name%'
tier: common
item-flags:
  - '*'
level:
  min: 1
  max: 25
item-module: item_generator
item-id: common
applicable-tomes:
  - common
  - rare
target-requirements:
  type:
    - '*'
  level:
    '1': 0
  module:
    - '*'

---

🔑 Key Sections

• name – Display name of the item while unidentified. Supports obfuscation (&k) for mystery effects.
• lore – Description shown before identification. Placeholders like %TIER_NAME%, %ITEM_LEVEL%, and %tome-name% are automatically filled.
• tier – Controls tier-based scaling or restrictions.
• item-flags – Visual/item metadata flags. '*' applies all default flags.
• level – Defines the min and max level the item can roll at.
• item-module – The module that supplies the actual item (e.g., item_generator).
• item-id – The ID from the linked item module to roll upon successful identification.
• applicable-tomes – A list of tomes that are allowed to identify this item.
• target-requirements – Optional restrictions on who can identify the item.

---

⬅️ identify — Back to Identify Module Hub