SkillFusion — Plugin description

SkillFusion brings RPG-style character progression to your Minecraft server without making everyday gameplay complicated. It fits Survival, SMP, RPG, Factions and similar modes.
Players choose their preferred Skill Groups, unlock abilities and upgrade individual skills with the Minecraft XP they already earn.

Each level makes a skill more effective.

• 7 Skill Groups – Warrior, Miner, Healer, Assassin, Fisherman, Farmer and Alchemist.
  
• 35 Different Skills – Every group contains 5 unique abilities.
  
• Active & Passive Abilities – Some skills work automatically while others are activated using commands.
  
• Primary + Secondary Classes – Players can combine two different skill groups to create their own build.
  
• Real XP Progression – Minecraft experience becomes a useful progression currency.
  
• Individual Skill Levels – Every ability has its own independent level.
  
• Scaling Abilities – Damage, healing, cooldowns, range, chance, duration and other effects improve with skill level.
  
• Fully Configurable Progression – Change prices, maximum levels, icons, descriptions and upgrade scaling.
  
• Clean GUI – Players can manage their complete character build without memorizing complicated commands.
  
• Per-Group Permissions – Decide exactly which classes each player or permission group may use.
  
• Spigot, Paper & Folia – The same plugin JAR supports all three platforms.
  
• No Required Dependencies – SkillFusion works as a standalone progression system.
  

⭐ BUILD YOUR OWN CLASS
Players can shape their character without being tied to one fixed role.
SkillFusion allows every player to select:

• 1 Primary Skill Group
  
• 1 Secondary Skill Group
  

Combine the groups to create a build that suits your playstyle.
A player can combine:

• Warrior + Healer – durable frontline support
  
• Assassin + Warrior – aggressive melee build
  
• Miner + Farmer – efficient Survival progression
  
• Fisherman + Alchemist – utility-focused gameplay
  
• Healer + Alchemist – powerful support build
  

Players choose their combination; administrators control which groups are available through permissions.

XP-BASED PROGRESSION
Players pay for skill upgrades with their regular Minecraft XP.
There is no need for a separate currency or an external economy plugin.
Each skill has:

• Current level
  
• Maximum level
  
• Base XP price
  
• Upgrade price multiplier
  
• Custom icon
  
• Display name
  
• How To Use description
  
• How It Works description
  

Upgrade costs rise according to the base price and multiplier you configure.
For example:



Early upgrades stay affordable, while higher levels take more XP to reach.
XP is calculated using the player's real total Minecraft experience, including their current level and XP progress.
SkillFusion deducts the exact XP cost and leaves the player’s remaining experience intact.

️COMPLETE GUI SYSTEM
Players can manage everything using /skills.


The main GUI displays every available Skill Group together with:

• Every skill inside the group
  
• Current skill levels
  
• Primary Group status
  
• Secondary Group status
  
• Selection status
  

Left Click selects or deselects a Skill Group.
Right Click opens the skills belonging to that group.
Inside the skill menu, players can immediately see:

• Skill name
  
• Current level
  
• Maximum level
  
• Next upgrade cost
  
• How the skill works
  
• How to activate it
  

Click a skill to buy its next level when you have enough XP.
The menu updates immediately, showing the new level and the cost of the next upgrade.

⚔ WARRIOR
A combat-focused specialization built around raw melee power, survivability and supporting nearby allies.

WARRIOR – 5 SKILLS

⚔ Brutal Strength

A passive bonus that permanently increases melee damage.

Each skill level increases damage dealt by player attacks, turning high-level Warriors into significantly stronger melee fighters.

• Passive ability
  
• +10% attack damage per skill level
  
• Works automatically while the Warrior group is active
  

Battle Fury

Killing an enemy can put the Warrior into a temporary combat frenzy.

• Activates after killing an entity
  
• Increases attack speed
  
• +5% attack speed per level
  
• Up to +50% attack speed
  
• Lasts 10 seconds
  
• Uses a cooldown before it can activate again
  
• Cooldown improves with skill level
  

Shield Wall

Holding a shield makes the Warrior significantly harder to kill.

• Passive ability
  
• Works while a shield is equipped
  
• Reduces incoming entity damage
  
• 5% damage reduction per level
  
• Maximum reduction is capped to keep the effect balanced
  

War Cry

A team-oriented active ability that increases the combat power of nearby players.

Use:

/s warcry

• Affects the caster and nearby players
  
• 10-block activation area
  
• Boosts attack damage
  
• +5% damage per skill level
  
• Up to +50%
  
• Effect lasts 10 seconds
  
• Level-based cooldown
  

❤️ Last Stand

An emergency defensive skill designed to save the Warrior when a fight becomes dangerous.

• Passive emergency ability
  
• Activates when incoming damage would leave the player at 20% health or less
  
• Reduces incoming damage
  
• 5% reduction per level
  
• Up to 50%
  
• Remains active for 10 seconds
  
• Uses a level-scaled cooldown
  

⛏ MINER
Designed for players who spend their time underground collecting resources and exploring caves.

MINER – 5 SKILLS

⛏ Efficient Mining

Automatically improves the player's mining speed.

• Passive ability
  
• Uses the Haste effect
  
• Strength increases with skill level
  
• Automatically activates with the Miner group
  

Lucky Find

Mining ores can produce additional drops.

• Passive ability
  
• 2% bonus-drop chance per level
  
• Works with supported ore blocks
  
• Additional drops use the player's current mining tool
  

Vein Miner

Mine an entire connected ore vein instead of breaking every block manually.

• Sneak while breaking an ore to activate
  
• Searches connected blocks of the same ore type
  
• Supports normal and deepslate ores, Nether ores, Ancient Debris and Copper
  
• Maximum 64 connected blocks per activation
  
• Cooldown decreases with skill level
  
• Automatically respects cancelled BlockBreakEvents
  

The vein scan remains inside the current chunk, making the system much safer for region-based servers.

Stone Skin

Miners become more resistant to explosions.

• Passive defensive ability
  
• Reduces explosion damage
  
• 5% damage reduction per level
  
• Reduction is capped to keep the effect balanced
  

Geologist

Scan the surrounding area for valuable ores.

Use:

/s geologist

• Searches nearby valuable ores
  
• Detection range increases with level
  
• Displays ore names and coordinates
  
• Higher levels reduce the cooldown
  
• Scanning stays within the current chunk
  

❤ HEALER
A complete support specialization focused on keeping other players alive and strengthening a team.

HEALER – 5 SKILLS

❤ Heal

Instantly restores health to another online player.

Use:

/s heal <player>

• Restores 2 health points per skill level
  
• Cannot exceed the target's maximum health
  
• Cooldown becomes shorter at higher levels
  

✨ Regeneration

Applies temporary regeneration to the caster.

Use:

/s regeneration

or:

/s regen

• Self-healing ability
  
• Base duration: 10 seconds
  
• +2 seconds per skill level
  
• Cooldown decreases as the skill improves
  

Purify

Remove negative potion effects from another player.

Use:

/s purify <player>

• Detects harmful potion effects
  
• Removes up to one harmful effect per skill level
  
• Higher levels allow removing more effects at once
  
• Cooldown decreases with progression
  

☠ Resurrection

Bring a fallen player back into the fight.

Use:

/s resurrection <player>

or:

/s resurrect <player>

• Works on a dead online player
  
• Respawns the target
  
• Restores approximately half of their maximum health plus additional health based on level
  
• Long strategic cooldown
  
• Cooldown becomes shorter at higher skill levels
  

Blessing

Temporarily increases the defense of nearby allies.

Use:

/s blessing

• Affects the caster and nearby players
  
• 10-block area
  
• Increases armor
  
• 5% defense scaling per level
  
• Up to 50% bonus
  
• Duration increases with level
  
• Cooldown decreases with level
  

ASSASSIN
A high-risk combat specialization focused on positioning, critical attacks, poison and mobility.

ASSASSIN – 5 SKILLS

Backstab

Rewards players for attacking enemies from behind.

• Passive ability
  
• Automatically checks the target's facing direction
  
• +10% backstab damage per level
  
• Bonus is capped to keep the effect balanced
  

Critical Strike

Normal attacks have a chance to become powerful critical hits.

• Passive ability
  
• 2.5% activation chance per level
  
• Critical chance is capped for balance
  
• Base critical multiplier starts at 1.5x
  
• Critical damage scaling also improves with level
  

☠ Poison Blade

Sword and axe attacks can poison enemies.

• Works with swords and axes
  
• 3% activation chance per level
  
• Poison duration increases with level
  
• Higher levels can also improve poison strength
  

Stealth

Disappear from sight and reposition before attacking.

Use:

/s stealth

• Applies invisibility
  
• Also provides a short Speed boost
  
• Base invisibility duration: 10 seconds
  
• +2 seconds per skill level
  
• Cooldown becomes shorter at higher levels
  
• Attacking breaks Stealth
  
• Receiving damage also breaks Stealth
  

Shadow Step

Instantly blink behind a nearby target.

Use:

/s shadowstep

• Searches for a target in the direction the player is looking
  
• Maximum targeting distance: 12 blocks
  
• Teleports behind the selected target
  
• Checks whether the destination is safe before teleporting
  
• Attempts alternative safe positions when the ideal destination is blocked
  
• Provides a short Invisibility and Speed effect after teleporting
  
• Cooldown decreases with skill level
  

FISHERMAN
Transforms normal Minecraft fishing into a much more rewarding progression path.

FISHERMAN – 5 SKILLS

Quick Catch

Spend less time waiting for a fish to bite.

• Passive ability
  
• Reduces minimum and maximum fishing wait time
  
• 5% reduction per level
  
• Safe minimum wait-time scaling prevents extreme values
  

Treasure Hunter

Normal catches can be replaced by valuable Minecraft fishing treasure.

• Passive ability
  
• 2% treasure chance per level
  
• Uses Minecraft's normal fishing treasure loot table
  

Net Fishing

Catch several fishing loot rolls at once.

Cast your fishing rod and use:

/s netfish

or:

/s netfishing

• Requires an active fishing cast
  
• Produces multiple fishing loot rolls
  
• Number of rolls increases with skill level
  
• Level 1 starts with 2 rolls
  
• Uses a strategic cooldown
  

Deep Sea Angler

Deep ocean fishing gains a chance to produce special high-value loot.

• Passive ability
  
• Works in Deep Ocean variants
  
• 5% activation chance per level
  
• Up to 50%
  
• Uses Minecraft's fishing treasure loot
  

Lucky Catch

Sometimes duplicate the item you just caught.

• Passive ability
  
• 4% chance per skill level
  
• Creates an additional copy of the caught item
  

FARMER
A complete farming specialization covering crops, animals and resource production.

FARMER – 5 SKILLS

Green Thumb

Crops planted by the Farmer grow through additional stages whenever they naturally grow.

• Passive ability
  
• Tracks the player who planted the crop
  
• Adds additional growth stages based on skill level
  
• Supports Wheat, Carrots, Potatoes, Beetroot, Nether Wart, Cocoa, Sweet Berries, Melon stems and Pumpkin stems
  

Crop ownership is stored safely with the chunk rather than relying only on temporary memory.

Bountiful Harvest

Fully grown crops can produce an additional set of drops.

• Passive ability
  
• 5% bonus harvest chance per level
  
• Works with multiple common crops
  
• Uses normal Minecraft block drops
  

Animal Breeder

Newly bred animals mature faster.

• Passive ability
  
• Activates when the player breeds animals
  
• Baby growth receives a 30-second advancement per skill level
  

Rancher

Animals killed by the player produce more resources.

• Passive ability
  
• 5% additional animal drops per level
  
• Fractional bonuses use randomized rounding for smoother progression
  

Fertilizer

Turn normal Bone Meal into a much stronger farming tool.

• Right-click supported crops using Bone Meal
  
• Advances the crop by one additional growth stage per skill level
  
• Never exceeds the crop's maximum age
  
• Consumes Bone Meal normally outside Creative mode
  

⚗ ALCHEMIST
A potion and brewing specialization that turns Minecraft's vanilla brewing system into its own progression path.

ALCHEMIST – 5 SKILLS

Splash Expert

Makes splash potions affect a much larger area.

• Passive ability
  
• Transforms the splash into a controlled Area Effect Cloud
  
• Base radius: 3 blocks
  
• +5% radius per skill level
  
• Effect duration also increases with level
  
• Preserves the thrown potion effects
  

Efficient Brewing

Brewing stands used by the Alchemist finish potions faster.

• Passive ability
  
• Tracks the player operating the Brewing Stand
  
• 6% brew-time reduction per level
  
• Reduction is capped at 60%
  

Reagent Saver

Brewing can preserve the ingredient instead of consuming it.

• Passive ability
  
• 2% chance per skill level
  
• Successful activation refunds the brewing ingredient
  

✨ Potion Mastery

Potions consumed by the Alchemist become significantly stronger.

• Passive ability
  
• Increases the amplifier of potion effects
  
• Effect-strength bonus scales with skill level
  
• Bonus is capped to prevent extreme values
  
• Works with base and custom potion effects
  

⏳ Duration Extender

Directly improve a potion before using it.

Hold a potion in your main hand and use:

/s extendduration

or:

/s durationextender

• Extends every effect stored in the potion
  
• +10% effect duration per level
  
• Supports base and custom potion effects
  
• Soft cap prevents excessively long effects
  
• 5-minute cooldown
  

⚙️ FULL SKILL CONFIGURATION
The complete progression system is controlled through skills.yml.

Adjust the default balance to suit your server.
Every individual skill supports configurable:

• DisplayName – Name shown inside the GUI
  
• Material – Minecraft item used as its icon
  
• MaxLevel – Maximum upgrade level
  
• BasePrice – Initial XP price
  
• MultiplyByLevel – Upgrade-cost scaling
  
• HowToUse – Instructions displayed directly inside the GUI
  
• HowItWorks – Description explaining the skill mechanic
  

Example:



Set a progression pace that fits your server, from a small Survival community to a long-running RPG economy.

CUSTOMIZABLE GUI
The appearance of the skill interface can be modified through config.yml.

You can customize:

• Skill Groups GUI title
  
• Individual Skills GUI title
  
• Skill display-name format
  
• Skill lore
  
• Level display
  
• Maximum-level display
  
• Next upgrade price
  
• How It Works section
  
• How To Use section
  
• Group skill list
  
• Selected / Not Selected text
  
• Primary Group status
  
• Secondary Group status
  
• Left Click action text
  
• Right Click action text
  
• Back button
  

Useful placeholders include:

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

CUSTOM MESSAGES
SkillFusion includes a dedicated messages.yml containing messages for individual skill mechanics.

This includes feedback for:

• Skill activations
  
• Cooldowns
  
• Damage boosts
  
• Healing
  
• Purification
  
• Resurrection
  
• Mining
  
• Fishing
  
• Farming
  
• Brewing
  
• Potion modification
  
• Skill-specific actions
  

Messages support normal Minecraft & color codes and skill-specific placeholders such as:

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

AUTOMATIC CONFIGURATION UPDATES
Configuration updates are handled for you, so you do not need to rebuild your files after each plugin update.

When a newer plugin version introduces missing configuration values:

• Existing files are loaded
  
• Missing default options are detected
  
• New required values are automatically added
  
• Existing customized values are preserved
  
• Configuration version numbers are updated automatically
  

This system applies to:

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

SAFE PLAYER PROGRESSION DATA
Each player’s progress is saved separately.

SkillFusion remembers:

• Player UUID
  
• Last known player name
  
• Primary Skill Group
  
• Secondary Skill Group
  
• Every individual skill level
  

Data is stored inside:
plugins/SkillFusion/playerdata/
Routine saves are handled outside gameplay events to avoid writing directly to disk during those events.

• Asynchronous Data Writer – Player snapshots are queued to a dedicated background writer.
  
• Serialized Saves – Player data writes are processed in a predictable order.
  
• Atomic File Replacement – Data is first written into a temporary file and then moved into place, reducing the chance of ending up with a partially written player file.
  
• Shutdown Save – Loaded player progression is flushed during plugin shutdown.
  
• Concurrent Player Registry – In-memory player progression uses thread-safe collections.
  
• Reload Protection – Pending data saves are flushed before player data is reloaded.
  

This is not simply a folia-supported: true flag.
A dedicated platform layer detects the server and sends each task to the appropriate scheduler.

• Global Scheduler – Used for server-wide work.
  
• Entity Scheduler – Player and entity operations follow the entity that owns them.
  
• Region Scheduler – Location-specific operations can execute on the correct region.
  
• Spigot Fallback – Standard Bukkit scheduling is automatically used on Spigot.
  
• Async Paper/Folia Teleports – Shadow Step uses asynchronous teleport handling where supported.
  
• Multi-Player Ability Safety – Abilities such as War Cry and Blessing schedule changes independently for each affected player.
  
• Region-Safe Vein Mining – Vein Miner remains inside the current chunk instead of touching unrelated regions.
  
• Thread-Safe Cooldowns – Concurrent collections protect active abilities and cooldown state.
  
• No Hard Paper Dependency – Paper-specific functionality is accessed through a small runtime bridge, allowing the same compiled JAR to also load on Spigot.
  

ADMINISTRATION TOOLS
Administrators can adjust player progression directly when needed.

• Set Skill Levels – Change an individual skill to any valid level.
  
• Manage Other Players – Set the level of a loaded player's skill from an admin command.
  
• Reset Default Skills Configuration – Restore the original skills.yml.
  
• Reset Player Skill Data – Wipe stored player progression using a protected confirmation command.
  
• Full Reload – Reload configurations, registered skills and player data without restarting the server.
  
• Tab Completion – Administrative and active-skill commands provide useful command suggestions.
  
• Update Notifications – Authorized administrators can receive information when a newer SkillFusion release is available.
  
• bStats Metrics – Anonymous usage metrics help track plugin usage.
  

PERFECT FOR

• Survival servers
  
• SMP servers
  
• RPG servers
  
• Factions
  
• Adventure servers
  
• Long-term progression servers
  
• Servers looking for character builds without replacing vanilla gameplay
  

SkillFusion keeps the Minecraft activities your players already know.
Fighting, mining, farming, fishing and brewing become part of a progression system that rewards long-term play.