LogoyStore
yEasterEggsConfiguração

Easter Eggs

Aprenda a criar e configurar eventos de Easter Eggs personalizados.

Exemplo completo de configuração

Aqui está um exemplo completo de como criar um evento de Easter Eggs de Halloween:

# Data que poderá começar a coletar
start-date: '01/10/2025-10:00'

# Data que finalizará a possibilidade de coletar
end-date: '31/10/2025-10:00'

# Lista de variedade de cabeças que poderão ser colocadas
heads:
  - '43c00154c561f3d66ac69b37d056a610f3700f41ea9323cdd40eeba5e6f3df91'
  - 'ecc184cec63a8c14bd6d5f878a09cab861c8ed03064c3ccef99186bf380c5d6'
  - '861b57ab8943ddfb8cb1fe478ae7e03d984782565d72880c4862f2eb3da0fd2'

# Ítem que o staff irá pegar pelo "give" para por no chão
item:
  name: '&6Abóbora do Halloween'
  lore:
    - '&7Coloque essa abóbora no chão'
    - '&7em um lugar escondido.'

# Configurações dos ícones dos menus
icons:
  main-staff-waiting:
    material: '43c00154c561f3d66ac69b37d056a610f3700f41ea9323cdd40eeba5e6f3df91'
    name: '&6Evento Halloween'
    lore:
      - '&7Easter-Eggs para o evento mais'
      - '&7assombroso do ano.'
      - ''
      - '&e* &fEsse evento irá começar em'
      - '&e* &f{start_time} &7({start_date}-{start_hour})'

# Sistema de partículas ao redor da head
particles:
  enabled: true
  particle: 'witch'

# Recompensas configuradas na rewards.yml
rewards:
  - '100.0,reward1'

# Mensagens
messages:
  placed: '&6Easter-Egg de Halloween colocado! &7({total}) easter-eggs.'
  removed: '&6Easter-Egg de Halloween removido! &7({total}) easter-eggs.'
  collected: '&6[Halloween] Mais uma abóbora coletada! &f({collected}/{total}).'

Opções disponíveis na configuração

Aqui estão os parâmetros que podem ser configurados em um Easter Egg:

start-date

Define a data e hora de início do evento. O formato deve ser DD/MM/YYYY-HH:MM.

Exemplo:

start-date: '01/10/2025-10:00'

end-date

Define a data e hora de término do evento. O formato deve ser DD/MM/YYYY-HH:MM.

Exemplo:

end-date: '31/10/2025-10:00'

heads

Lista de texturas de cabeças que podem ser colocadas durante o evento. Use os IDs de textura do minecraft-heads.com.

Exemplo:

heads:
  - '43c00154c561f3d66ac69b37d056a610f3700f41ea9323cdd40eeba5e6f3df91'
  - 'ecc184cec63a8c14bd6d5f878a09cab861c8ed03064c3ccef99186bf380c5d6'

item

Configuração do item que a staff receberá para colocar no mapa.

name

Nome do item que a staff irá receber. Pode ser estilizado com códigos de cor (&).

Exemplo:

item:
  name: '&6Abóbora do Halloween'

lore

Descrição do item que a staff irá receber. Pode ser estilizada com códigos de cor (&).

Exemplo:

item:
  lore:
    - '&7Coloque essa abóbora no chão'
    - '&7em um lugar escondido.'

icons

Configuração dos ícones exibidos nos menus do plugin. Existem diferentes ícones para diferentes estados e contextos.

main-staff-waiting

Ícone exibido no menu de gerenciamento quando o evento ainda não começou.

Exemplo:

icons:
  main-staff-waiting:
    material: '43c00154c561f3d66ac69b37d056a610f3700f41ea9323cdd40eeba5e6f3df91'
    name: '&6Evento Halloween'
    lore:
      - '&7Easter-Eggs para o evento mais'
      - '&7assombroso do ano.'

Placeholders disponíveis: {start_time}, {start_date}, {start_hour}

main-staff-started

Ícone exibido no menu de gerenciamento quando o evento está em andamento.

Exemplo:

icons:
  main-staff-started:
    material: '43c00154c561f3d66ac69b37d056a610f3700f41ea9323cdd40eeba5e6f3df91'
    name: '&6Evento Halloween'
    lore:
      - '&a* &fEsse evento irá finalizar em'
      - '&a* &f{end_time} &7({end_date}-{end_hour})'

Placeholders disponíveis: {end_time}, {end_date}, {end_hour}

main-staff-finished

Ícone exibido no menu de gerenciamento quando o evento já terminou.

Exemplo:

icons:
  main-staff-finished:
    material: '43c00154c561f3d66ac69b37d056a610f3700f41ea9323cdd40eeba5e6f3df91'
    name: '&6Evento Halloween'
    lore:
      - '&c* &fEsse evento já acabou.'

staff

Ícone exibido no menu onde a staff pode pegar o item para colocar no mapa.

Exemplo:

icons:
  staff:
    name: '&6Abóbora do Halloween'
    lore:
      - '&7Coloque essa abóbora no chão'
      - '&aClique para pegar.'

main-waiting

Ícone exibido no menu principal para jogadores quando o evento ainda não começou.

Exemplo:

icons:
  main-waiting:
    material: '43c00154c561f3d66ac69b37d056a610f3700f41ea9323cdd40eeba5e6f3df91'
    name: '&6Evento Halloween'
    lore:
      - '&e* &fEsse evento irá começar em'
      - '&e* &f{start_time}'

main-started

Ícone exibido no menu principal para jogadores quando o evento está em andamento.

Exemplo:

icons:
  main-started:
    material: '43c00154c561f3d66ac69b37d056a610f3700f41ea9323cdd40eeba5e6f3df91'
    name: '&6Evento Halloween'
    lore:
      - '&6 Abóboras coletadas: &f{collected}/{total}'

Placeholders disponíveis: {collected}, {total}, {end_time}, {end_date}, {end_hour}

main-finished

Ícone exibido no menu principal para jogadores quando o evento já terminou.

Exemplo:

icons:
  main-finished:
    material: '43c00154c561f3d66ac69b37d056a610f3700f41ea9323cdd40eeba5e6f3df91'
    name: '&6Evento Halloween'
    lore:
      - '&6 Abóboras coletadas: &f{collected}/{total}'
      - '&c* &fEsse evento já acabou.'

Placeholders disponíveis: {collected}, {total}

particles

Configuração do sistema de partículas ao redor das cabeças colocadas no mapa.

enabled

Define se as partículas estarão ativadas. Valores válidos: true ou false.

Exemplo:

particles:
  enabled: true

particle

Define o tipo de partícula que será exibida. Consulte a lista de partículas do Minecraft para ver todas as opções.

Exemplo:

particles:
  particle: 'witch'

rewards

Lista de recompensas que serão dadas aos jogadores. O formato é "CHANCE,ID_RECOMPENSA", onde a chance é um valor decimal (ex: 100.0 = 100%) e o ID corresponde a uma recompensa configurada no arquivo rewards.yml.

Exemplo:

rewards:
  - '100.0,reward1'
  - '50.0,reward2'
  - '25.0,reward3'

messages

Mensagens personalizadas exibidas durante o evento.

placed

Mensagem exibida quando uma cabeça é colocada pela staff.

Exemplo:

messages:
  placed: '&6Easter-Egg de Halloween colocado! &7({total}) easter-eggs.'

Placeholder disponível: {total} - Total de easter-eggs colocados

removed

Mensagem exibida quando uma cabeça é removida pela staff.

Exemplo:

messages:
  removed: '&6Easter-Egg de Halloween removido! &7({total}) easter-eggs.'

Placeholder disponível: {total} - Total de easter-eggs restantes

collected

Mensagem exibida quando um jogador coleta uma cabeça.

Exemplo:

messages:
  collected: '&6[Halloween] Mais uma abóbora coletada! &f({collected}/{total}).'

Placeholders disponíveis: {collected} - Quantidade coletada pelo jogador, {total} - Total de easter-eggs

collected-all

Mensagem exibida quando um jogador coleta todas as cabeças do evento.

Exemplo:

messages:
  collected-all: '&6[Halloween] Você coletou todas as abóboras! &fRecompensa enviada.'

already-collected

Mensagem exibida quando um jogador tenta coletar uma cabeça que já foi coletada.

Exemplo:

messages:
  already-collected: '&6[Halloween] &cVocê já coletou essa abóbora!'

already-collected-all

Mensagem exibida quando um jogador que já coletou todas as cabeças tenta coletar novamente.

Exemplo:

messages:
  already-collected-all: '&6[Halloween] &cVocê já coletou todas as abóboras!'

Criando seu primeiro Easter Egg

Crie o arquivo

Crie um novo arquivo na pasta plugins/yEasterEggs/easters/ com o nome do seu evento (ex: natal.yml).

Configure as datas

Defina quando o evento começará e terminará:

start-date: '20/12/2025-00:00'
end-date: '26/12/2025-23:59'

Adicione as cabeças

Escolha as texturas das cabeças no minecraft-heads.com e adicione os IDs:

heads:
  - 'texture_id_1'
  - 'texture_id_2'
  - 'texture_id_3'

Configure o item da staff

Personalize como o item aparecerá para a equipe:

item:
  name: '&cPresente de Natal'
  lore:
    - '&7Esconda este presente pelo mapa!'

Adicione as recompensas

Configure as recompensas no arquivo rewards.yml e referencie-as:

rewards:
  - '100.0,natal_completo'

Reinicie o servidor

Reinicie o servidor para aplicar as configurações.

Certifique-se de que as datas estão no formato correto: DD/MM/YYYY-HH:MM

Configuração

Conheça as várias opções de configuração.

Recompensas

Configure as recompensas dadas aos jogadores que completam eventos.

Nesta página

Exemplo completo de configuraçãoOpções disponíveis na configuraçãostart-dateend-dateheadsitemnameloreiconsmain-staff-waitingmain-staff-startedmain-staff-finishedstaffmain-waitingmain-startedmain-finishedparticlesenabledparticlerewardsmessagesplacedremovedcollectedcollected-allalready-collectedalready-collected-allCriando seu primeiro Easter EggCrie o arquivoConfigure as datasAdicione as cabeçasConfigure o item da staffAdicione as recompensasReinicie o servidor