📖 Game Documentation
Everything you need to know about running your Pokemon Gym
🎮 Overview
Welcome to PokéGym Tycoon - a browser-based management game where you build and run your own Pokemon Gym. Train Pokemon, battle challengers, upgrade your facilities, and become the ultimate Gym Leader!
Core Gameplay Loop
- Catch Pokemon - Recruit new Pokemon to your roster from the wild
- Train - Improve your Pokemon's stats through daily training
- Battle - Send Pokemon to fight challengers and earn rewards
- Upgrade - Invest in facilities to boost your gym's capabilities
- Progress - Advance days to trigger training, healing, and events
Key Features
Deep Pokemon System
8 Pokemon types, 6 stats, 14 natures, unique skills
Dynamic Battles
Turn-based combat with difficulty scaling
Gym Management
7 upgradeable facilities with unique bonuses
Economy System
Manage treasury, pay upkeep, earn from victories
🚀 Getting Started
1. Connect Your Wallet
PokéGym uses Solana wallet authentication. Supported wallets:
- Phantom - Most popular Solana wallet
- Solflare - Feature-rich alternative
💡 Tip: You'll need to sign a message to prove wallet ownership. This doesn't cost any SOL or grant access to your funds.
2. Create Your Gym
After connecting, you'll create your gym:
- Gym Name - Choose a unique name (2-50 characters)
- Motto - Your gym's catchphrase (optional)
- Region - Select from 8 Pokemon regions (Kanto, Johto, etc.)
3. Starting Resources
4. Catch Your First Pokemon
Visit the Catch Pokemon tab to see available wild Pokemon. Each has different stats, natures, and prices. Choose wisely based on your budget and strategy!
⚡ Pokemon
Pokemon Types
Each Pokemon has one of 8 types, which affects their base stats and battle effectiveness:
Pokemon Origins
Pokemon come from different backgrounds, affecting their initial morale and loyalty:
Pokemon Status
📊 Stats System
Every Pokemon has 6 core stats that determine their battle performance. Stats range from 1 to 255.
Physical attack power. Determines damage dealt with physical moves.
- • Increases physical damage
- • Affects tackle and slam moves
- • Higher = more knockout potential
Speed and reflexes. Determines turn order and dodge chance.
- • Faster Pokemon attack first
- • Increases dodge chance
- • Affects escape success rate
Physical defense and stamina. Reduces incoming damage.
- • Reduces physical damage taken
- • Increases max HP
- • Better stamina recovery
Special attack power and precision. Affects special moves and crits.
- • Increases special move damage
- • Higher critical hit chance
- • Affects skill effectiveness
Special defense and mental fortitude. Resists special attacks and morale loss.
- • Reduces special damage taken
- • Resists morale drops
- • Affects crowd favor in battles
Tactical ability and learning speed. Affects XP gain and skill learning.
- • Faster XP gain
- • Learns skills quicker
- • Better tactical decisions in battle
Stat Ranges
🌿 Natures
Each Pokemon has 1-3 natures that modify their stats and behavior. Natures are permanent traits that define a Pokemon's personality.
🏋️ Training
Training improves your Pokemon's stats over time. Each day, Pokemon train based on their assigned focus.
Training Focus Options
Training Mechanics
- Training costs 15 stamina per session
- Base stat gain is 1-3 points per day
- Training Dojo facility increases gains by 20% per level
- Pokemon with higher Intelligence learn faster
- Exhausted Pokemon (0 stamina) train less effectively
XP and Leveling
Pokemon gain XP from training and battles. Each level increases all stats slightly and unlocks new skills.
⚔️ Battles
Send your Pokemon to battle challengers. Victories earn gold, fame, and experience.
Battle Types
Battle wild Pokemon. Low risk, moderate rewards.
Challenge other trainers. Balanced risk/reward.
Face powerful Gym Leaders. High risk, high reward.
The elite challenge. Only for the strongest.
The ultimate test. Legendary rewards await.
Battle Mechanics
- Turn Order: Faster Pokemon (higher Agility) attack first
- Damage: Based on Strength/Technique vs Endurance/Courage
- Critical Hits: Chance based on Technique stat
- Dodge: Chance based on Agility stat
Battle Outcomes
- • Earn gold reward
- • Gain fame
- • Earn XP
- • Boost morale
- • No gold reward
- • Lose some fame
- • Still earn some XP
- • Morale drops
Injury & Fainting
⚠️ Warning: Pokemon can get injured or faint in battle!
- Injury risk: 10% base + 2% per difficulty level
- Fainting risk: 1% base + 2% per difficulty level
- Injured Pokemon need time at the Pokemon Center to heal
- Fainted Pokemon need revival (costly!)
🎯 PvP Battles
Challenge other players' Pokemon in real-time PvP battles! Test your training against real opponents.
How PvP Works
- Go to Battles Tab - Navigate to the Battles section in your gym
- Select PvP Mode - Switch from Bot battles to PvP mode
- Choose Your Fighter - Select one of your active Pokemon
- Select an Opponent - Browse Pokemon from other gyms
- Battle! - Watch the fight unfold with detailed battle logs
PvP Opponent Requirements
- Opponents must have at least 50% health
- Only Active status Pokemon can be challenged
- You cannot battle your own Pokemon
- Up to 20 opponents shown at a time
PvP Rewards
🏆 Victory Rewards
- • Pokédollars based on opponent's level
- • Fame points for your gym
- • XP for your Pokemon
- • Morale boost
💔 Defeat Consequences
- • No gold reward
- • Small fame loss
- • Pokemon may get injured
- • Morale drops
PvP Battle Tips
💡 Pro Tips:
- Check opponent's level and win/loss record before challenging
- Higher level Pokemon generally have better stats
- Consider type matchups when selecting opponents
- Keep your Pokemon healthy - you can't PvP with injured Pokemon
- Build a diverse team to handle different opponent types
🏛️ Facilities
Upgrade your gym's facilities to unlock bonuses and improve efficiency.
Where Pokemon train and grow stronger.
Heals injured Pokemon faster.
Attracts tougher opponents with better rewards.
Helps Pokemon learn and remember moves.
Pokemon rest and bond with trainers.
Sacred place that boosts spiritual connection.
Upgrade Costs
Each facility level costs 2x the previous level. Plan your upgrades carefully based on your strategy!
🛒 Marketplace
Buy and sell Gyms and Pokemon with other players using SOL or PGT tokens!
What Can You Trade?
🏟️ Gyms
- • Sell your entire gym operation
- • Includes all Pokemon, facilities, treasury
- • Fame and reputation transfer to buyer
- • Great for starting fresh or cashing out
⚡ Pokemon
- • List individual Pokemon for sale
- • Stats, level, and natures all transfer
- • Set your own price in SOL or PGT
- • Find rare Pokemon from other trainers
Payment Methods
How to List
- Go to Marketplace - Click "Market" in the navigation
- Select "My Listings" - Manage your sales
- List Gym or Pokemon - Choose what to sell from your gym page
- Set Prices - Enter SOL and/or PGT prices
- Confirm Listing - Your item appears on marketplace
How to Buy
- Browse Listings - View available Gyms and Pokemon
- Check Details - Review stats, level, facilities
- Choose Payment - Select SOL or PGT
- Approve Transaction - Sign with your wallet
- Receive Item - Pokemon/Gym transfers to you
Marketplace Tips
- Check a Pokemon's win/loss record before buying
- Higher level Pokemon are worth more
- Rare natures can add significant value
- Gyms with upgraded facilities are premium
- You can delist items anytime before sale
💰 Economy
Income Sources
Expenses
Reward Split
Pokemon save their share for eventual release ceremonies.
📈 Progression
Day Cycle
Click "Advance Day" to progress time. Each new day:
- Pokemon train based on their focus
- Injured Pokemon heal (if in Pokemon Center)
- Daily upkeep is deducted from treasury
- Random events may occur
- Morale and stamina are updated
Reputation & Fame
⭐ Reputation
Your gym's overall standing. Higher reputation attracts better Pokemon and opponents.
🏆 Fame
Earned through victories. Fame unlocks special events and sponsorships.
Hall of Fame
Legendary Pokemon who achieve great feats are immortalized in your Hall of Fame:
- Released - Pokemon who earned their freedom
- Champion - Defeated the Champion battle
- Legend - Achieved 100+ wins
- Record Holder - Set a gym record
🌐 Multiplayer
View Other Gyms
Visit the Gyms page to see other players' gyms. View their Pokemon, facilities, and stats to learn from the best!
- Browse all registered gyms
- See gym stats, Pokemon roster, and facilities
- Check win/loss records
- Find inspiration for your own gym strategy
Current Multiplayer Features
✅ Available Now
- • PvP Pokemon Battles
- • Marketplace (Buy/Sell)
- • View Other Gyms
- • Global Gym Browser
🚧 Coming Soon
- • Tournaments
- • Gym Alliances
- • Leaderboards
- • Chat System
Social Features
PokéGym Tycoon is designed to be a social experience. Interact with other trainers through:
- PvP Battles - Test your Pokemon against real players
- Marketplace - Trade Pokemon and Gyms
- Gym Browsing - Learn from successful trainers
🔐 Web3 Integration
Wallet Authentication
PokéGym uses Solana wallet signatures for secure, passwordless authentication:
- Connect your Solana wallet (Phantom, Solflare)
- Sign a verification message (free, no SOL required)
- Your wallet address becomes your account ID
- All game data is tied to your wallet
Benefits of Web3
- No passwords - Your wallet IS your login
- Ownership - Your gym is tied to your wallet
- Security - Cryptographic verification
- Future-proof - Ready for NFTs and tokens
Future Web3 Features
💎 Planned Web3 Features:
- NFT Pokemon with on-chain ownership
- Token rewards for achievements
- Decentralized marketplace
- DAO governance for game updates
💡 Tips & Strategies
Beginner Tips
🎯 Start Small
Don't blow your starting gold on expensive Pokemon. Catch 2-3 cheap Pokemon first to learn the mechanics. You can always catch better ones later.
🏥 Prioritize Pokemon Center
Your first facility upgrade should be the Pokemon Center. Faster healing means more battles and more income.
⚔️ Start with Easy Battles
Wild Pokemon battles are low risk. Build up your Pokemon's stats before attempting harder challenges.
Advanced Strategies
📊 Stat Specialization
Rather than training all stats evenly, specialize! A Pokemon with maxed Strength and Agility will often outperform one with balanced stats.
🔄 Rotation Strategy
Keep multiple Pokemon trained. While one battles, another can rest. This maximizes your daily earning potential.
💰 Economy Management
Always keep a reserve of 500+ gold. Daily upkeep and unexpected events can drain your treasury. Don't go broke!
PvP Strategies
🔍 Scout Before Fighting
Check the opponent's gym first. Look at their Pokemon's level, win record, and type. Pick battles you can win.
⚡ Speed Kills
In PvP, higher Agility means attacking first. A fast Pokemon can often defeat slower opponents before they get a chance to fight back.
🎲 Type Advantages
Build a diverse team. If you only have Fire types, Water opponents will dominate you. Cover your weaknesses.
Common Mistakes to Avoid
- ❌ Don't battle when your Pokemon is injured - they'll likely faint!
- ❌ Don't ignore stamina - exhausted Pokemon train poorly
- ❌ Don't spend all gold on one expensive Pokemon
- ❌ Don't attempt Champion battles without maxed stats
- ❌ Don't forget to advance the day - training happens daily!
Optimal Daily Routine
- Check Pokemon Status - Review health, stamina, morale
- Set Training Focus - Assign each Pokemon their training
- Battle Ready Pokemon - Send healthy ones to fight
- Rest Exhausted Pokemon - Set to Rest if stamina is low
- Check Marketplace - Look for good deals on Pokemon
- Advance Day - Progress to apply all changes
- Repeat! - Consistency is key to success