CIT for NBT

CIT for NBT

A mod that adds Optifine's CIT feature as a standalone feature for 1.12.2. Note that currently this is still in development. Most item-based features are implemented, while other stuff (ie. armor, enchantment glint, elytra) is not implemented yet.

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 .cit.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
  • Metadata or damage
  • Damage mask
  • Current hand: hand=any, hand=off, or hand=main
  • Enchantments
  • Enchantment levels
• Basic model support
• 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

Interactions

If Resource Loader is detected, this mod will deactivate its own internal resource loader in order to avoid potential conflicts.

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.