Menus

Exemplo completo de configuração

Aqui está um exemplo de como configurar os menus do plugin:

# Setas dos menus.
arrows:
  back:
    material: 'ARROW:0'
    name: '&cVoltar'
    lore: ['&7Clique para voltar ao menu anterior.']
  previous:
    material: 'ARROW:0'
    name: '&cAnterior'
    lore: ['&7Clique para ir à página anterior.']
  next:
    material: 'ARROW:0'
    name: '&aPróximo'
    lore: ['&7Clique para ir à próxima página.']

# Menu principal
main:
  name: '&8Loja Virtual'
  size: 27
  items:
    profile-slot: 10
    courier-slot: 11
    shop-slot: 13
    historic-slot: 14
    transactions-slot: 15
    top-slot: 16

Estrutura de menus

O plugin possui diferentes menus para diferentes finalidades:

arrows

Configuração dos botões de navegação usados em todos os menus.

back

Botão para voltar ao menu anterior.

Exemplo:

arrows:
  back:
    material: 'ARROW:0'
    name: '&cVoltar'
    lore: ['&7Clique para voltar ao menu anterior.']

Botão para ir à página anterior em menus paginados.

Exemplo:

arrows:
  previous:
    material: 'ARROW:0'
    name: '&cAnterior'
    lore: ['&7Clique para ir à página anterior.']

Botão para ir à próxima página em menus paginados.

Exemplo:

arrows:
  next:
    material: 'ARROW:0'
    name: '&aPróximo'
    lore: ['&7Clique para ir à próxima página.']

Menu principal exibido quando os jogadores executam /shop.

Estrutura básica

main:
  name: '&8Loja Virtual'
  size: 27
  items:
    profile-slot: 10
    courier-slot: 11
    shop-slot: 13
    historic-slot: 14
    transactions-slot: 15
    top-slot: 16

profile

Exibe informações do perfil do jogador na loja.

Exemplo:

items:
  profile:
    material: '{player}'
    name: '&eSeu Perfil'
    lore:
      - '&7Confira detalhes do seu'
      - '&7jogador na nossa loja.'
      - ''
      - ' &8▶ &fDinheiro gasto: &aR$ {spent}'
      - ''
      - ' &8▶ &fReembolso: &cR$ {refunded}'
      - ''
      - ' &8▶ &fProdutos no correio: &7{to_collect}'
      - ' &8▶ &fCompras realizadas: &7{bought_amount}'
      - ''

Placeholders disponíveis: {spent}, {refunded}, {to_collect}, {bought_amount}

shop

Botão para acessar a loja de produtos.

Exemplo:

items:
  shop:
    material: 'GOLD_INGOT'
    name: '&6Shop'
    lore:
      - '&6Clique para comprar produtos!'

courier

Botão para acessar o correio de produtos.

Exemplo:

items:
  courier:
    material: 'CHEST'
    name: '&6Correio'
    lore:
      - '&7Gerencie as compras'
      - '&7que você precisa recolher.'
      - ''
      - ' &8▶ &fProdutos no correio: &7{to_collect}'
      - ''
      - '&6Clique para gerenciar!'

Placeholder disponível: {to_collect} - Quantidade de produtos pendentes

historic

Botão para acessar o histórico de compras aprovadas.

Exemplo:

items:
  historic:
    material: 'EMERALD'
    name: '&dHistórico de Compras'
    lore:
      - '&7Consulte o histórico de'
      - '&7compras aprovadas realizadas'
      - '&7na loja.'
      - ''
      - '&dClique para acessar!'

transactions

Botão para acessar todas as transações.

Exemplo:

items:
  transactions:
    material: 'BOOK'
    name: '&cTransações'
    lore:
      - '&7Consulte a lista de'
      - '&7transações realizadas'
      - '&7na loja.'
      - ''
      - '&cClique para acessar!'

top

Botão para visualizar o ranking de jogadores.

Exemplo:

items:
  top:
    material: '351137e11443a8fbb05fcd3ccc1af9bd2303918f35448185e3ed96ef184da'
    name: '&aTOP Jogadores'
    lore:
      - '&7Visualize os jogadores que estão'
      - '&7se destacando em compras na loja.'
      - ''
      - '&aClique para acessar!'

Menu onde os jogadores visualizam as categorias de produtos disponíveis.

shop:
  name: '&8Loja Virtual'
  size: 27
  back-slot: 9

As categorias são configuradas no arquivo categories.yml.

Menu que exibe todas as transações realizadas pelo jogador.

transactions:
  name: '&8Loja Virtual'
  size: 54
  slots: [ 11, 12, 13, 14, 15, 20, 21, 22, 23, 24 ]
  previous-slot: 18
  next-slot: 26
  back-slot: 48

Seletor de status

Permite filtrar transações por status.

Exemplo:

transactions:
  selector:
    slot: 50
    material: '22d145c93e5eac48a661c6f27fdaff5922cf433dd627bf23eec378b9956197'
    name: '&aSeletor de STATUS'
    # Tipos do seletor
    types:
      approved:
        enabled: true
        name: 'Aprovado'
      processing:
        enabled: true
        name: 'Processando'
      pending:
        enabled: true
        name: 'Pendente'
      canceled:
        enabled: true
        name: 'Cancelado'
      refunded:
        enabled: true
        name: 'Reembolsado'
      in-mediation:
        enabled: true
        name: 'Em mediação'
    # Formatos do seletor
    formats:
      seeing: ' &f• &a{name}'
      select: ' &f• &7{name}'

Defina enabled: false em um tipo para desabilitar aquele status no seletor.

Menu que exibe apenas as compras aprovadas.

historic:
  name: '&8Loja Virtual'
  size: 54
  slots: [ 11, 12, 13, 14, 15, 20, 21, 22, 23, 24 ]
  previous-slot: 18
  next-slot: 26
  back-slot: 49

Menu onde os jogadores coletam os produtos comprados.

courier:
  name: '&8Loja Virtual'
  size: 54
  slots: [ 11, 12, 13, 14, 15, 20, 21, 22, 23, 24 ]
  previous-slot: 18
  next-slot: 26
  back-slot: 49

Menu que exibe o ranking de jogadores por gastos na loja.

top:
  name: '&8TOP LOJA'
  size: 36
  slots: [ 10, 11, 12, 13, 14, 15, 16 ]
  back-slot: 30
  previous-slot: 9
  next-slot: 17

Seletor de ranking

Exemplo:

top:
  selector:
    slot: 31
    material: '22d145c93e5eac48a661c6f27fdaff5922cf433dd627bf23eec378b9956197'
    name: '&aSeletor do TOP'
    # Tipos do seletor
    types:
      spent:
        enabled: true
        name: 'Gasto na Loja'
    # Formatos do seletor
    formats:
      seeing: ' &f• &a{nome}'
      select: ' &f• &7{nome}'

Item do ranking

Exemplo:

top:
  items:
    spent:
      material: '{player}'
      name: '&f{player}'
      lore:
        - ''
        - '&fGasto na Loja: &aR$ {amount}'
        - '&fPosição: &e{pos}º'
        - ''

Placeholders disponíveis: {player}, {amount}, {pos}

Menu onde o jogador seleciona o método de pagamento.

gateways:
  name: '&8Loja Virtual'
  size: 27
  back-slot: 9
  items:
    picpay-slot: 11
    mercadopago-slot: 12
    paypal-slot: 13
    coinbase-slot: 14
    stripe-slot: 15
    pix-slot: 16
    discount-slot: 17

Gateways disponíveis

PicPay

Exemplo:

items:
  picpay:
    material: '9d98c8409ac195df33c6cf1b185c2a3959e03e61be22e4ca323c5e47d5dfa686'
    name: '&aPicPay'
    lore:
      - ''
      - '&fValor original: &aR$ {price_original}'
      - '&fDesconto: &aR$ {price_discount}'
      - '&fValor total: &aR$ {price}'
      - ''
      - '&6Clique para comprar com PicPay!'

MercadoPago

Exemplo:

items:
  mercadopago:
    material: 'c0c9a3a4ffbee61d1ee1c3a533355bda9cdc377e07b0ff8bc618d3977b7f86cc'
    name: '&bMercadoPago'
    lore:
      - ''
      - '&fValor original: &aR$ {price_original}'
      - '&fDesconto: &aR$ {price_discount}'
      - '&fValor total: &aR$ {price}'
      - ''
      - '&6Clique para comprar com MercadoPago!'

PayPal

Exemplo:

items:
  paypal:
    material: 'd4dcfcfaf770e563c0cfdcd306a185ea9423fe169ccacea6b9037f233a2bf5c'
    name: '&bPayPal'
    lore:
      - ''
      - '&fValor original: &aR$ {price_original}'
      - '&fDesconto: &aR$ {price_discount}'
      - '&fValor total: &aR$ {price}'
      - ''
      - '&6Clique para comprar com PayPal!'

Coinbase

Exemplo:

items:
  coinbase:
    material: '614d862b3a6a8e3989f294b208d45b663a8aede643292b05a349e2f46ac721eb'
    name: '&bCoinbase'
    lore:
      - ''
      - '&fValor original: &aR$ {price_original}'
      - '&fDesconto: &aR$ {price_discount}'
      - '&fValor total: &aR$ {price}'
      - ''
      - '&6Clique para comprar com Coinbase!'

Stripe

Exemplo:

items:
  stripe:
    material: '60ffad33d293b61765fc86ab55602b955b9e1e757a8e885d502b3dbba5425517'
    name: '&bStripe'
    lore:
      - ''
      - '&fValor original: &aR$ {price_original}'
      - '&fDesconto: &aR$ {price_discount}'
      - '&fValor total: &aR$ {price}'
      - ''
      - '&6Clique para comprar com Stripe!'

PIX (MercadoPago)

Exemplo:

items:
  pix:
    material: '60ffad33d293b61765fc86ab55602b955b9e1e757a8e885d502b3dbba5425517'
    name: '&bPIX &7(MercadoPago)'
    lore:
      - ''
      - '&fValor original: &aR$ {price_original}'
      - '&fDesconto: &aR$ {price_discount}'
      - '&fValor total: &aR$ {price}'
      - ''
      - '&6Clique para comprar com PIX &7(MercadoPago)&6!'

Placeholders disponíveis: {price_original}, {price_discount}, {price}

Desconto

Botão para aplicar cupom de desconto.

Exemplo:

items:
  discount:
    material: 'GOLD_INGOT'
    name: '&6DESCONTO'
    lore:
      - ''
      - '&fAtual: &b{coupon} &f-> &b{discount}%'
      - ''
      - '&6Clique para digitar um cupom!'

Placeholders disponíveis: {coupon}, {discount}

Menu principal para administradores gerenciarem a loja.

main-admin:
  name: '&8Loja Virtual - ADMIN'
  size: 27
  items:
    profile-slot: 10
    approved-slot: 12
    refunded-slot: 13
    mediation-slot: 14
    report-slot: 16

profile

Exibe dados gerais do faturamento.

Exemplo:

items:
  profile:
    material: 'BOOK'
    name: '&eDados Gerais'
    lore:
      - '&7Confira detalhes do seu'
      - '&7faturamento da loja.'
      - ''
      - ' &8▶ &fValor GANHO: &aR$ {earned}'
      - ' &8▶ &fValor REEMBOLSADO: &cR$ {refunded}'
      - ''

Placeholders disponíveis: {earned}, {refunded}

approved

Botão para visualizar transações aprovadas.

Exemplo:

items:
  approved:
    material: '22d145c93e5eac48a661c6f27fdaff5922cf433dd627bf23eec378b9956197'
    name: '&aAPROVADOS'
    lore:
      - '&7Confira detalhes das ordens'
      - '&7que foram aprovadas.'
      - ''
      - '&aClique para acessar'

refunded

Botão para visualizar transações reembolsadas.

Exemplo:

items:
  refunded:
    material: '548d7d1e03e1af145b0125ab841285672b421265da2ab915015f9058438ba2d8'
    name: '&cREEMBOLSADAS'
    lore:
      - '&7Confira detalhes das ordens'
      - '&7que foram reembolsadas.'
      - ''
      - '&aClique para acessar'

mediation

Botão para visualizar transações em mediação.

Exemplo:

items:
  mediation:
    material: '6f97b4bf51ce2b22d6eb5ecc154a7ab393f6a4b0b142c884615317d019d89639'
    name: '&5EM MEDIAÇÃO'
    lore:
      - '&7Confira detalhes das ordens'
      - '&7que estão sendo reembolsadas.'
      - ''
      - '&aClique para acessar'

report

Botão para gerar relatório completo de todas as transações.

Exemplo:

items:
  report:
    material: '4883d656e49c38c6b5378572f31c63c4c7a5dd4375b6ecbca43f5971c2cc4ff'
    name: '&eGerar Extrato'
    lore:
      - '&7Confira detalhes de todas as ordens'
      - '&7que foram realizadas no servidor.'
      - ''
      - '&aClique para gerar'

Menu para administradores visualizarem transações de todos os jogadores.

transactions-admin:
  name: '&8Loja Virtual - ADMIN'
  size: 54
  slots: [ 11, 12, 13, 14, 15, 20, 21, 22, 23, 24 ]
  previous-slot: 18
  next-slot: 26
  back-slot: 49

Opções de configuração de menus

name

Define o título do menu exibido no topo.

Exemplo:

name: '&8Loja Virtual'

size

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

Exemplo:

size: 27

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

slots

Define os slots onde os itens principais serão exibidos.

Exemplo:

slots: [ 11, 12, 13, 14, 15, 20, 21, 22, 23, 24 ]

back-slot

Define o slot onde o botão de voltar será exibido.

Exemplo:

back-slot: 49

previous-slot

Define o slot onde o botão de página anterior será exibido.

Exemplo:

previous-slot: 18

next-slot

Define o slot onde o botão de próxima página será exibido.

Exemplo:

next-slot: 26

Os slots começam em 0 (canto superior esquerdo) e vão até 53 (canto inferior direito em um menu de tamanho 54).

Nesta página