[OS] LEO Armory Script

THIS SCRIPT IS OPEN SOURCE! 🔥

Upgrade your law enforcement roleplay with a clean, modern, and configurable LEO Armory System for FiveM. This resource gives officers an immersive armory interface where they can preview, select, and spawn department loadouts directly from station armory points.

Built with a stylish NUI menu, Discord role restrictions, custom saved loadouts, guard peds, weapon previews, and easy configuration, this armory is perfect for police, sheriff, SWAT, state patrol, and other emergency service departments.

Features

Modern Armory UI
A sleek NUI interface with weapon previews, loadout categories, search/filter support, custom branding, configurable colors, and clean animations.

Preset Department Loadouts
Includes configurable default LEO loadouts such as:

• Police

• PubCop

• Supervisor - Restricted

• SWAT - Restricted

Each preset can include weapons, attachments, tools, less-lethal equipment, and utility items.

Discord Role-Based Access
Restrict specific loadouts by Discord role ID. Perfect for locking SWAT, Supervisor, or department-specific gear behind proper permissions.

Custom Player Loadouts
Players can build and save their own personal loadouts from an admin-configured weapon allowlist. Saved loadouts are stored server-side by Discord ID.

Weapon Preview System
The UI displays weapon names, attachments, item counts, and matching weapon images for a more polished armory experience.

Configurable Armory Locations
Add armory interaction points anywhere on the map. Default locations are already included for multiple police and station-style areas.

Guard Ped Support
Optional configurable guard peds can spawn at armory locations for added immersion. Guards are frozen, invincible, and automatically cleaned up when the resource stops.

ox_lib Integration
Supports ox_lib notifications and point-based proximity detection, with a fallback proximity loop if needed.

Export Included
Includes an openArmoryNui export so other resources can open the armory menu.

Configuration Options

Easily configure:

• Armory station coordinates

• Prompt distance and interaction radius

• Guard ped model and spawn points

• Preset LEO loadouts

• Weapon display names

• Allowed custom-loadout weapons

• Max custom weapons per loadout

• Max saved loadouts per player

• Discord role permissions

• UI title, logo, colors, text, and button labels

Dependencies

• FiveM server running Cerulean

• ox_lib

Ideal For

• Police RP servers

• Sheriff departments

• State patrol departments

• SWAT teams

• Public safety roleplay communities

• Servers needing Discord-ranked equipment access

Important Setup Note

Before selling or releasing this resource, remove or rotate the Discord bot token currently hardcoded in server.lua. For a production release, it should be replaced with a placeholder and documented setup instructions.

Example Short Marketplace Description

A modern FiveM LEO armory system with Discord role-restricted loadouts, custom player-saved loadouts, weapon previews, guard peds, ox_lib interaction support, configurable stations, and a clean NUI interface. Perfect for police, sheriff, SWAT, and emergency roleplay servers.