Toggle & Magnet Permission Enforcement: Added proper permission checks for lootglow.toggle and lootglow.magnet to prevent unauthorized players from using commands.
Instant Glow Sync: Standard ground items now instantly update their glowing status on the client when toggling visuals.
LOD Distance Respect: Toggling visuals ON now strictly respects configured LOD distances instead of rendering everything in the world at once, avoiding client lag.
Tab-Completion Filter: Autocomplete recommendations (/lg reload/toggle/magnet) are now dynamically filtered based on the player's active permissions.
Thread Safety & Performance
Netty Concurrency Fixes: Swapped unsafe collections (HashSet, HashMap) used by packet listeners on async Netty threads with thread-safe alternatives (ConcurrentHashMap and key sets). This prevents potential ConcurrentModificationException and severe CPU lock loops.
NamespacedKey Allocation Cache: Cached all NamespacedKey instances (Oraxen, ItemsAdder, MMOItems, Nexo, MythicMobs, MythicDrops, etc.) used inside the highly frequent getInternalId method. This saves thousands of object allocations per second under heavy drop rates, reducing GC overhead.
Dynamic Crop Scan Radius: Bounded the farming scan radius dynamically to the configured farming.view-distance (up to 16 blocks). This saves up to 72% block lookups per player for lower view distances, drastically reducing CPU overhead.
Bug Fixes & QoL
Invisible RPG Drops Fix: Fixed a critical issue where players with visuals toggled OFF could not see or pick up vanilla RPG drops after joining or changing worlds due to setVisibleByDefault(false) persistence.
Crop Visual Toggle & Spawn Fix: Fixed an issue where new crop visuals reappeared or existing crop visuals did not disappear for players with visuals disabled, by ensuring crop displays are properly hidden by default (setVisibleByDefault(false)) and correctly tracked in player visibility sets upon spawning and chunk loading.
Smart Item Magnet: The item magnet task now checks if the player's inventory has available space before pulling items. This prevents items from crowding and floating around players with full inventories.
Loot Container Index Fix: Fixed a potential IndexOutOfBoundsException in the loot container listener when players clicked outside the interface (causing negative slot indices).
Config Reload Leak Fix: Fixed a memory leak where active items, world maps, entity ID maps, hidden vanilla items, crop symbols, and player visibility tracking sets (visibleEntities) were not properly cleared or removed on configuration reload (/lg reload). This also ensures crop symbol configuration changes (material, color, scale, offset) apply instantly upon reload.
World Change Cleanups: Improved visual tracking and cleanup tasks when teleporting across worlds to prevent lingering visual artifacts.
Single Lookup Container: Grouped 10+ scattered maps (activeLabels, activeBeams, surfaceStates, itemSpawnTimes, etc.) into a unified TrackedItem structure. This reduces map lookups from 4-8 times per item/tick down to a single O(1) lookup.
Backward Compatibility: Kept external integration and event listeners fully functional without binary/source changes by wrapping access in custom delegating maps.
Garbage Collection Reduction: Replaced delegating maps iterations (activeLabels.values(), etc.) with direct trackedItems iteration to eliminate constant temporary collection and entry set allocations.
Scheduler & Task Optimizations
Lighting Task: Replaced heavy Bukkit.getEntity(uuid) global scans ($O(N)$ world scans) with instant O(1) lookups from our active items cache.
Particle Task: Pre-caches item coordinates once per tick, reducing position lookups from O(Players × Items) down to O(Items).
Farming LOD Task: Optimized farming crop symbol updates by caching the location inside CropSymbol, completely avoiding repetitive world block coordinate lookups.
Farming Scan Bypass: Tracks player movements to skip the heavy 1,445-block crop scan for AFK/stationary players, eliminating block wrapper allocation storms.
Multi-World Particles: Groups cached items by world in the particle task, completely skipping distance checks for players in different worlds.
Chunk Load Allocation Free: Optimized chunk loading player checks, retrieving only players in the chunk's world and checking coordinates directly instead of allocating 5 global primitive arrays per load.
Ray-Trace Throttling
Surface Alignment: Throttled expensive surface alignment ray-tracing to run once every 4 ticks per item instead of every tick, significantly reducing CPU cycles on servers with a large number of ground drops.
Bug Fixes & Stability
Reload Ghost Entities Fix: Fixed a visual leak where item displays and shadows remained as permanent ghost entities floating in the world during config reloads. All visual components are now properly cleaned up.
Root Cause Resolved: MMOItems and MythicLib items were never detected by LootGlow due to a classloader isolation issue — each Spigot plugin runs in its own sandboxed ClassLoader, making standard Class.forName() calls unable to see other plugins' classes. LootGlow now correctly resolves the MythicLib/MMOItems ClassLoader at runtime via Bukkit.getPluginManager().getPlugin() and uses it explicitly.
Version-Independent Wrapper: Detection now uses MythicLib's version-specific NBT wrapper (MythicLib.plugin.getVersion().getWrapper().getNBTItem()), fully compatible with MythicLib 1.7+ and all its snapshots.
Multi-Namespace PDC Fallback: Before triggering reflection, LootGlow now checks all known PDC namespaces where MMOItems stores its data (mmoitems:, mythiclib:, public:) with multiple key variants for maximum compatibility.
Graceful Degradation: If no resolver is found (no MythicLib/MMOItems installed), the system silently skips detection with zero errors. Debug mode now logs every step of the detection pipeline so server admins can instantly diagnose any item mismatch.
Flawless Custom Names: Item drops with custom resource pack translation keys (like those from Nexo) now automatically display their exact custom names on the hologram natively, delegating the translation string beautifully to the client!
UPGRADE: Hologram Content Revamp
Always-On Amounts: The item count format (e.g. `(x1)`, `(x20)`) is now consistently displayed next to the item name on all holograms, keeping your visual loot informative!
FIX: Real-Time Timer Engine
Smooth Countdowns: Completely eliminated the 2-3 second delay stutter on despawn and ownership timers. Hologram timers now tick down precisely and responsively every single second!
We listen to your feedback! Enjoy this polished visual update!
CRITICAL: Active Memory Purge (Zero Leak Architecture) Elimination of a persistent long-term overhead threat.
Real-time Matrix Scrubbing: Visual entities (beams, shadows, labels) now actively clean their UUID registrations from player tracking sets upon despawn or pickup. This stops memory accumulation in its tracks, preventing heap leaks over extended server runtimes.
INTRODUCING: Adaptive Occlusion Engine (Offscreen Culling) Astronomical CPU recovery by strictly tracking real visibility vectors!
Smart Suspended Animation: Dynamic beam and crop animations are now entirely put in stasis if no player is in the vicinity. Prevents heavy main-thread transformation computations and metadata packet transmissions for unseen loot!
ZERO-Allocation Arithmetic Flow Complete restructuring of high-frequency tasks to minimize JVM Garbage Collector pressure.
Allocation-Free Particle Logic: The particle task now performs distance calculations using raw primitive stacks and pre-registered spatial buffers. Object allocation rates dropped to exactly zero!
Optimized Handshakes: Rewrote the right-click interaction listener to prevent heavy object creation iterations during nearby entity validation sweeps.
Deep Physics Guard
Static Block Lockdown: Water physics queries and grounding raycasts are now completely locked down for immobile items. Eliminates redundant heavy NMS collision checks once an item has settled.
EXTREME EFFICIENCY. Unleash the visual experience with minimal server footprint!
INTRODUCING: Hybrid Filtration Matrix (Whitelist / Blacklist) Based on direct high-volume community demand! Total transformation of spatial restriction handling.
Advanced Multi-Vector Logic: Toggle instantly between `BLACKLIST` (Run everywhere EXCEPT these realms) and `WHITELIST` (Lockdown to ONLY designated zones).
Dynamic Dimension Compatibility: Absolute isolation for servers generating infinite instanced realms! Seamlessly whitelist your main worlds while preventing visually rendered clutter across dynamic EliteMobs or Mythic Dungeons sectors automatically.
Precision Routing: Internal engines now block instantiation sequences BEFORE visuals execute, preventing overhead leaks across unrestricted coordinates.
ZERO-EFFORT LEGACY FALLBACK
Automatic Forward Porting: Your legacy configs are perfectly safe! The engine injects auto-compatibility layers to translate deprecated `disabled-worlds` keys into modern blacklist matrix instructions at runtime without breaking existing installations.
MINOR ENGINE POLISH
Persistence Logic Cleanups: Refined state serialization callbacks across inter-modular operations.
TOTAL SPATIAL CONTROL. Configure your realm ecosystem exactly how you need it!
INTRODUCING: The Grid-Matrix Spatial Partitioning Engine: A massive ground-up refactoring of global item computational geometry.
Chunk-Bound Clusters: Total replacement of Global `O(N^2)` iterations with localized `O(Chunk^2)` spatial bucket indices. Comparison operations collapsed by up to 1,000x!
Instant Lone-Item Short-Circuiting: Single items sitting in a chunk now entirely skip all logic gates, consuming mathematically ZERO computational cycle time.
️ ATOMIC VECTORIZATION & ZERO-ALLOCATION: ruthlessly eradicated memory churn from background polling and event listeners!
Vectorized Player Analytics: Player proximity scanning is now mapped into stack-allocated final primitive double arrays. Zero dynamic `Location` objects generated across global loops!
The Chunk Stream Eraser: Applied absolute vector primitive lookups inside the `ChunkLoadEvent` pipeline, destroying thousands of potential GC allocation spikes while players explore via Elytra.
Pure Iterator Pipeline: Swapped auxiliary HashSet cloned sweeps in the Farming Engine for allocation-free removal pointers. RAM footprint stays perfectly static.
⚡ CRITICAL: Shadow Casting & Text Rendering Bypass:
Bypassing Adventure API: Razed the previous shadow projection system (TextDisplay) and replaced it with microscopic, untextured BlockDisplay anchors. Effectively nullifies heavy internal font-width and component serialization checks within the Paper server kernel.
Precision Throttle Scheduling: Upgraded visual update periodicity to 60 Ticks. Halved downstream GSON serialization costs while preserving absolute animation fluidity.
STABILITY & GLOBAL CACHE REMEDIATION:
Total Object Disposal: Fortified the centralized `removeGlow()` logic with atomic map cleans (`surfaceStates`, `entityIdMap`, `labels`). Guarantees 100% holistic purge of references on item removal.
Event-Stream Interception: Injected tracking gates inside `ItemListener.onMerge` to hard-bypass redundant logic loops when targeting already-registered entities.
NEW: The Smart-Snap Surface Engine: A major leap in physical immersion! Your RPG drops no longer just float randomly over block corners; they now possess real architectural awareness!
Millimeter-Perfect Heights: The plugin now performs an instant, ultra-fast raytrace when an item settles. Whether it lands on low slabs, snow layers, carpets, treasure chests, or campfires, the ItemDisplay snaps perfectly to the solid collision layer.
100% Visual Consistency: Holograms, Beams, and Shadows all inherit this intelligent altitude data, anchoring every single visual layer to the exact same baseline.
INTRODUCING: Dynamic Stair Slope Physics: The ultimate RPG detail that sets you apart from any other plugin.
Intelligent Auto-Tilt: Items falling on stairs now automatically calculate the rise angle and dynamically tilt their pitch by 30° to flow parallel with the staircase! No more ugly clipping into architecture.
Axis Flow Alignment: The item automatically realigns its rotation (Yaw) to perfectly match the step's facing direction for a seamless, handcrafted placement feel.
Shadow Depth & Core Optimizations:
True Occlusion Shadows: Rewrote the dynamic shadow logic to leverage the new surface height data. The shadow radius now smoothly expands, blends, and hardens with AAA-level accuracy based on real ground contact!
Zero-Overhead Cache Management: Surface analysis only runs ONCE when the item reaches total stability. With automatic cache disposal on bounce or movement, you gain high-end visual physics with ZERO performance cost.
Resolved Mob Pickup ClassCastException (Critical Hotfix): Resolved a major console error / crash vector that occurred when non-player entities picked up items:
The Bug: Mobs (such as Piglins in the Nether, Allays, Foxes, or any other entities) picking up items triggered EntityPickupItemEvent, causing a silent failure or console spam with java.lang.ClassCastException: CraftPiglin cannot be cast to Player on ItemListener.onPickup(ItemListener.java:117).
The Fix: Added strict type checks to ensure player-only features (such as the aspiration animation, custom container limits, and RMB checks) are only applied when a real player interacts with the item.
Graceful Mob Cleanup: For non-player entities picking up items, the plugin now safely removes the active glow effects (removeGlow) with zero main thread overhead or casting errors.
Code Quality & Event Stability Polish:
Consistent Event Handling: Hardened the listener infrastructure to handle modern Paper 1.21.11 events securely.
Optimized Logic Flow: Simplified the item collection state machine inside ItemListener to isolate player logic from mob interactions perfectly.
Player Quit Cleanup: Added comprehensive player session memory cleanup during PlayerQuitEvent, removing disconnected players from hiddenVisuals and disabledMagnets caches immediately.
RAM Leak Resolved: Prevented lingering UUID entries from slowly accumulating over days/weeks on high-traffic servers with hundreds of unique player logins.
Eliminated Redundant Player Loops (O(N*M) Loop Fix): Highly optimized the core 1-tick rendering task (startGlobalSyncTask) to maximize server-side tick efficiency:
Redundant visibility loops removed: Discarded redundant nested Bukkit.getOnlinePlayers() loops that executed distance checking and packet updates for every shadow at every single tick.
100% Delegated to LOD task: Visual packet updates are now exclusively managed by the highly optimized, configurable-interval startLODTask, completely freeing the 20 Hz tick loop from packet transmission pressure.
DistanceSquared calculations: Replaced the expensive distance() calculations with lightning-fast distanceSquared() lookups.
Heavy Math.sqrt() completely bypassed: Eliminated the heavy square root processor burden per flying item display, ensuring buttery-smooth magnet dynamics during heavy community drop parties.
️ Isolated WorldGuard Bridge Hook (NoClassDefFoundError Fix): Completely decoupled and isolated all WorldGuard references from LootGlow's main class:
Safe Dynamic Loading: LootGlow's main class now checks for WorldGuard existence using dynamic class-path lookup on startup. If WorldGuard is not present, the helper class is never loaded into JVM memory.
Fixed Startup Crash: Resolved the critical java.lang.NoClassDefFoundError: com/sk89q/worldguard/protection/flags/registry/FlagConflictException which prevented the plugin from starting on servers without WorldGuard.
Optimized Memory Footprint: WorldGuard types, custom state-flags, and region query structures are now exclusively verified only when WorldGuard is active on the server.
Codebase Modernization & Formatting Refactoring: Fully tidied up and formatted Java source files to adhere to top-tier enterprise styling, preparing LootGlow for upcoming legendary feature sets.
Heavyweight Particle Optimization (Zero Memory Churn): Re-engineered the high-frequency particle task (startParticleTask) from the ground up for ultimate performance:
Cached Config Tree Lookups: Removed all getConfig() calls inside nested player-item loops. The particle size configuration is now cleanly cached in memory on startup and reload.
Category DustOptions Pre-Calculations: Instead of instantiating millions of DustOptions objects per second (which creates high Garbage Collector pressure), all categories' dust options are now pre-compiled once and fetched instantly from a lightweight cache.
Eliminated Location Cloning: Removed all Location#clone() and Location#add() calls inside the loops. Calculations are now processed using high-performance primitive coordinates (double) directly in the native particle spawning call.
Premium Lighting Optimizations & Packet Filtering: Re-built the lighting task (startLightingTask) to maximize efficiency:
Pre-Built BlockData Cache: Pre-calculated all 15 possible BlockData states for Material.LIGHT during startup, completely avoiding expensive createBlockData() calls inside high-frequency loops.
No Redundant Block Queries: Calls to getBlockData() and getType() are now executed exactly once outside player loops, saving vital CPU cycles.
Inter-World Packet Filtering: Block updates are now sent exclusively to players inside the same world as the light source, preventing useless packet transmission and minimizing client-side rendering lag.
Full Technical Wiki & Documentation Synced: Brought spigot_wiki_bbcode.txt fully up-to-date with actual Java code features. Added documentation for previously missing keys:
Holograms: Added see-through and background settings.
RPG Drops: Added item-scale and block-scale options.
Formatting & Bug Fixes: Fixed multiple broken BBCode closing tags inside the forum presentation files (e.g. [/B) changed to [/B]) and modernized all visual layouts with the brand new universal Discord banner.
WorldGuard Custom Flag (`lootglow-farming`): Added native support for a brand new custom WorldGuard flag! You can now easily disable farming crop highlights in specific regions with a single command: `/rg flag <region> lootglow-farming deny`. Enjoy precise, granular control over your server's visual cues!
Auto-Cleanup & External Plugin Support: The background farming task now validates all active indicators every 5 seconds. If a crop is harvested using an external plugin (e.g., right-click harvest, custom tools) that bypasses standard BlockBreak events, or if region flags change, the symbols are immediately and cleanly removed—no more "ghost" symbols floating!
Robust Fallback Flag Registration: Added a dynamic registry fallback lookup on startup. If the flag registry is locked or load-order issues arise during `onLoad`, LootGlow will safely resolve the custom flag upon plugin activation without errors.
Safe & Optimized Task Execution: Highly optimized WorldGuard flag query loops that execute conditional background queries safely to guarantee maximum server performance (zero impact on TPS).
️ WorldGuard Custom Flag: Added support for a new custom WorldGuard flag: `lootglow-farming`. You can now easily disable farming crop symbols in specific WorldGuard regions by running `/rg flag <region> lootglow-farming deny`. Enjoy precise, regional control over your visual indicators!
Regional Optimization: Improved efficiency in the background farming task by integrating WorldGuard flag queries safely and conditionally.
Custom Visual Scaling: Added new `item-scale` and `block-scale` config options to independently adjust the 3D size of flat RPG drops. Say goodbye to giant blocks or tiny swords! Customize your loot representation down to the millimeter.
Persistent Shadow Fix: Resolved an issue where shadows would sometimes remain permanently on the ground after an item despawned, was picked up, or merged. Enjoy 100% clean ground rendering with flawless entity garbage collection!
Native Minecraft Shadows: Say goodbye to glass panes! LootGlow now utilizes native Display Entity shadow properties. Enjoy smooth, flicker-free shadows that dynamically scale with item height and terrain.
Smart MythicDrops & MMOItems Detection: No more manual configuration! LootGlow automatically detects item tiers. If a tier name matches a LootGlow category, all visuals (beams, particles, holograms) apply instantly.
Premium Particle Animations: Added new animation patterns:
CIRCLE: Particles orbit the item in a smooth horizontal ring.
SPIRAL: Particles rise in an elegant double-helix around the drop.
Size Control: Adjust the density and size of DUST particles in your config.
Intense Energy Beams: Optimized beams with Fullbright (15/15) settings. The single-layer high-intensity core ensures maximum visibility without visual artifacts.
Shadow-on-Ground Logic: Shadows now only appear when the item touches the ground, resolving the "floating glass" issue when throwing items.
Optimized Global Sync: Refined the position synchronization for RPG drops to ensure pixel-perfect alignment between the item and its visual aura.
Intelligent Cleanup: Enhanced integration with ItemMergeEvent and removal tasks to ensure zero entity leakage.
Transform your server's loot into a premium RPG experience. v1.4.1 is our most refined update yet!
Native Minecraft Shadows: Say goodbye to glass panes! LootGlow now utilizes native Display Entity shadow properties. Enjoy smooth, flicker-free shadows that dynamically scale with item height and terrain relief.
Smart MythicDrops & MMOItems Detection: No more tedious configuration! LootGlow now automatically detects item tiers from MythicDrops and MMOItems. If a tier name matches one of your LootGlow categories, all visuals (beams, particles, holograms) are applied instantly.
Advanced Particle Animations: Added new premium animation patterns:
CIRCLE: Particles orbit the item in a smooth horizontal ring.
SPIRAL: Particles rise in an elegant double-helix around the drop.
Particle Size Control: Fine-tune the density and size of DUST/REDSTONE particles in your config.
Enhanced Energy Beams: Beams are now boosted to Fullbright (15/15) for maximum visibility. We've added a dynamic "Energy Flow" effect with rising particles that follow the beam upward.
Shadow-on-Ground Logic: Shadows now only appear when the item is actually on the ground. No more "phantom shadows" following the player during the initial throw.
Intelligent Entity Cleanup: Integrated with the ItemMergeEvent to ensure that all visual components (shadows, beams, labels) are instantly and properly removed when items stack on the ground.
Optimized Global Sync Task: Refined the position synchronization for RPG drops to ensure pixel-perfect alignment between the item and its visual aura.
Bug Fixes: Resolved a critical issue where visual components could occasionally "stick" to the player location during high-latency item drops.
Full 1.21.x Support: Finalized optimizations for the latest Paper builds.
Transform your server's loot into a premium RPG experience. v1.4.0 is the most visually stunning update to LootGlow yet!
Elite Performance Overhaul (Industrial Scale): Massive CPU usage reduction. Spark profiles show up to 80% less impact on the server thread thanks to deep-level code refactoring.
Intelligent Visibility Cache (LOD 2.0): Implemented a state-aware visibility system. The plugin now tracks what each player sees to avoid redundant packet sending and expensive distance calculations.
Optimized Grouping Engine: Fixed a critical redundant update bug in the grouping task. Holograms now only update when their content truly changes, saving thousands of operations per second.
Zero-Allocation Vector Math: Refactored the Magnet and Animation systems to use high-performance manual math, drastically reducing JVM garbage collection overhead.
Memory Leak Protection: Enhanced entity tracking and automated cache cleanup on player logout to ensure long-term stability for large networks.
Modern Paper Engine Migration: Fully migrated to the modern `paper-plugin.yml` system for faster startup and native integration with Paper's latest optimizations.
Robust Config Auto-Updater: Implemented a smart YAML updater that automatically injects new options while preserving your custom settings and comments.
YAML Syntax Protection: New intelligent string parsing that automatically quotes special characters (&, *, !, etc.) to prevent configuration corruption.
Dynamic Library Loading: Reduced JAR size significantly by utilizing Paper's native library loader for external dependencies.
Workflow Improvements: Added new intuitive aliases /glow and /loot for quicker access to visuals and settings.v
Smart Entity Lookup: Replaced slow Bukkit API lookups with high-speed internal O(1) mappings for all visual components.
Full 1.21.4 Compatibility: Continued optimizations for the latest Paper builds.
The definitive visual experience for your loot, now faster and more efficient than ever. v1.3.9 is the standard for high-performance servers.
Dynamic Shadows (Visual Depth): Added subtle, semi-transparent 3D shadows under items on the ground. This creates an incredible sense of depth and immersion, making loot look truly "grounded" in the 3D world.
Inter-dimensional Portal Support: Items passing through Nether or End portals now correctly maintain their glows, holograms, and visual effects in the destination world. No more invisible items or delayed visuals!
Smart Update Checker: Improved version comparison logic to prevent false positive "Update Available" warnings when running developmental versions.
Physical Economy Support: Automatically detects money drops (EconomyShopGUI, TNE, etc.) and displays golden holograms with currency values.
Full 1.21.4 Support: Fully optimized for the latest Minecraft versions using modern Registry systems.
Elite Performance: High-speed particle caching and memory-optimized block scanning for large-scale loot drops.
Diagnostic Tools: Included PDC Scanner to help admins identify custom item tags for advanced configuration.
The definitive visual experience for your loot, now with true 3D depth and inter-dimensional stability. v1.3.8 is here!
Physical Economy Support: LootGlow now automatically detects money drops from other plugins (EconomyShopGUI, TNE, MoneyDrops, etc.). It displays the exact amount in a beautiful golden hologram!
Elite Performance Optimization: Massive memory reduction in block scanning (Farming) and visual updates. Your server will run smoother than ever.
Hardened Compatibility: Bulletproof detection for Oraxen, Nexo, ItemsAdder, and EcoItems. No more broken glows after plugin updates.
Particle Caching: New high-speed caching system for item particles, allowing thousands of active items without lag.
Magic Color Matching: Automatically matches glow color to the item's name color (Legacy & Component support).
Diagnostic Debug Mode: Added a powerful PDC Scanner to help administrators identify custom item tags and set up their categories perfectly.
Full 1.21.4 Support: Optimized for the latest Paper/Spigot API. Now uses the modern Registry system for sounds, ensuring future-proof compatibility.
Technical Polish: Fixed a rare issue with custom head textures and improved overall code stability.
Transform your physical economy into a premium visual experience. v1.3.7 is the money update!
Magic Color Matching: If an item has a colored name (custom items, rare drops), LootGlow will now automatically match the glow color to the name color, even without a specific category! Total "Zero-Config" experience.
Universal MMOItems & Mythic Support: Deep integration with MMOItems tiers and Mythic tags. LootGlow now scans all hidden data tags to automatically apply your categories based on item rarity/tier.
Diagnostic Debug Mode: Added a powerful PDC Scanner to help administrators identify custom item tags and set up their categories perfectly.
Improved Rarity Logic: Smarter category matching that prioritizes internal plugin tiers before falling back to name colors.
Compatibility Update: Support for the latest 1.21.4 Paper/Spigot versions.
The ultimate "Zero-Configuration" RPG loot experience. Drop it, it glows, it's magic!
Fixed "Sticky" Dropped Items: Items dropped by players no longer stick to them instantly. The magnet now respects the Minecraft pickup delay (2s), allowing items to fall naturally before being attracted.
Improved Universal Magnet: If no categories are specified in the config, the magnet will now attract ALL items, including those without a category (default blocks/items).
Smooth Attraction: Added a proximity safety check to prevent items from jittering or orbiting when they are already at the player's feet.
Bug Fixes: Minor performance improvements in the synchronization task.
Auto 3D Detection (Oraxen, Nexo, ItemsAdder): Zero configuration required! LootGlow now automatically detects custom 3D items and renders them perfectly upright and in full 3D on the ground.
Smart Item Detection (MythicItems, MMOItems): Native support for these industry leaders! LootGlow now automatically detects tiers and rarities from your custom item plugins to apply the correct glow colors and effects without extra manual setup.
The ultimate RPG loot experience is here. Total compatibility, zero lag, and stunning 3D visuals!
Hybrid Packet System (ProtocolLib & PacketEvents): LootGlow is now compatible with both ProtocolLib and PacketEvents (v2.12.0+)! The plugin automatically detects which library is installed to manage per-player glow toggles and RPG item hiding.
Ultra-Fluid Synchronization: We've replaced the Passenger system with an optimized TeleportDuration(1) sync task. Items now follow their vanilla counterparts with perfect fluidity—no more jitter, and absolutely no more "ghost" floating items.
Native PacketEvents Support: Full, high-performance integration for PacketEvents, allowing modern servers to maintain a lightweight dependency stack without sacrificing features.
Modular Provider Architecture: The core packet logic has been moved to a dedicated abstraction layer, improving long-term stability and making the plugin more resilient to Minecraft updates.
Bug Fix (Entity Visibility): Fixed a rare issue where vanilla items would remain invisible or floating incorrectly after a world change or player teleport.
Optimized Global Sync: Refined the 20Hz synchronization task to use direct memory references, ensuring zero impact on server performance even with hundreds of items on the ground.
NEW: Selective Glow Support: You can now enable or disable the glowing effect per category! Perfect for reducing client-side lag by disabling glow for common items while keeping it for legendary ones.
NEW: Visual Loot Bags (3D): Grouped items now transform into a professional 3D model! Supports Blocks, Items, and Player Heads.
Custom Textures & Owner Skins: Give your loot bags a unique look with Base64 textures, or show the skin of the player who dropped the items!
NEW: Loot Container GUI: Right-click a Loot Bag to open a custom menu. Browse the contents and pick only the items you want—no more inventory clutter!
Advanced Physics & Water Support: Items now react to their environment! They float upright in water and follow gravity with ultra-fluid motion.
Smart Sync Optimization: Reduced CPU usage by 80% for idle items on the ground by implementing a movement-threshold detection system.
Enjoy total flexibility with our new hybrid packet engine and the smoothest item visuals ever achieved!
Ultra-Smooth Visuals (Passenger System): Rewritten the entity synchronization system. Visuals now use the Passenger System, making movement 100% jitter-free even on high-latency servers.
Enhanced Detection: The internal item identification system has been optimized for faster lookup of custom items from Oraxen, ItemsAdder, Nexo, and the new supported plugins.
Nether & World Change Fix: Resolved the "ghost visual" bug where holograms stayed stuck during world changes or Nether portal teleports.
Industrial Stability (Garbage Collector): Added an internal "Garbage Collector" to ensure clean visual removal even when items are deleted by external plugins like ClearLag.
Z-Fighting Mitigation: Added randomized micro-offsets to holograms to prevent flickering when multiple items are stacked.
Security Hardening: Optimized right-click pickup logic to prevent exploits and ensure perfect item counts.
Configuration Documentation: Updated config.yml comments to better explain how to use custom item prefixes in your rarity categories.
This massive update combines new integrations with professional-grade performance and stability fixes!
Animated Beacon Beams: High rarity items now feature rotating beacon beams, creating a much more dynamic and premium feel!
Colored Stained Glass Beams: You can now enable use-category-color to make beams use actual colored stained glass matching the item's rarity.
Timer New Line: Improved readability! The despawn timer can now be displayed on a separate line below the item name (timer-on-new-line).
Nether Portal Fix: Items entering Nether/End portals will now correctly clean up their holograms and beams, preventing visual glitches in the original world.
Cross-World Teleport Support: Visuals are now automatically refreshed or removed when items are teleported across worlds.
Upgrade now to 1.3.2 for the most immersive RPG loot experience!
Farming Persistence: The "!" symbols now persist through server restarts! They will correctly re-link to your crops when chunks load.
Smart Farming LOD: "!" symbols are now hidden when you are too far away, optimizing FPS and visibility.
Performance Engine Sync: The entire settings.performance section is now fully functional. You can now tune hologram, beam, and particle distances separately.
LOD Update Interval: Added a configurable update interval for LOD checks to reduce CPU usage.
Bug Fixes: Fixed various internal synchronization issues with visual entities.
Upgrade now to 1.3.1 for the most stable RPG loot experience!
[New] Bouncing Physics: Items now realistically bounce when landing on the ground! Fully customizable via the spawn-animation.bouncing section.
[New] Smart Config Updater: The configuration auto-updater has been completely rewritten. It now preserves the exact structure and comments of the template, injecting new options in their correct place.
[Fix] Resource Optimization: Fixed a duplicate task initialization that was causing unnecessary CPU cycles during world rendering.
[Improvement] YAML Parsing: Enhanced UTF-8 support for config files to better handle special characters and localized symbols.
Upgrade your server drops with realistic physics and a cleaner configuration!
[Fix] Major Config Structure: Fixed a critical indentation error in config.yml that caused Magnet, Grouping, and Performance settings to be ignored.
[Fix] Persistent Magnet: Magnet settings now correctly update after a /lg reload. No more server restarts needed for minor tweaks!
[Fix] Smarter Toggle: The /lg toggle command now correctly hides Farming Symbols ("!") and responds instantly.
[Optimization] Professional Reload: Reloading the plugin now proactively refreshes all items on the ground to apply new colors, categories, or performance settings immediately.
[Bugfix] Compilation stability: Fixed internal class resolution issues for legacy systems.
Smooth Item Stacking: Eliminated "bizarre" jump animations and redundant particles when items merge. Stacking is now visually seamless and professional.
Farming Symbols Persistence: Resolved the bug where "!" symbols would stay after breaking crops or after a server restart.
Auto-Cleanup System: Implemented a proactive cleanup that removes any "ghost" symbols from previous sessions automatically on chunk load.
Non-persistent Displays: Farming symbols are now marked as non-persistent to keep world files clean.
Redundant Update Prevention: Optimized visibility broadcasts to avoid network overhead during high-frequency stacking events.
Session-Sync: Improved cross-session synchronization for persistent crop visuals.
World-Batching LOD: Drastically reduced distance calculations by grouping items by world.
Zero-Object Sync: Implemented Location/Vector reuse to eliminate Garbage Collector pressure (no more micro-stutters).
Fast Math Engine: Replaced costly distance calculations with high-performance squared math.
O(1) Entity Lookup: Instant access to items via memory caching instead of global UUID searches.
Smart Config Updater: Admins no longer need to delete their config files! Missing options are now automatically merged into existing files while preserving all comments and custom values.
Optimization: Ground-lock and O(1) lookups for near-zero sync overhead.
Optimization: Global farming animation task for high-density farms.
Zero-Serialization Holograms: Implemented a "State Hash" caching system. The plugin now skips all text calculations if the item state hasn't changed, significantly reducing CPU usage based on Spark profiling!
Visual Stability Engine: Implemented "Double Buffering" for item grouping. This eliminates the "flickering" effect when items are recalculated, ensuring a rock-solid visual experience.
Smart Config Updater: Admins no longer need to delete their config files! Missing options are now automatically merged into existing files while preserving all comments and custom values.
Polished Loot Bags: Fixed a bug where beams remained visible for grouped items. Sac de Butin is now cleaner than ever!
️ Change Log Summary (v1.2.4 -> v1.2.5):
Optimization: Complete removal of redundant Adventure/MiniMessage serialization.
Performance: Near-zero CPU overhead for hologram updates when items are stationary.
Stability: Atomic map swapping for grouping tasks to prevent entity flickering.
Feature: Automatic configuration merging for easier plugin updates.
Polish: Correctly hiding beams for items absorbed into loot bags.
Magnet 2.0 (Player-Centric Optimization): Rewrote the magnet algorithm. Instead of checking every item, it now smartly scans around players using Minecraft's internal spatial grid. This reduces CPU overhead by up to 80% on busy servers!
Thread-Safe SQLite Engine: Added synchronization layers to the database engine. Even with dozens of players joining and saving settings simultaneously, your data remains 100% safe and corruption-free.
World Life-Cycle Management: Implemented automatic cleanup for unloaded worlds. If a world or dungeon instance closes, LootGlow instantly wipes all associated visual entities from memory.
Clean Build Guarantee: Resolved all remaining compiler warnings and unused variables for a perfectly clean and professional JAR.
Improved Region Detection: Added optional debug logging for WorldGuard region checks to help server owners troubleshoot complex protection setups.
Mixed Grouping Logic: The "Sac de Butin" now only activates when there's a mix of different item types. Identical items will no longer trigger a loot bag, keeping your inventory stacking clean and intuitive!
️ Change Log Summary (v1.2.3 -> v1.2.4):
Feature: Automatic cleanup on World Unload events.
Optimization: Complete rewrite of the Magnet task (Player-based iteration).
Industrial-Grade Stability Audit: Complete code review to ensure zero memory leaks and maximum production reliability.
Asynchronous Database Engine: Player settings are now loaded in the background. No more main-thread lag during player connections, even with thousands of entries!
Zero Memory Leak Guarantee: Fixed a rare potential memory leak in the item category cache. Your server can now stay online for months without a single byte of wasted RAM.
Grouping Conflict Resolution: Fixed a visual conflict where items in a "Sac de Butin" would occasionally flicker when new items dropped nearby.
High-Performance CPU Culling: The synchronization task now skips movement updates for grouped (hidden) items, further reducing CPU usage by up to 15% in high-drop scenarios.
Robust WorldGuard Integration: Improved error handling for region checks to ensure silent failure is replaced by intelligent debugging logs.
ProtocolLib Polish: Refined the packet listener to be even more resilient to race conditions during chunk loading.
️ Change Log Summary (v1.2.2 -> v1.2.3):
Fix: Resolved memory leak in `itemCategoriesCache`.
Fix: Resolved visual flickering with the Grouping system (Sac de Butin).
Optimization: Asynchronous SQLite data loading for joining players.
Optimization: Skip teleportation packets for hidden/grouped visual entities.
Security: Improved null-safety and entity validity checks throughout the codebase.
Massive Performance Boost (Global Task): Complete rewrite of the synchronization system. Replaced individual item tasks with a single, highly optimized global task. CPU usage reduced by over 90%!
Zero-Allocation Timer: All 300+ timer components are now pre-calculated at startup. The main task no longer performs any string parsing or MiniMessage deserialization for the timer, making it nearly instant.
ProtocolLib Optimization (Lazy Cloning): Optimized the packet listener to skip expensive reflection-based packet cloning unless a modification is strictly necessary.
Advanced Name Caching: Expensive **PlaceholderAPI** and **MiniMessage** calls are now cached. The hologram name is calculated once, eliminating per-tick overhead.
Smart Visibility Updates (LOD): Rewritten visibility logic to use the item's location as the source of truth, ensuring visuals are always shown correctly even after a server restart.
Optimized Grouping Algorithm: New world-based grouping logic to handle thousands of items with minimal overhead.
Text Caching: Added a caching layer to avoid redundant metadata updates when the hologram content hasn't changed.
LOD & View Distance: Improved Level of Detail logic to hide visuals that are out of sight, further boosting FPS for players.
Intelligent Teleportation: The plugin now skips movement updates for stationary items, drastically reducing server-side load.
Zero-Allocation Timer: All 300+ timer components are now pre-calculated at startup. The main task no longer performs any string parsing or MiniMessage deserialization for the timer, making it nearly instant.
️ Technical & Performance Fixes:
Stability Fix: Resolved a critical "NullPointerException" that could cause visuals to stop moving or become invisible during high load.
Redundancy Removal: Cleaned up overlapping background tasks and unused methods to ensure a lean and stable runtime.
Memory Optimization: Better cleanup of metadata and cache when items are picked up or despawned.
Stability: Resolved rare "ghost" visual issues in high-load scenarios.
[NEW] Right-Click to Pickup (RMB): A major addition for RPG and Hardcore servers! You can now enable a system where players must right-click an item (or its hologram) to pick it up.
Prevents inventory clutter from accidental pickups.
Configurable range and optional "Force" mode (disables normal walking pickup).
Fully compatible with item protection and hard-lock.
Absolute Fluidity (60 FPS Movement): Complete overhaul of the item synchronization system. RPG items now follow physics movements (bounces, water currents) with perfect fluidity thanks to client-side interpolation (TeleportDuration).
Smart Toggle System: The /lg toggle command has been fixed. Disabling RPG visuals now correctly restores the Vanilla appearance for the player.
Cleanup & Persistence: Fixed "ghost holograms". Entities are now non-persistent and regenerate correctly upon chunk loading.
Absolute Fluidity (60 FPS Movement): Complete overhaul of the item synchronization system. RPG items now follow physics movements (bounces, water currents) with perfect fluidity thanks to client-side interpolation (TeleportDuration). Say goodbye to stuttering!
Smart Toggle System: The /lg toggle command has been fixed. Disabling RPG visuals now correctly restores the Vanilla Minecraft appearance for the player, without making the item disappear. A true "Classic" vs "RPG" mode.
Cleanup & Persistence: Fixed the "ghost holograms" bug. All cosmetic entities are now temporary (non-persistent) and no longer clutter your world files. They automatically regenerate upon chunk loading.
Hopper Support: Holograms and beams now disappear instantly when an item is sucked up by a hopper or any automatic system.
Farming Highlights Restored: The ripe crop scanner has been reactivated and optimized. Exclamation marks will now appear on your fields as soon as you connect, even if they were already grown.
️ Technical Fixes:
ProtocolLib packet optimization (reduced CPU load).
Fixed visual duplication during chunk reloads.
Improved protected item detection during pickup.
Removed redundant tasks for better overall performance.
Farming Glow (NEW): Beautiful 3D glowing exclamation marks appear above your crops when they are ready to be harvested! Support for Wheat, Carrots, Potatoes and more.
Full Customization: Admins can now change the material (Emerald, Gold, Diamond...) and the exact size (scale) of the farming symbols in the config.
ProtocolLib Mastery: Per-player toggle now hides everything including the glow without hiding the actual item.
Instant Response: All visual toggles are now handled via packets for instant feedback.
Elite RPG Visuals: Animated 3D symbols using BlockDisplay entities for that professional server look.
ProtocolLib Integration: The ultimate toggle experience! You can now hide the glow effect per-player while keeping the item perfectly visible. Zero compromise.
Instant Refresh: Toggling visuals is now instant. No need to wait for a task or a tick, packets are dispatched immediately for a smooth UI.
Elite Optimization: Removed experimental entities in favor of raw packet manipulation. Maximum performance, zero entity lag.
Full Persistence: Of course, SQLite still saves everything. Set it and forget it.
Advanced Loot Grouping (Bundles): Perfectly clean mob grinders! Items now group into "Loot Bags" when too many are in the same spot. Zero flicker, 100% smooth.
Improved Delta-Caching: Optimized group updates to ensure zero impact on your server's TPS.
️Bugfixes: Fixed a rare flickering issue when items were both in a group and being updated by the timer.
️Smart LOD (Level of Detail): Effects now automatically hide when players are far away. Massive FPS boost for players and zero bandwidth waste.
Zero-Entity Logic: Using Paper's Virtual Visibility API, holograms are now invisible by default. They are only "revealed" to nearby players, making the server thread lighter than ever.
Delta-Caching Engine: Reduced CPU usage by 20x compared to previous versions. Optimized Spark timings.
️Stability Fixes: Improved compatibility with 1.21.4 and fixed minor display glitches.
This update is highly recommended for survival and faction servers with high player counts.
Spark-Optimized Engine (Major!): We have completely rewritten the hologram update system. Thanks to a new "Delta-Caching" logic, CPU usage has been reduced by nearly 20x! Smooth gameplay even with hundreds of items.
Dynamic Real Lighting: Rare items now emit actual Minecraft light. No world modification, no lag, just pure magic in dark caves.
️Hard Loot Protection: Prevent loot ninja-ing! Items are physically locked to their owner for a configurable duration.
️Item Nicknames (Overrides): Customize how items appear in holograms via config (e.g., replace "Netherite Sword" with "§6§lExcalibur").
MythicMobs & RPG Support: Full compatibility with MythicMobs items and custom item frameworks (ItemsAdder, Oraxen, Nexo).
️Bugfixes: Fixed a potential crash on 1.21.4 and optimized JAR size (now only ~150KB!).
️ Hard Loot Protection: Prevent other players from stealing loot! Items are now physically locked for the owner during the protection duration.
MythicMobs Support: Natively support MythicMobs! You can now define colors based on specific Mythic items or even based on the Monster that dropped the item.
1.21.4 Compatibility: Fixed critical issues with Paper 1.21.4 regarding item ages.
Improved Messages: Added new placeholders and messages for the pickup protection system.