🎨 Modern & Immersive UI
- **Beautiful React Interface** - Sleek, modern design with smooth animations and transitions
- **Radio Prop Overlay** - Realistic radio device display with transparent screen area
- **Multiple Colour Themes** - Choose from Blue, Green, Red, Purple, and more
- **Customizable Settings** - Adjust brightness, colour palettes, and UI preferences
- **Member Overlay** - Optional floating display showing channel members in-game
https://youtu.be/wR6j7msBVZ4
### 📡 Advanced Channel System
- **Unlimited Channels** - Support for up to 1000 channels (configurable)
- **Job Restrictions** - Restrict channels to specific jobs (perfect for Police, EMS, Mechanic)
- **Password Protection** - Secure private channels with password authentication
- **Favourites & Recents** - Quick access to frequently used channels
- **Channel Management** - Role-based permissions (Owner, Admin, Member)
- **Member Tracking** - Real-time player counts and member lists
🔊 Universal Voice Integration
- **Auto-Detection** - Automatically detects and works with your voice script
- **Multi-Voice Support** - Compatible with pma-voice, SaltyChat, TokoVOIP, and mumble-voip
- **Seamless Integration** - Works perfectly with your existing voice setup
- **Volume Control** - Adjustable radio volume (0-100%) with up/down buttons
🎮 Player Features
- **Custom Radio Nicknames** - Set personal radio handles (1-50 characters)
- **Emergency Alert System** - One-click emergency button with animated map blips
- **Radio Prop Animation** - Animated radio prop when in use (like phone systems)
- **Death Handling** - Automatic disconnection on player death (optional)
- **Settings Persistence** - All preferences saved per player
🔧 Framework & Compatibility
- **Universal Framework Support** - Works with ESX, QBCore, QBox, and more via wss-bridge
- **No Additional Setup** - Compatible with any framework supported by wss-bridge
- **Inventory Integration** - Optional radio item requirement
- **Easy Configuration** - Simple config file with comprehensive options
💾 Database & Persistence
- **Channel Persistence** - Channels saved across server restarts
- **Player Data Storage** - Favorites, settings, and nicknames saved per player
- **Secure Passwords** - Encrypted channel password storage
- **Automatic Cleanup** - Smart cleanup of empty channels and disconnected players
🎯 Advanced Controls
- **Customizable Keybinds** - Configure open radio, toggle, and channel keys
- **Invisible Button Overlays** - Click radio prop image for power, volume, and emergency
- **Button Positioning Tool** - Built-in tool for customizing button positions
- **Movement Restrictions** - Disable movement and combat while using radio (optional)
🔊 Sound System
- **Realistic Sound Effects** - Opening, closing, connecting, and emergency sounds
- **Mic Click Sounds** - Optional mic click sounds for Qbox integration
- **Audio Feedback** - Clear audio cues for all actions
---
🚀 What Makes It Special
**Professional Quality**
Built with modern web technologies (React, Framer Motion) for a polished, smooth experience that feels native to FiveM.
**Highly Customizable**
Every aspect can be configured - from UI colors to channel restrictions, keybinds to battery systems. Make it yours.
**Zero Hassle Setup**
Auto-detects your voice script and framework. Works out of the box with minimal configuration required.
**Feature Complete**
150+ features including emergency alerts, channel passwords, role management, member tracking, and more. Everything you need for professional roleplay.
**Regular Updates**
Continuously maintained and improved with new features and bug fixes based on community feedback.
---
📋 Default Presets Included
- **Channel 1** - Police (restricted to police jobs)
- **Channel 2** - EMS (restricted to ambulance jobs)
- **Channel 3** - Mechanic (restricted to mechanic jobs)
- **Channel 4** - Taxi (restricted to taxi jobs)
- **Channel 100** - Public (open to all)
All channels are fully customizable in the config file.
---
🎁 Additional Features
- **Battery System** (optional) - Realistic battery drain with replaceable batteries
- **Member Kick System** - Owners and admins can manage channel members
- **Role Promotion** - Promote members to admin for channel management
- **Channel Indicators** - Visual icons for restricted and password-protected channels
- **Empty State Messages** - Helpful guidance when channels are empty
- **Debug Mode** - Detailed logging for troubleshooting
---
📦 What's Included
- ✅ Fully functional radio system
- ✅ Modern React UI (pre-built)
- ✅ Comprehensive configuration file
- ✅ Database schema (SQL included)
- ✅ Multi-language support (English, Spanish, French, German)
- ✅ Complete documentation
- ✅ Export system for integration with other scripts
- ✅ Radio prop model and animations
- ✅ Sound effects package
---
⚙️ Requirements
- **wss-bridge** (included/separate) - Framework compatibility layer
- **Voice Script** - pma-voice, SaltyChat, TokoVOIP, or mumble-voip
- **MySQL/OxMySQL** - For data persistence
- **ox_lib** - For UI components (optional, but recommended)
---
🎯 Perfect For
- **Police & Law Enforcement** - Secure channels for operations
- **Emergency Services** - EMS dispatch and coordination
- **Business Roleplay** - Taxi, Mechanic, and business communications
- **Criminal Roleplay** - Private channels for gangs and organizations
- **Civilian Roleplay** - Public channels for general communication
- **Any Server** - Flexible enough for any roleplay scenario
---
## 💡 Technical Highlights
- **Optimized Performance** - Efficient updates and memory management
- **Security First** - Input validation, permission checks, and secure password handling
- **Resource Safe** - Proper cleanup on resource start/stop
- **Cross-Platform** - Works across all FiveM versions
- **Extensible** - Full export system for custom integrations
---
📚 Documentation
Comprehensive documentation included:
- Installation guide
- Configuration guide
- API/Exports reference
- Troubleshooting guide
- Database schema documentation
---
🎓 Support
- Detailed documentation included
- Debug mode for troubleshooting
- Active development and updates
- Community-driven improvements
---
🌟 Why Choose WSS Radio?
**Choose WSS Radio if you want:**
- ✅ A professional, polished radio system
- ✅ Easy setup with auto-detection
- ✅ Extensive customization options
- ✅ Modern, beautiful UI
- ✅ Regular updates and support
- ✅ Feature-rich without being bloated
- ✅ Works with any framework and voice script
**Perfect for server owners who value quality, ease of use, and professional presentation.**
---
*Transform your server's communication with WSS Radio - the radio system your players deserve.*
