Voeg een welkomstbericht toe aan je Minecraft Paper server

Minecraft welkomstbericht of MOTD in de serverlijst?

Een welkomstbericht verschijnt nadat de speler verbinding heeft gemaakt. De MOTD verschijnt daarvoor, onder de naam van de server in de multiplayerlijst. Als je motd in server.properties aanpast, verander je die laatste, zoals de Paper-documentatie uitlegt. Daarmee maak je niet de chatbegroeting uit deze gids.

Dit recept gebruikt de blokkeneditor van NimBlock en de aparte, gratis runtime. Een NimBlock-account is genoeg om de regel op te slaan. Om hem uit te voeren heb je een bestaande Minecraft Java-server nodig waarvan de host pluginuploads toestaat. De stappen hieronder zijn bedoeld voor Paper 1.21.11 met Java 21. Een door NimBlock gehoste server is niet nodig.

Bouw het welkomstbericht in de studio

1. Open je plugins in NimBlock en maak een nieuwe plugin. De editor start met een welkomstregel.
2. Houd de trigger Een speler verbindt en de actie Stuur een bericht naar de speler. Laat de regel zonder voorwaarden, zodat hij bij elke join draait.
3. Pas het bericht aan naar iets nuttigs, zoals Welkom {player}! Houd de chat alsjeblieft vriendelijk. Laat {player} precies zoals het er staat: de runtime vervangt het door de naam van de speler.
4. Sla de plugin op. Kopieer op de pagina van de plugin de volledige JSON die je ziet naar een tekstbestand met platte tekst, met de naam welcome.json en opgeslagen als UTF-8.

De studio maakt een JSON-regel, geen zelfstandige Java-plugin. Bij een andere host installeer je de runtime één keer en geef je hem daarna dat JSON-bestand. De openbare grammatica beschrijft de beschikbare triggers en acties.

Installeer het 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.
2. Controleer met /plugins of NimBlock ingeschakeld is. In de installatiegids voor plugins van Paper staat hoe je uitzoekt waarom een plugin niet laadt.
3. Upload welcome.json naar plugins/NimBlock/specs/. Behoud de hoofdletters van de map. Maak de map vóór het uploaden aan als die nog niet bestaat.
4. Voer als serveroperator /nimblock reload uit en daarna /nimblock list. De naam van je opgeslagen plugin hoort te verschijnen. Laat in de serverconsole de slash aan het begin weg.

Los een fout die tijdens het herladen wordt gemeld op voordat je test. Een runtime die in /plugins staat, bewijst dat de runtime geladen is, niet dat je JSON-regel dat ook is. Voor die tweede controle gebruik je /nimblock list.

Controleer wat spelers echt zien

Verbind met je Minecraft Java-account. Je zou je begroeting met je eigen naam erin moeten zien. Verbreek de verbinding en maak opnieuw verbinding: dezelfde begroeting hoort weer te verschijnen. Als er al een andere speler online is, vraag die dan te controleren dat die je privébegroeting niet ontvangt. Die speler ziet mogelijk nog wel de normale join-melding van Minecraft.

Wil je de aankomst in plaats daarvan aan iedereen melden, kies dan de broadcast-actie van de studio. Dat voegt een openbaar bericht toe; de normale melding verdwijnt daardoor nog steeds niet. Houd privé-instructies en openbare aankondigingen gescheiden, zodat elke join niet ieders chat volstroomt.

Pas de tekst aan zonder de runtime opnieuw te installeren

Pas het bericht aan in de studio en sla een nieuwe versie op. Vervang de inhoud van hetzelfde welcome.json-bestand door de zojuist opgeslagen JSON en voer daarna /nimblock reload uit. Verbind opnieuw om het te testen. Voor deze wijziging van alleen het bericht hoef je de server niet te herstarten. Als je zowel het oude als het nieuwe bestand laat staan, kunnen beide regels geladen worden en krijg je twee begroetingen.

Geen begroeting, of twee begroetingen?

• Niets in de lijst van de runtime: controleer de map, de extensie .json en de fouten bij het herladen. Een bestand met de naam welcome.json.txt is niet hetzelfde bestandstype.
• De regel laadt maar blijft stil: controleer of de trigger een speler is die joint, of de regel geen voorwaarden heeft en of je echt opnieuw hebt verbonden nadat je de regel had geladen. Een regel laden speelt eerdere joins niet opnieuw af.
• Je ziet twee eigen begroetingen: controleer of er een tweede JSON-bestand is of een andere plugin die een welkomstbericht stuurt. De normale join-melding naast één privébegroeting is normaal.
• Je wilt een begroeting alleen voor nieuwe spelers: daarvoor is een extra voorwaarde nodig. Dit recept begroet bewust ook terugkerende spelers.

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