🌟 Pixelmon - The Ultimate Discord RPG Bot 🌟

Immerse your community in the world of RPG with animals, battles, farming, quests, and more!

Pixelmon is a fully-featured Discord RPG bot that brings an immersive experience right to your server. With features like animal battles, farming, economy, quests, and more, Pixelmon is designed to keep your members engaged and entertained for hours. Collect, breed, and battle with animals, trade with friends, climb the leaderboards, and explore new areas as you grow your virtual farm and complete exciting tasks.

🌟 Preview

🌟 Features

💰 Economy System

• Daily rewards and work commands to earn coins
• Gambling system with risk/reward mechanics
• Gift coins to other players
• Complete quests to earn additional rewards

🏆 Rank & Level System

• 16 unique rank tiers with custom emojis and names
• XP-based progression system
• Global leaderboard with pagination
• Rank decay for inactive players
• Profile reputation system with likes/dislikes

⚔️ Battle System

• Player vs Player battles with level-based matchmaking
• Animal vs Animal battles with unique traits and abilities
• Battle power calculations based on stats
• Win/loss tracking and rewards

🐾 Animal Collection

• 15+ different animal types with varying rarity
• Unique traits that affect battle performance
• Breeding system to create offspring with inherited traits
• Animal leveling system with stat improvements
• Send animals on tasks to earn rewards

🌾 Farm System

• Farm management with upgradable structures
• Animal housing with expandable capacity
• Training grounds to boost animal XP gain
• Feeding stations to improve healing effectiveness

⛏️ Mining System

• Mine for various resources (stone, iron, gold, diamond, etc.)
• Rare jackpot discoveries with special rewards
• Chance to find animals while mining
• Resource collection for crafting and building

🎒 Inventory & Shop

• Buy and sell items in the shop
• Manage your inventory of items and resources
• Use potions and items to heal and boost your animals
• Collect rare items through hunting and exploration

🏅 Achievements & Quests

• Daily and weekly quests with rewards
• Achievement system with milestones and bonuses
• Track progress and earn special rewards

🏰 Clan System

• Create or join clans with other players
• Clan leaderboard and ranking
• Clan management with roles and permissions
• Clan XP and leveling system

🧪 Potion & Effects System

• Various potions with temporary effects
• XP boosts, coin boosts, and special abilities
• Active effects tracking and management

👤 Profile System

• Customizable profiles with bio, title, and background
• Profile reputation with likes and dislikes
• View detailed stats and progress
• Track battle record and achievements

📋 Commands

Economy Commands

Command	Description	Cooldown	Usage
/daily	Claim your daily coins and XP	24h	/daily
/work	Work to earn coins	1h	/work
/gift	Gift coins to another user	30m	/gift @user amount
/balance	Check your balance and level	3s	/balance

Battle Commands

Command	Description	Cooldown	Usage
/battle	Battle another user	10m	/battle @opponent
/animalbattle	Battle your animal against another user's animal	10m	/animalbattle @opponent

Game Commands

Command	Description	Cooldown	Usage
/hunt	Hunt for items and animals	30m	/hunt
/mine	Mine for resources and animals	10m	/mine
/guess	Guess a number between 1-10	5m	/guess number
/gamble	Gamble your coins	10m	/gamble amount

Shop Commands

Command	Description	Cooldown	Usage
/shop	View the shop	3s	/shop
/buy	Buy an item from the shop	3s	/buy item [quantity]

User Commands

Command	Description	Cooldown	Usage
/profile	View your profile or another user's profile	3s	/profile [@user]
/profileset	Customize your profile	5s	/profileset bio/title/background/favoriteitem
/inventory	View your inventory	3s	/inventory
/resources	View your resources	3s	/resources
/achievements	View your achievements	3s	/achievements
/help	Shows all available commands	3s	/help [category]

Leaderboard Commands

Command	Description	Cooldown	Usage
/leaderboard	View the leaderboard	10s	/leaderboard type [page]
/animaltop	View the top animals globally	10s	/animaltop sort
/ranktop	View the top ranked users	10s	/ranktop [page]
/liketop	View the most liked trainers	10s	/liketop [page]

Farm Commands

Command	Description	Cooldown	Usage
/farm	View and manage your farm	5s	/farm view/upgrade/build
/animals	View and manage your animals	3s	/animals list/info/select/rename
/addanimal	Add an animal to your farm	5s	/addanimal type name
/heal	Heal one of your animals	5s	/heal animal item
/breed	Breed two of your animals	1h	/breed parent1 parent2 name
/send	Send an animal on a task	5s	/send animal task
/collect	Collect rewards from an animal's task	3s	/collect animal

Rank Commands

Command	Description	Cooldown	Usage
/rank	View your rank or another user's rank	3s	/rank [@user]
/ranks	View all available ranks and their XP requirements	5s	/ranks

Clan Commands

Command	Description	Cooldown	Usage
/clan create	Create a new clan	5s	/clan create name tag [description]
/clan join	Join an existing clan	5s	/clan join name
/clan leave	Leave your current clan	5s	/clan leave
/clan info	View information about a clan	5s	/clan info [name]
/clan members	View the members of your clan	5s	/clan members
/clan kick	Kick a member from your clan	5s	/clan kick @user
/clan leaderboard	View the clan leaderboard	5s	/clan leaderboard

Potion Commands

Command	Description	Cooldown	Usage
/drink	Drink a potion to gain temporary effects	5s	/drink potion
/effects	View your active potion effects	3s	/effects

Quest Commands

Command	Description	Cooldown	Usage
/quests view	View your active quests	3s	/quests view
/quests claim	Claim rewards for completed quests	3s	/quests claim type

📝 Prefix Commands

All commands can also be used with the pixel prefix:

• Example: pixel profile instead of /profile
• Example: pixel battle @user instead of /battle @user

🔄 Cooldowns

• Most commands have cooldowns to prevent spam
• Cooldowns range from 3 seconds to 24 hours depending on the command
• The bot will inform you if you're still on cooldown for a command

🏆 Rank Tiers

Tier	Name	Emoji	XP Required
1	Stoneborn	🪨	0
2	Leafwalker	🌱	150
3	Beastling	🐾	400
4	Flareheart	🔥	700
5	Stormcaller	⚡	1,100
6	Frostshade	❄️	1,600
7	Voidstriker	🌌	2,300
8	Phantomblade	💀	3,200
9	Mythic Soul	🦄	4,500
10	Immortal Flame	🧿	6,000
11	Celestian Warden	🪐	8,000
12	Draconian Deity	🐉	11,000
13	Astralborn	🕊️	15,000
14	Ethereal Sage	🧙	20,000
15	Infinity Zenith	🌠	30,000
16	Omnilord	👑	50,000

🐾 Animal Types

Type	Emoji	Rarity	Source
Rabbit	🐇	Common	Hunt
Fox	🦊	Common	Hunt
Deer	🦌	Common	Hunt
Wolf	🐺	Uncommon	Hunt
Bear	🐻	Rare	Hunt
Mole	🐀	Common	Mine
Hedgehog	🦔	Common	Mine
Bat	🦇	Uncommon	Mine
Owl	🦉	Rare	Both
Eagle	🦅	Rare	Both
Dragon	🐉	Mythical	Special
Unicorn	🦄	Mythical	Special
Phoenix	🔥	Mythical	Special

🧬 Animal Traits

Trait	Effect
Brave	Increases strength in battles by 10%
Lazy	Recovers health faster when resting
Curious	Finds more items during exploration
Smart	Gains 20% more XP
Loyal	Increases coin rewards by 15%
Aggressive	Deals 15% more damage but takes 10% more damage
Timid	Takes 15% less damage but deals 10% less damage
Friendly	Has a 10% chance to avoid battles entirely

---

🏗️ Farm Structures

Structure	Effect	Max Level
Animal House	Increases animal capacity by 2 per level	5
Feeding Station	Increases healing effectiveness by 20%/level	3
Training Ground	Increases XP gain by 10% per level	3

---

💎 Resources

Resource	Emoji	Rarity
Stone	🪨	Common
Iron	⚙️	Common
Gold	🥇	Uncommon
Diamond	💎	Rare
Emerald	💚	Very Rare
Obsidian	🟣	Very Rare
Crystal	✨	Extremely Rare

---

🧪 Potions

Potion	Effect	Duration
Small XP Boost	Increases XP gain by 25%	1 hour
Medium XP Boost	Increases XP gain by 50%	1 hour
Large XP Boost	Doubles XP gain	1 hour
Small Coin Boost	Increases coin gain by 25%	1 hour
Medium Coin Boost	Increases coin gain by 50%	1 hour
Large Coin Boost	Doubles coin gain	1 hour
Battle Shield	Prevents loss of coins when losing battles	2 hours
Lucky Charm	Increases chance of rare finds when mining	30 minutes

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

Please make sure to add the following environment variables to your project:

Source Tree Structure

📦pixelmon
 ┣ 📂commands
 ┃ ┣ 📂achievements
 ┃ ┃ ┗ 📜achievements.js
 ┃ ┣ 📂battle
 ┃ ┃ ┗ 📜battle.js
 ┃ ┣ 📂clan
 ┃ ┃ ┗ 📜clan.js
 ┃ ┣ 📂economy
 ┃ ┃ ┣ 📜balance.js
 ┃ ┃ ┣ 📜daily.js
 ┃ ┃ ┗ 📜work.js
 ┃ ┣ 📂farm
 ┃ ┃ ┣ 📜addanimal.js
 ┃ ┃ ┣ 📜animalbattle.js
 ┃ ┃ ┣ 📜animals.js
 ┃ ┃ ┣ 📜animaltop.js
 ┃ ┃ ┣ 📜breed.js
 ┃ ┃ ┣ 📜collect.js
 ┃ ┃ ┣ 📜farm.js
 ┃ ┃ ┣ 📜gift.js
 ┃ ┃ ┣ 📜heal.js
 ┃ ┃ ┗ 📜send.js
 ┃ ┣ 📂games
 ┃ ┃ ┣ 📜gamble.js
 ┃ ┃ ┣ 📜guess.js
 ┃ ┃ ┗ 📜hunt.js
 ┃ ┣ 📂leaderboard
 ┃ ┃ ┣ 📜leaderboard.js
 ┃ ┃ ┗ 📜liketop.js
 ┃ ┣ 📂mining
 ┃ ┃ ┗ 📜mine.js
 ┃ ┣ 📂potions
 ┃ ┃ ┣ 📜drink.js
 ┃ ┃ ┗ 📜effects.js
 ┃ ┣ 📂quests
 ┃ ┃ ┗ 📜quests.js
 ┃ ┣ 📂rank
 ┃ ┃ ┣ 📜rank.js
 ┃ ┃ ┗ 📜ranktop.js
 ┃ ┣ 📂shop
 ┃ ┃ ┣ 📜buy.js
 ┃ ┃ ┗ 📜shop.js
 ┃ ┗ 📂user
 ┃ ┃ ┣ 📜help.js
 ┃ ┃ ┣ 📜inventory.js
 ┃ ┃ ┣ 📜profile.js
 ┃ ┃ ┣ 📜profileset.js
 ┃ ┃ ┗ 📜resources.js
 ┣ 📂events
 ┃ ┣ 📜interactionCreate.js
 ┃ ┣ 📜messageCreate.js
 ┃ ┗ 📜ready.js
 ┣ 📂models
 ┃ ┣ 📜clanModel.js
 ┃ ┗ 📜userModel.js
 ┣ 📂utils
 ┃ ┣ 📜achievementUtils.js
 ┃ ┣ 📜animalUtils.js
 ┃ ┣ 📜cooldown.js
 ┃ ┣ 📜levelUtils.js
 ┃ ┣ 📜potionUtils.js
 ┃ ┣ 📜questUtils.js
 ┃ ┗ 📜rankUtils.js
 ┣ 📜.env
 ┣ 📜README.md
 ┣ 📜index.js
 ┣ 📜package-lock.json
 ┣ 📜package.json
 ┗ 📜pixelmon.zip

Installation

1. Clone the repository:

   git clone https://github.com/mr3xploiter/The-Ultimate-Discord-RPG-Bot.git

2. Navigate to the project directory:

   cd The-Ultimate-Discord-RPG-Bot

3. Rename the .env.example file to .env and configure your environment variables.

4. Install the required dependencies:

   npm install

Discord Bot Token

1. Go to your discord developer portal or Click the link to go to your developer dashboard . Now click New Application button to create ana application.

2. Now give a name of your bot , and click the check box , then you need to click 'create' button .

3. If all good , then you need to copy the application ID.

4. Then go to any code editor like VS Code . then go to your '.env' and paste it like as shown as in the screenshot

5. Then go to your bot tab

6. Click 'reset token' to generate a bot token

7. Then click 'yes do it'

8. Then you need to provide your discord password and then click 'submit' button

9. Boom! Your token has been successfully generated . you need to copy this token , hint: do not share this token to anyone

10. Then go to your code editor and navigate to '.env' file and paste the token like this .

11. Then go to your developer portal and navigate to 'OAuth2' tab , and scroll down , then enable 'bot'

12. Then scroll down , then enable all propertise as shown as screenshot

13. Then scroll down , then copy the generated url.

13. Then open this link n new tab . you should see like this , select your server where your bot will be join. then click 'Continue' button

13. Then it should looks like this , then click 'Authorize' button.

13. Booom ! You have been successfully added this bot into your server

13. Now go to your discord server where you have successfully added your bot . you should see like this

13. Then you need to go you discord developer dashboard again , navigate to 'Bot' and scrool down , you need to enable all intents like this , and save this

MongoDB Setup

1. Go to MongoDB Register Page and create an account . once you have successfull done , you should see like this , select 'Free' plan for this project.

2. Give a name of your claster i have by default 'claster0' you can give any name you want. you need to select any provider , by default 'AWS' is selected. then click 'Create Deployment' button .

3. Then connect to cluster dialogue will comes , you have username and pasword , then click 'Create Database User' ,

4. Then scroll down , you will get connection string like this , copy the string , and then click 'Done'

5. Then go to your code editor , and paste your mongodb token here

6. Then go to your mongodb dashboard again .then navigate to 'Network Access' and click '+ Add IP Address' button

7. You should looks like when you click '+ Add IP Address' button . then click 'ALLOW ACCESS FROM EVERYWHERE' button . then click 'conferm' button

You have been successfully configured mongdb for this project

Now start this bot

5. Start the bot:

   node index.js

6. Now your Pixelmon bot should be up and running!