Troubleshooting

intermediate troubleshooting

Color Studio 10 · Troubleshooting & FAQ

Troubleshooting

This page covers the most common issues users encounter with Color Studio and how to resolve them.

Pixel Painter does not open or shows a warning

SymptomThe Pixel Painter window displays a warning about a missing package, or fails to open.
CauseThe Unity 2D Sprite package is not installed in your project.
Solution
  1. Open Window > Package Manager.
  2. Search for 2D Sprite in the Unity Registry.
  3. Click Install.
  4. Reopen Pixel Painter from Window > Color Studio > Pixel Painter.

Palette changes are not saved

SymptomYou modify a palette but the changes are lost when you reopen Unity.
CauseThe palette was modified in the Color Wheel tab without clicking Save in the Import/Export tab.
Solution
  1. After making changes, switch to the Palette Import/Export tab (2nd tab).
  2. Click Save to update the existing palette, or Save As to create a new one.
  3. The palette is stored as a ScriptableObject asset in your project — make sure it is not excluded from version control.

Recolor component has no visible effect

SymptomYou added the Recolor component but the object looks the same.
CauseNo palette is assigned, or the palette colors are too similar to the original colors.
Solution
  1. Ensure a Palette is assigned in the Recolor component inspector.
  2. Try a palette with contrasting colors to confirm the component is working.
  3. Check the Mode setting — use Texture for sprite recoloring or MainColorOnly for material color changes.
  4. If using Optimization, click Update Optimization after making changes.

Original textures appear modified

SymptomAfter using Recolor, the original texture files seem changed.
CauseThis is usually a visual misunderstanding — Recolor creates copies and never modifies original assets.
Solution
  1. Disable or remove the Recolor component — original materials and textures will be restored.
  2. If textures were permanently changed, you likely used the Bake function. Baking writes modifications to disk. Use version control to revert if needed.

Color matching produces unexpected results

SymptomRecolored objects or converted textures look wrong — colors do not match expectations.
CauseThe color matching algorithm may not suit the specific use case.
Solution
  1. Try switching the Match Mode between RGB, HSL, OKLCH, and OKLab.
  2. OKLCH generally produces the most perceptually accurate results.
  3. Enable Interpolate for smoother luminance transitions.
  4. Ensure your palette has enough shades to cover the luminance range of the source image.
Was this page helpful?