Skip to main content
Awoken Minigames separates its colours into two layers:
The accent wins over the theme’s own accent by design, so all your Awoken resources stay in unison. Set awoken:primaryColor once in server.cfg and Minigames, Chat, UI and the rest all match.
server.cfg

​
Pick a theme

Set it once for every game in config.lua:
config.lua
Or per call, which overrides the global for that one game:

​
Built-in themes

​
Make your own

A theme is just a table of colours. There’s no build step - edit, save, restart.
1

Copy a built-in

Duplicate web/themes/dark.lua and rename it, e.g. web/themes/casino.lua.
2

Change the id to match the filename

The key in the table is the id you’ll use in config.lua:
web/themes/casino.lua
3

Tweak the colours

Keep all the keys - the UI expects every one of them. Values are hex:
  • 6-digit for solid: #101418
  • 8-digit to add transparency: #RRGGBBAA - the last pair is opacity (00 = clear, FF = solid)
  • rgb() / rgba() work too if you prefer
4

Use it

config.lua
5

Restart

restart awoken_minigames. That’s it - the theme is read at runtime and handed to the UI. It shows up automatically in-game and in the dev menu.
Themes live in web/themes/*.lua, which asset escrow leaves open - they’re yours to edit. You never need Node, npm, or a build to recolour anything.

​
The live theme editor

Rather than editing hex by hand, the dev menu has a Theme button that opens a live editor: recolour every token and watch the panel change as you type. It edits the real CSS variables, so what you see is exactly what a game gets.
1

Open it

With enableDevMenu = true, run /awoken_minigames and click Theme. (It’s also in the browser dev panel - cd web && npm run dev.)
2

Start from an existing theme (optional)

Load one of your web/themes/*.lua files to tweak from, rather than starting blank.
3

Recolour

Adjust any token; the panel behind the editor updates instantly.
4

Save it

Give it an id and hit Save. In-game, that writes web/themes/<id>.lua straight into the resource for you. In the browser it downloads the .lua instead (CEF has no download manager), which you then drop into web/themes/.
5

Use it

Set theme = '<id>' in config.lua and restart awoken_minigames.
The editor’s Save writes a file into the resource, so it’s gated behind enableDevMenu. That’s another reason to keep the dev menu off on a live server.

​
The keys

Each theme file documents every key inline. The main groups:
Don’t delete keys you’re not using - the UI reads every one. To make something invisible, set it fully transparent (#00000000) rather than removing the line.

​
Per-call theming

Because theme is a shared option, you can theme a single job differently without touching the global: