Obscure Tooltips

Obscure Tooltips

Stylized tooltips with beautiful effects and smooth animations!

Updated May 17, 2026

Edit on GitHub
Cover
FabricForgeNeo ForgeDiscordMedia Kit

Obscure Tooltips is a client-side mod that enhances item tooltips with animated visual and particle effects, making rarer items more vibrant and eye-catching. The information provided here is intended to help understand the core concepts of the mod and customize it to your needs.

This wiki is relevant only for version 3.0.0 and above.
Older versions are incomplete and may be unstable.

Key Concept

Obscure Tooltips works like a box of LEGO. Every tooltip is made from small pieces. You can mix existing pieces or create your own. All customization is done either through a custom resource pack, or in a config-like way using Fragmentum Layer – no compiling, no manual enabling, nothing complicated.

How Everything Works

  • There are basic visual pieces: Panels, Frames, Slots, Icons, and Effects. These are simply visual JSON definitions. They don’t know when or where they’ll be used – only what they look like.

  • These pieces are combined into Styles. A Style is a JSON file that says: “use this panel, this frame, these effects.” Styles contain no logic – only appearance.

  • To actually apply a Style to items, you use Definitions. A Definition is a JSON file with a priority, a link to a Style, and filters: by item ID, tags, rarity, NBT, and so on.

Pack Structure

The folder layout below shows how Obscure Tooltips organizes all its data. This structure is the same whether you are using a resource pack or the root directory of Fragmentum Layer – the mod reads both in exactly the same format.

Example
assets/
<mod_id>/ Your pack's namespace
tooltips/
element/ Element repository
panel/
frame/
slot/
icon/
effect/
style/ Style repository
definition/ Definition repository
label/ Label repository