Latest revision as of 02:23, 16 September 2021

 

Home

 

Download

 

News

 

Support

 

Admin

 

Dev

 

Screen Shots

 

Grid List

 

Bugs

Languages:

English

[edit] Introduction

Depuis OpenSimulator 0.7.2, un certain nombre de fonctions sont fournies pour créer et manipuler des NPC côté serveur.

Les NPC sont contrôlés par un script qui doit être dans la même région que le NPC. Il peut être hébergé dans un attachement qui est attaché au maître.

Les NPC ne peuvent pas quitter la région dans laquelle ils sont nés.

L'apparence des NPC est sauvée et chargée en sérialisant la structure de données de l'apparence dans une notecard présente dans le même objet que le script. Les textures requises doivent être préservées quand un OAR est sauvegardé puis chargé.

Malheureusement, le format de données de l'apparence (tel que vu dans les notecards créées par la sauvegarde de l'apparence) est actuellement le même que celui utilisé pour la liaison avec OpenSimulator donc n'est pas prévu pour être édité directement. Cependant en y prenant bien attention, ceci peut être possible, voir Appearance Formats pour plus de détails mais ce n'est pas recommandé, sauf si vous avez vraiment, vraiment besoin de le faire.

[edit] Activer

Pour utiliser ces fonctions, vous avez besoin de des configurations suivantes dans votre fichier OpenSim.ini

1. Enabled = true défini dans la section [NPC].
2. Activer un moteur de script.

Dans config-include/osslEnable.ini

1. AllowOSFunctions = true
2. Vérifier la valeur de osslNPC pour définir les droits de la plupart des fonctions NPC.

Vous vérifiez également les droits de la fonction osAgentSaveAppearance().

Voir Configuring Simulator Parameters#Getting information about parameters si vous avez besoin de confirmer que ces paramètres sont correctement définis.

[edit] Notes

• Quand vous utilisez votre avatar pour modéliser l'apparence avant la sauvegarde, vous devez attendre quelques secondes avant d'invoquer une commande de changement d'apparence. C'est ainsi car la sauvegarde d'apparence opère actuellement avec un délai afin de gérer de multiples mises à jour de l'apparence depuis le client.
• Lorsque vous utilisez votre avatar pour modéliser l'apparence du NPC et si vous souhaitez repositionner les pièces jointes sur le NPC, vous devrez :

1. les repositionnez sur vous-même
2. puis les détachez depuis l'inventaire
3. les attacher à nouveau
4. et, enfin, sauvegarder l'apparence

En effet, actuellement, la sauvegarde des données d'apparence ne déclenche pas la sauvegarde des positions d'attachement.

[edit] Détection

llAgentSensor() peut être utilisé pour définir un capteur qui va détecter les NPC au même titre que les autres entités de région.

Dans OpenSimulator 0.7.2, les capteurs LSL détecteront les NPC comme des agents originaires.

Dans OpenSimulator 0.7.3-rc1 et supérieur, tant que le contraire n'est pas précisé, les NPC ne seront seulement détectés qu'en utilisant le drapeau OpenSimulator-specific.

//Author: mewtwo0641
 
list keys = [];
key npc;
string toucher;
key toucherkey;
vector toucherPos;
integer npc_on = FALSE;
 
default
{
    touch_start(integer x)
    {
        toucherkey = llDetectedKey(0);
        toucherPos = llDetectedPos(0);
        vector npcPos = llGetPos() + <1,1,1>;
 
        if(npc_on == FALSE)
        {
            npc = osNpcCreate("Fred", "Flintstone", npcPos, toucherkey);
            npc_on = TRUE;
            llSensor("", "", AGENT | NPC, 96.0, PI); //Retournera toujours la clef du NPC par rapport aux options définies dans osNpcCreate
            return;
        }
 
        if(npc_on == TRUE)
        {
            osNpcRemove(npc);
            llResetScript();
        }
    }
 
    sensor(integer num)
    {
        keys = [];
        integer i = 0;
 
        for(i; i < num; i++)
        {
            keys += llDetectedKey(i);
        }
 
        llOwnerSay(llDumpList2String(keys, "\n"));
    }
 
    no_sensor()
    {
        keys = [];
    }
}

Vous pouvez faire en sorte à ce que les NPC soient détectables de nouveau en tant qu' AGENT en utilisant l'option OS_NPC_SENSE_AS_AGENT dans osNpcCreate().

Cette précision sert à corriger le problème que certains scripts, détectant les NPC comme des AGENTS par défaut, peuvent être rendus inutilisables. (ex: les radars qui ne savent rien sur les NPC). Cependant la conversion d'autres scripts peuvent ne pas répondre comme prévu si les avatars ne sont pas détectés comme des agents (ex: les portes qui s'ouvrent automatiquement pour les avatars pourraient ne pas s'ouvrir pour les NPC).

Depuis OpenSimulator git master commit ecf7bb26 (Fri Jul 20 21:36:33 2012), llGetDetectedType() définit le drapeau OS_NPC si un NPC a été détecté. Si le NPC a été créé avec l'option OS_NPC_SENSE_AS_AGENT alors le drapeau AGENT sera aussi défini.

[edit] Formats de données

Pour plus d'informations sur le format utilisé pour stocker les informations relatives à l'apparence dans les notecards, voir Formats d'apparence.

[edit] Fonctions

[edit] Créer et Retirer

[edit] osNpcCreate

osNpcCreate(string firstname, string lastname, vector position, string cloneFrom):key

cloneFrom peut être:

• Le nom d'une notecard contenant une apparence d'avatar sérialisée, ou
• L'UUID de l'asset de la notecard, ou
• L'UUID d'un avatar connecté sur la même région. Cependant, notez que cette apparence ne sera pas persistante tant que osNpcSaveAppearance() n'est pas appellé.

Si le NPC est créé avec succès, alors son UUID est retourné, ce qui est nécessaire pour toutes les fonctions subséquentes. Un exemple est disponible dans osNpcCreate

(seulement depuis OpenSimulator 0.7.3-rc1). Ceci crée un NPC qui est "possédé" par le script de création et détecté en utilisant le drapeau OpenSimulator-only pour les capteurs.

[edit] osNpcCreate

Depuis OpenSimulator 0.7.3-rc1.

osNpcCreate(string firstname, string lastname, vector position, string cloneFrom, integer options):key

cloneFrom peut être:

• Le nom de la notecard contenant une apparence sérialisée d'avatar, ou
• L'UUID d'asset de la notecard, ou
• L'UUID d'un avatar actuellement connecté sur la même région. Cependant notez bien que cette apparence ne sera pas persistante tant que osNpcSaveAppearance() n'est pas appellé.

integer est un ensemble de drapeaux qui peut être 0 ou un de ceux ci

• OS_NPC_NOT_OWNED - crée un "unowned" NPC.
• OS_NPC_SENSE_AS_AGENT - crée un NPC qui est détecté en tant que AGENT par les capteurs LSL
• OS_NPC_OBJECT_GROUP - crée un NPC avec le groupe de l'objet du script, si le propriétaire de l'objet est membre de ce groupe.

Si le NPC est créé avec succès, alors son UUID est retourné, ce qui est nécessaire pour toutes les fonctions subséquentes. Un exemple est disponible dans osNpcCreate

[edit] osNpcRemove

osNpcRemove(key npc):void

Retire l'avatar donné depuis la région. Exemple à osNpcRemove.

[edit] Get et Set

[edit] osIsNpc

Depuis OpenSimulator 0.7.3-rc1.

osIsNpc(key npc):integer

Retourne TRUE si la clef donnée est un NPC, FALSE dans les autres cas.

[edit] osNpcGetRot

Récupère la rotation de l'avatar. Seulement la rotation autour du plan Z en coordonnées Euler (rotation horizontale) aura une signification.

osNpcGetRot(key npc):rotation

[edit] osNpcSetRot

osNpcSetRot(key npc, rotation rot):void

Définit la rotation de l'avatar. Seulement la rotation sur le plan Z en coordonnées Euler aura une signification (faire tourner l'avatar pour le faire pointer dans une direction ou une autre). Définir les valeurs Euler X ou Y résultera en une rotation d'une manière indéfinie.

[edit] osNpcGetPos

osNpcGetPos(key npc):vector

Retourne la position actuelle du NPC.

[edit] osNpcGetOwner

Depuis OpenSimulator 0.7.3-rc1.

osNpcGetOwner(key npc):key

Retourne le propriétaire du NPC donné. (ex: le propriétaire du script qui l'a créé). Si le NPC est unowned ou la clef fournie n'appartient pas à un NPC, il sera retourné NULL_KEY.

[edit] Déplacement

[edit] osNpcMoveTo

osNpcMoveTo(key npc, vector position):void

Fonction plus ancienne qui effectue un osNpcMoveToTarget() en volant et atterrissant sur la cible.

[edit] osNpcMoveToTarget

osNpcMoveToTarget(key npc, vector target, int options):void

Déplace l'avatar à une cible donnée durant un certain temps. La façon dont l'avatar va rejoindre sa cible dépendra des options suivantes.

• OS_NPC_FLY - Fait voler l'avatar à la position donnée. L'avatar n'atterrira pas tant que l'option OS_NPC_LAND_AT_TARGET n'est pas aussi définie.
• OS_NPC_NO_FLY - Ne fait pas voler vers la cible. Le NPC va tenter de marcher vers la destination. Si elle est en hauteur dans les airs, alors l'avatar va rebondir sans cesse jusqu'à ce qu'un autre move to target lui soit donné ou que le déplacement soit interrompu.
• OS_NPC_LAND_AT_TARGET - Si défini et que l'avatar donné est en train de voler, alors il va atterrir quand il atteindra la cible. Si OS_NPC_NO_FLY est donné, alors cette option n'aura pas d'effet.
• OS_NPC_RUNNING - Si défini, le NPC se déplacera à vitesse rapide ou lente, sinon à vitesse normale.

OS_NPC_FLY et OS_NPC_NO_FLY sont des options qui ne peuvent être combinées - l'avatar va finir par utiliser soit l'une soit l'autre. Si vous voulez que l'avatar vole et atterrisse sur la cible, alors OS_NPC_LAND_AT_TARGET doit être combiné avec OS_NPC_FLY. Par exemple,

osNpcMoveToTarget(npc, llGetPos() + <9,9,5>, OS_NPC_FLY|OS_NPC_LAND_AT_TARGET);

[edit] osNpcStopMoveToTarget

osNpcStopMoveToTarget(key npc):void

Arrête le déplacement actuel vers une cible.

[edit] Sitting and standing

[edit] osNpcSit

Depuis OpenSimulator 0.7.3-rc1.

osNpcSit(key npc, key target, int options):void

Assied un NPC sur la primitive cible.

[edit] osNpcStand

Depuis OpenSimulator 0.7.3-rc1.

osNpcStand(key npc):void

Mettre debout le NPC.

[edit] Communication

[edit] osNpcSay

osNpcSay(key npc, string message):void
osNpcSay(key npc, int channel, string message):void

Faire dire le message donné au NPC.

Si le canal est spécifié, alors le texte est dit sur le canal donné. Le parametre de canal est seulement disponible dans les versions supérieures à 0.7.4.

[edit] osNpcSayTo

osNpcSayTo(key npc, key target, integer channel, string message):void

Demande au NPC de dire le message donné sur le canal donné à la cible spécifiée.

Cette fonction est basée sur llRegionSayTo, elle n'a donc pas de limitation de portée à l'intérieur de la région.

Ajouté dans OpenSimulator 0.9.1.0 Dev

[edit] osNpcShout

Depuis OpenSimulator 0.7.4.

osNpcShout(key npc, int channel, string message):void

Faire crier le message donné au NPC sur le canal donné.

[edit] osNpcWhisper

Depuis OpenSimulator 0.7.4.

osNpcWhisper(key npc, int channel, string message):void

Faire chuchotter le message donné au NPC sur le canal donné.

[edit] Animations

[edit] osNpcPlayAnimation

Depuis OpenSimulator 0.7.3-rc1.

osNpcPlayAnimation(key npc, string animation):void

Faire jouer une animation au NPC. L'animation peut être soit une clef, soit le nom d'une animation contenue dans le même inventaire que le script.

[edit] osNpcStopAnimation

Dans OpenSimulator 0.7.3-rc1 il y a un bug qui fait jouer l'animation à la place. Ceci sera corrigé dans la version finale mais en attendant, utilisez osAvatarStopAnimation() à la place.

osNpcStopAnimation(key npc, string animation):void

Faire stopper une animation jouée par le NPC. L'animation peut être soit une clef, soit le nom d'une animation contenue dans le même inventaire que le script.

[edit] Appearance

L'apparence d'un NPC est manipulée en sauvegardant puis chargeant les données d'apparence dans une notecard contenue dans le même inventaire que le script invoqué.

[edit] osOwnerSaveAppearance

osOwnerSaveAppearance(string notecard):key

Sauvegarde l'apparence actuelle du propriétaire vers une notecard dans l'inventaire de la primitive. Ceci inclut les données du corps, les vêtements et attachements. Si une notecard ayant le même nom existe déjà, elle sera alors remplacée. Le propriétaire doit être présent sur la région quand la fonction est invoquée. Les texture rendues pour le propriétaire (nécessaires pour recréer l'apparence du NPC) sont sauvées définitivement.

[edit] osAgentSaveAppearance

osAgentSaveAppearance(key agentId, string notecard):key

Sauvegarde l'apparence actuelle d'un avatar vers une notecard dans l'inventaire de la primitive. Ceci inclut les données du corps, les vêtements et attachements. Si une notecard ayant le même nom existe déjà, elle sera alors remplacée. L'avatar doit être présent sur la région quand la fonction est invoquée. Les texture rendues pour l'avatar (nécessaires pour recréer l'apparence du NPC) sont sauvées définitivement.

[edit] osNpcSaveAppearance

osNpcSaveAppearance(key npc, string notecard):key

Sauvegarde l'apparence actuelle du NPC vers une notecard dans l'inventaire de la primitive. Ceci inclut les données du corps, les vêtements et attachements. Si une notecard ayant le même nom existe déjà, elle sera alors remplacée. L'avatar doit être présent sur la région quand la fonction est invoquée. Les texture rendues pour l'avatar (nécessaires pour recréer l'apparence du NPC) sont sauvées définitivement.

[edit] osNpcLoadAppearance

osNpcLoadAppearance(key npc, string notecard):void

Charge l'apparence depuis une notecard. Cette notecard doit contenir des données d'apparence crées avec une des fonctions de sauvegarde d'apparence.

[edit] Toucher

[edit] osNpcTouch

Depuis OpenSimulator 0.7.4.

osNpcTouch(key npc, key objectKey, integer linkNum)

Autorise le NPC à toucher des objets.

[edit] Exemples

[edit] NPC Automator

• NPC Automator 2.0

Ceci est un exemple brut pour la plupart des fonctionnalités des NPC. Une de ses déficiences majeures est qu'il ne suit pas plus d'un avatar créé à la fois. Bien sûr, n'hesitez pas à l'améliorer.

key npc;
integer listenChannel = 10;
 
default
{
    // NPC manipulator adapted by justincc 0.0.3 released 20121025
    state_entry()
    {
        llListen(listenChannel,"",NULL_KEY,"");
        llSetText("Listening on " + listenChannel, <0, 255, 0>, 1);
        llOwnerSay("Say /" + (string)listenChannel + " help for commands");
    }
 
    listen(integer channel, string name, key id, string msg)
    {
        if (msg != "")
        {
            list commands = llParseString2List(msg, [ " " ], []);
            string msg0 = llList2String(commands, 0);
            string msg1 = llList2String(commands, 1);
            string msg2 = llList2String(commands, 2);
            string msg3 = llList2String(commands, 3);
 
            if (msg0 == "create")
            {
                if (msg1 != "")
                {
                    string notecardName = msg1;
 
                    npc = osNpcCreate("Jane", "Doe", llGetPos() + <5, 5, 0>, notecardName);
 
                    llOwnerSay("Creation du npc depuis la notecard " + notecardName);
                }
                else
                {
                    llOwnerSay("Utilisation: create <notecard-name>");
                }
            }
            else if (msg0 =="createm" && msg1 != "")
            {
                osOwnerSaveAppearance("appearance");
                vector pos = llGetPos();
                integer i;
                for (i = 0; i < (integer)msg1; i++)
                {
                    osNpcCreate("John", "Doe", pos + <8, 0, 0>, "appearance");
                    llSleep(1);
                }
            }
            else if (msg0 == "remove" && npc != NULL_KEY)
            {
                osNpcSay(npc, "Vous le paierez de votre viiiiiieeeeeeee!!!.....");
                osNpcRemove(npc);
            }
            else if (msg0 == "say" && npc != NULL_KEY)
            {
                osNpcSay(npc, "Je suis votre pire cauchemard!!!!");
            }
            else if (msg0 == "move")
            {
                if (msg1 != "" && msg2 != "" && npc != NULL_KEY)
                {
                    vector delta = <(integer)msg1, (integer)msg2, 0>;
 
                    if (msg3 != "")
                    {
                        delta.z = (integer)msg3;
                    }
 
                    osNpcMoveTo(npc, osNpcGetPos(npc) + delta);
                }
                else
                {
                    llOwnerSay("Utilisation: move <x> <y> [<z>]");
                }
            }
            else if (msg0 == "moveto")
            {
                if (msg1 != "" && msg2 != "" && npc != NULL_KEY)
                {
                    vector pos = <(integer)msg1, (integer)msg2, 0>;
 
                    if (msg3 != "")
                    {
                        pos.z = (integer)msg3;
                    }
 
                    osNpcMoveTo(npc, pos);
                }
                else
                {
                    llOwnerSay("Utilisation: move <x> <y> [<z>]");
                }
            }
            else if (msg0 == "movetarget" && npc != NULL_KEY)
            {
                osNpcMoveToTarget(npc, llGetPos() + <9,9,5>, OS_NPC_FLY|OS_NPC_LAND_AT_TARGET);
            }
            else if (msg0 == "movetargetnoland" && npc != NULL_KEY)
            {
                osNpcMoveToTarget(npc, llGetPos() + <9,9,5>, OS_NPC_FLY);
            }
            else if (msg0 == "movetargetwalk" && npc != NULL_KEY)
            {
                osNpcMoveToTarget(npc, llGetPos() + <9,9,0>, OS_NPC_NO_FLY);
            }
            else if (msg0 == "rot" && npc != NULL_KEY)
            {
                vector xyz_angles = <0,0,90>; // Ceci pour définir un changement de 1 degres
                vector angles_in_radians = xyz_angles * DEG_TO_RAD; // Change en Radians
                rotation rot_xyzq = llEuler2Rot(angles_in_radians); // Change vers une Rotation
                rotation rot = osNpcGetRot(npc);
                osNpcSetRot(npc, rot * rot_xyzq);
            }
            else if (msg0 == "rotabs" && msg1 != "")
            {
                vector xyz_angles = <0, 0, (integer)msg1>;
                vector angles_in_radians = xyz_angles * DEG_TO_RAD; // Change en Radians
                rotation rot_xyzq = llEuler2Rot(angles_in_radians); // Change vers une Rotation
                osNpcSetRot(npc, rot_xyzq);
            }
            else if (msg0 == "animate" && npc != NULL_KEY)
            {
                osAvatarPlayAnimation(npc, "stabbed+die_2");
                llSleep(3);
                osAvatarStopAnimation(npc, "stabbed+die_2");
            }
            else if (msg0 == "save" && msg1 != "" && npc != NULL_KEY)
            {
                osNpcSaveAppearance(npc, msg1);
                llOwnerSay("Apparence sauvegardée " + msg1 + " to " + npc);
            }
            else if (msg0 == "load" && msg1 != "" && npc != NULL_KEY)
            {
                osNpcLoadAppearance(npc, msg1);
                llOwnerSay("Apparence chargée " + msg1 + " to " + npc);
            }
            else if (msg0 == "clone")
            {
                if (msg1 != "")
                {
                    osOwnerSaveAppearance(msg1);
                    llOwnerSay("Votre apparence a été clonée vers " + msg1);
                }
                else
                {
                    llOwnerSay("Utilisation: clone <notecard-name-to-save>");
                }
            }
            else if (msg0 == "stop" && npc != NULL_KEY)
            {
                osNpcStopMoveToTarget(npc);
            }
            else if (msg0 == "sit" && msg1 != "" && npc != NULL_KEY)
            {
                osNpcSit(npc, msg1, OS_NPC_SIT_NOW);
            }
            else if (msg0 == "stand" && npc != NULL_KEY)
            {
                osNpcStand(npc);
            }
            else if (msg0 == "help")
            {
                llOwnerSay("Les commandes sont:");
                llOwnerSay("create <notecard-name> - Crée un NPC depuis une notecarde sauvegardée");
                llOwnerSay("createm");
                llOwnerSay("remove - Retire le NPC actuel");
                llOwnerSay("clone <notecard-name> - Cloner sa propre apparence vers une notecard");
                llOwnerSay("load <notecard-name>  - Charge l'apparence d'une notecard vers le NPC actuel");
                llOwnerSay("save <notecard-name>  - Sauvegarde l'apparence du NPC actuel vers une notecard");
                llOwnerSay("animate");
                llOwnerSay("move");
                llOwnerSay("moveto <x> <y> <z> - se déplace vers la position absolue définie");
                llOwnerSay("movetargetnoland");
                llOwnerSay("movetargetwalk");
                llOwnerSay("rot");
                llOwnerSay("say");
                llOwnerSay("sit <target-uuid>");
                llOwnerSay("stop");
                llOwnerSay("stand");
            }
            else
            {
                llOwnerSay("Je ne comprends pas [" + msg + "]");
            }
        }
    }
}

[edit] OSW NPCs Controller

OpenSimWorld fournit un contrôleur de NPCs qui supporte les NPCs interactifs. Le système vous permet de donner des commandes aux NPCs à travers le chat local et de construire des comportements complexes à travers des notecards faciles à écrire. Il vous permet également de spécifier une "carte" de votre région afin que le NPC puisse la parcourir.

Plus d'informations

[edit] Questions/Commentaires

S'il vous plait, laissez vos questions et commentaires sur la page de discussion de cet article.