PetBot - Command Help

🚀 Getting Started

!start

Begin your pet collecting journey! Creates your trainer account and gives you your first starter pet.

Example: !start

!help

Get a link to this comprehensive command reference page.

Example: !help

!stats

View your basic trainer information including level, experience, and money.

Example: !stats

🌍 Exploration & Travel

!explore

Search your current location for wild pets or items. You might find pets to battle/catch or discover useful items!

Example: !explore

!travel <location>

Move to a different location. Each area has unique pets and gyms. Some locations require achievements to unlock.

Example: !travel whispering woods

!weather

Check the current weather effects in your location. Weather affects which pet types spawn more frequently.

Example: !weather

!where / !location

See which location you're currently in and get information about the area.

Example: !where

!wild [location]

Show wild pets available in your current location or a specified location. Helps you see what pets you can encounter.

Example: !wild or !wild crystal caves

🗺️ Available Locations

Starter Town - Peaceful starting area (Fire/Water/Grass pets)
Whispering Woods - Ancient forest (Grass pets + new species: Vinewrap, Bloomtail)
Electric Canyon - Charged valley (Electric/Rock pets)
Crystal Caves - Underground caverns (Rock/Crystal pets)
Frozen Tundra - Icy wasteland (Ice/Water pets)
Dragon's Peak - Ultimate challenge (Fire/Rock/Ice pets)

🌤️ Weather Effects

Sunny - 1.5x Fire/Grass spawns (1-2 hours)
Rainy - 2.0x Water spawns (45-90 minutes)
Thunderstorm - 2.0x Electric spawns (30-60 minutes)
Blizzard - 1.7x Ice/Water spawns (1-2 hours)
Earthquake - 1.8x Rock spawns (30-90 minutes)
Calm - Normal spawns (1.5-3 hours)

⚔️ Battle System

!catch / !capture

Attempt to catch a wild pet that appeared during exploration. Success depends on the pet's level and rarity.

Example: !catch

!battle

Start a turn-based battle with a wild pet. Defeat it to gain experience and money for your active pet.

Example: !battle

!attack <move>

Use a specific move during battle. Each move has different power, type, and effects.

Example: !attack flamethrower

!moves

View all available moves for your active pet, including their types and power levels.

Example: !moves

!flee

Attempt to escape from the current battle. Not always successful!

Example: !flee

💀 Pet Fainting System

Battle Defeat - Pets that lose battles will faint and cannot be used until healed
Healing Options - Use Revive items, !heal command, or wait 30 minutes for auto-recovery
Strategic Impact - Plan your battles carefully to avoid having all pets faint
Type Advantages - Use type matchups to win battles and avoid fainting

🏛️ Gym Battles NEW!

!gym

List all gyms in your current location with your progress. Shows victories and next difficulty level.

Example: !gym

!gym list

Show all gyms across all locations with your badge collection progress.

Example: !gym list

!gym challenge "<name>"

Challenge a gym leader! You must be in the same location as the gym. Difficulty increases with each victory.

Example: !gym challenge "Forest Guardian"

!gym info "<name>"

Get detailed information about a gym including leader, theme, team, and badge details.

Example: !gym info "Storm Master"

!forfeit

Forfeit your current gym battle if you're losing or want to try a different strategy.

Example: !forfeit

💡 Gym Strategy: Each gym specializes in a specific type. Bring pets with type advantages! The more you beat a gym, the harder it gets, but the better the rewards!

🏆 Gym Leaders & Badges

🍃 Forest Guardian
Location: Starter Town
Leader: Trainer Verde
Theme: Grass-type

🌳 Nature's Haven
Location: Whispering Woods
Leader: Elder Sage
Theme: Grass-type

⚡ Storm Master
Location: Electric Canyon
Leader: Captain Volt
Theme: Electric-type

💎 Stone Crusher
Location: Crystal Caves
Leader: Miner Magnus
Theme: Rock-type

❄️ Ice Breaker
Location: Frozen Tundra
Leader: Arctic Queen
Theme: Ice/Water-type

🐉 Dragon Slayer
Location: Dragon's Peak
Leader: Champion Drake
Theme: Fire-type

🐾 Pet Management

!team

View your active team of pets with their levels, HP, and status.

Example: !team

!pets

View your complete pet collection with detailed stats and information via web interface.

Example: !pets

!activate <pet>

Add a pet to your active battle team. You can have multiple active pets for different situations.

Example: !activate flamey

!deactivate <pet>

Remove a pet from your active team and put it in storage.

Example: !deactivate aqua

!nickname <pet> <new_nickname>

Give a custom nickname to one of your pets. Use their current name or ID to reference them.

Example: !nickname flamey "Blazer"

🎒 Inventory & Healing System UPDATED!

!inventory / !inv / !items

View all items in your inventory organized by category. Shows quantities and item descriptions.

Example: !inventory

!use <item name>

Use a consumable item from your inventory. Items can heal pets, boost stats, revive fainted pets, or provide other benefits.

Example: !use Small Potion, !use Revive

!heal

Heal all your active pets to full health. Has a 1-hour cooldown to prevent abuse.

Example: !heal

🎯 Item Categories & Rarities

○ Common (15%) - Small Potions, basic healing items
◇ Uncommon (8-12%) - Large Potions, battle boosters, special berries
◆ Rare (3-6%) - Super Potions, Revive items, speed elixirs, location treasures
★ Epic (2-3%) - Max Revive, evolution stones, rare crystals, ancient artifacts
✦ Legendary (1%) - Lucky charms, ancient fossils, ultimate items

💡 Item Discovery: Find items while exploring! Each location has unique treasures. Items stack in your inventory and can be used anytime.

🏥 Pet Healing System

Fainted Pets - Pets that lose battles faint and cannot be used until healed
Revive Items - Use Revive (50% HP) or Max Revive (100% HP) to restore fainted pets
!heal Command - Heals all active pets to full health (1-hour cooldown)
Auto-Recovery - Fainted pets automatically recover to 1 HP after 30 minutes
Travel Allowed - You can still travel and explore with fainted pets

🎯 Community Events NEW!

!events

View all active community events that all players can participate in together.

Example: !events

!event <id>

Get detailed information about a specific community event, including progress and leaderboard.

Example: !event 1

!contribute <id>

Contribute to a community event. Everyone who participates gets rewards when the event completes!

Example: !contribute 1

!eventhelp

Get detailed help about the community events system and how it works.

Example: !eventhelp

🤝 How Community Events Work

Collaborative Goals - All players work together toward shared objectives
Progress Tracking - Events show progress bars and contribution leaderboards
Time Limited - Events have deadlines and expire if not completed
Difficulty Levels - ⭐ Easy, ⭐⭐ Medium, ⭐⭐⭐ Hard events with better rewards
Automatic Spawning - New events appear regularly for ongoing engagement

🎪 Event Types

🏪 Resource Gathering - Help collect supplies for the community
🐾 Pet Rescue - Search for and rescue missing pets
🎪 Community Projects - Work together on town improvement projects
🚨 Emergency Response - Help during natural disasters or crises
🔬 Research - Assist scientists with important discoveries

💡 Event Strategy: Check !events regularly for new opportunities! Higher difficulty events give better rewards, and contributing more increases your reward multiplier when the event completes.

🏆 Achievements & Progress

!achievements

View your achievement progress and see which new locations you've unlocked.

Example: !achievements

🎯 Location Unlock Requirements

Pet Collector (5 pets) → Unlocks Whispering Woods
Spark Collector (2 Electric species) → Unlocks Electric Canyon
Rock Hound (3 Rock species) → Unlocks Crystal Caves
Ice Breaker (5 Water/Ice species) → Unlocks Frozen Tundra
Dragon Tamer (15 pets + 3 Fire species) → Unlocks Dragon's Peak

🌐 Web Interface

Access detailed information through the web dashboard at http://petz.rdx4.com/

Player Profiles - Complete stats, pet collections, and inventories
Leaderboard - Top players by level and achievements
Locations Guide - All areas with spawn information
Gym Badges - Display your earned badges and progress
Interactive Map - See where all players are exploring
Team Builder - Drag-and-drop team management with PIN verification

🤖 Bot Status & Utilities

!status

Check the bot's current connection status and basic system information.

Example: !status

!uptime

See how long the bot has been running since last restart.

Example: !uptime

!ping

Test the bot's responsiveness with a simple ping-pong test.

Example: !ping

🔧 System Status

Connection Monitoring - Bot automatically monitors its IRC connection
Auto-Reconnect - Automatically reconnects if connection is lost
Background Tasks - Weather updates, event spawning, and data validation
Rate Limiting - Built-in protection against spam and abuse

⚡ Rate Limiting & Fair Play

🛡️ Rate Limiting System

PetBot uses a sophisticated rate limiting system to ensure fair play and prevent spam. Commands are organized into categories with different limits:

Basic Commands (!help, !ping, !status) - 20 per minute, 5 burst capacity
Gameplay Commands (!explore, !battle, !catch) - 10 per minute, 3 burst capacity
Management Commands (!pets, !activate, !stats) - 5 per minute, 2 burst capacity
Web Interface - 60 requests per minute, 10 burst capacity

📊 How It Works

Token Bucket Algorithm - You have a "bucket" of tokens that refills over time
Burst Capacity - You can use multiple commands quickly up to the burst limit
Refill Rate - Tokens refill based on the requests per minute limit
Cooldown Period - Brief cooldown after hitting limits before trying again

⚠️ Violations & Penalties

3 violations - Warning threshold reached (logged)
10 violations - Temporary 5-minute ban from all commands
Admin Override - Admins can unban users and reset violations
Automatic Cleanup - Old violations and bans are automatically cleared

!rate_stats

View global rate limiting statistics (Admin only).

Example: !rate_stats

!rate_user <username>

Check rate limiting status for a specific user (Admin only).

Example: !rate_user playername

!rate_unban <username>

Manually unban a user from rate limiting (Admin only).

Example: !rate_unban playername

!rate_reset <username>

Reset violations for a user (Admin only).

Example: !rate_reset playername

💡 Tips for Smooth Gameplay

Play Naturally - Normal gameplay rarely hits rate limits
Use the Web Interface - Higher limits for browsing and pet management
Spread Out Commands - Avoid rapid-fire command spamming
Check Your Status - If you get rate limited, wait a moment before trying again

🛡️ Admin Commands

!reload

Reload all bot modules without restarting the bot (Admin only).

Example: !reload

!setweather <location|all> <weather_type> [duration]

Manually set weather for a location or all locations (Admin only).

Example: !setweather all sunny 120

!spawnevent [difficulty]

Force spawn a community event with optional difficulty 1-3 (Admin only).

Example: !spawnevent 2

!startevent [type] [difficulty]

Start a specific event type. Without args, shows available types (Admin only).

Example: !startevent resource_gathering 2

🔑 Admin Access

Single Admin User - Only one designated admin user can use these commands
Module Management - Reload modules without restarting the entire bot
Weather Control - Force weather changes for testing or events
Event Management - Spawn community events on demand

⚠️ Admin Note: These commands require admin privileges and can affect the entire bot system. Use with caution and always test changes in a development environment first.

📚 PetBot Commands

🧭 Quick Navigation

🗺️ Available Locations

🌤️ Weather Effects

💀 Pet Fainting System

🏆 Gym Leaders & Badges

🎯 Item Categories & Rarities

🏥 Pet Healing System

🤝 How Community Events Work

🎪 Event Types

🎯 Location Unlock Requirements

🔧 System Status

🛡️ Rate Limiting System

📊 How It Works

⚠️ Violations & Penalties

💡 Tips for Smooth Gameplay

🔑 Admin Access