What Is Item Marks?
Item Marks is a clever utility mod for Minecraft 1.7.10 that solves a common inventory headache: identifying specific items at a glance. Instead of hovering over every sword, potion, or machine component to read its tooltip, you can assign short, visible marks directly onto item icons. These marks appear as one- or two-character labels — like a star, a letter, or a number — right on the icon itself, making it effortless to spot your enchanted gear, charged tools, or custom NBT-tagged items in a crowded chest.
The mod shines in modded environments where dozens of items share the same base texture but differ in NBT data, damage values, or internal tags. With Item Marks, you can visually distinguish a fully charged battery from an empty one, a Strength potion from a Swiftness potion, or a machine with a specific upgrade from its default version. Everything is managed through an in-game GUI, and the configuration is stored in simple text files, so you can tweak, share, or back up your mark definitions easily.
Core Features
- Customizable 1-2 character marks rendered directly on item icons — use letters, digits, or symbols like ★, !, or OK.
- Flexible matching rules based on Item ID, metadata (damage value), and NBT data, including NBT-only matching that ignores the item type entirely.
- Visual configuration GUI with an entry list, editor, and a built-in NBT picker that lets you browse an item’s NBT structure and select fields without typing raw paths.
- Adjustable mark position and scale — place marks at any corner or the center, and scale them from 50% to 300% to suit your texture pack or GUI scale.
- Smart match priority ensures the most specific rule wins when multiple entries could apply to the same item.
- Wildcard and multi-condition support for advanced NBT matching, including wildcard keys and combined value conditions.
Installation and Setup
Getting Item Marks running on Minecraft 1.7.10 is straightforward. First, make sure you have Minecraft Forge for 1.7.10 installed — this mod relies on Forge’s modding framework. Next, you’ll need the ModularUI2 dependency, which powers the in-game configuration interface. Once both are in place, simply drop the Item Marks JAR file into your mods folder. If you prefer a more streamlined approach, many players use a dedicated launcher that handles modpack assembly and dependency resolution automatically. For instance, the foxygame.net launcher offers a modern, flexible way to manage your Minecraft instances, and you can download Item Marks right from its built-in mod menu without hunting for files manually. After adding the mod, launch the game and you’re ready to start marking.
Using the Item Marks Manager
The heart of the mod is the Item Marks Manager, opened by pressing the M key (this can be rebound in the Controls menu under the Item Marks category). The interface is clean and intuitive, with a list of all your current mark entries and a set of control buttons.
Key manager controls include:
- C Button — opens the configuration panel for display options.
- R Button — resets all entries after a confirmation prompt.
- Add — creates a new blank mark entry.
- From Hand — automatically grabs the Item ID of the item you’re holding and creates a new entry with it.
- Delete — removes the selected entry.
- ? — shows a help tooltip with quick syntax reminders.
Left-click any entry in the list to select it; right-click to open the editor for that entry. The editor is where you define the mark character(s), the target Item ID, and the NBT conditions. The Item ID field accepts formats like modid:item (matches metadata 0), modid:item:16 (specific metadata), or modid:item:* (any metadata). Leaving the Item ID empty tells the mod to match based solely on NBT data, which is incredibly powerful for marking items across different mods that share a common NBT structure.
NBT Matching and the NBT Picker
NBT conditions are where Item Marks really flexes its muscle. You specify an NBT path using dot notation to navigate compound tags, and a value to match against. For example, tag.display.Name targets the custom name of an item, while ench[0] looks at the first enchantment. Wildcards add even more flexibility: * matches any key at a given level, so a path like *.FluidName can check any root-level compound tag for a FluidName field — perfect for items from different mods that store fluid data in slightly different NBT structures.
Value matching supports exact strings or numbers, an asterisk (*) to check if a field merely exists, or an exclamation mark (!) to require that a field does not exist. You can also combine multiple conditions using &, for example active=1&energy>0 to match items that are both active and have positive energy.
To simplify NBT path selection, the editor includes an NBT Picker button (labeled “NBT…”). Hold an item with NBT data in your hand, click the button, and a draggable window appears showing the item’s full NBT tree. You can expand and collapse compound tags, then click a field to insert its path and choose whether to match the current value, check for existence, or require absence. The picker stays open and doesn’t block the editor underneath, so you can tweak multiple entries quickly.
Configuration Options
The configuration panel, accessed via the C button in the manager, lets you adjust how marks appear globally. You can toggle mark rendering on or off, change the mark position to Top Left, Top Right, Bottom Left, or Middle, and set the mark scale anywhere from 50% to 300%. These settings are saved in itemmarks_config.json inside your Minecraft config folder, while the actual mark entries live in itemmarks.txt — a plain text file you can edit outside the game if you prefer.
Match Priority System
When an item could match multiple mark rules, the mod uses a clear priority order to decide which mark to display. The most specific rule wins:
- Item ID + metadata + NBT (most specific)
- Item ID + NBT (any metadata)
- Item ID + metadata (no NBT condition)
- Item ID only (any metadata, no NBT)
- NBT + metadata (no item restriction)
- NBT only (no item, no metadata restriction)
This ensures that a rule targeting a specific potion with a particular NBT tag will override a broader rule that marks all potions, giving you fine-grained control.
Practical Examples
Here are a few real-world scenarios to show how Item Marks can tidy up your inventory:
- Mark all diamond swords — Mark: ◇, Item ID:
minecraft:diamond_sword:*, no NBT conditions. Every diamond sword, regardless of damage, gets a diamond-shaped mark. - Highlight enchanted items — Mark: E, Item ID: (empty), NBT Path:
ench, NBT Value: *. Any item carrying an enchantment tag will display an “E”. - Identify a specific potion — Mark: S, Item ID:
minecraft:potion:0, NBT Path:Potion, NBT Value:minecraft:strength. Only Strength potions get the “S” mark. - Flag uncharged electric tools — Mark: !, Item ID: (empty), NBT Path:
Charge, NBT Value: !. Any item missing a Charge tag (i.e., fully drained) shows an exclamation mark. - Multi-condition machine state — Mark: OK, Item ID:
modid:machine:0, NBT Value:active=1&energy=*. Marks a machine only when it’s active and has some energy stored.
Conclusion
Item Marks is a small but transformative addition for players who deal with complex inventories, especially in tech-heavy or magic-based modpacks. The ability to visually tag items based on their internal data saves time, reduces mistakes, and makes storage systems far more readable. With its intuitive GUI, powerful NBT matching, and flexible display settings, the mod fits seamlessly into any 1.7.10 setup. Whether you’re sorting through dozens of wands, managing a wall of barrels, or just want to spot your favorite sword at a glance, Item Marks delivers a clean, customizable solution that puts the information you need right on the icon.