Clan System | Discord Bot 1.0.0

Clan Module

The Clan Module adds a full clan management system to your 

This module is designed to fit seamlessly into the template’s modular structure — just drop it into the `modules` folder and it’ll register automatically.

---

Features
- Create and manage clans with unique names and colors  
- Invite users with accept/decline buttons  
- Promote, demote, transfer ownership, and manage roles  
- Built-in help command with usage info  

---

Commands

/clan create <name>
Creates a new clan. The name must be unique and follow the configured length limits.

/clan info <name>
Displays detailed information about a clan — including its name, leader, members, role color, and member count.

/clan invite <user>
Sends an invite message to the selected user with **Accept** and **Decline** buttons.  
Invites expire automatically after a set time.

/clan accept (button)
Accepts a pending clan invite. The user is added to the clan and their role is updated automatically.

/clan decline (button)
Declines a pending invite and removes the invite entry.

/clan promote <user>
Promotes a clan member (member → co-leader → leader).  
Promotion permissions depend on role hierarchy.

/clan demote <user>
Demotes a clan member one step down in the hierarchy.

/clan transfer <user>
Transfers clan ownership to another member.  
*Leader-only command.*

/clan kick <user>
Removes a member from the clan.  
*Leader and co-leader permissions required.*

/clan leave
Leaves the current clan.  
Leaders must transfer ownership or disband the clan before leaving.

/clan setcolor <hex>
Changes the clan’s role color.  
*Leader-only command.*

/clan rename <new_name>
Renames the clan.  
*Leader-only; name must be unique.*

/clan help
Displays an embedded help menu with command descriptions and usage examples.

---

Installation

1. Download or clone the

---

Notes
- Make sure your bot has the **Manage Roles** permission for color and role updates.  
- Customize settings (like name length or invite expiry) in the module’s config file.  
- You can easily modify this module to fit other systems, such as guilds, factions, or teams.

---

*Made for the TypeScript Discord Bot Template — modular, simple, and extendable.*