← Back to Game Hub

📚 PetBot Commands

Complete guide to Pokemon-style pet collecting in IRC

🧭 Quick Navigation

🚀 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.