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

jewelries.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 joias. 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 dos jogadores 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/yManopla/data.db.

redis

Configurações do servidor Redis para sincronização entre servidores.

# Configurações do servidor redis
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: ''

Define o tempo de espera em ticks antes de carregar os dados do jogador após o login. Útil para sincronização em servidores com mina separada ou sistemas BungeeCord/Velocity.

# Delay para carregar os dados depois do login
# Necessário para usar em servidor de mina separado
# Recomendado: 20 ticks
login-delay: 20

Quando ajustar este valor:

Servidor único sem proxy: 0 a 5 ticks
Servidor com mina separada: 20 ticks (1 segundo)
Rede BungeeCord/Velocity: 40 ticks (2 segundos)

20 ticks equivalem a 1 segundo no Minecraft. Este delay garante que os dados do jogador sejam carregados corretamente antes de aplicar os efeitos das joias.

world-blacklist

Lista de mundos onde os efeitos de poção das joias não funcionarão. Use isso para desabilitar os efeitos em arenas PvP, lobby ou mundos específicos.

# Blacklist de mundos que os efeitos (poções) não irão funcionar
world-blacklist: []

Exemplo de uso:

world-blacklist: ['world_lobby', 'world_eventos', 'arena_pvp']

Casos de uso comuns:

Lobby: Evitar que jogadores tenham vantagens no spawn
Eventos: Garantir equilíbrio em competições
PvP Arena: Criar combates balanceados

remove-jewelries / equip-jewelries

Controla se os jogadores podem remover ou equipar joias neste servidor. Essencial desativar em servidores de mina.

# Permite remover joias. (Essencial desativar para servidores de mina, etc)
remove-jewelries: true
# Permite equipar joias. (Essencial desativar para servidores de mina, etc)
equip-jewelries: true

Quando desativados, as mensagens jewelry-remove-disabled e jewelry-equip-disabled são enviadas.

slots

Configurações do sistema de slots de joias. Cada slot permite ao jogador equipar uma joia adicional.

slots:
  # Quantia padrão de slots que o jogador irá ter
  default: 1
  # Quantia máxima de slots que o jogador poderá ter
  max: 20
  # Item do slot que será ativável
  item:
    material: 'HOPPER'
    name: '&bSlots'
    lore:
      - ''
      - '&fQuantia: &a{amount}'
      - ''
      - '&7Clique com botão direito para ativar.'

default

Define quantos slots cada jogador terá ao entrar pela primeira vez no servidor.

slots:
  default: 1

Recomendações:

Servidor casual: 3 a 5 slots iniciais
Servidor competitivo: 1 slot inicial (progresso gradual)
Servidor donation: 1 slot inicial (venda de slots adicionais)

max

Define o limite máximo de slots que um jogador pode ter. Este valor limita quantas joias podem ser equipadas simultaneamente.

slots:
  max: 20

O valor máximo deve ser compatível com a quantidade de slots configurados no menu (menus.yml). Se definir max como 20, certifique-se de ter pelo menos 20 slots disponíveis no menu.

Balanceamento recomendado:

Poucos slots (3-5): Jogadores precisam escolher estrategicamente quais joias equipar
Médio slots (6-10): Equilíbrio entre variedade e limitação
Muitos slots (15+): Permite equipar muitas joias, pode desbalancear o servidor

item

Configura o item físico que representa slots adicionais. Jogadores podem clicar com o botão direito neste item para adicionar slots à sua manopla.

slots:
  item:
    material: 'HOPPER'
    name: '&bSlots'
    lore:
      - ''
      - '&fQuantia: &a{amount}'
      - ''
      - '&7Clique com botão direito para ativar.'

Placeholders disponíveis:

Placeholder	Descrição
`{amount}`	Quantidade de slots que o item irá adicionar

Exemplo personalizado:

slots:
  item:
    material: 'NETHER_STAR'
    name: '&6&lSlot da Manopla'
    lore:
      - ''
      - '&7Adicione &e{amount} &7slot(s) à sua manopla'
      - '&7para equipar mais joias poderosas!'
      - ''
      - '&e▸ &fClique direito para usar'

Use /manopla giveslot <jogador> <quantidade> para dar slots aos jogadores. O item configurado aqui será entregue ao inventário do jogador.

Nesta página