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

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 sistema de aluguel de feiras. Abaixo estão todas as 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 das feiras 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/yFeiras/data.db.

general

Configurações gerais que controlam o comportamento básico do sistema de feiras.

general:
  # Porcentagem atual referente ao tempo total que irá permitir renovar o aluguel
  renew-percent: 10.0
  # Quantia máxima de feiras que um jogador pode ter
  feira-max: 2
  # Delay padrão (em segundos) para anunciar a feira
  # Pode ser sobrescrito com a permissão yfeiras.anuncio_delay.<segundos>
  announce-delay: 60
  hologram-lines:
    rent:
      - '[item]{icon}'
      - '&fFeira {feira}'
      - '&fDono: &a{owner}'
      - '&fO aluguel vence em: &a{expire}'
    available:
      - '[item]{icon}'
      - '&fFeira {feira}'
      - '&7Renovação a cada: &f{time_to_renew}'
      - '&aFeira disponível para alugar!'

Explicação dos parâmetros:

renew-percent: Define quando o jogador pode renovar antecipadamente o aluguel. Com valor 10.0, o jogador poderá renovar quando faltarem 10% ou menos do tempo total. Por exemplo, se o aluguel é semanal (7 dias), poderá renovar quando faltarem menos de 16.8 horas (10% de 7 dias).
feira-max: Limite padrão de feiras que um jogador pode alugar simultaneamente. Este valor pode ser aumentado por jogador usando a permissão yfeiras.max.[numero].
announce-delay: Delay padrão em segundos entre anúncios de feira (/feira anunciar). Pode ser sobrescrito por jogador com a permissão yfeiras.anuncio_delay.<segundos> (ex: yfeiras.anuncio_delay.30).
hologram-lines: Define as linhas do holograma exibido acima de cada feira. Existem dois tipos:
- rent: Exibido quando a feira está alugada
- available: Exibido quando a feira está disponível para aluguel

Placeholders disponíveis nos hologramas:

{icon} - Exibe o ícone da feira como item flutuante (use [item] antes)
{feira} - Nome da feira
{owner} - Nome do dono que alugou
{expire} - Tempo restante até vencer o aluguel
{time_to_renew} - Período de renovação (diário, semanal, mensal)

Exemplo prático:

Se você quiser que jogadores renovem apenas no último dia de um aluguel semanal, use renew-percent: 14.28 (1 dia é ~14.28% de 7 dias).

Use renew-percent baixo (5-10%) para evitar que jogadores renovem muito cedo e acumulem tempo excessivo de aluguel.

wand

Configuração da varinha usada por administradores para selecionar a área de uma feira.

wand:
  material: 'GOLD_AXE'
  name: '&eSeleção de Área'
  lore: [ '&fFeira: &f{feira}', '', '&aEsquerdo -> POS1', '&aDireito -> POS2' ]

Como funciona:

Ao usar o comando /feira editar [nome] e clicar no item de área, o administrador recebe esta varinha no inventário. Com ela:

Clique esquerdo em um bloco define a primeira posição (POS1)
Clique direito em um bloco define a segunda posição (POS2)
As duas posições formam uma região cubóide que delimita a área da feira

Personalizando a varinha:

material: Qualquer item válido do Minecraft. Use formato MATERIAL:DATA para versões antigas (ex: WOOL:14)
name: Nome exibido no item
lore: Lista de linhas de descrição. Use {feira} para exibir o nome da feira sendo configurada

A seleção de área funciona similar ao WorldEdit, criando uma região entre dois pontos diagonalmente opostos.