LootBeams (Fabric)

LootBeams is a client-side Fabric mod that renders customizable beacon-style beams of light and floating nametags above dropped items in the world, making valuable loot easy to spot from a distance.

This project is an updated Fabric port of the original Forge mod by Elise (shiroroku).

Features

• Item Accent Colors: Beams dynamically match item properties, including:
  • Custom NBT colors and custom item name formatting
  • Potion liquid colors and dyed armor leather colors
  • Item rarity tiers (Common, Uncommon, Rare, Epic)
  • Material-based palette matching (Diamond, Netherite, Emerald, Gold, Iron, Copper, Amethyst, Redstone, Lapis, Prismarine, and more)
• Visual Elevation & Opacity Gradient: Beams rise cleanly from the top of the item entity with smooth vertical alpha feathering, keeping the dropped 3D item model fully visible and unobscured.
• Floating Nametags: Optional rendered labels showing item name and stack count above dropped items, with support for look-only display.
• Filtering Options: Configure beams to render on all items, only equipment (weapons, armor, tools), only rare items, or specific whitelisted/blacklisted item IDs.
• Client-Side Only: Does not need to be installed on servers. Works seamlessly in singleplayer and when connecting to vanilla or modded multiplayer servers.

Configuration

LootBeams can be configured through two methods:

1. In-Game GUI (OneConfig)

If OneConfig is present in your mod list, LootBeams registers an interactive configuration page under the Visuals category. You can toggle the master switch, adjust beam height, radius, opacity, render distance, and configure nametags in real time without restarting the game.

Note: The mod is disabled by default upon first install. Open OneConfig in-game to toggle it on and adjust your preferences.

2. Configuration File

Settings are also stored locally in:

config/lootbeams.json

Key configuration options include:

• enabled: Master switch to toggle rendering on or off.
• all_items: Render beams for every dropped item (true/false).
• only_rare: Limit rendering to items with non-common rarity.
• only_equipment: Limit rendering to weapons, tools, and armor.
• beam_radius: Controls beam thickness and scale.
• beam_height: Multiplier for total beam height.
• beam_alpha: Maximum beam opacity.
• render_distance: Maximum distance (in blocks) at which beams and nametags render.
• render_nametags: Toggle floating nametags above dropped items.
• render_nametags_onlook: Only render nametags when looking in the direction of the item.
• render_stackcount: Display stack amount next to item names.
• color_overrides: Custom hex color overrides per item ID.
• whitelist / blacklist: Precise item ID registry filters.

Credits & License

• Original Forge mod by Elise (shiroroku).
• Fabric port developed and maintained by ManorDev.
• Licensed under the MIT License.
• Source code available on GitHub.