Popmundo Itinerary Booker - Complete Documentation
Overview
The Popmundo Itinerary Booker is a comprehensive Tampermonkey userscript designed to automate the process of booking shows for your artist in the Popmundo game. It handles tour planning, conflict detection, and automatic booking based on your specified preferences.
Key Features
- Automated Tour Planning: Creates an optimized tour itinerary based on your preferences
- Upcoming Show Detection: Scans your existing bookings to avoid conflicts
- Smart Club Selection: Chooses the best clubs based on price, availability, and ratings
- Flexible Configuration: Customizable settings for dates, times, cities, and financial targets
- Visual Interface: Easy-to-use control panel integrated into the game interface
- Data Management: Import/export configurations and preview tour plans
Installation Instructions
- Install the Tampermonkey extension for your browser
- Create a new userscript and paste the provided code
- Save the script and ensure it's enabled
- Navigate to the Popmundo Book Show or Upcoming Performances page
User Interface Guide
Control Panel Elements
The script adds a control panel to the top of Popmundo pages with these sections:
Basic Settings:
- Artist ID: Your artist's unique identifier
- Start City: Where your tour begins
- Shows Per City: Number of performances in each city
- Shows Per Date: Maximum shows per day
Date Range:
- Start Date: When your tour begins
- Final Date: When your tour ends
Financial Targets:
- Club Price Range: Minimum and maximum payment requirements
Show Preferences:
- Show Times: Select one or multiple preferred performance times
- Require 5 Stars: Only book at 5-star venues
- Block same city/day: Prevent multiple shows in same city on same day
Club Selection Priority:
- Price: Largest → Smallest
- Price: Smallest → Largest
- Closest to Target Midpoint
Control Buttons
- Start Booker: Begin the automated booking process
- Stop Booker: Halt the process and clear data
- Preview Route: View the generated tour itinerary
- Preview Filtered Route: See tour after removing conflicts
- View Upcoming JSON: Examine your existing bookings
- Configuration Tools: Copy, download, load, or paste settings
How It Works
Tour Planning
The script uses a predefined itinerary that travels through 40+ cities worldwide. It calculates:
- Optimal routing between cities
- Travel time considerations
- Show frequency based on your settings
- Date and time slot availability
Conflict Detection
The script scans your existing upcoming shows to avoid:
- Double-booking the same time slot
- Booking multiple shows in the same city on the same day
- Exceeding your specified shows-per-date limit
Club Selection Algorithm
When booking a show, the script:
- Filters clubs based on your criteria (star rating, price range)
- Checks availability (remaining slots)
- Applies your selected sorting method
- Attempts booking from best to worst option
- Handles errors and dialog boxes automatically
Configuration Options
Default Settings
The script comes with sensible defaults:
- Initial City: São Paulo
- Show Times: 14:00:00 and 22:00:00
- Shows Per City: 1
- Shows Per Date: 1
- Target Club Range: $80M to $1500M
- Requires 5-star venues
- Blocks multiple same-city same-day shows
Customization
You can adjust all settings through the UI or by importing JSON configurations. The script saves your preferences between sessions.
Usage Instructions
Preparation:
- Navigate to the Book Show page for your artist
- Ensure you have sufficient funds for travel and bookings
Configuration:
- Set your desired parameters using the control panel
- Use "Preview Route" to verify your itinerary
- Check "Preview Filtered Route" to see actual available slots
Execution:
- Click "Start Booker" to begin automated booking
- Monitor progress through the status indicator
- The script will handle all navigation and form submissions
Completion:
- The script will stop when the tour is complete
- Use "Stop Booker" to manually halt the process
- All data is cleared when the process stops
Troubleshooting
Common Issues
Script not loading:
- Verify Tampermonkey is installed and enabled
- Check that the script is enabled in Tampermonkey dashboard
- Ensure you're on a supported Popmundo page
Bookings failing:
- Verify your artist ID is correct
- Check that you have available booking slots
- Ensure your financial targets are realistic
UI not appearing:
- Refresh the page
- Check browser console for errors (F12)
Error Messages
- "City not found in dropdown": The script couldn't locate your specified city
- "No candidate clubs": No venues matched your criteria
- "Booking error detected": Popmundo rejected the booking request
Technical Details
Browser Compatibility
Works with most modern browsers that support Tampermonkey:
- Chrome
- Firefox
- Edge
- Opera
Data Storage
The script uses:
- localStorage: For tour data and settings persistence
- sessionStorage: For current operation state
- No data is sent to external servers
Performance Considerations
- The script includes delays to avoid overwhelming the game server
- Complex tours with many cities may take significant time to process
- The iframe-based upcoming shows scanner may be blocked by strict browser settings
Predefined Itinerary
The script includes a comprehensive tour route covering:
- South America: Rio de Janeiro, São Paulo, Buenos Aires
- North America: Mexico City, Los Angeles, Seattle, Chicago, Nashville, Toronto, Montreal, New York
- Europe: London, Brussels, Paris, Barcelona, Madrid, Porto, Milan, Rome, Budapest, Belgrade, Dubrovnik, Sarajevo, Bucharest, Sofia, Istanbul, Izmir, Antalya, Ankara, Baku, Kyiv, Moscow, Tallinn, Stockholm, Vilnius, Warsaw, Berlin, Copenhagen, Tromsø, Helsinki, Glasgow, Amsterdam
- Asia: Singapore, Jakarta, Shanghai, Manila
- Oceania: Melbourne
- Africa: Johannesburg
Advanced Usage
JSON Configuration
For power users, the script supports full JSON configuration:
{
"ARTIST_ID": "2786249",
"INITIAL_CITY": "são paulo",
"INITIAL_DATE": "2023-11-15",
"FINAL_DATE": "2023-12-15",
"SHOW_TIMES": ["14:00:00", "22:00:00"],
"SHOWS_PER_CITY": 1,
"SHOWS_PER_DATE": 1,
"BLOCK_TWO_SHOWS_IN_CITY_AT_SAME_DATE": true,
"TARGET_CLUB_RANGE": {
"min": 80,
"max": 1500
},
"REQUIRE_5_STARS": true,
"SORT_MODE": "price_desc"
}
Manual Intervention
You can pause the script at any time by clicking "Stop Booker". Your progress will be saved until you manually clear it.
Disclaimer
This script is designed for personal use and should be used in accordance with Popmundo's terms of service. Use responsibly and avoid excessive booking that might impact game balance.
Support
For issues or questions, check the script comments for author information or seek help from the Popmundo player community.
Version History
- 10.1.1: Fixed upcoming shows parsing to handle various date/time formats
- Enhanced city matching with accent-insensitive comparison
- Improved error handling and recovery
- Added comprehensive configuration management
This documentation covers the core functionality of the Popmundo Itinerary Booker script. For the most current information, refer to the comments in the script itself.
