# 🗺️ GoldenOT Minimap Installer - Professional Edition

## 📋 Sobre o Instalador

Este é um instalador profissional e temático para adicionar o minimap completo ao cliente GoldenOT. Desenvolvido com interface visual inspirada no Tibia, proporcionando uma experiência imersiva durante a instalação.

---

## ✨ Características

### 🎨 Visual e Interface
- **Logo ASCII Art** do GoldenOT em alta qualidade
- **Arte do Personagem** (Golden Knight Level 999) com detalhes
- **Barras de Progresso Animadas** com preenchimento suave
- **Cores Dinâmicas** que mudam conforme as etapas
- **Layout Profissional** com bordas e alinhamento perfeito
- **Ícones Temáticos** do Tibia (⚔️ 🗡️ 🛡️ 🏰 etc)

### 🔧 Funcionalidades Técnicas
- ✅ Detecção automática do cliente GoldenOT
- ✅ Verificação de arquivos necessários
- ✅ Criação automática de pasta AppData
- ✅ Backup automático do minimap antigo
- ✅ Tratamento robusto de erros
- ✅ Mensagens descritivas em cada etapa
- ✅ Abertura automática do cliente ao finalizar

### 🛡️ Segurança
- 🔒 Backup automático antes de sobrescrever
- 🔒 Verificação de permissões
- 🔒 Tratamento de erros com mensagens claras
- 🔒 Não modifica arquivos do sistema

---

## 📁 Estrutura de Arquivos

```
GoldenOT/
├── GoldenOT_dx.exe              (Cliente principal)
├── GoldenOT_gl.exe
└── TUTORIAL - INSTALAR MINIMAP/
    ├── INSTALAR_MINIMAP.bat     (Instalador)
    ├── minimap.otmm             (Arquivo do minimap)
    └── README.md                (Este arquivo)
```

---

## 🚀 Como Usar

### Passo 1: Preparação
1. Certifique-se de que o arquivo `minimap.otmm` está nesta pasta
2. Verifique se `GoldenOT_dx.exe` está na pasta pai

### Passo 2: Executar
1. Dê **duplo clique** em `INSTALAR_MINIMAP.bat`
2. Aguarde a tela inicial carregar
3. Pressione **qualquer tecla** para iniciar

### Passo 3: Acompanhar
O instalador vai:
1. ✅ **[STEP 1/4]** Procurar o cliente GoldenOT
2. ✅ **[STEP 2/4]** Verificar o arquivo minimap.otmm
3. ✅ **[STEP 3/4]** Iniciar o cliente por 10 segundos (cria pasta)
4. ✅ **[STEP 4/4]** Verificar e criar pasta de configuração
5. ✅ **[FINAL]** Instalar o minimap e fazer backup

### Passo 4: Concluir
- Pressione qualquer tecla para abrir o cliente
- O minimap completo estará ativo!

---

## 📍 Localização Final

O minimap será instalado em:
```
C:\Users\[SeuUsuário]\AppData\Roaming\OTClientV8\GoldenOT\minimap.otmm
```

---

## 🔄 Backup Automático

Se você já tinha um minimap, o instalador cria um backup:
```
minimap_backup_YYYYMMDD_HHMMSS.otmm
```

Exemplo: `minimap_backup_20250930_153045.otmm`

---

## ❌ Solução de Problemas

### Erro: "CLIENT NOT FOUND"
**Causa:** O arquivo `GoldenOT_dx.exe` não foi encontrado

**Solução:**
- Verifique se o cliente está na pasta correta
- Estrutura deve ser:
  ```
  GoldenOT/GoldenOT_dx.exe
  GoldenOT/TUTORIAL - INSTALAR MINIMAP/INSTALAR_MINIMAP.bat
  ```

### Erro: "MINIMAP FILE NOT FOUND"
**Causa:** O arquivo `minimap.otmm` não está na pasta do instalador

**Solução:**
- Coloque o arquivo `minimap.otmm` na pasta `TUTORIAL - INSTALAR MINIMAP`

### Erro: "FOLDER CREATION FAILED"
**Causa:** Falta de permissões ou antivírus bloqueando

**Solução:**
1. Execute como **Administrador** (clique direito → Executar como administrador)
2. Desative temporariamente o antivírus
3. Verifique permissões na pasta AppData

---

## 🎯 Etapas do Instalador

### Etapa 1: Splash Screen
- Logo do GoldenOT
- Arte do personagem
- Informações sobre o que será instalado
- Aguarda confirmação do usuário

### Etapa 2: Verificação de Arquivos
- Procura `GoldenOT_dx.exe`
- Procura `minimap.otmm`
- Mostra tamanho dos arquivos
- Barra de progresso animada

### Etapa 3: Inicialização do Cliente
- Abre o cliente por 10 segundos
- Cria pasta de configuração automaticamente
- Contagem regressiva visual
- Fecha o cliente automaticamente

### Etapa 4: Verificação de Pasta
- Verifica se a pasta AppData foi criada
- Cria manualmente se necessário
- Confirma permissões de escrita

### Etapa 5: Instalação
- Faz backup do minimap antigo (se existir)
- Copia o novo minimap
- Verifica sucesso da operação
- Mostra informações do arquivo instalado

### Etapa 6: Finalização
- Tela de sucesso com detalhes
- Dicas úteis
- Opção de abrir o cliente
- Cliente abre automaticamente

---

## 🎨 Cores Utilizadas

| Cor | Etapa | Significado |
|-----|-------|-------------|
| 🟡 Amarelo | Splash Screen | Bem-vindo |
| 🔵 Azul Claro | Verificação | Checando arquivos |
| 🟢 Verde | Inicialização | Processando |
| 🟡 Amarelo | Verificação Pasta | Configurando |
| 🟣 Roxo | Instalação | Copiando arquivos |
| 🟢 Verde | Sucesso | Concluído |
| 🔴 Vermelho | Erro | Problema detectado |

---

## 🛠️ Detalhes Técnicos

### Tecnologias
- **Batch Script** com `EnableDelayedExpansion`
- **Codepage UTF-8** para suporte a caracteres especiais
- **Modo Console** 85x42 para layout otimizado

### Variáveis Principais
```batch
PASTA_ATUAL          - Diretório do instalador
PASTA_CLIENT         - Diretório do cliente
CLIENT_EXE           - Caminho do executável
MINIMAP_ORIGEM       - Arquivo minimap.otmm
APPDATA_DESTINO      - Pasta de destino no AppData
```

### Funções
- `SPLASH_SCREEN` - Tela inicial
- `CHECK_FILES` - Verificação de arquivos
- `INIT_CLIENT` - Inicialização do cliente
- `VERIFY_FOLDER` - Verificação de pastas
- `INSTALL_MINIMAP` - Instalação
- `SUCCESS_SCREEN` - Tela de sucesso
- `PROGRESS_BAR` - Barra de progresso
- `ERROR_SCREEN` - Tela de erro

---

## 📦 O Que o Minimap Inclui

Após a instalação, você terá acesso a:

### 🏙️ Cidades
- Todas as cidades principais reveladas
- Templos e áreas comerciais
- Depots e bancos

### 🏰 Dungeons
- Todos os andares mapeados
- Rotas otimizadas
- Áreas de hunt marcadas

### 🌍 Wilderness
- Florestas e campos
- Montanhas e desertos
- Praias e ilhas

### 🔥 Áreas Especiais
- Territórios de demons
- Locais de quests
- Bosses e raids

---

## 💡 Dicas

### Para Desinstalar
1. Vá até: `%AppData%\OTClientV8\GoldenOT\`
2. Delete o arquivo `minimap.otmm`
3. O minimap será resetado na próxima vez

### Para Restaurar Backup
1. Vá até: `%AppData%\OTClientV8\GoldenOT\`
2. Encontre o arquivo `minimap_backup_*.otmm`
3. Renomeie para `minimap.otmm`
4. Substitua o arquivo atual

### Para Atualizar
1. Execute o instalador novamente
2. O backup será feito automaticamente
3. O novo minimap será instalado

---

## 🎮 Após a Instalação

1. ✅ Abra o GoldenOT
2. ✅ Pressione a tecla de minimap (geralmente `Ctrl+M`)
3. ✅ Veja todos os mapas revelados!
4. ✅ Explore o mundo sem se perder

---

## 📞 Suporte

Se encontrar problemas:

1. **Leia a seção "Solução de Problemas"** neste README
2. **Execute como Administrador**
3. **Verifique permissões da pasta AppData**
4. **Desative temporariamente o antivírus**

---

## 📝 Notas da Versão

### Version 2.0 - Professional Edition
- ✨ Interface visual completamente reformulada
- 🎨 Arte ASCII de alta qualidade
- 📊 Barras de progresso animadas
- 🎯 Sistema de etapas numeradas
- 🛡️ Backup automático melhorado
- 🔧 Tratamento de erros aprimorado
- 📱 Layout responsivo otimizado
- 🌈 Sistema de cores dinâmico

---

## ⚖️ Licença

Este instalador foi desenvolvido para uso exclusivo com GoldenOT.
Distribuição livre para jogadores do servidor.

---

## 👨‍💻 Créditos

**Desenvolvido para:** GoldenOT Community  
**Versão:** 2.0 - Professional Edition  
**Ano:** 2025  
**Tema:** Tibia / GoldenOT  

---

## 🎉 Aproveite!

Que suas aventuras sejam lendárias! ⚔️🗺️🏆

---

**GoldenOT** - *Where Legends Are Born*

