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.

Estrutura de arquivos

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

Configuração do plugin (config.yml)

O arquivo config.yml é o núcleo do plugin, onde você controla todos os aspectos do funcionamento das espadas de farm. 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

general

Configurações gerais do sistema de espadas de farm. Esta seção controla o comportamento principal das espadas.

general:
  # Máximo de looting que uma espada pode ter
  # essencial para o sistema de stack de looting usando o item
  # deixe 0 para não ter máximo
  looting-maximum: 1500
  # Permitir que a espada possa ser usada para atacar jogadores
  attack-players: false
  # Abrir menu de evolução ao interagir com a espada (Shift+Botão direito)
  interact-menu: true
  # Mundos que a matadora não irá funcionar
  world-blacklist: []
  # Item da looting ativável
  usable-item:
    material: ENCHANTED_BOOK
    name: '&b+{looting} Pilhagem'
    lore:
      - ''
      - '&fPilhagem: &b{looting}'
      - ''
      - '&7Clique em uma espada para ativar.'

looting-maximum

Define o limite máximo de looting que uma espada pode acumular através de livros de looting.

• 0 - Sem limite (infinito)
• 1500 - Limite de 1500 níveis (recomendado para evitar valores excessivos)

Exemplo de uso:

looting-maximum: 2000  # Permite até 2000 de looting

attack-players

Controla se jogadores podem usar espadas de farm para atacar outros jogadores.

• true - Permite atacar jogadores (não recomendado, pode desbalancear PvP)
• false - Bloqueia ataques a jogadores (recomendado)

Quando desativar:

Espadas de farm geralmente têm encantamentos muito altos para farm de mobs. Permitir PvP com elas pode desbalancear completamente o combate entre jogadores.

interact-menu

Define se o jogador pode abrir o menu de evolução ao interagir com a espada (Shift + Botão Direito).

• true - Abre menu de evolução ao interagir
• false - Desativa abertura do menu por interação

world-blacklist

Lista de mundos onde as espadas de farm não funcionarão. Útil para desativar em lobbies ou mundos especiais.

Exemplo de uso:

world-blacklist: ['lobby', 'spawn', 'evento_especial']

usable-item

Configuração do item de livro de looting que pode ser aplicado nas espadas.

usable-item:
  material: ENCHANTED_BOOK
  name: '&b+{looting} Pilhagem'
  lore:
    - ''
    - '&fPilhagem: &b{looting}'
    - ''
    - '&7Clique em uma espada para ativar.'

Placeholder disponível: {looting} - Quantidade de looting que o livro adicionará

kill-normal

Sistema de restrição que força jogadores a usar espadas de farm para matar mobs. Útil para garantir que o sistema de looting seja utilizado.

kill-normal:
  # Ativar o sistema
  enable: false
  # Lista de metadatas que o sistema não vai funcionar
  blacklist-metadata: []

enable

Ativa ou desativa a restrição de matar mobs.

• true - Jogadores precisam usar espada de farm para matar mobs
• false - Jogadores podem matar mobs normalmente

Quando ativar:

Ative esta opção se quiser forçar jogadores a usar o sistema de espadas de farm. Sem uma espada de farm, não conseguirão matar mobs.

blacklist-metadata

Lista de metadatas de mobs que serão excluídos desta restrição. Mobs com estas metadatas poderão ser mortos normalmente mesmo sem espada de farm.

Exemplo de uso:

blacklist-metadata: ['boss_evento', 'mob_especial', 'mascote']

format

Sistema de formatação de valores monetários e quantidades. Controla como os números grandes são exibidos no plugin.

format:
  type: 'LETTER' # Tipos: LETTER - NUMBER
  max-decimals: 4
  formats:
    - ''
    - ''
    - 'K'
    - 'M'
    - 'B'
    - 'T'
    - 'Q'
    - 'QQ'
    - 'S'
    - 'SS'
    - 'O'
    - 'N'
    - 'D'

type

Define o tipo de formatação de números.

• LETTER - Usa letras para abreviar (1.5K, 2.3M, 5.7B)
• NUMBER - Exibe números completos (1500, 2300000, 5700000000)

Exemplo de comparação:

max-decimals

Define o número máximo de casas decimais ao exibir valores.

max-decimals: 4  # Exemplo: 1.5000K
max-decimals: 2  # Exemplo: 1.50K
max-decimals: 0  # Exemplo: 2K

formats

Lista de sufixos usados para cada magnitude de mil. A posição na lista determina a potência de 1000.

Como funciona:

• Posição 0 (unidades): '' - sem sufixo
• Posição 1 (mil): '' - sem sufixo
• Posição 2 (milhão): 'K' - 1.000 = 1K
• Posição 3 (bilhão): 'M' - 1.000.000 = 1M
• Posição 4 (trilhão): 'B' - 1.000.000.000 = 1B

Exemplo de customização:

formats:
  - ''
  - ''
  - 'mil'
  - 'mi'
  - 'bi'
  - 'tri'

Resultado: 1.5mil, 2.3mi, 5.7bi