Skip to main content
One file, config/config.lua. It ships readable, so it is yours to edit. Restart the resource after changing it. Which framework you run is not set here. Awoken Bridge answers that for every Awoken script at once.

General

config/config.lua

How it opens

config/config.lua
  • Item. Using the tablet item is the main way in and is always on.
  • Keybind. Players set their own key under Settings, Key Bindings, FiveM. default ships one for everybody. Empty means nobody has a key until they pick one.
  • Command. /tablet, off by default. Handy for staff and while setting up.
requiresItem = true means the key or command only works while the player is carrying a tablet.

When it cannot be opened

config/config.lua
Checked on every open attempt.

Theme and wallpapers

config/config.lua
primaryColor is the accent inside the tablet: buttons, highlights and the default app tile. You can also override it without editing the file:
server.cfg
With allowPlayerAccent = true each player can pick their own accent in the tablet’s Settings app. Set it to false to lock everyone to your colour. Saved choices stay in the database and come back if you turn it on again.
config/config.lua
The built-in wallpapers are drawn by the tablet itself, so there are no image files to manage. Remove a line to stop offering that wallpaper, or rename one. allowCustomURL lets a player paste a link to their own image.
You cannot add a new built-in wallpaper from the config. The id has to match one the tablet already knows how to draw.

Notifications

config/config.lua
Every notification an app sends is kept in the player’s inbox, up to maxPerPlayer, with the oldest dropped first. position and duration are for the pop-up shown while the tablet is closed.

Groups

config/config.lua
Groups are how players team up for anything an app runs as a crew. They live in memory only:
  • A server restart clears every group.
  • The leader choosing Leave disbands the group.
  • The leader crashing or dropping promotes the longest-standing member instead.
  • The last member leaving disbands it.
maxSize includes the leader. Apps can apply a smaller limit of their own on top.

The HUD

Apps can pin a small card to the side of the screen that stays up while the tablet is closed, for things like a live delivery route.
config/config.lua
toggleKey is the default key that shows or hides it. Players can rebind it in their FiveM key bindings, and choose which side of the screen it sits on in the tablet’s Settings app. Empty means unbound. The HUD uses the player’s own accent colour, so every app’s card matches their tablet.

Scaling

config/config.lua
The tablet scales itself so it feels the same size at any resolution. These are the limits on that. Most servers never need to touch them.

SD cards

Config.SdCards has a page of its own. See SD cards.

Language

Text lives in config/locales/en.lua. To translate, copy it to a new file such as fr.lua, change Locales.en at the top to Locales.fr, translate the values, add the file to shared_scripts in fxmanifest.lua next to en.lua, and set Config.Locale = 'fr'. Apps follow the same locale automatically.