Skip to content

Compatibility and Troubleshooting

Charles Gantt edited this page Sep 7, 2026 · 1 revision

Compatibility and troubleshooting

Compatibility

  • Minecraft Bedrock Edition 1.21.90 or newer
  • Standard graphics and Vibrant Visuals / PBR
  • Single-player, multiplayer, Realms, and dedicated servers
  • Overworld, Nether, and End
  • No experiments, cheats, operator permissions, or companion add-ons required

Vanilla item frames, glow item frames, and their recipes are left alone. This add-on only adds the two dyeable items and their recipes, so worlds and builds that already use item frames are unaffected.

Resource packs

A resource pack that retextures item frames changes the wooden border, because that border is the vanilla texture. The dyed leather center comes from this add-on and is not affected.

If a resource pack replaces the item frame model rather than only its texture, the dyed panel may not line up. Move this add-on above the other pack in your resource pack order and reopen the world.

Troubleshooting

The recipes do not appear

Obtain any dye at least once. That unlocks both recipes in the recipe book.

A frame shows no color after updating to 3.1.19

Frames placed on walls pick up the fix as soon as you load back in.

Frames placed underneath a block were positioned incorrectly by earlier versions. Break them and place them again and they will come back right.

The whole stack changed color

That is expected. Dyeing applies to the held stack, not to a single frame.

The color is not the dye I used

If the cauldron water holds a mix of dyes, the placed frame uses the closest of the 16 supported colors.

A placed frame looks plain

Confirm both packs are active and at the same version. The behavior pack places the frame and the resource pack draws the dyed panel, so an active behavior pack with an inactive or mismatched resource pack shows plain frames.

The DyeFrameSettings stick does nothing

The name must be exactly DyeFrameSettings, renamed in an anvil. Hold it and interact directly with a placed frame.

Reporting a problem

Include your Minecraft version, platform, whether you are in a world, Realm, or server, your other active add-ons and resource packs, and the steps that led to the problem.