Chest Item System

Syra_Chest is a complete chest and storage system for FiveM, built for servers that need secure, placeable and staff-managed storage points.

Players can use physical chests with PIN protection, while staff can create and manage persistent admin chests directly in game.

The system is made for roleplay environments where storage needs to be controlled, logged and easy to manage without creating every stash manually.

📦 Placeable chests: Allow players to place storage containers in the world.
🔐 PIN-secured storage: Protect chests with a code-based access system.
🛠️ Admin chest creation: Staff can create and manage permanent chests with dedicated commands.
🧰 Inventory-based storage: Chests are connected to inventory stashes for real item persistence.
🗝️ Lockpick support: Optional lockpick access can be enabled for roleplay or illegal gameplay.
📜 Discord logging: Track important chest actions through webhook logs.
⚙️ Configurable permissions: Control staff access through configured principals.
🗃️ Database persistence: Chest data is saved through SQL tables for reliable restarts.

- Framework : ESX, QB, Standalone

- Code is accessible : No (Partially)

- Subscription-based : No

- Lines : 3100

- Requirements : ox_lib, oxmysql, inventory, target optional, lockpick optional

- Support : Yes

- Locales : EN, FR

Installation guide

Download the resource
After purchase, sign in to portal.cfx.re (Granted Assets) with the Cfx account linked to your Tebex order and download Syra_Chest.
Add it to your resources
Extract the archive and place Syra_Chest in your server resources folder.
Import the SQL
Import sql/coffres.sql (player chests) and sql/admin_coffres.sql (admin chests). The server also runs oxmysql migrations for admin chest columns. sql/views.sql only adds optional read views.
Create the chest items
Every key of Config.Chests must exist as an item in your inventory: smallchest, averagechest, bigchest, smallchestsecure, averagechestsecure and bigchestsecure in the shipped config.

Start the selected inventory before Syra_Chest:

ensure oxmysql
ensure ox_lib
ensure ox_inventory # or your inventory
ensure Syra_Notif # optional
ensure Syra_Chest

Admin access
/createbox starts admin chest placement and /managebox opens the management UI. Permission is Config.AdminPrincipal (group.admin by default):
```
add_principal identifier.steam:XXXX group.admin
```
Discord logging
Config.Discord is enabled in the shipped config with placeholder values. Fill in your bot token and the two channel IDs (placement and items), or set enabled = false. The bot needs Send Messages and Embed Links permissions.