Weapon Crates
A guide to install Discord Linked Weapon Crates! for FiveM
Overview
Section titled “Overview”Create your weapon crates all over the map. Configure your style and edit it all to your liking! This script provides weapon crates for players to collect weapons from. Everything is built to be easy-to-use for the player. Almost everything is configurable and this script is provided with language support.
Key Features
Section titled “Key Features”- Discord Role Integration - Configurable permissions by Discord roles
- Multiple Framework Support - Standalone/ESX/QBCore compatible
- Configurable Locations - Place weapon crates anywhere on the map
- Configurable Camera View - Customize camera angles and perspectives
- Configurable Blips - Custom map markers for weapon crate locations
- Configurable Markers - Visual indicators for weapon crate areas
- Configurable 3D Text Labels - Custom text displays for weapon crates
- Configurable Sections - Create different sections (Police Officer, Armed Police, Taser Officer, etc.)
- Configurable Weaponry - Different weapons per section (baton, taser, firearms, etc.)
- Configurable Components - Weapon components per section and per weapon
- Configurable Props - Custom weapon crate props and appearances
- Configurable Names - Customize crate names, location names, and section names
- Language Support - Multi-language support for international servers
- Lightweight - Minimal performance impact
- Escrow Protection - Secure resource protection
Installation Process
Section titled “Installation Process”Step 1: Download Resource
Section titled “Step 1: Download Resource”Download this resource via CFX Portal Assets after purchasing. It can take a few minutes for the resource to appear in the CFX Portal after purchase.
Step 2: Install Resource
Section titled “Step 2: Install Resource”- Extract the ZIP package to your local machine
- Transfer files using binary FTP mode to your server’s resources folder
- Ensure the folder is named
night_discord_weaponcrates(do not rename)
Step 3: Server Configuration
Section titled “Step 3: Server Configuration”Add the resource to your server.cfg:
ensure night_discord_weaponcratesStep 4: Configure Settings
Section titled “Step 4: Configure Settings”- Open
/config/config.luain your preferred editor - Configure weapon crate locations and settings
- Test the resource functionality
Important Pre-Installation Notes
Section titled “Important Pre-Installation Notes”System Requirements & Compatibility
Section titled “System Requirements & Compatibility”Framework Compatibility
Section titled “Framework Compatibility”- Standalone: Works independently without any framework
- ESX: Compatible with ESX framework
- QBCore: Compatible with QBCore framework
OneSync Compatibility
Section titled “OneSync Compatibility”- OneSync Legacy: Fully tested and compatible
- OneSync Infinity: Fully tested and compatible
Dependencies
Section titled “Dependencies”- Required: Discord API resource (included in this package)
Configuration Setup
Section titled “Configuration Setup”Required Tools
Section titled “Required Tools”Configuration Files
Section titled “Configuration Files”| File | Purpose |
|---|---|
night_discord_weaponcrates/config/config.lua |
Main configuration and crate settings |
night_discord_weaponcrates/client/c_functions.lua |
Client-side functions |
night_discord_weaponcrates/server/s_functions.lua |
Server-side functions |
Configuration Process
Section titled “Configuration Process”- Open VS Code and navigate to the config files
- Read thoroughly - each line has explanatory comments
- Configure crate locations - add coordinates for weapon crates
- Configure sections - set up different weapon sections
- Test frequently - use F8 console for error checking
How It Works
Section titled “How It Works”Weapon Crate System
Section titled “Weapon Crate System”- Crate Locations - Place weapon crates anywhere on the map
- Section Management - Create different sections for different roles
- Weapon Distribution - Distribute weapons based on role requirements
- Player Interaction - Easy-to-use interface for weapon collection
Configuration Options
Section titled “Configuration Options”- Location Management - Configure weapon crate locations with precise coordinates
- Camera Settings - Customize camera view angles and perspectives
- Blip Configuration - Set up custom map markers for crate locations
- Marker Settings - Configure visual markers for weapon crate areas
- 3D Text Labels - Customize text displays for weapon crates
- Section Setup - Create different sections (Police Officer, Armed Police, Taser Officer, etc.)
- Weapon Assignment - Assign different weapons to each section
- Component Management - Configure weapon components per section and weapon
- Prop Customization - Set custom props for weapon crates
- Naming System - Customize crate names, location names, and section names
Discord Integration
Section titled “Discord Integration”- Role-Based Access - Restrict weapon access by Discord roles
- Permission System - Configure permissions for different Discord roles
- Real-Time Verification - Check Discord roles when accessing crates
- API Integration - Utilize included Discord API for role verification
User Experience
Section titled “User Experience”- Easy-to-Use Interface - Simple and intuitive weapon collection
- Visual Feedback - Clear indicators and markers for crate locations
- Role-Based Access - Access weapons based on Discord role permissions
- Multi-Language Support - International language support
Integration & Compatibility
Section titled “Integration & Compatibility”Framework Support
Section titled “Framework Support”- Standalone - Works independently without framework dependencies
- ESX - Compatible with ESX framework integration
- QBCore - Compatible with QBCore framework integration
Discord Integration
Section titled “Discord Integration”- Role-Based Access - Restrict weapon access by Discord roles
- Real-Time Verification - Check Discord roles when accessing crates
- Permission Management - Configure permissions for different roles
- API Integration - Utilize included Discord API for role verification
Script Integration
Section titled “Script Integration”- Weapon Management - Integrate with existing weapon systems
- Permission Systems - Connect with server permission management
- Access Control - Enhance weapon security and access control
- Custom Scripts - Perfect foundation for building weapon distribution systems
Server Integration
Section titled “Server Integration”- Performance Optimized - Lightweight and efficient operation
- Easy Integration - Simple setup and configuration
Troubleshooting
Section titled “Troubleshooting”Common Issues
Section titled “Common Issues”Debugging Tips
Section titled “Debugging Tips”- Check F8 Console - Look for any error messages
- Test Crate Locations - Verify crate points are accessible
- Verify Resource Loading - Ensure resource starts without errors
- Check File Permissions - Ensure all files are accessible
- Test Role Permissions - Verify Discord role assignments
Best Practices
Section titled “Best Practices”Crate Placement
Section titled “Crate Placement”- Strategic Locations - Place crates in logical and accessible areas
- Role-Based Placement - Position crates based on role requirements
- Visual Indicators - Use clear markers and blips for easy location
- Accessibility - Ensure crates are easily accessible for authorized players
Configuration Tips
Section titled “Configuration Tips”- Section Organization - Create logical sections for different roles
- Weapon Assignment - Assign appropriate weapons to each section
- Role Permissions - Set up clear role-based access control
- Testing - Thoroughly test crate access with different roles
Discord Integration
Section titled “Discord Integration”- Role Structure - Design logical Discord role hierarchy
- Permission Setup - Configure appropriate weapon access for roles
- API Configuration - Properly configure Discord API settings
- Role Verification - Regularly verify Discord role assignments
User Experience
Section titled “User Experience”- Clear Instructions - Provide clear guidance for weapon collection
- Visual Feedback - Use markers and 3D text for clear identification
- Language Support - Utilize multi-language support for international servers
- Performance Optimization - Monitor resource performance and optimization
Support
Section titled “Support”Read through the instructions again if you have not managed to install the resource. Can’t get it to work still? Create a ticket through our dedicated support system in Discord: