RegionFlag
Plugin de regiões para servidores Minecraft Paper/Folia (1.21.x)
Permite criar áreas no mapa e associar ações automáticas quando jogadores entram ou saem delas — como tocar sons, executar comandos, exibir títulos na tela ou teleportar.
Desenvolvido com foco em performance e compatibilidade total com Folia (multithreading por região).
Requisitos
- Java 21+
- Paper 1.21.x ou Folia 1.21.x
- (Opcional) PlaceholderAPI — para usar placeholders como %player_name%
Instalação
- Baixe o arquivo RegionFlag-1.0.0.jar
- Coloque na pasta plugins/ do seu servidor
- Reinicie o servidor
- O arquivo config.yml será gerado automaticamente na pasta plugins/RegionFlag/
Como funciona
O fluxo básico é:
- Vá até um canto da área desejada e digite /regiao pos1
- Vá até o canto oposto e digite /regiao pos2
- Crie a região com /regiao criar <nome>
- Adicione flags (ações) à região criada
Quando um jogador entrar na região, as ações configuradas serão executadas automaticamente.
Comandos
Gerenciamento de regiões
- /regiao pos1 - Define o primeiro ponto da seleção
- /regiao pos2 - Define o segundo ponto da seleção
- /regiao criar <nome> - Cria uma região com a seleção atual
- /regiao deletar <nome> - Remove uma região
- /regiao listar - Lista as regiões do mundo atual
- /regiao info <nome> - Mostra detalhes de uma região
- /regiao <nome> prioridade <n> - Define a prioridade (para sobreposição)
Flags (ações)
- /regiao <nome> playsound <som> - Toca um som ao entrar
- /regiao <nome> console_command <comando> - Executa um comando no console ao entrar
- /regiao <nome> title <título> ; <subtítulo> - Exibe um título na tela ao entrar
- /regiao <nome> teleport <x> <y> <z> [yaw] [pitch] [mundo] - Teleporta o jogador ao entrar
Administração
- /regiao visualizar <nome> - Mostra as bordas da região com partículas
- /regiao reload - Recarrega configuração e regiões
- /regiao debug - Ativa/desativa mensagens de debug
Exemplos práticos
Criar uma região de spawn e tocar um som
Code (Text):
/regiao pos1
(ande até o outro canto)
/regiao pos2
/regiao criar spawn
/regiao spawn playsound minecraft:entity.experience_orb.pickup
Exibir um título colorido ao entrar
Code (Text):
/regiao spawn title &#FF0000Bem-vindo ao Spawn ; �FF00Aproveite o servidor!
Resultado: o jogador vê "Bem-vindo ao Spawn" em vermelho e "Aproveite o servidor!" em verde.
Executar um comando no console
Code (Text):
/regiao spawn console_command give %player_name% diamond 1
Teleportar o jogador
Code (Text):
/regiao portal teleport 100 64 200 0 0 world
Permissões
- regionflag.use - Comandos básicos (Padrão: Todos)
- regionflag.create - Criar e deletar regiões (Padrão: OP)
- regionflag.admin - Acesso completo (Padrão: OP)
- regionflag.flag.playsound - Configurar sons (Padrão: OP)
- regionflag.flag.console_command - Configurar comandos (Padrão: OP)
- regionflag.flag.title - Configurar títulos (Padrão: OP)
- regionflag.flag.teleport - Configurar teleporte (Padrão: OP)
Cores
O plugin aceita dois formatos de cor:
- Códigos legacy: &a (verde), &c (vermelho), &l (negrito), etc.
- Cores HEX: &#FF0000 (vermelho), �FF00 (verde), C3AED (roxo)
Exemplos:
Code (Text):
/regiao spawn title &aBem-vindo ; &7Divirta-se
/regiao spawn title &#FF6B35Olá ; ECDC4Subtítulo personalizado
PlaceholderAPI
Se o PlaceholderAPI estiver instalado, você pode usar qualquer placeholder nos comandos e títulos:
Code (Text):
/regiao spawn title Olá, %player_name% ; Bem-vindo de volta!
/regiao spawn console_command msg %player_name% Você entrou no spawn
Desenvolvido por Eduardo12B.