# SC-Chatbox – Revolutionary Staff Communication Platform
The world’s first advanced group communication system for FiveM servers featuring one-click chat initiation, dynamic conference calls, persistent message history, and professional-grade coordination tools.
## **🚀 Revolutionary Features**
**This isn’t just another chat system – it’s a complete communication revolution for FiveM servers.**
### **One-Click Communication**
– **Click any player name** → Instantly start chat (no buttons needed)
– **Click to join** → Accept requests with a single click
– **Click to leave** → Click your own name to exit without ending chat for others
– **Intuitive flow** → Works exactly like modern messaging apps
### **Dynamic Conference Calls**
– **Organic group building** → Click additional players to add them to existing chats
– **Unlimited participants** → Build groups of any size dynamically
– **Individual leave/join** → Members can drop in/out without disrupting others
– **Smart channel management** → Automatic creation and cleanup of voice channels
### **Persistent Message History**
– **Background message capture** → All messages stored even when menu is closed
– **Complete conversation history** → Never lose context when reopening menu
– **Memory-based system** → Reliable JSON storage that survives UI state changes
– **Clean session management** → History cleared only when chat truly ends
### **Professional Dual-Notification System**
– **Real-time floating alerts** → Critical messages appear as notifications during gameplay
– **Complete history preservation** → Full conversation thread available when you have time
– **Never miss anything** → Perfect for staff coordination during events/emergencies
### **Advanced Voice Integration**
– **Seamless pma-voice integration** → Group voice channels for all chat members
– **Conference voice support** → All participants join the same voice channel
– **Professional PTT system** → Clear visual feedback for mic status
– **Auto-channel management** → Dynamic voice channel creation and cleanup
—
## **🎯 Perfect For**
### **Staff Teams & Administration**
– **Event coordination** → Real-time communication during server events
– **Emergency response** → Instant group coordination for rule violations
– **Administrative oversight** → Persistent communication channels for ongoing situations
– **Training & mentoring** → Group discussions with new staff members
### **Roleplay Communities**
– **Gang/organization coordination** → Private group planning and communication
– **Business operations** → Team coordination for complex RP scenarios
– **Law enforcement** → Multi-unit coordination and backup requests
– **Medical teams** → Hospital staff coordination and emergency response
### **Server Networks**
– **Cross-server staff communication** → Unified communication across multiple servers
– **Management coordination** → High-level administrative discussions
– **Community building** → Enhanced player interaction and engagement
—
## **💡 Revolutionary Use Cases**
### **Scenario: Bank Robbery Response**
1. **Officer 1** clicks Officer 2’s name → Instant chat connection
2. **Officer 1**: “Bank robbery in progress, need backup”
3. **Officer 1** clicks Officer 3’s name → Adds to group chat (conference call)
4. **All officers** coordinate response while driving to scene
5. **Officer 2** closes menu to focus on driving → Still receives updates as notifications
6. **Officer 2** reopens menu later → Full conversation history preserved
7. **Individual officers** click their own names to leave when situation resolved
### **Scenario: Event Management**
1. **Event coordinator** starts group chat with all staff
2. **Staff members** join throughout the event as needed
3. **Coordinators** manage multiple ongoing situations simultaneously
4. **Background notifications** keep everyone informed during active RP
5. **Complete message history** ensures no critical information is lost
6. **Voice integration** allows instant verbal coordination when needed
## **🎮 How to Use**
### **Getting Started**
– **Open Menu**: Press `F10` or type `/pm`
– **Start Chat**: Click any player’s name to send request
– **Join Chat**: Click requester’s name to accept and connect
– **Send Messages**: Type and press Enter (works like any modern chat app)
### **Advanced Features**
– **Create Group Chat**: While in a chat, click another player’s name to invite them
– **Leave Chat**: Click your own name (appears red) to disconnect yourself only
– **Background Mode**: Click Close to hide menu while keeping chats active
– **Voice Chat**: Click 🎤 button, then hold PTT key to speak to entire group
– **Message History**: Close and reopen menu – full conversation history preserved
### **Professional Workflow**
1. **Start your shift** → Open menu, see who’s online
2. **Begin coordination** → Click names to start group chats as needed
3. **Stay connected** → Close menu during active duties, receive notifications
4. **Maintain context** → Reopen menu anytime to see full conversation history
5. **Clean transitions** → Leave individual chats without disrupting team coordination
## **⚡ Technical Excellence**
### **Performance Optimized**
– **Lightweight memory system** → Efficient JSON-based message storage
– **Smart UI rendering** → Only processes visible elements
– **Automatic cleanup** → Memory cleared when chats end
– **Minimal network traffic** → Optimized event handling
### **Reliability Features**
– **Persistent state management** → Survives UI hide/show cycles
– **Error-resistant design** → Graceful handling of disconnections
– **Cross-browser compatibility** → Works in all FiveM-supported browsers
– **Memory leak prevention** → Automatic cleanup of chat sessions
### **Professional UI/UX**
– **Modern cyberpunk design** → Gradient themes with glowing effects
– **Intuitive interactions** → Click-to-chat eliminates button confusion
– **Visual feedback** → Clear indicators for all states and actions
– **Custom scrollbars** → Sleek golden scrollbars match the theme
– **Responsive layout** → Optimized for various screen sizes
## **Technical Details**
### **Dependencies**
– **QBCore Framework**
– **pma-voice** (for voice chat functionality)