Skip to content

First Setup

In order to use the plugin will you need to first set it up properly.
This page will navigate you through the steps required.

1. Download the assets

IAWAILA uses custom textures to display the UI. These textures aren't included in the default ItemsAdder installation, nor in IAWAILA itself to keep it relatively small (Size is still somewhat big due to included language files).

Your first step is to download the Zip file containing the default assets of the plugin.
You can press the button below to download, or get it from the repository:

Download WAILA Assets (1.21.4)

Copyright

All textures within the default Zip are © Mojang and do not fall under the MIT license.

2. Extract assets

You need to extract the content of the Zip file and move it into the plugins/ItemsAdder/ directory. If you made it correctly should there be a folder called waila inside the contents folder and have the following structure:

waila/
└── assets/
    └── waila/
        ├── font/
        │   ├── offset.json
        │   └── waila.json
        └── textures/
            ├── block/
            │   └── minecraft/
            │       └── // PNG images for MC blocks
            └── font/
                └── waila/
                    └── // WAILA image files

3. Add custom block assets

If you have custom blocks from ItemsAdder can you add images to be displayed when the player looks at a custom Block.

Adding images is relatively easy: Just create a new folder named after the namespace of the block(s) in the textures/block/ directory and add the PNG images to display named after the block.
As an example, if I wanted to add an image for myblocks:my_block would I create the folder myblock inside textures/block/ and add a PNG named my_block.png to it.

Isometric Block view/Animated textures

IAWAILA does not support animated textures and will display the file as-is unchanged. This also means it doesn't generate an image depicting the block in an isometric view.

You'll have to make an image yourself showing the block. One easy way to do this is by using the Isometric Renders. Here's a quick guide:

  1. Get the block to render in your inventory and hold it.
  2. Run /isorender item
  3. In the UI, leave all settings unchanged except the image size. Set this one to 128 (recommended).
  4. Click Export.

The image may require additional tweaks (i.e. filling the background with a barely visible color to keep transparent edges) to display properly.

4. Generate image.json Font file

All that is left to do is generate the font file. To do this, run /iawaila (Requires iawaila.admin or iawaila.command.iawaila permission) ingame or in the console.
Should the file already exist and you want to refresh it, append --force to the command to force a refresh.

The plugin should now process the blocks from vanilla and ItemsAdder in the backrgound and generate the file. Note that this will happen asynchronously to not slow down the server.
Once this completed can you run /iazip to refresh the Resource pack.