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 coração do plugin, onde você controla desde a persistência dos dados até os comandos que serão interceptados. 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

database

Define como e onde os dados das preferências dos jogadores serão armazenados. O plugin suporta três tipos de armazenamento:

• SQLITE: Armazena dados em um arquivo local (plugins/yPreferencias/data.db). Ideal para servidores pequenos ou teste.
• 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 oferecer melhor performance em alta concorrência.

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

Recomendação de configuração por tamanho de servidor:

redis

Configurações do servidor Redis para sincronização multi-servidor. Necessário apenas se você possui uma rede BungeeCord/Velocity com múltiplos servidores de mineração ou lobby.

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: 6379]
  port: 6379
  # Usuário de conexão. [EX: root]
  username: ''
  # Senha do usuário de conexão: [EX: 123]
  password: ''

Quando usar Redis:

• Rede BungeeCord/Velocity com múltiplos servidores
• Sincronização em tempo real das preferências entre servidores
• Se um jogador desativar o chat global no servidor minas, a mudança reflete imediatamente no servidor lobby

Quando NÃO usar Redis:

• Servidor único (sem proxy)
• Rede com apenas um servidor de gameplay

login-delay

Define o delay em ticks para carregar os dados do jogador após o login. Necessário para uso em servidores de mineração separados ou com proxy, onde os dados podem demorar para sincronizar.

# Delay para carregar os dados do jogador após o login.
# Necessário para uso em servidores de mineração separados.
# Recomendado: 20 ticks
login-delay: 20

Exemplos de configuração:

# Servidor único — sem proxy
login-delay: 0

# Rede com proxy (recomendado)
login-delay: 20

# Rede com proxy e muitos plugins
login-delay: 40

chat-global-nome e chat-local-nome

Definem os nomes dos canais global e local para integração com plugins de chat como LegendChat e nChat. O plugin usa estes nomes para identificar qual canal deve ser bloqueado quando o jogador desativa o chat global ou local.

# Nome do canal global (para integração com nChat / LegendChat)
chat-global-nome: 'global'

# Nome do canal local (para integração com nChat / LegendChat)
chat-local-nome: 'local'

comandos-tp

Lista de comandos de teleporte que serão interceptados. Quando o jogador desativa a preferência teleport, qualquer tentativa de usar estes comandos direcionados a ele será bloqueada com a mensagem disabled-teleport.

# Comandos de teleporte interceptados (deixe o espaço antes do nick)
comandos-tp:
  - '/tpa '
  - '/etpa '
  - '/tpahere '
  - '/etpahere '

Como funciona:

1. Jogador A desativa a preferência teleport
2. Jogador B tenta usar /tpa JogadorA
3. O plugin intercepta, detecta que JogadorA desativou teleporte
4. Jogador B recebe a mensagem: "Este jogador desativou o recebimento de solicitações de teleporte."

Extensão para mais comandos:

comandos-tp:
  - '/tpa '
  - '/etpa '
  - '/tpahere '
  - '/etpahere '
  - '/warptp '        # De outros plugins de warp
  - '/randomtp '      # De plugins de teleporte aleatório
  - '/spawn '         # Bloqueia também /spawn (opcional)

comandos-coin

Lista de comandos de pagamento/transferência de coins que serão interceptados. Quando o jogador desativa a preferência coin, estes comandos são bloqueados quando usados por outros jogadores direcionados a ele.

# Comandos de pagamento interceptados (deixe o espaço antes do nick)
comandos-coin:
  - '/pay '
  - '/money pay '
  - '/eco pay '
  - '/bal pay '

Como funciona:

1. Jogador A desativa a preferência coin
2. Jogador B tenta usar /pay JogadorA 100
3. O plugin intercepta e bloqueia a transação
4. Jogador B recebe: "Este jogador desativou o recebimento de coins."

Preferências Built-in

O plugin possui preferências internas prontas para uso. Cada uma pode ser exibida ou ocultada do menu definindo seu nome como vazio ('') no menus.yml.

Preferências internas (sem dependência)

Estas preferências funcionam sem plugins externos:

Preferências de chat (com LegendChat / nChat)

Preferências de integração

Dependem de plugins específicos para funcionar:

Preferências customizadas (PlaceholderAPI)

Além das preferências built-in, você pode criar preferências customizadas que dependem de placeholders do PlaceholderAPI. Isso permite integrar qualquer plugin que tenha placeholders PAPI.

Exemplo de preferência customizada:

custom-preferences:
  duplo-drop:
    display-name: '&fDuplo Drop'
    placeholder: '%yminas_droplvl%'
    on-value: '3'
    executor: console
    commands-when-on:
      - 'toggle duplo-drop {player} off'
    commands-when-off:
      - 'toggle duplo-drop {player} on'
    on-item:
      material: 'DIAMOND'
      name: '&fDuplo Drop'
      lore:
        - ''
        - '&7Estado: &aLigado'
        - ''
        - '&eClique para desativar.'
    off-item:
      material: 'COAL'
      name: '&fDuplo Drop'
      lore:
        - ''
        - '&7Estado: &cDesligado'
        - ''
        - '&eClique para ativar.'

Dicas importantes