SentryLore

Below you will find the complete, copy-ready configuration files for SentryLore. We provide tabbed variants for visual elements (menu/gui.yml and messages.yml): our recommended Small Caps version for an elite RPG aesthetic, and a Standard Font version if your community prefers native Minecraft typography.

Core Configuration (`config.yml`)

The config.yml controls database persistence, Discord webhook logging, NBT dupe protection, and the primary RPG lore formatting rules.

config.yml

# ==============================================================================
# SentryLore - Production Configuration
# Build: v1.0.0 | Folia / Paper / Purpur
# ==============================================================================

# Developer debugging (keep false in production)
dev-mode:
  enabled: false

# Restrict /lore settings GUI to operators
admin-only-settings: true

# Database Configuration (Used for Item Registry & Backups)
database:
  type: "H2" # Options: H2, MYSQL, SQLITE
  mysql:
    host: "127.0.0.1"
    port: 3306
    database: "sentrylore"
    username: "root"
    password: "your_secure_password"

# Discord Webhook Logging
discord:
  enabled: false
  webhook-url: "https://discord.com/api/webhooks/your_webhook_url"
  username: "SentryLore Item Logs"
  avatar-url: "https://sentrystudios.org/logo/favicon.png"
  embed-color: "#3B82F6"
  buttons:
    namemc: true
    docs: true
    discord: true

# Hardware NBT Dupe Protection Engine
dupe-protection:
  enabled: true
  unstackable-only: true
  deep-shulker-scan: true
  discord-alerts: true

# Core Lore Text Symbols & Indentation
formatting:
  title-symbol: "◆"
  stat-symbol: "■"
  desc-indent: " &f"
  how-to-use-indent: " &f"
  cta-symbol: "▶ "
  value-color: "&#3B82F6"

# Custom Tooltip Layout Order (Tokens: SUBTITLE, DESCRIPTION, SPECIFIC_LORE, INSTRUCTION, SUBTEXT, STATS, CTA, EMPTY_LINE)
layout:
  enabled: false
  default:
    - "SUBTITLE"
    - "EMPTY_LINE"
    - "DESCRIPTION"
    - "SPECIFIC_LORE"
    - "EMPTY_LINE"
    - "INSTRUCTION"
    - "EMPTY_LINE"
    - "SUBTEXT"
    - "EMPTY_LINE"
    - "STATS"
    - "EMPTY_LINE"
    - "CTA"
  categories: {}
  rarities: {}
  items: {}

# Rarity Color Gradients & Badges
rarities:
  COMMON:
    gradient-start: "#A9A9A9"
    gradient-end: "#D3D3D3"
    prefix: " &8◆ &7"
  UNCOMMON:
    gradient-start: "#55FF55"
    gradient-end: "#AAFFAA"
    prefix: " &8◆ &a"
  RARE:
    gradient-start: "#00AAFF"
    gradient-end: "#55FFFF"
    prefix: " &8◆ &b"
  EPIC:
    gradient-start: "#AA00AA"
    gradient-end: "#FF55FF"
    prefix: " &8◆ &d"
  LEGENDARY:
    gradient-start: "#FFAA00"
    gradient-end: "#FFFF55"
    prefix: " &8◆ &6"
  MYTHICAL:
    gradient-start: "#FF5555"
    gradient-end: "#FFAAAA"
    prefix: " &8◆ &c"

# Automated Item Categories
material-categories:
  SWORD: "WEAPON"
  BOW: "RANGED"
  CROSSBOW: "RANGED"
  TRIDENT: "WEAPON"
  MACE: "HEAVY WEAPON"
  PAINTING: "CANVAS"
  DIAMOND_HELMET: "ARMOR"
  DIAMOND_CHESTPLATE: "ARMOR"
  DIAMOND_LEGGINGS: "ARMOR"
  DIAMOND_BOOTS: "ARMOR"
  NETHERITE_HELMET: "ARMOR"
  NETHERITE_CHESTPLATE: "ARMOR"
  NETHERITE_LEGGINGS: "ARMOR"
  NETHERITE_BOOTS: "ARMOR"

# Default Lore Descriptions
default-descriptions:
  WEAPON: "A finely balanced blade forged for combat."
  RANGED: "Designed for precise, high-velocity strikes."
  ARMOR: "Reinforced protective plating."
  CANVAS: "A pristine decorative artwork."
  TOOL: "Engineered for resource extraction."

In-Game GUI Configuration (`menu/gui.yml`)

Select your preferred font style below for the /lore, /lore edit, and /lore registry menus:

Small Caps (Recommended)
Standard Font (Vanilla)

Our signature aesthetic featuring sleek Unicode small-caps typography:

menu/gui.yml (Small Caps)

gui:
  admin:
    title: '&#3B82F6sᴇɴᴛʀʏʟᴏʀᴇ'
    size: 27
    fill: BLACK_STAINED_GLASS_PANE
    items:
      format-held:
        slot: 11
        material: ANVIL
        name: '&#FFAA00ғᴏʀᴍᴀᴛ ʜᴇʟᴅ ɪᴛᴇᴍ'
        lore:
          - '&8&nᴀᴄᴛɪᴏɴ'
          - ''
          - ' &fRe-formats the item currently in'
          - ' &fhand using active config rules.'
          - ''
          - '&#FFAA00&nᴄʟɪᴄᴋ ᴛᴏ ғᴏʀᴍᴀᴛ'
      backup:
        slot: 13
        material: ENDER_CHEST
        name: '&#B6D9D8ʙᴀᴄᴋᴜᴘ ᴍᴀɴᴀɢᴇʀ'
        lore:
          - '&8&nᴀᴄᴛɪᴏɴ'
          - ''
          - ' &fManage snapshot backups and'
          - ' &frestore custom item databases.'
          - ''
          - '&#B6D9D8&nᴄʟɪᴄᴋ ᴛᴏ ᴏᴘᴇɴ ʙᴀᴄᴋᴜᴘs'
      registry:
        slot: 15
        material: CHEST
        name: '&#00B4D8ᴄᴜsᴛᴏᴍ ɪᴛᴇᴍ ʀᴇɢɪsᴛʀʏ'
        lore:
          - '&8&nᴀᴄᴛɪᴏɴ'
          - ''
          - ' &fBrowse, give, and inspect all'
          - ' &fsaved custom items in database.'
          - ''
          - '&#00B4D8&nᴄʟɪᴄᴋ ᴛᴏ ᴏᴘᴇɴ ʀᴇɢɪsᴛʀʏ'
      settings:
        slot: 22
        material: COMPARATOR
        name: '&#A9C8FFsᴇᴛᴛɪɴɢs ᴍᴀɴᴀɢᴇʀ'
        lore:
          - '&8&nɴᴀᴠɪɢᴀᴛɪᴏɴ'
          - ''
          - ' &fConfigure in-game options and'
          - ' &fauto-formatting toggles.'
          - ''
          - '&#A9C8FF&nᴄʟɪᴄᴋ ᴛᴏ ᴏᴘᴇɴ sᴇᴛᴛɪɴɢs'

Standard native Minecraft capitalization without special Unicode glyphs:

menu/gui.yml (Standard Font)

gui:
  admin:
    title: '&#3B82F6SentryLore'
    size: 27
    fill: BLACK_STAINED_GLASS_PANE
    items:
      format-held:
        slot: 11
        material: ANVIL
        name: '&#FFAA00Format Held Item'
        lore:
          - '&8&nAction'
          - ''
          - ' &fRe-formats the item currently in'
          - ' &fhand using active config rules.'
          - ''
          - '&#FFAA00&nClick to Format'
      backup:
        slot: 13
        material: ENDER_CHEST
        name: '&#B6D9D8Backup Manager'
        lore:
          - '&8&nAction'
          - ''
          - ' &fManage snapshot backups and'
          - ' &frestore custom item databases.'
          - ''
          - '&#B6D9D8&nClick to Open Backups'
      registry:
        slot: 15
        material: CHEST
        name: '&#00B4D8Custom Item Registry'
        lore:
          - '&8&nAction'
          - ''
          - ' &fBrowse, give, and inspect all'
          - ' &fsaved custom items in database.'
          - ''
          - '&#00B4D8&nClick to Open Registry'
      settings:
        slot: 22
        material: COMPARATOR
        name: '&#A9C8FFSettings Manager'
        lore:
          - '&8&nNavigation'
          - ''
          - ' &fConfigure in-game options and'
          - ' &fauto-formatting toggles.'
          - ''
          - '&#A9C8FF&nClick to Open Settings'

Messages Configuration (`messages.yml`)

Small Caps (Recommended)
Standard Font (Vanilla)

messages.yml (Small Caps)

success:
  reload: " &#10B985sᴜᴄᴄᴇss &#64748B• &fConfiguration reloaded. &#64748B(%time%)"
  item-saved: " &#10B985sᴜᴄᴄᴇss &#64748B• &fItem saved as &#3B82F6%id%"
  item-formatted: " &#10B985sᴜᴄᴄᴇss &#64748B• &fHeld item re-formatted successfully."
  item-give: " &#10B985sᴜᴄᴄᴇss &#64748B• &fGave &#3B82F6%id% &fto &#60A5FA%player%."
  item-receive: " &#3B82F6ɪᴛᴇᴍ ʀᴇᴄᴇɪᴠᴇᴅ &#64748B• &fAdded &#3B82F6%id% &fto your inventory."
  editor-saved: " &#10B985sᴜᴄᴄᴇss &#64748B• &fUpdated &#3B82F6%type% &ffor &#60A5FA%material%."
  backup-created: " &#10B985sᴜᴄᴄᴇss &#64748B• &fCreated database backup: &#3B82F6%file%"
  backup-restored: " &#10B985sᴜᴄᴄᴇss &#64748B• &fRestored database backup from: &#3B82F6%file%"

error:
  player-only: " &#EF4444ᴇʀʀᴏʀ &#64748B• &fThis command can only be executed by in-game players."
  no-permission: " &#EF4444ᴇʀʀᴏʀ &#64748B• &fYou do not have permission (sentrylore.admin)."
  no-item: " &#EF4444ᴇʀʀᴏʀ &#64748B• &fYou must be holding an item in your main hand."
  player-not-found: " &#EF4444ᴇʀʀᴏʀ &#64748B• &fThe target player could not be found."
  invalid-id: " &#EF4444ᴇʀʀᴏʀ &#64748B• &fNo registered item exists with ID: %id%"
  dupe-detected: " &#EF4444ᴇʀʀᴏʀ &#64748B• &fDupe protection cancelled illegal item replication."

messages.yml (Standard Font)

success:
  reload: " &#10B985SUCCESS &#64748B• &fConfiguration reloaded. &#64748B(%time%)"
  item-saved: " &#10B985SUCCESS &#64748B• &fItem saved as &#3B82F6%id%"
  item-formatted: " &#10B985SUCCESS &#64748B• &fHeld item re-formatted successfully."
  item-give: " &#10B985SUCCESS &#64748B• &fGave &#3B82F6%id% &fto &#60A5FA%player%."
  item-receive: " &#3B82F6ITEM RECEIVED &#64748B• &fAdded &#3B82F6%id% &fto your inventory."
  editor-saved: " &#10B985SUCCESS &#64748B• &fUpdated &#3B82F6%type% &ffor &#60A5FA%material%."
  backup-created: " &#10B985SUCCESS &#64748B• &fCreated database backup: &#3B82F6%file%"
  backup-restored: " &#10B985SUCCESS &#64748B• &fRestored database backup from: &#3B82F6%file%"

error:
  player-only: " &#EF4444ERROR &#64748B• &fThis command can only be executed by in-game players."
  no-permission: " &#EF4444ERROR &#64748B• &fYou do not have permission (sentrylore.admin)."
  no-item: " &#EF4444ERROR &#64748B• &fYou must be holding an item in your main hand."
  player-not-found: " &#EF4444ERROR &#64748B• &fThe target player could not be found."
  invalid-id: " &#EF4444ERROR &#64748B• &fNo registered item exists with ID: %id%"
  dupe-detected: " &#EF4444ERROR &#64748B• &fDupe protection cancelled illegal item replication."

Production Use-Case Presets

1. MMORPG Dungeon Loot Template
2. Competitive Factions Minimalist Template
3. Lifesteal SMP Heart & Bloodline Template
4. OP Prison Explosive Pickaxe & Multiplier Template
5. Anarchy / Vanilla+ Clean Layout Template

Tailored for servers with complex boss drops and equipment stats:

config.yml (MMORPG Lore Preset)

formatting:
  title-symbol: "⚔"
  stat-symbol: "✦"
  cta-symbol: "» "
  value-color: "&#F59E0B"

layout:
  enabled: true
  default:
    - "SUBTITLE"
    - "EMPTY_LINE"
    - "STATS"
    - "EMPTY_LINE"
    - "DESCRIPTION"
    - "EMPTY_LINE"
    - "INSTRUCTION"
    - "EMPTY_LINE"
    - "CTA"

Sleek, compact layout designed to keep combat tooltips short and readable during intense PvP:

config.yml (Factions Lore Preset)

formatting:
  title-symbol: "◆"
  stat-symbol: "•"
  cta-symbol: "› "
  value-color: "&#3B82F6"

layout:
  enabled: true
  default:
    - "SUBTITLE"
    - "EMPTY_LINE"
    - "STATS"
    - "EMPTY_LINE"
    - "DESCRIPTION"

Engineered for Lifesteal servers with blood-red accents (&#EF4444), heart theft modifiers, and kill counter badges:

config.yml (Lifesteal Lore Preset)

formatting:
  title-symbol: "❤"
  stat-symbol: "▪"
  cta-symbol: "⚔ "
  value-color: "&#EF4444"
  desc-indent: " &c"

layout:
  enabled: true
  default:
    - "SUBTITLE"
    - "EMPTY_LINE"
    - "STATS"
    - "EMPTY_LINE"
    - "SPECIFIC_LORE"
    - "EMPTY_LINE"
    - "INSTRUCTION"
    - "EMPTY_LINE"
    - "CTA"

# Bloodline rarity palette for custom lifesteal equipment
rarities:
  COMMON:
    prefix: "&#94A3B8"
  UNCOMMON:
    prefix: "&#38BDF8"
  RARE:
    prefix: "&#A855F7"
  EPIC:
    prefix: "&#F59E0B"
  LEGENDARY:
    prefix: "&#EF4444&l"

Designed for Prison and Mine networks requiring multi-million token indicators, explosive mining enchants, and neon prestige palettes:

config.yml (OP Prison Lore Preset)

formatting:
  title-symbol: "⛏"
  stat-symbol: "◆"
  cta-symbol: "⚡ "
  value-color: "&#8B5CF6"
  desc-indent: " &d"

layout:
  enabled: true
  default:
    - "SUBTITLE"
    - "EMPTY_LINE"
    - "STATS"
    - "EMPTY_LINE"
    - "DESCRIPTION"
    - "EMPTY_LINE"
    - "SUBTEXT"
    - "EMPTY_LINE"
    - "CTA"

rarities:
  COMMON:
    prefix: "&#94A3B8"
  RARE:
    prefix: "&#06B6D4"
  EPIC:
    prefix: "&#8B5CF6"
  LEGENDARY:
    prefix: "&#EC4899&l"
  MYTHIC:
    prefix: "&#FACC15&l"

Ultra-clean layout preserving native vanilla item feel while showing essential durability and sharpness tiers for crystal and anchor PvP:

config.yml (Vanilla+ Anarchy Preset)

formatting:
  title-symbol: "•"
  stat-symbol: " "
  cta-symbol: " "
  value-color: "&#10B985"
  desc-indent: " &7"

layout:
  enabled: true
  default:
    - "SUBTITLE"
    - "EMPTY_LINE"
    - "STATS"

Overview

Core Concepts

GUI + Config Templates

Developer API

SentryWipe

SentrySettings

Configurations

SentryLore

Core Configuration (`config.yml`)

In-Game GUI Configuration (`menu/gui.yml`)

Messages Configuration (`messages.yml`)

Production Use-Case Presets

​ Core Configuration (config.yml)

​ In-Game GUI Configuration (menu/gui.yml)

​ Messages Configuration (messages.yml)

​ Production Use-Case Presets

Core Configuration (`config.yml`)

In-Game GUI Configuration (`menu/gui.yml`)

Messages Configuration (`messages.yml`)

Production Use-Case Presets