Textures

Model precedence

When loading or rendering a model namespace:path (eg. minecraft:item/stick), the following options will be attempted in this order; the first to successfully load will be used.

Generic

1. hexdoc.toml:
   doc/hexdoc.toml

   [textures.overrides.models]
   {namespace}:{path}" = ...
2. Internal resources: assets/{namespace}/hexdoc/renders/{path}.{png,gif}
   • If multiple formats exist, the one configured in props.textures.animated.format (default: APNG) will be used.
3. On-demand model rendering: assets/{namespace}/models/{path}.json
4. External resources: assets/{namespace}/hexdoc/renders/{path}.{png,gif}

minecraft:item/stick

1. hexdoc.toml:
   doc/hexdoc.toml

   [textures.overrides.models]
   minecraft:item/stick" = ...
2. Internal resources: assets/minecraft/hexdoc/renders/item/stick.{png,gif}
   • If multiple formats exist, the one configured in props.textures.animated.format (default: APNG) will be used.
3. On-demand model rendering: assets/minecraft/models/item/stick.json
4. External resources: assets/minecraft/hexdoc/renders/item/stick.{png,gif}

note

In hexdoc.toml, if textures.strict is True (the default) and none of the above options are successfully loaded, the build will fail.