Caixas

Exemplo completo de configuração

Aqui está um exemplo de como configurar uma caixa misteriosa:

# Nome que aparecerá nas mensagens
display: '&5Básica'

# Item que será interagido
item:
  material: CHEST
  name: '&5Caixa Misteriosa'
  lore: ['&7Tipo: &fBásica&7.', '', '&aClique com botão direito', '&apara abrir esta caixa.']

# Mundos em que poderá abrir essa caixa
worlds: []

# Ativar o sistema de UUID (para não estacar caixas sem ser pelo comando de give)
uuid: false

# Se ativado, o jogador ganha 1 recompensa para cada raridade presente na caixa.
# Exemplo: comum + raro + ultra-raro = 3 recompensas.
one-item-per-rarity: false

# Configurações de animação da roleta
animation:
  # Ativar a animação
  enabled: true
  # Duração total da animação (em iterações)
  duration: 110
  # Velocidade inicial (ticks entre atualizações)
  initial-speed: 3
  # Ponto onde a animação acelera (% da duração)
  acceleration-point: 15
  # Ponto onde atinge velocidade máxima (% da duração)
  max-speed: 25
  # Ponto onde começa a desacelerar (% da duração)
  deceleration-point: 60
  # Velocidade final (ticks entre atualizações no final)
  final-speed: 6
  # Som que tocará ao rodar recompensas
  sound: 'NOTE_STICKS'
  # Som que tocará ao ganhar a recompensa
  win-sound: 'LEVEL_UP'
  # Configurações dos vidros
  glass:
    material: 'GLASS_RANDOM_COLOR'
    material-finish: 'STAINED_GLASS_PANE:7'
    middle-top: 'STAINED_GLASS_PANE:5'
    middle-bottom: 'STAINED_GLASS_PANE:5'

# Dê uma chance a mais para os vips
additional-chance:
  vip:
    # Permissão para ter essa chance a mais
    permission: 'ymysteryboxes.vip'
    # Raridade válida
    rarity: 'rare'
    # Chance a mais
    chance: 15.0

# Sistema de chaves (yMysteryBoxesKeyAddon)
key:
  # Exigir a chave para abrir
  need: false
  # Mensagem que não possui a key
  message: '&cVocê precisa da chave para abrir essa caixa.'
  # Item da chave
  item:
    material: TRIPWIRE_HOOK
    name: '&5Chave Misteriosa'
    lore: [ '&7Tipo: &fBásica&7.', '', '&aDeixe-a no inventário', '&apara abrir a caixa.' ]

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

display

Nome da caixa que aparecerá nas mensagens.

Exemplo:

display: '&5Básica'

item

Configuração do item físico da caixa.

Exemplo:

item:
  material: CHEST
  name: '&5Caixa Misteriosa'
  lore: ['&7Tipo: &fBásica&7.', '', '&aClique com botão direito', '&apara abrir esta caixa.']

O material pode ser um item normal ou uma textura de cabeça (head).

worlds

Lista de mundos onde a caixa pode ser aberta. Se vazio, permite em todos os mundos.

Exemplo:

worlds: []

ou com mundos específicos:

worlds: ['world', 'world_nether']

uuid

Ativa o sistema de UUID para impedir que caixas sejam empilhadas sem ser pelo comando de give.

Exemplo:

uuid: false

Valores válidos: true, false

one-item-per-rarity

Quando ativado, a abertura da caixa entrega uma recompensa para cada raridade presente na caixa.

Exemplo:

one-item-per-rarity: false

Com true, uma caixa com recompensas comuns, raras e ultra-raras pode entregar 3 recompensas, uma de cada raridade encontrada.

animation

Configurações da animação de roleta quando a caixa é aberta.

enabled

Ativa ou desativa a animação.

Exemplo:

animation:
  enabled: true

duration

Duração total da animação em iterações.

Exemplo:

animation:
  duration: 110

initial-speed

Velocidade inicial da roleta em ticks entre atualizações.

Exemplo:

animation:
  initial-speed: 3

acceleration-point

Ponto percentual da duração onde a animação começa a acelerar.

Exemplo:

animation:
  acceleration-point: 15

max-speed

Ponto percentual da duração onde atinge velocidade máxima.

Exemplo:

animation:
  max-speed: 25

deceleration-point

Ponto percentual da duração onde começa a desacelerar.

Exemplo:

animation:
  deceleration-point: 60

final-speed

Velocidade final da roleta em ticks entre atualizações.

Exemplo:

animation:
  final-speed: 6

sound

Som que tocará ao rodar as recompensas.

Exemplo:

animation:
  sound: 'NOTE_STICKS'

win-sound

Som que tocará ao ganhar a recompensa.

Exemplo:

animation:
  win-sound: 'LEVEL_UP'

glass

Configurações dos vidros da animação.

Exemplo:

animation:
  glass:
    material: 'GLASS_RANDOM_COLOR'
    material-finish: 'STAINED_GLASS_PANE:7'
    middle-top: 'STAINED_GLASS_PANE:5'
    middle-bottom: 'STAINED_GLASS_PANE:5'

Use GLASS_RANDOM_COLOR para usar vidros aleatórios definidos no config.yml

additional-chance

Sistema de chance adicional para jogadores com permissões específicas.

Exemplo:

additional-chance:
  vip:
    # Permissão para ter essa chance a mais
    permission: 'ymysteryboxes.vip'
    # Raridade válida
    rarity: 'rare'
    # Chance a mais
    chance: 15.0

Você pode criar múltiplas entradas de chance adicional, uma para cada grupo de jogadores.

key

Sistema de chaves (requer addon yMysteryBoxesKeyAddon).

need

Define se a chave é necessária para abrir a caixa.

Exemplo:

key:
  need: false

message

Mensagem exibida quando o jogador não possui a chave.

Exemplo:

key:
  message: '&cVocê precisa da chave para abrir essa caixa.'

item

Configuração do item da chave.

Exemplo:

key:
  item:
    material: TRIPWIRE_HOOK
    name: '&5Chave Misteriosa'
    lore: [ '&7Tipo: &fBásica&7.', '', '&aDeixe-a no inventário', '&apara abrir a caixa.' ]

Criando uma nova caixa

Crie o arquivo

Crie um novo arquivo na pasta plugins/yMysteryBoxes/boxes/ com o nome desejado (ex: vip.yml).

Configure os básicos

Defina o display, item e mundos permitidos.

Configure a animação

Ajuste os valores de velocidade e sons da roleta conforme preferir.

Adicione recompensas

Use o comando /mbox edit <nome-da-caixa> no jogo para adicionar recompensas.

Teste a caixa

Use /mbox give <seu-nick> <nome-da-caixa> 1 para testar.

O nome do arquivo (sem .yml) será o ID da caixa usado nos comandos.

Nesta página