⚔️ RoyItems — Version 2026.1.4

🌟 Highlights

• Crafting Station GUI Engine: Create unlimited custom workstations and forges with multi-currency recipes, client-language translation, and NPC support.
• Packet-Based Training Dummy System: Test weapon damage and DPS with client-side packet entities and live Text Display holograms—zero tick overhead on your server!
• Combat & Attribute Accuracy Overhaul: Suppressed vanilla material attribute drift and eliminated double-counting bugs on attack damage.

---

✨ New Features & Enhancements

• Modular Crafting Stations (crafting-station/<station_id>.yml):

  • Create unlimited crafting stations with customizable GUI sizes (9 to 54 slots).
  • Menu titles fully support MiniMessage, Hex colors, and PlaceholderAPI.
  • Define custom command shortcuts with dynamic tab-completion that register automatically upon config reload.
  • Native NPC binding: Right-click NPCs from FancyNpcs or Citizens to open designated stations instantly.
  • Decorative background items supporting slot ranges (e.g. 1-9), clickable actions ([player], [console], [sound]), and textures from Vanilla, Nexo, ItemsAdder, Oraxen, HeadDatabase, and custom Base64 heads.
  • Multi-currency & multi-item recipe inputs and outputs:
    • RoyItems custom items (royitems[...])
    • Vanilla materials (vanilla[...])
    • Vault economy (money=X)
    • Experience points (exp=X)
    • PlayerPoints (point=X)
    • ExcellentEconomy currencies (excellenteconomy:<id>=X)
  • Dynamic client-side language translation: Vanilla item names in recipes and lore adapt to each player's Minecraft client language setting.

• Packet-Based Training Dummies & DPS Holograms:

  • Spawn packet-based dummies anywhere with /ri dummy spawn <dummy_id> [mob_type].
  • Runs 100% client-side via PacketEvents / ProtocolLib with zero impact on server main thread or TPS.
  • Immune to /kill @e, clear-lag plugins, entity purges, and world mob sweeps.
  • WorldGuard bypass: Dummies spawn and register hits seamlessly inside protected regions, spawns, and PvP-disabled zones.
  • Text Display Holograms: Track and display real-time DPS, Total Damage, Last Hit, and Hit Count with MiniMessage and color gradients.
  • Per-dummy YAML configuration in plugins/RoyItems/dummy/<dummy_id>.yml for idle/combat lines, billboard angles, shadows, and background colors.
  • Safe hot-reload: No ghost entities or detached holograms when reloading via /ri reload or PlugmanX.

• Attribute Isolation & Precision:

  • Default vanilla armor and weapon attributes (inherent armor points on armor and damage on swords) are now cleanly suppressed, ensuring players only receive stats explicitly configured in RoyItems.
  • Clean number formatting on dummy holograms: whole numbers display cleanly (e.g. 6 instead of 6.0), while decimals display with one decimal place (e.g. 6.5).

---

🐛 Bug Fixes

• Fixed Attack Damage Double-Counting: Fixed an issue where attacking a training dummy with a weapon having attack-damage: 6 displayed 13 damage due to the flat modifier being counted both in the player's attribute instance and the stat calculator. Weapons now deal and display exactly their configured damage.
• Fixed Crafted Item Stacking: Fixed an issue where items crafted from stations could not stack together due to subtle NBT divergence. Crafted outputs now stack properly.
• Fixed Max-Health Stat Application: Resolved an issue where the max-health attribute was not properly adding health when items were equipped in certain armor slots or hand slots.
• Fixed Client Disconnect on Packet Dummy Spawn: Resolved a client protocol error on modern Minecraft versions by synchronizing Text Display packet metadata indices to modern 1.20+/1.21+ standards.

---

📋 New Commands & Permissions

Command	Permission	Description
/ri station open <station_id> [player]	royitems.command.station.open	Opens a crafting station GUI directly
/ri station list or /ri stations	royitems.command.station.list	Opens the global Crafting Stations list menu
/ri dummy spawn <dummy_id> [mob_type]	royitems.command.dummy	Spawns a packet-based training dummy centered at target block
/ri dummy despawn <dummy_id|all>	royitems.command.dummy	Despawns a specific training dummy or all active dummies