Voici le guide complet sur les commandes de gestion des PNJ (Personnages Non-Joueurs) dans Hytale. Ces outils sont essentiels pour donner vie à vos mondes, créer des scénarios ou tester les comportements de l’intelligence artificielle.
La commande /npc
Cette commande est la pierre angulaire de la gestion des entités dans Hytale. Elle permet non seulement de faire apparaître des créatures et des personnages, mais aussi de modifier leur comportement, leur équipement et leurs déplacements en temps réel.
📋 Fiche Technique
- Description : Création, modification, équipement et débogage des PNJ.
- Permission :
hytale.npc.command.npc
🛠️ Syntaxe et Utilisation
| Action | Sous-commande | Description |
| Apparition | /npc spawn <rôle> | Fait apparaître un PNJ avec un rôle spécifique. |
| Tout faire apparaître | /npc all | Fait apparaître tous les rôles de PNJ disponibles (utile pour les tests de charge). |
| Changer l’apparence | /npc appearance <modèle> | Change le modèle visuel (skin/mesh) d’un PNJ existant. |
| Définir le rôle | /npc role <rôle> | Change le rôle (l’IA et le comportement) d’un PNJ. |
| Nettoyer la zone | /npc clean | Supprime tous les PNJ environnants (commande de nettoyage de masse). |
| Combat | /npc attack | Définit une séquence d’attaque qui écrase le comportement par défaut. |
| Équipement | /npc give <item> | Donne un objet spécifique au PNJ (arme, outil). |
| Mouvement (Path) | /npc path | Définit un chemin temporaire (« transient path ») que le PNJ doit suivre. |
| Déplacement pas à pas | /npc step | Fait avancer le comportement du PNJ d’un nombre défini de « frames » (débogage précis). |
| Figer / Défiger | /npc freeze / /npc thaw | freeze fige totalement le PNJ. thaw le débloque. Utile pour prendre des screenshots ou inspecter une pose. |
| Groupes | /npc flock | Ajoute ou retire des PNJ d’un « troupeau » (comportement de groupe). |
| Mémoire IA | /npc blackboard | Commandes liées au « Blackboard » (la mémoire interne du PNJ où il stocke ses cibles, états, etc.). |
| Communication | /npc message <msg> | Envoie un message signal (beacon message) à un PNJ. |
| Débogage | /npc debug / /npc dump | Affiche les indicateurs de débogage ou exporte toutes les infos des composants du PNJ. |
La commande /path
Pour créer des rondes de garde ou des itinéraires de villageois réalistes, la commande /path est indispensable. Elle permet de définir des nœuds invisibles dans le monde que les PNJ configurés pourront suivre. Cela évite les mouvements aléatoires et permet de structurer la vie dans vos villes ou donjons.
📋 Fiche Technique
- Description : Création et édition des chemins de patrouille (Patrol Paths).
- Permission :
hytale.path.command.path
🛠️ Syntaxe et Utilisation
| Action | Sous-commande | Description |
| Nouveau chemin | /path new <nom> | Démarre l’enregistrement d’un nouveau chemin de patrouille. |
| Mode édition | /path edit | Prépare l’édition d’un chemin existant. |
| Ajouter un nœud | /path add | Ajoute un point de passage (nœud) au chemin actuel à votre position. |
| Lister les chemins | /path list | Affiche la liste de tous les chemins actifs dans le monde. |
| Infos des nœuds | /path nodes <ID> <path> | Liste tous les nœuds et informations pour un chemin donné. |
| Fusionner | /path merge <nom> | Fusionne un second chemin dans le chemin actuellement édité. |
| Mettre à jour | /path update | Met à jour les marqueurs de chemin des « prefabs » (structures préfabriquées). |
La commande /spawning
Alors que /npc gère les entités individuelles, /spawning contrôle les règles globales de génération de la faune et des monstres dans le monde. C’est une commande cruciale pour les administrateurs qui souhaitent sécuriser une zone de construction ou, au contraire, forcer le repeuplement d’une région après un nettoyage.
📋 Fiche Technique
- Description : Gestion du système de spawn global, des marqueurs et des zones d’interdiction.
- Permission :
hytale.spawning.command.spawning
🛠️ Syntaxe et Utilisation
| Action | Sous-commande | Description |
| Activer | /spawning enable | Active le système d’apparition des PNJ dans le monde. |
| Désactiver | /spawning disable | Désactive le système d’apparition (arrêt total des spawns naturels). |
| Repeupler | /spawning populate | Supprime les PNJ et relance une vague de peuplement complète. |
| Statistiques | /spawning stats | Affiche les stats de densité et de performance du spawning. |
| Marqueurs | /spawning markers | Commandes pour gérer les marqueurs d’apparition (points précis où des entités doivent apparaître). |
| Balises | /spawning beacons | Commandes liées aux balises de spawn (spawn beacons). |
| Suppression | /spawning suppression | Gère les commandes de suppression (création de zones empêchant le spawn). |