Item Marks

A Minecraft 1.7.10 mod that allows players to display custom marks on item icons for quick identification of specific items.

In-game config GUI, FULLY customizable.

Features

• Render 1-2 character custom marks on item icons (Auto-adaptation planned)
• Match items by Item ID, metadata (Meta), and NBT data
• Support NBT-only matching (no Item ID required) to match different items with the same NBT structure
• Visual GUI management interface
• Configurable mark position and size

Installation

1. Ensure Minecraft Forge 1.7.10 is installed
2. Ensure ModularUI2 dependency is installed
3. Place the mod JAR file into the mods folder

Usage

Opening the Manager

Press M key (configurable in Controls settings) to open the Item Marks Manager.

Manager Interface Layout

• C Button: Open configuration panel
• R Button: Reset all entries (requires confirmation)
• Add: Create a new mark entry
• From Hand: Get Item ID from held item and create new entry
• Delete: Delete selected entry
• [?]: Display help tooltip

Entry List Operations

• Left-click: Select entry
• Right-click: Edit entry

Entry Editor

Field Descriptions

Item ID Format

NBT Path Syntax

NBT Value Matching

NBT Picker

Click NBT… button to open the NBT Picker (requires holding an item with NBT data):

• Visual display of item's NBT structure
• Click [+]/[-] to expand/collapse compound tags
• After selecting a field, choose:
  • = Value: Match the field's current value
  • Exists (*): Match if field exists
  • Not (!): Match if field does not exist

The NBT Picker is draggable and does not block interaction with the editor window below.

Configuration

Click the C button in the manager to open the configuration panel:

Mark Position Options

• Top Left: Mark displays at top-left corner of item icon
• Top Right: Mark displays at top-right corner of item icon
• Bottom Left: Mark displays at bottom-left corner of item icon
• Middle: Mark displays at center of item icon

Match Priority

When multiple entries could match the same item, the following priority is used:

1. Item + NBT + Meta (most specific)
2. Item + NBT (any metadata)
3. Item + Meta (no NBT condition)
4. Item only (no NBT, no meta restriction)
5. NBT + Meta (no item restriction)
6. NBT only (no item, no meta restriction)

Configuration Files

Mod configuration is stored in the Minecraft config directory:

Entry File Format

One entry per line, format:

Mark|ItemID:Meta|NBTPath|NBTValue

Examples:

★|minecraft:diamond_sword:*||
A|minecraft:potion:0|Potion|minecraft:strength
!|gtceu:electric_item:*|Charge|!

Usage Examples

Example 1: Mark All Diamond Swords

• Mark: ◇
• Item ID: minecraft:diamond_sword:*
• NBT Path: (empty)
• NBT Value: (empty)

Example 2: Mark Enchanted Items

• Mark: E
• Item ID: (empty)
• NBT Path: ench
• NBT Value: *

Example 3: Mark Specific Potion

• Mark: S
• Item ID: minecraft:potion:0
• NBT Path: Potion
• NBT Value: minecraft:strength

Example 4: Mark Uncharged Electric Items

• Mark: !
• Item ID: (empty)
• NBT Path: Charge
• NBT Value: !

Example 5: Multi-Condition Matching

• Mark: OK
• Item ID: modid:machine:0
• NBT Path: (empty)
• NBT Value: active=1&energy=*

Example 6: Wildcard Path Matching (e.g., Fluid Tanks)

• Mark: O₂
• Item ID: (empty)
• NBT Path: *.FluidName
• NBT Value: oxygen

This matches any item where any root-level NBT key contains a FluidName field with value oxygen.

Key Bindings

Configurable in Game Settings → Controls → Item Marks category.

Dependencies

• Minecraft 1.7.10
• Forge
• ModularUI2