# Portais - Plugin de Portais Personalizados para Minecraft

** Versão:** 1.0.0
** Compatibilidade:** Paper/Spigot 1.20.x
** Java:** 17+

---

## Dependências

| Plugin | Obrigatório | Uso |
|---------------------------|-------------------|-------------------------------------------|
| Paper/Spigot 1.20.x | ✅ Sim | Base |
| EssentialsX |❌ Opcional | Warps (/warp) |
| Multiverse-Core | ❌ Opcional | Teleporte entre mundos (/mvtp) |
| PlaceholderAPI | ❌ Opcional | Mensagens dinâmicas |

---

## Comandos

| Comando | Descrição | Permissão |
|---------|-----------|-----------|
| `/portais criar <nome> <tipo> <destino>` | Criar um portal | `portais.create` |
| `/portais deletar <nome>` | Deletar um portal | `portais.delete` |
| `/portais editar <nome> <prop> <valor>` | Editar propriedades de um portal | `portais.edit` |
| `/portais listar` | Listar todos os portais | `portais.use` |
| `/portais info <nome>` | Ver detalhes de um portal | `portais.use` |
| `/portais reload` | Recarregar configurações | `portais.reload` |

### Tipos de Portal

- `warp` — Teleporta via EssentialsX (`/warp <destino>`)
- `mvtp` — Teleporta via Multiverse (`/mvtp <jogador> <mundo>`)
- `comando` — Executa qualquer comando. Use `{player}` como placeholder do jogador.

### Exemplos

```
/portais criar spawn warp spawn
/portais criar minas mvtp minas_world
/portais criar vip comando /warp vip
/portais criar kit comando /kit vip {player}
```

---

## Sistema de Seleção

1. Pegue a ferramenta de seleção (padrão: `GOLDEN_AXE`)
2. **Botão esquerdo** em um bloco → define Posição 1
3. **Botão direito** em um bloco → define Posição 2
4. Use `/portais criar` para criar o portal com a seleção atual

> A área selecionada define a região onde o portal será ativo. Quando um jogador entrar nessa área, o teleporte é ativado.

---

## Permissões

| Permissão | Descrição | Padrão |
|-----------|-----------|--------|
| `portais.admin` | Acesso total (inclui todas abaixo) | OP |
| `portais.create` | Criar portais | OP |
| `portais.delete` | Deletar portais | OP |
| `portais.edit` | Editar portais | OP |
| `portais.reload` | Reload das configs | OP |
| `portais.use` | Usar portais | Todos |

Para restringir um portal específico, use a propriedade `permissao`:
```
/portais editar meuPortal permissao portais.vip
```
Então dê a permissão `portais.vip` ao grupo VIP no seu sistema de permissões.

---

## Propriedades Editáveis

Use `/portais editar <nome> <propriedade> <valor>`:

| Propriedade | Valores | Descrição |
|-------------|---------|-----------|
| `destino` | texto | Destino do teleporte |
| `delay` | número (segundos) | Delay antes de teleportar |
| `cooldown` | número (segundos) | Tempo entre usos |
| `permissao` | permissão ou `none` | Permissão necessária |
| `ativo` | `true` / `false` | Ativar/desativar portal |
| `mensagem` | texto ou `none` | Mensagem ao teleportar |
| `tipo-mensagem` | `CHAT` / `ACTIONBAR` / `TITLE` | Forma de exibir mensagem |
| `cancelar-se-mover` | `true` / `false` | Cancela se o jogador se mover |
| `particulas` | `true` / `false` | Ativar/desativar partículas |
| `tipo-particula` | nome da partícula Bukkit | Tipo de partícula |
| `som` | `true` / `false` | Ativar/desativar som |
| `som-entrada` | nome do som Bukkit | Som ao entrar no portal |
| `som-teleporte` | nome do som Bukkit | Som ao teleportar |
| `destino-vip` | texto | Destino alternativo para VIP |
| `permissao-vip` | permissão | Permissão para destino VIP |
| `mundo-permitido` | nome do mundo ou `none` | Restringir a um mundo |
| `destino-aleatorio` | `true` / `false` | Ativar destinos aleatórios |
| `adicionar-destino` | texto | Adicionar destino aleatório |
| `remover-destino` | texto | Remover destino aleatório |

---

## Exemplos Avançados

### Portal com destino aleatório (ex: minas)
```
/portais criar minas comando /tp {player} 0 65 0
/portais editar minas destino-aleatorio true
/portais editar minas adicionar-destino /mvtp {player} minas1
/portais editar minas adicionar-destino /mvtp {player} minas2
/portais editar minas adicionar-destino /mvtp {player} minas3
```

### Portal VIP (membros VIP vão para lugar diferente)
```
/portais criar hub warp hub
/portais editar hub destino-vip warp hubvip
/portais editar hub permissao-vip grupo.vip
```

### Portal com confirmação (ficar parado 5 segundos)
```
/portais criar dungeon mvtp dungeon_world
/portais editar dungeon delay 5
/portais editar dungeon cancelar-se-mover true
/portais editar dungeon mensagem &aBem-vindo à dungeon!
/portais editar dungeon tipo-mensagem TITLE
```

---

## config.yml

O arquivo `config.yml` permite personalizar comportamentos globais, mensagens, partículas, sons e muito mais. Veja o arquivo completo em `src/main/resources/config.yml`.

---

## portais.yml

Todos os portais são salvos automaticamente no arquivo `portais.yml`. O plugin faz auto-save a cada 5 minutos (configurável) e também salva ao desligar o servidor.