Files
echoes-of-the-ash/docs/archive/PWA_QUICK_START.md
2025-11-07 15:27:13 +01:00

139 lines
3.1 KiB
Markdown

# 🎮 PWA Quick Start Guide
## Getting Started
1. **Visit:** https://echoesoftheashgame.patacuack.net
2. **Register:** Create a new account with username and password
3. **Login:** Enter your credentials
4. **Play!** Start exploring the wasteland
---
## Interface Overview
### 📊 Stats Bar (Always Visible)
- **❤️ Health** - Your current HP / max HP
- **⚡ Stamina** - Energy for movement and actions
- **📍 Location** - Current area name
### 🗺️ Explore Tab
- **Location Info:** Name and description of where you are
- **Compass:** Move north, south, east, or west
- Grayed out buttons = no path in that direction
- **Actions:** Rest, Look, Search (coming soon)
- **NPCs/Items:** See who and what is at your location
### 🎒 Inventory Tab
- View your items and equipment
- Note: Being migrated for web users
### 🗺️ Map Tab
- See available exits from your current location
- Interactive map visualization coming soon
### 👤 Profile Tab
- Character stats (Level, XP, Attributes)
- Skill points to spend
- Combat stats
---
## How to Play
### Moving Around
1. Go to **Explore** tab
2. Click compass buttons to travel
3. Each move costs 1 stamina
4. Read the location description to explore
### Managing Resources
- **Stamina:** Regenerates over time (feature coming)
- **Health:** Rest or use items to recover
- **Items:** Check inventory tab
### Character Development
- Gain XP by exploring and combat
- Level up to earn skill points
- Spend points in Profile tab (coming soon)
---
## Mobile Installation
### Android (Chrome/Edge)
1. Visit the site
2. Tap menu (⋮)
3. Select "Add to Home Screen"
4. Confirm installation
### iOS (Safari)
1. Visit the site
2. Tap Share button
3. Select "Add to Home Screen"
4. Confirm installation
---
## Keyboard Shortcuts (Coming Soon)
- **Arrow Keys** - Move in directions
- **I** - Open inventory
- **M** - Open map
- **P** - Open profile
- **R** - Rest
---
## Tips & Tricks
1. **Explore Everywhere** - Each location has unique features
2. **Watch Your Stamina** - Don't get stranded without energy
3. **Read Descriptions** - Clues for quests and secrets
4. **Talk to NPCs** - They have stories and items (coming soon)
5. **Install the PWA** - Works offline after first visit!
---
## Troubleshooting
### Can't Login?
- Check username/password spelling
- Try registering a new account
- Clear browser cache and retry
### Not Loading?
- Check internet connection
- Try refreshing the page (Ctrl+R / Cmd+R)
- Clear cache and reload
### Movement Not Working?
- Check stamina - need at least 1 to move
- Ensure path exists (button should be enabled)
- Refresh page if stuck
### Lost Connection?
- PWA works offline for basic navigation
- Reconnect to sync progress
- Changes saved to server automatically
---
## Features Coming Soon
- ⚔️ Combat system
- 💬 NPC conversations
- 📦 Item pickup and use
- 🗺️ Interactive world map
- 🏆 Achievements
- 👥 Player trading
- 🔔 Push notifications
---
## Need Help?
- Check game logs
- Report issues to admin
- Join community discord (coming soon)
**Happy exploring! 🏜️**