The Ultimate Guide to the CFX Finder Discord Bot (Full Features)
This is the core functionality. By entering a Cfx.re join code (e.g., /server-info cfxt.re/join/xxx ), the bot retrieves detailed information, including: Current player count. Maximum player capacity. Server location/hostname. Server version. 2. /status-cfx (General API Status)
The full bot supports interactive buttons under each search result: cfx+finder+discord+bot+full
After weeks of development, I’m excited to release the – a powerful, feature-rich bot that integrates the CFX.re ecosystem with your Discord community.
| Bot Name | Key Features | Monetization Model | Availability | | :--- | :--- | :--- | :--- | | | Full Command Suite: The most complete set of commands, including cinfo , cplayers , cbanners , and more. | Freemium Model: The core functionality is free to use for all users. Some advanced features or perks may be unlocked through optional payments or subscriptions. | Available on Discord Bot List; actively maintained. | | CFX Finder V1 | Core Information: Provides the most essential commands, such as cfind , cip , clogo , and ctags . | Free: This is the original, free-to-use version of the bot. | Available on various Discord bot lists; may not be actively maintained by all hosting parties. | | 5M Finder | Focused & Streamlined: Prioritizes the core commands like cfind , cip , clogo , and ctags . | Free: Promotes a clean, no-cost experience without unnecessary complexity. | Available for public invitation; maintained by its original creator. | | Self-Hosted Version | Full Control & Customization: You have complete control over the bot's source code, allowing you to modify its behavior, add new features, or integrate it with other tools. | Free (requires your own hosting): No charges for the software itself, but you are responsible for the cost of running your own server. | Accessible only to developers who follow the self-hosting instructions provided on GitHub. | The Ultimate Guide to the CFX Finder Discord
Are you hosting on a or using a gaming server provider (like Zap-Hosting)?
import discord from discord.ext import commands import requests import json # Initialize bot with a prefix command structure intents = discord.Intents.default() intents.message_content = True bot = commands.Bot(command_prefix="!", intents=intents) # Cfx.re API base endpoint CFX_API_URL = "https://fivem.net" @bot.event async def on_ready(): print(f"Successfully logged in as bot.user.name") await bot.change_presence(activity=discord.Game(name="!cfx ")) @bot.command(name="cfx") async def find_cfx_server(ctx, join_code: str): """ Looks up a FiveM/Cfx.re server using its 6-character join code. Example: !cfx abcd12 """ # Clean up the join code input join_code = join_code.strip().lower() # Notify user that the bot is searching await ctx.send(f"🔍 Fetching data for Cfx code: `join_code`... Please wait.") headers = "User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36" try: # Request data from the official Cfx.re frontend API response = requests.get(f"CFX_API_URLjoin_code", headers=headers) if response.status_code == 404: await ctx.send("❌ Server not found. Please check your Cfx join code.") return elif response.status_code != 200: await ctx.send(f"⚠️ Error fetching data from Cfx API (Status Code: response.status_code).") return server_data = response.json().get('Data', {}) if not server_data: await ctx.send("❌ Failed to parse server data. The server might be offline.") return # Extracting key data points server_name = server_data.get('hostname', 'Unknown Server') # Clean up color codes often found in FiveM server names for clean_char in ["^0", "^1", "^2", "^3", "^4", "^5", "^6", "^7", "^8", "^9"]: server_name = server_name.replace(clean_char, "") clients = server_data.get('clients', 0) max_clients = server_data.get('sv_maxclients', 0) resources = server_data.get('resources', []) game_type = server_data.get('gametype', 'Not Specified') map_name = server_data.get('mapname', 'Not Specified') artifacts = server_data.get('server', 'Unknown Build') # Building the Discord Embed embed = discord.Embed( title=server_name[:256], color=discord.Color.orange(), description=f"**Direct Connect Link:**\n[Click to Join Server](fivem://connect/cfx.re/join/join_code)" ) embed.add_field(name="Cfx Code", value=f"`join_code.upper()`", inline=True) embed.add_field(name="Players Online", value=f"👥 clients / max_clients", inline=True) embed.add_field(name="Game Type", value=game_type, inline=True) embed.add_field(name="Map", value=map_name, inline=True) embed.add_field(name="Server Build", value=f"`artifacts`", inline=True) embed.add_field(name="Total Scripts/Resources", value=f"📦 len(resources)", inline=True) # Truncate resource list if it's too long for a single field if resources: resource_list = ", ".join(resources) if len(resource_list) > 1024: resource_list = resource_list[:1021] + "..." embed.add_field(name="Active Resources List", value=f"```resource_list```", inline=False) else: embed.add_field(name="Active Resources List", value="No public resources listed.", inline=False) # Set official FiveM logo as thumbnail embed.set_thumbnail(url="https://cfx.re") embed.set_footer(text="Cfx Finder Bot • Powered by Cfx.re API") await ctx.send(embed=embed) except Exception as e: print(f"Error handling command: e") await ctx.send("💥 An internal error occurred while trying to process that request.") # Run the bot bot.run("YOUR_DISCORD_BOT_TOKEN") Use code with caution. Step 4: How to Run and Test the Bot Server location/hostname
To get started with Cfx+Finder, follow these steps:
Most users will simply add a pre-hosted bot. Here’s how:
: Finds the IP and detailed metadata for a specific CFX code.
