Join our community — get updates, share feedback & connect with other clubsJoin Discord →

ClubsZone Bot · User Guide

Discord Bot Docs

A clean guide for the current bot commands: claiming players and clubs, checking stats, browsing market values, running recruitment, managing tags, and handling tournament or draft workflows.

Start Here

What the Bot Does

ClubsZone Bot connects Discord to the platform data your community already uses on the website. Profiles, club pages, rankings, tournaments, recruitment, and market values all become easy to access from slash commands.

Profiles

Claim EA players and open profile links from Discord.

Club Pages

Show owners, managers, stats, value, and tournaments.

Rankings

Browse linked club rankings with DP movement.

Recruitment

List free agents and paged club recruitment posts.

Tournaments

Post events, browse fixture carousels, and submit results.

Server Setup

Configure auto posts and manage nickname tags.

Command Index

Commands

The bot uses slash commands. Type / inside Discord to search commands and subcommands. Player-specific market lookup is now part of /stats.

Command Group

Profiles & Players

Commands players use to connect their EA pro, check stats, and browse player leaderboards.

Shield
/claim player

Link a Discord user to an EA player

Starts the player claim flow. The bot searches EA clubs, lets the user pick their club, then select their player from the squad.

club-namerequired

Search the EA club that your player currently belongs to.

Creates the player profile used by stats, market value, recruitment, and draft commands.

Refreshes the player nickname through /clubtag when server auto-tagging is enabled.

Prevents duplicate claims so one EA player cannot be linked to multiple Discord accounts.

Example/claim player club-name:E1T1 Gaming
BarChart
/stats

Stats + market value in one player card

Shows the player's EA stats, current club, market value, market rank, and a button linking to their ClubsZone profile.

playeroptional

Discord user to inspect. Defaults to the person running the command.

Replaces the old /market player flow.

Pulls fresh EA stats when possible, while using stored market valuation data for the value section.

Adds a Player Profile button so users can jump straight to the frontend.

Example/stats player:@teammate
Flame
/topscorers

Player leaderboard by category

Ranks the top 10 claimed players and links each player name to their ClubsZone profile.

categoryoptional

Goals, assists, average rating, MOTM, clean sheets, or market value.

No Discord mention dependency, so users who cannot be tagged still show correctly.

Supports scoring, assisting, rating, clean sheet, MOTM, and value leaderboards.

Only claimed players with usable stats are counted.

Example/topscorers category:goals

Command Group

Clubs & Rankings

Commands for registered clubs, club value, ranking visibility, and server nickname structure.

Badge
/claim club

Register an EA club

Registers a club on ClubsZone and seeds its initial ranking row from EA club stats.

club-namerequired

EA club name to search.

short-nameoptional

Optional club tag used in Discord nicknames.

coloroptional

Optional hex color for club embeds.

descriptionoptional

Optional short club description.

Creates the club page data used by /club, /ranking, tournament registration, and recruitment posts.

Stores owner data and initial club stats.

Can apply the owner club tag after registration.

Example/claim club club-name:E1T1 Gaming short-name:E1T1
Club
/club

Complete club profile card

Shows owner, managers, club stats, club value, squad performance, top players, last 5 tournaments, and a Club Page button.

namerequired

Club name, tag, or EA club ID.

Falls back to live EA API stats when cached ranking data is missing.

Avoids showing zero-value club valuation when player data is still being calculated.

Links users to the frontend club page.

Example/club name:E1T1
Trophy
/ranking

Club DP ranking with links

Shows the ClubsZone DP ranking. Club names are clickable links to each frontend club page.

/rankings also remains available as an alias.

Rows show rank, tier marker, DP, and movement since the previous snapshot.

A stale-data warning appears when rankings have not refreshed recently.

Example/ranking
Tag
/clubtag

Nickname tags and value sync

One command for Discord nickname management: self-tagging, clearing, server-wide sync, value refresh, and auto-tag toggles.

statusoptional

Show current club tag settings.

meoptional

Apply your own club tag.

clearoptional

Remove your own club tag.

syncoptional

Bulk sync tags and values for registered members.

autooptional

Turn auto-tagging on or off for claims.

Replaces the old /setup nicknames shortcut.

Owner nicknames keep the owner marker, club tag, display name, and value within Discord's 32-character limit.

Bulk sync requires Manage Nicknames permission.

Example/clubtag sync mode:all

Command Group

Market & Recruitment

Commands for transfer values, free agents, and club recruitment posts.

Coins
/market top

Top 10 market values

Shows the most valuable players, using profile links instead of Discord mentions.

No tier label is printed in the list, keeping the leaderboard clean.

Inactive players can still show with a compact inactive marker.

The player-specific lookup now lives inside /stats.

Example/market top
Report
/market report

Post a market report

Admin-only command that posts the full market report to the configured market channel.

Useful when admins want to force a report outside the scheduled Monday post.

Requires Manage Guild permission.

The weekly scheduled report still runs automatically.

Example/market report
Users
/recruit list

Free agent board

Lists free agents with player profile links, positions, value, games played, and looking message.

Uses profile links instead of tags, so untaggable users still appear cleanly.

Players manage their free-agent status from the frontend profile page.

Designed as the temporary bridge until frontend invite-player UX is added.

Example/recruit list
Clipboard
/recruit posts

Club recruitment posts carousel

Shows active club recruitment posts with linked club names, Discord invites, positions needed, and carousel buttons.

Each club name links to its ClubsZone club page.

Previous and Next buttons page through longer recruitment boards.

Posts are managed from the website and surfaced in Discord.

Example/recruit posts

Command Group

Tournaments & Drafts

Commands for posting competitions, joining, submitting results, fixture browsing, and draft tournament operations.

Calendar
/tournament post

Post a tournament announcement

Posts a tournament card with Join, Withdraw, Fixtures, Refresh, Submit Result, Recap, Team of the Tournament, and website actions.

competitionrequired

Autocomplete tournament picker.

roleoptional

Optional role to give clubs that join.

The Fixtures button opens an ephemeral carousel for league, knockout, and world cup formats.

Join and Withdraw lock automatically when fixtures are generated or the tournament finishes.

Managers can submit results from the post without hunting for the slash command.

Example/tournament post competition:Season 4
Fixtures
/tournament fixtures

Browse fixtures and results

Displays paged fixture embeds for any tournament style, including league matchweeks, knockout rounds, and world cup groups/knockouts.

competitionrequired

Autocomplete tournament picker.

Previous and Next buttons keep large schedules readable.

Played matches show scores; unplayed matches show upcoming pairings.

Works across all supported tournament structures.

Example/tournament fixtures competition:Season 4
Whistle
/tournament submit

Manager result submission

Lets a club manager submit a tournament result for opponent confirmation, with EA match lookup where available.

Finds the manager's active tournaments and fixtures.

Uses EA match data when possible, with manual score fallback.

Sends opponent confirmation or flags disputed reports for staff.

Example/tournament submit
Draft
/draft

Draft tournament toolkit

Supports draft tournament posts, player pool joining, position preferences, role setup, squad image posting, match results, and draft stats.

postoptional

Post the draft announcement with Join / Leave / My Stats.

setupoptional

Bind side roles for drafted players.

assignrolesoptional

Assign drafted players to their side roles.

statsoptional

Show draft-specific player stats.

Players join drafts from Discord buttons and choose preferred positions.

Managers can bind roles and assign them after the draft is generated.

Draft stats are calculated from recorded draft matches.

Example/draft post draft:Friday Draft

Command Group

Server Setup

Commands for server admins to configure channels and automated posts.

Settings
/setup view

View bot configuration

Shows configured free-agent, market-report, rankings channels, and club tag status.

Nickname tools now live under /clubtag.

Useful after inviting the bot or moving channels.

Requires Manage Guild permission through the /setup command.

Example/setup view
Channel
/setup channel

Set auto-post channels

Points the bot's automatic posts at the channels your server wants to use.

typerequired

Free agents, weekly market report, or weekly rankings post.

channelrequired

Discord text channel to post in.

Free-agent alerts can be sent to a recruitment channel.

Market reports and rankings can live in separate announcement channels.

Run /setup view afterward to confirm the configuration.

Example/setup channel type:weekly rankings post channel:#rankings

Scheduled Posts

Auto Posts

Configure these channels with /setup channel. The bot will keep posting updates automatically after setup.

Free Agent AlertsEvery 30 minutes

Posts active free agents to the configured channel so clubs can quickly find available players.

Weekly Market ReportMondays at 9am

Posts the transfer market summary, including top values and market movement.

Weekly Rankings PostSundays at 8pm

Posts the DP club rankings so servers can track club movement week to week.

Common Questions

FAQ