Andy's Dyeable Item Frames

Dye, display, and organize with item frames that finally match your build.

Andy's Dyeable Item Frames adds dyeable versions of both the normal Item Frame and Glow Item Frame to Minecraft Bedrock. Their leather centers use Bedrock's real minecraft:dyeable item system—the same system used by leather armor—so dyeing a frame feels like a natural part of vanilla gameplay instead of a separate color menu.

Prepare colored water in a cauldron, interact with it while holding your frames, and the held frame stack takes on that dye color. Place the result on a wall, floor, or ceiling and use it like a normal frame. The wooden border keeps its vanilla appearance while only the leather center changes color. Glow variants retain their brighter center and colored glow effect.

Under the dyed leather, each placed frame is backed by a real Bedrock Item Frame or Glow Item Frame. That means displayed items, maps, normal rotation, comparator output, breaking behavior, and glow-item rendering remain in Minecraft's hands. The add-on adds the color and optional settings without replacing the frame behavior players already know.

Features

• Dyeable Item Frames and Dyeable Glow Item Frames
• All 16 familiar Minecraft dye colors
• Uses Bedrock's native leather-item dye component
• Dye complete held stacks in colored cauldron water
• Vanilla-colored wooden frame border with a dyed leather center
• Brighter, color-matched centers on Glow Item Frames
• Wall, floor, and ceiling placement
• Native item insertion, removal, rotation, map display, comparator output, and glow rendering
• Dyed color is preserved when the frame is broken and placed again
• Survival-friendly shapeless recipes
• Recipe-book unlocks from obtaining any dye
• DyeFrameSettings stick for optional rotation locking and frame labels
• Persistent per-frame settings
• Works in single-player, multiplayer, Realms, and supported Bedrock servers
• No Cheats or experimental gameplay toggles required

Requirements

• Minecraft Bedrock Edition 1.21.90 or newer
• Both the included Behavior Pack and Resource Pack active at the same version
• No required add-on dependencies
• No experimental gameplay toggles

Installation Guide

Windows, Android, iPhone, and iPad

1. Download Andys_Dyeable_Item_Frames_3.1.2.mcaddon from this official CurseForge project.
2. Open the downloaded .mcaddon file with Minecraft Bedrock.
3. Wait for Minecraft to confirm that both included packs imported successfully.
4. Create a world, or edit the world where you want to use the add-on.
5. Open Behavior Packs → My Packs.
6. Activate Andy's Dyeable Item Frames BP.
7. Confirm that Andy's Dyeable Item Frames RP is active under Resource Packs. Bedrock may activate the paired pack automatically.
8. Enter the world. Cheats and experimental toggles are not required.

Back up an important world before installing or updating any add-on.

Xbox, PlayStation, and Nintendo Switch

Consoles generally cannot import arbitrary local .mcaddon files directly. Import and activate the add-on on Windows or mobile, upload the prepared world to a Realm, and join that Realm from the console. Realm members will download the world's required packs when joining.

Updating the Add-On

1. Back up the world.
2. Close the world completely.
3. Import the newer .mcaddon file.
4. Edit the world and confirm that the Behavior Pack and Resource Pack show the same newest version.
5. Remove older active copies if Minecraft retained them.
6. Reopen the world.

Frames placed by releases 2.0.0 through 2.0.9 use the add-on's older custom-block system. Break and replace those legacy frames once with version 3.0.0 or newer to receive native displayed-item behavior and DyeFrameSettings support.

Dyeable Frame Recipes

Both recipes are shapeless and use a Crafting Table.

Dyeable Item Frame

1 Item Frame + 1 Leather = 1 Dyeable Item Frame

Dyeable Glow Item Frame

1 Glow Item Frame + 1 Leather = 1 Dyeable Glow Item Frame

Obtaining any one of Minecraft's 16 dyes unlocks both recipes in the recipe book. Leather is the added ingredient because the recolorable portion of each frame is its leather center.

How to Dye Frames in a Cauldron

The process follows the same Bedrock dye system used for leather armor.

1. Place a Cauldron.
2. Fill the Cauldron with water.
3. Hold the dye color you want.
4. Interact with the water-filled Cauldron to color the water.
5. Hold a Dyeable Item Frame or Dyeable Glow Item Frame.
6. Interact with the dyed cauldron water.
7. The entire held frame stack takes on that color.
8. Place the dyed frames wherever you want to display or organize items.

Minecraft's 16 standard dye colors are supported. If dyes are mixed into a custom shade, the placed frame uses the closest supported vanilla dye color.

Using Dyed Frames

1. Place a dyed frame against a wall, floor, or ceiling.
2. Interact with the placed frame while holding an item to display it.
3. Interact again to rotate the displayed item through the normal frame positions.
4. Break the frame normally when you want to move it.
5. In Survival, the custom frame drops with its dye state preserved. Minecraft also drops the displayed item normally.

Because the placed frame uses a native Bedrock frame underneath its dyed leather skin, maps, renamed items, Glow Item Frame brightness, comparator output, and the normal eight rotation positions behave like vanilla frames.

DyeFrameSettings Stick

The settings tool works on normal, glow, vanilla, and dyed frames.

Create the settings stick

1. Place a normal Stick in an Anvil.
2. Rename it exactly:

DyeFrameSettings

1. Hold the renamed stick.
2. Interact directly with any placed Item Frame or Glow Item Frame.

The Item Frame Settings menu opens for that individual frame. Settings are saved per frame and persist across world reloads.

Item Frame Settings

Lock displayed-item rotation

Prevents use-clicks from changing the displayed item's rotation. This is useful for labels, maps, tools, clocks, and decorative displays that should stay aligned when players interact nearby.

Place the displayed item and set its desired angle before enabling the lock. If an empty locked frame will not accept an item, open the settings again and temporarily disable the lock.

Breaking the frame still works normally.

Show name while looking at frame

Displays the frame's name in the action bar while a player looks directly at it from within eight blocks. The text disappears when the player looks away, keeping storage rooms readable without filling the screen with permanent labels.

Display name

Sets the text used by Show name while looking at frame. Enter a custom label such as Building Blocks, Redstone Parts, or Diamond Tools.

Names may contain up to 80 characters. If no custom label is supplied, the add-on attempts to use the displayed item's normal or custom name when Bedrock exposes that item name to scripts.

Save

Saves the rotation-lock, name-display, and label settings to that frame. Configuring a vanilla frame does not replace its normal vanilla drop.

Storage-Room Ideas

• Dye barrel labels by item category
• Use blue frames for ores, green for crops, and red for combat supplies
• Give rare storage sections brighter Glow Item Frames
• Lock item rotation so visitors cannot disturb carefully aligned labels
• Show container names only while players look at them
• Build color-coded map walls, workshops, libraries, armories, and sorting systems

Native Frame Behavior

The add-on deliberately keeps a real minecraft:frame or minecraft:glow_frame behind every newly placed dyed frame. Minecraft therefore remains responsible for:

• The displayed item slot
• Inserting and removing items
• Eight-step item rotation
• Map display and map state
• Comparator output
• Displayed-item drops
• Glow Item Frame item rendering

The add-on stores the dye color and renders a fitted leather-center skin without covering the vanilla wooden border.

Performance Guidance

A dyed frame is slightly heavier than a completely vanilla frame because it uses the native frame plus one lightweight, zero-hitbox visual marker that stores and renders the leather color. Frames configured with DyeFrameSettings use the same marker system.

Ordinary storage rooms and display walls should be practical, but very dense builds can cost more than the same number of untouched vanilla frames. Add large displays gradually on lower-powered devices, multiplayer servers, and Realms, and test them under the normal number of players expected in the area.

Achievement-Friendly Design

Andy's Dyeable Item Frames is designed to preserve normal achievement eligibility:

• No Cheats required
• No Beta APIs
• No experimental world toggles
• Stable @minecraft/server and @minecraft/server-ui APIs
• No required external add-ons

Minecraft makes the final achievement-eligibility decision for every world. A world that previously enabled Creative mode, Cheats, Experiments, or an ineligible template may already have achievements disabled; removing an add-on cannot reverse that history.

Compatibility

• Minecraft Bedrock 1.21.90 or newer
• Windows, Android, iOS/iPadOS, Xbox, PlayStation, and Nintendo Switch through supported world or Realm delivery
• Single-player and multiplayer worlds
• Realms and Bedrock servers that support world Behavior Packs and Resource Packs
• Standard graphics and Vibrant Visuals
• No required dependencies

Resource packs that replace vanilla Item Frame or Glow Item Frame visuals may change the visible wooden border or conflict with the intended appearance. Add-ons that intercept frame placement, interaction, breaking, or drops may also conflict. Test unusual pack combinations in a copied world first.

Troubleshooting

The recipes do not appear

• Confirm that Andy's Dyeable Item Frames BP is active.
• Obtain any normal Minecraft dye to unlock both recipes.
• Use a Crafting Table, not only the 2×2 inventory grid.
• Use a vanilla Item Frame or Glow Item Frame plus one Leather.
• Leave and reopen the world after changing active packs.

A frame will not take dye

• Confirm that you crafted the add-on's Dyeable Item Frame or Dyeable Glow Item Frame. A vanilla frame is not directly dyeable.
• Fill the Cauldron with water before adding dye.
• Interact with the colored water while holding the frame stack.
• Confirm that the Behavior Pack and Resource Pack are both active at the same version.

The frame places without its color, appears black, or uses the wrong visual

• Confirm that Andy's Dyeable Item Frames RP is active.
• Confirm that both included packs show the same version.
• Completely leave and reopen the world.
• Test once with other frame-changing resource packs disabled.
• Break and replace a frame that was placed by a legacy 2.x release.

Items will not insert or rotate

• Use the displayed item directly on the center of the frame.
• If rotation locking is enabled, use DyeFrameSettings and disable the lock before inserting an item or changing its angle.
• Confirm that the native frame is still present and that no other add-on is intercepting frame interaction.

The settings menu does not open

• Start with a normal vanilla Stick.
• Rename it DyeFrameSettings in an Anvil with no spaces.
• Hold it and interact directly with the placed frame.
• Confirm that the Behavior Pack is active.

A frame name does not appear

• Enable Show name while looking at frame and press Save.
• Look directly at the frame from within eight blocks.
• Enter a custom Display name if Bedrock does not expose the displayed item's name.

The import fails

• Confirm that the filename ends in .mcaddon, not .zip.
• Do not extract, rename, or recompress the package.
• Download the file again if it may be incomplete.
• Close and reopen Minecraft Bedrock, then import it again.

An older version still appears

• Open Minecraft Settings → Storage.
• Check for older Behavior Pack and Resource Pack copies.
• Remove obsolete copies if needed.
• Restart Minecraft and import the newest .mcaddon again.
• Activate only the newest matching BP and RP pair.

Enjoying Andy's Dyeable Item Frames?

Follow the project on CurseForge to receive update notifications, leave a comment with feedback, and share screenshots or videos of the storage rooms, map walls, workshops, and color-coded displays you create.

If the add-on helps organize or decorate your world, please consider rating or favoriting the project. Those small actions help other Minecraft Bedrock players discover Andy's Add-ons.

Follow and Support Andy

Visit AndyTheMakerMC.xyz for Andy's add-ons, world lore, tutorials, guides, videos, and other Minecraft content.

Follow @AndyTheMakerMC on:

• YouTube
• Twitch
• <input disabled="disabled" type="checkbox" checked="checked" />(https://x.com/AndyTheMakerMC)
• TikTok
• Instagram

Support future projects through Ko-fi or a direct Stripe contribution.

Content Creator Usage Rights

Content creators may use an official, unmodified release of Andy's Dyeable Item Frames in their Minecraft worlds, multiplayer worlds, Realms, servers, videos, livestreams, screenshots, tutorials, reviews, showcases, articles, guides, social posts, and other original gameplay content, including monetized content.

Credit to AndyTheMakerMC and a link to the official CurseForge project page are appreciated whenever practical.

This permission allows normal Minecraft delivery of the official, unmodified add-on to players joining an authorized world, Realm, or server. It does not grant permission to offer the add-on file as a separate download or to redistribute, rehost, mirror, modify, translate, adapt, extract, decompile, disassemble, reverse engineer, or reuse any project content.

All Rights Reserved License

All Rights Reserved. Copyright © 2026 Andy / AndyTheMakerMC.

You may not redistribute, reupload, rehost, mirror, resell, sublicense, bundle, repackage, modify and publish, translate, adapt, decompile, disassemble, reverse engineer, extract, or reuse the add-on, its source code, documentation, branding, textures, models, or artwork. You may not create derivative works or incorporate any portion into another add-on, pack, application, website, download, or project without prior written permission from the copyright holder.

The Content Creator Usage Rights above provide limited permission to display normal gameplay and commentary using an official, unmodified release. They do not transfer ownership or grant permission to distribute, modify, reverse engineer, or rehost the project files.

The promotional artwork is original AI-assisted concept artwork directed for this project. It is not an in-game screenshot.

Minecraft is a trademark of Microsoft Corporation. This project is not affiliated with, endorsed by, sponsored by, or associated with Microsoft or Mojang Studios.

Official Links and Attribution

• Website: www.AndyTheMakerMC.XYZ
• Creator credit: AndyTheMakerMC
• X, Twitch, and YouTube: @AndyTheMakerMC