Handleiding

Een Spigot-plugin maken

Bijgewerkt 7 oktober 2026

Een Spigot-plugin gebruikt de Bukkit/Spigot-API, dus hij draait op Spigot en op elke fork ervan, Paper inbegrepen. Dat maakt het de breedste keuze als je niet weet waar de plugin gaat draaien. Deze handleiding behandelt het project, de code en de build.

Pas het voorbeeld aan naar jouw server.

Genereer dit met Codexe

Stap voor stap

  1. 1.Zet Java en een buildtool op

    Installeer de JDK die bij je Minecraft-versie past (17, 21 of 25) en gebruik Maven of Gradle.

  2. 2.Voeg de Spigot-API toe

    Voeg spigot-api voor je versie toe uit de Spigot-repository met de scope provided. Het is alleen nodig om te compileren; de server levert het tijdens het draaien.

  3. 3.Schrijf commando's en listeners

    Registreer een CommandExecutor met getCommand("name").setExecutor(...) en event listeners met registerEvents.

  4. 4.Schrijf plugin.yml

    Naam, versie, hoofdklasse, api-version (vanaf 1.13), commando's en permissions.

  5. 5.Bouwen en installeren

    mvn package, kopieer daarna de .jar uit target/ naar de map plugins/ van de server en herstart.

Oude versies (1.8 tot 1.12)

Veel minigameservers draaien nog 1.8. De API is ouder (geen api-version, andere materiaalnamen), dus een plugin moet voor die versie worden geschreven, niet worden gekopieerd uit een 1.21-tutorial. Codexe vraagt om de versie en schrijft de code voor die API.

Met Codexe

Beschrijf de plugin en zeg "Spigot" met de versie. Codexe genereert het Maven-project, compileert het, lost fouten op en laat je het testen op een testserver van die versie voordat je downloadt.

Vragen

Heb ik BuildTools nodig?

Alleen om een Spigot-server te draaien of om NMS (interne servercode) te gebruiken. Om tegen de gewone API te compileren is de dependency spigot-api genoeg.

Spigot-plugin of Paper-plugin?

Spigot als hij overal moet draaien; Paper als je server Paper draait en je de extra API wilt. Zie hoe je een Paper-plugin maakt.

Maak een Spigot-plugin

Deze prompt opent klaar om te versturen:

“Een Spigot 1.8.8-plugin genaamd Kits: /kit <name> geeft een instelbare set items met een cooldown per kit, kits gedefinieerd in config.yml, permission kits.<name> per kit, cooldowns bewaard na herstarts.”

Genereer dit met Codexe
Een Spigot-plugin maken: opzet, code, build | Codexe