LuminItems

✨ Key Features

• Custom items from YAML — name, lore (with hex colors), enchants, item flags, custom model data, unbreakable, glow, and more.
• Full RPG stat system on top of vanilla attributes: max mana, mana regen, virtual health, defense, all/melee/projectile/skill damage, critical chance & damage, lifesteal, cooldown reduction, mana cost reduction.
• Virtual health pool — real RPG HP separate from vanilla hearts, shown proportionally on the vanilla heart bar and precisely in the action bar, so high-HP builds never break the client HUD.
• Ability / skill triggers bound to MythicMobs skills: right-click, left-click (including on entities), on-attack, on-kill, on-shoot-bow, on-block-break/place, on-consume, on-drop, when-hit, on-sneak, on-respawn, and a passive timer with conditions (sneaking, sprinting, low health).
• Armor sets — define set bonuses (potion effects) in one file; players get them automatically once all 4 pieces of a set are equipped, with a compatibility/joker-piece system for mix-and-match sets.
• Accessory system — a dedicated 4-slot accessory menu (/li accessories) for trinket-style items that grant stats and passive abilities without occupying armor or hand slots.
• Player head armor — wearable custom-skin heads (by username, texture URL, or base64) that function as full armor pieces with stats and set bonuses.
• Combat pipeline — a unified outgoing-damage system that applies your RPG damage stats consistently across melee, projectiles, MythicMobs skills, and player-owned summons/pets.
• Homing arrows — optional, configurable auto-aim for bows, with search radius, turn strength, line-of-sight requirement, and a max-duration safety cap.
• ItemsAdder integration — pull base items directly from your ItemsAdder namespace, including leather-armor dye colors.
• PlaceholderAPI support for displaying player stats elsewhere.
• Networked item tracking & dupe detection (optional) — via a shared SKVS database, know exactly who holds a unique item or where it last was seen, across your entire network, plus a /li dupecheck scanner for duplicated unique-ID items.
• Safe hot-reloading — /li reload refreshes items, armor sets, and config without a restart, while re-syncing already-issued items on player join.

⚙️ Requirements

• Java 17, Spigot/Paper 1.20.x–1.21.x
• No hard dependencies — works standalone out of the box

Soft Dependencies
(all optional, auto-detected)

• MythicMobs
• MythicLib
• ItemsAdder
• PlaceholderAPI
• LXDungeon
• SkvsInventory (required only for cross-server item tracking)

Database Support
Networked item tracking and dupe-checking work only with SKVS (the same shared plugins/.skvs/config.txt used by SkvsInventory). No other database backend (MySQL, SQLite, MongoDB, etc.) is supported, and none is planned. If SKVS isn't installed/configured, these features simply stay disabled and the rest of the plugin works normally.

⚠️ Support Disclaimer
This plugin was originally built for my own server and is shared here as-is, in case it's useful to someone else. I do not provide support for it — no guaranteed bug fixes, feature requests, or response times. Issues and pull requests on GitHub are welcome, but use it at your own risk.


Commands
/luminitems (aliases: /li, /lumin) — permission: luminitems.admin (default: OP)


What's Included
A ready-to-use set of example items — a triggered sword, a mana staff, a hex-colored chestplate, an ItemsAdder helmet, a full 4-piece armor set with set-bonus effects, a custom player-head helmet, a stackable material, and seven pre-built accessory "runes" — so you can see every feature working before writing a single item file of your own.


Documentation
Full setup, YAML reference, and every config option are covered in the resource's documentation tab / attached documentation file.