Chaves

O arquivo crates.yml permite configurar quais chaves do yCratesVirtuais podem ser armazenadas na mochila e como elas aparecem no menu.

Estrutura

crates:
  vip:
    # Identificador da key no yCratesVirtuais
    ycratesvirtuais-key: 'vip'
    # Ícone no menu
    menu:
      material: 'TRIPWIRE_HOOK'
      name: '&6Chave VIP'
      lore: [ '', '&fQuantidade: &7{amount}', '', '&aClique para recolher.' ]

Configuração de Chaves

Cada chave configurada neste arquivo representa uma chave do yCratesVirtuais que pode ser armazenada na mochila.

Estrutura de uma chave

crates:
  identificador_da_chave:
    ycratesvirtuais-key: 'id_no_ycratesvirtuais'
    menu:
      material: 'MATERIAL'
      name: '&Nome da Chave'
      lore: 
        - '&7Linha 1'
        - '&7Linha 2'

Parâmetros:

identificador_da_chave: ID único da chave neste arquivo (pode ser qualquer nome)
ycratesvirtuais-key: ID da chave conforme configurado no arquivo crates.yml do yCratesVirtuais
- Importante: Este valor deve corresponder exatamente ao ID da chave no plugin principal
menu.material: Material do item exibido no menu da mochila
- Formato: Nome do material do Minecraft ou ID de textura
menu.name: Nome do item no menu
- Suporta códigos de cor (&)
menu.lore: Lista de linhas de descrição do item
- Suporta códigos de cor (&)
- Placeholders disponíveis:
  - {amount} - Quantidade de chaves deste tipo armazenadas

Exemplos

Chave básica

crates:
  comum:
    ycratesvirtuais-key: 'comum'
    menu:
      material: 'TRIPWIRE_HOOK'
      name: '&7Chave Comum'
      lore: 
        - ''
        - '&fQuantidade: &7{amount}'
        - ''
        - '&aClique para recolher.'

Múltiplas chaves

crates:
  vip:
    ycratesvirtuais-key: 'vip'
    menu:
      material: 'TRIPWIRE_HOOK'
      name: '&6Chave VIP'
      lore: 
        - ''
        - '&fQuantidade: &7{amount}'
        - ''
        - '&aClique para recolher.'
  
  mvp:
    ycratesvirtuais-key: 'mvp'
    menu:
      material: 'TRIPWIRE_HOOK'
      name: '&bChave MVP'
      lore: 
        - ''
        - '&fQuantidade: &7{amount}'
        - ''
        - '&aClique para recolher.'
  
  lendaria:
    ycratesvirtuais-key: 'lendaria'
    menu:
      material: 'TRIPWIRE_HOOK'
      name: '&5&lChave Lendária'
      lore: 
        - ''
        - '&fQuantidade: &7{amount}'
        - ''
        - '&aClique para recolher todas.'

Chave com textura personalizada

crates:
  especial:
    ycratesvirtuais-key: 'especial'
    menu:
      material: 'eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvYmFkYzA0OGE3Y2U3OGY3ZGFkNzJhMDdkYTI3ZDg1YzA5MTY4ODFlNTUyMmVlZWQxZTNkYWYyMTdhMzhjMWEifX19'
      name: '&d&lChave Especial'
      lore: 
        - '&7Uma chave muito especial!'
        - ''
        - '&fQuantidade: &e{amount}'
        - ''
        - '&e▸ &aClique para recolher'

Para usar texturas personalizadas em heads (cabeças), utilize a textura em formato Base64 no campo material.

Chave com lore personalizada

crates:
  mega:
    ycratesvirtuais-key: 'mega'
    menu:
      material: 'TRIPWIRE_HOOK'
      name: '&c&lMEGA CHAVE'
      lore: 
        - '&7━━━━━━━━━━━━━━━━━━━━'
        - '&7Chaves armazenadas: &f{amount}'
        - '&7━━━━━━━━━━━━━━━━━━━━'
        - ''
        - '&aClique com o botão esquerdo'
        - '&apara recolher todas as chaves.'

Integração com yCratesVirtuais

Importante: O valor de ycratesvirtuais-key deve corresponder exatamente ao ID da chave configurado no arquivo crates.yml do plugin yCratesVirtuais.

Exemplo de correspondência:

No yCratesVirtuais (plugins/yCratesVirtuais/crates.yml):

crates:
  vip:
    name: '&6Chave VIP'
    # ... outras configurações

No yCratesVirtuaisMochilas (plugins/yCratesVirtuaisMochilasAddon/crates.yml):

crates:
  vip:
    ycratesvirtuais-key: 'vip'  # Deve ser o mesmo ID
    # ... configurações do menu

Funcionalidade

Quando um jogador:

Clica em uma chave no menu da mochila
Todas as chaves daquele tipo armazenadas são transferidas para o inventário do yCratesVirtuais
O item é removido da mochila

As chaves são automaticamente guardadas na mochila quando o jogador usa o botão "Guardar chaves" no menu da mochila.

Nesta página