🤖 NexBot — Full-Featured Discord Bot

A feature-rich Discord bot inspired by OwO Bot, with economy, hunting, gambling, leveling, moderation, social interactions, and more.

---

⚡ Quick Start

1. Install Python 3.11+

Download from python.org if not already installed.

2. Install dependencies

pip install -r requirements.txt

3. Set your bot token

Copy .env.example to .env and paste your token:

DISCORD_TOKEN=your_bot_token_here

Or open config.py and paste your token directly into the TOKEN field.

4. Run the bot

python main.py

---

🔑 Getting a Bot Token

1. Go to discord.com/developers/applications
2. Click New Application → give it a name
3. Go to Bot tab → click Add Bot
4. Under Privileged Gateway Intents, enable:
   • ✅ Presence Intent
   • ✅ Server Members Intent
   • ✅ Message Content Intent
5. Click Reset Token → copy the token
6. Go to OAuth2 → URL Generator:
   • Scopes: bot, applications.commands
   • Bot Permissions: Administrator (or select individually)
7. Open the generated URL to invite the bot to your server

---

📁 File Structure

discord_bot/
├── main.py           — Bot entry point, loads all cogs
├── config.py         — Configuration (token, cooldowns, constants)
├── database.py       — SQLite database manager (nexbot.db auto-created)
├── requirements.txt  — Python dependencies
├── .env.example      — Token template
└── cogs/
    ├── economy.py    — Coins, daily, work, rob, shop, marry
    ├── hunting.py    — OwO-style animal hunting & zoo
    ├── gambling.py   — Slots, Blackjack, Roulette, Dice, Crash, High/Low
    ├── leveling.py   — XP system, rank card, leaderboard
    ├── moderation.py — Kick, ban, mute, warn, purge, lock, etc.
    ├── fun.py        — 8ball, trivia, hangman, riddles, polls, etc.
    ├── utility.py    — Ping, help, serverinfo, userinfo, avatar, etc.
    └── social.py     — Anime GIF interactions (hug, pat, kiss, etc.)

---

🎮 Command Reference

💰 Economy (economy.py)

Command	Aliases	Description
!balance	bal, money, wallet	Check wallet & bank
!daily	—	Claim daily reward (streak bonuses!)
!work	—	Work a random job (1h cooldown)
!deposit <amount>	dep	Deposit to bank
!withdraw <amount>	with	Withdraw from bank
!give @user <amount>	pay, transfer	Send money
!rob @user	steal	Attempt to rob someone (5m CD)
!shop	—	Browse the item shop
!buy <item>	—	Purchase an item
!use <item>	—	Use an item from inventory
!inventory	inv, bag	View your items
!leaderboard	lb, top	Economy/level leaderboard
!profile	prof, me	Full stats profile
!marry @user	—	Propose marriage (needs Ring 💍)
!divorce	—	End marriage

🦊 Hunting (hunting.py)

Command	Aliases	Description
!hunt	owo, h	Hunt for animals (30s CD)
!zoo	animals	View your animal collection
!battle @user	fight, vs	Battle another user's animals
!cowoncy	cw	Check your cowoncy balance
!release <animal>	—	Convert animal to cowoncy
!animalinfo <name>	ainfo	Animal stats & rarity
!huntcheck	hcheck	Remaining hunt cooldown
!zoorank	zr	Zoo hunt leaderboard

Rarities: Common 55% → Uncommon 25% → Rare 12% → Epic 6% → Legendary 2%

🎰 Gambling (gambling.py)

Command	Aliases	Description
!slots <bet>	slot, s	Spin the slot machine
!blackjack <bet>	bj	Play Blackjack vs dealer
!roulette <bet> <type>	rou	Red/black/number roulette
!dice <bet>	roll	Roll dice vs the bot
!coinbet <bet> <h/t>	cf, flip	Bet on a coin flip
!crash <bet>	—	Cash out before it crashes!
!highlow <bet>	hl	Higher or lower card game
!gamblinginfo	games	Game list & rules

Bet shortcuts: all, half, max, or any number. Min: $10, Max: $100,000

📈 Leveling (leveling.py)

Command	Aliases	Description
!rank	level, xp, lvl	View rank card
!levels	lvlboard	XP leaderboard
!xpinfo [level]	levelinfo	XP needed for a level
!setlevel @user <n>	Admin	Set someone's level
!addxp @user <n>	Admin	Add XP to a user
!removexp @user <n>	Admin	Remove XP from a user

XP is earned every 60s of chatting. Level-up reward = level × $200.

🛡️ Moderation (moderation.py)

Command	Description
!kick @user [reason]	Kick a member
!ban @user [reason]	Ban a member
!softban @user	Ban + unban (delete messages)
!hackban <id>	Ban by user ID
!unban <user#tag>	Unban a user
!mute @user [duration] [reason]	Timeout a member
!unmute @user	Remove timeout
!warn @user [reason]	Add a warning
!warnings @user	View warnings
!clearwarns @user	Clear all warnings
!purge <n> [@user]	Delete messages
!slowmode <seconds>	Set channel slowmode
!lock / !unlock	Lock/unlock channel
!addrole / !removerole	Manage roles
!nuke	Clone & delete channel
!setlog #channel	Set mod log channel

🎉 Fun (fun.py)

Command	Description
!8ball <question>	Magic 8-ball answer
!joke	Random joke
!truth / !dare	Truth or dare prompts
!wouldyourather	WYR with reactions
!ship @u1 @u2	Ship compatibility
!rate <thing>	Rate anything out of 10
!roast @user	Get roasted
!compliment @user	Give a compliment
!rps <r/p/s>	Rock Paper Scissors
!riddle	Answer a riddle (30s)
!trivia	15-question trivia (reaction-based)
!hangman	Play Hangman
!choose <a|b>	Make a choice
!poll <question> [opts]	Create a poll
!uwuify <text>	UwUify text
!mock <text>	SpOnGeBoB mOcK

🔧 Utility (utility.py)

Command	Description
!ping	Latency & API ping
!help [command]	Help menu
!serverinfo	Server information
!userinfo [@user]	User information
!avatar [@user]	Profile picture
!botinfo	Bot statistics
!uptime	Bot uptime
!roleinfo <role>	Role details
!channelinfo	Channel details
!emojis	Server emoji list
!invite	Bot invite link
!membercount	Member count
!setprefix <prefix>	Change bot prefix (Admin)

💞 Social (social.py)

Targeted: !hug, !pat, !slap, !kiss, !poke, !bite, !cuddle, !feed, !wave, !wink, !stare, !thumbsup

Solo: !blush, !cry, !dance, !smile, !think, !shrug, !sleep, !yawn, !smug, !laugh, !pout, !nod

All social commands fetch anime GIFs from nekos.best API.

---

🛒 Shop Items

Item	Price	Description
🎣 Fishing Rod	$800	Better hunting luck
🪱 Bait	$200	Reduce miss chance by 10%
🍀 Lucky Charm	$1,500	Rare animal chance +5%
🔫 Hunting Rifle	$3,000	Reduce miss by 25%
💍 Ring	$5,000	Required to propose
🏦 Bank Upgrade	$2,000	+$5,000 bank capacity
⚡ XP Boost	$1,000	Double XP from chatting
🎁 Lootbox	$500	Random items inside
🔮 Mystery Box	$2,500	Rare loot box
🪙 Lottery Ticket	$100	Win up to $10,000
🍖 Medkit	$300	Restore 50% daily streak
🪄 Rare Scroll	$10,000	Guaranteed rare hunt
💎 Gem	$50,000	Legendary hunt guarantee

---

⚙️ Configuration (config.py)

Setting	Default	Description
PREFIX	!	Command prefix
STARTING_BALANCE	500	New user starting money
WORK_COOLDOWN_SEC	3600	Work command cooldown
HUNT_COOLDOWN_SEC	30	Hunt command cooldown
ROB_COOLDOWN_SEC	300	Rob command cooldown
MIN_BET	10	Minimum gambling bet
MAX_BET	100000	Maximum gambling bet

---

🗄️ Database

The bot uses SQLite (nexbot.db) auto-created on first run. Tables:

• users — balance, bank, XP, level, cowoncy, streaks, marriage
• animals — zoo collection per user
• warnings — moderation warning log
• inventory — user items
• shop — shop item definitions
• giveaways — active giveaways
• guild_config — per-server settings (prefix, log channel)

---

🐛 Troubleshooting

Bot doesn't respond?

• Check Message Content Intent is enabled in Discord Dev Portal
• Verify token in .env or config.py
• Make sure the bot has permission to send messages in the channel

Commands not loading?

• Ensure Python 3.11+ is installed: python --version
• Install deps: pip install -r requirements.txt
• Check console for error messages on startup

GIFs not showing in social commands?

• The bot uses nekos.best free API — no API key needed
• Fallback GIFs from Giphy are used if the API is down

---

📜 License

Free to use, modify, and distribute. Credit appreciated but not required.