engine lore

🧾 Engine Config: lore

This section defines how item stats, durability, requirements, and other metadata are visually displayed on item tooltips. It controls both formatting and logic for dynamic item lores.

---

🔑 Sections

The lore section contains these nested categories:

• chars – Character symbols used for percent, positive/negative numbers, etc.
• stats.style.separator – Controls how stat values are split and colored.
• stats.style.durability – Format for displaying item durability values or bars.
• stats.style.damage – Format for showing single/double damage ranges.
• stats.style.charges – How charge-based items display usage and limits.
• stats.style.requirements – Visual formatting for level, class, banned-class, and module requirements.
• stats.style.enchantments – Line format for enchantments.
• fabled-attribute-format – Format string for custom attribute lines.

---

🧪 Example

lore:
  chars:
    percent: '%'
    negative: '&c'
    positive: +
    multiplier: x
  stats:
    style:
      separator:
        value: '&7/'
        color: '&f'
      durability:
        format: default
        unbreakable: '&fUnbreakable'
        format-list:
          default:
            '0': '&f%current%&7/&f%max%'
          text:
            '100': '&aGood &7(%percent%%)'
            '70': '&2Pretty good &7(%percent%%)'
            '50': '&eDamaged &7(%percent%%)'
            '25': '&6Need repair &7(%percent%%)'
            '10': '&cAlmost broken &7(%percent%%)'
            '0': '&4Broken &7(%percent%%)'
      damage:
        format:
          single: '&f%value%'
          double: '&f%min% &7- &f%max%'
      charges:
        enabled: true
        name: Charges
        format:
          main: '&7%name%: &f%value%'
          value:
            default: '&f%min%&7/&f%max%'
            unlimited: Unlimited
        break-items-on-zero:
          enabled: true
          excluded-modules:
            - item_generator
      requirements:
        user:
          dynamic:
            enabled: true
            format:
              'true': '&a&l✓ &r&a'
              'false': '&c&l✗ &r&c'
          level:
            enabled: true
            name: Player Level
            format:
              main: '&c%state%%name%: &f%value%'
              value:
                single: '%min%+'
                range: '%min%-%max%'
          class:
            enabled: true
            name: Player Class
            format:
              main: '&c%state%%name%: %value%'
              max-classes-per-line: -1
              value:
                separator: '&7/'
                color: '&f'
                newline: '&r  '
          banned-class:
            enabled: true
            name: Banned Player Class
            format:
              main: '&c%state%%name%: %value%'
              max-classes-per-line: -1
              value:
                separator: '&7/'
                color: '&f'
                newline: '&r  '
        item:
          level:
            enabled: true
            name: Item Level
            format:
              main: '&c▸ %name%: %value%'
              value:
                single: '%min%+'
                range: '%min% ~ %max%'
          module:
            enabled: true
            name: Item Module
            format:
              main: '&c▸ %name%: %value%'
              value:
                separator: '&7/'
                color: '&f'
          type:
            enabled: true
            name: Item Type
            format:
              main: '&c▸ %name%: %value%'
              value:
                separator: '&7/'
                color: '&f'
          socket:
            name: Socket Type
            format:
              main: '&c▸ %name%: %value%'
          tier:
            enabled: true
            name: Tier
            format:
              main: '&c▸ %name%: %value%'
      enchantments:
        format:
          main: '&c▸ %name% %value%'
          max-roman: 10
  fabled-attribute-format: '&7%attrPre%&3%name%&7%attrPost%'

---

💬 Notes

• Durability formats (format-list) support both numerical and graphical representations like bars or status text.
• All placeholders like %min%, %max%, %percent%, and %name% will be replaced in-game.
• ✓ and ✗ symbols can be customized via the dynamic.requirements.format section.

---

🔗 Related

• engine-attributes – Controls how stats apply
• config-tiers – For tier formatting used in item names
• config-item-definitions – For item categories and groups