Comment donner un kit de départ aux nouveaux joueurs sur ton serveur Paper

Ce que fait un kit de départ Minecraft à la première connexion

Le kit de ce guide contient une épée en pierre, une pioche en pierre et 16 pains, suivis d'un message privé dans le tchat qui dit au nouveau venu ce qu'il vient de recevoir. Il est donné automatiquement quand un joueur rejoint ton serveur pour la première fois. Il n'y a aucune commande à taper et aucune permission à régler.

« Première fois » veut dire ici ce que Paper sait déjà : un joueur que le serveur n'avait jamais enregistré avant sa connexion. Le runtime ne tient ni liste à lui ni compteur. C'est pour ça que le kit marche sur un serveur que tu fais déjà tourner, et aussi pour ça qu'il ne peut pas faire certaines choses, listées plus bas.

Cette recette utilise l'éditeur de blocs de NimBlock et son runtime, séparé et gratuit. Un compte NimBlock te permet d'enregistrer la règle. Pour la faire tourner, il te faut un serveur Minecraft Java existant dont l'hébergeur autorise l'envoi de plugins. Les étapes ci-dessous visent Paper 1.21.11 avec Java 21. Tu n'as pas besoin d'un serveur hébergé par NimBlock.

Créer la règle du kit dans le studio

1. Ouvre tes plugins dans NimBlock et crée un nouveau plugin. L'éditeur démarre avec une règle de bienvenue ; tu peux la garder ou la supprimer.
2. Depuis Règles, fais glisser une nouvelle règle dans le plugin et nomme-la Kit de départ.
3. Depuis Déclencheurs, place Un joueur se connecte dans son emplacement quand.
4. Depuis Conditions, place Le joueur vient pour la première fois dans son emplacement si.
5. Depuis Actions, ajoute trois fois Donner un objet au joueur : STONE_SWORD avec la quantité 1, STONE_PICKAXE avec la quantité 1, BREAD avec la quantité 16.
6. Ajoute Envoyer un message au joueur en dernier, par exemple Bienvenue {player} ! Voici un kit de départ pour bien commencer. Garde {player} exactement tel quel : le runtime le remplace par le pseudo du joueur.
7. Enregistre le plugin. Sur sa page, copie le JSON complet affiché dans un fichier texte brut nommé starter-kit.json, enregistré en UTF-8.

Les objets s'écrivent avec leur nom Minecraft, comme IRON_AXE ou COOKED_BEEF. Remplace les trois objets par ceux de ton kit : une action par objet, chacune avec sa quantité. La grammaire publique liste tous les déclencheurs, conditions et actions disponibles.

L'installer sur ton serveur Paper existant

1. Télécharge le runtime NimBlock. Arrête ton serveur, mets le .jar du runtime directement dans plugins/, puis démarre le serveur.
2. Vérifie que NimBlock est activé avec /plugins. Le guide d'installation des plugins de Paper explique comment diagnostiquer un chargement raté.
3. Envoie starter-kit.json dans plugins/NimBlock/specs/. Garde les majuscules du nom du dossier. Si besoin, crée d'abord le dossier.
4. En tant qu'opérateur du serveur, lance /nimblock reload, puis /nimblock list. Le nom de ton plugin enregistré doit apparaître. Dans la console du serveur, enlève la barre oblique du début.

Corrige toute erreur signalée pendant le rechargement avant de tester. Un nom d'objet inconnu n'est détecté qu'au moment où la règle s'exécute, alors vérifie l'orthographe de chaque objet avant ton premier test.

Le tester avec un compte qui ne s'est jamais connecté

Ton propre compte a déjà joué sur ton serveur, donc il ne recevra pas le kit, et c'est la règle qui fonctionne. Teste avec un compte Minecraft Java qui ne s'est jamais connecté à ce serveur, par exemple celui d'un ami, ou sur une copie de ton serveur avec un nouveau monde. À cette première connexion, le compte doit recevoir l'épée, la pioche, le pain et le message. Déconnecte-toi, attends un moment et reconnecte-toi : rien de plus ne doit être donné.

Les joueurs qui se sont connectés avant que tu installes la règle ne sont pas des nouveaux venus et ne recevront pas le kit. Charger la règle ne rejoue pas les connexions passées.

Les limites d'un kit de première connexion

• Une fois par joueur, tant que le serveur se souvient de lui : la condition lit les données de joueur de Paper. Si tu lances un nouveau monde, tout le monde redevient nouveau venu et reçoit à nouveau le kit. Si tu supprimes les données d'un joueur, seul ce joueur redevient nouveau venu et reçoit le kit une nouvelle fois.
• Vraie pendant toute la première session : la condition est vraie non seulement au moment où le nouveau venu se connecte, mais jusqu'à ce qu'il se déconnecte, même si le serveur l'enregistre entre-temps. Garde-la sous Un joueur se connecte ; sous un autre déclencheur, comme la réapparition, un nouveau venu pourrait recevoir le kit une deuxième fois pendant cette première session.
• Pas de kit quotidien, pas de délai d'attente, pas de compteur : le runtime réagit aux événements et ne retient rien, donc il ne peut pas donner un kit « une fois par jour » ni « trois fois par joueur ».
• Objets simples : l'action donne un type d'objet et une quantité. Les enchantements et les noms personnalisés n'en font pas partie.
• Inventaire plein : ce qui ne rentre pas tombe par terre aux pieds du joueur. L'inventaire d'un nouveau venu est normalement vide, donc ça arrive rarement.

Changer le kit sans réinstaller le runtime

Modifie la règle dans le studio et enregistre une nouvelle version. Remplace le contenu du même fichier starter-kit.json par le JSON que tu viens d'enregistrer, puis lance /nimblock reload. Le prochain nouveau venu reçoit le nouveau kit ; les joueurs qui ont déjà eu l'ancien ne reçoivent rien de plus. Garder l'ancien et le nouveau fichier chargerait les deux règles et donnerait deux kits.

Tu peux utiliser le runtime sur ton propre serveur Paper compatible sans acheter d'hébergement NimBlock. Ta règle reste un fichier JSON lisible que tu peux consulter et garder avec la sauvegarde de ton serveur.