Installation
This page walks you through installing OLS HUD on a FiveM server. Follow the order below so dependencies load before the HUD.
Before you start
You need:
- A working FXServer
- One framework core running before OLS Base — see OLS Base — Framework (e.g.
es_extended,qb-core, orqbx_core) - ox_lib and oxmysql
- ols_base (OceanLineStudios; loads before HUD — see OLS Base — Installation)
Install steps
Install and start dependencies
Add and ensure these resources before OLS HUD in server.cfg (exact names and order can match your host’s guide):
oxmysqlox_lib- Your framework core (e.g.
es_extended), thenols_base— order matters; see OLS Base
Copy OLS HUD into resources
Place the folder ols_hud inside your server’s resources tree (for example resources/[ols]/ols_hud).
Add ensure to server.cfg
Add a line after your dependencies:
ensure ols_hudRestart or start the resource
Restart the server, or use your panel’s option to start ols_hud after its dependencies are running.
Escrow and editable files
If your copy is escrow-protected, encrypted code stays locked, but the manifest often still ships these paths as editable:
configs/**— main and safezone settingslocales/**— language stringsdata/**— files such as postal data
That lets you tune behavior and text without touching compiled scripts.
Verify it works
- Join the server as a player.
- Confirm the HUD appears after load (status, money display, etc.).
- Try the settings command (default
/settingsunless you changedsettingsCommandin Main config).
If something fails, see Common issues.
Last updated on