Zo geef je nieuwe spelers een starter kit op je Paper-server

Wat een Minecraft starter kit bij de eerste join doet

De kit in deze handleiding bestaat uit een stenen zwaard, een stenen houweel en 16 brood, gevolgd door een privéchatbericht dat de nieuwe speler vertelt wat hij net heeft gekregen. De kit wordt automatisch uitgedeeld zodra een speler voor het eerst op je server joint. Er is geen commando om te typen en geen permissie om in te stellen.

"Voor het eerst" betekent hier wat Paper al weet: een speler die de server vóór zijn join nog nooit had opgeslagen. De runtime houdt zelf geen lijst en geen teller bij. Daardoor werkt de kit op een server die je al draait, en daardoor kan hij ook een paar dingen niet, die verderop staan.

Dit recept gebruikt de blokeditor van NimBlock en de losse, gratis runtime. Met een NimBlock-account kun je de regel opslaan. Om hem te laten draaien heb je een bestaande Minecraft Java-server nodig waarvan de host het uploaden van plugins toestaat. De stappen hieronder zijn voor Paper 1.21.11 met Java 21. Je hebt geen server nodig die door NimBlock wordt gehost.

Bouw de kitregel in de studio

1. Open je plugins in NimBlock en maak een nieuwe plugin. De editor begint met een welkomstregel; die kun je houden of verwijderen.
2. Sleep vanuit Regels een nieuwe regel in de plugin en noem hem Starter kit.
3. Zet vanuit Triggers Een speler verbindt in het vak wanneer.
4. Zet vanuit Voorwaarden De speler is er voor het eerst in het vak als.
5. Voeg vanuit Acties drie keer Geef een voorwerp aan de speler toe: STONE_SWORD met aantal 1, STONE_PICKAXE met aantal 1, BREAD met aantal 16.
6. Voeg als laatste Stuur een bericht naar de speler toe, bijvoorbeeld Welkom {player}! Hier is een starter kit om mee te beginnen. Laat {player} precies zo staan: de runtime vervangt het door de naam van de speler.
7. Sla de plugin op. Kopieer op de pagina van de plugin de volledige JSON die daar staat naar een plattetekstbestand met de naam starter-kit.json, opgeslagen als UTF-8.

Items schrijf je met hun Minecraft-naam, zoals IRON_AXE of COOKED_BEEF. Vervang de drie items door je eigen kit: één actie per item, elk met een eigen aantal. De openbare grammatica toont alle beschikbare triggers, voorwaarden en acties.

Installeer hem op je bestaande Paper-server

1. Download de NimBlock-runtime. Stop je server, zet de .jar van de runtime direct in plugins/ en start de server daarna weer.
2. Controleer met /plugins of NimBlock aan staat. De handleiding voor het installeren van plugins van Paper legt uit hoe je onderzoekt waarom het laden mislukt.
3. Upload starter-kit.json naar plugins/NimBlock/specs/. Houd de hoofdletters van de map aan. Maak de map eerst aan als dat nodig is.
4. Voer als serveroperator /nimblock reload uit en daarna /nimblock list. De naam waaronder je de plugin hebt opgeslagen hoort te verschijnen. Laat in de serverconsole de schuine streep aan het begin weg.

Los eerst alle fouten op die tijdens het herladen worden gemeld, voordat je gaat testen. Een onbekende itemnaam wordt pas opgemerkt als de regel wordt uitgevoerd, dus controleer de spelling van elk item voor je eerste test.

Test hem met een account dat nog nooit heeft gejoind

Je eigen account heeft al op je server gespeeld, dus dat krijgt de kit niet, en zo hoort de regel ook te werken. Test met een Minecraft Java-account dat nog nooit op deze server is geweest, bijvoorbeeld dat van een vriend, of op een kopie van je server met een nieuwe wereld. Bij die eerste join hoort het account het zwaard, het houweel, het brood en het bericht te krijgen. Verbreek de verbinding, wacht even en maak opnieuw verbinding: er hoort niets meer bij te komen.

Spelers die al joinden voordat je de regel installeerde, zijn geen nieuwe spelers en krijgen de kit niet. Het laden van de regel speelt eerdere joins niet opnieuw af.

De beperkingen van een kit bij de eerste join

• Eén keer per speler, zolang de server hem onthoudt: de voorwaarde leest de eigen spelergegevens van Paper. Begin je een nieuwe wereld, dan is iedereen weer nieuw en krijgt iedereen de kit opnieuw. Verwijder je de gegevens van een speler, dan is alleen die speler weer nieuw en krijgt hij de kit opnieuw.
• Waar tijdens de hele eerste sessie: de voorwaarde is niet alleen waar op het moment dat een nieuwe speler joint, maar tot hij de verbinding verbreekt, ook als de server hem tussendoor opslaat. Houd hem onder Een speler verbindt; onder een andere trigger, zoals respawnen, kan een nieuwe speler de kit tijdens die eerste sessie een tweede keer krijgen.
• Geen dagelijkse kit, geen cooldown, geen teller: de runtime reageert op gebeurtenissen en onthoudt niets, dus hij kan geen kit "één keer per dag" of "drie keer per speler" geven.
• Gewone items: de actie geeft een itemsoort en een aantal. Betoveringen en eigen namen horen daar niet bij.
• Volle inventaris: wat niet past, valt op de grond bij de voeten van de speler. De inventaris van een nieuwe speler is normaal leeg, dus dit maakt zelden uit.

Pas de kit aan zonder de runtime opnieuw te installeren

Bewerk de regel in de studio en sla een nieuwe versie op. Vervang de inhoud van hetzelfde bestand starter-kit.json door de nieuw opgeslagen JSON en voer daarna /nimblock reload uit. De volgende nieuwe speler krijgt de nieuwe kit; spelers die de oude al hebben gekregen, krijgen niets extra. Houd je zowel het oude als het nieuwe bestand, dan worden beide regels geladen en worden er twee kits uitgedeeld.

Je kunt de runtime op je eigen compatibele Paper-server gebruiken zonder hosting bij NimBlock te kopen. Je regel blijft een leesbaar JSON-bestand dat je kunt bekijken en samen met de back-up van je server kunt bewaren.