NL-Scoreboard

Player Scoreboard - Northline
A modern, Discord-integrated scoreboard for FiveM servers. Displays online players with avatars, names, pings (color-coded), server stats, and more. Clean NUI UI opened via F10.

✨ Features

• Player List: Discord avatar + username, player name, server ID, real-time ping (🟢 ≤70ms, 🟠 70-100ms, 🔴 >100ms).
• Server Stats: Uptime (hh:mm), player count / max, queue size support.
• Discord Integration: Fetches avatars/usernames via Discord bot API.
• Keybind: F10 or /scoreboard command.
• Customizable: Configurable default images, text, Discord link.
• Responsive UI: Hover effects, smooth scrolling, modern design.
• Escrow Compatible: Shared.lua ignored.

Footer: SERVER UPTIME: 02h 15m | PLAYER COUNT: 24/128 | DISCORD.GG/...

📋 Requirements

• FiveM server (Cerulean fx_version, Lua 5.4).
• Discord Application/Bot (for avatar/name fetching).

🛠️ Installation

1. Download: Place the NL-Scoreboard folder in your resources directory.

   resources/
       └── NL-Scoreboard
   

2. Discord Bot Setup (Required for avatars/discord names):

   • Go to Discord Developer Portal.
   • Create a new Application → Bot → Copy Bot Token.
   • Edit server/Functions.lua:

     local FormattedToken = 'Bot YOUR_BOT_TOKEN_HERE'  -- Paste token
     

   • Invite bot to your Discord server with users.read scope (use OAuth2 URL generator).

3. Configuration (Shared.lua):

   Config = {
       Default_Profile = 'https://static.vecteezy.com/system/resources/previews/005/337/799/original/icon-image-not-found-free-vector.jpg',  -- Fallback avatar
       Discord_Not_Found = 'Not Found',  -- Fallback discord text
       Discord_Link = 'https://discord.gg/discordlink'  -- Footer invite link
   }
   

4. Start Resource:

   • Add to server.cfg:

     ensure PerkoScoreboard2
     

   • Restart server or run refresh + start PerkoScoreboard2 in console.

5. Test: Join server, press F10 or /scoreboard. ESC to close.

🎮 Usage

• Open: F10 key or /scoreboard.
• Columns: Discord (avatar/name), Player Name, Server ID, Ping.
• Footer: Server uptime, players/max, Discord link (clickable? via JS).

⚙️ Customization

• UI: Edit html/ files (index.html, app.js, style.css).
• Logic: Client/server Lua files.
• Ping Colors: In html/app.js (adjust thresholds).
• Max Players: Auto from sv_maxclients convar.

🔧 Troubleshooting

• Logs: Check server/client console for Discord API responses.

📞 Support

• Discord - Report issues or get help.
• Author: Northline Solutions.

📜 Changelog

• 1.0.0: Initial release with Discord integration, NUI UI.

Made with ❤️ by Perko