Theming

The Awoken UI is driven by a single accent colour plus a small set of theme presets. Set the accent once and every active element - selected option, buttons, highlights, the save/purchase button - re-themes to match.

Accent colour

The accent is resolved in this order:

The awoken:primaryColor convar, if set.
Otherwise Config.PrimaryColor in shared/theme.lua.

shared/theme.lua

-- Fallback used when the convar is not set
Config.PrimaryColor = "#00E5FF"

Global Awoken accent (cross-resource theming)

If you run multiple Awoken-branded resources (appearance, inventory, recorder, …) and want them all to share one accent, set a single convar in server.cfg:

server.cfg

setr awoken:primaryColor "#00E5FF"

When set, this convar overrides Config.PrimaryColor for every Awoken resource at once - set it once and your appearance menu, inventory and recorder all share the same brand colour. Leave it unset to use each resource’s own value. The value is read when the UI loads.

Theme presets

shared/theme.lua ships three theme presets. currentTheme selects the active one.

shared/theme.lua

Config.Theme = {
    currentTheme = "awoken",  -- "awoken" | "default" | "qb-core"
    themes = { ... }
}

Preset	Look
`awoken` (default)	The modern dark Awoken styling - rounded corners, Inter font, smooth transitions.
`default`	Flatter, squarer styling for a more neutral look.
`qb-core`	A QBCore-flavoured red/dark theme.

The accent colour is injected into whichever preset is active, so switching presets keeps your awoken:primaryColor.

After editing shared/theme.lua, run ensure illenium-appearance and reconnect - the UI reads the theme fresh on load.

Get Started

Awoken Scripts

Accent colour

Global Awoken accent (cross-resource theming)

Theme presets

​Accent colour

​Global Awoken accent (cross-resource theming)

​Theme presets

Accent colour

Global Awoken accent (cross-resource theming)

Theme presets