SkillFusion — Descrição do plugin

O SkillFusion acrescenta progressão de personagens ao estilo RPG ao teu servidor Minecraft, sem complicar o dia a dia do jogo. Adapta-se a Survival, SMP, RPG, Factions e modos semelhantes.
Os jogadores escolhem os seus grupos de habilidades preferidos, desbloqueiam habilidades e melhoram cada uma com a experiência que ganham no Minecraft.

Cada nível torna uma habilidade mais eficaz.

• 7 grupos de habilidades – Warrior, Miner, Healer, Assassin, Fisherman, Farmer e Alchemist.
  
• 35 habilidades diferentes – Cada grupo contém 5 habilidades únicas.
  
• Habilidades ativas e passivas – Algumas funcionam automaticamente, outras são ativadas por comandos.
  
• Classes principal + secundária – Os jogadores combinam dois grupos diferentes para criar sua própria build.
  
• Progressão com XP real – A experiência do Minecraft se torna uma moeda útil de progressão.
  
• Níveis individuais – Cada habilidade possui nível próprio e independente.
  
• Habilidades escaláveis – Dano, cura, recarga, alcance, chance, duração e outros efeitos melhoram com o nível.
  
• Progressão totalmente configurável – Altera preços, níveis máximos, ícones, descrições e escala das melhorias.
  
• GUI organizado – Os jogadores gerenciam a build completa sem memorizar comandos complicados.
  
• Permissões por grupo – Define exatamente quais classes cada jogador ou grupo de permissões pode usar.
  
• Spigot, Paper & Folia – O mesmo JAR suporta as três plataformas.
  
• Sem dependências obrigatórias – SkillFusion funciona como sistema independente de progressão.
  

⭐ CRIE SUA PRÓPRIA CLASSE
Os jogadores desenvolvem a sua personagem sem ficarem presos a um único papel.
SkillFusion permite escolher:

• 1 grupo principal
  
• 1 grupo secundário
  

Combina os grupos para criares uma build que se adapte ao teu estilo de jogo.
Um jogador pode combinar:

• Warrior + Healer – apoio resistente na linha de frente
  
• Assassin + Warrior – build agressiva de combate corpo a corpo
  
• Miner + Farmer – progressão eficiente no Survival
  
• Fisherman + Alchemist – jogo voltado à utilidade
  
• Healer + Alchemist – build poderosa de suporte
  

Os jogadores escolhem a sua combinação; a administração define os grupos disponíveis através das permissões.

PROGRESSÃO BASEADA EM XP
Os jogadores pagam as melhorias com a experiência habitual do Minecraft.
Não precisas de uma moeda separada nem de um plugin de economia externo.
Cada habilidade possui:

• Nível atual
  
• Nível máximo
  
• Preço base em XP
  
• Multiplicador do preço de melhoria
  
• Ícone personalizado
  
• Nome exibido
  
• Descrição de uso
  
• Descrição de funcionamento
  

O custo das melhorias aumenta de acordo com o preço base e o multiplicador que definires.
Por exemplo:



As primeiras melhorias são acessíveis; os níveis mais altos exigem cada vez mais experiência.
O XP é calculado pela experiência total real do jogador no Minecraft, incluindo nível atual e progresso de XP.
O SkillFusion desconta o custo exato em XP e mantém a experiência restante do jogador.

️SISTEMA GUI COMPLETO
Os jogadores gerenciam tudo usando /skills.


O GUI principal mostra cada grupo disponível com:

• Todas as habilidades do grupo
  
• Níveis atuais das habilidades
  
• Estado do grupo principal
  
• Estado do grupo secundário
  
• Estado da seleção
  

Clique esquerdo seleciona ou remove a seleção de um grupo.
Clique direito abre as habilidades daquele grupo.
No menu os jogadores veem imediatamente:

• Nome da habilidade
  
• Nível atual
  
• Nível máximo
  
• Custo da próxima melhoria
  
• Como funciona
  
• Como ativar
  

Clica numa habilidade para comprares o nível seguinte, se tiveres experiência suficiente.
O menu atualiza-se de imediato, mostrando o novo nível e o custo da melhoria seguinte.

⚔ WARRIOR
Especialização de combate focada em força corpo a corpo, sobrevivência e apoio a aliados próximos.

WARRIOR – 5 HABILIDADES

⚔ Brutal Strength

Uma habilidade passiva que aumenta permanentemente o dano corpo a corpo.

Cada nível aumenta o dano dos ataques, tornando guerreiros de nível alto muito mais fortes no combate corpo a corpo.

• Habilidade passiva
  
• +10% de dano de ataque por nível
  
• Funciona automaticamente com Warrior ativo
  

Battle Fury

Matar um inimigo pode provocar um frenesi temporário de combate.

• Ativa após matar uma entidade
  
• Aumenta a velocidade de ataque
  
• +5% de velocidade de ataque por nível
  
• Até +50% de velocidade de ataque
  
• Dura 10 segundos
  
• Possui recarga antes de ativar novamente
  
• A recarga melhora com o nível
  

Shield Wall

Segurar um escudo torna o guerreiro muito mais difícil de matar.

• Habilidade passiva
  
• Funciona com escudo equipado
  
• Reduz dano recebido de entidades
  
• 5% de redução de dano por nível
  
• A redução máxima possui limite seguro
  

War Cry

Habilidade ativa de equipe que aumenta o poder de combate de jogadores próximos.

Uso:

/s warcry

• Afeta o utilizador e jogadores próximos
  
• Área de ativação de 10 blocos
  
• Aumenta dano de ataque
  
• +5% de dano por nível
  
• Até +50%
  
• O efeito dura 10 segundos
  
• Recarga baseada em nível
  

❤️ Last Stand

Habilidade defensiva de emergência para salvar o guerreiro quando a luta fica perigosa.

• Habilidade passiva de emergência
  
• Ativa quando o dano deixaria o jogador com 20% de vida ou menos
  
• Reduz dano recebido
  
• 5% de redução por nível
  
• Até 50%
  
• Permanece ativa por 10 segundos
  
• Usa recarga escalada pelo nível
  

⛏ MINER
Para jogadores que passam tempo no subsolo coletando recursos e explorando cavernas.

MINER – 5 HABILIDADES

⛏ Efficient Mining

Melhora automaticamente a velocidade de mineração.

• Habilidade passiva
  
• Usa o efeito Pressa
  
• A força aumenta com o nível
  
• Ativa automaticamente com Miner
  

Lucky Find

Minerar pode produzir drops adicionais.

• Habilidade passiva
  
• 2% de chance de drops extras por nível
  
• Funciona com minérios compatíveis
  
• Drops extras usam a ferramenta atual
  

Vein Miner

Minere uma veia conectada inteira sem quebrar manualmente cada bloco.

• Agache ao quebrar minério para ativar
  
• Busca blocos conectados do mesmo minério
  
• Suporta minérios normais e de ardósia, minérios do Nether, detritos ancestrais e cobre
  
• Máximo de 64 blocos conectados por ativação
  
• A recarga diminui com o nível
  
• Respeita automaticamente BlockBreakEvents cancelados
  

A busca da veia fica no chunk atual, tornando o sistema muito mais seguro para servidores por regiões.

Stone Skin

Mineradores ficam mais resistentes a explosões.

• Habilidade defensiva passiva
  
• Reduz dano de explosões
  
• 5% de redução de dano por nível
  
• A redução possui limite seguro
  

Geologist

Examine a área em busca de minérios valiosos.

Uso:

/s geologist

• Busca minérios valiosos próximos
  
• O alcance aumenta com o nível
  
• Mostra nomes e coordenadas
  
• Níveis altos reduzem a recarga
  
• A busca fica no chunk atual
  

❤ HEALER
Especialização completa de suporte para manter outros jogadores vivos e fortalecer a equipe.

HEALER – 5 HABILIDADES

❤ Heal

Restaura instantaneamente a vida de outro jogador online.

Uso:

/s heal <player>

• Restaura 2 pontos de vida por nível
  
• Não ultrapassa a vida máxima do alvo
  
• A recarga fica menor em níveis altos
  

✨ Regeneration

Aplica regeneração temporária ao utilizador.

Uso:

/s regeneration

ou:

/s regen

• Habilidade de autocura
  
• Duração base: 10 segundos
  
• +2 segundos por nível
  
• A recarga diminui conforme melhora
  

Purify

Remove efeitos negativos de poção de outro jogador.

Uso:

/s purify <player>

• Detecta efeitos prejudiciais
  
• Remove até um efeito prejudicial por nível
  
• Níveis altos removem mais efeitos de uma vez
  
• A recarga diminui com a progressão
  

☠ Resurrection

Traga um jogador caído de volta ao combate.

Uso:

/s resurrection <player>

ou:

/s resurrect <player>

• Funciona com jogador morto online
  
• Faz o alvo reaparecer
  
• Restaura aproximadamente metade da vida máxima mais vida adicional conforme o nível
  
• Recarga estratégica longa
  
• A recarga fica menor em níveis altos da habilidade
  

Blessing

Aumenta temporariamente a defesa de aliados próximos.

Uso:

/s blessing

• Afeta o utilizador e jogadores próximos
  
• Área de 10 blocos
  
• Aumenta armadura
  
• 5% de escalonamento de defesa por nível
  
• Até 50% de bônus
  
• A duração aumenta com o nível
  
• A recarga diminui com o nível
  

ASSASSIN
Especialização de combate arriscada focada em posição, críticos, veneno e mobilidade.

ASSASSIN – 5 HABILIDADES

Backstab

Recompensa atacar inimigos pelas costas.

• Habilidade passiva
  
• Verifica automaticamente a direção do alvo
  
• +10% de dano pelas costas por nível
  
• O bônus possui limite seguro
  

Critical Strike

Ataques normais podem se tornar críticos poderosos.

• Habilidade passiva
  
• 2.5% de chance de ativação por nível
  
• A chance crítica é limitada para equilíbrio
  
• O multiplicador crítico base começa em 1.5x
  
• O dano crítico também escala com o nível
  

☠ Poison Blade

Espadas e machados podem envenenar inimigos.

• Funciona com espadas e machados
  
• 3% de chance de ativação por nível
  
• A duração do veneno aumenta com o nível
  
• Níveis altos também podem fortalecer o veneno
  

Stealth

Desapareça e mude de posição antes de atacar.

Uso:

/s stealth

• Aplica invisibilidade
  
• Também concede Velocidade breve
  
• Invisibilidade base: 10 segundos
  
• +2 segundos por nível
  
• A recarga fica menor em níveis altos
  
• Atacar encerra Stealth
  
• Receber dano também encerra Stealth
  

Shadow Step

Apareça instantaneamente atrás de um alvo próximo.

Uso:

/s shadowstep

• Busca alvo na direção do olhar
  
• Distância máxima: 12 blocos
  
• Teleporta atrás do alvo escolhido
  
• Verifica destino seguro antes de teleportar
  
• Tenta posições seguras alternativas se a ideal estiver bloqueada
  
• Concede Invisibilidade e Velocidade breves após teleportar
  
• A recarga diminui com o nível
  

FISHERMAN
Transforma a pesca normal em uma progressão muito mais recompensadora.

FISHERMAN – 5 HABILIDADES

Quick Catch

Espere menos até um peixe morder.

• Habilidade passiva
  
• Reduz espera mínima e máxima de pesca
  
• 5% de redução por nível
  
• Escalonamento mínimo seguro evita valores extremos
  

Treasure Hunter

Capturas normais podem ser substituídas por tesouros valiosos de pesca do Minecraft.

• Habilidade passiva
  
• 2% de chance de tesouro por nível
  
• Usa a tabela normal de tesouros de pesca
  

Net Fishing

Obtenha vários sorteios de loot de pesca de uma vez.

Lance a vara e usa:

/s netfish

ou:

/s netfishing

• Exige vara lançada
  
• Produz vários sorteios de loot de pesca
  
• O número de sorteios aumenta com o nível
  
• Nível 1 começa com 2 sorteios
  
• Usa recarga estratégica
  

Deep Sea Angler

Pesca em oceanos profundos ganha chance de loot especial valioso.

• Habilidade passiva
  
• Funciona em variantes de oceano profundo
  
• 5% de chance de ativação por nível
  
• Até 50%
  
• Usa tesouros de pesca do Minecraft
  

Lucky Catch

Às vezes duplica o item recém-pescado.

• Habilidade passiva
  
• 4% de chance por nível
  
• Cria uma cópia adicional do item pescado
  

FARMER
Especialização agrícola completa para plantações, animais e produção de recursos.

FARMER – 5 HABILIDADES

Green Thumb

Culturas plantadas pelo Farmer avançam etapas adicionais quando crescem naturalmente.

• Habilidade passiva
  
• Registra o jogador que plantou
  
• Adiciona etapas de crescimento conforme o nível
  
• Suporta trigo, cenouras, batatas, beterrabas, fungo do Nether, cacau, bagas doces e caules de melancia e abóbora
  

A propriedade é salva com segurança no chunk, sem depender apenas de memória temporária.

Bountiful Harvest

Culturas maduras podem gerar drops adicionais.

• Habilidade passiva
  
• 5% de chance de colheita extra por nível
  
• Funciona com várias culturas comuns
  
• Usa drops normais dos blocos do Minecraft
  

Animal Breeder

Animais recém-reproduzidos amadurecem mais rápido.

• Habilidade passiva
  
• Ativa ao reproduzir animais
  
• Filhotes recebem 30 segundos de avanço por nível
  

Rancher

Animais mortos pelo jogador produzem mais recursos.

• Habilidade passiva
  
• 5% de drops extras de animais por nível
  
• Bônus fracionários usam arredondamento aleatório para progressão suave
  

Fertilizer

Transforme farinha de osso em uma ferramenta agrícola muito mais forte.

• Clique direito em culturas compatíveis com farinha de osso
  
• Avança uma etapa adicional de crescimento por nível
  
• Nunca ultrapassa a idade máxima
  
• Consome farinha normalmente fora do Creative
  

⚗ ALCHEMIST
Especialização de poções que transforma a fabricação padrão do Minecraft em uma progressão própria.

ALCHEMIST – 5 HABILIDADES

Splash Expert

Faz poções arremessadas afetarem uma área muito maior.

• Habilidade passiva
  
• Transforma o impacto em uma nuvem de efeito controlada
  
• Raio base: 3 blocos
  
• +5% de raio por nível
  
• A duração também aumenta com o nível
  
• Preserva os efeitos da poção lançada
  

Efficient Brewing

Suportes usados pelo Alchemist terminam poções mais rápido.

• Habilidade passiva
  
• Registra o jogador operando o suporte
  
• 6% de redução no preparo por nível
  
• Redução limitada a 60%
  

Reagent Saver

O preparo pode preservar o ingrediente em vez de consumi-lo.

• Habilidade passiva
  
• 2% de chance por nível
  
• Ativação bem-sucedida devolve o ingrediente
  

✨ Potion Mastery

Poções bebidas pelo Alchemist ficam muito mais fortes.

• Habilidade passiva
  
• Aumenta o amplificador dos efeitos
  
• O bônus de força escala com o nível
  
• Um limite impede valores extremos
  
• Funciona com efeitos base e personalizados
  

⏳ Duration Extender

Melhore diretamente uma poção antes de usar.

Segure uma poção na mão principal e usa:

/s extendduration

ou:

/s durationextender

• Estende todos os efeitos da poção
  
• +10% de duração por nível
  
• Suporta efeitos base e personalizados
  
• Limite suave evita efeitos excessivamente longos
  
• 5 minutos de recarga
  

⚙️ CONFIGURAÇÃO COMPLETA DE HABILIDADES
Todo o sistema de progressão é controlado por skills.yml.

Adapta o equilíbrio predefinido ao teu servidor.
Cada habilidade permite configurar:

• DisplayName – Nome exibido no GUI
  
• Material – Item do Minecraft usado como ícone
  
• MaxLevel – Nível máximo de melhoria
  
• BasePrice – Preço XP inicial
  
• MultiplyByLevel – Escala do custo de melhoria
  
• HowToUse – Instruções exibidas diretamente no GUI
  
• HowItWorks – Descrição da mecânica
  

Exemplo:



Ajusta o ritmo de progressão ao teu servidor, desde uma pequena comunidade de Survival até uma economia RPG de longa duração.

GUI PERSONALIZÁVEL
A aparência da interface pode ser modificada por config.yml.

Podes personalizar:

• Título do GUI de grupos
  
• Título do GUI de habilidades individuais
  
• Formato do nome exibido
  
• Descrição da habilidade
  
• Exibição de nível
  
• Exibição do máximo
  
• Preço da próxima melhoria
  
• Seção de funcionamento
  
• Seção de uso
  
• Lista de habilidades do grupo
  
• Texto selecionado / não selecionado
  
• Estado do grupo principal
  
• Estado do grupo secundário
  
• Texto de ação do clique esquerdo
  
• Texto de ação do clique direito
  
• Botão voltar
  

Variáveis úteis incluem:

• %groupName%
  
• %group.displayName%
  
• %skill.name%
  
• %skillName%
  
• %skillLevel%
  
• %level%
  
• %maxLevel%
  
• %nextCost%
  
• %howItWorks%
  
• %howToUse%
  

MENSAGENS PERSONALIZADAS
SkillFusion inclui um ficheiro dedicado messages.yml com mensagens das mecânicas individuais.

Inclui respostas para:

• Ativações de habilidades
  
• Recargas
  
• Bônus de dano
  
• Cura
  
• Purificação
  
• Resurrection
  
• Mineração
  
• Pesca
  
• Agricultura
  
• Preparo de poções
  
• Modificação de poções
  
• Ações específicas de habilidades
  

As mensagens suportam os códigos normais do Minecraft & para cores e variáveis específicas como:

• %player%
  
• %target%
  
• %level%
  
• %duration%
  
• %time%
  
• %count%
  
• %reduction%
  
• %healAmount%
  

ATUALIZAÇÃO AUTOMÁTICA DE CONFIGURAÇÃO
O plugin atualiza a configuração para não teres de reconstruir os ficheiros à mão após cada atualização.

Quando uma versão nova introduz valores ausentes:

• Ficheiros existentes são carregados
  
• Padrões ausentes são detectados
  
• Novos valores necessários são adicionados automaticamente
  
• Valores personalizados são preservados
  
• Versões de configuração são atualizadas automaticamente
  

Este sistema se aplica a:

• config.yml
  
• messages.yml
  
• skills.yml
  

DADOS DE PROGRESSÃO SEGUROS
O progresso de cada jogador é guardado em separado.

SkillFusion lembra:

• UUID do jogador
  
• Último nome conhecido
  
• Grupo principal
  
• Grupo secundário
  
• Nível de cada habilidade
  

Os dados são salvos em:
plugins/SkillFusion/playerdata/
As gravações habituais são tratadas fora dos eventos de jogo, para evitar escritas diretas no disco durante esses eventos.

• Gravador assíncrono – Capturas dos jogadores são enfileiradas em um gravador dedicado em segundo plano.
  
• Gravações ordenadas – Os dados são processados em ordem previsível.
  
• Substituição atômica de ficheiros – Dados vão primeiro a um ficheiro temporário e depois ao destino, reduzindo o risco de ficheiros de jogador parcialmente gravados.
  
• Gravação ao desligar – O progresso carregado é salvo ao desativar o plugin.
  
• Registro concorrente de jogadores – O progresso em memória usa coleções seguras para threads.
  
• Proteção de recarga – Gravações pendentes terminam antes de recarregar os dados.
  

Não é simplesmente a opção folia-supported: true.
Uma camada dedicada deteta a plataforma do servidor e encaminha cada tarefa para o agendador adequado.

• Agendador global – Usado para tarefas de todo o servidor.
  
• Agendador de entidades – Operações de jogadores e entidades seguem sua entidade responsável.
  
• Agendador regional – Operações de localização executam na região correta.
  
• Alternativa Spigot – Spigot usa automaticamente o agendamento padrão Bukkit.
  
• Teleportes assíncronos Paper/Folia – Shadow Step usa teleporte assíncrono quando disponível.
  
• Segurança para vários jogadores – War Cry e Blessing agendam alterações separadamente para cada jogador afetado.
  
• Mineração de veios segura por regiões – Vein Miner fica no chunk atual sem tocar regiões alheias.
  
• Recargas seguras para threads – Coleções concorrentes protegem habilidades ativas e estado da recarga.
  
• Sem dependência obrigatória de Paper – Funções Paper usam uma pequena ponte de execução, permitindo carregar o mesmo JAR também no Spigot.
  

FERRAMENTAS ADMINISTRATIVAS
A administração pode ajustar diretamente o progresso dos jogadores quando for necessário.

• Definir níveis – Altera uma habilidade para qualquer nível válido.
  
• Gerenciar outros jogadores – Define o nível de um jogador carregado por comando administrativo.
  
• Restaurar configuração de habilidades – Restaura o ficheiro original skills.yml.
  
• Redefinir dados de habilidades – Apaga progresso salvo com comando protegido por confirmação.
  
• Recarga completa – Recarrega definições, habilidades e dados sem reiniciar o servidor.
  
• Autocompletar – Comandos administrativos e ativos oferecem sugestões úteis.
  
• Avisos de atualização – Administradores autorizados podem receber informações de novas versões do SkillFusion.
  
• bStats Metrics – Métricas anônimas ajudam a acompanhar o uso do plugin.
  

IDEAL PARA

• Servidores Survival
  
• Servidores SMP
  
• Servidores RPG
  
• Factions
  
• Servidores de aventura
  
• Servidores de progressão de longo prazo
  
• Servidores que querem builds sem substituir a jogabilidade original
  

O SkillFusion mantém as atividades de Minecraft que os jogadores já conhecem.
Combater, minerar, cultivar, pescar e preparar poções passam a fazer parte de uma progressão que dá um objetivo a longo prazo.