📜 Guide — Advanced Quest Navigation System
Comprehensive Popmundo quest tracking, step management, and route recording tool with intelligent navigation
🚀 Installation
Browser Extension Setup
Installation Steps:
- Install Tampermonkey extension for your browser
- Visit GreasyFork script page
- Click Install button
- Script updates automatically
Mobile Installation
Android Options:
- Kiwi Browser + Tampermonkey extension (recommended)
- Firefox + Tampermonkey extension
iPhone / iPad Options:
- Userscripts app (Safari)
- Other userscript-compatible browsers
✨ Core Features
🧭 Intelligent Compass Panel
Auto-opens on map pages (/Locale/Compass) with comprehensive quest management:
- Active quest display with progress counter (
57/156 format)
- Large action button for current step execution
- Next 5 steps preview for planning ahead
- Manual navigation with
← Back / Forward → buttons
- Checkpoint jumping via dropdown menu
- Stop/Skip mode toggle for confirmation control
- Color-coded event log (last 20 entries)
- Travel timer with expiration alerts
- Route recording mode for creating new quests
- Draggable interface with position memory
⊡ Compact Mode Optimization
The ⊡ button transforms the panel for mobile-friendly usage:
- 200px width layout for space efficiency
- Quest dropdown + step counter on single line
- Large action button maintained
- Navigation buttons preserved
- Preference saving for mode persistence
- Normal mode return with
⛶ button
✏️ Quest Edit System
Direct quest modification when active:
- In-place editing of quest name and full text
- Parse validation for step verification
- Error checking with detailed feedback
- Save/Cancel controls for safety
📋 Comprehensive Admin Panel
Four-tab management system for complete control:
Characters Tab:
- Multi-character overview with quest status
- Per-character quest assignment
- Individual progress tracking
- Personal note fields per character
- Bulk quest operations for efficiency
Quests Tab:
- Complete quest library management
- Edit, copy, delete operations
- New quest creation with form interface
- Parse validation for syntax checking
- Import/Export functionality (plain text or JSON)
Log Tab:
- 150-entry event history per character
- Color-coded event types (error, checkpoint, move, travel...)
- Copy and clear log operations
- Detailed activity tracking
Settings Tab:
- Language selection (TR / EN / PT-BR)
- Connection status display
- System configuration options
🔊 Smart Alert System
Intelligent notification management:
- Sound + browser notifications for travel completion
- Repeating alerts every minute (up to 5 times)
- Mute functionality (1-hour silence)
- Cross-tab synchronization via
localStorage
🗺️ Route Recording Mode
Capture your journeys:
- Automatic recording of movements and item usage
- Quest creation from recorded paths
- Named quest saving in database
- Step-by-step capture of actual gameplay
🔌 PopControl Integration
Seamless ecosystem connectivity:
- Auto-connect on page load
- Guide button appears on PopControl bar
- Float button hiding when connected
- Persistent connection management
📝 Quest Command System
Command Reference
| Command |
Description |
Example |
move |
Direction movement |
move North SouthEast East |
use_item |
Use specific item |
use_item Submarine |
use_item ? @ Location |
Use any item at location |
use_item ? @ Icy Caverns |
use_item Name @ Location |
Use specific item at location |
use_item hole @ Icy Caverns |
try_item |
Use item if present, skip if not |
try_item Oxygen Tank |
passage Xmin |
Travel waiting time |
passage 16min |
wait Xmin |
General waiting time |
wait 30min |
checkpoint LABEL |
Location marker for jumping |
checkpoint ENTRANCE |
| `require Item \ |
Description` |
Required item warning |
| `info Text \ |
Link` |
One-time information message |
| `goto Place \ |
LocID` |
Direct navigation link |
branch Dir -> CHECKPOINT |
Conditional branch |
branch West -> GO_BACK |
# Comment |
Non-step comment line |
# Watch out here! |
Direction Codes Support
| Code |
Direction |
Turkish |
Portuguese |
| N / K |
North |
Kuzey |
Norte |
| S / G |
South |
Güney |
Sul |
| E / D |
East |
Doğu |
Leste |
| W / B |
West |
Batı |
Oeste |
| NE / KD |
NorthEast |
KuzeyDoğu |
Nordeste |
| NW / KB |
NorthWest |
KuzeyBatı |
Noroeste |
| SE / GD |
SouthEast |
GüneyDoğu |
Sudeste |
| SW / GB |
SouthWest |
GüneyBatí |
Sudoeste |
| U / Y |
Up |
Yukarı |
Cima |
| D / A |
Down |
Aşağı |
Baixo |
🎮 Usage Guide
Opening the Panel
- Map Pages: Auto-opens on
/Locale/Compass
- Other Pages: Click float button (
🗺️)
- PopControl: Click Guide button on bar
Quest Navigation
- Select quest from dropdown
- View current step in main display
- Execute step with large Forward button
- Navigate manually with arrow buttons
- Jump checkpoints via dropdown
Route Recording
- Select
🗺 New Map from quest dropdown
- Perform actions - automatically recorded
- Save recording as named quest
- Edit and refine if needed
Quest Creation
- Admin Panel → Quests tab
- Click + New Quest
- Enter name and steps (one per line)
- Use Parse button for validation
- Save to database
Multi-Character Management
- Characters tab → + Add Character
- Enter character name
- Assign quest from dropdown
- Track progress independently
⚙️ Configuration Options
| Setting |
Options |
Description |
| Language |
TR / EN / PT-BR |
Interface language |
| Stop/Skip Mode |
Confirm / Auto-advance |
Step execution mode |
| Alert Volume |
0-100% |
Notification volume |
| Auto-open |
On / Off |
Auto-open on compass pages |
| Compact Mode |
On / Off |
Mobile-friendly layout |
| Panel Position |
Saved position |
Drag-and-drop positioning |
🔧 Advanced Features
Smart Step Detection
- Location-aware step execution
- Item matching with subtitle search
- Single item auto-use when only one available
- Selection list for ambiguous items
- Error recovery with helpful messages
Travel Management
- Automatic timer for travel steps
- Visual countdown display
- Alert system for completion
- Mute controls for silence periods
- Cross-tab synchronization
Data Persistence
- GM storage for quest data
- Character progress tracking
- Settings preservation
- Backup/restore functionality
- Cross-browser compatibility
❓ Troubleshooting
Common Issues & Solutions
Script not loading?
→ Ensure Tampermonkey is active. Refresh page. Verify popmundo.com URL.
Compass panel not showing?
→ Only opens automatically on /Locale/Compass pages. Click float button or use PopControl.
Panel closed and won't reopen?
→ Closing with × prevents auto-reopen on same page. Use float button or PopControl.
"Item not found" errors?
→ Item name may not match exactly. Script now searches subtitles too. Selection list appears for multiple matches.
Alert keeps sounding?
→ Click 🔇 in passage dialog or Mute button. Muted for 1 hour.
Not working on mobile?
→ Kiwi Browser + Tampermonkey recommended for Android. Firefox mobile also works. iPhone: try Userscripts app.
PopControl connection issues?
→ Auto-reconnects after page reload. Float button visible = connection lost.
📋 Version History
Recent Updates
- v2.3: PopControl integration, custom language support
- v2.2: Multi-character management, quest database improvements
- v2.1: Route recording mode, compact interface optimization
- v2.0: Quest command system, smart compass panel
Built-in Quests
- North Pole Quest - Complete polar adventure
- Antenora - Advanced navigation challenge
- Depths of the Sea - Underwater exploration
- Unholy Diver - Specialized diving quest
- Nautilus Team - Cooperative mission
- Kraken Team - Advanced team quest
- Mosaic Miracles - Complex puzzle quest
- Nec Plus Ultra - Ultimate challenge
🌐 Language Support
Available Languages
- 🇹🇷 Turkish (TR)
- 🇬🇧 English (EN)
- 🇧🇷 Brazilian Portuguese (PT-BR)
Translation Features
- Complete UI translation for all interface elements
- Dynamic language switching without reload
- Direction code localization (Turkish/Portuguese support)
- Custom terminology support
🔗 Integration & Ecosystem
PopControl Ecosystem
- Central management through PopControl bar
- Auto-connect functionality
- Unified interface when connected
- Cross-script communication
Compatible Scripts
- Depot: Inventory management
- Helper: UI enhancements
- Social/Social Mobile: Social features
- MissionAid: Quest assistance
💡 Pro Tips
Efficiency Tips
- Use keyboard shortcuts for faster navigation
- Enable compact mode on mobile devices
- Record routes for frequently used paths
- Utilize checkpoints for complex quests
- Backup quests regularly
Best Practices
- Test quests before full deployment
- Use descriptive names for checkpoints
- Plan routes in advance
- Validate syntax with parse function
- Document complex quests with comments
📞 Support & Community
Getting Help
- Check troubleshooting section for common issues
- Visit GreasyFork for updates and discussions
- Report bugs via comment section
- Request features through community feedback
Resources
- Built-in quest database for examples
- Command reference for quest creation
- Community forums for sharing quests
- Video tutorials for visual learning
Guide is part of the PopControl ecosystem - developed by luke-james-gibson for comprehensive Popmundo quest management.
