Så ger du nya spelare ett startkit på din Paper-server

Vad ett Minecraft startkit vid första anslutningen gör

Kitet i den här guiden är ett stensvärd, en stenhacka och 16 bröd, följt av en privat chattrad som berättar för nykomlingen vad hen just har fått. Det delas ut automatiskt när en spelare ansluter till din server för första gången. Det finns inget kommando att skriva och ingen behörighet att ställa in.

”Första gången” betyder här det Paper redan vet: en spelare som servern aldrig hade sparat innan hen anslöt. Runtime-pluginet har ingen egen lista och ingen räknare. Det är därför kitet fungerar på en server du redan kör, och också därför det inte kan göra vissa saker, som listas längre ner.

Det här receptet använder NimBlocks blockredigerare och dess separata, gratis runtime. Med ett NimBlock-konto kan du spara regeln. För att köra den behöver du en befintlig Minecraft Java-server vars värd tillåter att du laddar upp plugins. Stegen nedan gäller Paper 1.21.11 med Java 21. Du behöver ingen server som körs hos NimBlock.

Bygg kitregeln i studion

1. Öppna dina plugins i NimBlock och skapa ett nytt plugin. Redigeraren startar med en välkomstregel; du kan behålla den eller ta bort den.
2. Dra en ny regel från Regler in i pluginet och döp den till Startkit.
3. Lägg En spelare går med från Utlösare i regelns när-plats.
4. Lägg Spelaren är här för första gången från Villkor i regelns om-plats.
5. Lägg till Ge spelaren ett föremål från Åtgärder tre gånger: STONE_SWORD med antal 1, STONE_PICKAXE med antal 1, BREAD med antal 16.
6. Lägg till Skicka ett meddelande till spelaren sist, till exempel Välkommen {player}! Här är ett startkit så att du kommer igång. Behåll {player} exakt som det står: runtime byter ut det mot spelarens namn.
7. Spara pluginet. Kopiera hela JSON-koden som visas på dess sida till en vanlig textfil med namnet starter-kit.json, sparad som UTF-8.

Föremål skrivs med sitt Minecraft-namn, till exempel IRON_AXE eller COOKED_BEEF. Byt ut de tre föremålen mot ditt eget kit: en åtgärd per föremål, var och en med sitt antal. Den publika grammatiken listar alla utlösare, villkor och åtgärder som finns.

Installera det på din befintliga Paper-server

1. Ladda ner NimBlocks runtime. Stoppa servern, lägg runtimens .jar direkt i plugins/ och starta sedan servern.
2. Kontrollera med /plugins att NimBlock är aktiverat. Papers guide för att installera plugins förklarar hur du felsöker en inläsning som misslyckas.
3. Ladda upp starter-kit.json till plugins/NimBlock/specs/. Behåll mappens stora bokstäver. Skapa mappen först om det behövs.
4. Kör /nimblock reload som operatör på servern, och sedan /nimblock list. Namnet på ditt sparade plugin ska synas. I serverkonsolen skriver du kommandot utan snedstrecket i början.

Rätta alla fel som visas vid omladdningen innan du testar. Ett okänt föremålsnamn upptäcks först när regeln körs, så kontrollera stavningen av varje föremål innan ditt första test.

Testa med ett konto som aldrig har anslutit

Ditt eget konto har redan spelat på din server, så det får inte kitet, och det betyder att regeln fungerar. Testa med ett Minecraft Java-konto som aldrig har anslutit till den här servern, till exempel en kompis konto, eller på en kopia av din server med en ny värld. Vid den första anslutningen ska kontot få svärdet, hackan, brödet och meddelandet. Koppla från, vänta en stund och anslut igen: inget mer ska delas ut.

Spelare som anslöt innan du installerade regeln är inte nykomlingar och får inte kitet. Att läsa in regeln spelar inte upp tidigare anslutningar igen.

Begränsningar för ett kit vid första anslutningen

• En gång per spelare, så länge servern minns hen: villkoret läser Papers egna spelardata. Om du startar en ny värld är alla nykomlingar igen och får kitet igen. Om du raderar en spelares data blir bara den spelaren nykomling igen och får kitet en gång till.
• Sant under hela första sessionen: villkoret är sant inte bara i det ögonblick nykomlingen ansluter, utan tills hen kopplar från, även om servern sparar under tiden. Behåll det under En spelare går med; under en annan utlösare, till exempel när spelaren återuppstår, kan en nykomling få kitet en andra gång under den första sessionen.
• Inget dagligt kit, ingen väntetid, ingen räknare: runtime reagerar på händelser och minns ingenting, så den kan inte ge ett kit ”en gång om dagen” eller ”tre gånger per spelare”.
• Vanliga föremål: åtgärden ger en föremålstyp och ett antal. Förtrollningar och egna namn ingår inte.
• Fullt förråd: det som inte får plats hamnar på marken vid spelarens fötter. En nykomlings förråd är normalt tomt, så det spelar sällan någon roll.

Ändra kitet utan att installera om runtime

Redigera regeln i studion och spara en ny version. Ersätt innehållet i samma starter-kit.json-fil med den nysparade JSON-koden och kör sedan /nimblock reload. Nästa nykomling får det nya kitet; spelare som redan har fått det gamla får inget mer. Om du behåller både den gamla och den nya filen läses båda reglerna in och två kit delas ut.

Du kan använda runtime på din egen kompatibla Paper-server utan att köpa hosting hos NimBlock. Din regel förblir en läsbar JSON-fil som du kan granska och spara tillsammans med din serverbackup.