Come dare un kit iniziale Minecraft ai nuovi giocatori sul tuo server Paper

Cosa fa un kit iniziale Minecraft al primo accesso

Il kit di questa guida è una spada di pietra, un piccone di pietra e 16 pani, seguiti da un messaggio privato in chat che dice al nuovo arrivato cosa ha appena ricevuto. Viene consegnato in automatico quando un giocatore entra nel tuo server per la prima volta. Non c'è nessun comando da scrivere e nessun permesso da configurare.

"Prima volta" qui vuol dire quello che Paper sa già: un giocatore che il server non aveva mai salvato prima del suo ingresso. Il runtime non tiene nessuna lista sua e nessun contatore. Per questo il kit funziona su un server che gestisci già, ed è anche il motivo per cui non può fare alcune cose, elencate più sotto.

Questa ricetta usa l'editor a blocchi di NimBlock e il suo runtime separato e gratuito. Un account NimBlock ti permette di salvare la regola. Per farla girare ti serve un server Minecraft Java che hai già, con un hosting che permette di caricare plugin. I passaggi qui sotto sono per Paper 1.21.11 con Java 21. Non ti serve un server ospitato da NimBlock.

Crea la regola del kit nello studio

1. Apri i tuoi plugin in NimBlock e crea un nuovo plugin. L'editor parte con una regola di benvenuto; puoi tenerla o eliminarla.
2. Da Regole, trascina una nuova regola nel plugin e chiamala Kit iniziale.
3. Da Trigger, metti Un giocatore si connette nel suo spazio quando.
4. Da Condizioni, metti È la prima visita del giocatore nel suo spazio se.
5. Da Azioni, aggiungi Dai un oggetto al giocatore tre volte: STONE_SWORD con quantità 1, STONE_PICKAXE con quantità 1, BREAD con quantità 16.
6. Aggiungi per ultima Invia un messaggio al giocatore, per esempio Benvenuto {player}! Ecco un kit iniziale per cominciare. Lascia {player} esattamente così: il runtime lo sostituisce con il nome del giocatore.
7. Salva il plugin. Nella sua pagina, copia tutto il JSON mostrato in un file di testo semplice chiamato starter-kit.json, salvato in UTF-8.

Gli oggetti si scrivono con il loro nome Minecraft, come IRON_AXE o COOKED_BEEF. Sostituisci i tre oggetti con quelli del tuo kit: un'azione per oggetto, ognuna con la sua quantità. La grammatica pubblica elenca tutti i trigger, le condizioni e le azioni disponibili.

Installalo sul tuo server Paper

1. Scarica il runtime di NimBlock. Ferma il server, metti il .jar del runtime direttamente in plugins/, poi avvia il server.
2. Controlla che NimBlock sia attivo con /plugins. La guida all'installazione dei plugin di Paper spiega come capire perché un caricamento non è riuscito.
3. Carica starter-kit.json in plugins/NimBlock/specs/. Rispetta le maiuscole del nome della cartella. Se serve, crea prima la cartella.
4. Da operatore del server, esegui /nimblock reload, poi /nimblock list. Dovrebbe comparire il nome del plugin che hai salvato. Nella console del server, togli la barra iniziale.

Correggi ogni errore segnalato durante il ricaricamento prima di provare. Un nome di oggetto sbagliato viene scoperto solo quando la regola si attiva, quindi controlla come hai scritto ogni oggetto prima della tua prima prova.

Provalo con un account che non è mai entrato

Il tuo account ha già giocato sul tuo server, quindi non riceverà il kit, ed è il segno che la regola funziona. Prova con un account Minecraft Java che non è mai entrato in questo server, per esempio quello di un amico, oppure su una copia del tuo server con un mondo nuovo. Al primo accesso, l'account dovrebbe ricevere la spada, il piccone, il pane e il messaggio. Esci, aspetta un attimo e rientra: non dovrebbe arrivare nient'altro.

I giocatori entrati prima che installassi la regola non sono nuovi arrivati e non riceveranno il kit. Caricare la regola non rimette in gioco gli accessi precedenti.

I limiti di un kit al primo accesso

• Una volta per giocatore, finché il server se lo ricorda: la condizione legge i dati dei giocatori di Paper. Se crei un mondo nuovo, tutti tornano a essere nuovi arrivati e ricevono di nuovo il kit. Se cancelli i dati di un giocatore, solo quel giocatore torna a essere un nuovo arrivato e riceve di nuovo il kit.
• Vale per tutta la prima sessione: la condizione è vera non solo nel momento in cui il nuovo arrivato entra, ma finché non si disconnette, anche se nel frattempo il server lo salva. Tienila sotto Un giocatore si connette; sotto un altro trigger, come la rinascita, un nuovo arrivato potrebbe ricevere il kit una seconda volta durante quella prima sessione.
• Niente kit giornaliero, niente tempo di attesa, niente contatore: il runtime reagisce agli eventi e non ricorda nulla, quindi non può dare un kit "una volta al giorno" o "tre volte per giocatore".
• Oggetti semplici: l'azione dà un tipo di oggetto e una quantità. Incantesimi e nomi personalizzati non sono compresi.
• Inventario pieno: quello che non ci sta cade a terra ai piedi del giocatore. L'inventario di un nuovo arrivato di solito è vuoto, quindi capita di rado.

Cambia il kit senza reinstallare il runtime

Modifica la regola nello studio e salva una nuova versione. Sostituisci il contenuto dello stesso file starter-kit.json con il JSON appena salvato, poi esegui /nimblock reload. Il prossimo nuovo arrivato riceve il nuovo kit; chi ha già avuto quello vecchio non riceve altro. Se tieni sia il file vecchio sia quello nuovo, vengono caricate tutte e due le regole e vengono dati due kit.

Puoi usare il runtime sul tuo server Paper compatibile senza comprare un hosting NimBlock. La tua regola resta un file JSON leggibile, che puoi controllare e conservare insieme al backup del tuo server.