Assets and Items

Assets and Minecraft items

Two panels in the top-left tab group handle pictures: Assets for your own images and Items for Minecraft item icons. Both are also under View → Panels.

Assets (your images)

Assets shows thumbnails and resource paths for every PNG in your project, with a search box.

Button	Does
Import PNGs	Adds one or more PNG files. A clashing filename gets a suffix; nothing is overwritten. (Also Project → Import texture….)
Assign selected	Uses the selected image as the skin or texture of the selected controls.
Add image	Creates an Image control showing it.
Replace	Swaps the image's pixels but keeps its path, so every control using it updates.
Find uses	Lists controls, events and scripts that mention the image.
Delete	Removes the image. Refused while it's still known to be used.

You can also drag an image onto the canvas to create an Image control there. All of these can be undone.

Scripts that build image paths from pieces can't be detected by Find uses. Check your scripts before deleting an image that looks unused.

Where images live: assets/<project_id>/textures/gui/<control_type>/<name>.png, referenced as <project_id>:textures/gui/<control_type>/<name>.png. Wysicraft manages these paths for you, and they update automatically if you change the project Id. Minecraft resource packs can override them.

Limits: PNG only, up to 8192 × 8192 pixels and 32 MiB each, 256 MiB per project. The editor may show a smaller preview of large images; exports keep the originals.

Items (Minecraft item icons)

Items searches Minecraft items by name or ID (namespace:item_id).

• Add item creates an Item Icon control, or drag an item onto the canvas.
• Assign selected changes the item of the selected Item Icon controls.
• Item Icon controls also have a Browse Minecraft items button in Properties.
• You can always type an ID straight into the control's Item field.

Where the list comes from

• Wysicraft reads your installed Minecraft 1.21.1 client automatically when it can find it (the standard launcher, or Wysicraft's own test instance).
• Load Minecraft / mod JAR adds items from another client or mod JAR.
• For the exact list of registered items, including modded items, start a Minecraft test once, then click Read test items. It also reads textures from the test instance's mods folder.

Minecraft's files stay on your computer; they're never packed into your project or exports.

About the thumbnails

Thumbnails are texture previews, not 3D renders. Blocks show one face, animated textures show their first frame, and some custom-rendered items have no thumbnail. In Minecraft, the real model, tint and animation are drawn. An item with no thumbnail still works if its mod is installed.