v1.0.2

Stability and compatibility update focused on robust tooltip rebuilding.

Highlights

• Reworked tooltip ownership to a marker-based system (deterministic + idempotent).
• Removed fragile lore-position dependencies from previous behavior.
• Better compatibility with external /lore and enchant modifications.
• Preserves third-party/admin lore while rebuilding Descriptioner-managed lines.
• Stable enchant ordering for consistent visual output.
• Added background normalization command for bulk cleanup.

Admin Command

/descriptioner normalize [batchSize]

• Runs in background batches.
• Useful to normalize existing items after updates.

Compatibility

• Paper/Purpur 1.21.4
• Java 21

v1.0.1

• Fixed tooltip re-injection after external lore edits (e.g. Essentials /lore add).
• Preserved third-party lore order below enchantment descriptions.
• Fixed color inheritance so non-overridden levels correctly use global normal-name-color / normal-level-color.

v1.0.0

Descriptioner v1.0.0

Initial public release of Descriptioner.

Descriptioner adds localized vanilla enchantment descriptions directly into item tooltips for Paper/Purpur 1.21.4, with optional advanced styling controls.

Features

• Adds readable description lines for vanilla enchantments in item tooltips
• Supports regular enchanted items and enchanted books
• Supports localized descriptions via YAML language files
• Bundled locales:
  • en_US
  • es_ES
• Configurable active language with fallback support
• Optional enchant title styling system with:
  • per-enchant overrides
  • per-level overrides
  • custom name/level segment templates
  • placeholder support ({name}, {level_roman}, {level_arabic})
  • hex and named color support
• Handles tooltip updates in common inventory/anvil interaction flows

Technical

• Built for Paper API 1.21.4-R0.1-SNAPSHOT
• Kotlin + Adventure Components
• Gradle Shadow build included
• Java 21 required

Configuration Notes

• Main config: plugins/Descriptioner/config.yml
• Language files: plugins/Descriptioner/languages/*.yml
• YAML uses spaces (tabs are auto-normalized at startup with backup)

Known Notes

• Focused on vanilla enchantment descriptions by design
• Does not include custom-enchant frameworks, commands, or GUI layer

Download

Use the jar from this release assets and place it in your server plugins/ folder.