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

economies.yml

menus.yml

messages.yml

missions.yml

normal.yml

lightning.yml

global.yml

secret.yml

vip.yml

pvp.yml

cooperative.yml

boss.yml

waves.yml

default.yml

halloween.yml

natal.yml

Configuração do plugin (config.yml)

O arquivo config.yml controla o comportamento geral do airdrop: banco de dados, limites, spawn, proteção, animações, radar, autostart e compra de bússola.

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.

# 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 como e onde os dados 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/HIKARI.
  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.

redis

Configurações do servidor Redis para sincronização multi-servidor.

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

Delay em ticks para carregar os dados depois do login. Útil em servidores de mina separados.

# Recomendado: 20 ticks
login-delay: 20

general

Sistemas gerais do airdrop.

general:
  # Máximo de airdrops ativos simultâneos no servidor
  max-active-airdrops: 5
  # Tempo (segundos) padrão até a caixa expirar se não for aberta
  default-expire-seconds: 600
  # Tempo (segundos) de captura padrão (segurar botão direito)
  default-capture-seconds: 5
  # Jogadores necessários no modo cooperativo (fallback se o evento não definir)
  cooperative-players: 5
  # Raio (blocos) para considerar jogadores no cooperativo
  cooperative-radius: 8.0
  # Intervalo de checagem de captura (ticks)
  capture-check-ticks: 5
  # Intervalo (ticks) da lógica pesada (expiração, chuva). Queda roda todo tick.
  tick-interval: 10

Opção	Descrição
`max-active-airdrops`	Limite global de airdrops ativos ao mesmo tempo.
`default-expire-seconds`	Expiração padrão se o evento não definir.
`default-capture-seconds`	Tempo padrão segurando o botão direito.
`cooperative-players`	Fallback de jogadores no modo cooperativo.
`cooperative-radius`	Raio em blocos do cooperativo.
`capture-check-ticks`	Frequência da checagem de captura.
`tick-interval`	Intervalo da lógica pesada (expiração/chuva).

general.hack-protection

Proteção básica contra hacks ao interagir com a caixa.

  hack-protection:
    # Se true, valida reach e cliques por segundo
    enabled: true
    # Máximo de cliques por segundo permitidos
    max-clicks-per-second: 20
    # Distância máxima (blocos) para clicar na caixa
    max-reach: 6.0
    # Se true, cancela a ação ao detectar comportamento suspeito
    cancel-on-detect: true

general.location

Sistema de localização do spawn do airdrop.

  location:
    # Mundos onde o airdrop pode nascer (nome exato do mundo)
    worlds:
      - world
    # Altitude mínima / máxima do chão sólido
    min-y: 40
    max-y: 180
    # Distância do spawn do mundo (usada se não achar perto de players)
    min-distance-from-spawn: 10
    max-distance-from-spawn: 400
    # Distância de jogadores online
    min-distance-from-players: 5
    max-distance-from-players: 250
    # true = prioriza spawn perto de jogadores (recomendado)
    near-players: true
    # Se true, só usa chunks já carregadas
    only-loaded-chunks: false
    # Se true, carrega a chunk ao escolher o local
    load-chunk: true
    # Tentativas por fase de busca (total ~3-4x isso)
    max-attempts: 80
    # Biomas permitidos (vazio = todos). Ex: [DESERT, PLAINS]
    biomes: []
    # Regiões WorldGuard permitidas (vazio = qualquer). Ex: [arena, pvp]
    regions: []

Exemplo com filtro de bioma e região:

  location:
    worlds:
      - world
      - world_pvp
    near-players: true
    biomes: [PLAINS, DESERT]
    regions: [arena, pvp]

general.anti-abuse

Locais onde o airdrop nunca deve nascer.

  anti-abuse:
    block-lava: true
    block-water: true
    block-leaves: true
    block-trees: true
    block-caves: true
    block-ceiling: true
    block-void: true

general.protection

Proteção da caixa enquanto fechada.

  protection:
    # Impede quebrar o bloco
    break: true
    # Impede TNT destruir
    tnt: true
    # Impede creeper destruir
    creeper: true
    # Impede pistão mover
    piston: true
    # Impede água/lava empurrar
    water: true
    # Impede fogo queimar
    fire: true

general.fall

Configuração padrão da animação de queda (altura, velocidade, partículas e materiais dos visuais PARACHUTE, BALLOON, PLANE, HELICOPTER, UFO, ROCKET e SHIP).

  fall:
    # Altura inicial acima do alvo (blocos)
    height: 40
    # Velocidade de queda em blocos por tick (0.4 ≈ suave; 0.8 = mais rápido)
    speed: 0.45
    # Exibir partículas durante a queda
    particles: true
    fire: false
    smoke: true
    lightning: false
    explosion: false

Os materiais de cada visual (parachute, balloon, plane, etc.) ficam sob general.fall no mesmo arquivo. A animação usada por evento é definida em events/*.yml → animation.

general.radar

Sistema de radar (item bússola NBT).

  radar:
    # Intervalo de atualização (ticks)
    update-ticks: 20
    # Distância máxima de rastreio (blocos)
    max-distance: 500
    # Exibir bossbar (se suportado)
    bossbar: true
    # Exibir actionbar com distância/direção
    actionbar: true

general — temporadas e clima

  # Ativar sistema de temporadas (pasta seasons/)
  seasons-enabled: true
  # Temas por bioma (efeitos visuais)
  biome-themes-enabled: true
  # Efeitos especiais com chuva/tempestade
  weather-effects-enabled: true
  # Multiplicador de chance de spawn automático à noite
  night-chance-multiplier: 1.5

general.sounds

Sons do Bukkit usados nos eventos do plugin.

  sounds:
    drop-start: 'ENTITY_FIREWORK_ROCKET_LAUNCH'
    drop-land: 'ENTITY_GENERIC_EXPLODE'
    open-success: 'ENTITY_PLAYER_LEVELUP'
    open-fail: 'ENTITY_VILLAGER_NO'
    capture-tick: 'BLOCK_NOTE_BLOCK_PLING'
    hack-success: 'ENTITY_EXPERIENCE_ORB_PICKUP'
    wave-spawn: 'ENTITY_ZOMBIE_AMBIENT'
    boss-spawn: 'ENTITY_WITHER_SPAWN'
    rain-start: 'WEATHER_RAIN'

autostart

Auto-start com vários tipos independentes. Cada tipo possui whitelist de eventos (events/*.yml). Lista vazia = todos os eventos com enabled: true.

autostart:
  # Ligar/desligar o sistema inteiro
  enabled: true
  types:
    comum:
      enabled: true
      interval-min-seconds: 300
      interval-max-seconds: 600
      min-players: 1
      amount: 1
      chance: 100
      warn-seconds: 30
      worlds: []
      events:
        - normal
        - lightning
        - secret
    especial:
      enabled: true
      interval-min-seconds: 900
      interval-max-seconds: 1200
      min-players: 3
      amount: 1
      chance: 80
      warn-seconds: 60
      worlds: []
      events:
        - boss
        - waves
        - global
        - pvp
        - cooperative
        - vip

Campo	Descrição
`interval-min-seconds`	Intervalo mínimo entre spawns.
`interval-max-seconds`	Intervalo máximo entre spawns.
`min-players`	Jogadores online mínimos para spawnar.
`amount`	Quantidade de airdrops por ciclo.
`chance`	Chance % de spawnar no ciclo.
`warn-seconds`	Aviso global antes do spawn.
`worlds`	Mundos permitidos (vazio = usa `general.location`).
`events`	Whitelist de chaves de `events/*.yml`.

compass-buy

Bússola/radar comprável no menu de airdrops ativos (/ad list).

compass-buy:
  # Permissão para pegar a bússola no menu (vazio = todos)
  permission: 'yairdrop.compass'
  # Economias cobradas ao pegar (chave de economies.yml → valor).
  # Deixe vazio ou comente as linhas para grátis.
  costs:
    money: 1000
    # cash: 50

status

Textos coloridos dos status exibidos ao jogador.

status:
  falling: '&eCaindo'
  landed: '&aNo chão'
  capturing: '&6Capturando'
  locked: '&cTrancado'
  opened: '&bAberto'
  expired: '&7Expirado'
  fighting: '&cCombate'
  boss: '&5Boss'
  waves: '&dOndas'

Outros arquivos

Arquivo / pasta	Página
`commands.yml`	Comandos
`economies.yml`	Economias
`menus.yml`	Menus
`messages.yml`	Mensagens
`missions.yml`	Missões
`events/*.yml`	Eventos
`seasons/*.yml`	Temporadas

Nesta página