PortaisCore

# 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



<br> /portais criar spawn warp spawn <br> /portais criar minas mvtp minas_world <br> /portais criar vip comando /warp vip <br> /portais criar kit comando /kit vip {player} <br>



---




## 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:

<br> /portais editar meuPortal permissao portais.vip <br>

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)

<br> /portais criar minas comando /tp {player} 0 65 0 <br> /portais editar minas destino-aleatorio true <br> /portais editar minas adicionar-destino /mvtp {player} minas1 <br> /portais editar minas adicionar-destino /mvtp {player} minas2 <br> /portais editar minas adicionar-destino /mvtp {player} minas3 <br>




### Portal VIP (membros VIP vão para lugar diferente)

<br> /portais criar hub warp hub <br> /portais editar hub destino-vip warp hubvip <br> /portais editar hub permissao-vip grupo.vip <br>




### Portal com confirmação (ficar parado 5 segundos)

<br> /portais criar dungeon mvtp dungeon_world <br> /portais editar dungeon delay 5 <br> /portais editar dungeon cancelar-se-mover true <br> /portais editar dungeon mensagem &amp;aBem-vindo à dungeon! <br> /portais editar dungeon tipo-mensagem TITLE <br>



---




## 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.