Módulo central para gerenciar todos os scripts do Popmundo
# 🛠️ PopControl — v1.4
> O módulo central que permite gerenciar todos os scripts do Popmundo a partir de um único painel.
---
## 📦 Instalação
### Extensão do Navegador
O **Tampermonkey** deve estar instalado primeiro:
- 🌐 Chrome: [tampermonkey.net/?browser=chrome](https://tampermonkey.net/?browser=chrome)
- 🦊 Firefox: [tampermonkey.net/?browser=firefox](https://tampermonkey.net/?browser=firefox)
**Passos:**
1. Instale o Tampermonkey no seu navegador
2. Abra [Greasyfork — PopControl](https://greasyfork.org/tr/scripts/569102-popcontrol)
3. Clique em **Install**
4. O script se atualiza automaticamente
> ⚠️ O PopControl deve carregar **antes** de todos os outros scripts. No Tampermonkey → Dashboard, arraste o PopControl para o topo da lista.
### Uso no Celular
| Plataforma | Opção |
|------------|-------|
| Android | Kiwi Browser + Tampermonkey |
| Android | Firefox + extensão Tampermonkey |
| iPhone | Orion Browser ou app UserScripts |
---
## ✨ Funcionalidades
### Barra Central de Scripts
- Agrupa os botões de todos os scripts conectados em uma única barra
- Posição da barra configurável: **Baixo / Cima / Esquerda / Direita**
- Ordem dos botões alterável por **arrastar e soltar** (mouse no desktop + toque no celular)
- Quando um script se conecta, ele oculta sua própria interface; todos os controles vão para a barra do PopControl
- Desativar um script (toggle OFF) retorna o script à sua interface independente
- Atalho de teclado **Alt+P** oculta/exibe a barra silenciosamente
### Painel de Configurações
- Botão **📖 Leia-me** — acesso direto ao guia de uso
- Seletor de posição da barra (4 posições)
- Seletor de idioma: 🇹🇷 Turco / 🇬🇧 Inglês / 🇧🇷 Português
- Botão **🌍 Customize** — sistema de idioma personalizado
- Personalização de cores: fundo da barra + cor do texto (paleta predefinida + entrada hex + visualização ao vivo)
- Lista de scripts conectados com toggle ativar/desativar
- Dica de ordenação de botões
### 🌍 Sistema de Idioma Personalizado (Customize)
- **Export:** Copia as strings em inglês de todos os scripts conectados + prompt de IA para a área de transferência
- **Import:** Cole o JSON traduzido para atualizar a interface de todos os scripts simultaneamente
- **Reset:** Limpa todas as traduções personalizadas e restaura o idioma padrão
- Dados armazenados em `localStorage` (sem limite de tamanho)
- 💡 [Google Gemini](https://gemini.google.com) é recomendado para melhores resultados
- O pill Customize é destacado automaticamente quando há tradução ativa
### Integração de Scripts
- Scripts se conectam automaticamente ao carregar a página (em ~6 segundos)
- Se a conexão falhar, o script volta à sua interface independente
- Estado ativo/inativo preservado em todos os servidores (domínio `.popmundo.com`)
- Ordem dos botões preservada em todos os servidores (73/74/75)
---
## 🚀 Como Usar
### Configurar Posição da Barra
1. Clique no botão **⚙️** de configurações na barra
2. Escolha uma posição em **Posição**
3. A página recarrega automaticamente
### Reordenar Botões
- **Desktop:** Arraste e solte os botões
- **Celular:** Pressione longo + arraste
### Configurar Idioma Personalizado
1. Configurações → **🌍 Customize**
2. Clique em **📋 Copy Export JSON + Prompt**
3. Abra [Google Gemini](https://gemini.google.com) e cole
4. Especifique o idioma alvo (ex: *"Español"*)
5. Copie o JSON retornado pelo Gemini
6. Cole no campo **Import** do Customize
7. Clique em **✅ Apply & Reload** — todos os scripts mudam de idioma instantaneamente
### Desativar um Script
1. Abra o painel de configurações
2. Desative o toggle do script na lista
3. O script não será executado no próximo carregamento
---
## ⚙️ Opções
| Configuração | Descrição |
|-------------|-----------|
| Posição da Barra | Baixo / Cima / Esquerda / Direita |
| Idioma | TR / EN / PT-BR / Customize |
| Cor da Barra | Paleta predefinida ou hex personalizado |
| Cor do Texto | Paleta predefinida ou hex personalizado |
| Toggle de Script | Ativar/desativar independente por script |
| Ordem dos Botões | Arrastar e soltar, salvo permanentemente |
---
## ❓ Solução de Problemas
**A barra não aparece.**
→ Atualize a página. Certifique-se de que o PopControl carrega antes de todos os outros scripts.
**Scripts não estão se conectando.**
→ No Tampermonkey Dashboard, mova o PopControl para o topo da lista.
**Alt+P não funciona.**
→ Clique em algum lugar da página (foco necessário) e tente novamente.
**Idioma personalizado não aparece.**
→ Aguarde o recarregamento completo após o Import. Todos os scripts precisam estar carregados durante o Export.
---
## 📋 Histórico de Versões
### v1.4
- 🌍 Sistema de idioma Customize adicionado (Export / Import / Reset)
- "🌍 Customize" adicionado como 4º pill na linha de idioma
- Traduções movidas para `localStorage`
- Recomendação e link do Google Gemini adicionados
- Botões antigos de Export/Import removidos do painel de configurações
### v1.3
- Botão 📖 Leia-me movido para o topo do painel de configurações
- Campo `strings` adicionado ao registro de scripts
### v1.2
- Personalização de cores com visualização ao vivo
- Reordenação de botões por arrastar e soltar
- 4 posições de barra
- Atalho Alt+P
- Toggle de ativar/desativar por script
---
## 🏷️ Notas de Versão Greasyfork — v1.4
- Sistema de idioma personalizado: fluxo Export → tradução IA → Import
- Corrigido: limite de cookie causava falha em scripts grandes — movido para `localStorage`
- Painel Customize consolidado; tela de configurações simplificada
- Recomendação do Google Gemini adicionada
