Crates

Estrutura de arquivos

As crates são armazenadas na pasta crates/ dentro do diretório do plugin. Cada crate possui seu próprio arquivo YAML.

basic.yml

padrao.yml

Você pode criar quantos arquivos de crates quiser. Basta criar um novo arquivo .yml na pasta crates/.

Exemplo completo de configuração (basic.yml)

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

# Sistema de abertura em lote (batch)
batch-enabled: true

# Verificar se o inventário está lotado (ou vai lotar se abrir as keys)
verify-inv: true

# Som de erro ao abrir a caixa
error-sound: 'CAT_MEOW'

# Item que será interagido
item:
  material: CHEST
  name: '&5Caixa Misteriosa'
  lore: ['&7Tipo: &fBásica&7.']

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

# Sistema de chaves
key:
  # Mensagem que não possui a key
  message: '&cVocê precisa da chave para abrir essa crate.'
  # Item da chave
  item:
    material: TRIPWIRE_HOOK
    glow: true
    name: '&fChave da caixa &bDiamante&f.'
    lore:
      - '&7Esta chave abre a caixa &bdiamante&7,'
      - '&7com ela, você consegue itens raros.'
      - ''
      - '&7Vá até a &f/warp crates&7 para abrir.'
      - ''
      - '&f Quantia: &b{amount}'
      - ''

Opções de configuração

display

Nome da crate exibido nas mensagens.

Exemplo:

display: '&5Básica'

batch-enabled

Habilita o sistema de abertura em lote (abrir múltiplas keys de uma vez).

Exemplo:

batch-enabled: true

verify-inv

Verifica se o inventário do jogador está cheio antes de abrir a crate.

Exemplo:

verify-inv: true

error-sound

Som reproduzido quando ocorre um erro ao abrir a crate.

Exemplo:

error-sound: 'CAT_MEOW'

Lista de sons disponíveis: Sounds

item

Configuração do item físico da crate que pode ser colocado no mundo.

Exemplo:

item:
  material: CHEST
  name: '&5Caixa Misteriosa'
  lore: ['&7Tipo: &fBásica&7.']

additional-chance

Sistema que permite dar chance adicional para jogadores com permissões específicas.

Exemplo:

additional-chance:
  vip:
    permission: 'ycrates.vip'
    rarity: 'rare'
    chance: 15.0

Jogadores com a permissão especificada terão a chance adicional configurada para recompensas da raridade especificada.

key

Configuração do sistema de chaves necessárias para abrir a crate.

Exemplo:

key:
  message: '&cVocê precisa da chave para abrir essa crate.'
  item:
    material: TRIPWIRE_HOOK
    glow: true
    name: '&fChave da caixa &bDiamante&f.'
    lore:
      - '&7Esta chave abre a caixa &bdiamante&7,'
      - '&7com ela, você consegue itens raros.'
      - ''
      - '&f Quantia: &b{amount}'

Placeholder disponível: {amount} - Quantidade de keys

hologram

Configuração do holograma que aparece acima da crate.

Exemplo:

hologram:
  enabled: true
  # Altura em relação a crate
  off-set: 3.3
  # X em relação a crate
  off-set-x: 0.5
  # Z em relação a crate
  off-set-z: 0.5
  lines:
    - '&fCrate &bdiamante&f.'
    - '&7Consiga itens raros ao abrí-la.'
    - ''
    - '&7Ver conteúdo: &fBotão esquerdo&7.'
    - '&7Abrir crate: &fBotão direito com a chave&7.'
    - ''
    - '[item]DIAMOND_BLOCK'

Use [item]MATERIAL para exibir um item no holograma.

model-engine

Configuração para usar modelos do ModelEngine (1.16+).

Exemplo:

model-engine:
  enabled: true
  # Modelo na pasta do ModalEngine
  model: 'explosive_crate'

Requer o plugin ModelEngine instalado.

head-entity

Configuração do sistema de cabeça flutuante.

Exemplo:

head-entity:
  enabled: true
  # Material que ficará flutuando
  material: 'CHEST'
  # Ativar animação
  animation: true
  # Ativar o up-down
  up-down: true
  # Ativar o shake
  shake: true
  # Ativar a rotação
  rotate: true

glass

Sistema de bloco de vidro com cabeça dentro.

Exemplo:

glass:
  # O spawner vai gerar um vidro com uma cabeça dentro?
  enabled: false
  # material do vidro
  material: 'STAINED_GLASS'
  # material da cabeça dentro do vidro
  head: 'CHEST'
  # Data da cor do vidro
  data: 11
  # Ajuste a cabeça dentro do vidro
  off-set: -1.2
  # Animação da cabeça dentro do vidro
  animation-enabled: false
  # Velocidade da animação
  animation-speed: 4

particles

Sistema de partículas ao redor da crate.

Exemplo:

particles:
  # Um linha reta de partículas abaixo da crate
  stick:
    enabled: true
    particle: 'flame'
    off-set: 0.0
  # Partículas saltando da crate
  shiny:
    enabled: true
    particle: 'flame'
    radius: 0.8
  # Partículas sobem em espiral ao redor da crate
  spiral:
    enabled: false
    particle: 'flame'
    radius: 0.5
  # Partículas giram horizontalmente em órbita
  orbit:
    enabled: false
    particle: 'flame'
    radius: 0.8
    head-offset-y: 1.5
    block-offset-y: 0.5
  # Duas linhas de partículas entrelaçadas subindo
  helix:
    enabled: false
    particle: 'flame'
    radius: 0.4
  # Círculo que expande e contrai ritmicamente
  pulse:
    enabled: false
    particle: 'flame'
    radius: 0.3

Lista de partículas: ParticleTypes

Configurações de animação da roleta em menu.

Exemplo:

menu-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'

Use GLASS_RANDOM_COLOR para vidros aleatórios baseados na lista configurada em config.yml.

roulette

Sistema de animação da roleta física.

Exemplo:

roulette:
  enabled: true
  # Cabeças que irão aparecer na roleta
  skulls:
    - '8534b17d2d3b5a64c57f5f080dd777945761d9f71d82e8f599f242976e4d0c05'
    - 'c133414759f9e5315156017023a8b1b31cfbf177dcafb0603b8e9d94036a23f1'
  # Configuração do holograma
  hologram:
    off-set: 2.2
    lines: [ '&a{reward}', '[item]{reward_preview}' ]
  # Sistema de partículas
  particles:
    # Partícula ao aparecer as skulls na roleta
    appear: 'ENCHANT'
    # Partícula ao sumir as skulls da roleta
    disappear: 'LARGE_SMOKE'
    # Partícula de sorteando a recompensa
    sorting: 'HAPPY_VILLAGER'
    # Partícula ao receber a recompensa
    appear-reward: 'CLOUD'
  # Sistema de sons
  sounds:
    # Som ao aparecer as skulls na roleta
    appear: 'NOTE_PLING'
    # Som ao sumir as skulls da roleta
    disappear: 'NOTE_BASS'
    # Som enquanto a roleta estiver rodando
    running: 'NOTE_STICKS'
    # Som de sorteando a recompensa
    sorting: 'FIRE_IGNITE'
    # Som ao receber a recompensa
    appear-reward: 'LEVEL_UP'
  # Mensagens da roleta
  messages:
    appear:
      title: ''
      actionbar: '&f&l.&c&l.&f&l.'
      chat: ''
    running:
      title: ''
      actionbar: '&f&lG&c&lI&f&lR&c&lA&f&lN&c&lD&f&lO&c&l.'
      chat: ''
    sorting:
      title: ''
      actionbar: '&f&lS&c&lO&f&lR&c&lT&f&lE&c&lA&f&lN&c&lD&f&lO&c&l.'
      chat: ''