Browse docs

UI integrations

Choose notification, interaction-prompt and progress providers for Sky Base and the Sky resources that use them.

Choose each interface separately in sky_base/config/config.lua. Notifications and keyboard prompts use the included Sky interface by default. Progress bars require a supported progress resource. These settings are managed in the Base file, not through /jobconfig.

Quick setup

For example, to use Ox for all three interfaces, change these fields inside your existing Config = { ... } table:

sky_base/config/config.lua
notification = "ox_lib",
helpnotify = "ox_lib",
progressbar = "ox",

Start the selected providers before Sky Base, then restart Sky Base and the resources that use it. Configuration values are case-sensitive. The resource name and the selection value can differ, as with ox_lib progress above.

InterfaceSettingShipped valueSelection
NotificationsConfig.notification"default"Built-in Sky notifications, "auto", or a provider from the table.
Keyboard prompts / TextUIConfig.helpnotify"default"Built-in Sky prompts, "auto", or a provider from the table.
Progress barsConfig.progressbar"auto"A supported external provider or an implemented custom integration.

"auto" selects an available provider once at startup; it does not switch providers while playing. If several providers are installed, choose one explicitly to retain the intended appearance. A provider that depends on Sky Base should also be selected explicitly. Notifications and prompts fall back to the included Sky interface when automatic detection finds nothing. Progress has no built-in fallback.

Supported providers

The cells below are the exact values to use for each setting. A dash means that this release does not include that interface for the listed provider. These integrations are included with Sky Base 1.41.0; external resources must be installed separately.

Provider resourcenotificationhelpnotifyprogressbar
17mov_Hud17mov_Hud17mov_Hud17mov_Hud
aty_uiaty_uiaty_ui
aty_uikitv2aty_uikitv2aty_uikitv2
brutal_notifybrutal_notify
brutal_textuibrutal_textui
codem-notificationcodem-notification
codem-supreme-hudcodem-supreme-hudcodem-supreme-hud
codem-supreme-notificationcodem-supreme-notification
codem-textuicodem-textui
core_notifycore_notify
cp_notifycp_notify
cs_hudcs_hud
drugs_creatorjaksam
es_extendedesxesx
esx_notifyesx_notify
esx_progressbaresx
esx_textuiesx_textui
frkn-uikitfrkn-uikitfrkn-uikit
hex_1_hudhex_1_hudhex_1_hud
hex_2_hudhex_2_hudhex_2_hudhex
hex_4_hudhex_4_hudhex_4_hudhex
hex_final_hudhex_final_hudhex_final_hudhex
hex_finalhud_v2hex_finalhud_v2hex_finalhud_v2hex
hex_future_hudhex_future_hudhex_future_hudhex
hex_genesis_hudhex_genesis_hudhex_genesis_hudhex
hex_hud_premhex_hud_premhex_hud_premhex
jg-textuijg-textui
jobs_creatorjaksam
lation_uilation_uilation_ui
msk_coremsk_coremsk_coremsk_core
mythic_notifymythic_notify
mythic_progbarmythic
okokNotifyokokNotify
okokTextUIokokTextUI
ox_libox_libox_libox
prims_hudprims_hudprims_hud
prism_uipackprism_uipackprism_uipack
progressbarqb
qb-coreqbqb
qbx_coreqboxqbox
qs-interfaceqs-interface
qs-textuiqs-textui
risk-notifyrisk-notifyrisk-notifyrisk-notify
robberies_creatorjaksam
rtx_notifyrtx_notify
RxNotifyRxNotify
sky_hudsky_hudsky_hud
sky_notifysky_notify
Venice-NotificationVenice-Notification
vms_notifyv2vms_notifyv2
wasabi_notifywasabi_notify
wasabi_uikitwasabi_uikitwasabi_uikitwasabi
zenit_hudzenit_hudzenit_hud

ESX help uses the framework TextUI hook; the standard ESX setup needs esx_textui. Automatic selection detects esx_textui directly. Qbox help uses ox_lib. The spelling prims_hud is intentional and differs from prism_uipack.

Notification support does not imply TextUI or progress support. For example, CP Notify supplies notifications, while CodeM Supreme HUD supplies prompts and progress; its notifications use the separate CodeM Supreme Notification resource. The table lists normal TextUI prompts, not every provider-specific 3D display feature.

Progress options

The seven newly supported progress choices are codem-supreme-hud, aty_uikitv2, 17mov_Hud, risk-notify, prism_uipack, frkn-uikit and msk_core. Available animations, props, disabled controls and cancellation vary by provider. ATY UI Kit v2 and FRKN do not provide a programmatic cancellation export through these integrations; use a provider with that capability if your workflow needs it.

Custom interfaces and updates

For a custom interface, implement the matching public template before selecting "custom":

  • Notifications: sky_base/config/integration/notification/custom.lua.
  • Interaction prompts: sky_base/config/integration/helpnotify/custom.lua.
  • Progress: sky_base/config/integration/progress/custom.lua.

Existing custom notification and single-action help code from config/functions.lua belongs in the corresponding new adapter. Multi-action help remains in config/functions.lua. Custom templates require implementation and are not automatically selected.

When upgrading, merge your intended provider selections and install the complete matching integration files and manifest. Follow the Base changelog for the release-specific file list and full update instructions.