A role and channels per clan
Each clan gets its own Discord role with the clan color and no permissions, plus optional private text and voice channels only its members and your staff can see.
Discord clan bot: member-run clans with a weekly territory war
Clans let your members build their own teams inside your server. Anyone you allow founds a clan with a name, tag, color and emoji; BotGG gives it a role and optional private channels, a shared clan bank and points on a weekly leaderboard. Switch on the war map and clans fight every week over territories on a hex or square map, and the strongest clan takes each contested tile.
clan-warsDiscord preview
What you get
Leader, officers, members
Leaders edit and transfer the clan, officers invite, approve requests and remove members. Clans can be open, request-only, invite-only or closed.
A shared clan bank
Members deposit Bank coins into the clan’s pot, and you choose who may deposit and withdraw. Deposits can also earn clan points. Guild Bank adds daily limits and an item vault.
Weekly and all-time leaderboard
Clan score = points from staff, deposits and other features + the Levels XP its members earn. /clan top ranks clans this week or all time.
A war map of territories
Draw a hex or square map in the console, name the territories (or use the fantasy names pack) and seed owners. The bot draws it as an image with each clan’s color.
A weekly war, resolved fairly
Clans earn war points from member activity, leaders declare attacks, and on war day each contested territory goes to the strongest clan; defenders get a bonus.
How it works
Turn on Clans
Open https://console.botgg.app, choose your server and turn on Clans in the Community section. Decide who may found a clan, the member cap, roles and private channels.
Members found and join clans
With
/clan createa member founds a clan and becomes its leader. Others join with/clan join, accept an invite or send a request that officers approve.Draw the war map
In the War map tab pick hex or square cells, the grid size and territory names, then set the war day and hour, attacks per war and rewards per territory.
Fight for territory every week
Leaders declare attacks with
/clan war attack, members chat to earn war points, and when the war ends the results post with the new map is shared and the next war begins.
Clan Wars: a map your clans fight over every week
Turn on wars and a war starts as soon as a map exists. It runs until the day and hour you choose (in UTC), at least 24 hours. War points come from members’ messages (with a per-member cooldown, never reading their content), from clan points earned during the war and from Flows. With adjacency on, a clan that holds land may only attack territories bordering it.
When the war ends, attackers below the minimum points drop out, the owner defends with a bonus, and the strongest clan takes each territory (the owner keeps ties). Every territory held pays clan points and, if you want, clan bank coins. Free servers can draw up to 24 territories per map and Pro servers 120.
/clan war map: the map, live standings and your clan’s attacks/clan war attackand/clan war retreat: declare or call off an attack/clan war history: the last wars, winners and captures
Clans that run themselves, with staff in control
Names and tags are checked against your blocked words and the Moderation word list, roles are created without permissions, and if BotGG lacks a permission it tells you instead of failing silently. In the console staff can edit any clan, award or remove points, change the leader, remove members, override territory owners and disband a clan.
/clan create,/clan info,/clan join,/clan leave: found, inspect, join and leave/clan invite,/clan requests,/clan kick,/clan promote,/clan demote,/clan transfer: manage members/clan bank balance,/clan bank deposit,/clan bank withdraw,/clan bank vault,/clan top: the clan bank, its vault and the leaderboard
Clan projects: shared goals with a deadline
Staff build a catalog of clan projects in the console: what it needs (Shop items and / or clan coins), an optional minimum clan size or points, a deadline in days, an optional cooldown, and the rewards on completion: coins and a Shop item for every member, clan points and a Discord role for a set number of days. A clan leader (or officers, if you allow it) starts one project at a time, and members deliver items from their inventory or from the clan vault and coins from the clan bank, within their rank’s rights and daily limits. Coins come only from the clan bank, never from a member’s own wallet.
Everything given is used up by the project and shown as progress bars, with top contributors named at the end. If the deadline passes, the project fails and nothing is returned, unless staff turn on refunds on failure, and the confirmation card says which rule applies before anything moves. While a server sells coins for real money, crates can’t be given. Projects are off by default. Usable catalog entries: 3 on Free, 25 on Pro. Projects work in Flows with triggers for started, completed and failed.
/clan project list: what your clan can start/clan project start: start a project (leader or officers)/clan project status: progress, deadline and top contributors/clan project give: give items or clan coins
Slash commands
Generated from the bot’s real command definitions. Full list on the commands page.
/clanClans: create, join and manage clans28 subcommands
/clan createnametagcolor?emoji?description?Found a new clan (you become its leader)/clan infoclan?member?Show a clan’s card/clan joinclanJoin a clan (or ask to join)/clan leaveLeave your clan/clan invitememberInvite a member to your clan/clan kickmemberRemove a member from your clan/clan promotememberPromote a member to officer/clan demotememberDemote an officer to member/clan transfermemberHand the leadership to another member/clan editname?tag?color?emoji?description?mode?Leader: change the clan’s name, tag, color, emoji, description or join mode/clan requestsSee and answer join requests/clan disbandLeader: disband the clan/clan topperiod?Clan leaderboard/clan bank balanceClan bank balance and recent activity/clan bank depositamountPut coins into the clan bank/clan bank withdrawamountTake coins out of the clan bank/clan bank vaultWhat the clan keeps in its item vault/clan bank storeitemquantity?Put Shop items into the clan vault/clan bank takeitemquantity?Take Shop items out of the clan vault/clan bank logEvery coin and item movement of the clan bank/clan war mapSee the war map, the standings and your clan's attacks/clan war attackterritoryDeclare an attack on a territory (leader / officers)/clan war retreatterritoryCall off an attack your clan declared/clan war historyResults of the last clan wars/clan project listProjects your clan can start/clan project startprojectStart a project for your clan (leader / officers)/clan project statusProgress of your clan’s project/clan project giveitemquantityfrom?Give items or clan coins to your clan’s project
Free vs Pro
Every feature works on the Free plan. Pro raises the limits and unlocks extras.
| Limit | Free | Pro |
|---|---|---|
| Territories per war map | 24 | 120 |
| Items per clan vault | 50 | 1,000 |
| Clan projects in the catalog | 3 | 25 |
Frequently asked questions
How do I make clans on my Discord server?
Turn on Clans in the BotGG console and choose who may found one. Members then use /clan create with a name and tag; BotGG creates the clan role (and channels, if enabled) right away.
How does the Clan Wars map work?
Staff draw a map of territories in the console. Each week clans earn war points from member activity, leaders declare attacks, and when the war ends every contested territory goes to the strongest clan.
Can a member be in more than one clan?
No. A member belongs to at most one clan per server, and after leaving or being removed there is a join cooldown you can set.
What happens when a clan leader leaves the server?
The longest-serving officer becomes leader, or else the longest-serving member. When the last member leaves, the clan is disbanded if you chose that option.
Does the clan bank use real money?
No. The clan bank holds the server’s virtual Bank coins, which have no real-world value. It works only while the Bank is on.
Ready to level up your server?
Add BotGG for free, then switch features on in the web console.