☰

πŸ“œ Guide

Popmundo quest guide β€” guide mode, step navigation, log and timer.

You will need to install an extension such as Tampermonkey, Greasemonkey or Violentmonkey to install this script.

You will need to install an extension such as Tampermonkey to install this script.

You will need to install an extension such as Tampermonkey or Violentmonkey to install this script.

You will need to install an extension such as Tampermonkey or Userscripts to install this script.

You will need to install an extension such as Tampermonkey to install this script.

You will need to install a user script manager extension to install this script.

(I already have a user script manager, let me install it!)

You will need to install an extension such as Stylus to install this style.

You will need to install an extension such as Stylus to install this style.

You will need to install an extension such as Stylus to install this style.

You will need to install a user style manager extension to install this style.

You will need to install a user style manager extension to install this style.

You will need to install a user style manager extension to install this style.

(I already have a user style manager, let me install it!)

Author
Luke James gibson
Daily installs
3
Total installs
8
Ratings
0 0 0
Version
2.1
Created
2026-03-04
Updated
2026-03-11
Size
101 KB
License
MIT
Applies to

πŸ“œ Guide v2.1 β€” Popmundo Quest Helper

A quest tracking, step management and route recording tool for Popmundo.


πŸ“¦ Installation

1. Browser Extension

First install Tampermonkey:

Browser Link
Chrome https://tampermonkey.net/?browser=chrome
Firefox https://tampermonkey.net/?browser=firefox

Then:

  1. Install Tampermonkey
  2. Open the GreasyFork script page
  3. Click Install
  4. The script updates automatically

2. Mobile Usage

Android:

  • Kiwi Browser + Tampermonkey extension (recommended)
  • Firefox + Tampermonkey extension

iPhone / iPad:

  • Userscripts app (Safari)
  • Other userscript-compatible browsers

✨ Features

🧭 Compass Panel

A floating panel that opens automatically on map pages (/Locale/Compass).

  • Active quest and progress display (57/156 step counter format)
  • Large action button for the current step β€” click to execute
  • Preview of the next 5 steps
  • ← Back / Forward β†’ buttons for manual step navigation
  • Jump to any checkpoint from the dropdown
  • Stop / Skip mode: confirm each step or advance automatically
  • Color-coded recent event log (last 20 entries)
  • Travel timer with alert when passage time expires
  • Route recording mode (save a traveled path as a quest)
  • Draggable panel (position is saved)

⊑ Compact Mode

The ⊑ button in the header switches the panel to a compact 200px layout.

  • Quest dropdown + step counter on one line
  • Large action button
  • ← Back / Forward β†’ buttons
  • Ideal when screen space is limited (especially on mobile)
  • Return to normal mode with β›Ά
  • Compact mode preference is saved

✏️ Quest Edit

When a quest is active, a ✏️ button appears in the normal-mode header.

  • Edit the active quest's name and full text directly
  • Parse button for step validation and error checking
  • Save / Cancel buttons

πŸ“‹ Admin Panel

Opens when the float button is clicked on non-map pages. Contains 4 tabs:

Characters tab:

  • All characters' quest and progress status at a glance
  • Per-character quest assignment and reset
  • Note field per character
  • Bulk quest assignment

Quests tab:

  • Quest list: edit, copy, delete
  • New quest creation form
  • Parse button for syntax checking
  • Import (plain text or JSON) / Export

Log tab:

  • Last 150 events per character
  • Color-coded event types (error, checkpoint, move, travel…)
  • Copy and clear log

Settings tab:

  • Language selection (TR / EN / PT-BR)
  • Connection info

πŸ”Š Alert System

  • Sound + browser notification when travel time expires
  • Repeats every minute (up to 5 times)
  • Mute button (1 hour silence)
  • Synchronized across tabs/characters via localStorage

πŸ—ΊοΈ Route Recording Mode

  • Started by selecting πŸ—Ί New Map from the quest dropdown
  • All movements and item uses are recorded automatically
  • Save the recording as a named quest in the database

πŸ”Œ PopControl Integration

Automatically connects if the PopControl extension is installed.

  • Guide button appears in the PopControl bar
  • Float button is hidden when connected
  • Closing Guide from PopControl closes the panel but keeps the connection

πŸ“ Quest Format and Commands

Quest text is written as plain text. Each line is a step. Lines starting with # are comments and are ignored.

Full Command Reference

Command Description Example
move Direction step move North SouthEast East
use_item Use an 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 β€” can jump back to checkpoint ENTRANCE
`require Item \ Description` Required item warning (shown every time)
`info Text \ Link` One-time information message
`goto Place Name \ LocID` Direct navigation link to a locale
branch Dir -> CHECKPOINT Conditional branch β€” jump if direction is active branch West -> GO_BACK
# Comment Comment line β€” not counted as a step # Watch out here!

Short direction codes are supported: N=North, S=South, E=East, W=West, NE=NorthEast, SW=SouthWest, U=Up, D=Down

Turkish short codes: K=North, G=South, D=East, B=West, KD=NorthEast, GB=SouthWest, Y=Up, A=Down

Portuguese directions: Norte, Sul, Leste, Oeste, Nordeste, Sudeste etc.


πŸ“– Example Quest

# North Pole β€” Example
require Winter Clothing | Required for protection against cold
info This quest has three sections: Cave β†’ Mountain β†’ Blizzard | /Forum/...

# Go to starting location
goto North Pole Entrance | 1234567

# Section 1: Ice Caverns
checkpoint ICY_ENTRANCE
move North SouthEast East NorthEast
passage 16min

checkpoint ICY_PATH_START
move East SouthEast South
use_item hole @ Icy Caverns

# Section 2: Mountain
checkpoint ICEPEAK_ENTRANCE
move SouthWest West NorthWest West
passage 16min

checkpoint ICEPEAK_PATH_START
move NorthWest Up NorthWest Up
use_item ? @ Icepeak Mountain

# Branch: take shortcut if West is active
branch West -> ICY_ENTRANCE

βš™οΈ Panel Usage

Compass Panel β€” Buttons

Button Function
Forward β†’ (large button) Execute current step
← Back Go to previous step
Forward β†’ (bottom button) Advance to next step (without executing)
Stop / Skip Toggle step confirmation mode
↩ Go Jump to selected checkpoint
⊑ / β›Ά Toggle compact mode
✏️ Edit active quest
ℹ️ Show quest info notes
Admin Open admin panel
Reset Reset character's step and quest data
Γ— Close panel (for this page visit only)

Log Entry Colors

Color Type
🟑 Yellow Item used
🟣 Purple Checkpoint
πŸ”΅ Blue Travel / wait
πŸ”΄ Red Error
⬜ White Movement
🩡 Light blue Manual movement

πŸ—ΊοΈ Direction Reference

Code Direction
N / K North
S / G South
E / D East
W / B West
NE / KD NorthEast
NW / KB NorthWest
SE / GD SouthEast
SW / GB SouthWest
U / Y Up
D / A Down

❓ FAQ / Troubleshooting

Script is not loading. Make sure Tampermonkey is active. Refresh the page. Check that you are on a popmundo.com URL.

Compass panel is not showing. The panel only opens automatically on /Locale/Compass pages. Click the float button (πŸ—ΊοΈ) or open it via PopControl.

I closed the panel and it won't reopen. Closing with Γ— prevents the panel from reopening on the same page β€” this is intentional. Use the float button or PopControl button to reopen.

Getting "item not found" errors. The item name in the quest text may not exactly match the page. The script now also searches the item's subtitle (e.g. "Blinding Blizzard"). If still not found, a selection list will appear.

Alert keeps sounding. Click πŸ”‡ in the passage dialog or the Mute button in the panel. Muted for 1 hour.

Not working on mobile. Kiwi Browser + Tampermonkey is recommended for Android. Firefox mobile also works. On iPhone try the Userscripts app.

PopControl connection issue. It reconnects automatically after a page reload. If the float button is visible, the connection is lost.


πŸ“‹ Changelog

v2.1

  • Fixed SVG direction clicking (Tampermonkey sandbox compatibility)
  • Added compact panel mode (200px, mobile-friendly)
  • Added Quest Edit button (✏️ β€” direct access from compass)
  • Added goto command (direct navigation link)
  • Improved item matching: subtitle is now also searched
  • Single item on page is used directly, ignoring location mismatch
  • Selection list shows "Name β€” Subtitle" format
  • Progress display changed from % to 57/156 format
  • "Other directions" label corrected
  • Panel no longer auto-reopens for 5 seconds after closing with Γ—
  • ❄️ North Pole quest name updated

v2.0

  • Added require and info commands
  • PopControl integration
  • 7 built-in quests (North Pole, Antenora, Depths of the Sea, Unholy Diver, Nautilus Team, Kraken Team, Mosaic Miracles, Nec Plus Ultra)
  • Route recording mode
  • Multilingual interface (TR/EN/PT-BR)

🏷️ GreasyFork Release Notes β€” v2.1

  • Fix: SVG direction clicking now works correctly in Tampermonkey sandbox mode
  • New: Compact panel mode β€” ideal for mobile use
  • New: goto command β€” direct locale navigation link in quest text
  • New: ✏️ Quest Edit button β€” one-click access from the compass panel
  • Improvement: Item matching now searches subtitles; single item is used directly
  • Improvement: Progress counter in 57/156 format
  • Improvement: Panel no longer auto-reopens after being closed with Γ—