📜 Guide

Guia de quests do Popmundo — modo guia, navegação por etapas, log e timer.

Você precisará instalar uma extensão como Tampermonkey, Greasemonkey ou Violentmonkey para instalar este script.

Você precisará instalar uma extensão como Tampermonkey para instalar este script.

Você precisará instalar uma extensão como Tampermonkey ou Violentmonkey para instalar este script.

Você precisará instalar uma extensão como Tampermonkey ou Userscripts para instalar este script.

Você precisará instalar uma extensão como o Tampermonkey para instalar este script.

Você precisará instalar um gerenciador de scripts de usuário para instalar este script.

(Eu já tenho um gerenciador de scripts de usuário, me deixe instalá-lo!)

Você precisará instalar uma extensão como o Stylus para instalar este estilo.

Você precisará instalar uma extensão como o Stylus para instalar este estilo.

Você precisará instalar uma extensão como o Stylus para instalar este estilo.

Você precisará instalar um gerenciador de estilos de usuário para instalar este estilo.

Você precisará instalar um gerenciador de estilos de usuário para instalar este estilo.

Você precisará instalar um gerenciador de estilos de usuário para instalar este estilo.

(Eu já possuo um gerenciador de estilos de usuário, me deixar fazer a instalação!)

Autor
Luke James gibson
Instalações hoje
2
Total de instalações
9
Avaliações
0 0 0
Versão
2.1
Criado
04/03/2026
Atualizado
11/03/2026
Tamanho
101 KB
Licença
MIT
Aplicável a

📜 Guide v2.1 — Assistente de Quests do Popmundo

Ferramenta de acompanhamento de quests, gerenciamento de etapas e gravação de rotas para o Popmundo.


📦 Instalação

1. Extensão do Navegador

Primeiro instale o Tampermonkey:

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

Em seguida:

  1. Instale o Tampermonkey
  2. Abra a página do script no GreasyFork
  3. Clique em Install
  4. O script se atualiza automaticamente

2. Uso em Dispositivos Móveis

Android:

  • Kiwi Browser + extensão Tampermonkey (recomendado)
  • Firefox + extensão Tampermonkey

iPhone / iPad:

  • Aplicativo Userscripts (Safari)
  • Outros navegadores com suporte a userscripts

✨ Funcionalidades

🧭 Painel da Bússola

Um painel flutuante que abre automaticamente nas páginas de mapa (/Locale/Compass).

  • Quest ativa e progresso exibidos no formato 57/156
  • Botão de ação grande para a etapa atual — clique para executar
  • Prévia das próximas 5 etapas
  • Botões ← Voltar / Avançar → para navegação manual de etapas
  • Pular para qualquer checkpoint pelo menu suspenso
  • Modo Parar / Pular: confirmar cada etapa ou avançar automaticamente
  • Log colorido dos últimos 20 eventos
  • Temporizador de viagem com alerta quando o tempo de passage expira
  • Modo de gravação de rota (salvar caminho percorrido como quest)
  • Painel arrastável (posição salva)

⊡ Modo Compacto

O botão no cabeçalho muda o painel para um layout compacto de 200px.

  • Menu suspenso de quest + contador de etapas em uma linha
  • Botão de ação grande
  • Botões ← Voltar / Avançar →
  • Ideal quando o espaço de tela é limitado (especialmente no celular)
  • Retorne ao modo normal com
  • Preferência de modo compacto é salva

✏️ Editar Quest

Quando uma quest está ativa, um botão ✏️ aparece no cabeçalho do modo normal.

  • Edite o nome e o texto completo da quest ativa diretamente
  • Botão Parse para validação de etapas e verificação de erros
  • Botões Salvar / Cancelar

📋 Painel Administrativo

Abre ao clicar no botão flutuante em páginas fora do mapa. Contém 4 abas:

Aba Personagens:

  • Status de quest e progresso de todos os personagens
  • Atribuição e reset de quest por personagem
  • Campo de notas por personagem
  • Atribuição em massa de quest

Aba Quests:

  • Lista de quests: editar, copiar, excluir
  • Formulário para criar nova quest
  • Botão Parse para verificação de sintaxe
  • Import (texto simples ou JSON) / Export

Aba Log:

  • Últimos 150 eventos por personagem
  • Tipos de evento coloridos (erro, checkpoint, movimento, viagem…)
  • Copiar e limpar log

Aba Configurações:

  • Seleção de idioma (TR / EN / PT-BR)
  • Informações de conexão

🔊 Sistema de Alertas

  • Som + notificação do navegador quando o tempo de viagem expira
  • Repete a cada minuto (até 5 vezes)
  • Botão de silenciar (1 hora)
  • Sincronizado entre abas/personagens via localStorage

🗺️ Modo de Gravação de Rota

  • Iniciado selecionando 🗺 Novo Mapa no menu suspenso de quests
  • Todos os movimentos e usos de itens são gravados automaticamente
  • Salve a gravação como uma quest nomeada no banco de dados

🔌 Integração com PopControl

Conecta automaticamente se a extensão PopControl estiver instalada.

  • Botão do Guide aparece na barra do PopControl
  • Botão flutuante fica oculto quando conectado
  • Fechar o Guide pelo PopControl fecha o painel mas mantém a conexão

📝 Formato de Quest e Comandos

O texto da quest é escrito em texto simples. Cada linha é uma etapa. Linhas começando com # são comentários e são ignoradas.

Referência Completa de Comandos

Comando Descrição Exemplo
move Etapa de direção move North SouthEast East
use_item Usar um item use_item Submarino
use_item ? @ Local Usar qualquer item no local use_item ? @ Icy Caverns
use_item Nome @ Local Usar item específico no local use_item buraco @ Icy Caverns
try_item Usar item se presente, pular se não try_item Tanque de Oxigênio
passage Xmin Tempo de espera de viagem passage 16min
wait Xmin Tempo de espera geral wait 30min
checkpoint LABEL Marcador de localização — pode retornar checkpoint ENTRADA
`require Item \ Descrição` Aviso de item necessário (sempre exibido)
`info Texto \ Link` Mensagem informativa única
`goto Nome do Local \ LocID` Link de navegação direta para um local
branch Dir -> CHECKPOINT Desvio condicional — pula se a direção está ativa branch West -> VOLTAR
# Comentário Linha de comentário — não conta como etapa # Atenção aqui!

Códigos curtos de direção são suportados: N=Norte, S=Sul, L/E=Leste, O/W=Oeste, NE=Nordeste, SO/SW=Sudoeste, U=Cima, D=Baixo

Direções em português: Norte, Sul, Leste, Oeste, Nordeste, Sudeste, Cima, Baixo, Acima, Abaixo etc.


📖 Exemplo de Quest

# Polo Norte — Exemplo
require Roupa de Inverno | Necessária para proteção contra o frio
info Esta quest tem três seções: Caverna → Montanha → Nevasca | /Forum/...

# Ir para o local inicial
goto Entrada do Polo Norte | 1234567

# Seção 1: Cavernas de Gelo
checkpoint ICY_ENTRANCE
move North SouthEast East NorthEast
passage 16min

checkpoint ICY_PATH_START
move East SouthEast South
use_item buraco @ Icy Caverns

# Seção 2: Montanha
checkpoint ICEPEAK_ENTRANCE
move SouthWest West NorthWest West
passage 16min

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

# Desvio: atalho se Oeste estiver ativo
branch West -> ICY_ENTRANCE

⚙️ Uso do Painel

Painel da Bússola — Botões

Botão Função
Avançar → (botão grande) Executar etapa atual
← Voltar Ir para etapa anterior
Avançar → (botão inferior) Avançar para próxima etapa (sem executar)
Parar / Pular Alternar modo de confirmação de etapa
↩ Ir Pular para checkpoint selecionado
/ Alternar modo compacto
✏️ Editar quest ativa
ℹ️ Mostrar notas de informação da quest
Admin Abrir painel administrativo
Reset Resetar dados de etapa e quest do personagem
× Fechar painel (apenas para esta visita)

Cores das Entradas do Log

Cor Tipo
🟡 Amarelo Item usado
🟣 Roxo Checkpoint
🔵 Azul Viagem / espera
🔴 Vermelho Erro
⬜ Branco Movimento
🩵 Azul claro Movimento manual

🗺️ Referência de Direções

Código Direção
N / Norte North
S / Sul South
L / E / Leste East
O / W / Oeste West
NE / Nordeste NorthEast
NO / NW / Noroeste NorthWest
SE / Sudeste SouthEast
SO / SW / Sudoeste SouthWest
U / Cima / Acima Up
D / Baixo / Abaixo Down

❓ Perguntas Frequentes / Solução de Problemas

O script não está carregando. Certifique-se de que o Tampermonkey está ativo. Atualize a página. Verifique se você está em uma URL do popmundo.com.

O painel da bússola não aparece. O painel só abre automaticamente em páginas /Locale/Compass. Clique no botão flutuante (🗺️) ou abra pelo PopControl.

Fechei o painel e ele não reabre. Fechar com × impede que o painel reabra na mesma página — isso é intencional. Use o botão flutuante ou o botão PopControl para reabrir.

Recebo erros de "item não encontrado". O nome do item no texto da quest pode não corresponder exatamente à página. O script agora também busca no subtítulo do item (ex: "Blinding Blizzard"). Se ainda não encontrado, uma lista de seleção aparecerá.

O alerta continua tocando. Clique em 🔇 no diálogo de passage ou no botão Mudo no painel. Silenciado por 1 hora.

Não funciona no celular. Kiwi Browser + Tampermonkey é recomendado para Android. Firefox mobile também funciona. No iPhone, experimente o aplicativo Userscripts.

Problema de conexão com o PopControl. Reconecta automaticamente após recarregar a página. Se o botão flutuante estiver visível, a conexão foi perdida.


📋 Histórico de Versões

v2.1

  • Corrigido clique em direções SVG (compatibilidade com sandbox do Tampermonkey)
  • Adicionado modo compacto de painel (200px, amigável para celular)
  • Adicionado botão Editar Quest (✏️ — acesso direto da bússola)
  • Adicionado comando goto (link de navegação direta)
  • Melhoria na correspondência de itens: subtítulo também é pesquisado
  • Item único na página é usado diretamente, ignorando incompatibilidade de local
  • Lista de seleção exibe formato "Nome — Subtítulo"
  • Progresso mudou de % para formato 57/156
  • Rótulo de "outras direções" corrigido
  • Painel não reabre automaticamente por 5 segundos após fechar com ×
  • Nome da quest ❄️ North Pole atualizado

v2.0

  • Comandos require e info adicionados
  • Integração com PopControl
  • 7 quests embutidas (Polo Norte, Antenora, Segredos das Profundezas, Unholy Diver, Equipe Nautilus, Equipe Kraken, Maravilhas em Mosaico, Nec Plus Ultra)
  • Modo de gravação de rota
  • Interface multilíngue (TR/EN/PT-BR)

🏷️ Notas de Lançamento GreasyFork — v2.1

  • Correção: Clique em direções SVG agora funciona corretamente no modo sandbox do Tampermonkey
  • Novo: Modo compacto do painel — ideal para uso em dispositivos móveis
  • Novo: Comando goto — link de navegação direta no texto da quest
  • Novo: Botão ✏️ Editar Quest — acesso com um clique pelo painel da bússola
  • Melhoria: Correspondência de itens agora busca subtítulos; item único é usado diretamente
  • Melhoria: Contador de progresso no formato 57/156
  • Melhoria: Painel não reabre automaticamente após ser fechado com ×