📚 StudyCoins Bot - Complete User Guide

A comprehensive guide for using the StudyCoins economy system, including commands, challenges, transactions, and best practices.

1. Checking Your Balance

Command: !check_balance

✅ Features:

• Shows current StudyCoins balance

• Displays any pending coin requests

• Clean, visual embed format with gold color

Output Format:

💰 StudyCoins Balance
Current Balance: 1,000 StudyCoins
Pending Requests: 2 requests totaling 500 StudyCoins

2. Donating Coins

Command: !donate_coins @user amount message

✅ Correct Usage:

!donate_coins @Alex 100 Thanks for the study help!
!donate_coins @Sarah 50 Group project contribution
!donate_coins @Jamie 200 Math tutoring session

❌ Common Mistakes:

• Using negative amounts

• Trying to donate more than your balance

• Forgetting to mention the recipient

• Not including a message

Important:

• Amount must be positive

• Cannot donate to bots

• Transaction is recorded for both users

• Recipient gets notification

• Message is optional but recommended

3. Requesting Coins

Command: !ask_coins @user amount message

✅ Correct Usage:

!ask_coins @Alex 100 Need help with project expenses
!ask_coins @Sarah 50 Study group snacks

❌ Common Mistakes:

• Requesting negative amounts

• Requesting from bots

• Not explaining reason in message

Features:

• Request appears in recipient's pending requests

• Both users get notification embeds

• Recipient can use !donate_coins to accept

4. Viewing Transactions

Command: !transaction_list [limit]

✅ Correct Usage:

!transaction_list
!transaction_list 10

Output Format:

📜 Recent Transactions
🔻 Sent 100 coins to Alex
Message: Thanks for helping
Time: 2024-01-01 12:00:00

🔺 Received 50 coins from Sarah
Message: Project contribution
Time: 2024-01-01 11:30:00

Features:

• Shows both sent and received transactions

• Challenge rewards included

• Default limit of 5 transactions

• Sorted by most recent first

5. Challenges System

Viewing Challenges

Command: !coins_challenges

Features:

• Shows available challenges

• Displays reward amounts

• Indicates completed challenges

• Resets daily

Challenge Types:

1. Honor Challenges:

   • Daily Study (150 coins)

   • Help Others (200 coins)

2. Quiz Challenge:

   • Educational questions

   • Perfect score required

   • 300 coins reward

   • Various topics covered

Completing Challenges

Command: !complete_challenge challenge_id

✅ Correct Usage:

!complete_challenge daily_study
!complete_challenge help_others
!complete_challenge quiz_challenge

Quiz Challenge Rules:

• 30 seconds per question

• All questions must be correct

• Case-insensitive answers

• Hints available

Best Practices

Earning StudyCoins:

1. Complete daily challenges consistently

2. Help other students to earn rewards

3. Participate in quiz challenges

4. Accept reasonable coin requests

Managing Transactions:

1. Include clear messages with donations

2. Keep track of pending requests

3. Review transaction history regularly

4. Only request coins when necessary

Challenge Tips:

1. Check available challenges daily

2. Prepare for quiz challenges

3. Document completed study hours

4. Help others genuinely, not just for coins

Transaction Color Codes

• 🟢 Green: Positive (receiving coins)

• 🔴 Red: Negative (sending coins)

• 🔵 Blue: Challenge rewards

• 🟡 Gold: Balance display

Quick Reference Table

Error Recovery

If you encounter issues:

1. Check your balance before transactions

2. Verify user mentions are correct

3. Ensure positive amounts

4. Wait for quiz timeouts to expire

5. Check if challenge is already completed today

Getting Help

• Commands work in any channel where bot is present

• Error messages explain what went wrong

• Challenge statuses reset daily at midnight

• Transaction history is permanent

Patreon Subscribers will receive a one-time deposit on their StudyCoins Economy Account!, StudyCoins are available for the enrolled users, ask to participate and we’ll add you!