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.

midnight_wanderer.yml

night_hunter.yml

secret_sequence.yml

secret-types.txt

battlepass.yml

spawners.yml

categories.yml

commands.yml

config.yml

data.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 missões. 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 missões 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/yMissoes/data.db.

redis

Configurações do servidor Redis para sincronização multi-servidor (BungeeCord/Velocity). O Redis permite que o progresso das missões seja compartilhado entre múltiplos servidores em tempo real.

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 de progresso de missões entre servidores
Missões colaborativas entre jogadores em diferentes servidores

O Redis é essencial para redes com lobby + servidores de jogo separados, garantindo que o progresso das missões seja compartilhado.

Delay para carregar os dados do jogador após o login. Necessário principalmente para servidores de mina separados ou redes BungeeCord onde há transferência de servidores.

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

Valores recomendados:

Servidor único: 5-10 ticks
Rede BungeeCord: 20-30 ticks
Servidores com lag: 30-40 ticks

Valores muito baixos podem causar perda de dados. Valores muito altos podem atrasar a exibição das missões para o jogador.

limit

Sistema de limite para recolher recompensas de uma só vez. Este limite previne lag e possíveis crashes ao coletar grandes quantidades de recompensas simultaneamente.

# Este limite serve para recolher recompensas
# Desativar ou aumentar o limite pode gerar lag
# e em alguns casos crashar o servidor.
limit:
  enabled: true
  # Máximo que irá recolher por vez
  max: 1000

Configuração recomendada:

Servidores pequenos (< 50 jogadores): max: 500
Servidores médios (50-200 jogadores): max: 1000
Servidores grandes (200+ jogadores): max: 2000

general

Configurações gerais do funcionamento das missões.

general:
  # Deletar a recompensa ao clicar com botão direito
  right-delete-reward: true
  # Dar as recompensas das missões para todos os usuários cadastrados
  # caso "false" dará apenas para quem contribuiu
  give-reward-all: true
  # Enviar as recompensas de missões concluídas para o armazém de recompensas
  send-complete-storage: false
  # Atualizar o countdown de liberação nos menus abertos
  menu-updater: true

Detalhamento das opções:

right-delete-reward: Permite que jogadores deletem recompensas clicando com botão direito no menu
give-reward-all:
- true - Todos os jogadores online recebem recompensas (servidor colaborativo)
- false - Apenas quem contribuiu recebe (servidor competitivo)
send-complete-storage:
- true - Recompensas vão para o armazém automaticamente
- false - Jogador precisa coletar manualmente no menu
menu-updater: Atualizar o countdown de liberação nos menus abertos

Configuração recomendada para servidor colaborativo:

general:
  right-delete-reward: true
  give-reward-all: true
  send-complete-storage: true

Configuração recomendada para servidor competitivo:

general:
  right-delete-reward: false
  give-reward-all: false
  send-complete-storage: false

progress-bar

Configuração visual da barra de progresso exibida nas missões.

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

Como funciona:

amount: Quantidade de símbolos na barra (10 = barra com 10 caracteres)
symbol: Caractere usado para desenhar a barra
color-yes: Cor da parte completa (verde por padrão)
color-no: Cor da parte incompleta (cinza por padrão)

Exemplo visual:

Com 50% de progresso: &a:::::&7:::::

Personalizações populares:

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

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

npc

Sistema de NPC (Citizens) para abrir o menu de missões. Permite criar NPCs interativos que os jogadores podem clicar para acessar as missões.

npc:
  skin: 'Pitombaa'
  hologram:
    offset: 3.4
    hologram:
      - '&6&lMISSÕES'
      - '&7Complete missões e ganhe recompensas!'
      - '[item]EMERALD'

Opções:

skin: Nome do jogador cuja skin será usada no NPC
offset: Altura do holograma acima do NPC (em blocos)
hologram: Linhas do holograma (use [item]MATERIAL para exibir itens)

Comandos do NPC:

/missoes setnpc - Cria um NPC na sua localização
/missoes delnpc - Remove o NPC

Requer o plugin Citizens instalado para funcionar.

flash-goals

Sistema de missões relâmpago - missões temporárias com prazo de finalização que aparecem aleatoriamente.

flash-goals:
  enabled: true
  # Tempo em segundos entre novas flash missões
  interval: 3600
  # Duração da flash-mission em segundos
  duration: 900
  # Mensagens da flash-mission
  messages:
    start:
      chat: '<nl>&a&l[FlashMissions]&e Uma nova missão relâmpago foi iniciada. &aAcesse em: &f/missoes&e e seja o primeiro a concluir.'
      actionbar: ''
      title: ''
    stop:
      chat: ''
      actionbar: '&aA missão relâmpago acabou e ninguém a completou.'
      title: ''
    finish:
      chat: '<nl>&a&l[FlashMission]&e A missão relâmpago foi concluída por &f{player}&e, resgate sua recompensa em &f/missoes&e.'
      actionbar: ''
      title: ''

Como funciona:

A cada interval segundos, uma missão aleatória é iniciada
Jogadores têm duration segundos para completar
O primeiro a completar ganha as recompensas
Se ninguém completar, a missão expira

Configurações de tempo:

interval (segundos):
- 1800 = 30 minutos
- 3600 = 1 hora
- 7200 = 2 horas
duration (segundos):
- 300 = 5 minutos
- 900 = 15 minutos
- 1800 = 30 minutos

Exemplo de configuração para eventos rápidos:

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

Configurando objetivos das flash missions

flash-goals:
  goals:
    blocks_break:
      # Tipo do objetivo (disponível em: goals.txt)
      goal-type: BREAK_BLOCKS
      # Material necessário (ALL_BLOCKS para todos, ou material específico)
      type: STONE
      # Quantidade necessária
      amount: 100
      # Recompensas (formato: chance,recompensa)
      rewards: [ '100.0,reward1' ]
      # Ícone no menu principal
      icon:
        material: 'STONE'
        glow: true
        name: '&aFlash Mission'
        lore:
          - '&7Quebre &f100 PEDRAS&7 antes do tempo acabar!'
          - ''
          - '&f *Progresso: &a{actual}&7/&c{total} &8({percentage})'
          - '&f -> &7[{progressbar}&7]'
          - ''
          - '&cFinaliza em: {time}'

Você pode criar múltiplos objetivos:

flash-goals:
  goals:
    blocks_break:
      goal-type: BREAK_BLOCKS
      type: STONE
      amount: 100
      rewards: [ '100.0,reward1' ]
      icon: # ...
    
    mobs_kill:
      goal-type: KILL_MOBS
      type: ZOMBIE
      amount: 50
      rewards: [ '100.0,reward2', '50.0,reward3' ]
      icon: # ...
    
    players_kill:
      goal-type: KILL_PLAYERS
      type: ALL
      amount: 5
      rewards: [ '100.0,reward_pvp' ]
      icon: # ...

Tipos de objetivos disponíveis:

Consulte o arquivo goals.txt para ver todos os 15 tipos disponíveis:

KILL_MOBS, KILL_PLAYERS, DEATH, CRAFT_ITEM
BREAK_BLOCKS, PLACE_BLOCKS, WALK
YMINAS, YMINASPACKETS
YCAMPO, YPLANTACOES
YPESCA, YPESCASIMPLES
YBOSSES, YSTACKBOSSES

secret

Sistema de missões secretas - conquistas ocultas que testam dedicação e habilidade dos jogadores. Os objetivos não são revelados, apenas pistas criptografadas.

secret:
  # Ativar/desativar o sistema de conquistas secretas
  enabled: true
  # Notificar todos os jogadores quando alguém consegue uma conquista secreta
  announce: true
  # Sistema de pistas no chat
  hint:
    # Ativar as pistas
    enabled: true
    # Intervalo entre pistas em segundos
    interval: 60
  # Efeitos quando conquista é desbloqueada
  unlock-effects:
    # Som tocado quando uma conquista secreta é desbloqueada
    sound: 'ENTITY_PLAYER_LEVELUP'
    firework: true

Como funciona:

Jogadores não sabem o que precisam fazer para desbloquear
Pistas aparecem periodicamente no chat (se hint.enabled: true)
Quando alguém desbloqueia, todos são notificados (se announce: true)
Efeitos visuais e sonoros celebram a conquista

Configuração recomendada para máximo mistério:

secret:
  enabled: true
  announce: true      # Gera competitividade
  hint:
    enabled: true
    interval: 300     # Pistas a cada 5 minutos (não muito frequente)
  unlock-effects:
    sound: 'ENTITY_PLAYER_LEVELUP'
    firework: true

Configuração recomendada para mais dicas:

secret:
  enabled: true
  announce: true
  hint:
    enabled: true
    interval: 60      # Pistas a cada 1 minuto (mais frequente)
  unlock-effects:
    sound: 'ENTITY_PLAYER_LEVELUP'
    firework: true

Tipos de conquistas secretas disponíveis:

O plugin oferece 13 tipos diferentes de conquistas secretas. Consulte o arquivo addons/secret-types.txt para documentação completa sobre cada tipo:

KILL_MOBS_NIGHT - Matar mobs em condições específicas à noite
LOCATION_TIME - Estar em local e horário específicos
ACTION_SEQUENCE - Executar sequência de ações (pular, agachar, etc)
MISSION_STREAK - Completar missões consecutivas
POTION_EFFECT_TIME - Manter efeito de poção prolongado
E mais 8 tipos...

As conquistas secretas são configuradas individualmente em addons/secrets/*.yml.

Crie pistas sutis e poéticas para as conquistas secretas. Evite revelar diretamente o objetivo!

Dicas de configuração

Para servidores colaborativos

general:
  give-reward-all: true
  send-complete-storage: true

flash-goals:
  enabled: true
  interval: 3600      # 1 hora
  duration: 1800      # 30 minutos para completar

Para servidores competitivos

general:
  give-reward-all: false
  send-complete-storage: false

flash-goals:
  enabled: true
  interval: 1800      # 30 minutos
  duration: 600       # 10 minutos para completar (mais rápido)

Para redes multi-servidor

database:
  storage-type: HIKARI  # Melhor performance

redis:
  enabled: true         # Essencial para sincronização
  host: '127.0.0.1'
  port: 6379

login-delay: 30         # Maior delay para garantir sincronização

Sempre faça backup das configurações antes de fazer alterações significativas!

Nesta página