An open API service indexing awesome lists of open source software.

https://github.com/nahtanpng/cheapobot


https://github.com/nahtanpng/cheapobot

discord discord-bot discord-py python

Last synced: 3 months ago
JSON representation

Awesome Lists containing this project

README

        

# **Cheapo** πŸ’°
**Your Ultimate Discord Economy Bot!**

Cheapo is a fun and interactive economy bot for Discord servers. Earn coins, climb the leaderboard, and unlock awesome rewards.

---

## **Features** 🎩✨

### πŸ’° **Economy System**
- Earn coins by chatting, working, and claiming daily rewards.
- Send coins to friends and compete to become the richest in the server.

### πŸ›οΈ **Shop** ( In Progress ⚠️)
- Spend your hard-earned coins on roles, custom emojis, and other cool perks.
- Show off your purchases with the `c!inventory` command.

### 🎲 **Gambling Games**
- Try your luck with coin flips, slot machines, and more!
- Win big or lose it allβ€”Lady Luck is always watching.

### πŸ† **Leaderboard** ( In Progress ⚠️)
- Climb the ranks and see who’s the wealthiest in the server.
- Flex your riches and show off your financial prowess!

### 🎯 **Quests** ( In Progress ⚠️)
- Complete daily and weekly challenges to earn bonus rewards.
- Level up and unlock exclusive perks.

---

## **Commands** πŸ› οΈ

### πŸ’° **Economy Commands**
- `c!balance` - Check your coin balance.
- `c!daily` - Claim your daily reward (once per day).
- `c!work` - Work to earn coins.
- `c!pay @user ` - Send coins to another user.

### 🎲 **Gambling Commands**
- `c!flip ` - Gamble coins on a coin flip.

### ❓ **Help Command**
- `c!help` - Display all available commands.

---

## **Setup Instructions** πŸš€

### **1. Invite Cheapo to Your Server**
- Visit the [Discord Developer Portal](https://discord.com/developers/applications) and create a new application.
- Add a bot to your application and copy the bot token.
- Use the OAuth2 URL generator to invite Cheapo to your server with the necessary permissions.

### **2. Install Dependencies**
Make sure you have the following installed:
- Python 3.8 or higher
- `discord.py` library
- `python-dotenv` library
- SQLite (built into Python)

Run the following command to install dependencies:
```bash
pip install discord.py
pip install python-dotenv
```

### **3. Configure the Bot**
- Create a `.env` file in your project directory and add your bot token:
```python
TOKEN = "YOUR_BOT_TOKEN_HERE"
```

### **4. Run the Bot**
- Start the bot by running:
```bash
python main.py
```

---

## **Contributing** 🀝
Cheapo is an open-source project, and contributions are welcome! If you’d like to contribute, please follow these steps:
1. Fork the repository.
2. Create a new branch for your feature or bug fix.
3. Submit a pull request with a detailed description of your changes.

---

## **Support** ❀️
If you encounter any issues or have questions, feel free to open an issue on the GitHub repository or join our [support server](#).

---

## **License** πŸ“œ
Cheapo is licensed under the **MIT License**. See the [LICENSE](LICENSE) file for more details.

---

## **Credits** πŸ™Œ
- Developed with ❀️ by [nahtanPNG](https://github.com/nahtanPNG).

---

**Let’s make your server the most fun and engaging place to be with Cheapo!** πŸŽ‰

---