DOCS
Reference

Troubleshooting

Common editing, import, playback and export problems.

Pixart reports operation errors and warnings in the Unity Console. Check the message there first; it usually names the condition that stopped the action.

The editor doesn't compile after import

Check that 2D Sprite (com.unity.2d.sprite) is installed. The editor assembly references Unity.2D.Sprite.Editor. Current testing uses Unity 6.3. See dependencies.

Nothing happens when I paint

Check all selected layers. A hidden or locked layer blocks the edit; show/unlock it or deselect it first. A selection can also clip your strokes, and transparent slot 0 paints transparency. For a custom brush, check that its first frame has visible pixels and is no larger than 64×64.

If a keyboard shortcut does nothing, focus the canvas. A text or number field may still be receiving the key.

The scene object doesn't update while drawing

Use Pixart Live Previewer with the correct asset assigned, and enable Live Preview on both the component and the Pixart View menu. Disable External Control if Pixart is meant to own the sprite.

A standard SpriteRenderer assigned to an imported Sprite only updates after saving. An exported PNG only updates after re-export. See using sprites in Unity.

Animation is static in Play Mode

Add Pixart Animator alongside Live Previewer. Enable Play On Awake on Animator, or call its Play() method. Both components must be enabled. Check Start Animation and any missing-range warning in the Inspector. External Control on Live Previewer pauses Pixart playback. Speed and the scaled/unscaled time choice can also explain a pause.

A Once range holds its final frame. Call Play("Idle") when you want to return to Idle.

Copying or pasting gives unexpected colors

Copy keeps separate pixels for each selected frame/layer; it does not flatten the visible image. When pasting a multi-target copy, select the same number of frames and layers as the source. The clipboard carries the selected pixels and their palette colors. It belongs to Pixart and is cleared by script reload/editor restart.

Pasting can add missing colors to a local palette, but won't modify a shared palette to make room. Choose None in Palette > Set Palette… to make a local copy, or add matching colors to the shared palette first. A full 256-slot palette can reject the paste.

Editing a palette stopped changes from reaching other sprites

Editing a shared palette through one sprite detaches that sprite to a local copy. Use Palette > Override Palette to update the original asset and reconnect, or Save New Palette… to keep it separate. Palettes covers both options.

A moved selection stayed where I put it after Escape

Escape keeps the pixels and deselects. Use Undo to reverse the transform. Before the transform is finished, Undo cancels the floating preview first. Selections covers these controls.

Pen pressure stays fixed

Open Tools > Pen Settings… and press in the Pressure test area. If the meter changes, enable pressure for the current tool and set its maximum above the minimum. If it says No pen input received or stays at 100%, check the tablet driver's settings for Unity. See tablets & pen pressure for the full setup.

Onion skins are invisible

Make sure Onion is enabled, playback is paused, and the previous/next direction you want is enabled. Open the arrow beside Onion and enable Show on top if the current artwork covers the guides. With the option off, guides sit behind the current frame. They don't wrap at the first/last frame. Canvases over 1,048,576 pixels disable onion skins to bound memory use.

Painting changes more than one frame or layer

Check the highlighted frame thumbnails and layer rows. Painting and selection operations apply to all selected frame/layer combinations. Click one thumbnail and one layer without modifiers to return to editing a single target. See multi-edit.

Undo after editing layer opacity

Use Cmd/Ctrl+Z while focused anywhere inside the Pixart window. It should undo Pixart's edit. If you're typing in a text or number field, that field handles its typing history first. Move focus out of the field or use Edit > Undo inside Pixart to undo the artwork operation.

Imported artwork has different colors

Maximum colors includes transparent slot 0. If the source has more visible colors than the remaining slots, Pixart reduces them. Compare Result with Source and raise the limit up to the detected source maximum if you lowered it. The initial limit already includes all detected source colors, up to 256 slots. Smooth resizing can introduce new colors too; use Nearest neighbor for existing pixel art. Leave Dither off if you want clean, solid regions.

JPEG backgrounds are opaque. Alpha cutoff removes low-alpha pixels; it does not remove a background by color. See image import.

The sheet is sliced in the wrong places

Check Frame width/height, Left/Top margin and both spacing values in Source / slicing. Grid dimensions are measured in original image pixels, before resizing. Only complete cells are imported, in row order. If the texture already has Unity slices, choose Unity sprite slices instead.

An imported palette cannot be assigned

The sprite may use indices beyond the new palette's length. Palette assignment keeps those indices, so it needs a slot for each used index. Use image import if you want existing image pixels remapped to fewer colors. Palette import only extracts and saves colors. See Import a palette.

Export refuses to overwrite a file

The output may belong to something else, have been edited externally, or no longer match its .pixart-export.json sidecar. Keep the sidecar with its PNGs/clips, and use the same name, format and scope when re-exporting.

To make a fresh export with a different scope or format, choose a new output name or folder. Pixart also refuses to remove an existing sliced Sprite from a sheet on re-export; use a new sheet name for a reduced set.

Recovered unsaved artwork

Pixart keeps local recovery checkpoints after completed edits and around editor lifecycle changes. Reopening may restore one and report Recovered unsaved artwork. Save accepts that artwork. File > Reload from Disk… discards it after confirmation.

Recovery files live in Library/InanEvin/Pixart/Recovery and are deleted if you clear Library. Recovery restores the artwork, but not the undo stack or clipboard.

If the source changes externally while you have unsaved edits, your session stays open. Reload to use the external version, or Save Copy to keep your edits in another asset.

A large operation is rejected

Undo history and preview pixel buffers each have a 32 MiB budget. When history fills up, the oldest undo commands are dropped. Drawing gestures and selections are limited to 262,144 pixels; a batch shares that budget across selected targets. Selection bounds count too, including gaps between disconnected islands. Exceeding the limit cancels the operation.

Large canvases with many layers or frames can hit these limits. Try editing a smaller region, reducing the canvas size or frame count, or splitting the artwork into separate assets.

On this page