Mensagens
Sistema de mensagens personalizáveis do yFactions
Visão Geral
Configure todas as mensagens exibidas pelo plugin. O sistema suporta múltiplas linhas, códigos de cor, placeholders e mensagens condicionais.
Estrutura do Sistema
O arquivo messages.yml contém mais de 200 mensagens organizadas por categoria. Todas suportam:
- ✅ Códigos de cor (
&a,&c,&l, etc.) - ✅ Placeholders do plugin (
{player},{faction}, etc.) - ✅ Placeholders do PlaceholderAPI
- ✅ Múltiplas linhas com lista YAML
- ✅ Mensagens vazias (desabilitar com
[])
Mensagens de Prefixo
# Prefixo padrão das mensagens
prefix: '&8[&byStore&8]'Usado em todas as mensagens do plugin. Para remover o prefixo de uma mensagem específica, não use o placeholder {prefix}.
Placeholders Globais
Disponíveis em todas as mensagens:
| Placeholder | Descrição | Exemplo |
|---|---|---|
{prefix} | Prefixo configurado | &8[&byStore&8] |
{player} | Nome do jogador | Steve |
{target} | Nome do alvo | Notch |
{faction} | Nome da faction | Avengers |
{tag} | Tag da faction | ABC |
{colortag} | Tag com cor | &4[ABC] |
{amount} | Quantidade/valor | 1000 |
{time} | Tempo formatado | 10s, 5m |
{reason} | Motivo/descrição | Inatividade |
Categorias de Mensagens
Mensagens Gerais
messages:
# Sem permissão
no-permission: '{prefix} &cVocê não tem permissão para isto.'
# Apenas jogadores
player-only: '{prefix} &cApenas jogadores podem executar este comando.'
# Comando inválido
invalid-command: '{prefix} &cComando inválido. Use /f help'
# Argumentos insuficientes
invalid-args: '{prefix} &cUse: {usage}'
# Jogador não encontrado
player-not-found: '{prefix} &cJogador {player} não encontrado.'
# Jogador offline
player-offline: '{prefix} &cO jogador {player} está offline.'Mensagens de Faction
Criação e Gerenciamento
faction:
# Criar faction
create:
success: '{prefix} &aFaction {faction} criada com sucesso!'
already-in-faction: '{prefix} &cVocê já está em uma faction.'
tag-in-use: '{prefix} &cEsta tag já está em uso.'
tag-too-short: '{prefix} &cA tag deve ter no mínimo {min} caracteres.'
tag-too-long: '{prefix} &cA tag deve ter no máximo {max} caracteres.'
invalid-tag: '{prefix} &cA tag contém caracteres inválidos.'
name-in-use: '{prefix} &cEste nome já está em uso.'
# Dissolver faction
disband:
success: '{prefix} &aFaction {faction} dissolvida!'
confirm: '{prefix} &eDigite &c/f disband confirm &epara confirmar.'
only-leader: '{prefix} &cApenas o líder pode dissolver a faction.'
# Renomear faction
rename:
success: '{prefix} &aFaction renomeada para {faction}!'
in-use: '{prefix} &cEste nome já está em uso.'
# Alterar tag
tag:
success: '{prefix} &aTag alterada para {tag}!'
in-use: '{prefix} &cEsta tag já está em uso.'
# Alterar descrição
description:
success: '{prefix} &aDescrição alterada!'
too-long: '{prefix} &cA descrição deve ter no máximo {max} caracteres.'Membros e Convites
faction:
# Convidar jogador
invite:
sent: '{prefix} &aConvite enviado para {player}!'
received:
- ''
- '{prefix} &aVocê foi convidado para {colortag}'
- '{prefix} &7Use &a/f join {tag} &7para aceitar'
- ''
already-invited: '{prefix} &c{player} já foi convidado.'
already-member: '{prefix} &c{player} já é membro de uma faction.'
# Entrar na faction
join:
success: '{prefix} &aVocê entrou na faction {faction}!'
broadcast: '{prefix} &a{player} entrou na faction!'
not-invited: '{prefix} &cVocê não foi convidado para esta faction.'
no-invite: '{prefix} &cVocê não tem convites pendentes.'
# Expulsar membro
kick:
success: '{prefix} &a{player} foi expulso da faction!'
kicked: '{prefix} &cVocê foi expulso da faction {faction}!'
broadcast: '{prefix} &c{player} foi expulso da faction!'
cannot-kick-leader: '{prefix} &cVocê não pode expulsar o líder.'
cannot-kick-yourself: '{prefix} &cVocê não pode se expulsar.'
higher-rank: '{prefix} &cVocê não pode expulsar membros de cargo superior.'
# Sair da faction
leave:
success: '{prefix} &aVocê saiu da faction {faction}!'
broadcast: '{prefix} &c{player} saiu da faction!'
leader-must-disband: '{prefix} &cLíderes devem dissolver a faction.'Cargos e Promoções
faction:
# Promover membro
promote:
success: '{prefix} &a{player} promovido para {rank}!'
promoted: '{prefix} &aVocê foi promovido para {rank}!'
broadcast: '{prefix} &a{player} foi promovido para {rank}!'
max-rank: '{prefix} &c{player} já está no cargo máximo.'
cannot-promote-leader: '{prefix} &cVocê não pode promover o líder.'
# Rebaixar membro
demote:
success: '{prefix} &a{player} rebaixado para {rank}!'
demoted: '{prefix} &cVocê foi rebaixado para {rank}!'
broadcast: '{prefix} &c{player} foi rebaixado para {rank}!'
min-rank: '{prefix} &c{player} já está no cargo mínimo.'
cannot-demote-leader: '{prefix} &cVocê não pode rebaixar o líder.'
# Transferir liderança
leader:
success: '{prefix} &aLiderança transferida para {player}!'
new-leader: '{prefix} &aVocê é o novo líder da faction!'
broadcast: '{prefix} &e{player} é o novo líder da faction!'
only-leader: '{prefix} &cApenas o líder pode transferir a liderança.'Mensagens de Território
Claim e Unclaim
territory:
# Clamar território
claim:
success: '{prefix} &aTerritório clamado! ({current}/{max})'
no-power: '{prefix} &cSua faction não tem poder suficiente.'
already-claimed: '{prefix} &cEste território já foi clamado.'
max-claims: '{prefix} &cVocê atingiu o limite de territórios.'
too-close-spawn: '{prefix} &cMuito próximo do spawn.'
adjacent-required: '{prefix} &cDeve ser adjacente ao seu território.'
not-enough-money: '{prefix} &cSua faction precisa de {amount} coins.'
# Desclamar território
unclaim:
success: '{prefix} &aTerritório desclamado!'
not-claimed: '{prefix} &cEste território não está clamado.'
not-your-territory: '{prefix} &cEste território não é seu.'
cannot-unclaim-home: '{prefix} &cVocê não pode desclamar a home.'
# Desclamar tudo
unclaimall:
success: '{prefix} &aTodos os territórios foram desclamados!'
confirm: '{prefix} &eDigite &c/f unclaimall confirm &epara confirmar.'
# Clamar automático
autoclaim:
enabled: '{prefix} &aClaim automático ativado!'
disabled: '{prefix} &cClaim automático desativado!'
claimed: '{prefix} &aTerritório clamado automaticamente!'Mensagens de Zona
territory:
# Entrar em território
enter:
own: '{prefix} &aVocê entrou no território da sua faction.'
ally: '{prefix} &bVocê entrou no território de {colortag}'
enemy: '{prefix} &cVocê entrou no território de {colortag}'
neutral: '{prefix} &eVocê entrou no território de {colortag}'
wilderness: '{prefix} &7Você entrou na selva.'
warzone: '{prefix} &4Você entrou na zona de guerra!'
safezone: '{prefix} &aVocê entrou na zona segura!'
# Sair de território
leave:
own: '{prefix} &7Você saiu do seu território.'
# ... (mesma estrutura de enter)Mensagens de Combate
Proteção e PvP
combat:
# Tag de combate
tag:
start: '{prefix} &cVocê entrou em combate! Não desconecte.'
end: '{prefix} &aVocê saiu de combate.'
logout: '{prefix} &cVocê desconectou em combate e foi morto!'
# Proteção de spawn
spawn-protection:
cannot-attack: '{prefix} &c{player} está protegido pelo spawn.'
lose-protection: '{prefix} &cVocê perdeu a proteção de spawn ao atacar!'
# Friendly fire
friendly-fire:
disabled: '{prefix} &cVocê não pode atacar membros da sua faction.'
ally-disabled: '{prefix} &cVocê não pode atacar membros de factions aliadas.'
# DTR (Deaths Till Raidable)
dtr:
lost: '{prefix} &cSua faction perdeu {amount} DTR! ({current}/{max})'
raidable: '{prefix} &4SUA FACTION ESTÁ RAIDABLE!'
frozen: '{prefix} &cSeu DTR está congelado por {time}.'
regenerating: '{prefix} &aSeu DTR está regenerando... ({current}/{max})'Mensagens de Economia
Banco da Faction
economy:
# Depositar dinheiro
deposit:
success: '{prefix} &aVocê depositou {amount} no banco da faction!'
broadcast: '{prefix} &a{player} depositou {amount} no banco!'
not-enough: '{prefix} &cVocê não tem {amount}.'
# Sacar dinheiro
withdraw:
success: '{prefix} &aVocê sacou {amount} do banco da faction!'
broadcast: '{prefix} &c{player} sacou {amount} do banco!'
not-enough-faction: '{prefix} &cA faction não tem {amount}.'
# Ver saldo
balance:
message: '{prefix} &aBank da faction: &2${amount}'
# Compras
purchase:
success: '{prefix} &aCompra realizada com sucesso!'
not-enough-money: '{prefix} &cA faction precisa de {amount}.'
max-reached: '{prefix} &cVocê atingiu o limite máximo.'Mensagens de Relações
Alianças
relations:
# Solicitar aliança
ally:
request-sent: '{prefix} &aSolicitação de aliança enviada para {faction}!'
request-received:
- ''
- '{prefix} &a{colortag} &7quer ser sua aliada!'
- '{prefix} &7Use &a/f ally {tag} &7para aceitar'
- ''
accepted: '{prefix} &aAgora você é aliado de {colortag}!'
already-allies: '{prefix} &cVocê já é aliado desta faction.'
# Desfazer aliança
unally:
success: '{prefix} &cVocê não é mais aliado de {colortag}!'
broadcast: '{prefix} &c{faction} desfez a aliança!'
not-allies: '{prefix} &cVocê não é aliado desta faction.'
# Inimigos
enemy:
set: '{prefix} &cAgora você é inimigo de {colortag}!'
removed: '{prefix} &7Você não é mais inimigo de {colortag}.'Mensagens de Home e Warps
Home da Faction
home:
# Definir home
set:
success: '{prefix} &aHome da faction definida!'
must-be-territory: '{prefix} &cDeve estar no território da sua faction.'
# Teleportar para home
teleport:
success: '{prefix} &aTeleportando para home em {time}...'
teleported: '{prefix} &aVocê foi teleportado!'
cancelled: '{prefix} &cTeleporte cancelado! Você se moveu.'
no-home: '{prefix} &cSua faction não tem uma home definida.'
enemy-territory: '{prefix} &cVocê não pode usar /f home em território inimigo.'
# Deletar home
delete:
success: '{prefix} &aHome da faction deletada!'Warps
warps:
# Criar warp
create:
success: '{prefix} &aWarp {name} criada!'
already-exists: '{prefix} &cJá existe um warp com este nome.'
max-warps: '{prefix} &cVocê atingiu o limite de warps. ({max})'
invalid-name: '{prefix} &cNome de warp inválido.'
# Deletar warp
delete:
success: '{prefix} &aWarp {name} deletada!'
not-found: '{prefix} &cWarp não encontrada.'
# Teleportar
teleport:
success: '{prefix} &aTeleportando para {name} em {time}...'
not-found: '{prefix} &cWarp não encontrada.'
# Listar warps
list:
header: '{prefix} &aWarps disponíveis:'
format: '&8 - &7{name} &8({world})'
empty: '{prefix} &cSua faction não tem warps.'Mensagens de Power
Sistema de Poder
power:
# Ganhar poder
gain: '{prefix} &aVocê ganhou {amount} de poder! ({current}/{max})'
# Perder poder
loss: '{prefix} &cVocê perdeu {amount} de poder! ({current}/{max})'
# Informações
info:
player: '{prefix} &fSeu poder: &a{current}/{max}'
faction: '{prefix} &fPoder da faction: &a{current}/{max}'
# Máximo atingido
max-reached: '{prefix} &aSeu poder está no máximo!'Mensagens de Melhorias (Upgrades)
upgrades:
# Comprar melhoria
purchase:
success: '{prefix} &aMelhoria {upgrade} comprada! Nível {level}'
max-level: '{prefix} &cEsta melhoria já está no nível máximo.'
not-enough-money: '{prefix} &cPreço: {amount}'
# Tipos de melhorias
types:
max-power: 'Poder Máximo'
max-claims: 'Territórios Máximos'
max-members: 'Membros Máximos'
max-warps: 'Warps Máximos'
chest-slots: 'Slots do Baú'Mensagens de Proteção
Blocos Protegidos
protection:
# Obsidian protegida
obsidian:
placed: '{prefix} &aObsidian protegida colocada! ({durability} resistência)'
broken: '{prefix} &cObsidian protegida quebrada!'
damage: '{prefix} &cObsidian: {durability}/{max} resistência'
regenerating: '{prefix} &aObsidian regenerando... ({time})'
# Interação bloqueada
interact:
blocked: '{prefix} &cVocê não pode fazer isto aqui!'
no-permission: '{prefix} &cVocê não tem permissão na faction.'Mensagens de Admin
Comandos Administrativos
admin:
# Modo admin
toggle:
enabled: '{prefix} &aModo admin ativado!'
disabled: '{prefix} &cModo admin desativado!'
# Bypass
bypass:
enabled: '{prefix} &aBypass ativado!'
disabled: '{prefix} &cBypass desativado!'
# Forçar ações
force:
disband: '{prefix} &aFaction {faction} dissolvida pelo admin!'
kick: '{prefix} &a{player} foi expulso por um admin!'
unclaim: '{prefix} &aTerritório desclamado por um admin!'
# Modo debug
debug:
enabled: '{prefix} &aDebug mode enabled.'
disabled: '{prefix} &cDebug mode disabled.'Mensagens de Informação
Ver informações
info:
# Informações da faction
faction:
header:
- ''
- '&8&m--------------&8[{colortag}&8]&m--------------'
- ''
leader: '&f Líder: &a{leader}'
members: '&f Membros: &a{online}/{total}'
power: '&f Poder: &a{current}/{max}'
land: '&f Terras: &a{claims}/{maxclaims}'
founded: '&f Fundada: &7{date}'
description: '&f Descrição: &7{description}'
allies: '&f Aliados: &a{allies}'
enemies: '&f Inimigos: &c{enemies}'
footer:
- ''
- '&8&m---------------------------------'
- ''
# Informações do jogador
player:
header: '&8&m----------- &f{player} &8&m-----------'
faction: '&f Faction: {colortag}'
rank: '&f Cargo: &7{rank}'
power: '&f Poder: &a{current}/{max}'
kills: '&f Kills: &a{kills}'
deaths: '&f Deaths: &c{deaths}'
kdr: '&f KDR: &e{kdr}'Mensagens de Lista
Listar factions
list:
# Cabeçalho
header:
- ''
- '&8&m----------&8[ &bTop Factions &8]&m----------'
- ''
# Formato de linha
format: '&f{position}. {colortag} &8- &7{members} membros &8- &a{power} poder'
# Rodapé
footer:
- ''
- '&7Total: &f{total} factions'
- ''
# Lista vazia
empty: '{prefix} &cNão há factions criadas.'Exemplos de Personalização
Mensagens Minimalistas
prefix: '&8[&6F&8]'
faction:
create:
success: '{prefix} &aFaction criada!'
invite:
sent: '{prefix} &aConvite enviado!'
join:
success: '{prefix} &aVocê entrou!'Mensagens Detalhadas
prefix: '&8[&b&lFACTIONS&8]'
faction:
create:
success:
- ''
- '{prefix} &a&lFACTION CRIADA!'
- ''
- '&f Tag: {colortag}'
- '&f Nome: &7{faction}'
- '&f Líder: &a{player}'
- ''
- '&7Use &a/f help &7para ver os comandos!'
- ''Mensagens com Símbolos
faction:
invite:
received:
- ''
- '&8▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬'
- ''
- ' &b&lCONVITE DE FACTION'
- ''
- ' &fVocê foi convidado para {colortag}'
- ''
- ' &a▶ &7Clique para aceitar'
- ' &c✖ &7/f deny para recusar'
- ''
- '&8▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬'
- ''Desabilitar Mensagens
Para desabilitar uma mensagem específica, use uma lista vazia:
faction:
leave:
broadcast: [] # Não envia mensagemOu remova completamente a linha:
faction:
leave:
success: '{prefix} &aVocê saiu!'
# broadcast removido = desabilitadoMensagens Condicionais
Algumas mensagens mudam baseadas no contexto:
Por Relação
territory:
enter:
own: '&aTeritório próprio' # Verde
ally: '&bTerritório aliado' # Azul
enemy: '&cTerritório inimigo' # Vermelho
neutral: '&eTerritório neutro' # AmareloPor Estado
combat:
dtr:
normal: '&aDTR: {current}/{max}'
low: '&eDTR: {current}/{max}'
raidable: '&cRAIDABLE!'Placeholders Especiais
Formatação Automática
| Placeholder | Descrição | Input | Output |
|---|---|---|---|
{amount_formatted} | Valor com separadores | 1000000 | 1,000,000 |
{time_formatted} | Tempo humanizado | 90 | 1m 30s |
{date_formatted} | Data formatada | timestamp | 12/11/2025 |
Pluralização
messages:
members: '{faction} tem {count} membro(s)' # Genérico
# Ou específico:
members-single: '{faction} tem 1 membro'
members-plural: '{faction} tem {count} membros'Cores por Relação
colors:
own: '&a' # Verde
ally: '&b' # Azul
neutral: '&f' # Branco
enemy: '&c' # Vermelho
warzone: '&4' # Vermelho escuro
safezone: '&2' # Verde escuro
wilderness: '&7' # CinzaUsado automaticamente em:
{colortag}- Tag com cor da relação- Mensagens de território
- Listagens de factions
Dicas de Escrita
Clareza
- ✅
Você precisa de {amount} coins - ❌
Valor insuficiente: {amount}
Consistência
- Use sempre o mesmo tom (formal/informal)
- Mantenha cores padronizadas (verde = sucesso, vermelho = erro)
- Formate valores da mesma forma
Brevidade
- ✅
Faction criada! - ❌
Sua faction foi criada com sucesso e agora você pode começar a jogar.
Feedback
- ✅
Home definida! Use /f home para teleportar - ❌
Home definida
Troubleshooting
Cores não aparecem
- Verifique se está usando
&e não§ - Confirme suporte a cores na versão do servidor
Placeholders não substituem
- Verifique se o placeholder existe
- Confirme a sintaxe:
{placeholder}não%placeholder% - PlaceholderAPI usa
%plugin_placeholder%
Mensagens muito longas
- Divida em múltiplas linhas com lista YAML
- Use
/npara quebra de linha (se suportado) - Reduza texto desnecessário
Caracteres especiais
- Use UTF-8 no arquivo
- Teste símbolos Unicode antes de usar
- Alternativas:
->ao invés de→
Documentação completa! Todos os arquivos de configuração do yFactions foram documentados.