Produtos

Exemplo completo de configuração

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

products:
  diamond:
    # Nome nas mensagens
    name: '&bDiamantes!'
    # Nome no pagamento
    title: 'yStore - Diamantes'
    # Meio de pagamento
    # Disponível: MERCADOPAGO, PICPAY, PAYPAL, COINBASE, STRIPE, PIX
    gateways: ['PICPAY', 'MERCADOPAGO', 'PAYPAL', 'COINBASE', 'STRIPE', 'PIX']
    # Meios de pagamento que irão dar o mapa
    # Disponível: MERCADOPAGO, PICPAY, PAYPAL, COINBASE, STRIPE, PIX
    map-gateways: ['PICPAY', 'MERCADOPAGO', 'PAYPAL', 'COINBASE', 'STRIPE', 'PIX']
    # Em reais
    price: 0.01
    # Lista de descontos já aplicados
    # GATEWAY:PORCENTAGEM
    gateway-discount: [ 'PIX:10.0' ]
    # Lista de gateways que não será possível aplicar cupom
    # GATEWAY
    coupon-block: []
    # O que será dado ao player
    rewards:
      commands: []
      items:
        diamond:
          material: DIAMOND
          amount: 10
    discord:
      # exclusivo yDiscordHook
      # enviar o embed no privado
      discordhook:
        enable: true
        dm-bought-embed: 'bought'
        dm-mediation-embed: ''
        dm-refunded-embed: ''
      # enviar o embed em um chat
      webhook:
        enable: true
        chat-bought-embed: 'bought'
        chat-mediation-embed: ''
        chat-refunded-embed: ''
    # Comandos que serão executados quando o for reembolsado
    commands-refunded: ['give {player} barrier 1']
    # Comandos que serão executados quando o jogador contestar
    commands-mediation: ['give {player} stone 1']

Estrutura de produtos

ID do produto

O ID é a chave única que identifica o produto. Use apenas letras minúsculas e underscore.

Exemplo:

products:
  diamond:  # ID do produto

name

Nome exibido nas mensagens do plugin.

Exemplo:

products:
  diamond:
    name: '&bDiamantes!'

title

Título da cobrança que aparecerá no gateway de pagamento.

Exemplo:

products:
  diamond:
    title: 'yStore - Diamantes'

Este título é visto pelo comprador na página de pagamento do gateway escolhido.

gateways

Lista de gateways de pagamento disponíveis para este produto.

Exemplo:

products:
  diamond:
    gateways: ['PICPAY', 'MERCADOPAGO', 'PAYPAL', 'COINBASE', 'STRIPE', 'PIX']

Valores válidos: MERCADOPAGO, PICPAY, PAYPAL, COINBASE, STRIPE, PIX

map-gateways

Lista de gateways que fornecerão mapa com QR-Code para pagamento.

Exemplo:

products:
  diamond:
    map-gateways: ['PICPAY', 'MERCADOPAGO', 'PIX']

O mapa de QR-Code facilita o pagamento via aplicativos móveis.

price

Preço do produto em reais (BRL).

Exemplo:

products:
  diamond:
    price: 10.50

gateway-discount

Descontos automáticos aplicados por gateway específico.

Exemplo:

products:
  diamond:
    gateway-discount: [ 'PIX:10.0', 'PICPAY:5.0' ]

Formato: 'GATEWAY:PORCENTAGEM'. No exemplo, PIX tem 10% de desconto e PicPay 5%.

coupon-block

Lista de gateways onde cupons de desconto não podem ser aplicados.

Exemplo:

products:
  diamond:
    coupon-block: ['PIX']

Use isso para evitar acúmulo de descontos em gateways que já possuem desconto automático.

Sistema de recompensas

rewards

Define o que o jogador receberá ao comprar o produto.

commands

Lista de comandos executados quando a compra é aprovada.

Exemplo:

products:
  diamond:
    rewards:
      commands:
        - 'give {player} diamond 10'
        - 'tell {player} Obrigado pela compra!'

Placeholder disponível: {player} - Nome do jogador que comprou

items

Itens que serão dados ao jogador no correio.

Exemplo:

products:
  diamond:
    rewards:
      items:
        diamond:
          material: DIAMOND
          amount: 10
        sword:
          material: DIAMOND_SWORD
          amount: 1

Os itens são enviados ao correio do jogador e devem ser coletados com /shop correio.

Integração com Discord

discord

Configurações de notificações via Discord.

discordhook

Integração com o plugin yDiscordHook para enviar mensagens no privado dos jogadores.

Exemplo:

products:
  diamond:
    discord:
      discordhook:
        enable: true
        dm-bought-embed: 'bought'
        dm-mediation-embed: 'mediation'
        dm-refunded-embed: 'refunded'

Requer o plugin yDiscordHook instalado e configurado.

webhook

Enviar notificações em canais do Discord via webhooks.

Exemplo:

products:
  diamond:
    discord:
      webhook:
        enable: true
        chat-bought-embed: 'bought'
        chat-mediation-embed: 'mediation'
        chat-refunded-embed: 'refunded'

Configure os webhooks no arquivo discord.yml.

Comandos de sanção

commands-refunded

Comandos executados quando a compra é reembolsada.

Exemplo:

products:
  diamond:
    commands-refunded: 
      - 'clear {player}'
      - 'ban {player} Reembolso fraudulento'

Use estes comandos para aplicar sanções ou remover benefícios de jogadores que solicitaram reembolso.

commands-mediation

Comandos executados quando a compra entra em mediação (contestação).

Exemplo:

products:
  diamond:
    commands-mediation: 
      - 'tempban {player} 7d Compra em contestação'

Sistema de mensagens

messages

Mensagens personalizadas para cada produto.

broadcast

Mensagens enviadas para todos os jogadores online.

Exemplo:

products:
  diamond:
    messages:
      broadcast:
        chat: '&aO jogador &f{player}&a comprou &bDiamantes&a!'
        actionbar: '&a{player} &fcomprou Diamantes!'
        title: '&a{player}<nl>&fcomprou Diamantes!'

Deixe vazio para não enviar mensagem. Use <nl> para quebra de linha em títulos.

private

Mensagens enviadas apenas para o comprador.

Exemplo:

products:
  diamond:
    messages:
      private:
        chat: |

          &a&lLOJA
          &aObrigado pela sua compra na nossa loja.
          &7Desfrute do seu novo item &bDiamantes!

        actionbar: '&aCompra aprovada!'
        title: '&aObrigado<nl>&fpela compra!'

refunded

Mensagens enviadas quando a compra é reembolsada.

Exemplo:

products:
  diamond:
    messages:
      refunded:
        chat: |

          &a&lLOJA
          &cSua compra de referência &f{reference} &7{gateway}&c foi reembolsada.
          &7Sanções serão aplicadas.

        actionbar: '&cCompra reembolsada'
        title: '&cReembolso<nl>&fprocessado'

Placeholders disponíveis: {reference}, {gateway}

in-mediation

Mensagens enviadas quando a compra entra em mediação.

Exemplo:

products:
  diamond:
    messages:
      in-mediation:
        chat: |

          &a&lLOJA
          &cSua compra de referência &f{reference} &7{gateway}&c foi contestada.
          &7Sanções serão aplicadas.

        actionbar: '&cCompra em mediação'
        title: '&cContestação<nl>&fdetectada'

collect

Mensagens enviadas quando o jogador coleta os itens do correio.

Exemplo:

products:
  diamond:
    messages:
      collect:
        chat: |

          &a&lLOJA
          &bOs itens da sua compra foram adicionados ao seu inventário.

        actionbar: '&aItens coletados!'
        title: ''

Sistema de ícones

icons

Configuração de como o produto aparece nos diferentes menus.

sell

Ícone exibido no menu de compra.

Exemplo:

products:
  diamond:
    icons:
      sell:
        categories: ['11,items', '11,main-menu']
        material: DIAMOND
        name: '&bDiamantes'
        amount: 10
        lore: 
          - '&7Ostente esses belíssimos'
          - '&7diamantes no servidor.'
          - ''
          - '&fPreço: &2R$ &a0,01'
          - ''
          - '&7Clique para comprar'

O campo categories define onde o produto aparecerá. Formato: 'slot,categoria'

historic

Ícone exibido no menu de histórico de compras.

Exemplo:

products:
  diamond:
    icons:
      historic:
        material: DIAMOND
        name: '&bDiamantes'
        amount: 10
        lore: 
          - '&7Ostente esses belíssimos'
          - '&7diamantes no servidor.'
          - ''
          - '&fReferência: &b{reference}&f.'
          - '&aComprado em &f{date} &aàs &f{hour}'
          - '&aPreço pago: &fR$ {price}'

Placeholders disponíveis: {reference}, {date}, {hour}, {price}

transactions

Ícone exibido no menu de transações do jogador.

Exemplo:

products:
  diamond:
    icons:
      transactions:
        material: DIAMOND
        name: '&bDiamantes'
        amount: 10
        lore: 
          - '&7Ostente esses belíssimos'
          - '&7diamantes no servidor.'
          - ''
          - '&fReferência: &b{reference}&f.'
          - '&fStatus: &e{status}&f.'
          - '&fGateway: &b{gateway}'
          - ''
          - '&aAtualizado em &f{date} &aàs &f{hour}'
          - '&aPreço pago: &fR$ {price}'
          - ''

Placeholders disponíveis: {reference}, {status}, {gateway}, {date}, {hour}, {price}

transactions-admin

Ícone exibido no menu de transações para administradores.

Exemplo:

products:
  diamond:
    icons:
      transactions-admin:
        material: DIAMOND
        name: '&bDiamantes'
        amount: 10
        lore: 
          - '&7Ostente esses belíssimos'
          - '&7diamantes no servidor.'
          - ''
          - '&fJogador: &6{owner}'
          - '&fReferência: &b{reference}&f.'
          - '&fStatus: &e{status}&f.'
          - '&fGateway: &b{gateway}'
          - ''
          - '&aAtualizado em &f{date} &aàs &f{hour}'
          - '&aPreço pago: &fR$ {price}'
          - ''

Placeholder adicional: {owner} - Nome do jogador que comprou

collect

Ícone exibido no menu de correio.

Exemplo:

products:
  diamond:
    icons:
      collect:
        material: DIAMOND
        name: '&bDiamantes'
        amount: 10
        lore: 
          - '&7Ostente esses belíssimos'
          - '&7diamantes no servidor.'
          - ''
          - '&fReferência: &b{reference}&f.'
          - ''
          - '&aClique para recolher'

Placeholder disponível: {reference} - Código de referência da compra

Criando múltiplos produtos

Você pode criar quantos produtos quiser:

products:
  diamond:
    name: '&bDiamantes!'
    title: 'yStore - Diamantes'
    price: 10.00
    # ... configurações do produto
  
  vip:
    name: '&aVIP Mensal'
    title: 'yStore - VIP Mensal'
    price: 25.00
    # ... configurações do produto
  
  kit_starter:
    name: '&eKit Starter'
    title: 'yStore - Kit Starter'
    price: 5.00
    # ... configurações do produto

Personalizando produtos

Defina o ID

Escolha um ID único usando apenas letras minúsculas e underscore.

Configure informações básicas

Defina nome, título, preço e gateways disponíveis.

Configure recompensas

Defina comandos e/ou itens que serão dados ao jogador.

Configure mensagens

Personalize as mensagens para cada etapa da compra.

Configure ícones

Defina como o produto aparecerá em cada menu.

Teste a compra

Faça uma compra de teste para verificar se tudo funciona corretamente.

Após alterar os produtos, é necessário reiniciar o servidor para aplicar as mudanças.

Nesta página