CIT for NBT logo

CIT for NBT

Mod

by SabrePotato

An NBT based CIT alternative for Optifine.

Downloads

46,105

Type

Mod

CurseForge ID

1298387

Last Updated

Apr 10, 2026

Description

CIT for NBT

A mod that adds Optifine's CIT feature as a standalone feature for 1.12.2.

Usage

This mod currently only looks in the .minecraft/resources folder for your files. It treats this resource folder as the "assets" folder. In other words, a path assets/<namespace>/textures would be placed in resources/<namespace>/textures instead. This allows compat with mods like contenttweaker, which follows this folder style instead.

To conditionally texture an item, a .properties file must exist. This file can exist anywhere in the resources folder, and can apply to a list of items. This currently requires two fields. items, the target item. And texture or model, which can be any texture or valid item. All other fields are currently optional.

Example:

items=minecraft:stick nbt.display.Name=contains:Glow texture=cit:items/stick_glow

Note: texture does NOT need to be in the same namespace as the item.

Behavior

  • The NBT condition exists must be either true or false
  • Relative paths do not work like Optifine's do (yet)
  • Aside from the one exception above, the file format is stable. Unless a serious bug occurs, you can use the same .properties file in any version.

Current Features

  • NBT conditions
    • Matches: nbt.tag.path=matches:ExactNBTMatch
    • Contains/IContains: nbt.tag.path=contains:TextToContain
    • Exists: nbt.tag.path=exists:true
    • Range: nbt.tag.path=range:1-5 9 17
    • Regex/IRegex: nbt.display.Name=iregex:Something fishe?y is(n't)? brewing\\.+
    • Raw: nbt.ench=raw:[{lvl:1s,id:2s}]
  • Item Stack conditions
    • Stack Size: stackSize=1 or stackSize=range:1-17 32
  • Basic model support (not fully tested)
  • mcmeta animation support
  • Hot reload
  • Multi item support items=minecraft:paper minecraft:stick

Possible future features

  • Regular Resourcepack Support
  • More Optifine conditions
  • Set primary assets folder

Breaking Changes

0.2 -> 0.3+

Free-floating .properties files will require an additional suffix related to their role. For example: item.properties -> item.cit.properties, animation_item.properties -> animation_item.anim.properties. Files that follow Optifine's folder organization will not require additional suffix. While I may add support for default being cit, this should not be counted upon.

Similar Mods

Included in Modpacks

External Resources