LogoyStore

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:

PlaceholderDescriçãoExemplo
{prefix}Prefixo configurado&8[&byStore&8]
{player}Nome do jogadorSteve
{target}Nome do alvoNotch
{faction}Nome da factionAvengers
{tag}Tag da factionABC
{colortag}Tag com cor&4[ABC]
{amount}Quantidade/valor1000
{time}Tempo formatado10s, 5m
{reason}Motivo/descriçãoInatividade

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 mensagem

Ou remova completamente a linha:

faction:
  leave:
    success: '{prefix} &aVocê saiu!'
    # broadcast removido = desabilitado

Mensagens 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'  # Amarelo

Por Estado

combat:
  dtr:
    normal: '&aDTR: {current}/{max}'
    low: '&eDTR: {current}/{max}'
    raidable: '&cRAIDABLE!'

Placeholders Especiais

Formatação Automática

PlaceholderDescriçãoInputOutput
{amount_formatted}Valor com separadores10000001,000,000
{time_formatted}Tempo humanizado901m 30s
{date_formatted}Data formatadatimestamp12/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' # Cinza

Usado 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 /n para 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.

Nesta página