ricepunk

Elevate your FiveM server management to the next level with xdiscord, the all-in-one Discord bot designed for unparalleled control and seamless integration.

Whether you're running a massive community or a private server, xdiscord provides the powerful tools you need to manage your server, players, and resources directly from the comfort of your Discord server. Built for performance and compatibility, it offers out-of-the-box support for QBCore and QBX frameworks.

⭐ Key Features

• 👑 Total Server Control: Manage resources, monitor performance, and control the in-game world.
• 👮 Advanced Player Administration: Kick, ban, screenshot, teleport, and manage players with precision.
• 💼 Deep Character & Inventory Insight: View and manage character data (including jobs) and inventories for online and offline players.
• 🚗 Complete Vehicle Management: Spawn, list, and inspect any vehicle on your server in real-time.
• 🔒 Role-Based Permissions: Secure, configurable access control for all commands.
• ✨ Context Menu Integration: Right-click a user to check if they're online in the server.
• ⚡ Smart Autocompletion: Intuitive command suggestions for players, resources, items, and vehicle models.
• 🚀 Latest Discord.js: Built with the most recent version of Discord.js for cutting-edge features and stability.
• 🌐 Framework Ready: Works seamlessly with QBCore and QBX.

🚀 Feature Breakdown

SERVER MANAGEMENT

• Resource Control: Start, stop, restart, and view detailed information for any server resource without touching the panel.
• Server Vitals: Keep an eye on server performance with /server performance, showing CPU, memory, and network stats. Get a quick overview with /server info.
• World Control: Dynamically change the in-game time and weather, freeze time, or trigger a server-wide blackout for events.
• Entity Cleanup: Instantly clear all peds, props, or vehicles (even excluding player-owned ones) to boost server performance.
• Global Announcements: Send announcements from Discord that appear to all players in-game.
• Richest Leaderboard: Show off your server's top earners with the /server richest command.
• txAdmin Integration: Restart your server directly from Discord with /server tx restart.
• Server Connection Info: Display server connection details, with an easy-to-use connect button.

PLAYER & CHARACTER ADMINISTRATION

• Full Player List: View all online players, their server ID, and ping in a clean, paginated list.
• Detailed Player Info: Get a comprehensive profile of any player, including their playtime, ping, and linked Discord account.
• Moderation Suite: Kick, ban, kill, or revive players. Send direct messages to players in-game. All actions are logged for accountability.
• Discreet Screenshot: Capture a player's screen for administrative review with a single command.
• Advanced Teleportation: Teleport any player (or all players) to predefined locations or exact coordinates, with or without their vehicle.
• Quick Online Check: Right-click any Discord user and use the "Online" context menu to instantly see if they are connected to your FiveM server.
• Character & Inventory Management:
  • View detailed character sheets for both online and offline players (money, job, status, etc.).
  • Change a character's name and job directly from Discord.
  • Inspect player inventories (supports ox_inventory and qb-inventory), and give, remove, or clear items.
  • Find which players are carrying a specific item, with filters for minimum amount and total results.

VEHICLE MANAGEMENT

• Spawn Vehicles: Give any vehicle to a player by model name, with an optional custom license plate.
• Detailed Vehicle Info: Look up any vehicle on the server by its entity ID or license plate to see its owner, location, condition, fuel, and more.
• Live Vehicle List: Get a server-wide list of all spawned vehicles, their models, plates, and network owners.

DISCORD UTILITIES

• Role-Based Permissions: Easily configure which Discord roles have access to which commands (e.g., Moderator, Admin, Developer).
• Sticky Messages: Keep important information at the top of your channels with automated sticky messages.
• Intuitive Autocomplete: Commands are easy to use with smart autocomplete for players, resources, items, and vehicle models.
• Help Command: A dynamic help command that shows users only the commands they have permission to use.

⚙️ Technical Details

• Language: Developed with TypeScript for type safety and improved developer experience.
• Full Source Code: You receive the complete, unminified source code, allowing for full transparency and customization.
• Development & Building: Comprehensive documentation is available in docs/development.md detailing how to set up your development environment, modify the source code, and build the resource.
• Frameworks: Natively supports QBCore and QBX. Can be adapted to other frameworks.
• Performance: Optimized for low resource usage.
• Dependencies: Standalone, with clear setup instructions.
• Database: Requires MySQL >= 5.7 or MariaDB >= 10.2.

FiveM Exports (API)

xdiscord exposes a powerful API for other FiveM resources to interact with Discord. The identifier parameter in these functions accepts either a FiveM player source ID or a Discord user ID.

• getDiscordId: Retrieve a player's Discord ID.
• getName: Get a Discord member's display name.
• getRoles: Fetch a Discord member's roles.
• hasRole: Check if a Discord member has specific roles (accepts a single role string or an array of role strings).
• isInGuild: Verify if a Discord member is in the server's Discord guild.
• createLog: Send an embed to a configured webhook.

xdiscord is more than just a bot; it's your server's new command center. Streamline your administrative tasks, empower your staff, and spend more time creating amazing experiences for your players!