Configuração

O ySkills possui um sistema de configuração modular e organizado. Esta página explica a estrutura de arquivos e as configurações principais.

Estrutura de Arquivos

config.yml

messages.yml

menus.yml

commands.yml

mining.yml

excavation.yml

woodcutting.yml

herbalism.yml

swords.yml

axes.yml

archery.yml

fishing.yml

alchemy.yml

acrobatics.yml

super_breaker.yml

tree_feller.yml

skill_shot.yml

...

Organização Modular

Cada skill e habilidade possui seu próprio arquivo de configuração, facilitando a personalização e manutenção.

config.yml

O arquivo principal de configuração do plugin.

Debug

# Modo de depuração para correção de problemas no plugin
debug-mode: false

Ative apenas se estiver enfrentando problemas e precisar de logs detalhados.

Banco de Dados

database:
  # Tipo de banco: SQLITE, MYSQL, HIKARI (recomendado)
  storage-type: SQLITE

  # Dados para conexão MySQL
  data:
    host: localhost
    port: 3306
    database: ''
    username: ''
    password: ''

Tipos de Banco de Dados

SQLITE: Banco local, ideal para servidores pequenos
MYSQL: Banco externo, necessário para múltiplos servidores
HIKARI: Pool de conexões otimizado (recomendado para MySQL)

Redis (Opcional)

redis:
  # Ativar sincronização via Redis
  enabled: false
  host: 'localhost'
  port: 6379
  username: ''
  password: ''

Quando Usar Redis?

Redis só é necessário se você tiver múltiplos servidores (network) que precisam sincronizar dados de skills em tempo real.

# Delay para carregar dados após login (em ticks)
# Necessário para servidores de mina separados
# Recomendado: 20 ticks
login-delay: 20

Se você usa servidor de lobby + mina separados, configure um delay de 20-40 ticks para garantir que os dados sejam carregados corretamente.

Sistema de Bônus

general:
  # Acumular bônus se tiver múltiplas permissões
  accumulate-bonus: false
  # Formato da mensagem quando tem bônus
  formatter-bonus-has: '&a+{bonus}% por ser {display}&a.'
  # Formato quando não tem bônus
  formatter-bonus-no-has: ''

# Configuração de bônus por permissão
bonus:
  members:
    order: 1
    permission: 'yskills.bonus.member'
    display: '&7[Membro]'
    bonus: 10.0

Criando Bônus Personalizados

bonus:
  vip:
    order: 2
    permission: 'yskills.bonus.vip'
    display: '&6[VIP]'
    bonus: 25.0
  
  elite:
    order: 3
    permission: 'yskills.bonus.elite'
    display: '&5[Elite]'
    bonus: 50.0
  
  supremo:
    order: 4
    permission: 'yskills.bonus.supremo'
    display: '&c[Supremo]'
    bonus: 100.0

Parâmetros:

order: Ordem de prioridade (menor = mais importante)
permission: Permissão necessária
display: Nome exibido nas mensagens
bonus: Multiplicador de XP em % (10.0 = +10% de XP)

Acumular Bônus

Se accumulate-bonus: true, um jogador com VIP (25%) + Elite (50%) ganhará +75% de XP total. Se false, apenas o bônus de maior order será aplicado.

Sistema de Frascos de XP

xp-bottle:
  # Frasco global (jogador escolhe a skill)
  global:
    material: 'EXP_BOTTLE'
    name: '&a&lFrasco de XP &7(Global)'
    lore:
      - '&8&m------------------------'
      - '&7Quantidade de XP: &a{xp}'
      - ''
      - '&7Tipo: &eGlobal'
      - '&7Escolha uma skill para aplicar.'
      - '&8&m------------------------'
      - ''
      - '&eClique direito para usar!'
    glow: true
  
  # Frasco específico (aplica direto em uma skill)
  specific:
    material: 'EXP_BOTTLE'
    name: '&b&lFrasco de XP &7({skill})'
    lore:
      - '&8&m------------------------'
      - '&7Quantidade de XP: &a{xp}'
      - ''
      - '&7Skill: &b{skill}'
      - '&8&m------------------------'
      - ''
      - '&eClique direito para usar!'
    glow: true

Placeholders disponíveis:

{xp} - Quantidade de XP do frasco
{skill} - Nome da skill (apenas no specific)

Sistema de Boosters

booster:
  # Booster global (afeta todos os jogadores)
  global:
    material: 'NETHER_STAR'
    name: '&6&lBooster Global &7({multiplier}x)'
    lore:
      - '&8&m------------------------'
      - '&7Multiplicador: &6{multiplier}x'
      - '&7Duração: &e{duration}'
      - ''
      - '&7Skill: &a{skill}'
      - '&8&m------------------------'
      - ''
      - '&6Este booster afeta TODOS'
      - '&6os jogadores do servidor!'
      - ''
      - '&eClique direito para ativar!'
    glow: true
  
  # Booster individual (apenas quem ativar)
  individual:
    material: 'BLAZE_POWDER'
    name: '&e&lBooster Individual &7({multiplier}x)'
    lore:
      - '&8&m------------------------'
      - '&7Multiplicador: &e{multiplier}x'
      - '&7Duração: &a{duration}'
      - ''
      - '&7Skill: &b{skill}'
      - '&8&m------------------------'
      - ''
      - '&eClique direito para ativar!'
    glow: true
  
  # Configurações gerais
  settings:
    # Broadcast quando booster global é ativado
    broadcast-global: true
    # Exibir actionbar com tempo restante
    show-actionbar: true
    # Formato da actionbar
    actionbar-format: '&6⚡ Booster {type}: &e{multiplier}x &7| {skill} &7| &aRestam: {time}'

Placeholders disponíveis:

{multiplier} - Multiplicador do booster
{duration} - Duração formatada
{skill} - Skill afetada
{type} - Tipo (Global/Individual)
{time} - Tempo restante

Sistema de Requisitos

requirements:
  # Ativar sistema de requisitos
  enabled: true
  
  # Configurações gerais
  settings:
    # Cooldown entre mensagens (segundos)
    message-cooldown: 3
    # Cancelar evento quando não atende requisito
    cancel-event: true
    # Dropar item mesmo se cancelado (apenas blocos)
    drop-item-if-cancelled: false
  
  # Requisitos para blocos
  blocks:
    DIAMOND_ORE:
      # Modo: ANY (qualquer skill) ou ALL (todas necessárias)
      mode: ANY
      skills:
        mining: 20
        excavation: 30
    
    EMERALD_ORE:
      mode: ALL
      skills:
        mining: 25
        excavation: 15
  
  # Requisitos para mobs
  mobs:
    WITHER:
      mode: ANY
      skills:
        swords: 40
        archery: 45
      # Ícone personalizado no menu
      icon:
        material: NETHER_STAR
        name: '&5Wither'
        glow: false
    
    ENDER_DRAGON:
      mode: ANY
      skills:
        swords: 50
      icon:
        material: DRAGON_EGG
        name: '&dEnder Dragon'
        glow: false

Modos de Requisito

ANY: O jogador precisa ter pelo menos uma das skills no nível necessário
ALL: O jogador precisa ter todas as skills nos níveis necessários

Exemplo:

DIAMOND_ORE:
  mode: ANY
  skills:
    mining: 20      # Precisa nível 20 em Mining
    excavation: 30  # OU nível 30 em Excavation

EMERALD_ORE:
  mode: ALL
  skills:
    mining: 25      # Precisa nível 25 em Mining
    excavation: 15  # E nível 15 em Excavation

Adicionando Novos Requisitos

Você pode adicionar requisitos para qualquer bloco ou mob do Minecraft. Use os nomes exatos do Material/EntityType.

Próximos Passos

Agora que você configurou o arquivo principal, explore as outras seções:

Mensagens - Personalize todas as mensagens
Menus - Configure os menus do plugin
Skills - Configure as skills individuais
Habilidades - Configure as habilidades

Recarregar Configurações

Após modificar qualquer arquivo, use /skills reload para aplicar as mudanças sem reiniciar o servidor.

Configuração

Nesta página