Starter Kit Mod pour Minecraft 1.20.1, 1.21.1

Starter Kit est un mod qui permet aux joueurs rejoignant un monde pour la première fois de recevoir des objets définis dans un fichier de configuration. Il est possible de placer des objets dans n'importe quel emplacement spécifique de l'inventaire, dans la main secondaire et dans les emplacements d'armure. Le mod peut détecter quels joueurs n'ont jamais rejoint auparavant. Si un autre mod ajoute des objets, comme des livres guides, ils peuvent soit être supprimés complètement, soit être ajoutés après que le kit a été défini. Cela est configurable via l'option de configuration addExistingItemsAfterKitSet.

Peut être utilisé sur un serveur pour tous les nouveaux joueurs ou en solo pour commencer avec un inventaire par défaut de votre choix. Il y a aussi un support optionnel pour le mod Team Island de FTB après la commande create island.

Le mod peut être utilisé uniquement côté serveur. Si vous voulez que les joueurs puissent utiliser l'interface "Choose Kit GUI", il doit aussi être installé sur le client. Sinon, ils peuvent choisir des kits via les commandes du serveur.

Fonctionnalités : • Un guide ici dans la description. Difficulté allant de Simple, Intermédiaire et Avancé. • Donnez aux joueurs rejoignant le monde pour la première fois des objets de départ personnalisés et/ou des effets de potion. • Support de plusieurs kits. Peuvent être donnés aléatoirement ou choisis par le joueur. • Il y a un suivi personnalisé pour déterminer qui sont les nouveaux joueurs, compatible avec les mondes existants. • Beaucoup de commandes ! Pour créer, ajouter, gérer et choisir des kits de départ. • Si installé sur le client, les kits peuvent être choisis via un écran GUI personnalisé. Sinon, les commandes peuvent être utilisées. • Ajoutez des descriptions à vos kits. Modpack RPG, quelqu'un ? • Supprimez les autres objets de départ moddés, comme les livres guides. Ou ajoutez-les après le kit de départ. • Support de Curios et Trinkets ! Les objets dans ces emplacements sont sauvegardés dans le kit et rendus, sans nécessiter l'un ou l'autre des mods. • Exécutez des commandes lorsqu'un kit est donné, comme accorder une compétence. Chaque kit a son propre fichier dans le dossier commands. • Les noms de kits, descriptions et le texte de choix de kit peuvent être des clés de traduction. Parfait pour les modpacks multilingues.

Toutes les options de configuration disponibles :

Afficher le spoiler

randomizeMultipleKitsToggle par défaut true Lorsque plusieurs kits de départ sont ajoutés via /starterkit add, il y a deux façons de les distribuer. Avec ceci activé, un est choisi au hasard. Lorsque désactivé, les joueurs peuvent en choisir un à la première connexion.

randomKitWeights par défaut "" La probabilité que chaque kit soit choisi lorsque les kits sont donnés aléatoirement, sous forme de paires kitname:weight séparées par des virgules. Les kits qui ne sont pas listés ont un poids de 1. Par exemple 'warrior:5,wizard:1' rend le kit warrior 5 fois plus probable que le kit wizard.

giveStarterKitOnFirstJoin par défaut true Si les nouveaux joueurs reçoivent (ou peuvent choisir) un kit de départ lorsqu'ils rejoignent pour la première fois. Lorsque désactivé, les kits sont uniquement distribués via '/sk give <player>', ce qui ouvre l'écran de choix de kit lorsque les joueurs peuvent choisir. Utile pour un PNJ ou un bloc de commande qui distribue des kits.

giveStarterKitOnRespawn par défaut false Si les joueurs reçoivent à nouveau le dernier kit de départ qu'ils ont obtenu lorsqu'ils réapparaissent après être morts. Ne fait rien lorsque la règle de jeu keepInventory est activée.

addExistingItemsAfterKitSet par défaut true Si les objets qui existaient dans l'inventaire, comme les livres ajoutés par d'autres mods, doivent être rajoutés à l'inventaire après que le kit a été défini. Si désactivé, ils seront supprimés. Vous pouvez toujours les définir manuellement via le kit.

usePotionEffectsInStarterKit par défaut true Si la fonctionnalité des effets de potion/de créature doit être activée. Cela signifie que lors de la création d'un kit via /sk (add/set), il sauvegarde aussi les effets actifs que le joueur possède. Et lors de la distribution des kits de départ, il ajoute les effets aux nouveaux joueurs.

formatKitNames par défaut true Si les noms de kits doivent être formatés. Chaque mot sera mis en majuscule.

chooseKitText par défaut "%s, you can choose a starter kit!" Le texte utilisé au-dessus de l'écran de choix de kit, ou si le mod n'est pas installé dans le chat. %s sera remplacé par le nom du joueur. Peut aussi être une clé de traduction d'un pack de ressources, tout comme les noms de kits et les descriptions de kits.

lockKitChoiceScreen par défaut false Si l'écran de choix de kit reste ouvert jusqu'à ce qu'un kit soit choisi. Lorsque activé, la touche d'inventaire et Échap ne le ferment pas. Ceci est lu depuis la configuration propre à chaque joueur, donc un modpack le définit dans la configuration qu'il fournit.

announcePlayerKitChoiceInDedicatedServer par défaut true Si une annonce doit être diffusée au serveur chaque fois qu'un nouveau joueur fait un choix de kit. 'randomizeMultipleKitsToggle' doit être désactivé, et il doit y avoir au moins 2 kits de départ disponibles.

enableFTBIslandCreateCompatibility par défaut true Si le kit de départ doit être redéfini après la commande '/ftbteamislands create' de FTB Team Islands. Ne fait rien lorsqu'il n'est pas installé.

'/starterkit' et '/sk' peuvent tous deux être utilisés.

Commandes d'administration : /sk add (kitname) - Ajoute votre inventaire actuel aux kits actifs. /sk set (kitname) - Définit votre inventaire actuel comme le seul kit actif.

/sk give <player> (kitname) - Donne à un joueur un kit de départ aléatoire (ou spécifique).

/sk activate <kitname>/all - Déplace kitname ou tous les kits d'inactif à actif. /sk deactivate <kitname>/all - Déplace kitname ou tous les kits d'actif à inactif.

/sk list (inactive) - Liste tous les kits actifs (ou inactifs). /sk reset - Réinitialise tout le suivi. Les joueurs reçoivent un autre kit à la connexion. /sk reload - Recharge les changements de kit de départ depuis le dossier de configuration.

Commandes utilisateur : /sk choose <kitname> - Permet aux joueurs de choisir un kit de départ via les commandes. Ceci n'est nécessaire que lorsque Starter Kit n'est pas installé sur le client et que le serveur a activé les choix de kits. /sk info <kitname> - Affiche la description et les objets de kitname. /sk help - Affiche les commandes de Starter Kit en jeu.

Guide d'utilisation : Le mod peut être configuré de nombreuses façons différentes. Pour garder une meilleure vue d'ensemble, j'ai divisé la difficulté en trois sections différentes. Simple, Intermédiaire et Avancé.

Simple : Définir un kit de départ personnalisé. Ajouter/Supprimer des objets de départ d'autres mods. Et donner aux joueurs un kit de départ via les commandes.

Intermédiaire : Ajouter un kit de départ supplémentaire. Désactiver un kit via les commandes. Ajouter un kit de départ avec des effets de potion, et définir le niveau et la durée.

Avancé : Faire choisir aux joueurs un kit à la première connexion. Déplacer les kits par défaut inactifs vers actifs. Afficher l'écran GUI de choix de kit. Créer un kit de départ avec une description personnalisée.

Section 1 : Simple Ceci est le kit de départ par défaut, qui sera donné lorsque le mod est installé sans aucune configuration :

Vous pouvez définir votre propre kit de départ en utilisant la commande '/starterkit set (kitname)' (ou '/sk set (kitname)'). Le nom du kit est optionnel. Après avoir utilisé cette commande, tous les autres kits de départ actifs sont déplacés vers le dossier inactif.

Ici vous pouvez voir le nouveau fichier de données de kit de départ qui a été créé avec la commande précédente. Il se trouve dans './config/serilum/starterkit/kits/' :

C'est tout ! Tous les nouveaux joueurs recevront maintenant le kit "Upgraded" lorsqu'ils rejoignent le monde pour la première fois :

Dans le fichier de configuration, situé à './config/serilum/starterkit.json5', vous pouvez choisir si les autres objets de départ moddés doivent être supprimés ou donnés après le kit. Des exemples de ces objets de départ moddés sont les livres guides.

Pour donner à d'autres joueurs (ou à vous-même) un kit de départ manuellement, vous pouvez utiliser la commande '/starterkit give <player> (kitname)'. L'argument kitname est optionnel, s'il est omis : Si le mod est configuré via intermédiaire, un kit peut être donné aléatoirement. Si le mod est configuré via avancé, l'écran de choix de kit peut être affiché.

Section 2 : Intermédiaire Vous pouvez ajouter un autre kit actif en utilisant la commande '/starterkit add (kitname)'. Avec la configuration par défaut, cela signifie que les nouveaux joueurs recevront maintenant aléatoirement le kit de départ "Default" ou "No Bread".

Pour voir tous les kits de départ actifs, utilisez la commande '/starterkit list'. Pour voir les kits de départ inactifs, utilisez '/starterkit list inactive' :

Pour désactiver un kit actif, utilisez '/starterkit deactivate <kitname>'. Cela le déplace vers le dossier './config/serilum/starterkit/kits/inactive/'.

Le mod peut aussi donner des effets de potion en plus du kit de départ ! Assurez-vous que 'usePotionEffectsInStarterKit' est activé dans la configuration. Ensuite, assurez-vous simplement d'avoir l'effet de potion activé, et utilisez la commande '/starterkit set' ou '/starterkit add'. La durée de l'effet sera définie sur ce que le joueur a exactement maintenant, mais nous arrondirons cela à l'étape suivante.

Pour cet exemple, j'ai donné au joueur l'effet de potion speed. Il était actif lors de l'utilisation de la commande précédente :

Localisez et ouvrez le kit que nous venons de créer. Le chemin est './config/serilum/starterkit/kits/SpeedKit.txt' :

Ceci est le fichier de données du kit "Speed Kit". Il contient les objets que le joueur recevra et en bas quels effets seront donnés au joueur. Lorsqu'un kit est créé sans effets actifs, cette ligne sera vide. Sinon, il copie le niveau et la durée exacts. Dans le cas de cet exemple, il contient une référence à l'effet Speed. Il est de niveau 1 avec une durée de 3341 ticks, ce qui équivaut à 167 secondes. 20 ticks = 1 seconde.

Je vais changer l'effet qu'un joueur recevra en Speed niveau 5, avec une durée de 5 minutes. 6000 ticks = 300 secondes = 5 minutes :

Vous pouvez recharger tous les changements que vous avez faits aux fichiers dans './config/serilum/starterkit/' via la commande '/starterkit reload' :

C'est tout ! Chaque fois qu'un joueur rejoint un monde pour la première fois, il recevra maintenant le kit "Speed Kit". Qui contient quelques objets standard et l'effet Speed V, avec une durée de 5 minutes :

Afficher le spoiler

Section 3 : Avancé Starter Kit contient aussi un écran de choix de kit personnalisé ! Voici un exemple de ce à quoi il ressemble avec le kit "Default". Dans cette section, nous allons activer ceci, créer un kit et ajouter une description pour celui-ci.

Désactivez le "Randomize Multiple Kits Toggle" dans la configuration. Rappelez-vous, il se trouve dans './config/serilum/starterkit.json5'. Vous pouvez aussi utiliser l'éditeur de configuration en jeu pour cela :

Il y a quelques kits par défaut situés dans le dossier './config/serilum/starterkit/kits/inactive/'. Activons ceux-ci pour cet exemple. Utilisez la commande '/starterkit activate all' pour activer tous les kits inactifs.

Vous pouvez utiliser la commande '/starterkit list' pour voir quels kits sont actuellement actifs :

Comme tout contient des valeurs par défaut, vous pouvez immédiatement le voir fonctionner ! Chargez un nouveau monde, et l'écran de choix de kit vous sera montré :

Afficher le spoiler

Ajoutons notre propre kit personnalisé, et voyons comment les descriptions fonctionnent. Commencez avec un inventaire de votre choix, et utilisez la commande '/starterkit add'. Je l'appelle "Pumpkin".

Toutes les descriptions de kits sont sauvegardées dans './config/serilum/starterkit/descriptions/'. Celles-ci sont automatiquement créées chaque fois que vous créez ou ajoutez un kit. Ouvrez le fichier de description avec le nom du kit que vous venez de définir. Dans mon cas, le fichier est './config/serilum/starterkit/descriptions/Pumpkin.txt'.

Ceci est le contenu de description par défaut pour tout kit nouvellement créé. La description est utilisée pour l'écran de choix de kit, et la commande '/starterkit info <kitname>'.

Changez la description comme vous le souhaitez ! Il n'y a pas de limite de taille, mais tout débordement sera masqué. Assurez-vous donc qu'elle ne soit pas trop longue :

Pour recharger les changements que nous avons faits au fichier de description, utilisez la commande '/starterkit reload' :

C'est tout ! La description sera maintenant visible sur l'écran de choix de kit :

Cliquez sur le bouton "Choose Starter Kit", et recevez le kit sélectionné :

Starter Kit peut automatiquement détecter si le mod a été installé sur le client. Il y a un support pour une utilisation uniquement côté serveur. Dans ce cas, les joueurs peuvent choisir un kit via les commandes. Chaque fois que le serveur ne reçoit pas de réponse du client, ce qui signifie que le mod n'est pas installé, le message suivant est envoyé à la première connexion :

Les joueurs peuvent utiliser la commande '/starterkit info <kitname>' pour voir quels objets sont inclus dans le kit de départ :

Un kit peut être choisi avec la commande '/starterkit choose <kitname>' :

Vous pouvez librement utiliser ce mod dans n'importe quel modpack, tant que le téléchargement reste hébergé dans l'écosystème CurseForge ou Modrinth.

Serilum.com contient un aperçu et plus d'informations sur tous les mods disponibles.

Pour les problèmes, idées, suggestions ou quoi que ce soit d'autre, il y a le dépôt Github. Merci !