Dice Game Bot 🎲

A versatile and customizable Dice Game Bot for Telegram that integrates advanced features, seamless user interaction, and robust functionality for managing games. This bot is designed for users looking for an interactive gaming experience, developers seeking to enhance or repurpose it, and businesses exploring innovative engagement strategies.

⚠️ Disclaimer:
This project is provided as-is for educational and experimental purposes. The original author is not liable for any unlawful use, such as scam-related activities or fraudulent purposes, if the code is modified or deployed improperly.

---

📋 Table of Contents

• ✨ Features
• 🛠️ Technologies Used
• 📦 Setup and Installation
• 🚀 How It Works
• 💡 Usage
• ☣️ Disclaimer
• 🤝 Contributing
• 📝 License
• 📌 Attribution

---

✨ Features

• 🎲 Interactive Dice Game: Players can roll dice with realistic probabilities and compete.
• 🏦 Withdrawal Management: Users can request withdrawals with bank account validation.
• 📈 Dynamic Responses: Immediate feedback for successful or failed transactions.
• 🔒 Security: API keys are securely integrated for robust account validation.
• 🔄 Customizable: Modify default withdrawal amounts, fees, and gameplay rules.
• 📊 User-Friendly UI: Clear prompts and confirmation dialogues for a seamless experience.

---

🛠️ Technologies Used

• Node.js: Backend framework.
• Express.js: Web framework for API routes.
• Axios: Simplifies API requests to third-party services (e.g., Flutterwave).
• Flutterwave API: Secure banking integration.

---

📦 Setup and Installation

Prerequisites:

1. Node.js (v16 or above)
2. A valid Flutterwave API key.

Installation:

1. Clone the repository:

   git clone https://github.com/tamecalm/dice-game-bot.git
   cd dice-game-bot

2. Install Dependencies

   npm install

3. Create an .env file for secure configuration:

   touch .env

4. Populate .env with your Flutterwave keys:

   check the config settings for 
   what to populate

5. Start the server.

   node src/config/app.js
   

---

🚀 How It Works

Game Logic:

1. Players initiate the bot by rolling a dice.
2. The bot calculates outcomes dynamically based on probabilities.

Withdrawal Process:

1. Default withdrawal amount: ₦100 (deducts VAT at 7.5%).
2. The bot validates the bank account and retrieves the account name using Flutterwave.
3. Players confirm or cancel the transaction.

---

💡 Usage

1. Initiate the Game:

Follow bot prompts to start rolling dice.

2. Request a Withdrawal:

• The bot will ask for your bank account details.
• It retrieves your account name automatically.
• Confirm the withdrawal for processing.

Example Bot Flow:

1. Player: "Roll the dice!"
   Bot: 🎲 "You rolled a 6! Congratulations!"

2. Player: "Request withdrawal."
   Bot: "Provide your account details."
   (Displays account name and default withdrawal amount.)

3. Player: "Confirm withdrawal."
   Bot: "Withdrawal successful!"

---

☣️ Disclaimer

The bot's code is open-source and provided for educational purposes only. By using or modifying this code, you agree:

• The author is not responsible for any unlawful use of the bot.
• You will not deploy the bot for fraudulent, scam-related, or illegal activities.

---

🤝 Contributing

Contributions are welcome! To contribute:

1. Fork the repository.
2. Create a feature branch:

   git checkout -b feature-name

3. Commit your changes:

   git commit -m "Add new feature"

4. Push the branch:

   git push origin feature-name

5. Submit a pull request.

---

📝 License

This project is licensed under the General Public License v3.0

GPL-3.0 License Summary:

• Permission: You are free to use, modify, and distribute this project.
• Condition: Include the original license and attribution in any distribution.
• Limitation: No warranty or liability is provided.

For full terms, see the LICENSE file.

---

📌 Attribution

Authored by John.

Support & Updates ❤️❤️