Configuração

O plugin deve funcionar sem necessidade de configuração adicional, mas se você precisar alterar o comportamento do plugin, você está no lugar certo.

Configurações Gerais

Acumular Bonus

Define se o bônus de venda será acumulado com os prêmios normais:

Acumular bonus: false

Explicação:

• Quando true: Os bônus são somados aos prêmios regulares
• Quando false: Os bônus substituem os prêmios regulares

Mundos Blacklist

Lista de mundos onde o sistema de venda não funciona:

Mundos blacklist: []

Exemplo:

Mundos blacklist:
  - 'pvp_world'
  - 'creative'
  - 'world_border'

Padrão Auto-vender

Ativa o sistema auto-vender como padrão para novos jogadores:

Padrao auto: false

Explicação:

• Quando true: Novos jogadores começam com auto-vender ativado
• Quando false: Novos jogadores começam com auto-vender desativado
• Jogadores podem alternar a qualquer momento usando o comando

Padrão Shift-Sell

Ativa o sistema shift-sell como padrão para novos jogadores:

Padrao shift: false

Explicação:

• Quando true: Shift-sell começa ativado para novos jogadores
• Quando false: Shift-sell começa desativado para novos jogadores

Menu Venda Selecionada

Define o comportamento do menu de venda selecionada (baú duplo):

venda-selecionada:
  # Ativar ou desativar o menu de venda selecionada
  habilitado: true

O que é:

O menu de Venda Selecionada permite que jogadores coloquem itens específicos em um baú duplo e vendam todos de uma vez. É útil para vender múltiplos itens de diferentes tipos em uma única ação.

Como funciona:

1. Abrir o menu de Venda Selecionada via comando ou botão no menu principal
2. Colocar os itens desejados nos slots permitidos do baú
3. Clicar em "Confirmar Venda" para vender todos os itens de uma vez
4. Ou clicar em "Cancelar" para devolver os itens ao inventário

Configuração de Itens (itens_new.yml)

Estrutura Básica de Item

itens:
  categoria1:
    item1:
      # Ordenação do item no menu
      ordem: 1
      
      # Material da venda (formato: MATERIAL:DATA)
      material: 'STONE:0'
      
      # CustomModelData do item (opcional, para texturas customizadas)
      # Se configurado, apenas itens com esse custom-model-data serão vendidos
      # Deixe em 0 ou remova a linha para vender itens sem textura customizada
      custom-model-data: 0
      
      # Nome do item
      display-name: '&7Pedra'
      
      # Vender apenas os itens que estiverem renomeados com o display_name
      require-display-name: false
      
      # Permissão para vender este item
      permissao: ''
      
      # Configuração do item exibido no menu
      display:
        material: 'STONE:0'
        name: '&7Pedra'
        lore:
          - ''
          - ' &fPreço por unidade: &a{unidade_money}&f.'
          - ''
          - '&aBotão &fESQUERDO &apara vender 64.'
          - '&aSHIFT+Botão &fESQUERDO &apara vender tudo.'
      
      # Preços de venda
      prices:
        price1:
          provider: 'money'
          amount: 10.0
      
      # Regiões WorldGuard onde o item será vendido automaticamente ao ser dropado
      # Deixe [] para vender em qualquer região
      regions: []

Explicação dos Parâmetros

• ordem: Posição do item no menu (1, 2, 3, etc)
• material: Material do item em formato MATERIAL:DATA (ex: STONE:0, DIRT:0)
• custom-model-data: Valor CustomModelData para texturas customizadas (deixe em 0 se não usar)
• display-name: Nome do item que será vendido
• require-display-name: Se true, só vende itens com o nome exato especificado
• permissao: Permissão necessária para vender este item (deixe vazio para permitir todos)
• display: Configuração visual do item no menu
• prices: Lista de provedores de preço (money, tokens, etc)
• regions: Lista de regiões WorldGuard onde o item será vendido automaticamente ao ser dropado. Deixe [] para vender em qualquer região

Sistema CustomModelData

O CustomModelData permite vender itens com texturas customizadas específicas:

itens:
  categorias_especiais:
    espada_customizada:
      ordem: 1
      material: 'DIAMOND_SWORD:0'
      custom-model-data: 1001
      display-name: '&6Espada Especial'
      require-display-name: false
      permissao: ''
      display:
        material: 'DIAMOND_SWORD:0'
        custom-model-data: 1001
        name: '&6Espada Especial'
        lore:
          - ''
          - ' &fPreço: &a{unidade_money}&f por unidade'
          - ''
      prices:
        price1:
          provider: 'money'
          amount: 50000.0

Funcionamento:

• Se custom-model-data estiver configurado, apenas itens com esse CustomModelData serão vendidos
• Itens sem CustomModelData não serão vendidos se essa configuração estiver ativa
• Deixe em 0 ou remova a linha para vender qualquer variação do item

Exemplo com múltiplos preços:

prices:
  price1:
    provider: 'money'
    amount: 50.0
  price2:
    provider: 'tokens'
    amount: 5.0

Recomendações de Uso

Para economia simples:

Padrao auto: true
Padrao shift: true
Acumular bonus: true

Para economia com restrições:

Padrao auto: false
Padrao shift: false
Acumular bonus: false
Mundos blacklist:
  - 'pvp'
  - 'admin'

Para servidor com texturas customizadas:

• Use custom-model-data para cada item especial
• Configure valores únicos para cada textura
• Exemplo: custom-model-data: 1001 para primeira textura customizada

Regiões WorldGuard (regions)

O campo regions permite restringir a venda automática de um item a regiões específicas do WorldGuard. Quando o jogador dropa o item dentro de uma região listada, ele é vendido automaticamente.

itens:
  minerios:
    diamante:
      ordem: 1
      material: 'DIAMOND:0'
      display-name: '&bDiamante'
      require-display-name: false
      permissao: ''
      display:
        material: 'DIAMOND:0'
        name: '&bDiamante'
        lore:
          - ' &fPreço: &a{unidade_money}&f por unidade'
      prices:
        price1:
          provider: 'money'
          amount: 1000.0
      regions:
        - 'mina_vip'
        - 'mina_premium'

Como funciona:

• Se regions estiver configurado com regiões, o item só será vendido automaticamente quando dropado dentro de uma dessas regiões
• Se regions: [] (vazio), o item é vendido ao ser dropado em qualquer lugar