Aller au contenu
← Documentation

HumanNPC · Kits

Un personnage, son équipement et son interaction

Préparez un PNJ sans écrire ses fichiers à la main. Les plugins conservent leurs formats et leurs règles ; le projet rassemble les documents nécessaires.

Créer un PNJ →

1. Définir le personnage

Ouvrez Personnages PNJ dans le hub, puis créez un personnage. Indiquez son nom : vous pouvez préparer sa tenue et enregistrer le projet avant de choisir les coordonnées X, Y, Z relevées sur votre serveur. L’outil ne choisit pas une position arbitraire. Dans Position, réglez son orientation et, si nécessaire, une permission pour l’utiliser.

Chaque personnage reçoit un ID HumanNPC exact et un identifiant d’interaction stable. Lors d’une application sur un autre serveur, une collision peut nécessiter un autre ID ; le résultat présente ce changement.

2. Ajouter vêtements et armes

L’onglet Équipement reprend l’inventaire de Kits : tenue, ceinture et sac. Ajoutez un objet avec la recherche d’items, puis réglez quantité, skin, état et contenu. Une arme compatible propose ses accessoires et ses munitions.

Les vêtements se portent dans Tenue, les armes s’équipent dans Ceinture et les objets du Sac restent rangés. Le kit créé est masqué et réservé à l’administration. Il ne constitue pas un lot que les joueurs peuvent réclamer. L’aperçu 3D utilise des modèles légers ; un objet sans modèle ou un skin sans texture reste dans les fichiers, avec un avertissement clair dans l’aperçu.

3. Choisir une interaction

Dans Interaction, choisissez aucune action, un message public, un dialogue existant ou une page PimpMyCUI. Choisissez une ressource dans le projet actuel, un fichier PMR ou vos projets enregistrés. Vous pouvez aussi créer une nouvelle fenêtre CUI directement dans ce sélecteur. Annuler conserve l’interaction précédente.

Choisissez une page libre pour cette interaction. Les pages Récompenses et Traduction déjà reliées à leur plugin ne sont pas proposées ici. L’outil utilise uniquement les actions prises en charge, sans exécuter de nom de hook saisi librement.

L’action Offrir un kit utilise l’API GiveKit. Elle ignore le prix, le délai et la limite d’utilisations de la réclamation normale : utilisez-la seulement pour un cadeau volontaire. NpcOverlay peut ajouter un texte au-dessus du personnage, avec des textes français et anglais séparés.

4. Conserver et installer

Enregistrer
Conserve le projet dans votre compte. Cette action ne modifie aucun serveur.
Télécharger le projet PMR
Conserve une copie modifiable des documents et interfaces, réutilisable sur un autre serveur.
Télécharger les fichiers ZIP
Prépare les fichiers des plugins, les interfaces compilées et les instructions de fusion. Le projet modifiable reste inclus. Ne remplacez jamais un catalogue ou un registre CUI existant sans conserver ses autres entrées.
Envoyer vers un serveur
Vérifie les fichiers existants, prépare leurs sauvegardes et réconcilie les IDs avant l’installation. La destination et les étapes sont présentées avant confirmation.

HumanNPC écrit ses données en mémoire. Il doit être arrêté avant leur modification : cela interrompt temporairement tous les PNJ. Le résultat distingue fichiers copiés, plugins chargés et présence du personnage. Une copie réussie ne prouve pas à elle seule qu’un personnage est apparu en jeu.

Installez HumanNPC et Kits séparément. Une interface CUI nécessite PimpMyCUI et le compagnon PimpMyRust ; un message public ou un cadeau utilise aussi le compagnon. Le compagnon n’est pas nécessaire pour un PNJ sans action ni pour un dialogue géré directement par Dialogs. Ce dernier nécessite Dialogs et PlayerEventStates ; le texte au-dessus du PNJ nécessite NpcOverlay. L’onglet Installation affiche les plugins requis pour votre projet.