Playernames v2
Configure playernames above peoples heads as well as the range for when it becomes visible. Add or remove displaying their ID & PING. All the way configurable to your liking.
Overview
Section titled “Overview”Discord Playernames is a flexible player identification system that allows you to customize how player names are displayed above players’ heads. With support for Discord names, default names, or custom names, you can create a personalized player identification experience that matches your server’s needs.
Key Features
Section titled “Key Features”- Flexible Name Display - Configure Discord, default, or custom player names
- Configurable Range - Set visibility range for player names
- ID & Ping Display - Add or remove player ID and ping information
- Toggle Functionality - Allow players to toggle name display
- OneSync Compatible - Works with OneSync synchronization
- Language Support - Multi-language compatibility
- Discord API Integration - Requires Discord API (included)
- Escrow Protection - Secure resource protection
- Standalone - No framework dependencies required
Important Pre-Installation Notes
Section titled “Important Pre-Installation Notes”System Requirements & Compatibility
Section titled “System Requirements & Compatibility”Dependencies
Section titled “Dependencies”- Discord API - Required for Discord integration (included)
- OneSync - Compatible with OneSync synchronization
- Universal - Works with any FiveM server setup
Installation Process
Section titled “Installation Process”Step 1: Download the Resource
Section titled “Step 1: Download the Resource”- Access CFX Portal
- Go to CFX Portal Assets
- Find “Discord Playernames” in your granted assets
- Download the ZIP package
Step 2: Extract and Transfer
Section titled “Step 2: Extract and Transfer”-
Extract the ZIP file
- Unpack the downloaded ZIP package to a local folder
- Ensure all files are properly extracted
-
Transfer to Server
- Set your FTP client to binary transfer mode
- Upload the
night_discord_playernamesfolder to your server’sresourcesdirectory - Maintain the original folder structure
Step 3: Server Configuration
Section titled “Step 3: Server Configuration”Add the following line to your server.cfg file:
ensure night_discord_playernamesStep 4: Configuration Setup
Section titled “Step 4: Configuration Setup”-
Navigate to Config File
- Open
night_discord_playernames/config/config.lua - Review all configuration options
- Open
-
Configure Player Names
- Set up name display preferences (Discord, default, or custom)
- Configure visibility range settings
- Adjust ID and ping display options
- Set up toggle functionality
How It Works
Section titled “How It Works”Name Display System
Section titled “Name Display System”- Flexible Name Options: Choose between Discord names, default names, or custom names
- Configurable Range: Set the distance at which player names become visible
- Dynamic Updates: Real-time name display updates as players move
- Customizable Format: Configure how names are displayed above players
Information Display
Section titled “Information Display”- Player ID Display: Show or hide player IDs above heads
- Ping Information: Display player ping values
- Toggle Functionality: Allow players to turn name display on/off
- Configurable Elements: Choose which information to display
Discord Integration
Section titled “Discord Integration”- Discord Name Support: Use Discord usernames for player identification
- Seamless Integration: Automatic Discord name synchronization
- Fallback Options: Use default or custom names when Discord names unavailable
- Consistent Display: Maintain consistent name formatting
Integration & Compatibility
Section titled “Integration & Compatibility”Framework Integration
Section titled “Framework Integration”- Standalone Operation: Works without any framework
- Discord API Integration: Seamless Discord name integration
- OneSync Compatibility: Works with OneSync synchronization
- Universal Compatibility: Works with all FiveM server setups
Server Applications
Section titled “Server Applications”- Roleplay Servers: Clear player identification for roleplay scenarios
- Community Servers: Easy player recognition and interaction
- Gaming Communities: Enhanced player visibility and communication
- Administrative Teams: Better player monitoring and management
Troubleshooting
Section titled “Troubleshooting”Common Issues
Section titled “Common Issues”Names Not Displaying
Section titled “Names Not Displaying”Discord Names Not Working
Section titled “Discord Names Not Working”Range Issues
Section titled “Range Issues”Error Messages
Section titled “Error Messages”| Error | Solution |
|---|---|
| “Resource not found” | Check resource folder name and ensure line |
| “Names not displaying” | Verify name display configuration |
| “Discord API error” | Check Discord API integration settings |
| “Range not working” | Review visibility range configuration |
Best Practices
Section titled “Best Practices”Configuration Best Practices
Section titled “Configuration Best Practices”- Start with default settings and customize to your needs
- Test different name display options to find the best fit
- Configure appropriate visibility ranges for your server size
- Use toggle functionality to give players control
Server Integration
Section titled “Server Integration”- Coordinate with Discord server for consistent naming
- Test name display with different player types
- Monitor performance with large player counts
- Review and optimize settings based on player feedback
Player Experience
Section titled “Player Experience”- Use clear name formats for easy identification
- Provide toggle options for player preference
- Balance information display to avoid clutter
- Test with different server scenarios
Support
Section titled “Support”Getting Help
Section titled “Getting Help”If you’re having trouble with Discord Playernames:
- Review this documentation thoroughly
- Check server console for error messages
- Join our Discord for community support
Community Support
Section titled “Community Support”Join our Discord community for:
- Technical support
- Configuration help
- Best practices sharing
- Community discussions