> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sentrystudios.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Features & Use Cases

> Discover SentryLore's dynamic RPG engine, 51-painting canvas catalog, in-game item editor, and NBT dupe protection.

SentryLore transforms vanilla Minecraft items into a rich, immersive RPG experience. Combining automated item classification, a full 51-painting canvas catalog, an interactive in-game editor, and hardware-accelerated NBT dupe protection, SentryLore sets the gold standard for server itemization.

***

## Dynamic RPG Formatting Engine

SentryLore automatically parses vanilla and custom items, injecting sleek small-caps rarity headers, categorized badges, stat breakdowns, and custom lore blocks without requiring manual configuration for thousands of materials.

> **Automated Categories**
>
> Items are categorized into `SWORD`, `BOW`, `ARMOR`, `TOOL`, `CANVAS`, and `MISC` with custom Small Caps styling.

> **Tiered Rarities**
>
> Six balanced loot tiers: **COMMON**, **UNCOMMON**, **RARE**, **EPIC**, **LEGENDARY**, and **MYTHICAL** with Hex styling.

> **Live Stat Formatting**
>
> Dynamically tracks attack speed, damage, armor toughness, durability percentages, and custom attributes.

### Loot Rarity Color Swatches

**Standard Tiers**

**COMMON** `#AAAAAA`

**UNCOMMON** `#55FF55`

**RARE** `#55FFFF`

**Prestige Tiers**

**EPIC** `#FF55FF`

**LEGENDARY** `#FFAA00`

**MYTHICAL** `#FF5555`

![SentryLore Weapon Tooltip](https://mintcdn.com/sentrystudios/FMIaJt_G0MJ4Ro6T/images/lore_sword.png?fit=max\&auto=format\&n=FMIaJt_G0MJ4Ro6T\&q=85\&s=28644ae36b9c1e483362cffdb24ffcb2)

![SentryLore Armor Tooltip](https://mintcdn.com/sentrystudios/FMIaJt_G0MJ4Ro6T/images/lore_armor.png?fit=max\&auto=format\&n=FMIaJt_G0MJ4Ro6T\&q=85\&s=f7707540afd55109f949bcc68fb081d7)

***

## Canvas Painting & Entity Protection System

SentryLore features a specialized **Canvas Engine** specifically built for decorative and collectible server items:

> **51 Canvas Painting Catalog**
>
> Every vanilla painting variant is cataloged with custom rarities (COMMON up to EPIC max), formatted under the `CANVAS` category with clean artist attribution.

> **Entity Tag Suppression**
>
> Automatically suppresses floating nametags when placing paintings, spawn eggs, or entity items in the world—keeping your builds pristine and uncluttered.

![SentryLore Canvas Painting Tooltip](https://mintcdn.com/sentrystudios/FMIaJt_G0MJ4Ro6T/images/lore_canvas.png?fit=max\&auto=format\&n=FMIaJt_G0MJ4Ro6T\&q=85\&s=1594e56c402ddf439fa0a804eb2b9f57)

### Key Canvas Engine Highlights

* **`HIDE_ADDITIONAL_TOOLTIP` Flag:** Strips ugly vanilla Minecraft 1.20.5+ author and dimension tags, replacing them with Sentry's sleek, branded small-caps layout.
* **Placement Cleanliness:** Intercepts `HangingPlaceEvent`, `CreatureSpawnEvent`, and `EntityPlaceEvent` to ensure spawned entities do not show floating custom names.
* **Rarity Capping:** Decorative paintings are strictly balanced between `COMMON` and `EPIC`, preserving `LEGENDARY` and `MYTHICAL` tiers for ultra-rare quest artifacts.

***

## In-Game Lore Editor (`/lore edit`)

Staff members can modify any held item visually without ever touching a configuration file.

![SentryLore In-Game Editor GUI](https://mintcdn.com/sentrystudios/FMIaJt_G0MJ4Ro6T/images/lore_editor.png?fit=max\&auto=format\&n=FMIaJt_G0MJ4Ro6T\&q=85\&s=a6f5f2b2f03d7ca9974e4351b4e8fe36)

* **Rarity Switcher:** Cycle through rarity tiers with a single click; colors and header badges update in real time.
* **Live Description & Instructions:** Set customized lore lines, item origins, and call-to-actions directly through chat prompts.
* **Dynamic Stat Tuning:** Add or modify attack damage, defense attributes, and custom NBT flags visually.

***

## Custom Item Database Registry (`/lore registry`)

Save your server's custom weapons, dungeon loot, and crate keys directly to the persistent database:

```bash theme={null}
# Hold your custom item in main hand
/lore save excalibur_v1
```

Once saved to the registry, distribute it via commands or console scripts:

```bash theme={null}
/lore give Notch excalibur_v1
```

![SentryLore Item Registry GUI](https://mintcdn.com/sentrystudios/FMIaJt_G0MJ4Ro6T/images/lore_registry.png?fit=max\&auto=format\&n=FMIaJt_G0MJ4Ro6T\&q=85\&s=ff0dd21124133e48a2bead50aeeb4a0c)

### Hardware NBT Dupe Protection

Every item generated through `/lore give` receives a cryptographically secure, random NBT UUID (`sentrylore_uuid`). SentryLore monitors inventory clicks, container transfers, and drops:

* **Duplicate Detection:** If two items with the identical UUID exist in an inventory, the duplicated item is instantly neutralized.
* **Stacking Protection:** Unstackable RPG items are locked against illegal stacking exploits.

> **Creative Mode & Outside-Slot Protection (v1.0.1)**
>
> Staff in Creative Mode (`GameMode.CREATIVE`), server operators, and players with `sentrylore.dupebypass` or `sentrylore.admin` are granted full bypass to prevent accidental item clearance. The engine intelligently ignores out-of-boundary container clicks (`rawSlot < 0`) and block placements.

***

## Popular Production Use Cases

> **MMORPG & Dungeon Loot Tables**
>
> Format boss mob drops automatically. Register unique relics using `/lore save <id>` and distribute them as MythicMobs rewards or quest completion prizes.

> **Web Store & Crate Packages**
>
> Instead of typing complex 20-line lore strings into your Crates or Tebex/Buycraft commands, simply execute `/lore give %player% <id>` for seamless delivery.

> **Factions & Competitive SMP Itemization**
>
> Give your server's diamond and netherite gear a clean, branded feel with custom Small Caps categories, live durability percentages, and clean enchant lists.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.