Minecraft "UnknownDependencyException" oplossen (plugin mist dependency)

Last updated on 

Server start op, maar een aantal plugins doet het niet? Kans groot dat dit in je console staat:

[10:12:42 ERROR]: Could not load 'plugins/MinetopiaFarms.jar' in folder 'plugins'
org.bukkit.plugin.UnknownDependencyException: WorldEdit
at org.bukkit.plugin.SimplePluginManager.loadPlugins(SimplePluginManager.java:218) ~[server.jar:git-Paper-1620]

Simpel probleem: de plugin mist een andere plugin om op te draaien, en die staat niet in je plugins-map.

Wat betekent deze foutmelding?

Sommige plugins zijn geen op zichzelf staand pakket, maar bouwen voort op een andere plugin (een dependency). Zonder die dependency weigert Bukkit/Paper de plugin te laden, in plaats van hem half of foutief te starten. Achter de dubbele punt staat exact welke plugin ontbreekt, hier dus WorldEdit en verderop ProtocolLib.

Elke plugin die dezelfde dependency mist geeft dezelfde melding. Eén ontbrekende jar kan zo meerdere regels errors veroorzaken die op het eerste gezicht los lijken te staan.

Hoe kom je hieraan?

  • Je hebt een pluginmap gekopieerd of hersteld zonder de dependencies mee te nemen.
  • Je hebt een plugin geüpdatet of verwijderd waar andere plugins op leunden.
  • De plugin is nooit met een dependency geïnstalleerd, bijvoorbeeld bij een kant-en-klaar serverpakket dat je zelf hebt aangevuld.

Oplossing: de ontbrekende dependency installeren

  1. Lees uit de foutmelding welke plugin ontbreekt (na UnknownDependencyException:).
  2. Download die plugin, bijvoorbeeld WorldEdit of ProtocolLib via SpigotMC. Let op dat de versie past bij je serverversie (hier 1.12.2, zie v1_12_R1 in de log).
  3. Zet de jar in je plugins-map, naast de plugins die hem nodig hebben.
  4. Herstart de server.

Alle plugins die op deze dependency wachtten, laden nu vanzelf mee.

Voorkomen

  • Check bij het verwijderen van een plugin eerst of andere plugins ervan afhankelijk zijn.
  • Neem bij een backup of migratie altijd de hele plugins-map mee, niet alleen de plugin die je nodig denkt te hebben.
  • Lees bij een nieuwe plugin de resource-pagina, dependencies staan daar meestal expliciet vermeld.

Veelgestelde vragen

Moet ik exact dezelfde versie van de dependency gebruiken?

Niet per se dezelfde build, maar wel eentje die je serverversie ondersteunt. Bij twijfel: pak de nieuwste versie die nog compatibel is met jouw Minecraft-versie.

Kan ik de plugin die dit veroorzaakt gewoon verwijderen?

Kan, maar dan mis je de functionaliteit van die plugin. Meestal is de dependency alsnog installeren minder werk en het enige dat echt oplost.