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.

Após alterar a configuração, é necessário reiniciar o servidor.

Estrutura de arquivos

Abaixo está um exemplo de como é a estrutura de arquivos do plugin. Clique em uma pasta para expandi-la.

commands.yml

config.yml

data.yml

discord.yml

economies.yml

menus.yml

messages.yml

Configuração do plugin (config.yml)

O arquivo config.yml é o coração do plugin, onde você controla todos os aspectos do funcionamento do sistema de leilões. Abaixo estão as principais opções disponíveis com explicações detalhadas.

debug-mode

Ativa ou desativa o modo de depuração. Quando ativado, o plugin registrará informações detalhadas no console para ajudar a identificar problemas.

# Determina o funcionamento da depuração. Valores válidos: [false, true]
debug-mode: false

Mantenha desativado em produção, pois pode gerar muitos logs e afetar a performance.

database

Define como e onde os dados dos leilões serão armazenados. O plugin suporta três tipos de armazenamento:

SQLITE: Armazena dados em um arquivo local. Ideal para servidores pequenos.
MYSQL: Conecta a um servidor MySQL externo. Recomendado para servidores médios.
HIKARI: Usa pool de conexões para MySQL. Recomendado para servidores grandes por melhor performance.

database:
  # Determina o tipo de banco de dados. Valores válidos: [SQLITE, MYSQL, HIKARI (recomendado)]
  storage-type: SQLITE

  # Dados para conexão ao banco de dados MYSQL.
  data:
    # Endereço de conexão do banco de dados. [EX: 127.0.0.1]
    host: localhost
    # Porta de conexão do banco de dados. [EX: 3306]
    port: 3306
    # Nome do banco de dados a ser conectado. [EX: minecraft]
    database: ''
    # Usuário de conexão. [EX: root]
    username: ''
    # Senha do usuário de conexão: [EX: 123]
    password: ''

Se usar SQLITE, não precisa preencher os dados de conexão. O arquivo será criado automaticamente em plugins/yLeilao/data.db.

general

Configurações gerais do sistema de leilões.

general:
  # Abrir o menu auctions diretamente ao digitar /leilao
  # caso contrário, irá abrir o menu principal
  open-auctions-menu: false
  # Tempo padrão para começar o leilão (em segundos)
  default-time: 1800
  # Quantia máxima de leilões simultâneos que o servidor pode ter
  # deixe 0 para ser infinito
  max-auctions: 10
  # Quantia máxima de leilões simultâneos que o jogador pode fazer
  # deixe 0 para ser infinito
  player-max-auctions: 1
  # Taxa que o leiloador irá pagar sobre o lance vencedor (em porcentagem)
  auction-tax: 10.0
  # Tempo que irá acrescentar quando um lance maior que um já existente for computado (em segundos)
  bid-sum-time: 30
  # Tempo mínimo para iniciar um leilão (em segundos)
  min-time: 900
  # Tempo máximo para iniciar um leilão (em segundos)
  max-time: 21600

Destaques importantes:

open-auctions-menu: Se true, o comando /leilao abre diretamente o menu de leilões; se false, abre o menu principal
default-time: 1800 segundos = 30 minutos de duração padrão
max-auctions: Limite o total de leilões simultâneos para evitar sobrecarga
player-max-auctions: Use a permissão yleilao.auction_limit.[numero] para limites customizados por jogador
auction-tax: Com 10%, se um item for arrematado por 1000 coins, o leiloador receberá 900 coins
bid-sum-time: Adiciona tempo quando há disputa de lances, evitando términos abruptos
min-time: 900 segundos = 15 minutos (tempo mínimo de duração)
max-time: 21600 segundos = 6 horas (tempo máximo de duração)

Configure bid-sum-time para 30-60 segundos para dar aos jogadores tempo de reagir quando forem superados.

black-list

Sistema de blacklist de itens que não podem ser leiloados.

black-list:
  # Materiais que estarão na black-list
  materials: [ 'STONE', 'LOG:0' ]
  # NBTTags que estarão na black-list
  nbt-tags: []

Exemplo de uso:

black-list:
  materials: [ 'BEDROCK', 'BARRIER', 'COMMAND_BLOCK' ]
  nbt-tags: [ 'custom-blocked', 'admin-item' ]

Use isto para bloquear itens administrativos, baratos demais ou que causam problemas.

white-list

Sistema de whitelist de itens que podem ser leiloados. Quando ativado, apenas os itens da lista poderão ser leiloados.

white-list:
  # Ativar a whitelist
  enabled: false
  # Materiais que estarão na white-list
  materials: [ 'LOG:1', 'TRIPWIRE_HOOK' ]

Quando usar:

Servidores temáticos onde apenas certos itens devem ser comercializados
Eventos especiais com itens específicos
Controle rígido da economia do servidor

Quando a whitelist está ativada, a blacklist é ignorada. Use uma ou outra, não ambas.

discordhook e webhook

Sistema de notificações quando itens são anunciados no leilão.

general:
  # Sistema de notificar via yDiscordHook
  discordhook:
    enabled: true
    channel: ''
    embed: ''
  
  # Sistema de notificar via webhook
  webhook:
    enabled: true
    embed: 'new_item'

discordhook: Requer o plugin yDiscordHook instalado. Configure o canal e embed no arquivo de configuração do yDiscordHook.

webhook: Usa o arquivo discord.yml para configurar a URL do webhook e os embeds personalizados.

Escolha apenas um dos sistemas (discordhook OU webhook) para evitar notificações duplicadas.

npc

Sistema de NPC para acesso rápido ao menu de leilões.

npc:
  skin: 'Pitombaa'
  hologram:
    offset: 3.4
    hologram:
      - '&6&lLEILÃO'
      - '&7Faça o comércio rápido dos itens!'
      - '[item]EMERALD'

Como usar:

Use /leilao setnpc olhando para o local onde deseja criar o NPC
O NPC será criado com a skin configurada
Clique no NPC para abrir o menu de leilões
Use /leilao delnpc para remover o NPC

Personalização do holograma:

offset: Altura do holograma acima do NPC (3.4 = bem acima da cabeça)
Use [item]MATERIAL para exibir um item flutuante no holograma

Nesta página