ericezam / godot-color-palette

Manage color palettes from within Godot to make coloring and theming easier!

Godot Color Palette Plugin

Manage color palettes from within Godot to make coloring and theming easier!

Watch the feature demo

Quick Reference Docs

To install the plugin, download the repository and put the folder addons/godot-color-palette into your project directory (res://). Or download directly from the asset library within the Godot editor.

Go to Project -> Settings -> Plugins, and activate the plugin. A new "Color Palette" tab should appear at the bottom, near "Output", "Debugger", etc.

In this tab you can view and manage your colors and palettes.

Basic Usage

Palette management

• Set the palette directory to where palette files (GIMP Palettes, .gpl files) should be stored. This is where palettes are saved to. Also, if you download palettes online or bring existing ones from GIMP or Aseprite, they should go here.
• Add new palettes by giving them a name and clicking the plus button next to the text box.
• Click the reload button to reload all palette files and refresh the list.

Color Management

• To add a new color to a palette, select the palette by clicking on it's name. You can then choose a color with the color picker and press the plus button above the picker to add it to the color list.
• To edit a color, click on the color in the palettes color list. Edit the color in the color picker, and then click the override button above the picker (it's to the left of the Add button)
• Click and drag colors in the list to rearrange them
• These actions have undo-redo ability.

Integration with Editor Color Picker

• Click "Load into Picker" to load the palette into the editor's color picker presets. NOTE: Sometimes the picker may not refresh immediately. To resolve this, change scene tabs or go to Scene > Revert Scene. This is due to the logic of when the editor refreshes the presets from the editor settings, and cannot be resolved in this plugin.
• Click "Load from Picker" to get the colors currently in the color picker presets into this palette. This overrides the current palette, and cannot currently be undone

godot-color-palette's Issues

Godot 4 support

Love this addon! Any chance of a Godot 4 version of it now that the first beta version was just released?

Does the system accept alpha values?

Hi. It seems that I cannot store colors with alpha values != 255.
I'm using a 3.x win version of Godot.

Importer fails with some .gpl files

Hi,

I was trying to use this add-on with the following palette, generated with GIMP 2.10.18, but some colors were lost, not parsed correctly.

The issue seems to be with the test for lines that start with numbers.
Apparently, valid palette entries can start with whitespace.

See for instance:

GIMP Palette
Name: [famicube]
Columns: 16
#
  0   0   0	Index 0
224  60  40	Index 1
255 255 255	Index 2
215 215 215	Index 3
168 168 168	Index 4
123 123 123	Index 5
 52  52  52	Index 6
 21  21  21	Index 7
 13  32  48	Index 8
 65  93 102	Index 9

Notice also that after the entry there's a name (in this case it seems autogenerated, but perhaps you can manually fill them in?). It comes after a tab \t.

The format seems to be:

[spaces (optional)] R [spaces] G [spaces] B [tab] name

I made a fork of this repo, and created a fix which properly imports the .gpl file I had.

turbohz@15fcf7f

Would you like me to submit a pull request?

Cheers.

Does not work properly

I have got two palettes in a folder. I can visualize them in the "Color Palette" window of the plugin. However when I click on "Load into Picker", nothing happens. The palette I click on does not appears in the color picker. I tried to Reopen the scene but it did not solve the issue.

Lospec palettes fail to import

Steps to reproduce:

• Download this palette as a .gpl file https://lospec.com/palette-list/zughy-32.
• Click the reload palettes button

Observed behaviour: the palette is not imported and the following error appears on the console: res://addons/color-palette/PaletteImporter.gd:37 - Invalid get index '1' (on base: 'PoolStringArray').

Expected behaviour: the palette is correctly imported.