# Cosmos - Discord Bot

[![Discord](https://img.shields.io/discord/690878977920729177?label=Discord%20Community&logo=Discord&style=for-the-badge)](https://discord.gg/7CrQEyP) ![GitHub release \(latest by date\)](https://img.shields.io/github/v/release/thec0sm0s/cosmos-discord-bot?color=40e0d0&style=for-the-badge)

> The only discord bot you probably need to power up your community.

Cosmos is a general purpose bot made for [Discord](https://discordapp.com/). It has been developed taking care of everyone's needs and interests. Designed to help server administrators with managing their communities as well as includes plugins and features for all of the casual discord users.  
It is an open source project actively being developed updated frequently with adding new and exciting features along with the important fixes whenever required. Need a feature it doesn't has? We are open to your suggestions and will look forward to implement them.

## Key Features

* **Welcome Banners** to welcome new members using custom static or **GIF** images.
* **Text and voice Levelling** with assignable roles or points as rewards for different levels.
* **Role Shop** to purchase roles using earned points.
* **Welcome Messages** including direct and channel based welcome messages.
* **Moderation** plugin including member and server logs for major events.
* **Auto Moderation** system based on triggers and different actions.
* **Auto Roles** rewards and ranking system with rank cards.
* Discord User, Member custom profiles and much more.

### Not Enough?

We continuously keep working on it to introduce new features and also improve the existing ones. The bot receives updates very frequently, almost every other day.

## Help and Reference
Visit [our website](https://cosmos.thecosmos.space/) for full documentation and getting started guide or just check [quick reference](https://cosmos.thecosmos.space/reference) to all of the available commands and plugins. Feel free to [join our community](https://discord.gg/7CrQEyP) for help with anything or to suggest and features or report bugs.

## Basic Reference

### Plugins

* [AdministratorSettings](settings/administrator-settings.md)
* [AutoModeration](moderation/auto-moderation.md)
* [Economy](profile/economy.md)
* [CosmosPermissions](guild/cosmos-permissions.md)
* [DeadMemes](fun/dead-memes.md)
* [GuildSettings](guild/guild-settings/)
* [HasteBin](tools/haste-bin.md)
* [Imgur](tools/imgur.md)
* [Leaderboards](profile/leaderboards.md)
* [Levels](guild/levels.md)
* [Logger](moderation/logger.md)
* [Marriage](profile/marriage.md)
* [Moderation](moderation/moderation.md)
* [Profile](profile/profile.md)
* [ReactionRoles](guild/reaction-roles.md)
* [Reactor](guild/reactor.md)
* [Reminder](tools/reminder.md)
* [RoleShop](guild/role-shop/)
* [Secret Confessions](guild/secret-confessions.md)
* [Starboard](guild/starboard.md)
* [Tags](tools/tags.md)
* [UserVerification](moderation/user-verification.md)
* [Utilities](tools/utilities.md)
* [Welcome](guild/welcome/)


#### **Primary** Commands

The following table displays entire list of primary commands and their basic syntax to use. Click on the command to know more about it including their **sub-commands**.

**Understanding the syntax**

All of the usages provided for each commands and sub-commands follow a certain syntax, very much similar to the way these commands will be actually used.  
Every command begins with a pre-defined prefix which can be the default prefix, `;` or any of the custom prefixes you have set. Following with the Primary Command, optional sub-command and arguments.

**Syntax:** `<prefix><primary command> [sub-command] [argument1] ...`

* The arguments under `<argument>` are required arguments.
* The arguments under `[argument]` are optional arguments.

**Note:** Do not include `<>` or `[]` while actually using the commands.


| Command | Short Description | Usage |
| :---: | :---: | :---: |
| [ban](https://cosmos.thecosmos.space/moderation/moderation#ban) | Bans specified member from the server. | `;ban <member> [reason]` |
| [banword](https://cosmos.thecosmos.space/moderation/auto-moderation#banword) | Blacklists or bans specified word. | `;banword [word]` |
| [bosons](https://cosmos.thecosmos.space/profile/economy#bosons) | Displays Bosons earned by you or specified member. | `;bosons [user]` |
| [clean](https://cosmos.thecosmos.space/moderation/moderation#clean) | Cleans and deleted last few messages sent by the bot. | `;clean` |
| [confessions](https://cosmos.thecosmos.space/guild/secret-confessions.md#confessions) | Lets you confess anonymously in specified server. | `;confess <server_id> <confession>` |
| [disable](https://cosmos.thecosmos.space/guild/cosmos-permissions.md#disable) | Disables provided function from one or multiple channels which are specified. | `;disable <function> [channels...]` |
| [divorce](https://cosmos.thecosmos.space/profile/marriage#divorce) | Lets you divorce if you're already married to someone. | `;divorce` |
| [embed](https://cosmos.thecosmos.space/tools/utilities.md#embed) | Make bot send a neat embed with all provided attributes. | `;embed [msg]` |
| [enable](https://cosmos.thecosmos.space/guild/cosmos-permissions.md#enable) | Enables provided function in all of the specified channels. | `;enable <function> [channels...]` |
| [fermions](https://cosmos.thecosmos.space/profile/economy#fermions) | Displays number of Fermions you have. | `;fermions` |
| [givepoints](https://cosmos.thecosmos.space/guild/role-shop/settings.md#givepoints) | Generate and give points to specified member. | `;givepoints <points> <member>` |
| [hastebin](https://cosmos.thecosmos.space/tools/haste-bin#hastebin) | Posts the provided content to [https://hastebin.com/](https://hastebin.com/) and displays a shareable link. | `;hastebin <content>` |
| [imgur](https://cosmos.thecosmos.space/tools/imgur#imgur) | Uploads provided URL or attached image to imgur.com and returns the direct URL of the image. | `;imgur [url]` |
| [kick](https://cosmos.thecosmos.space/moderation/moderation#kick) | Kicks specified member from the server. | `;kick <member> [reason]` |
| [leaderboards](https://cosmos.thecosmos.space/profile/leaderboards.md#leaderboards) | Displays top members with maximum chat experience points. | `;leaderboards` |
| [level](https://cosmos.thecosmos.space/levels#level) | Displays current level and experience points. | `;level [member]` |
| [logger](https://cosmos.thecosmos.space/moderation/logger#logger) | Displays list of loggers enabled in different channels. | `;logger` |
| [moderators](https://cosmos.thecosmos.space/settings/administrator-settings#moderators) | Displays list of roles and members who has been assigned as special moderators. | `;moderators` |
| [modlogs](https://cosmos.thecosmos.space/moderation/moderation#modlogs) | Displays all of the moderation logs of specified member. | `;modlogs <member>` |
| [mute](https://cosmos.thecosmos.space/moderation/moderation#mute) | Mutes specified member from voice and also adds the muted role. | `;mute <member> [reason]` |
| [points](https://cosmos.thecosmos.space/role-shop/points#points) | Displays Guild Points earned by you or specified member. | `;points [member]` |
| [prefix](https://cosmos.thecosmos.space/guild-settings/prefix#prefix) | Displays currently set custom prefixes. | `;prefix` |
| [preset](https://cosmos.thecosmos.space/settings/administrator-settings#preset) | Sets preset for commands to display certain preset message. | `;preset <command_name> <image_url> [text]` |
| [profile](https://cosmos.thecosmos.space/profile/profile#profile) | Displays your Cosmos Profile or of specified member. | `;profile [user]` |
| [propose](https://cosmos.thecosmos.space/profile/marriage#propose) | Lets you propose them. | `;propose <user>` |
| [purge](https://cosmos.thecosmos.space/moderation/moderation#purge) | Removes and purges messages which meets specified criteria. | `;purge [search=100]` |
| [rafflepoints](https://cosmos.thecosmos.space/guild/role-shop/settings.md#rafflepoints) | Raffles points among the members who react to the confetti reaction to specified number of winners. | `;rafflepoints <points> [winners=1] [end]` |
| [reaction](https://cosmos.thecosmos.space/reaction-roles#reaction) | It contains multiple reaction based sub-commands. | `;reaction` |
| [reactor](https://cosmos.thecosmos.space/reactor#reactor) | Displays reactor settings of current or specified channel. | `;reactor [channel]` |
| [reminder](https://cosmos.thecosmos.space/tools/reminder#reminder) | Set reminder to get notified at specified time in future in the same channel in which you created the reminder. | `;remind [when]` |
| [reminders](https://cosmos.thecosmos.space/tools/reminder#reminders) | Displays list of reminders which has been created by you. | `;reminders` |
| [rep](https://cosmos.thecosmos.space/profile/profile#rep) | Add a reputation point to specified member. | `;rep [user]` |
| [roleshop](https://cosmos.thecosmos.space/role-shop#roleshop) | Displays all of the roles which can be purchased from role shop. | `;roleshop` |
| [spongebobmock](https://cosmos.thecosmos.space/dead-memes#spongebobmock) | Spongebob mocks provided message or text and sends it back. | `;spongebobmock <message>` |
| [starboard](https://cosmos.thecosmos.space/starboard#starboard) | Configure Starboard in server. | `;starboard <sub-command> ...` |
| [tag](https://cosmos.thecosmos.space/tools/tags#tag) | Retrieves and displays specified tag and all of its contents. | `;tag <name>` |
| [tags](https://cosmos.thecosmos.space/tools/tags#tags) | Displays list of custom tags created and owned by you. | `;tags` |
| [theme](https://cosmos.thecosmos.space/guild-settings/theme#theme) | Configure theme settings. | `;theme <sub-command> ...` |
| [triggers](https://cosmos.thecosmos.space/moderation/auto-moderation#triggers) | Displays all of the active triggers along with their actions. | `;triggers` |
| [unban](https://cosmos.thecosmos.space/moderation/moderation#unban) | Un bans user from their discord ID. | `;unban <user_id> [reason]` |
| [unmute](https://cosmos.thecosmos.space/moderation/moderation#unmute) | Un mutes specified member from voice and removes the muted role. | `;unmute <member>` |
| [verification](https://cosmos.thecosmos.space/moderation/user-verification.md#verification) | Primary command to setup several verification methods. | `;verification` |
| [warn](https://cosmos.thecosmos.space/moderation/moderation#warn) | Issues a warning to specified member. | `;warn <member> <reason>` |
| [welcome](https://cosmos.thecosmos.space/welcome#welcome) | Manage different welcome settings of your server. | `;welcome` |


Cosmos

Welcome Banners [GIF], Role Shop, Text & Voice Levelling, Reaction & Auto Roles, Auto Moderation, Loggers, Profiles and features you need.

Voting for Cosmos

Do you want to support us?