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.

spawners.yml

categories.yml

commands.yml

config.yml

goals.txt

menus.yml

messages.yml

rewards.yml

Configuração do plugin (config.yml)

O arquivo config.yml é o coração do plugin, onde você controla todos os aspectos do funcionamento das metas colaborativas. 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 metas 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/yMetas/data.db.

redis

Configurações do servidor Redis para sincronização multi-servidor (BungeeCord/Velocity).

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 do progresso das metas entre servidores
Progresso compartilhado entre servidor de lobby e minas

Delay para carregar os dados do jogador após o login. Necessário quando o servidor de mina é separado do lobby.

# Delay em ticks (20 ticks = 1 segundo)
# Recomendado: 20 ticks
login-delay: 20

Quando ajustar:

Servidor único: 0-5 ticks
Rede com servidor separado: 20-40 ticks
Problemas de carregamento: aumentar até 60 ticks

limit

Sistema de limite para recolher recompensas. Protege o servidor de sobrecarga ao coletar muitas recompensas de uma vez.

limit:
  enabled: true
  # Máximo que irá recolher por vez
  max: 1000

Desativar ou aumentar muito o limite pode gerar lag intenso e em casos extremos crashar o servidor. Mantenha valores razoáveis (500-1500).

general

Configurações gerais do comportamento das metas.

general:
  # Deletar a recompensa ao clicar com botão direito
  right-delete-reward: true
  # Dar as recompensas das metas para todos os usuários cadastrados
  # caso "false" dará apenas para quem contribuiu
  give-reward-all: true
  # Enviar as recompensas de metas concluídas para o armazém de recompensas
  send-complete-storage: false

Opções explicadas:

right-delete-reward: Permite deletar recompensas rapidamente com clique direito
give-reward-all:
- true - Todos no servidor recebem recompensa quando meta é concluída
- false - Apenas quem contribuiu recebe
send-complete-storage:
- true - Recompensas vão direto para o armazém (evita spam de items)
- false - Recompensas são dadas no momento

Configuração recomendada para servidores grandes:

general:
  right-delete-reward: true
  give-reward-all: false  # Premia apenas contribuintes
  send-complete-storage: true  # Evita lag ao dar items

progress-bar

Configuração visual da barra de progresso exibida nos menus e mensagens.

progress-bar:
  amount: 10
  symbol: ':'
  color-yes: '&a'
  color-no: '&7'

Resultado visual: &a:::::&7:::::

Personalizações populares:

# Barra com blocos
progress-bar:
  amount: 20
  symbol: '█'
  color-yes: '&a'
  color-no: '&8'

# Barra simples
progress-bar:
  amount: 10
  symbol: '|'
  color-yes: '&e'
  color-no: '&7'

flash-goals

Sistema de metas relâmpago - metas temporárias com prazo de conclusão que aparecem aleatoriamente.

flash-goals:
  enabled: true
  # Tempo em segundos entre novas flash metas (3600s = 1 hora)
  interval: 3600
  # Duração da flash meta em segundos (900s = 15 minutos)
  duration: 900
  # Mensagens da flash-meta
  messages:
    start:
      chat: '<nl>&a&l[FlashMetas]&e Uma nova meta relâmpago foi iniciada. &aAcesse em: &f/metas&e.'
      actionbar: ''
      title: ''
    stop:
      chat: ''
      actionbar: '&aA meta relâmpago acabou.'
      title: ''
    finish:
      chat: '<nl>&a&l[FlashMetas]&e A meta relâmpago foi concluída, resgate sua recompensa em &f/metas&e.'
      actionbar: ''
      title: ''
  goals:
    blocks_break:
      # Tipo do objetivo (disponível em: goals.txt)
      goal-type: BREAK_BLOCKS
      # Material necessário
      # Para permitir todos os blocos: ALL_BLOCKS
      # Para permitir todas entidades: ALL_ENTITIES
      type: STONE
      # Quantidade necessária
      amount: 100
      # chance,recompensa (100.0 = 100% de chance)
      rewards: [ '100.0,reward1' ]
      # Ícone no menu principal
      icon:
        material: 'STONE'
        glow: true
        name: '&aFlash meta'
        lore:
          - '&7Os jogadores do servidor precisarão'
          - '&7quebrar &fPEDRAS&7 para ajudar no progresso'
          - '&7dessa meta.'
          - ''
          - '&f *Progresso: &a{actual}&7/&c{total} &8({percentage})'
          - '&f -> &7[{progressbar}&7]'
          - ''
          - '&cFinaliza em: {time}'

Como funciona:

A cada interval segundos, uma nova flash meta é iniciada aleatoriamente
Os jogadores têm duration segundos para completá-la
Se completada, todos recebem recompensas
Se o tempo acabar, a meta é cancelada

Configuração para eventos rápidos:

flash-goals:
  enabled: true
  interval: 1800  # Nova meta a cada 30 minutos
  duration: 600   # 10 minutos para completar

Múltiplas flash metas:

Você pode criar várias opções de flash metas. O plugin escolherá uma aleatoriamente:

flash-goals:
  enabled: true
  interval: 3600
  duration: 900
  goals:
    quebrar_pedra:
      goal-type: BREAK_BLOCKS
      type: STONE
      amount: 500
      rewards: [ '100.0,reward1' ]
    matar_zumbis:
      goal-type: KILL_MOBS
      type: ZOMBIE
      amount: 100
      rewards: [ '100.0,reward2' ]
    andar_blocos:
      goal-type: WALK
      type: ALL
      amount: 10000
      rewards: [ '100.0,reward3' ]

Use flash metas para manter os jogadores engajados! Configure durações curtas (5-15 minutos) e recompensas atrativas.

Nesta página