Assets

Assets are used to display images of items, blocks and other project content across the website.

These can be used as part of crafting recipes, sidebar information or custom components.

Placement

• <root>
  • .assets
    • <namespace>
      • gui
        • electric_furnace.png
        • progress.gif
      • example_item.png// Referenced via <namespace>:example_item

Format

Assets are identified using resource locations  using the same syntax as in the game itself. It’s recommened to match asset names with the in-game IDs of the objects they belong to.

Rendered project assets including both items and blocks should be placed under .assets/(modid) inside the documentation directory, where modid is the namespace of each texture you wish to provide.

By default, resource locations point to .png files. A custom file extension can be appended to the resource location if the file is of another format.

The name of the file is up to your choice.

Examples

• examplemod:generator - Displays <root>/.assets/examplemod/generator.png

• examplemod:gui/grinding.gif - Displays <root>/.assets/examplemod/gui/grinding.gif

• minecraft:crafting_table, crafting_table - Displays a 3D render of the Crafting table

Usage

You’ll encounter assets being used for various different purposes across the wiki depending on the feature.

The most common use cases include:

• Displaying images anywhere in pages

• Providing icons for pages by specifying the icon frontmatter attribute

• Providing icons for content pages, sourced automatically using the page’s id frontmatter attribute as the asset location

• Showing items in recipes