Palette Controls

The engine uses a color palette for all rendering. These functions let you temporarily remap palette colors for visual effects.

set_col

set_col(index, replacementIndex)

Temporarily remap one palette color to another.

Parameters:

• index (number) – Palette slot to replace.

• replacementIndex (number) – Palette slot to copy into it.

This changes the active palette used by all subsequent rendering calls. Use it for:

• Damage flashes – swap sprite colors to white or red for a few frames

• Night mode – darken all colors

• Enemy recolors – create enemy variants by swapping specific colors

• Power-up effects – tint the player when powered up

Invalid palette indexes print an error in the output panel.

-- Make color 8 render as color 10
set_col(8, 10)

-- Flash the player white on hit
if player.hit_timer > 0 then
  set_col(8, 7)   -- swap main color to white
  set_col(9, 7)
end

reset_col

reset_col()

Restore the original palette, undoing all set_col changes.

reset_col()

Always call reset_col() after temporary color swaps so that later drawing calls in the same frame use the correct colors.

Typical usage pattern

function _draw()
  clear(0)

  -- Draw enemies with a red tint
  set_col(8, 4)
  for i = 1, #enemies do
    sprite(enemies[i].spr, enemies[i].x, enemies[i].y, 1, 1)
  end
  reset_col()

  -- Draw the player with normal colors
  sprite(player.spr, player.x, player.y, 1, 2)
end