Download Script
To download the assets needed for this script, you must access the official Cfx.re portal, where all assets purchased through Tebex are managed.
Access the Granted Assets Page
Open the Cfx.re granted assets page: https://portal.cfx.re/assets/granted-assets.
This page contains all assets linked to your Cfx.re purchases.
Log In with Your Cfx.re Account
Sign in using the same Cfx.re account you used when purchasing the asset.
If you use a different account, the assets will not appear.
Download the Housing Assets
In the granted assets list, locate and download:
CrosshairThese two packages are required to install the full housing system.
These files include the models, materials, and visual resources required for the proper operation of the housing system.
Download Dependencies
This script requires some mandatory dependencies to function correctly. Make sure to download and extract them inside your server’s main directory, keeping their original folder structure intact.
Server.cfg Placement
Get up and running in just a few minutes. Follow the steps below to install the resource, configure the required dependencies, and verify that everything is working correctly on your server. Once completed, all features will be available in-game and ready to use.
Upload The Resource
Place qs-crosshair/ inside your server's resources/ directory.
Configure server.cfg
Add the following lines to your server.cfg in this exact order:
Restart The Server
Restart your server to load the resource.
Verify Installation
Check the server console and confirm that the qs-crosshair startup banner appears successfully, showing the resource version and status.
Database Setup
This script includes an essential database required for its operation.You must import it before starting your server, preferably using HeidiSQL or any other manager compatible with MariaDB/MySQL.
Configure The Script
All settings are in qs-crosshair/config/main.lua. The file uses semantic markers so you know what is safe to change:
| Marker | Description |
|---|---|
[EDIT] | Safe to modify. Intended for server owners and administrators. |
[INFO] | Informational content. No action required. |
[ADV] | Advanced configuration. Modify only if you understand the impact. |
[CORE] | Core functionality. Editing is not recommended. |
[AUTO] | Automatically managed by the system. Do not modify. |
Common Settings
These are the most frequently customized options:
| Setting | Description |
|---|---|
Config.Command | Changes the command used to open the interface. Default: crosshair |
Config.Keybind | Changes the default key binding. Default: F4 |
Config.Share.RadiusM | Maximum distance for the Share Nearby feature. Default: 30m (Maximum: 100m) |
Config.NotificationType | Notification system to use. Supported values: ox_lib, qs, esx, custom, builtin |
Config.Admin.AceGroup | ACE permission required to access the admin panel. Default: group.admin |
Admin Permissions
The Admin tab is visible only to players whose FiveM ace includes Config.Admin.AceGroup (default group.admin).
Grant from the server console or txAdmin:
Replace XXXXXXXXXXXXXXXXXX with the player's FiveM license identifier. You can find it via F8 while connected, or from the txAdmin player list.
To use a different ace group (for example a custom crosshair.admin), edit Config.Admin.AceGroup in config/main.lua and grant that ace to your admin players.
Custom Hooks (Optional)
If you need to gate access, fire side-effects, or integrate with another script, use the hook files — they are not encrypted.
Location client/custom/main.lua.
Location server/custom/main.lua.