Pinhatas

Exemplo completo de configuração

Aqui está um exemplo de como configurar uma pinhata:

# Nome nas mensagens
display-name: '&6&lPinhata'

# Entidade da pinhata
entity-type: 'SHEEP'

# Quantia total de hits
hits: 5

# Delay entre hits (em milisegundos)
hit-delay: 1000

# Ativar o brilho da pinhata
# 1.19+
glow: true

# Desativar a inteligência artificial da pinhata
no-ai: false

# Configuração do holograma
hologram:
  off-set: 2.5
  lines:
    - '&6&lPINHATA'
    - '&aQuebre-me para ganhar recompensas!'
    - '&eHits restantes: &f{remaining_hits}'

# Recompensas configuradas na rewards.yml
random-rewards:
  - 'reward1'
  - 'reward2'

# Recompensas configuradas na rewards.yml
# use "random" para os da lista acima
# chance, recompensa
hit-rewards:
  - '50.0,random'

# Recompensas configuradas na rewards.yml
# use "random" para os da lista acima
# chance, recompensa
death-rewards:
  - '100.0,reward3'

# Horários que o evento irá ativar
# todos, segunda, terca, quarta, quinta, sexta, sabado, domingo
# dia-hora-minuto-segundo
auto-start:
  - 'todos-12:00:00'

# Sistema de knockback ao hitar
knockback:
  # Chance de ativar
  chance: 50.0
  # Força horizontal do knockback
  power: 0.8
  # Força vertical do knockback
  y-power: 0.5
  # Som ao aplicar o knockback
  sound: 'CAT_MEOW'
  # Particle ao aplicar o knockback
  particle:
    type: 'EXPLOSION'
    amount: 10

# Mensagens do plugin
messages:
  spawn:
    chat: |
      &r
      &6&lPinhata!
      &aUma pinhata apareceu!
      &r
    action-bar: '&aUma pinhata apareceu!'
    title: ''
  hit:
    chat: '&eVocê acertou a pinhata! &7({current_hits}/{total_hits})'
    action-bar: '&eVocê acertou a pinhata! &7({current_hits}/{total_hits})'
    title: ''
  death:
    chat: |
      &r
      &6&lPinhata Quebrada!
      &a{player} quebrou a pinhata e ganhou a recompensa máxima!
      &r
    action-bar: '&a{player} quebrou a pinhata e ganhou a recompensa máxima!'
    title: ''

location: 'none'

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

display-name

Define o nome da pinhata exibido nas mensagens.

Exemplo:

display-name: '&6&lPinhata'

Use códigos de cor com & para personalizar o nome.

entity-type

Define o tipo de entidade que será usada como pinhata.

Exemplo:

entity-type: 'SHEEP'

Você pode usar qualquer tipo de entidade válido do Minecraft (ex: SHEEP, COW, PIG, ZOMBIE, etc.).

hits

Define quantos golpes são necessários para quebrar a pinhata.

Exemplo:

hits: 5

hit-delay

Define o tempo de espera em milisegundos entre cada golpe do jogador.

Exemplo:

hit-delay: 1000

1000 milisegundos = 1 segundo

glow

Ativa o efeito de brilho na pinhata (requer Minecraft 1.19+).

Exemplo:

glow: true

Valores válidos: true ou false

no-ai

Desativa a inteligência artificial da entidade, fazendo com que ela fique parada.

Exemplo:

no-ai: false

Valores válidos: true ou false

hologram

Configura o holograma exibido acima da pinhata.

off-set

Define a distância vertical do holograma em relação à entidade.

Exemplo:

hologram:
  off-set: 2.5

lines

Define as linhas de texto do holograma.

Exemplo:

hologram:
  lines:
    - '&6&lPINHATA'
    - '&aQuebre-me para ganhar recompensas!'
    - '&eHits restantes: &f{remaining_hits}'

Placeholder disponível: {remaining_hits} - Quantidade de hits restantes

random-rewards

Lista de IDs de recompensas configuradas no rewards.yml que podem ser sorteadas aleatoriamente.

Exemplo:

random-rewards:
  - 'reward1'
  - 'reward2'

hit-rewards

Define as recompensas que podem ser ganhas ao acertar a pinhata. Use o formato chance,recompensa.

Exemplo:

hit-rewards:
  - '50.0,random'

50.0 = 50% de chance
random = sorteia uma recompensa da lista random-rewards
Você também pode especificar um ID de recompensa específico: 50.0,reward1

Para múltiplas recompensas:

hit-rewards:
  - '30.0,reward1'
  - '20.0,reward2'
  - '50.0,random'

death-rewards

Define as recompensas que são dadas ao jogador que der o último golpe na pinhata. Use o formato chance,recompensa.

Exemplo:

death-rewards:
  - '100.0,reward3'

100.0 = 100% de chance
Você pode usar random ou um ID específico de recompensa

auto-start

Define os horários em que a pinhata será spawnada automaticamente. Use o formato dia-hora:minuto:segundo.

Exemplo:

auto-start:
  - 'todos-12:00:00'

Dias válidos:

todos - Todos os dias
segunda - Segunda-feira
terca - Terça-feira
quarta - Quarta-feira
quinta - Quinta-feira
sexta - Sexta-feira
sabado - Sábado
domingo - Domingo

Para múltiplos horários:

auto-start:
  - 'todos-12:00:00'
  - 'todos-18:00:00'
  - 'sabado-15:00:00'

knockback

Configura o sistema de knockback ao bater na pinhata.

chance

Chance de aplicar o knockback.

Exemplo:

knockback:
  chance: 50.0

50.0 = 50% de chance

power

Força horizontal do knockback.

Exemplo:

knockback:
  power: 0.8

y-power

Força vertical do knockback.

Exemplo:

knockback:
  y-power: 0.5

sound

Som reproduzido ao aplicar o knockback.

Exemplo:

knockback:
  sound: 'CAT_MEOW'

Use nomes de sons válidos do Minecraft (ex: ENTITY_PLAYER_HURT, BLOCK_ANVIL_LAND, etc.).

particle

Configura as partículas exibidas ao aplicar o knockback.

type

Tipo de partícula.

Exemplo:

knockback:
  particle:
    type: 'EXPLOSION'

amount

Quantidade de partículas.

Exemplo:

knockback:
  particle:
    amount: 10

messages

Configura as mensagens exibidas em diferentes momentos do evento.

spawn

Mensagens exibidas quando a pinhata é spawnada.

Exemplo:

messages:
  spawn:
    chat: |
      &r
      &6&lPinhata!
      &aUma pinhata apareceu!
      &r
    action-bar: '&aUma pinhata apareceu!'
    title: ''

chat - Mensagem no chat
action-bar - Mensagem na action bar
title - Mensagem no título (deixe vazio '' para não exibir)

hit

Mensagens exibidas quando um jogador acerta a pinhata.

Exemplo:

messages:
  hit:
    chat: '&eVocê acertou a pinhata! &7({current_hits}/{total_hits})'
    action-bar: '&eVocê acertou a pinhata! &7({current_hits}/{total_hits})'
    title: ''

Placeholders disponíveis:

{current_hits} - Hits atuais
{total_hits} - Total de hits necessários

death

Mensagens exibidas quando a pinhata é quebrada.

Exemplo:

messages:
  death:
    chat: |
      &r
      &6&lPinhata Quebrada!
      &a{player} quebrou a pinhata e ganhou a recompensa máxima!
      &r
    action-bar: '&a{player} quebrou a pinhata e ganhou a recompensa máxima!'
    title: ''

Placeholder disponível: {player} - Nome do jogador que quebrou a pinhata

location

Armazena a localização onde a pinhata será spawnada. Este valor é definido automaticamente pelo comando /pinhata setlocation.

Exemplo:

location: 'none'

Não edite este valor manualmente. Use o comando /pinhata setlocation para definir a localização.

Criando múltiplas pinhatas

Para criar múltiplas pinhatas, basta criar múltiplos arquivos na pasta plugins/yPinata/pinatas/:

Cada arquivo representa uma pinhata diferente e pode ter configurações únicas.

Personalizando pinhatas

Crie o arquivo

Crie um arquivo .yml na pasta plugins/yPinata/pinatas/ com um nome único.

Configure as opções

Copie o exemplo completo e ajuste os valores conforme necessário.

Defina a localização

Use /pinhata setlocation <nome> para definir onde a pinhata aparecerá.

Teste o spawn

Use /pinhata spawn <nome> para testar se a pinhata está configurada corretamente.

Após criar ou editar arquivos de pinhatas, use /pinhata reload ou reinicie o servidor.

Nesta página