Categorias

Exemplo completo de configuração

Aqui está um exemplo de como configurar as categorias do plugin:

categories:
  items:
    # Comando para acessar a categoria
    command: 'diamantes'
    # Permissão para acessar a categoria
    permission: ''
    # Categoria aparecer no menu principal
    main-menu: true
    # Slot no menu principal
    slot: 13
    # Ícone no menu principal
    icon:
      material: 'DIAMOND'
      name: '&aLoja de &bDiamantes'
      lore: ['&7Compre aqui os diamantes mais', '&7bonitos já lapidados.', '', '&aClique para acessar']
    # Configurações do menu
    menu:
      title: '&8Loja Virtual'
      size: 27
      back-slot: 9

Estrutura de categorias

command

Define o comando que será usado para acessar a categoria diretamente.

Exemplo:

categories:
  items:
    command: 'diamantes'

Os jogadores poderão usar /shop diamantes ou /virtualshop diamantes para acessar esta categoria diretamente.

permission

Define a permissão necessária para acessar a categoria. Deixe vazio para não requerer permissão.

Exemplo:

categories:
  items:
    permission: 'ypayments.category.items'

Jogadores sem a permissão configurada não poderão ver nem acessar a categoria.

Define se a categoria aparecerá no menu principal da loja.

Exemplo:

categories:
  items:
    main-menu: true

slot

Define em qual slot do menu principal a categoria aparecerá.

Exemplo:

categories:
  items:
    slot: 13

Os slots começam em 0 (canto superior esquerdo).

icon

Configuração do ícone que representa a categoria no menu.

material

Material do item que será usado como ícone.

Exemplo:

categories:
  items:
    icon:
      material: 'DIAMOND'

Você pode usar materiais do Minecraft ou texturas de cabeça em formato Base64.

name

Nome exibido no item da categoria.

Exemplo:

categories:
  items:
    icon:
      name: '&aLoja de &bDiamantes'

lore

Descrição da categoria exibida no item.

Exemplo:

categories:
  items:
    icon:
      lore: 
        - '&7Compre aqui os diamantes mais'
        - '&7bonitos já lapidados.'
        - ''
        - '&aClique para acessar'

Configurações do menu da categoria.

title

Título do menu quando a categoria é aberta.

Exemplo:

categories:
  items:
    menu:
      title: '&8Loja Virtual'

size

Tamanho do menu (deve ser múltiplo de 9, máximo 54).

Exemplo:

categories:
  items:
    menu:
      size: 27

Valores válidos: 9, 18, 27, 36, 45, 54

back-slot

Slot onde o botão de voltar será exibido.

Exemplo:

categories:
  items:
    menu:
      back-slot: 9

Criando múltiplas categorias

Você pode criar quantas categorias quiser. Aqui está um exemplo com múltiplas categorias:

categories:
  items:
    command: 'items'
    permission: ''
    main-menu: true
    slot: 11
    icon:
      material: 'DIAMOND'
      name: '&aLoja de &bItems'
      lore: ['&7Compre items exclusivos.', '', '&aClique para acessar']
    menu:
      title: '&8Loja Virtual - Items'
      size: 27
      back-slot: 9
  
  ranks:
    command: 'ranks'
    permission: ''
    main-menu: true
    slot: 13
    icon:
      material: 'DIAMOND_SWORD'
      name: '&aLoja de &bRanks'
      lore: ['&7Adquira ranks VIP.', '', '&aClique para acessar']
    menu:
      title: '&8Loja Virtual - Ranks'
      size: 27
      back-slot: 9
  
  vips:
    command: 'vips'
    permission: ''
    main-menu: true
    slot: 15
    icon:
      material: 'EMERALD'
      name: '&aLoja de &bVIPs'
      lore: ['&7Torne-se VIP do servidor.', '', '&aClique para acessar']
    menu:
      title: '&8Loja Virtual - VIPs'
      size: 27
      back-slot: 9

Vinculando produtos às categorias

Os produtos são vinculados às categorias através da configuração do produto no arquivo products.yml:

products:
  diamond:
    icons:
      sell:
        # Define em quais categorias o produto aparecerá
        # Formato: 'slot,categoria'
        categories: ['11,items', '11,main-menu']