top of page

Pro Pixel Palette

Manual

Version 1.0.0

Video Tutorial: https://youtu.be/zCjtEWU4OfA

Video Tutorial (Renderer Setup): https://youtu.be/u7txUjfmvaU

How to Use
Open the Tool

From Unity’s top menu: Tools → Reamplyfied → ProPixelPalette Window



This opens a dedicated PPPalette window.


Pixel art editor window showing a karate fighter sprite on a transparent checkerboard, with palette and export buttons visible
PPPalette Window
Create a PPPalette Asset

  • Right-click in Project, go to Create → Pro Pixel Palette → PPPalette Asset



  • Assign the PPPalette asset to the PPPalette window.


  • Right-click the asset and select properties to open the PPPalette Asset properties.

 


  • Dock the PPPalette Asset properties window next to the PPPalette window.


Recommended workflow setup
Recommended workflow setup
Palette Extraction and Modification

1  Drag and drop the sprites or the folder containing the sprites you want to create a color palette for. It is recommended to drop the parent folder containing all the sprites. This ensures the output maintains the same structure as your original folder structure.


Note: Make sure no unwanted sprites are present in the parent folder to avoid adding unused colors to the palette.



Note: All sprite “Texture Type” must be set to “Sprite (2D and UI)”, and the “Read/Write” property must be enabled.


2  Click the “Add All Colors To Palette” button to add all the individual sprite colors in the sprite list to the pppalette asset. Additionally, you can selectively add colors from each sprite.



These buttons also help identify when a newly added sprite contains colors that are not present in the palette. Add them by clicking the corresponding button.


3  Click the preview button to select a suitable sprite for sampling.


4  In the pppalette asset properties, click the “Add Group” button to create a color group (for example, a hair color group, skin color, clothes, etc.).


5  In the pppalette window, go to the sample sprite preview area (Use mouse wheel to zoom in and out). Click each individual pixel color to highlight them in the pppalette asset editable palette.


6  In the pppalette asset editable palette, drag and drop the highlighted color into your group. Add all colors corresponding to that group.


7  Use the group settings properties to bulk modify the colors in the group. Each individual color can still be modified in the group by clicking the color field and picking a new color from the color picker.


Note: It is advisable to save the original color palette (Step 8) before any modifications.

Each Group has an “Exclude From Palette” toggle. Toggle this on for any color group you do not want to modify. Fewer colors result in fewer shader computations. So, excluding unchanged colors can improve performance.


8  Use the “Save Current As Preset” button to save the current modifications as a palette preset. You can save an unlimited number of presets in one pppalette asset.

 PPPalette Asset Usage

  • Create a GameObject with a SpriteRenderer component, set your sprite in the Sprite field.


Note: If you notice some color mismatch or artifacts around the sprite edges, set the texture compression format to RGBA 32 bit.



  • Go to “Add component in the inspector, search “PPPaletteSwapper” and add that script.


  • In PPPaletteSwapper “Palette” field, assign the pppalette asset.


  • Create a new material and add the SpriteRenderer material field.


In the material shader, select  ProPixelShader → PPPaletteShader_URP (or PPPaletteShader_BuiltIn), depending on your project renderer pipeline.


Note: Make sure “Source Blend = ScrAlpha” and “Destination Blend = OneMinusSrcAlpha”.



  • Click the Palette Preset dropdown in PPPaletteSwapper and select a preset from the menu.


 Runtime Palette Swapping

1.      Create a new script.


2.      Add the namespace: using PPPalette;


3.      Inherit from PPPaletteRuntimeController.


using UnityEngine;
UnityEngine PPPalette;

public class PPPExample : PPPaletteRuntimeController
{

}

4.      Save and run.


5.      Use the Runtime Palette Preset dropdown to select palette presets at runtime.


6.      PPPaletteRuntimeController also provides preset color group modification at runtime.


 Pro Pixel Shader

The pro pixel shader provides a custom shader property window with an organised, clean layout. You can easily switch between the built-in renderer pipeline and URP, select lighting mode directly from the shader properties. It also comes with several shader effects and unique VFXs with effect combination possibilities. Be sure to check the example scenes.


Do not hesitate to contact us for technical support.

Email: reamplyfied@gmail.com

bottom of page