Configuração

O plugin deve funcionar sem necessidade de configuração adicional, mas se você precisar alterar o comportamento do plugin, você está no lugar certo.

Após alterar a configuração, é necessário reiniciar o servidor.

Configuração do plugin (config.yml)

redis

Configurações do servidor Redis para sincronização de dados entre múltiplos servidores. Necessário apenas em redes BungeeCord/Velocity para manter os dados de correio sincronizados em tempo real.

redis:
  # Ativar a conexão com o redis
  enabled: false
  # Endereço de conexão. [EX: 127.0.0.1]
  host: 'localhost'
  # Porta de conexão. [EX: 6379]
  port: 6379
  # Usuário de conexão. [EX: root]
  username: ''
  # Senha do usuário de conexão: [EX: 123]
  password: ''

Redis é essencial se você usa yCorreio em múltiplos servidores conectados via BungeeCord/Velocity, garantindo que itens enviados entre servidores sejam sincronizados corretamente.

Mensagens (messages.yml)

Recebeu player all

Mensagem enviada no chat para todos os jogadores online quando um pacote de correio é enviado para um jogador.

Recebeu player all: '&e[Correio] &f{player} &erecebeu um item de &f{remetente}&e!'

Placeholders disponíveis:

Placeholder	Descrição
`{player}`	Nome do destinatário
`{remetente}`	Nome de quem enviou

Recebeu player all actionbar

Mensagem enviada na actionbar para todos os jogadores online quando um pacote de correio é entregue.

Recebeu player all actionbar: '&e[Correio] &f{player} &erecebeu um item de &f{remetente}&e!'

As mensagens Recebeu player all e Recebeu player all actionbar funcionam em conjunto: a primeira aparece no chat e a segunda na barra de ação. Deixe em branco para desativar individualmente.

Sistema de Histórico de Envios

O yCorreio oferece um sistema completo de histórico que permite aos jogadores acompanhar todos os seus envios de itens. Este sistema mantém um registro de todas as remessas com seus status e datas.

Configuração do Histórico

# Sistema de histórico de envios
Historico:
  # Quantos dias o item fica pendente antes de retornar ao remetente
  Dias expiracao: 7
  
  # Limite de entradas no histórico por jogador
  Limite por jogador: 50
  
  # A cada quantos minutos verificar itens expirados
  Verificar minutos: 60
  
  # Permissão para ver histórico de outros jogadores
  Permissao staff: 'ycorreio.historico.outros'
  
  Mensagens:
    Titulo: '&8Histórico de Envios'
    Status pendente: '&ePendente'
    Status recolhido: '&a✓ Recolhido'
    Status retornado: '&c↩ Retornado'
    Enviado para: '&7Enviado para: &f{destinatario}'
    Data envio: '&7Data: &f{data}'
    Expira em: '&7Expira em: &f{tempo}'
    Sem historico: '&cVocê não tem envios no histórico.'
    Item retornado: '&e[Correio] &fSeu item &e{item} &fnão foi coletado por &e{player} &fe retornou para você!'

Explicação dos Parâmetros

Dias expiracao: Quantidade de dias que um item permanece no histórico antes de retornar automaticamente ao remetente. Padrão: 7 dias
Limite por jogador: Número máximo de entradas que cada jogador pode ter no histórico. Entradas antigas serão removidas quando o limite for atingido. Padrão: 50
Verificar minutos: Intervalo em minutos para verificar e processar itens expirados. Padrão: 60 minutos (1 hora)
Permissao staff: Permissão necessária para que staff possa visualizar o histórico de outros jogadores

Status do Item

O sistema rastreia o status de cada item enviado:

Pendente: Item foi enviado mas ainda não foi coletado pelo destinatário
Recolhido (✓): Item foi coletado com sucesso pelo destinatário
Retornado (↩): Item expirou e retornou automaticamente ao remetente

Comandos Relacionados

O sistema de histórico adiciona novos comandos ao plugin:

/correio historico - Visualiza seu próprio histórico de envios
/correio historico [player] - Visualiza o histórico de envios de outro jogador (requer ycorreio.historico.outros)

Variáveis de Placeholder

As seguintes variáveis podem ser usadas nas mensagens do histórico:

Placeholder	Descrição
`{status}`	Status atual do item (Pendente, Recolhido, Retornado)
`{destinatario}`	Nome do jogador que recebeu o item
`{data_envio}`	Data em que o item foi enviado
`{expira_em}`	Tempo restante antes do item expirar
`{item}`	Nome do item enviado
`{player}`	Nome do jogador que enviou o item
`{quantidade}`	Quantidade do item

Recomendações de Uso

Para servidores pequenos (até 50 jogadores):

Historico:
  Dias expiracao: 14          # Mais tempo de retenção
  Limite por jogador: 30      # Menos espaço necessário
  Verificar minutos: 120      # Verificações menos frequentes

Para servidores grandes (100+ jogadores):

Historico:
  Dias expiracao: 7           # Menos espaço utilizado
  Limite por jogador: 50      # Limite padrão
  Verificar minutos: 30       # Verificações mais frequentes

Para economia voltada em leveling/missões:

Historico:
  Dias expiracao: 3           # Itens expiram rapidamente
  Limite por jogador: 100     # Mais histórico para tracking
  Verificar minutos: 15       # Verificações muito frequentes

Permissões

ycorreio.historico.outros - Permite visualizar histórico de outros jogadores

Nesta página