LootGlow -----
Transform every drop into a cinematic experience. 3D shadows, beacon beams, holograms, RPG physicsLOOTGLOW DOCUMENTATION
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Complete technical guide for server administrators
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
1. INSTALLATION
────────────────────────────────────────────────────
-
Download the LootGlow.jar file.
-
Place it in your server's /plugins/ directory.
-
Restart your server to generate configuration files.
-
Customize config.yml and messages.yml to your liking.
⚙️ 2. CONFIGURATION GUIDE
────────────────────────────────────────────────────
General Settings:
-
enabled: Globally enable or disable the entire plugin.
-
only-player-drops: If true, visuals only apply to items dropped by players (not mobs).
-
disabled-worlds: List of world names where the plugin is completely inactive.
-
despawn-time: Seconds before items despawn. Used for the hologram countdown timer (default 300).
-
default-glow: Fallback glow setting for items that don't match any category (default true).
-
check-updates: Automatically check for new versions on startup.
-
Portal Support: Visuals persist perfectly through Nether and End portals. No configuration needed.
Hologram Settings:
-
holograms.enabled: Toggle floating name labels above items.
-
holograms.height-offset: Vertical position of the hologram above the item (recommended 0.7).
-
holograms.see-through: If true, the hologram text is visible through blocks.
-
holograms.background: If true, adds a dark background panel behind the hologram text.
-
holograms.view-distance: Distance in blocks at which holograms become visible (default 15).
-
holograms.show-amount: Show the stack quantity on the label (e.g. x32).
-
holograms.show-timer: Show a live countdown before the item despawns.
-
holograms.timer-on-new-line: Display the timer on a separate line below the item name.
Dynamic Shadows:
-
rpg-drops.shadows.enabled: Adds a semi-transparent 3D shadow under ground items for depth and realism.
-
rpg-drops.shadows.scale: Size of the shadow relative to the item (default 0.4).
RPG Drops (Flat Item Rendering):
-
rpg-drops.enabled: Lay items flat on the ground for an RPG-style look.
-
rpg-drops.enabled-categories: Restrict flat rendering to specific categories. Leave empty to apply to all.
-
rpg-drops.rotation-angle: Rotation in degrees (90.0 = perfectly flat on the ground).
-
rpg-drops.item-scale: Visual scale for individual item drops (default 0.6).
-
rpg-drops.block-scale: Visual scale for block drops (default 0.8). Allows different sizing per type.
Economy Support:
-
economy.enabled: Automatically detect money drops from other plugins using PDC tags.
-
economy.format: Hologram label format. Use <prefix> and <amount> as placeholders.
-
economy.prefix: Currency prefix displayed before the amount (e.g. &a$&f).
-
economy.color: Glow color of money drops (e.g. GOLD).
-
economy.sound: Sound played when a player walks near a money drop.
-
economy.custom-keys: Extra PDC keys to scan for currency amounts (format: namespace:key). Most common plugins are detected automatically.
Advanced Performance (LOD):
-
performance.lod.enabled: Enable the Level of Detail system. Highly recommended for large servers.
-
performance.lod.hologram-distance: Holograms beyond this range are hidden (default 24 blocks).
-
performance.lod.beam-distance: Beams beyond this range are hidden (default 48 blocks).
-
performance.lod.particle-distance: Particles are skipped if no player is within this range (default 32 blocks).
-
performance.update-interval: Ticks between each LOD check cycle (default 20 = 1 second).
-
Zero-Entity Logic: All visual entities are invisible by default and only revealed to nearby players, minimizing server and client load.
Magnet Mode:
-
magnet.enabled: Enable the auto-pickup feature.
-
magnet.distance: Attraction range in blocks (default 5.0).
-
magnet.permission: Required permission node (default lootglow.magnet).
-
magnet.categories-enabled: List of rarity categories attracted by the magnet (e.g. legendary, epic, rare).
Grouping & Visual Bags:
-
grouping.enabled: Consolidate nearby identical items into a single stack to reduce hologram clutter.
-
grouping.radius: Search radius in blocks to find items to group together (default 2.0).
-
grouping.min-items: Minimum number of items required to form a group (default 5).
-
grouping.group-by-category: If true, only items sharing the same rarity category are grouped together.
-
grouping.visual.enabled: Show a visual Loot Bag entity instead of a plain item stack.
-
grouping.visual.material: Material used for the Loot Bag (e.g. PLAYER_HEAD, BUNDLE, CHEST).
-
grouping.visual.head-texture: Base64 skin texture for PLAYER_HEAD bags. Leave empty to use the default bag texture.
-
grouping.visual.use-owner-head: If true and material is PLAYER_HEAD, use the skin of the player who dropped the items.
-
grouping.visual.custom-model-data: Custom Model Data value for resource pack support (0 to disable).
-
grouping.container.enabled: Enable the right-click GUI to browse the content of a Loot Bag.
-
grouping.container.title: Title of the Loot Bag GUI. Supports MiniMessage formatting.
-
grouping.container.require-click: If true, players must right-click to open the bag (walking over it won't open it).
Farming Highlights:
-
farming.enabled: Display a floating '!' symbol above fully grown crops.
-
farming.glow-color: Color of the glow effect on the symbol (e.g. GREEN).
-
farming.symbol-material: Block used as the visual symbol (default EMERALD_BLOCK).
-
farming.symbol-scale: Size of the symbol display entity (default 0.2).
-
farming.height-offset: Vertical offset above the crop block (default 1.5).
-
farming.animation: Enable the gentle rotation and bobbing animation on the symbol.
-
farming.view-distance: Distance in blocks at which farming symbols become visible (default 5.0).
-
farming.crops: List of crop materials to monitor (WHEAT, CARROTS, POTATOES, BEETROOTS, NETHER_WART, COCOA...).
-
lootglow-farming flag (WorldGuard): Custom WorldGuard flag. Run /rg flag <region> lootglow-farming deny to disable crop highlights in specific regions only.
Loot Protection:
-
loot-protection.enabled: Show the owner's name above their freshly dropped item.
-
loot-protection.display-duration: Seconds the owner label remains visible after the drop (default 10).
-
loot-protection.hard-lock: Physically prevent other players from picking up the item during the protection window.
-
loot-protection.bypass-permission: Permission node that lets admins bypass hard-lock protection (default lootglow.bypass.lock).
-
display-names (per category): Define custom MiniMessage names for specific items in a category (e.g. "DIAMOND" -> "<blue>Shiny Gem").
-
owner-format (messages.yml): Customize the owner line format. Supports <owner> placeholder and PlaceholderAPI.
WorldGuard Support:
-
worldguard.enabled: Toggle WorldGuard integration.
-
worldguard.blocked-regions: List of region IDs where all LootGlow visuals are disabled.
-
lootglow-farming flag: Selectively control crop highlights per region. Independent from the general blocked-regions list.
Physics & Animations:
-
spawn-animation.enabled: Enable the "pop" effect when an item first appears.
-
spawn-animation.jump-force: Initial upward velocity of the pop effect (default 0.25).
-
spawn-animation.burst-amount: Number of particles in the spawn burst explosion (default 15).
-
spawn-animation.bouncing.enabled: Items bounce realistically on the ground after landing.
-
spawn-animation.bouncing.max-bounces: Maximum number of bounces before the item comes to rest (default 3).
-
spawn-animation.bouncing.damping: Energy retained after each bounce (0.0 to 1.0). Lower = faster stop (default 0.6).
-
aspiration.enabled: Items fly smoothly toward the player's inventory when picked up.
-
aspiration.speed: Speed of the fly-to-player animation (0.1 to 0.5 recommended, default 0.15).
Visual Beams:
-
beams.enabled: Toggle the vertical light pillar above high-rarity loot.
-
beams.height: Height of the beam in blocks (default 10).
-
beams.width: Width (thickness) of the beam. Default 0.05 for a thin line.
-
beams.animate: Enable rotation animation for a "living" beam effect.
-
beams.use-category-color: The beam glass color matches the item's rarity color.
-
beams.enabled-categories: Which rarity categories trigger a beam (e.g. legendary, epic).
Particles:
-
particles.enabled: Toggle ambient particles around categorized items.
-
particles.frequency: Ticks between each particle burst (default 10). Higher = less frequent.
-
particles.animation-type: Global fallback animation style for particles (e.g. STILL). Overridden by category-specific settings.
Right-Click Pickup (Interaction):
-
interaction.rmb-pickup.enabled: Allow players to right-click an item or its hologram to pick it up.
-
interaction.rmb-pickup.force: If true, right-clicking is the ONLY way to pick up items (walking over them is disabled).
-
interaction.rmb-pickup.range: Maximum distance for right-click pickup (default 3.0 blocks).
Custom Items & Integrations:
Use the following prefixes inside any category's items: list to match items from other plugins:
Use the following prefixes inside any category's items: list to match items from other plugins:
-
ORAXEN:itemID — Matches an Oraxen item by its ID.
-
ITEMSADDER:itemID — Matches an ItemsAdder item by its namespace:id.
-
NEXO:itemID — Matches a Nexo item by its ID.
-
MYTHIC:id — Matches a MythicMobs item OR mob drop by its internal name.
-
MMOITEMS:type:id — Matches an MMOItems entry by type and ID.
-
ECOITEMS:itemID — Matches an EcoItems item by its ID.
-
ADVANCEDITEMS:itemID — Matches an AdvancedItems item by its ID.
-
ITEMEDIT:itemID — Matches an ItemEdit item by its ID.
3. LOCALIZATION (messages.yml)
────────────────────────────────────────────────────
LootGlow supports full MiniMessage formatting in messages.yml. Use the <prefix> placeholder to keep your messages consistent:
Code (YAML):
prefix : "<gradient:#FFD700:#FFFFFF><bold>[LootGlow]</bold></gradient> <gray>» </gray>"
no-permission : "<prefix><red>You don't have permission to do this!</red>"
config-reloaded : "<prefix><green>Configuration and messages successfully reloaded!</green>"
plugin-info :
- "<gradient:gold:white><bold>LootGlow</bold></gradient> <gray>v<version>"
- "<gray>Author : <white><author> "
- "<gray>Use <yellow>/lg help</yellow> to see commands. "
help-header: "<gold> --- <yellow>LootGlow Help</yellow> ---</gold> "
help-reload: "<yellow>/lg reload <gray>- <white>Reload the plugin configuration "
help-toggle: "<yellow>/lg toggle <gray>- <white>Toggle item visuals for yourself "
help-magnet: "<yellow>/lg magnet <gray>- <white>Toggle item magnet for yourself "
toggle-on: "<prefix><green>Item visuals have been enabled for you.</green> "
toggle-off: "<prefix><red>Item visuals have been disabled for you.</red> "
magnet-on: "<prefix><green>Item magnet has been enabled for you.</green> "
magnet-off: "<prefix><red>Item magnet has been disabled for you.</red> "
# Hologram Format — use <amount> and <time> as placeholders
item-amount-format: " <gray> (x<amount> )</gray> "
item-timer-format: " <gray> (<time>s )</gray> "
# Loot Protection — use <owner> for the player's name (PlaceholderAPI supported)
owner-format: "<newline><gray>Owned by</gray> <white><owner></white> "
# Announcements
legendary-found: "<prefix><gradient: #FFD700:#FFAA00><bold>LEGENDARY!</bold></gradient> <white>A precious item has been discovered nearby!</white>"
# Pickup Protection — use <owner> and <time>
cannot-pickup : "<prefix><red>This item belongs to <white><owner></white>! Try again in <white><time>s</white>.</red>"
️ 4. COMMANDS
────────────────────────────────────────────────────
The main command is /lootglow with aliases /lg and /glow.
| /lg | Display plugin information and version. |
| /lg help | List all available commands. |
| /lg toggle | Hide or show item visuals for yourself. |
| /lg magnet | Toggle your personal item magnet on or off. |
| /lg reload | Reload config.yml and messages.yml. Requires lootglow.admin. |
5. PERMISSIONS
────────────────────────────────────────────────────
-
lootglow.admin — Access to /lg reload. Recommended for staff only.
-
lootglow.magnet — Access to the VIP Magnet feature and /lg magnet command.
-
lootglow.bypass.lock — Bypass the hard-lock loot protection. Useful for admins.
-
(No permission required) — /lg, /lg help and /lg toggle are accessible by all players by default.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Questions? Join our community on Discord!
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Resource Information
Author:
----------
Total Downloads: 289
First Release: Apr 28, 2026
Last Update: Jun 9, 2026
Category: ---------------
All-Time Rating:
6 ratings
Version -----
Released: --------------------
Downloads: ------
Version Rating:
----------------------
-- ratings