Compatibility
Minecraft: Java Edition
Platforms
Supported environments
Tags
Creators
Details
Minecraft 1.21.1 · Client-side only · One jar for NeoForge and Fabric
A crisp, customizable 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 and mobs. Works with or without shader packs, and in any modded environment.
The name is a direct reference to Actions & Stuff on Bedrock Edition. Its outline style is exactly what this mod brings to Java, and the Outline N' Stuff mode reproduces it faithfully.
Two outline styles
Outline N' Stuff is the default: a geometric border that hugs the item's real shape. It is part of the item, so it sticks perfectly in first person, follows animation mods, and costs almost nothing. It works on flat items, on 3D models, and on custom-rendered items such as tridents and shields.
Ring is the screen-space alternative: constant thickness in pixels, with a glow halo, blur, corner mode and distance fade. It captures a silhouette and runs post-processing passes every frame, so it costs more.
Beware: the Ring style can cost FPS on modest hardware. A master switch lets you disable it entirely and give the whole budget back.
Make it yours
Width. One slider drives the thickness of both styles, so switching between them keeps the same look.
Intensity. From a subtle edge to a bold, saturated line.
Color picker. Pick any colour you want, with a live preview, directly in-game.
Chameleon mode. The outline colour is derived from the item's dominant texture colour, so each item gets its own matching glow, modded textures included.
Rarity mode. Colour 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 tier, with a filter by mod.
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. Want an item left alone, or forced to the Ring style? The blacklist does that, in one click too.
Compatible modded environment. Modded weapons, tools and custom-rendered items receive the outline exactly like vanilla ones. Custom renderers are captured at their call site, so mods the outline has never seen are covered without any special support.
Compatible with Punchy and Inventory Particles. Outlines, occlusion and enchant runes follow the animated weapon, and the runes borrow the particle sprites you already have.
Hit feedback. When one of your projectiles hits an entity, the outline of your weapon flashes green for a second and plays the arrow "ding" that many resource packs provide. It reads who caused the damage, not which weapon fired, so it works with any modded bow, crossbow or ranged weapon.
Durability warning. When your held item drops into its last fifth of durability, the outline pulses red. Vanilla only shows this on a three-pixel bar in the corner of the screen, which is unreadable mid-fight.
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, tridents and shields included. Size and density are adjustable, and they can be turned off on their own.
Proper occlusion. Outlines do not show through walls, through entity bodies, through your own 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 U (rebindable) to open a side panel that keeps your weapon visible while you tune it. Everything applies live, every setting has a coloured tooltip, and your settings are saved between sessions.
Performance
The Outline N' Stuff style is geometry: no framebuffer, no post-processing, its cost is negligible.
The Ring style runs a screen-space pipeline that was rebuilt from the ground up: about 4x cheaper on the render thread than the first releases for pixel-identical output, measured with an internal probe (-76 %) and with a spark profile (21.6 % down to 9.2 % of the render thread). Occlusion checks are cached, so crowded scenes stay cheap.
Three switches let you trim the budget further: disable the Ring style entirely, skip items in item frames, or skip items held by entities and lying on the ground. Without world items to outline, the occlusion masks have nothing to cover and stay idle.
Shader packs
Fully tested with Iris. Both styles are drawn outside the shader pack's own passes, so shadows, colour grading, bloom and water are left untouched. No flicker, no Z-fighting, no broken effects.
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. One single jar works on both.
- Client-side only, safe on any server, nothing to install server-side.
Mods tested and explicitly supported
- Iris, Sodium, ImmediatelyFast: supported. Both outline styles are drawn outside the shader pack's own passes.
- Punchy, Hold My Items: explicit support. Outlines, occlusion and enchant runes follow the animated weapon, including through Punchy's weapon-swap animation.
- Inventory Particles: the enchant runes borrow its sprites, so they match the rest of your particles.
- Gnetum: explicit support, so the outline is never cached and left stale on screen.
- Accessories: cosmetic layers such as quivers and capes do not leak through walls.
- Apotheosis: in Rarity mode, outlines follow Apotheosis rarities. Your per-item overrides always take priority.
- GeckoLib, AzureLib: animated items are outlined and follow their animation. Layers drawn with the library's own render types are included, so glowing parts are not missing from the outline.
- Any custom item renderer: renderers are captured where the game calls them, not by class name, so mods with their own item renderer are covered without special support. Confirmed on Mekanism, Create, Eternal Starlight, Legendary Monsters, Mahou Tsukai, MineColonies, Ars Nouveau, Twilight Forest, Enderman Overhaul, The Bumblezone, Additional Lights, Farmer's Delight.
- Per-mod compatibility files: a few items have a renderer the geometric border cannot trace faithfully. They fall back to the Ring style automatically. Currently covered: L_Ender's Cataclysm, Hazen N Stuff, Macabre, Cult of Azazel, Bosses'Rise, Ice and Fire, Born in Chaos, Eternal Starlight, Legendary Monsters, Mowzie's Mobs, Simply Swords, Paladins & Priests, Forbidden Arcanus, The Undergarden, Armor of the Ages, Mo'Bosses, Remnant Bosses, Extra Delight, Create, Create Stuff & Additions, Create Big Cannons, Mahou Tsukai, Mekanism, Silent Gear, Iron's Spells 'n Spellbooks, Oritech, Ars Nouveau, Applied Energistics 2, Wither Skeleton Tweaks, Qliphoth Awakening. Every entry is per item, never per mod: the rest of each mod keeps the geometric border.
- Your own blacklist: whatever the compatibility files miss, you can fix in one click from the panel, per item, and report it on the Discord to get it into the next release.
- Pack authors can assign rarity tiers with the
#astoutline:tier/<tier>item tags.
Known limitation: Draconic Evolution draws its tools straight to the GPU with its own shaders, outside any path an outline can intercept. Its items are not outlined.
FAQ
Is there a Discord?
Yes: join here. It's the best place for questions, suggestions and bug reports.
An item has a wrong or missing outline, what do I do?
Open the panel with the item in hand and blacklist it: either force it to the Ring style, or remove its outline entirely. Then report it on the Discord with the mod name, and it will get a proper compatibility entry in the next release.
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.!
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
- Iris: explicit support. The outline is composited outside the shader pack's own passes, so shadows, color grading and water are left untouched.
- Sodium: supported.
- Gnetum: explicit support, so the outline is never cached and left stale on screen.
- Punchy: explicit support. Outlines, occlusion and enchant runes all follow the animated weapon.
- Hold My Items: explicit support, including hand and held-item occlusion.
- GeckoLib: animated items are outlined and follow their animation.
- L_Ender's Cataclysm, Mowzie's Mobs, Farmer's Delight: custom-model items outlined along their visible shape, not their bounding box.
- Accessories: cosmetic layers such as quivers and capes no longer leak through walls.
- Apotheosis: in Rarity mode, outlines follow Apotheosis item rarities. Your per-item overrides always take priority.
- Tridents, shields, banners and other custom-renderer items get outlines and runes too.
- Pack authors can assign rarity tiers themselves with the
#astoutline:tier/<tier>item tags.
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.