User Guide

Warning

This wiki may be outdated due to its beta release and breaking changes may happen often. Please check the default resources on GitHub for up-to-date examples.

The Lore Template Engine lets you define custom item lore/tooltips through config.

Items are tagged with a template ID (via PDC), and their lore is generated from that template whenever the item changes (crafting, enchanting, admin commands, ...).

The config is split into three layers:

• Variables single values read from an item (rarity, item_level)
• Groups lists of values read from an item (enchantments, tags)
• Templates arrange variables and groups into an actual lore layout

Each concept has its own page. Once you understand the building blocks, read how to apply a template to an item.

KDL

All config definitions use the KDL document language.

More info at https://kdl.dev

Command overview

Command	Permission	Description
/lore reload	lte.command.reload	Reloads config and rebuilds all templated items
/lore rebuild [player]	lte.command.rebuild	Rebuilds your (or a target player's) templated items
/lore set template <id>	lte.command.set.template	Tags the item in hand with a template
/lore set variable <name> <value>	lte.command.set.variable	Sets a variable PDC value on the item in hand
/lore set group <name> <values...>	lte.command.set.group	Overwrites and sets group PDC values on the item in hand
/lore group add <name> <values...>	lte.command.group.add	Appends value(s) to a group on the item in hand
/lore group setslot <name> <index> <value>	lte.command.group.setslot	Sets a specific 1-based slot value in a group
/lore group removeat <name> <index>	lte.command.group.removeat	Removes a value at a 1-based slot index in a group
/lore group remove <name> <value>	lte.command.group.remove	Removes the first occurrence of a value from a group
/lore group clear <name>	lte.command.group.clear	Clears all values from a group on the item in hand

lore and lte are aliases for the same command.