Outline N' Stuff - Enchantements

Minecraft 1.21.1 · Client-side only

A smooth, customizable glow outline around the items you actually care about. Spot your enchanted gear at a glance: in your hand, on the ground, in item frames, or held by other players in third-person view. Works with or without shader packs, and on any modded setup.

One mod, multiples outlines. Like a famous mod on Bedrock Edition.

Features

Smart targeting: outlines enchanted items by default (vanilla and modded enchantments alike). Want something else outlined? Add the item you're holding to the whitelist in one click.

Full modded support: works seamlessly with items from any other mod. Modded swords, tools, armor, and custom enchantments all get the outline treatment automatically.

Universal coverage: held items (first-person and third-person), dropped items on the ground, items inside item frames, and items held by other players and mobs are all outlined.

Enchant runes: floating runes that cling to the actual shape of the item you're holding and follow it through swings, bobbing and camera moves, including tridents, shields and other custom-model items. Size and density are adjustable, and they can be turned off on their own.

Distance-adaptive thickness: held items get a bold, prominent ring, while distant items get a subtle, thin edge. No visual clutter even with lots of enchanted items on screen.

HSV color picker: pick any color you want, with a live preview, directly in-game.

Chameleon mode: outline color is automatically derived from the item's dominant texture color. Each item gets its own matching glow, including modded items with custom textures.

Rarity mode: color your outlines by item value instead, with a 6-tier system (Common, Uncommon, Rare, Epic, Legendary, Mythic) that reads modded gear automatically. A searchable per-item editor lets you override any item's tier yourself, with a filter by mod.

Full appearance control: ring thickness and opacity, glow halo on its own toggle and intensity slider (from subtle to full neon bloom), edge blur, round or sharp corners, and distance fade.

Proper occlusion: outlines do not show through walls, through entity bodies, through your own player body in third-person, or through your hand in first-person. The weapon you're holding always stays in the foreground.

Tabbed config panel: press G (rebindable) to open a side panel that keeps your weapon visible while you tune it. Everything applies live, and your settings are saved between sessions.

Shader Pack Compatibility

Fully tested with Iris. The outline pipeline runs on its own dedicated framebuffer and composites cleanly on top of the shader pack's final output. No flicker, no Z-fighting, no broken effects.

Performance

The mod runs a lightweight screen-space pipeline (custom framebuffer plus separable horizontal and vertical dilation passes). It only processes the screen area covered by outlined items, so the cost stays negligible even with many items visible at once.

The rendering path was rebuilt from the ground up. The mod now costs about 4x less on the render thread for pixel-identical output, measured both with an internal probe (-76 %) and with a spark profile (21.6 % down to 9.2 % of the render thread), which works out to roughly +14 to +20 % FPS depending on the scene. Occlusion checks are cached, so crowded scenes stay cheap.

Compatibility

Designed to be a good citizen in any modpack. Hooks are minimal and non-invasive, it's client-side only, there's no shared state with servers and no protocol changes.

• Minecraft 1.21.1
• NeoForge 21.1 or newer, or Fabric (with Fabric API)
• Client-side only, safe to use on any server, no install required server-side
• Compatible with any modded environment. Modded items receive the outline exactly like vanilla ones.

Mods tested and explicitly supported

FAQ

Is there a Discord?
Yes: join here. It's the best place for questions, suggestions and bug reports.

Is a Forge version planned?
No. Iris has never supported Forge, and Oculus, its Forge port, has not been updated past 1.20.1. This mod is built around shader pack compatibility, so a Forge build would ship without the thing that makes it worth using.

Will you support 1.20.x, 1.21.11, 26.x, or other versions?
Yes, that's the plan. I'd rather gather more feedback on the current version first and iron out the remaining bugs before spreading across more Minecraft versions.

I found a bug, where do I report it?
On the Discord server. Screenshots, your mod list and your log file help a lot.

License

This mod is proprietary software, all rights reserved. You are welcome to include it in modpacks as long as the original jar is distributed unmodified and proper credit is given. Decompilation, code extraction, and unauthorized derivative works are not permitted.

---

Enjoy spotting your loot more easily.