Handleiding

Een minigame-plugin voor Minecraft maken

Bijgewerkt 18 oktober 2026

Een minigame-plugin draait rondes: spelers wachten in een lobby, er start een aftelling, het spel loopt volgens zijn eigen regels, iemand wint en de arena wordt gereset voor de volgende ronde. Elke minigame, van spleef tot bed wars, heeft hetzelfde skelet. Zit dat goed, dan zijn de spelregels het makkelijke deel.

Begin met dit voorbeeld en pas de regels aan.

Genereer dit met Codexe

Stap voor stap

  1. 1.Schrijf de regels van één ronde op

    Hoeveel spelers, hoe een ronde begint en eindigt, hoe iemand wint, wat er gebeurt bij een dood (uit, respawn, toeschouwer) en wat spelers bij de start krijgen.

  2. 2.Plan het opzetten van de arena

    Admincommando's om een arena aan te maken en de lobby, spawnpunten en grenzen in te stellen, bijvoorbeeld /mg create <name> en /mg setspawn <name>. Arena's worden in een bestand opgeslagen, zodat ze herstarts overleven.

  3. 3.Leg de gamestatussen vast

    Wachten, starten (aftellen), spelen en afronden. Elke status staat andere dingen toe: niemand breekt blokken in de lobby, niemand joint een spel dat al bezig is.

  4. 4.Bepaal hoe de arena wordt gereset

    Houd de blokken bij die tijdens de ronde veranderen en draai ze terug, of laad een kopie van een sjabloonwereld opnieuw. Zonder reset begint de tweede ronde op een kapotte map.

  5. 5.Voeg toe wat spelers zien

    Een sidebar-scoreboard met overgebleven spelers en tijd, een bossbar of titels voor het aftellen, en chatberichten voor kills en de winnaar.

  6. 6.Genereer, bouw en speel een ronde

    Beschrijf het aan Codexe, laat het compileren en join dan de testserver met Probeer het nu. Zet het minimum aantal spelers laag tijdens het testen, zodat een ronde kan starten.

De gamestatussen

De meeste minigamebugs zijn spelers die iets doen in de verkeerde status. Als je de statussen in het verzoek zet, bouwt de AI de plugin eromheen.

StatusWat er gebeurtGebruikelijke regels
WachtenSpelers joinen de lobbyGeen schade, geen blokken breken, verlaten met een item of commando
StartenAftellen zodra het minimum is bereiktAftellen stopt als er spelers vertrekken en het aantal onder het minimum zakt
SpelenDe spelregels geldenNiet joinen, doodgaan betekent uit of respawnen, afsluiten telt als verlies
AfrondenWinnaar bekendgemaakt, beloningen uitgedeeldSpelers na een paar seconden teruggestuurd, arena gereset

De arena resetten

  • Wijzigingen vastleggen en terugdraaien: sla elk blok op voordat het tijdens de ronde verandert en zet het aan het eind terug. Snel voor kleine arena's waar spelers een paar blokken breken of plaatsen.
  • Sjabloonwereld: bewaar een schone kopie van de map, ontlaad na de ronde de gespeelde wereld en kopieer het sjabloon eroverheen. Eenvoudig en betrouwbaar voor maps die worden verwoest.
  • Geen wijzigingen toegestaan: bij spellen als parkour of PvP-duels annuleer je blokwijzigingen volledig en hoeft er niets gereset te worden.

Voorbeeldbeschrijving

"Een Paper 1.21.4-minigame-plugin voor spleef. Admins maken arena's aan met /spleef create <name>, /spleef setlobby en /spleef setfloor (de twee hoeken van de sneeuwvloer). Spelers joinen met /spleef join <arena>. De ronde start 15 seconden nadat er 2 spelers zijn, tot maximaal 8. Spelers krijgen een diamanten schep, breken sneeuw direct en liggen eruit als ze onder de vloer vallen. De laatste speler die overblijft wint 50 coins via Vault. Uitgeschakelde spelers worden toeschouwer. De sneeuwvloer wordt na elke ronde hersteld. Sidebar met overgebleven spelers en tijd. Arena's opgeslagen in arenas.yml, minimum aantal spelers en beloningen in config.yml."

Een minigame testen

Een minigame is moeilijk te beoordelen aan de hand van de code: je moet een ronde spelen. Probeer het nu start een privé-Paper-server van jouw versie met de plugin geïnstalleerd, meestal in een platte wereld, en vrienden kunnen joinen als je ze toevoegt aan Servertoegang. Het gratis abonnement staat 2 personen op een testserver toe, Pro 5, Business 10 en Enterprise 20.

Vraag om het minimum aantal spelers in config.yml, zodat je het tijdens het testen op 1 of 2 kunt zetten. Testspelers kunnen ook joinen, de join- en admincommando's uitvoeren en de berichten controleren, zodat kapotte commando's opvallen voordat je speelt.

Vragen

Eén arena of meerdere?

Vraag vanaf het begin om meerdere arena's. Een plugin met één arena later ombouwen naar meerdere arena's betekent dat je herschrijft hoe spelers en gamestatus worden opgeslagen.

Kan ik een PvP-minigame voor 1.8 maken?

Ja. Zet Spigot of Paper 1.8.8 in het verzoek: Codexe schrijft de code voor die oudere API, en testservers draaien versies van 1.8 tot 26.3.

Hoe werken minigamenetwerken?

Grote netwerken draaien elk spel op een eigen server achter een BungeeCord- of Velocity-proxy, met een lobbyserver die spelers naar een vrij spel stuurt. Dat is een proxyplugin plus een gameplugin, als twee projecten.

Bouw je minigame

Deze prompt opent klaar om te versturen:

“Een Paper 1.21.4-minigame-plugin voor spleef: arena's aangemaakt met /spleef create, setlobby en setfloor, spelers joinen met /spleef join, ronde start 15 seconden na 2 spelers (max. 8), diamanten scheppen, uit bij een val onder de vloer, de laatste speler wint 50 coins via Vault, toeschouwers voor uitgeschakelde spelers, sneeuwvloer hersteld na elke ronde, sidebar met overgebleven spelers en tijd, arena's opgeslagen in arenas.yml.”

Genereer dit met Codexe
Een minigame-plugin voor Minecraft maken | Codexe