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

contraband.yml

economies.yml

menus.yml

messages.yml

Como navegar nesta seção

Cada arquivo da pasta de configuração possui uma página dedicada com explicações e exemplos reais:

config.yml: núcleo do plugin (banco de dados, redis, polícia, revista, punições e procurados).
commands.yml: comandos principais e aliases.
messages.yml: mensagens de chat e actionbar com placeholders.
menus.yml: layouts e itens dos menus.
economies.yml: providers de economia e parâmetros de exibição.
contraband.yml: itens ilegais, multas e comandos por item.

Configuração principal (config.yml)

O arquivo config.yml é o coração do plugin. Nele você define desde integração de dados até regras de inspeção, punições e recompensa.

debug-mode

Ativa ou desativa o modo de depuração para diagnóstico de problemas.

# Modo de depuração para correção de problemas no plugin.
debug-mode: false

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

database

Define o tipo de armazenamento e os dados de conexão quando usar MySQL/Hikari.

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: ''

redis

Configuração de Redis para sincronização entre servidores.

redis:
  # Ativar a conexão com o redis
  enabled: false
  # Endereço de conexão. [EX: 127.0.0.1]
  host: 'localhost'
  # Porta de conexão. [EX: 3306]
  port: 6379
  # Usuário de conexão. [EX: root]
  username: ''
  # Senha do usuário de conexão: [EX: 123]
  password: ''

police

Controla contratação de policiais, limite de vagas, duração do contrato e regras de conduta.

police:
  # Preço para virar policial.
  contract-price: 50000.0
  # Economia usada para pagar o contrato (chave do economies.yml).
  contract-provider: 'money'
  # Preços multi-economia do contrato (chave = economia do economies.yml).
  # Se preenchido, tem prioridade sobre contract-price/contract-provider.
  contract-prices:
    money: 50000.0
  # Duração do contrato (s, m, h, d).
  contract-duration: '7d'
  # Limite máximo de policiais ativos.
  max-officers: 10
  # Remove automaticamente o cargo quando o contrato expira.
  remove-role-on-expire: true
  # Permite renovar contrato ativo.
  allow-renew-contract: true
  # Permite sair manualmente da polícia.
  allow-leave: true
  # Impede policial de portar contrabando.
  block-contraband: true

inspection e inspection-baton

Define regras da revista (/police inspect) e do Bastão da Revista.

inspection:
  # Distância máxima entre policial e alvo.
  max-distance: 5
  # Tempo da revista (em segundos).
  duration: 5
  # Cooldown da revista por policial (em segundos).
  cooldown: 30

inspection-baton:
  # Ativa o sistema do bastão.
  enabled: true
  # Entrega o bastão ao virar policial.
  give-on-become-officer: true

contraband-detection, punishment e officer-reward

Essas seções controlam como o plugin identifica itens ilegais e qual ação executa após uma apreensão.

contraband-detection:
  # Usa NBT interno para identificação (recomendado).
  use-nbt: true

punishment:
  # Cobra multa do alvo via economia.
  charge-fine: true
  # Multiplica multa pela quantidade de itens.
  fine-per-item: true

officer-reward:
  # Ativa sistema de recompensa.
  enabled: true
  # Tipo da recompensa:
  # - PERCENTAGE, FIXED, COMMAND_ONLY, NONE
  type: PERCENTAGE

wanted

Gerencia o sistema de procurados, incluindo tempo por fuga/apreensão e captura por bastão.

wanted:
  # Ativa o sistema de procurados.
  enabled: true
  # Tempo de procurado ao fugir de revista.
  duration-on-escape: '10m'
  # Tempo de procurado ao ser pego com contrabando.
  duration-on-caught: '15m'
  capture:
    enabled: true
    fines:
      money: 25000.0
    behavior: 'FULL_REQUIRED'

Próximos arquivos

Agora siga para as páginas individuais de cada arquivo para ver todas as chaves completas e exemplos detalhados exatamente como estão na configuração real do plugin.

Nesta página