SkillFusion — Pluginbeschrijving

SkillFusion voegt personageontwikkeling in RPG-stijl toe aan je Minecraft-server, zonder het dagelijkse spelen ingewikkeld te maken. Het systeem past bij Survival, SMP, RPG, Factions en vergelijkbare spelmodi.
Spelers kiezen hun favoriete vaardigheidsgroepen, ontgrendelen vaardigheden en verbeteren ze met de XP die ze in Minecraft verdienen.

Elk niveau maakt een vaardigheid effectiever.

• 7 vaardigheidsgroepen – Warrior, Miner, Healer, Assassin, Fisherman, Farmer en Alchemist.
  
• 35 verschillende vaardigheden – Elke groep bevat 5 unieke vaardigheden.
  
• Actieve en passieve vaardigheden – Sommige werken automatisch, andere activeer je met commando’s.
  
• Primaire + secundaire klassen – Spelers combineren twee groepen tot hun eigen build.
  
• Ontwikkeling met echte XP – Minecraft-ervaring wordt een bruikbare ontwikkelingsvaluta.
  
• Afzonderlijke vaardigheidslevels – Elke vaardigheid heeft een eigen onafhankelijk level.
  
• Meegroeiende vaardigheden – Schade, genezing, afkoeltijd, bereik, kans, duur en andere effecten verbeteren met het level.
  
• Volledig instelbare ontwikkeling – Wijzig prijzen, maximumlevels, iconen, beschrijvingen en upgradeschaling.
  
• Overzichtelijk GUI – Spelers beheren hun hele build zonder ingewikkelde commando’s te onthouden.
  
• Rechten per groep – Bepaal precies welke klassen spelers of rechtengroepen mogen gebruiken.
  
• Spigot, Paper & Folia – Hetzelfde plugin-JAR ondersteunt alle drie platforms.
  
• Geen verplichte afhankelijkheden – SkillFusion werkt als zelfstandig ontwikkelingssysteem.
  

⭐ BOUW JE EIGEN KLASSE
Spelers ontwikkelen hun personage zonder vast te zitten aan één rol.
SkillFusion laat elke speler kiezen:

• 1 primaire vaardigheidsgroep
  
• 1 secundaire vaardigheidsgroep
  

Combineer de groepen tot een build die bij jouw speelstijl past.
Een speler kan combineren:

• Warrior + Healer – stevige ondersteuning aan de frontlinie
  
• Assassin + Warrior – agressieve build voor gevechten van dichtbij
  
• Miner + Farmer – efficiënte Survival-ontwikkeling
  
• Fisherman + Alchemist – gameplay gericht op bruikbaarheid
  
• Healer + Alchemist – sterke ondersteuningsbuild
  

Spelers kiezen hun combinatie; beheerders bepalen via rechten welke groepen beschikbaar zijn.

ONTWIKKELING OP BASIS VAN XP
Spelers betalen upgrades met hun gewone Minecraft-XP.
Een aparte valuta of externe economieplugin is niet nodig.
Elke vaardigheid heeft:

• Huidig level
  
• Maximumlevel
  
• XP-basisprijs
  
• Prijsmultiplier voor upgrades
  
• Eigen icoon
  
• Weergavenaam
  
• Uitleg over gebruik
  
• Uitleg over werking
  

De kosten stijgen volgens de basisprijs en vermenigvuldigingsfactor die je instelt.
Bijvoorbeeld:



De eerste upgrades blijven betaalbaar; voor hogere niveaus is steeds meer XP nodig.
XP wordt berekend uit de werkelijke totale Minecraft-ervaring van de speler, inclusief huidig level en XP-voortgang.
SkillFusion trekt precies de benodigde XP af en laat de resterende ervaring staan.

️VOLLEDIG GUI-SYSTEEM
Spelers beheren alles met /skills.


Het hoofd-GUI toont elke beschikbare groep met:

• Elke vaardigheid van de groep
  
• Huidige vaardigheidslevels
  
• Status van primaire groep
  
• Status van secundaire groep
  
• Selectiestatus
  

Linksklik selecteert of verwijdert een groep.
Rechtsklik opent de vaardigheden van die groep.
In het vaardigheidsmenu zien spelers meteen:

• Vaardigheidsnaam
  
• Huidig level
  
• Maximumlevel
  
• Kosten van volgende upgrade
  
• Hoe de vaardigheid werkt
  
• Hoe deze te activeren
  

Klik op een vaardigheid om het volgende niveau te kopen als je genoeg XP hebt.
Het menu toont meteen het nieuwe niveau en de prijs van de volgende upgrade.

⚔ WARRIOR
Een gevechtsspecialisatie rond aanvalskracht van dichtbij, overleving en ondersteuning van nabije bondgenoten.

WARRIOR – 5 VAARDIGHEDEN

⚔ Brutal Strength

Een passieve bonus die je schade in gevechten van dichtbij blijvend verhoogt.

Elk level verhoogt aanvalsschade, waardoor krijgers met hoge levels veel sterker worden in gevechten van dichtbij.

• Passieve vaardigheid
  
• +10% aanvalsschade per vaardigheidslevel
  
• Werkt automatisch met Warrior actief
  

Battle Fury

Een vijand doden kan de krijger tijdelijk in gevechtsrazernij brengen.

• Activeert na het doden van een entiteit
  
• Verhoogt aanvalssnelheid
  
• +5% aanvalssnelheid per level
  
• Tot +50% aanvalssnelheid
  
• Duurt 10 seconden
  
• Heeft afkoeltijd voor heractivering
  
• Afkoeltijd verbetert met het vaardigheidslevel
  

Shield Wall

Een schild vasthouden maakt de krijger veel moeilijker te doden.

• Passieve vaardigheid
  
• Werkt met uitgerust schild
  
• Vermindert inkomende entiteitsschade
  
• 5% schadevermindering per level
  
• Maximale vermindering is begrensd om de balans te bewaren
  

War Cry

Teamgerichte actieve vaardigheid die gevechtskracht van nabije spelers verhoogt.

Gebruik:

/s warcry

• Werkt op gebruiker en nabije spelers
  
• Activeringsgebied van 10 blokken
  
• Verhoogt aanvalsschade
  
• +5% schade per vaardigheidslevel
  
• Tot +50%
  
• Effect duurt 10 seconden
  
• Levelafhankelijke afkoeltijd
  

❤️ Last Stand

Defensieve noodvaardigheid die de krijger redt wanneer een gevecht gevaarlijk wordt.

• Passieve noodvaardigheid
  
• Activeert als schade de speler op 20% gezondheid of minder zou brengen
  
• Vermindert inkomende schade
  
• 5% vermindering per level
  
• Tot 50%
  
• Blijft 10 seconden actief
  
• Gebruikt een met level schalende afkoeltijd
  

⛏ MINER
Voor spelers die ondergronds grondstoffen verzamelen en grotten verkennen.

MINER – 5 VAARDIGHEDEN

⛏ Efficient Mining

Verbetert automatisch de mijnsnelheid.

• Passieve vaardigheid
  
• Gebruikt het effect Haast
  
• Sterkte groeit met het vaardigheidslevel
  
• Activeert automatisch met Miner
  

Lucky Find

Ertsmijnen kan extra buit opleveren.

• Passieve vaardigheid
  
• 2% extra-buitkans per level
  
• Werkt op ondersteunde ertsblokken
  
• Extra buit gebruikt het huidige gereedschap
  

Vein Miner

Mijn een hele verbonden ertsader in plaats van elk blok handmatig te breken.

• Sluip tijdens ertsmijnen om te activeren
  
• Zoekt verbonden blokken van hetzelfde erts
  
• Ondersteunt normale en diepleisteenertsen, Netherertsen, oeroud puin en koper
  
• Maximaal 64 verbonden blokken per activering
  
• Afkoeltijd daalt met het vaardigheidslevel
  
• Respecteert geannuleerde BlockBreakEvents automatisch
  

De aderscan blijft in de huidige chunk, waardoor het systeem veiliger is voor regionale servers.

Stone Skin

Mijnwerkers worden beter bestand tegen explosies.

• Passieve verdedigingsvaardigheid
  
• Vermindert explosieschade
  
• 5% schadevermindering per level
  
• Vermindering is begrensd om de balans te bewaren
  

Geologist

Scan de omgeving op waardevolle ertsen.

Gebruik:

/s geologist

• Zoekt waardevolle ertsen dichtbij
  
• Detectiebereik groeit met het level
  
• Toont ertsnamen en coördinaten
  
• Hogere levels verkorten de afkoeltijd
  
• Scannen blijft in de huidige chunk
  

❤ HEALER
Een volledige ondersteuningsspecialisatie om andere spelers in leven te houden en het team te versterken.

HEALER – 5 VAARDIGHEDEN

❤ Heal

Herstelt direct gezondheid van een andere online speler.

Gebruik:

/s heal <player>

• Herstelt 2 gezondheidspunten per vaardigheidslevel
  
• Overschrijdt de maximumgezondheid niet
  
• Afkoeltijd wordt korter op hogere levels
  

✨ Regeneration

Geeft de gebruiker tijdelijk regeneratie.

Gebruik:

/s regeneration

of:

/s regen

• Zelfgenezende vaardigheid
  
• Basisduur: 10 seconden
  
• +2 seconden per vaardigheidslevel
  
• Afkoeltijd daalt wanneer de vaardigheid verbetert
  

Purify

Verwijder negatieve toverdrankeffecten van een andere speler.

Gebruik:

/s purify <player>

• Detecteert schadelijke toverdrankeffecten
  
• Verwijdert maximaal één schadelijk effect per vaardigheidslevel
  
• Hogere levels verwijderen meer effecten tegelijk
  
• Afkoeltijd daalt met de ontwikkeling
  

☠ Resurrection

Breng een gevallen speler terug in het gevecht.

Gebruik:

/s resurrection <player>

of:

/s resurrect <player>

• Werkt op een dode online speler
  
• Laat het doel respawnen
  
• Herstelt ongeveer de halve maximumgezondheid plus extra gezondheid op basis van level
  
• Lange strategische afkoeltijd
  
• Afkoeltijd wordt korter op hogere vaardigheidslevels
  

Blessing

Verhoogt tijdelijk de verdediging van nabije bondgenoten.

Gebruik:

/s blessing

• Werkt op gebruiker en nabije spelers
  
• Gebied van 10 blokken
  
• Verhoogt pantser
  
• 5% verdedigingsschaling per level
  
• Tot 50% bonus
  
• Duur stijgt met het level
  
• Afkoeltijd daalt met het level
  

ASSASSIN
Een riskante gevechtsspecialisatie voor positionering, kritieke aanvallen, gif en mobiliteit.

ASSASSIN – 5 VAARDIGHEDEN

Backstab

Beloont aanvallen van achteren.

• Passieve vaardigheid
  
• Controleert automatisch de kijkrichting van het doel
  
• +10% rugaanvalschade per level
  
• Bonus is begrensd om de balans te bewaren
  

Critical Strike

Normale aanvallen kunnen krachtige kritieke treffers worden.

• Passieve vaardigheid
  
• 2.5% activeringskans per level
  
• Kritieke kans is begrensd voor balans
  
• Kritieke basismultiplier begint bij 1.5x
  
• Kritieke schade verbetert ook met het level
  

☠ Poison Blade

Zwaarden en bijlen kunnen vijanden vergiftigen.

• Werkt met zwaarden en bijlen
  
• 3% activeringskans per level
  
• Gifduur groeit met het level
  
• Hogere levels kunnen gif ook versterken
  

Stealth

Verdwijn uit zicht en kies een nieuwe positie voor je aanval.

Gebruik:

/s stealth

• Geeft onzichtbaarheid
  
• Geeft ook een korte Snelheidsbonus
  
• Basisduur onzichtbaarheid: 10 seconden
  
• +2 seconden per vaardigheidslevel
  
• Afkoeltijd wordt korter op hogere levels
  
• Aanvallen verbreekt Stealth
  
• Schade ontvangen verbreekt ook Stealth
  

Shadow Step

Verschijn direct achter een nabij doel.

Gebruik:

/s shadowstep

• Zoekt een doel in de kijkrichting
  
• Maximale doelafstand: 12 blokken
  
• Teleporteert achter het gekozen doel
  
• Controleert de bestemming op veiligheid
  
• Probeert andere veilige plaatsen als de ideale geblokkeerd is
  
• Geeft na teleporteren kort Onzichtbaarheid en Snelheid
  
• Afkoeltijd daalt met het vaardigheidslevel
  

FISHERMAN
Maakt normaal vissen een veel lonender ontwikkelingspad.

FISHERMAN – 5 VAARDIGHEDEN

Quick Catch

Wacht minder lang tot een vis bijt.

• Passieve vaardigheid
  
• Vermindert minimale en maximale viswachttijd
  
• 5% vermindering per level
  
• Veilige minimale schaling voorkomt extreme waarden
  

Treasure Hunter

Normale vangsten kunnen worden vervangen door waardevolle Minecraft-visschatten.

• Passieve vaardigheid
  
• 2% schatkans per level
  
• Gebruikt de normale buittabel voor Minecraft-visschatten
  

Net Fishing

Verkrijg meerdere visbuittrekkingen tegelijk.

Werp de hengel uit en gebruik:

/s netfish

of:

/s netfishing

• Vereist een uitgeworpen hengel
  
• Maakt meerdere visbuittrekkingen
  
• Aantal trekkingen groeit met het vaardigheidslevel
  
• Level 1 begint met 2 trekkingen
  
• Gebruikt een strategische afkoeltijd
  

Deep Sea Angler

Diepzeevissen krijgt kans op bijzondere waardevolle buit.

• Passieve vaardigheid
  
• Werkt in diepe-oceaanvarianten
  
• 5% activeringskans per level
  
• Tot 50%
  
• Gebruikt Minecraft-visschatten
  

Lucky Catch

Verdubbelt soms het net gevangen voorwerp.

• Passieve vaardigheid
  
• 4% kans per vaardigheidslevel
  
• Maakt een extra kopie van het gevangen voorwerp
  

FARMER
Een volledige landbouwspecialisatie voor gewassen, dieren en grondstofproductie.

FARMER – 5 VAARDIGHEDEN

Green Thumb

Door Farmer geplante gewassen groeien bij natuurlijke groei extra fasen.

• Passieve vaardigheid
  
• Houdt bij wie het gewas plantte
  
• Voegt groeifasen toe volgens vaardigheidslevel
  
• Ondersteunt tarwe, wortels, aardappels, bieten, Netherkruid, cacao, zoete bessen en meloen- en pompoenstengels
  

Gewaseigendom wordt veilig in de chunk opgeslagen, niet alleen in tijdelijk geheugen.

Bountiful Harvest

Volgroeide gewassen kunnen extra buit opleveren.

• Passieve vaardigheid
  
• 5% extra-oogstkans per level
  
• Werkt met meerdere gewone gewassen
  
• Gebruikt normale Minecraft-blokbuit
  

Animal Breeder

Pas gefokte dieren groeien sneller op.

• Passieve vaardigheid
  
• Activeert wanneer de speler dieren fokt
  
• Jonge dieren krijgen 30 seconden groeivoorsprong per vaardigheidslevel
  

Rancher

Door de speler gedode dieren leveren meer grondstoffen.

• Passieve vaardigheid
  
• 5% extra dierenbuit per level
  
• Fracties gebruiken willekeurige afronding voor geleidelijkere ontwikkeling
  

Fertilizer

Maak gewoon beendermeel een veel krachtiger landbouwgereedschap.

• Rechtsklik op ondersteunde gewassen met beendermeel
  
• Voegt een extra groeifase per vaardigheidslevel toe
  
• Overschrijdt nooit de maximumleeftijd
  
• Verbruikt beendermeel normaal buiten Creative
  

⚗ ALCHEMIST
Een drank- en brouwspecialisatie die normaal Minecraft-brouwen tot een eigen ontwikkelingspad maakt.

ALCHEMIST – 5 VAARDIGHEDEN

Splash Expert

Laat werpdranken een veel groter gebied beïnvloeden.

• Passieve vaardigheid
  
• Verandert de inslag in een gecontroleerde effectwolk
  
• Basisstraal: 3 blokken
  
• +5% straal per vaardigheidslevel
  
• Effectduur groeit ook met het level
  
• Behoudt effecten van de geworpen drank
  

Efficient Brewing

Brouwstandaarden van Alchemist maken dranken sneller.

• Passieve vaardigheid
  
• Houdt bij wie de brouwstandaard gebruikt
  
• 6% kortere brouwtijd per level
  
• Vermindering is begrensd op 60%
  

Reagent Saver

Brouwen kan het ingrediënt behouden in plaats van verbruiken.

• Passieve vaardigheid
  
• 2% kans per vaardigheidslevel
  
• Succesvolle activering geeft het ingrediënt terug
  

✨ Potion Mastery

Door Alchemist gedronken dranken worden veel sterker.

• Passieve vaardigheid
  
• Verhoogt de versterker van toverdrankeffecten
  
• Sterktebonus groeit met het vaardigheidslevel
  
• Bonus is begrensd tegen extreme waarden
  
• Werkt met basis- en eigen toverdrankeffecten
  

⏳ Duration Extender

Verbeter een drank direct voor gebruik.

Houd een drank in je hoofdhand en gebruik:

/s extendduration

of:

/s durationextender

• Verlengt elk opgeslagen effect van de drank
  
• +10% effectduur per level
  
• Ondersteunt basis- en eigen toverdrankeffecten
  
• Zachte grens voorkomt extreem lange effecten
  
• 5 minuten afkoeltijd
  

⚙️ VOLLEDIGE VAARDIGHEIDSCONFIGURATIE
Het volledige ontwikkelingssysteem wordt geregeld via skills.yml.

Pas de standaardbalans aan je server aan.
Voor elke vaardigheid instelbaar:

• DisplayName – Naam in het GUI
  
• Material – Minecraft-voorwerp als icoon
  
• MaxLevel – Maximaal upgradelevel
  
• BasePrice – Eerste XP-prijs
  
• MultiplyByLevel – Schaling van upgradekosten
  
• HowToUse – Instructies direct in het GUI
  
• HowItWorks – Beschrijving van de werking
  

Voorbeeld:



Kies een ontwikkelingstempo dat bij je server past, van een kleine Survival-gemeenschap tot een langdurige RPG-economie.

AANPASBAAR GUI
De vaardigheidsinterface kan worden aangepast via config.yml.

Je kunt aanpassen:

• GUI-titel van vaardigheidsgroepen
  
• GUI-titel van afzonderlijke vaardigheden
  
• Formaat van weergavenaam
  
• Vaardigheidsbeschrijving
  
• Levelweergave
  
• Maximumlevelweergave
  
• Volgende upgradeprijs
  
• Sectie over werking
  
• Sectie over gebruik
  
• Vaardigheidslijst van de groep
  
• Tekst geselecteerd / niet geselecteerd
  
• Status van primaire groep
  
• Status van secundaire groep
  
• Actietekst voor linksklik
  
• Actietekst voor rechtsklik
  
• Terugknop
  

Handige variabelen zijn:

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

EIGEN BERICHTEN
SkillFusion bevat een apart bestand messages.yml met berichten voor afzonderlijke vaardigheidsmechanieken.

Dit bevat meldingen voor:

• Activering van vaardigheden
  
• Afkoeltijden
  
• Schadebonussen
  
• Genezing
  
• Zuivering
  
• Resurrection
  
• Mijnbouw
  
• Vissen
  
• Landbouw
  
• Brouwen
  
• Drankaanpassingen
  
• Vaardigheidsspecifieke acties
  

Berichten ondersteunen gewone Minecraft-kleurcodes & en vaardigheidsspecifieke variabelen zoals:

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

AUTOMATISCHE CONFIGURATIE-UPDATES
De plugin werkt de configuratie bij, zodat je bestanden niet na elke update handmatig hoeft op te bouwen.

Wanneer een nieuwe versie ontbrekende configuratiewaarden toevoegt:

• Bestaande bestanden worden geladen
  
• Ontbrekende standaardopties worden gevonden
  
• Nieuwe vereiste waarden worden automatisch toegevoegd
  
• Eigen waarden blijven behouden
  
• Configuratieversies worden automatisch bijgewerkt
  

Dit systeem geldt voor:

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

VEILIGE SPELERONTWIKKELING
De voortgang van elke speler wordt apart opgeslagen.

SkillFusion onthoudt:

• Speler-UUID
  
• Laatst opgeslagen spelersnaam
  
• Primaire vaardigheidsgroep
  
• Secundaire vaardigheidsgroep
  
• Elk afzonderlijk vaardigheidslevel
  

Gegevens worden opgeslagen in:
plugins/SkillFusion/playerdata/
Gewone opslagbewerkingen worden buiten gameplay-events afgehandeld, zodat er tijdens die events niet direct naar de schijf wordt geschreven.

• Asynchrone gegevensschrijver – Momentopnamen worden aan een eigen achtergrondschrijver doorgegeven.
  
• Geordend opslaan – Spelersgegevens worden in voorspelbare volgorde geschreven.
  
• Atomaire bestandsvervanging – Gegevens gaan eerst naar een tijdelijk bestand en daarna naar de bestemming, wat gedeeltelijk geschreven spelersbestanden beperkt.
  
• Opslaan bij afsluiten – Geladen voortgang wordt opgeslagen wanneer de plugin stopt.
  
• Gelijktijdig spelersregister – Voortgang in geheugen gebruikt threadveilige verzamelingen.
  
• Bescherming bij herladen – Wachtende schrijfacties eindigen voordat gegevens worden herladen.
  

Dit is meer dan alleen de instelling folia-supported: true.
Een aparte platformlaag herkent de server en stuurt elke taak naar de juiste scheduler.

• Globale planner – Voor taken over de hele server.
  
• Entiteitsplanner – Speler- en entiteitsoperaties volgen hun eigen entiteit.
  
• Regionale planner – Locatiegebonden operaties draaien in de juiste regio.
  
• Spigot-terugval – Spigot gebruikt automatisch standaard-Bukkit-planning.
  
• Asynchrone Paper-/Folia-teleports – Shadow Step gebruikt asynchroon teleporteren waar ondersteund.
  
• Veiligheid voor meerdere spelers – War Cry en Blessing plannen wijzigingen apart voor elke betrokken speler.
  
• Regionaal veilige adermijnbouw – Vein Miner blijft in de huidige chunk zonder andere regio’s aan te raken.
  
• Threadveilige afkoeltijden – Gelijktijdige verzamelingen beschermen actieve vaardigheden en afkoelstatus.
  
• Geen verplichte Paper-afhankelijkheid – Paper-functies lopen via een kleine runtimebrug, zodat hetzelfde JAR ook op Spigot laadt.
  

BEHEERTOOLS
Beheerders kunnen de voortgang van spelers zo nodig rechtstreeks aanpassen.

• Vaardigheidslevels instellen – Verander een vaardigheid naar elk geldig level.
  
• Andere spelers beheren – Stel een geladen spelerslevel in via beheercommando.
  
• Standaardvaardigheden herstellen – Herstel het originele bestand skills.yml.
  
• Spelersvaardigheidsgegevens wissen – Wis opgeslagen voortgang met een beschermd bevestigingscommando.
  
• Volledig herladen – Herlaad configuraties, geregistreerde vaardigheden en gegevens zonder serverherstart.
  
• Commandoaanvulling – Beheer- en actieve commando’s bieden handige suggesties.
  
• Updatemeldingen – Bevoegde beheerders kunnen meldingen over nieuwe SkillFusion-versies krijgen.
  
• bStats Metrics – Anonieme statistieken helpen het plugingebruik bij te houden.
  

IDEAAL VOOR

• Survival-servers
  
• SMP-servers
  
• RPG-servers
  
• Factions
  
• Avonturenservers
  
• Servers met langdurige ontwikkeling
  
• Servers die builds zoeken zonder normale Minecraft-gameplay te vervangen
  

SkillFusion behoudt de Minecraft-activiteiten die je spelers al kennen.
Vechten, delven, boeren, vissen en brouwen krijgen een plek in een ontwikkeling die ook op lange termijn blijft boeien.