Ryzom Forge Wiki - User contributions [en]

EN Teddybear

2014-07-27T20:31:51Z

Madi: /* Object of the month: creating and deploying cudlly toys "Atys' mobs" in game */

{{TabLang|EN|Teddybaer|EN Teddybear|ES|FR Peluche|RU}}

{{ToTrad}}



(Translation under progress - if you want to complete it, please update this line so that no one will edit it in the meantime)

The aim of this tutorial is to show how to create cuddly toys based on the models of atysian animals.

=Object of the month: creating and deploying cudlly toys "Atys' mobs" in game=

[[File:00-tuto-peluche.png|300px]]

Prerequisite for modelising only the cuddly toy:

* Having installed Ryzom assets and properly set-up the repositories (NEL tools expect to find the assets in the W:\database folder).
* Having installed 3DSMax and set-up the NEL plugin (Beware the plugin works only with versions 32bits of 3DSMax, and from version 9 till version 2012).
* Advised but not mandatory: having installed the NEL tool "''tga2dds.exe''".

Prerequisite for deploying the cuddly toy on a game server:

* Having compiled and installed a game server, and having set-up a client to use it.

Note: it is possible to test this cuddly toy IG without having a game server through a trick which will be explained a bit further in this tutorial.

Some usefeul linkds for these prerequisites:

* Downloading the assets and tools: https://ryzomcore.atlassian.net/wiki/display/RC/Downloads+for+Windows
* Set-up the drive letter for the assets : https://ryzomcore.atlassian.net/wiki/display/RC/How+to+set+up+the+Build+Pipeline
* Insalling the NEL plugin of 3DSMax: https://ryzomcore.atlassian.net/wiki/display/RC/Installing+the+Max+Plugins

== Step 1: choosing the model we'll use for our cuddly toy ==

All 3d models for Ryzom fauna are gathered in the "W:\database\stuff\tryker\agents\monsters" folder, by creature family. In this tutorial, we'll use the "Gubani" model, which is located in the "horse" ("cheval" in French) folder, to create our cuddly toy:

W:\database\stuff\tryker\agents\monsters\cheval\h12tr_mo_h12.max

[[File:01-tuto-peluche-dossiers-mobs.png|600px]]

== Step 2: Getting the model and creating a dedicated work folder ==

In 3DSMax, open the "W:\database\stuff\tryker\agents\monsters\cheval\h12tr_mo_h12.max" file.

Use the menu => "File" => "Manage" => "Asset Tracking" to check the list of the files used in this model, especially the textures. Notice this two files:

* The 3d model: "tr_mo_h12.max"
* The texture for the gubani: "ju_mo_h12.png"

[[File:02-tuto-peluche-asset-tracking.png|800px]]

The aim here is to deploy cuddly monbs for the month object. Hence, we'll create a dedicated folder for our to-be toys and respect the naming convention used by Ryzom.

So we'll create a "soft-toy" folder, in the "W:\database\stuff\generique\agents\accessories" folder. We'll save our model by renaming it under: ge_acc_teddy-gubani_01.max

* the first "ge_" prefix in the file name specifies the ecosystem, here _ge_neric (tr: tryker, fy: fyros, etc...).
* the second prefix in the file name specifies the type of model (hom: male homin, mo: monster, wea: weapon, etc...). Here "acc" for _acc_essory.
* and last, the name of our model "teddy-gubani", which will be suffixed with a number, in order to be able to create several variants of the teddy-gubani.

For the texture, we should also copy it under "W:\database\stuff\generique\agents\_textures\accessories", but we'll do it more simply. We'll place it in the same folder as the 3d model and rename it according to the same convention: "ge_acc_teddy-gubani_01.png".

Ryzom core knwo only how to show textures with a ".tga" or ".dds" format. TGA is a raw format without compression which makes it useful for edition, but less efficient in term of memory space. DDS format is a compressed image format which, as jpeg, is destructive. It is the format used internally by Ryzom to minimize the textures' memory space. With your favorite editor, convert the ".png" image into a ".tga" one. That's the one we'll keep for edition. We'll use the NEL tool "'tga2dds'" to generate a texture image under ".dds" format for the 3d model. That's the one which well be used in 3DSMax.

tga2dds ge_acc_teddy-gubani_01.tga

If you don't have this tool, you gan keep the ".tga" version. It will work for the IG tests.
In the "soft-toy" folder, you should now have as a result:

[[File:03-tuto-peluche-dossier-soft-toy.png|600px]]

== Step 3: Cleaing the 3D model using 3DSMax ==
The monster 3D model contains a skeleton and animation tracks. This is not necessary for a toy accessory and unnecessarily overburden the final ryzom model. We will delete it.

[[File:04-tuto-peluche-animation.png|800px]]

Select with the mouse the "Gubani" model. In the right panel, select the "''modify''" tab. You should see the mesh called "TR_MO_H12" and in the stack one modifier called "physical". We will delete

[[File:05-tuto-peluche-physique.png|600px]]

Ensuite nous allons ouvrir l'écran affichant les éléments de la scene via le menu "Tools"=> "New Scene Explorer" et supprimer tous les éléments constituant le squelette du modèle pour ne garder au final que le mesh de l'animal.

Then we will open the scene explorer screen via the "Tools" menu => "New Scene Explorer" and delete all the elements constituting the skeleton of the model and keep only the animal mesh.

[[File:06-tuto-peluche-bones-01.png|800px]]

Now we have only one element in our "scene": the Gubani mesh "TR_MO_H12"

[[File:07-tuto-peluche-nettoyer-modele.png|800px]]

In the right panel, we will rename the mesh "ge_acc_tedy-gubani_01". This name will be used by the export "NEL" to name the generated file when exporting to "shape" NEL format.

[[File:07-tuto-peluche-nettoyer-modele-fin.png|800px]]

== Étape 4 : Map the right texture to the model ==

In this section, we will adapt the texturing of 3d model. In principle, we would just change the base texture "ju_mo_h12.png" to point to our "ge_acc_teddy-gubani_01.dds" texture (or the ". tga" one). However, this will be a bit more complicated:

First we open the "Material Editor" (1) screen, then we select the unique material of the scene (2) by double clicking on it. In the central viewport select the node named "Map # 1 Nel Multi Bitmap" by double clicking on it (3). In the right sidebar, a description of its properties (4) appear. The "Nel Multi Bitmap" allow to specify 8 different images. It is not multi-texturing, but the ability to configure multiple texture images. Only one is applied at a given moment on the model. This is used for the mobs to specify one texture for each ecosystem. This is also used by and environmental objects to specify a different texture for each season.

[[File:08-tuto-peluche-texture.png|800px]]

The ID 1 slot is used for textures of Tryker ecosystem, the second solt (ID 2) for the Fyros ecosystem Fyros. The third slot (ID 3) for Zoraï ecosystem and the fourth one (ID 4) for the Primes Root ecosystem. Do not look for Matis slot. As good aesthetes, they understood that beauty lay in the Zorai nature and therefore use Zoraï textures for all their animals. Note that here the Gubani is being ponly resent in jungle primes root. Only slots 3 and 4 are used

The same system is also used for other IG objects, such as buildings. In this case, the 4 slots correspond to the four seasons. Thus we can note the presence of snow on some Zoraï buildings in winter.

[[File:09-tuto-peluche-multi-texture.png]]

We will not use this mechanism. We will therefore deleted the "NEL Multi Bitmap" and replace it with a simple "Bitmap" by dragging the mouse from the output of "1 tTexture 1" as shown in the above image. When release the mouse, a menu appears (2), select "Bitmap" entry:

[[File:10-tuto-peluche-bitmap.png|800px]]

Then select our texture "W:\database\stuff\generic\agents\ _textures\accessories\ oft-toyge_acc_teddy gubani_01.dds" (or ".tga").

[[File:11-tuto-peluche-bitmap.png|800px]]

Repeat the operation on the other "Nel Multi Bitmap" which reference the same image.

== Étape 5 : Scaling the model ==

Our 3d model is almost ready. However, its size does not match what expected. If you use the 3dsmax measuring tool you will see that the Gubani is 2m high. The simplest way to put it in the right size is to load a Homin model to have visual comparison and ensure that the teddybear can be taken in hand.

So we will temporarily put in our scene a reference to another 3d model via the File menu (1) => References (2) => Xref Scene (3) and then clicking on the Add button (4) :

[[File:15-tuto-peluche-xref.png|800px]]

Select the Homin model "W:\database\stuff\generic\agents\actors\male\ge_hom_armor02.max" which should appear in your 3d scene.

[[File:15-tuto-peluche-xref-02.png]]

Scale the Gubani modeland move via tools "Scale" and "Move" from the popup menu that appears when you click the model with the right mouse button.

[[File:16-tuto-peluche-echelle.png]]

Once at the right scale, remove the reference to the homin model through the File menu => References => Xref Scene.

Reposition the Gubani model at the scene origin (x = 0, y = 0, z = 0), because when the object is carried the position (0,0,0) is located in the hand.

== Étape 6 : Adapt the texture for a fluffy look ==

In terms of texture, to give a "plush effect", give free rein to your imagination

[[File:17-tuto-peluche-texture-source.png]]

I edited the "ge_acc_teddy-gubani_01.tga" image with the Gimp application. I used the filter "Artistic> GIMPressionist" using the "canvas" model for a weft fabric effect.

[[File:17-tuto-peluche-texture-peluche.png]]

Once the image saved, I re-generated the dds texture with the command:

tga2dds ge_acc_teddy-gubani_01.tga

Here is the result on the 3d model in 3dsmax:

[[File:18-tuto-peluche-modele3d.png]]

== Step 7 : Shape export ==

It's time to test the teddybear IG. For this game you have to export the model to the "shape" file used by the Ryzom engine

If this is not already the case I add the ''NEL export'' button on your right side panel by clicking on the"utilities" tab thant "More" button and selecting the "NEL Export" option :

[[File:20-tuto-peluche-export-nel-01.png]]

Then select the Gubani mesh with the mouse and click on the "Export Model" button. You must specify the folder on wihc the file "ge_acc_teddy-Gubani-01.shape" will be created.

[[File:20-tuto-peluche-export-nel-02.png]]

== Étape 8 : Tester la peluche IG ==

Pour bien faire les choses, il faudrait ajouter le ''datasheet'' de la peluche au serveur de jeu et patcher le client. Cette méthode sera détaillée plus loin. Cependant il existe une solution de contournement si vous n'avez pas votre propre serveur de jeu pour réaliser ces opérations.

Il faut savoir qu'une peluche n'est rien d'autre qu'une arme équipée. Ainsi nous pourrions remplacer le modèle de la dague par celui de notre gubani pour le tester sur le serveur officiel. Il existe une astuce simple pour cela. Le client de jeu recherche les modèles et textures dans le dossier "user" avant d'aller voir le dossier "data". Il suffit de copier notre fichier shape et la texture associée dans le dossier "user", puis de renommer le shape du gubani en celui de la dague : "GE_Wea_Dague.shape"

A présent lorsque vous équiperez une dague IG, vous aurez en main notre peluche "gubani".
Pour retrouver la dague d'origine, il suffit de supprimer le fichier shape du dossier "user" :

[[File:21-gubani-peluche-axe.png|400px]]

En réalisant ce test vous pouvez noter une anomalie : la peluche est tenue par le pied, ce qui n'est pas forcément ce que nous voulons

== Étape 9 : orientation et positionnement d'un objet porté ==

Le point de fixation d'un objet tenu en main correspond au point de coordonnée (0,0,0) de l'objet.Son orientation suit la règle suivante :

l'axe X remonte le long de l'avant-bras ;
l'axe Y part depuis le dos de la main vers l'extérieur ;
l'axe Z pointe vers le haut de l'objet tenu fermement en main.

Nous réorientons la peluche gubani dans 3dsmax comme le montre l'image suivante : l'axe X sort du dos du gubani pour remonter le long du bras qui le portera. L'axe Z sort de la main et est donc dans le prolongement de la tête de la peluche :

[[File:22-gubani-peluche-axe-3dsmax.png]]

Après réorientation du modèle gubani et réexportation du shape nous obtenons enfin une peluche qui est tenue par le tronc :

[[File:22-gubani-peluche-axe.png|400px]]

Pour aller plus loin sur les objets portés, je vous conseille de lire ce tutorial : http://khaganat.net/wikhan/fr:todo:dessiner:creation_d_un_objet_prehensible_en_jeu

== Étape 9 : Créer l’icône pour l'inventaire et la barre d'actions ==

Il faut créer un icône pour l'affichage de l'item peluche gubani dans l'inventaire et dans la barre d'actions.
Cet au icône au format tga doit faire 40x40 pixels avec un fond transparent. Nous le nommerons "icon_teddygubani.tga"

L'icône de 40x40 pixels :

[[File:23-icone-gubani.png|80px]]

Pour des questions de performance, ces icônes ne sont pas stockés individuellement mais regroupés dans une seule image dénommée : "texture_interfaces_v3.tga". Le fichier texte associé dénommé "texture_interfaces_v3.txt" liste les icones présents et leur position dans l'image :

[[File:23-icone-gubani-contexte-txt.png]]

le fichier texte utilise le format suivant pour chaque ligne :

NomFichierIcone u1 v1 u2 v2

Avec :
* u1,v1 la position du point supérieur gauche de l'icône
* u2,v2 la position du coin inférieur droit de l'icône

A la différence des coordonnées en pixels, ces coordonnées qui utilisent la technique du UV Mapping en 3d ont leurs valeurs dans l’intervalle [0 .. 1]. la coordonnée (0,0) correspond au point supérieur gauche de l'image et (1,1) au point inférieur droit de l'image.

Le passage d'un système à l'autre est simple. Soit (x1,y1) la position en pixels du coin haut gauche de notre icône dans l'image globale et (x2,y2) la position du point inférieur droit de l'icône dans l'image, alors :
* u1 = x1 / largeur-image
* v1 = y1 / hauteur-image
* u2 = x2 / largeur-image
* v2 = y2 / hauteur-image

Sachant que la texture "texture_interfaces_v3.tga" fait 1024x1024 pixel, et que dans l'exemple l'icône "icon_teddygubani.tga" se situe à la position (x1=118,y1=798), que le point inférieur gauche étant à la position (x2=157,y2=837), le fichier txt contient donc la ligne :

icon_teddygubani.tga 0.115234375 0.779296875 0.1533203125 0.8173828125

Même si cela peut être ajouté à la main, la bonne méthode et d'utiliser l'outil dédié de NEL ''build_interface'' comme indiqué dans le tutorial https://khaganat.net/wikhan/fr:todo:dessiner:creer_icone_objet qui recrée la texture globale et le fichier txt à partir d'un dossier contenant tous les icones.

Note: L'ajout de l'icône ne suffit pas, il faut également créer le datasheet de l'objet peluche et spécifier dedans le nom de notre icône à utiliser comme nous le verrons plus loin dans ce tutorial. Au final nous obtenons le résultat suivant IG :

[[File:23-icone-gubani-contexte.png]]

== Etape 11 : créer le fichiers des noms ==

A compléter.

[[File:30-tuto-peluche-txtfile.png]]

== Étape 12 : créer le datasheet ==

A la base, une peluche reste est un objet porté comme une arme. De fait le datasheet de la peluche est trs semblable à celui d'une arme une main, comme l'exemple de la dague ci-dessous.

__icrm1pd.sitem ( datasheet de la dague du réfugié ) :__

<pre>
<?xml version="1.0"?>
<FORM Revision="$Revision: 1.2 $" State="modified">
<PARENT Filename="_c_m1pd.sitem"/>
<STRUCT>
<STRUCT Name="basics">
<ATOM Name="name" Value="refugee dagger"/>
<ATOM Name="origin" Value="refugee"/>
<ATOM Name="Drop or Sell" Value="false"/>
<ATOM Name="CraftPlan" Value="bcrmea06.sbrick"/>
<ATOM Name="Saleable" Value="false"/>
</STRUCT>
<STRUCT Name="3d">
<ATOM Name="shape" Value="GE_Wea_Dague.shape"/>
<ATOM Name="shape_female" Value="GE_Wea_Dague.shape"/>
<ATOM Name="map_variant" Value="Low Quality"/>
<ATOM Name="icon background" Value="BK_generic.tga"/>
<STRUCT Name="fx">
<ATOM Name="Trail" Value="GE_Wea_Dague_trail_00.shape"/>
</STRUCT>
</STRUCT>
</STRUCT>
<STRUCT/>
<STRUCT/>
<STRUCT/>
<STRUCT/>
<LOG>
</FORM>
</pre>

Ce qui change c'est :

* la référénce au shape dans la section "3d"

<ATOM Name="shape" Value="ge_acc_teddy-gubani_01.shape"/>
<ATOM Name="shape_female" Value="ge_acc_teddy-gubani_01.shape"/>

* la référence à l'icone utilisé dans la barre d'état et l'inventaire dans la section "3d"

<ATOM Name="icon" Value="icon_teddygubani.tga"/>
<ATOM Name="icon overlay" Value="icon_teddygubani.tga"/>

* les caractéristiques de base qui diffèrent d'une arme : pas de niveau requis, pas de brique de plan, etc..

<STRUCT Name="basics">
<ATOM Name="name" Value="staff"/>
<ATOM Name="origin" Value="common"/>
<ATOM Name="family" Value="handled item"/>
<ATOM Name="ItemType" Value="Staff"/>
<ATOM Name="Bulk" Value="5"/>
<ATOM Name="RequiredCharacQualityFactor" Value="0"/>
<ATOM Name="RequiredCharacQualityOffset" Value="0"/>
</STRUCT>

Voila donc le datasheet de la peluche gubani que nous nommerons "teddygubani.sitem" :

<pre>
<?xml version="1.0"?>
<FORM Revision="$Revision: 1.7 $" State="modified">
<PARENT Filename="_c_m1pd.sitem"/>
<STRUCT>
<STRUCT Name="basics">
<ATOM Name="name" Value="staff"/>
<ATOM Name="origin" Value="common"/>
<ATOM Name="family" Value="handled item"/>
<ATOM Name="ItemType" Value="Staff"/>
<ATOM Name="Bulk" Value="5"/>
<ATOM Name="RequiredCharacQualityFactor" Value="0"/>
<ATOM Name="RequiredCharacQualityOffset" Value="0"/>
</STRUCT>
<STRUCT Name="3d">
<ATOM Name="shape" Value="ge_acc_teddy-gubani_01.shape"/>
<ATOM Name="shape_female" Value="ge_acc_teddy-gubani_01.shape"/>
<ATOM Name="map_variant" Value="Low Quality"/>
<ATOM Name="icon" Value="icon_teddygubani.tga"/>
<ATOM Name="icon background" Value="BK_generic.tga"/>
<ATOM Name="icon overlay" Value="icon_teddygubani.tga"/>
<STRUCT Name="fx">
<ATOM Name="Trail" Value="GE_Wea_Dague_trail_00.shape"/>
</STRUCT>
</STRUCT>
</STRUCT>
<STRUCT/>
<STRUCT/>
<STRUCT/>
<STRUCT/>
<LOG></LOG>
</FORM>
</pre>

== Étape 13 : Déployer la peluche sur le serveur et le client de jeu ==

Afin de déployer la peluche en jeu la méthode officielle consiste à utiliser la pipeline "build_gamedata" (cf. https:''ryzomcore.atlassian.net/wiki/display/RC/Gamedata+Build+Pipeline). Je vais vous proposer une méthode différente, où les opérations seront effectués à la mains, mais uniquement celles nécessaires à notre peluche :

Nous avons besoin des fichiers suivants :

* teddygubani.sitem ( le datasheet de la peluche gunabi )
* ge_acc_teddy-gubani_01.shape ( le modèle 3d NEL de la peluche )
* ge_acc_teddy-gubani_01.dds ( la texture du modèle 3d )

De plus le déploiement de cette peluche va impacter les fichiers suivants :

* les fichiers "*.packed_sheets" utilisée par le serveur et le client qui sont une version compilé des datasheets
* le fichier "sheet_id.bin" qui est un index de tous les datasheets utilisés par le jeu
* le fichier "visual_slot.tab" qui liste les éléments affichables coté client

Pour bien faire les choses, nous allons également créer un fichier "soft-toy.bnp" qui contiendra les shapes et les textures de toutes les futures peluches.

Pour la suite des opérations nous partons du principe que notre serveur de jeu fonctionne sous linux, et que les variables d'envrionnement suivantes sont définies :

* LEVELDESIGNPATH pointe sur le dossier des datas du level design
* RYZOM_HOME sur l'installation des sources du serveur

=== Ajout du datasheet "teddygubani.sitem" au serveur ===

Coté serveur nous allons créer un dossier dédié pour les datasheets des peluches et y placer celui du gubani :

$ mkdir $LEVELDESIGNPATH/leveldesign/game_element/sitem/soft-toy
$ cp teddygubani.sitem $LEVELDESIGNPATH/leveldesign/game_element/sitem/soft-toy

=== Nettoyages préalables ===

=== Re-générer le fichier "sheet_id.bin" ===

La première étape consiste à regénérer le fichier d'index des datasheet via la commande "make_sheet_id". Il reprend le fichier d'index existant et va le compléter avec les datasheets du dossier $RYZOM_LEVELPATH/leveldesign/game_element/sitem/soft-toy c'est-à-dire les datasheets de nos peluches

$ make_sheet_id -o$LEVELDESIGNPATH/leveldesign/Game_elem/sheet_id.bin $LEVELDESIGNPATH/leveldesign/game_element/sitem/soft-toy

=== Re-générer les "*.packed_sheets" et "visual_slot.tab" ===

Il faut regénérer les "*.packed_sheets".Ce sont les versions pré-compilées des datasheets :

$ sheets_packer

Cette commande va également re-générer le fichier visual_slot.tab

=== Copier les fichiers nécessaires coté client ===

* Nous copions le fichier "visual_slot.tab" généré dans le dossier courant dans le dossier "user" du client de jeu
* Nous copions le fichier $LEVELDESIGNPATH/leveldesign/Game_elem/sheet_id.bin dans le dossier "user" du client de jeu
* Nous remplaçons les fichiers packet_sheets du dossier "data" du client par ceux générés ici $RYZOM_HOME/code/ryzom/client/data/*.packed_sheets par la commande ''sheets_packer''

=== Créer un bnp pour le modèle de la peluche ===

Pour finir il faut copier le shape et la texture de la peluche dans le dossier "data" du client.
Cependant pour bien faire les choses, autant créer un fichier ".bnp" dédié.
Un fichier ".bnp" est une sorte de zip regroupant les différents fichiers shape, dds, txt, ou autres par thème.

Créer on dossier "soft-toy", copions y tous les shapes et textures de nos peluche, à savoir pour le moment "ge_acc_teddy-gubani_01.shape" et "ge_acc_teddy-gubani_01.dds" et créons un fichier BNP pour les contenur

bnp_make /p soft-toy

La commande va créer un fichier "soft-toy,bnp" qui contiendra nos deux fichiers. A présent il faut le copier dans le dossier "data" du client.

=== Tester IG ===

Relancer le serveur avec la commande ''shard start'' puis connectez vous avec votre client.

Si tout c'est bien déroulé, en lançant votre client de jeu, vous pouvez créer une peluche dans votre inventaire avec la commande :

/a createItemInBag teddygubani 1 5

=Sources=

https://khaganat.net/wikhan/fr:todo:dessiner:peluche



<references />

{{TPInWikiRyzom}}
[[Category:EN]]

EN Teddybear

2014-07-26T23:30:20Z

Madi: /* Étape 7 : Export du shape */

{{tabLang|EN|DE|EN Teddybear|ES|FR Peluche|RU}}

{{ToTrad}}



(Translation under progress - if you want to complete it, please update this line so that no one will edit it in the meantime)

The aim of this tutorial is to show how to create cuddly toys based on the models of atysian animals.

=Object of the month: creating and deploying cudlly toys "Atys' mobs" in game=

[[File:00-tuto-peluche.png|300px]]

Prerequisite for modelising only the cuddly toy:

* Having installed Ryzom assets and properly set-up the repositories (NEL tools expect to find the assets in the W:\database folder).
* Having installed 3DSMax and set-up the NEL plugin (Beware the plugin works only with versions 32bits of 3DSMax, and from version 9 till version 2012).
* Advised but not mandatory: having installed the NEL tool "''tga2dds.exe''".

Prerequisite for deploying the cuddly toy on a game server:

* Having compiled and installed a game server, and having set-up a client to use it.

Note: it is possible to test this cuddly toy IG without having a game server through a trick which will be explained a bit further in this tutorial.

Some usefeul linkds for these prerequisites:

* Downloading the assets and tools: https://ryzomcore.atlassian.net/wiki/display/RC/Downloads+for+Windows
* Set-up of the readers: https://ryzomcore.atlassian.net/wiki/display/RC/How+to+set+up+the+Build+Pipeline
* Insalling the NEL plugin of 3DSMax: https://ryzomcore.atlassian.net/wiki/display/RC/Installing+the+Max+Plugins

== Step 1: choosing the model we'll use for our cuddly toy ==

All 3d models for Ryzom fauna are gathered in the "W:\database\stuff\tryker\agents\monsters" folder, by creature family. In this tutorial, we'll use the "Gubani" model, which is located in the "horse" ("cheval" in French) folder, to create our cuddly toy:

W:\database\stuff\tryker\agents\monsters\cheval\h12tr_mo_h12.max

[[File:01-tuto-peluche-dossiers-mobs.png|600px]]

== Step 2: Getting the model and creating a dedicated work folder ==

In 3DSMax, open the "W:\database\stuff\tryker\agents\monsters\cheval\h12tr_mo_h12.max" file.

Use the menu => "File" => "Manage" => "Asset Tracking" to check the list of the files used in this model, especially the textures. Notice this two files:

* The 3d model: "tr_mo_h12.max"
* The texture for the gubani: "ju_mo_h12.png"

[[File:02-tuto-peluche-asset-tracking.png|800px]]

The aim here is to deploy cuddly monbs for the month object. Hence, we'll create a dedicated folder for our to-be toys and respect the naming convention used by Ryzom.

So we'll create a "soft-toy" folder, in the "W:\database\stuff\generique\agents\accessories" folder. We'll save our model by renaming it under: ge_acc_teddy-gubani_01.max

* the first "ge_" prefix in the file name specifies the ecosystem, here _ge_neric (tr: tryker, fy: fyros, etc...).
* the second prefix in the file name specifies the type of model (hom: male homin, mo: monster, wea: weapon, etc...). Here "acc" for _acc_essory.
* and last, the name of our model "teddy-gubani", which will be suffixed with a number, in order to be able to create several variants of the teddy-gubani.

For the texture, we should also copy it under "W:\database\stuff\generique\agents\_textures\accessories", but we'll do it more simply. We'll place it in the same folder as the 3d model and rename it according to the same convention: "ge_acc_teddy-gubani_01.png".

Ryzom core knwo only how to show textures with a ".tga" or ".dds" format. TGA is a raw format without compression which makes it useful for edition, but less efficient in term of memory space. DDS format is a compressed image format which, as jpeg, is destructive. It is the format used internally by Ryzom to minimize the textures' memory space. With your favorite editor, convert the ".png" image into a ".tga" one. That's the one we'll keep for edition. We'll use the NEL tool "'tga2dds'" to generate a texture image under ".dds" format for the 3d model. That's the one which well be used in 3DSMax.

tga2dds ge_acc_teddy-gubani_01.tga

If you don't have this tool, you gan keep the ".tga" version. It will work for the IG tests.
In the "soft-toy" folder, you should now have as a result:

[[File:03-tuto-peluche-dossier-soft-toy.png|600px]]

== Step 3: Cleaing the 3D model using 3DSMax ==
The monster 3D model contains a skeleton and animation tracks. This is not necessary for a toy accessory and unnecessarily overburden the final ryzom model. We will delete it.

[[File:04-tuto-peluche-animation.png|800px]]

Select with the mouse the "Gubani" model. In the right panel, select the "''modify''" tab. You should see the mesh called "TR_MO_H12" and in the stack one modifier called "physical". We will delete

[[File:05-tuto-peluche-physique.png|600px]]

Ensuite nous allons ouvrir l'écran affichant les éléments de la scene via le menu "Tools"=> "New Scene Explorer" et supprimer tous les éléments constituant le squelette du modèle pour ne garder au final que le mesh de l'animal.

Then we will open the scene explorer screen via the "Tools" menu => "New Scene Explorer" and delete all the elements constituting the skeleton of the model and keep only the animal mesh.

[[File:06-tuto-peluche-bones-01.png|800px]]

Now we have only one element in our "scene": the Gubani mesh "TR_MO_H12"

[[File:07-tuto-peluche-nettoyer-modele.png|800px]]

In the right panel, we will rename the mesh "ge_acc_tedy-gubani_01". This name will be used by the export "NEL" to name the generated file when exporting to "shape" NEL format.

[[File:07-tuto-peluche-nettoyer-modele-fin.png|800px]]

== Étape 4 : Map the right texture to the model ==

In this section, we will adapt the texturing of 3d model. In principle, we would just change the base texture "ju_mo_h12.png" to point to our "ge_acc_teddy-gubani_01.dds" texture (or the ". tga" one). However, this will be a bit more complicated:

First we open the "Material Editor" (1) screen, then we select the unique material of the scene (2) by double clicking on it. In the central viewport select the node named "Map # 1 Nel Multi Bitmap" by double clicking on it (3). In the right sidebar, a description of its properties (4) appear. The "Nel Multi Bitmap" allow to specify 8 different images. It is not multi-texturing, but the ability to configure multiple texture images. Only one is applied at a given moment on the model. This is used for the mobs to specify one texture for each ecosystem. This is also used by and environmental objects to specify a different texture for each season.

[[File:08-tuto-peluche-texture.png|800px]]

The ID 1 slot is used for textures of Tryker ecosystem, the second solt (ID 2) for the Fyros ecosystem Fyros. The third slot (ID 3) for Zoraï ecosystem and the fourth one (ID 4) for the Primes Root ecosystem. Do not look for Matis slot. As good aesthetes, they understood that beauty lay in the Zorai nature and therefore use Zoraï textures for all their animals. Note that here the Gubani is being ponly resent in jungle primes root. Only slots 3 and 4 are used

The same system is also used for other IG objects, such as buildings. In this case, the 4 slots correspond to the four seasons. Thus we can note the presence of snow on some Zoraï buildings in winter.

[[File:09-tuto-peluche-multi-texture.png]]

We will not use this mechanism. We will therefore deleted the "NEL Multi Bitmap" and replace it with a simple "Bitmap" by dragging the mouse from the output of "1 tTexture 1" as shown in the above image. When release the mouse, a menu appears (2), select "Bitmap" entry:

[[File:10-tuto-peluche-bitmap.png|800px]]

Then select our texture "W:\database\stuff\generic\agents\ _textures\accessories\ oft-toyge_acc_teddy gubani_01.dds" (or ".tga").

[[File:11-tuto-peluche-bitmap.png|800px]]

Repeat the operation on the other "Nel Multi Bitmap" which reference the same image.

== Étape 5 : Scaling the model ==

Our 3d model is almost ready. However, its size does not match what expected. If you use the 3dsmax measuring tool you will see that the Gubani is 2m high. The simplest way to put it in the right size is to load a Homin model to have visual comparison and ensure that the teddybear can be taken in hand.

So we will temporarily put in our scene a reference to another 3d model via the File menu (1) => References (2) => Xref Scene (3) and then clicking on the Add button (4) :

[[File:15-tuto-peluche-xref.png|800px]]

Select the Homin model "W:\database\stuff\generic\agents\actors\male\ge_hom_armor02.max" which should appear in your 3d scene.

[[File:15-tuto-peluche-xref-02.png]]

Scale the Gubani modeland move via tools "Scale" and "Move" from the popup menu that appears when you click the model with the right mouse button.

[[File:16-tuto-peluche-echelle.png]]

Once at the right scale, remove the reference to the homin model through the File menu => References => Xref Scene.

Reposition the Gubani model at the scene origin (x = 0, y = 0, z = 0), because when the object is carried the position (0,0,0) is located in the hand.

== Étape 6 : Adapt the texture for a fluffy look ==

In terms of texture, to give a "plush effect", give free rein to your imagination

[[File:17-tuto-peluche-texture-source.png]]

I edited the "ge_acc_teddy-gubani_01.tga" image with the Gimp application. I used the filter "Artistic> GIMPressionist" using the "canvas" model for a weft fabric effect.

[[File:17-tuto-peluche-texture-peluche.png]]

Once the image saved, I re-generated the dds texture with the command:

tga2dds ge_acc_teddy-gubani_01.tga

Here is the result on the 3d model in 3dsmax:

[[File:18-tuto-peluche-modele3d.png]]

== Step 7 : Shape export ==

It's time to test the teddybear IG. For this game you have to export the model to the "shape" file used by the Ryzom engine

If this is not already the case I add the ''NEL export'' button on your right side panel by clicking on the"utilities" tab thant "More" button and selecting the "NEL Export" option :

[[File:20-tuto-peluche-export-nel-01.png]]

Then select the Gubani mesh with the mouse and click on the "Export Model" button. You must specify the folder on wihc the file "ge_acc_teddy-Gubani-01.shape" will be created.

[[File:20-tuto-peluche-export-nel-02.png]]

== Étape 8 : Tester la peluche IG ==

Pour bien faire les choses, il faudrait ajouter le ''datasheet'' de la peluche au serveur de jeu et patcher le client. Cette méthode sera détaillée plus loin. Cependant il existe une solution de contournement si vous n'avez pas votre propre serveur de jeu pour réaliser ces opérations.

Il faut savoir qu'une peluche n'est rien d'autre qu'une arme équipée. Ainsi nous pourrions remplacer le modèle de la dague par celui de notre gubani pour le tester sur le serveur officiel. Il existe une astuce simple pour cela. Le client de jeu recherche les modèles et textures dans le dossier "user" avant d'aller voir le dossier "data". Il suffit de copier notre fichier shape et la texture associée dans le dossier "user", puis de renommer le shape du gubani en celui de la dague : "GE_Wea_Dague.shape"

A présent lorsque vous équiperez une dague IG, vous aurez en main notre peluche "gubani".
Pour retrouver la dague d'origine, il suffit de supprimer le fichier shape du dossier "user" :

[[File:21-gubani-peluche-axe.png|400px]]

En réalisant ce test vous pouvez noter une anomalie : la peluche est tenue par le pied, ce qui n'est pas forcément ce que nous voulons

== Étape 9 : orientation et positionnement d'un objet porté ==

Le point de fixation d'un objet tenu en main correspond au point de coordonnée (0,0,0) de l'objet.Son orientation suit la règle suivante :

l'axe X remonte le long de l'avant-bras ;
l'axe Y part depuis le dos de la main vers l'extérieur ;
l'axe Z pointe vers le haut de l'objet tenu fermement en main.

Nous réorientons la peluche gubani dans 3dsmax comme le montre l'image suivante : l'axe X sort du dos du gubani pour remonter le long du bras qui le portera. L'axe Z sort de la main et est donc dans le prolongement de la tête de la peluche :

[[File:22-gubani-peluche-axe-3dsmax.png]]

Après réorientation du modèle gubani et réexportation du shape nous obtenons enfin une peluche qui est tenue par le tronc :

[[File:22-gubani-peluche-axe.png|400px]]

Pour aller plus loin sur les objets portés, je vous conseille de lire ce tutorial : http://khaganat.net/wikhan/fr:todo:dessiner:creation_d_un_objet_prehensible_en_jeu

== Étape 9 : Créer l’icône pour l'inventaire et la barre d'actions ==

Il faut créer un icône pour l'affichage de l'item peluche gubani dans l'inventaire et dans la barre d'actions.
Cet au icône au format tga doit faire 40x40 pixels avec un fond transparent. Nous le nommerons "icon_teddygubani.tga"

L'icône de 40x40 pixels :

[[File:23-icone-gubani.png|80px]]

Pour des questions de performance, ces icônes ne sont pas stockés individuellement mais regroupés dans une seule image dénommée : "texture_interfaces_v3.tga". Le fichier texte associé dénommé "texture_interfaces_v3.txt" liste les icones présents et leur position dans l'image :

[[File:23-icone-gubani-contexte-txt.png]]

le fichier texte utilise le format suivant pour chaque ligne :

NomFichierIcone u1 v1 u2 v2

Avec :
* u1,v1 la position du point supérieur gauche de l'icône
* u2,v2 la position du coin inférieur droit de l'icône

A la différence des coordonnées en pixels, ces coordonnées qui utilisent la technique du UV Mapping en 3d ont leurs valeurs dans l’intervalle [0 .. 1]. la coordonnée (0,0) correspond au point supérieur gauche de l'image et (1,1) au point inférieur droit de l'image.

Le passage d'un système à l'autre est simple. Soit (x1,y1) la position en pixels du coin haut gauche de notre icône dans l'image globale et (x2,y2) la position du point inférieur droit de l'icône dans l'image, alors :
* u1 = x1 / largeur-image
* v1 = y1 / hauteur-image
* u2 = x2 / largeur-image
* v2 = y2 / hauteur-image

Sachant que la texture "texture_interfaces_v3.tga" fait 1024x1024 pixel, et que dans l'exemple l'icône "icon_teddygubani.tga" se situe à la position (x1=118,y1=798), que le point inférieur gauche étant à la position (x2=157,y2=837), le fichier txt contient donc la ligne :

icon_teddygubani.tga 0.115234375 0.779296875 0.1533203125 0.8173828125

Même si cela peut être ajouté à la main, la bonne méthode et d'utiliser l'outil dédié de NEL ''build_interface'' comme indiqué dans le tutorial https://khaganat.net/wikhan/fr:todo:dessiner:creer_icone_objet qui recrée la texture globale et le fichier txt à partir d'un dossier contenant tous les icones.

Note: L'ajout de l'icône ne suffit pas, il faut également créer le datasheet de l'objet peluche et spécifier dedans le nom de notre icône à utiliser comme nous le verrons plus loin dans ce tutorial. Au final nous obtenons le résultat suivant IG :

[[File:23-icone-gubani-contexte.png]]

== Etape 11 : créer le fichiers des noms ==

A compléter.

[[File:30-tuto-peluche-txtfile.png]]

== Étape 12 : créer le datasheet ==

A la base, une peluche reste est un objet porté comme une arme. De fait le datasheet de la peluche est trs semblable à celui d'une arme une main, comme l'exemple de la dague ci-dessous.

__icrm1pd.sitem ( datasheet de la dague du réfugié ) :__

<pre>
<?xml version="1.0"?>
<FORM Revision="$Revision: 1.2 $" State="modified">
<PARENT Filename="_c_m1pd.sitem"/>
<STRUCT>
<STRUCT Name="basics">
<ATOM Name="name" Value="refugee dagger"/>
<ATOM Name="origin" Value="refugee"/>
<ATOM Name="Drop or Sell" Value="false"/>
<ATOM Name="CraftPlan" Value="bcrmea06.sbrick"/>
<ATOM Name="Saleable" Value="false"/>
</STRUCT>
<STRUCT Name="3d">
<ATOM Name="shape" Value="GE_Wea_Dague.shape"/>
<ATOM Name="shape_female" Value="GE_Wea_Dague.shape"/>
<ATOM Name="map_variant" Value="Low Quality"/>
<ATOM Name="icon background" Value="BK_generic.tga"/>
<STRUCT Name="fx">
<ATOM Name="Trail" Value="GE_Wea_Dague_trail_00.shape"/>
</STRUCT>
</STRUCT>
</STRUCT>
<STRUCT/>
<STRUCT/>
<STRUCT/>
<STRUCT/>
<LOG>
</FORM>
</pre>

Ce qui change c'est :

* la référénce au shape dans la section "3d"

<ATOM Name="shape" Value="ge_acc_teddy-gubani_01.shape"/>
<ATOM Name="shape_female" Value="ge_acc_teddy-gubani_01.shape"/>

* la référence à l'icone utilisé dans la barre d'état et l'inventaire dans la section "3d"

<ATOM Name="icon" Value="icon_teddygubani.tga"/>
<ATOM Name="icon overlay" Value="icon_teddygubani.tga"/>

* les caractéristiques de base qui diffèrent d'une arme : pas de niveau requis, pas de brique de plan, etc..

<STRUCT Name="basics">
<ATOM Name="name" Value="staff"/>
<ATOM Name="origin" Value="common"/>
<ATOM Name="family" Value="handled item"/>
<ATOM Name="ItemType" Value="Staff"/>
<ATOM Name="Bulk" Value="5"/>
<ATOM Name="RequiredCharacQualityFactor" Value="0"/>
<ATOM Name="RequiredCharacQualityOffset" Value="0"/>
</STRUCT>

Voila donc le datasheet de la peluche gubani que nous nommerons "teddygubani.sitem" :

<pre>
<?xml version="1.0"?>
<FORM Revision="$Revision: 1.7 $" State="modified">
<PARENT Filename="_c_m1pd.sitem"/>
<STRUCT>
<STRUCT Name="basics">
<ATOM Name="name" Value="staff"/>
<ATOM Name="origin" Value="common"/>
<ATOM Name="family" Value="handled item"/>
<ATOM Name="ItemType" Value="Staff"/>
<ATOM Name="Bulk" Value="5"/>
<ATOM Name="RequiredCharacQualityFactor" Value="0"/>
<ATOM Name="RequiredCharacQualityOffset" Value="0"/>
</STRUCT>
<STRUCT Name="3d">
<ATOM Name="shape" Value="ge_acc_teddy-gubani_01.shape"/>
<ATOM Name="shape_female" Value="ge_acc_teddy-gubani_01.shape"/>
<ATOM Name="map_variant" Value="Low Quality"/>
<ATOM Name="icon" Value="icon_teddygubani.tga"/>
<ATOM Name="icon background" Value="BK_generic.tga"/>
<ATOM Name="icon overlay" Value="icon_teddygubani.tga"/>
<STRUCT Name="fx">
<ATOM Name="Trail" Value="GE_Wea_Dague_trail_00.shape"/>
</STRUCT>
</STRUCT>
</STRUCT>
<STRUCT/>
<STRUCT/>
<STRUCT/>
<STRUCT/>
<LOG></LOG>
</FORM>
</pre>

== Étape 13 : Déployer la peluche sur le serveur et le client de jeu ==

Afin de déployer la peluche en jeu la méthode officielle consiste à utiliser la pipeline "build_gamedata" (cf. https:''ryzomcore.atlassian.net/wiki/display/RC/Gamedata+Build+Pipeline). Je vais vous proposer une méthode différente, où les opérations seront effectués à la mains, mais uniquement celles nécessaires à notre peluche :

Nous avons besoin des fichiers suivants :

* teddygubani.sitem ( le datasheet de la peluche gunabi )
* ge_acc_teddy-gubani_01.shape ( le modèle 3d NEL de la peluche )
* ge_acc_teddy-gubani_01.dds ( la texture du modèle 3d )

De plus le déploiement de cette peluche va impacter les fichiers suivants :

* les fichiers "*.packed_sheets" utilisée par le serveur et le client qui sont une version compilé des datasheets
* le fichier "sheet_id.bin" qui est un index de tous les datasheets utilisés par le jeu
* le fichier "visual_slot.tab" qui liste les éléments affichables coté client

Pour bien faire les choses, nous allons également créer un fichier "soft-toy.bnp" qui contiendra les shapes et les textures de toutes les futures peluches.

Pour la suite des opérations nous partons du principe que notre serveur de jeu fonctionne sous linux, et que les variables d'envrionnement suivantes sont définies :

* LEVELDESIGNPATH pointe sur le dossier des datas du level design
* RYZOM_HOME sur l'installation des sources du serveur

=== Ajout du datasheet "teddygubani.sitem" au serveur ===

Coté serveur nous allons créer un dossier dédié pour les datasheets des peluches et y placer celui du gubani :

$ mkdir $LEVELDESIGNPATH/leveldesign/game_element/sitem/soft-toy
$ cp teddygubani.sitem $LEVELDESIGNPATH/leveldesign/game_element/sitem/soft-toy

=== Nettoyages préalables ===

=== Re-générer le fichier "sheet_id.bin" ===

La première étape consiste à regénérer le fichier d'index des datasheet via la commande "make_sheet_id". Il reprend le fichier d'index existant et va le compléter avec les datasheets du dossier $RYZOM_LEVELPATH/leveldesign/game_element/sitem/soft-toy c'est-à-dire les datasheets de nos peluches

$ make_sheet_id -o$LEVELDESIGNPATH/leveldesign/Game_elem/sheet_id.bin $LEVELDESIGNPATH/leveldesign/game_element/sitem/soft-toy

=== Re-générer les "*.packed_sheets" et "visual_slot.tab" ===

Il faut regénérer les "*.packed_sheets".Ce sont les versions pré-compilées des datasheets :

$ sheets_packer

Cette commande va également re-générer le fichier visual_slot.tab

=== Copier les fichiers nécessaires coté client ===

* Nous copions le fichier "visual_slot.tab" généré dans le dossier courant dans le dossier "user" du client de jeu
* Nous copions le fichier $LEVELDESIGNPATH/leveldesign/Game_elem/sheet_id.bin dans le dossier "user" du client de jeu
* Nous remplaçons les fichiers packet_sheets du dossier "data" du client par ceux générés ici $RYZOM_HOME/code/ryzom/client/data/*.packed_sheets par la commande ''sheets_packer''

=== Créer un bnp pour le modèle de la peluche ===

Pour finir il faut copier le shape et la texture de la peluche dans le dossier "data" du client.
Cependant pour bien faire les choses, autant créer un fichier ".bnp" dédié.
Un fichier ".bnp" est une sorte de zip regroupant les différents fichiers shape, dds, txt, ou autres par thème.

Créer on dossier "soft-toy", copions y tous les shapes et textures de nos peluche, à savoir pour le moment "ge_acc_teddy-gubani_01.shape" et "ge_acc_teddy-gubani_01.dds" et créons un fichier BNP pour les contenur

bnp_make /p soft-toy

La commande va créer un fichier "soft-toy,bnp" qui contiendra nos deux fichiers. A présent il faut le copier dans le dossier "data" du client.

=== Tester IG ===

Relancer le serveur avec la commande ''shard start'' puis connectez vous avec votre client.

Si tout c'est bien déroulé, en lançant votre client de jeu, vous pouvez créer une peluche dans votre inventaire avec la commande :

/a createItemInBag teddygubani 1 5

=Sources=

https://khaganat.net/wikhan/fr:todo:dessiner:peluche



<references />

{{TPInWikiRyzom}}
[[Category:EN]]

EN Teddybear

2014-07-26T23:22:37Z

Madi: /* Sources */

{{tabLang|EN|DE|EN Teddybear|ES|FR Peluche|RU}}

{{ToTrad}}



(Translation under progress - if you want to complete it, please update this line so that no one will edit it in the meantime)

The aim of this tutorial is to show how to create cuddly toys based on the models of atysian animals.

=Object of the month: creating and deploying cudlly toys "Atys' mobs" in game=

[[File:00-tuto-peluche.png|300px]]

Prerequisite for modelising only the cuddly toy:

* Having installed Ryzom assets and properly set-up the repositories (NEL tools expect to find the assets in the W:\database folder).
* Having installed 3DSMax and set-up the NEL plugin (Beware the plugin works only with versions 32bits of 3DSMax, and from version 9 till version 2012).
* Advised but not mandatory: having installed the NEL tool "''tga2dds.exe''".

Prerequisite for deploying the cuddly toy on a game server:

* Having compiled and installed a game server, and having set-up a client to use it.

Note: it is possible to test this cuddly toy IG without having a game server through a trick which will be explained a bit further in this tutorial.

Some usefeul linkds for these prerequisites:

* Downloading the assets and tools: https://ryzomcore.atlassian.net/wiki/display/RC/Downloads+for+Windows
* Set-up of the readers: https://ryzomcore.atlassian.net/wiki/display/RC/How+to+set+up+the+Build+Pipeline
* Insalling the NEL plugin of 3DSMax: https://ryzomcore.atlassian.net/wiki/display/RC/Installing+the+Max+Plugins

== Step 1: choosing the model we'll use for our cuddly toy ==

All 3d models for Ryzom fauna are gathered in the "W:\database\stuff\tryker\agents\monsters" folder, by creature family. In this tutorial, we'll use the "Gubani" model, which is located in the "horse" ("cheval" in French) folder, to create our cuddly toy:

W:\database\stuff\tryker\agents\monsters\cheval\h12tr_mo_h12.max

[[File:01-tuto-peluche-dossiers-mobs.png|600px]]

== Step 2: Getting the model and creating a dedicated work folder ==

In 3DSMax, open the "W:\database\stuff\tryker\agents\monsters\cheval\h12tr_mo_h12.max" file.

Use the menu => "File" => "Manage" => "Asset Tracking" to check the list of the files used in this model, especially the textures. Notice this two files:

* The 3d model: "tr_mo_h12.max"
* The texture for the gubani: "ju_mo_h12.png"

[[File:02-tuto-peluche-asset-tracking.png|800px]]

The aim here is to deploy cuddly monbs for the month object. Hence, we'll create a dedicated folder for our to-be toys and respect the naming convention used by Ryzom.

So we'll create a "soft-toy" folder, in the "W:\database\stuff\generique\agents\accessories" folder. We'll save our model by renaming it under: ge_acc_teddy-gubani_01.max

* the first "ge_" prefix in the file name specifies the ecosystem, here _ge_neric (tr: tryker, fy: fyros, etc...).
* the second prefix in the file name specifies the type of model (hom: male homin, mo: monster, wea: weapon, etc...). Here "acc" for _acc_essory.
* and last, the name of our model "teddy-gubani", which will be suffixed with a number, in order to be able to create several variants of the teddy-gubani.

For the texture, we should also copy it under "W:\database\stuff\generique\agents\_textures\accessories", but we'll do it more simply. We'll place it in the same folder as the 3d model and rename it according to the same convention: "ge_acc_teddy-gubani_01.png".

Ryzom core knwo only how to show textures with a ".tga" or ".dds" format. TGA is a raw format without compression which makes it useful for edition, but less efficient in term of memory space. DDS format is a compressed image format which, as jpeg, is destructive. It is the format used internally by Ryzom to minimize the textures' memory space. With your favorite editor, convert the ".png" image into a ".tga" one. That's the one we'll keep for edition. We'll use the NEL tool "'tga2dds'" to generate a texture image under ".dds" format for the 3d model. That's the one which well be used in 3DSMax.

tga2dds ge_acc_teddy-gubani_01.tga

If you don't have this tool, you gan keep the ".tga" version. It will work for the IG tests.
In the "soft-toy" folder, you should now have as a result:

[[File:03-tuto-peluche-dossier-soft-toy.png|600px]]

== Step 3: Cleaing the 3D model using 3DSMax ==
The monster 3D model contains a skeleton and animation tracks. This is not necessary for a toy accessory and unnecessarily overburden the final ryzom model. We will delete it.

[[File:04-tuto-peluche-animation.png|800px]]

Select with the mouse the "Gubani" model. In the right panel, select the "''modify''" tab. You should see the mesh called "TR_MO_H12" and in the stack one modifier called "physical". We will delete

[[File:05-tuto-peluche-physique.png|600px]]

Ensuite nous allons ouvrir l'écran affichant les éléments de la scene via le menu "Tools"=> "New Scene Explorer" et supprimer tous les éléments constituant le squelette du modèle pour ne garder au final que le mesh de l'animal.

Then we will open the scene explorer screen via the "Tools" menu => "New Scene Explorer" and delete all the elements constituting the skeleton of the model and keep only the animal mesh.

[[File:06-tuto-peluche-bones-01.png|800px]]

Now we have only one element in our "scene": the Gubani mesh "TR_MO_H12"

[[File:07-tuto-peluche-nettoyer-modele.png|800px]]

In the right panel, we will rename the mesh "ge_acc_tedy-gubani_01". This name will be used by the export "NEL" to name the generated file when exporting to "shape" NEL format.

[[File:07-tuto-peluche-nettoyer-modele-fin.png|800px]]

== Étape 4 : Map the right texture to the model ==

In this section, we will adapt the texturing of 3d model. In principle, we would just change the base texture "ju_mo_h12.png" to point to our "ge_acc_teddy-gubani_01.dds" texture (or the ". tga" one). However, this will be a bit more complicated:

First we open the "Material Editor" (1) screen, then we select the unique material of the scene (2) by double clicking on it. In the central viewport select the node named "Map # 1 Nel Multi Bitmap" by double clicking on it (3). In the right sidebar, a description of its properties (4) appear. The "Nel Multi Bitmap" allow to specify 8 different images. It is not multi-texturing, but the ability to configure multiple texture images. Only one is applied at a given moment on the model. This is used for the mobs to specify one texture for each ecosystem. This is also used by and environmental objects to specify a different texture for each season.

[[File:08-tuto-peluche-texture.png|800px]]

The ID 1 slot is used for textures of Tryker ecosystem, the second solt (ID 2) for the Fyros ecosystem Fyros. The third slot (ID 3) for Zoraï ecosystem and the fourth one (ID 4) for the Primes Root ecosystem. Do not look for Matis slot. As good aesthetes, they understood that beauty lay in the Zorai nature and therefore use Zoraï textures for all their animals. Note that here the Gubani is being ponly resent in jungle primes root. Only slots 3 and 4 are used

The same system is also used for other IG objects, such as buildings. In this case, the 4 slots correspond to the four seasons. Thus we can note the presence of snow on some Zoraï buildings in winter.

[[File:09-tuto-peluche-multi-texture.png]]

We will not use this mechanism. We will therefore deleted the "NEL Multi Bitmap" and replace it with a simple "Bitmap" by dragging the mouse from the output of "1 tTexture 1" as shown in the above image. When release the mouse, a menu appears (2), select "Bitmap" entry:

[[File:10-tuto-peluche-bitmap.png|800px]]

Then select our texture "W:\database\stuff\generic\agents\ _textures\accessories\ oft-toyge_acc_teddy gubani_01.dds" (or ".tga").

[[File:11-tuto-peluche-bitmap.png|800px]]

Repeat the operation on the other "Nel Multi Bitmap" which reference the same image.

== Étape 5 : Scaling the model ==

Our 3d model is almost ready. However, its size does not match what expected. If you use the 3dsmax measuring tool you will see that the Gubani is 2m high. The simplest way to put it in the right size is to load a Homin model to have visual comparison and ensure that the teddybear can be taken in hand.

So we will temporarily put in our scene a reference to another 3d model via the File menu (1) => References (2) => Xref Scene (3) and then clicking on the Add button (4) :

[[File:15-tuto-peluche-xref.png|800px]]

Select the Homin model "W:\database\stuff\generic\agents\actors\male\ge_hom_armor02.max" which should appear in your 3d scene.

[[File:15-tuto-peluche-xref-02.png]]

Scale the Gubani modeland move via tools "Scale" and "Move" from the popup menu that appears when you click the model with the right mouse button.

[[File:16-tuto-peluche-echelle.png]]

Once at the right scale, remove the reference to the homin model through the File menu => References => Xref Scene.

Reposition the Gubani model at the scene origin (x = 0, y = 0, z = 0), because when the object is carried the position (0,0,0) is located in the hand.

== Étape 6 : Adapt the texture for a fluffy look ==

In terms of texture, to give a "plush effect", give free rein to your imagination

[[File:17-tuto-peluche-texture-source.png]]

I edited the "ge_acc_teddy-gubani_01.tga" image with the Gimp application. I used the filter "Artistic> GIMPressionist" using the "canvas" model for a weft fabric effect.

[[File:17-tuto-peluche-texture-peluche.png]]

Once the image saved, I re-generated the dds texture with the command:

tga2dds ge_acc_teddy-gubani_01.tga

Here is the result on the 3d model in 3dsmax:

[[File:18-tuto-peluche-modele3d.png]]

== Étape 7 : Export du shape ==

Il est temps de tester cette peluche en jeu. Pour cela il va falloir exporter le modèle en générant le fichier "shape" utilisé par le moteur Ryzom

Si ce n'est pas déjà je cas, ajouter le bouton ''d'export NEL'' au panneau latéral droit en cliquant sur l'onglet "''utilities''", puis "''More''" et en sélectionnant l'option "''NEL Export''" :

[[File:20-tuto-peluche-export-nel-01.png]]

Ensuite sélectionner le mesh du gubani puis cliquer sur le bouton "Export Model". Il vous faut alors spécifier le dossier où sera crée le fichier "ge_acc_teddy-gubani-01.shape"

[[File:20-tuto-peluche-export-nel-02.png]]

== Étape 8 : Tester la peluche IG ==

Pour bien faire les choses, il faudrait ajouter le ''datasheet'' de la peluche au serveur de jeu et patcher le client. Cette méthode sera détaillée plus loin. Cependant il existe une solution de contournement si vous n'avez pas votre propre serveur de jeu pour réaliser ces opérations.

Il faut savoir qu'une peluche n'est rien d'autre qu'une arme équipée. Ainsi nous pourrions remplacer le modèle de la dague par celui de notre gubani pour le tester sur le serveur officiel. Il existe une astuce simple pour cela. Le client de jeu recherche les modèles et textures dans le dossier "user" avant d'aller voir le dossier "data". Il suffit de copier notre fichier shape et la texture associée dans le dossier "user", puis de renommer le shape du gubani en celui de la dague : "GE_Wea_Dague.shape"

A présent lorsque vous équiperez une dague IG, vous aurez en main notre peluche "gubani".
Pour retrouver la dague d'origine, il suffit de supprimer le fichier shape du dossier "user" :

[[File:21-gubani-peluche-axe.png|400px]]

En réalisant ce test vous pouvez noter une anomalie : la peluche est tenue par le pied, ce qui n'est pas forcément ce que nous voulons

== Étape 9 : orientation et positionnement d'un objet porté ==

Le point de fixation d'un objet tenu en main correspond au point de coordonnée (0,0,0) de l'objet.Son orientation suit la règle suivante :

l'axe X remonte le long de l'avant-bras ;
l'axe Y part depuis le dos de la main vers l'extérieur ;
l'axe Z pointe vers le haut de l'objet tenu fermement en main.

Nous réorientons la peluche gubani dans 3dsmax comme le montre l'image suivante : l'axe X sort du dos du gubani pour remonter le long du bras qui le portera. L'axe Z sort de la main et est donc dans le prolongement de la tête de la peluche :

[[File:22-gubani-peluche-axe-3dsmax.png]]

Après réorientation du modèle gubani et réexportation du shape nous obtenons enfin une peluche qui est tenue par le tronc :

[[File:22-gubani-peluche-axe.png|400px]]

Pour aller plus loin sur les objets portés, je vous conseille de lire ce tutorial : http://khaganat.net/wikhan/fr:todo:dessiner:creation_d_un_objet_prehensible_en_jeu

== Étape 9 : Créer l’icône pour l'inventaire et la barre d'actions ==

Il faut créer un icône pour l'affichage de l'item peluche gubani dans l'inventaire et dans la barre d'actions.
Cet au icône au format tga doit faire 40x40 pixels avec un fond transparent. Nous le nommerons "icon_teddygubani.tga"

L'icône de 40x40 pixels :

[[File:23-icone-gubani.png|80px]]

Pour des questions de performance, ces icônes ne sont pas stockés individuellement mais regroupés dans une seule image dénommée : "texture_interfaces_v3.tga". Le fichier texte associé dénommé "texture_interfaces_v3.txt" liste les icones présents et leur position dans l'image :

[[File:23-icone-gubani-contexte-txt.png]]

le fichier texte utilise le format suivant pour chaque ligne :

NomFichierIcone u1 v1 u2 v2

Avec :
* u1,v1 la position du point supérieur gauche de l'icône
* u2,v2 la position du coin inférieur droit de l'icône

A la différence des coordonnées en pixels, ces coordonnées qui utilisent la technique du UV Mapping en 3d ont leurs valeurs dans l’intervalle [0 .. 1]. la coordonnée (0,0) correspond au point supérieur gauche de l'image et (1,1) au point inférieur droit de l'image.

Le passage d'un système à l'autre est simple. Soit (x1,y1) la position en pixels du coin haut gauche de notre icône dans l'image globale et (x2,y2) la position du point inférieur droit de l'icône dans l'image, alors :
* u1 = x1 / largeur-image
* v1 = y1 / hauteur-image
* u2 = x2 / largeur-image
* v2 = y2 / hauteur-image

Sachant que la texture "texture_interfaces_v3.tga" fait 1024x1024 pixel, et que dans l'exemple l'icône "icon_teddygubani.tga" se situe à la position (x1=118,y1=798), que le point inférieur gauche étant à la position (x2=157,y2=837), le fichier txt contient donc la ligne :

icon_teddygubani.tga 0.115234375 0.779296875 0.1533203125 0.8173828125

Même si cela peut être ajouté à la main, la bonne méthode et d'utiliser l'outil dédié de NEL ''build_interface'' comme indiqué dans le tutorial https://khaganat.net/wikhan/fr:todo:dessiner:creer_icone_objet qui recrée la texture globale et le fichier txt à partir d'un dossier contenant tous les icones.

Note: L'ajout de l'icône ne suffit pas, il faut également créer le datasheet de l'objet peluche et spécifier dedans le nom de notre icône à utiliser comme nous le verrons plus loin dans ce tutorial. Au final nous obtenons le résultat suivant IG :

[[File:23-icone-gubani-contexte.png]]

== Etape 11 : créer le fichiers des noms ==

A compléter.

[[File:30-tuto-peluche-txtfile.png]]

== Étape 12 : créer le datasheet ==

A la base, une peluche reste est un objet porté comme une arme. De fait le datasheet de la peluche est trs semblable à celui d'une arme une main, comme l'exemple de la dague ci-dessous.

__icrm1pd.sitem ( datasheet de la dague du réfugié ) :__

<pre>
<?xml version="1.0"?>
<FORM Revision="$Revision: 1.2 $" State="modified">
<PARENT Filename="_c_m1pd.sitem"/>
<STRUCT>
<STRUCT Name="basics">
<ATOM Name="name" Value="refugee dagger"/>
<ATOM Name="origin" Value="refugee"/>
<ATOM Name="Drop or Sell" Value="false"/>
<ATOM Name="CraftPlan" Value="bcrmea06.sbrick"/>
<ATOM Name="Saleable" Value="false"/>
</STRUCT>
<STRUCT Name="3d">
<ATOM Name="shape" Value="GE_Wea_Dague.shape"/>
<ATOM Name="shape_female" Value="GE_Wea_Dague.shape"/>
<ATOM Name="map_variant" Value="Low Quality"/>
<ATOM Name="icon background" Value="BK_generic.tga"/>
<STRUCT Name="fx">
<ATOM Name="Trail" Value="GE_Wea_Dague_trail_00.shape"/>
</STRUCT>
</STRUCT>
</STRUCT>
<STRUCT/>
<STRUCT/>
<STRUCT/>
<STRUCT/>
<LOG>
</FORM>
</pre>

Ce qui change c'est :

* la référénce au shape dans la section "3d"

<ATOM Name="shape" Value="ge_acc_teddy-gubani_01.shape"/>
<ATOM Name="shape_female" Value="ge_acc_teddy-gubani_01.shape"/>

* la référence à l'icone utilisé dans la barre d'état et l'inventaire dans la section "3d"

<ATOM Name="icon" Value="icon_teddygubani.tga"/>
<ATOM Name="icon overlay" Value="icon_teddygubani.tga"/>

* les caractéristiques de base qui diffèrent d'une arme : pas de niveau requis, pas de brique de plan, etc..

<STRUCT Name="basics">
<ATOM Name="name" Value="staff"/>
<ATOM Name="origin" Value="common"/>
<ATOM Name="family" Value="handled item"/>
<ATOM Name="ItemType" Value="Staff"/>
<ATOM Name="Bulk" Value="5"/>
<ATOM Name="RequiredCharacQualityFactor" Value="0"/>
<ATOM Name="RequiredCharacQualityOffset" Value="0"/>
</STRUCT>

Voila donc le datasheet de la peluche gubani que nous nommerons "teddygubani.sitem" :

<pre>
<?xml version="1.0"?>
<FORM Revision="$Revision: 1.7 $" State="modified">
<PARENT Filename="_c_m1pd.sitem"/>
<STRUCT>
<STRUCT Name="basics">
<ATOM Name="name" Value="staff"/>
<ATOM Name="origin" Value="common"/>
<ATOM Name="family" Value="handled item"/>
<ATOM Name="ItemType" Value="Staff"/>
<ATOM Name="Bulk" Value="5"/>
<ATOM Name="RequiredCharacQualityFactor" Value="0"/>
<ATOM Name="RequiredCharacQualityOffset" Value="0"/>
</STRUCT>
<STRUCT Name="3d">
<ATOM Name="shape" Value="ge_acc_teddy-gubani_01.shape"/>
<ATOM Name="shape_female" Value="ge_acc_teddy-gubani_01.shape"/>
<ATOM Name="map_variant" Value="Low Quality"/>
<ATOM Name="icon" Value="icon_teddygubani.tga"/>
<ATOM Name="icon background" Value="BK_generic.tga"/>
<ATOM Name="icon overlay" Value="icon_teddygubani.tga"/>
<STRUCT Name="fx">
<ATOM Name="Trail" Value="GE_Wea_Dague_trail_00.shape"/>
</STRUCT>
</STRUCT>
</STRUCT>
<STRUCT/>
<STRUCT/>
<STRUCT/>
<STRUCT/>
<LOG></LOG>
</FORM>
</pre>

== Étape 13 : Déployer la peluche sur le serveur et le client de jeu ==

Afin de déployer la peluche en jeu la méthode officielle consiste à utiliser la pipeline "build_gamedata" (cf. https:''ryzomcore.atlassian.net/wiki/display/RC/Gamedata+Build+Pipeline). Je vais vous proposer une méthode différente, où les opérations seront effectués à la mains, mais uniquement celles nécessaires à notre peluche :

Nous avons besoin des fichiers suivants :

* teddygubani.sitem ( le datasheet de la peluche gunabi )
* ge_acc_teddy-gubani_01.shape ( le modèle 3d NEL de la peluche )
* ge_acc_teddy-gubani_01.dds ( la texture du modèle 3d )

De plus le déploiement de cette peluche va impacter les fichiers suivants :

* les fichiers "*.packed_sheets" utilisée par le serveur et le client qui sont une version compilé des datasheets
* le fichier "sheet_id.bin" qui est un index de tous les datasheets utilisés par le jeu
* le fichier "visual_slot.tab" qui liste les éléments affichables coté client

Pour bien faire les choses, nous allons également créer un fichier "soft-toy.bnp" qui contiendra les shapes et les textures de toutes les futures peluches.

Pour la suite des opérations nous partons du principe que notre serveur de jeu fonctionne sous linux, et que les variables d'envrionnement suivantes sont définies :

* LEVELDESIGNPATH pointe sur le dossier des datas du level design
* RYZOM_HOME sur l'installation des sources du serveur

=== Ajout du datasheet "teddygubani.sitem" au serveur ===

Coté serveur nous allons créer un dossier dédié pour les datasheets des peluches et y placer celui du gubani :

$ mkdir $LEVELDESIGNPATH/leveldesign/game_element/sitem/soft-toy
$ cp teddygubani.sitem $LEVELDESIGNPATH/leveldesign/game_element/sitem/soft-toy

=== Nettoyages préalables ===

=== Re-générer le fichier "sheet_id.bin" ===

La première étape consiste à regénérer le fichier d'index des datasheet via la commande "make_sheet_id". Il reprend le fichier d'index existant et va le compléter avec les datasheets du dossier $RYZOM_LEVELPATH/leveldesign/game_element/sitem/soft-toy c'est-à-dire les datasheets de nos peluches

$ make_sheet_id -o$LEVELDESIGNPATH/leveldesign/Game_elem/sheet_id.bin $LEVELDESIGNPATH/leveldesign/game_element/sitem/soft-toy

=== Re-générer les "*.packed_sheets" et "visual_slot.tab" ===

Il faut regénérer les "*.packed_sheets".Ce sont les versions pré-compilées des datasheets :

$ sheets_packer

Cette commande va également re-générer le fichier visual_slot.tab

=== Copier les fichiers nécessaires coté client ===

* Nous copions le fichier "visual_slot.tab" généré dans le dossier courant dans le dossier "user" du client de jeu
* Nous copions le fichier $LEVELDESIGNPATH/leveldesign/Game_elem/sheet_id.bin dans le dossier "user" du client de jeu
* Nous remplaçons les fichiers packet_sheets du dossier "data" du client par ceux générés ici $RYZOM_HOME/code/ryzom/client/data/*.packed_sheets par la commande ''sheets_packer''

=== Créer un bnp pour le modèle de la peluche ===

Pour finir il faut copier le shape et la texture de la peluche dans le dossier "data" du client.
Cependant pour bien faire les choses, autant créer un fichier ".bnp" dédié.
Un fichier ".bnp" est une sorte de zip regroupant les différents fichiers shape, dds, txt, ou autres par thème.

Créer on dossier "soft-toy", copions y tous les shapes et textures de nos peluche, à savoir pour le moment "ge_acc_teddy-gubani_01.shape" et "ge_acc_teddy-gubani_01.dds" et créons un fichier BNP pour les contenur

bnp_make /p soft-toy

La commande va créer un fichier "soft-toy,bnp" qui contiendra nos deux fichiers. A présent il faut le copier dans le dossier "data" du client.

=== Tester IG ===

Relancer le serveur avec la commande ''shard start'' puis connectez vous avec votre client.

Si tout c'est bien déroulé, en lançant votre client de jeu, vous pouvez créer une peluche dans votre inventaire avec la commande :

/a createItemInBag teddygubani 1 5

=Sources=

https://khaganat.net/wikhan/fr:todo:dessiner:peluche



<references />

{{TPInWikiRyzom}}
[[Category:EN]]

EN Teddybear

2014-07-26T23:21:25Z

Madi: /* Sources */

EN Teddybear

2014-07-26T22:57:17Z

Madi: /* Étape 4 : Modifier le mapping des textures du modèle */

EN Teddybear

2014-07-26T22:55:50Z

Madi: /* Étape 6 : modifier la texture pour un rendu peluche */

EN Teddybear

2014-07-26T22:31:02Z

Madi: /* Sources */

EN Teddybear

2014-07-26T21:58:30Z

Madi: /* Sources */

EN Teddybear

2014-07-26T20:44:27Z

Madi: /* Sources */

EN Teddybear

2014-07-26T20:05:31Z

Madi: /* Step 3: Cleaing the 3D model using 3DSMax */

EN Teddybear

2014-07-26T19:35:33Z

Madi: /* Step 2: Getting the model and creating a dedicated work folder */

FR Peluche

2014-07-25T22:19:46Z

Madi: /* Objets du mois : Déployer en Jeu des peluches « mobs d'atys » */

{{TabLang|FR|DE|EN|ES|{{FULLPAGENAME}}|RU}}

{{ToTrad}}



{{Banner|fed|Cette Page est préformatée|Il ne vous reste qu'à écrire votre texte entre les deux lignes suivantes visibles en mode édition:

<nowiki></nowiki>
<br/>et <br/>
<nowiki></nowiki>

Vous pouvez effacer le contenu qui s'y trouve déjà en guise de guide.
}}

Un brève introduction de votre page '''{{FULLPAGENAME}}''' avant le premier titre qui se fait toujours avec 2 "'''='''" devant et derrière, comme ici. L'index des matières apparaît tout seul dès qu'il y a trois titres.
==Premier titre==
==Références==
===Voir aussi===
===Remarques===
===Sources===
===Notes===



<references />

{{TPInWikiRyzom}}
[[Category:FR]]

= Objets du mois : Déployer en Jeu des peluches « mobs d'atys » =

( Source : https://khaganat.net/wikhan/fr:todo:dessiner:peluche )

[[File:00-tuto-peluche.png|300px]]

Le but de ce tutorial est de montrer comment réaliser des peluches basées sur les modèles des animaux atysiens.

Pré-requis pour modéliser uniquement la peluche :

* Avoir installé les assets ryzom et configuré correctement les lecteurs (les outils NEL s'attendent à trouver les données des assets dans le dossier ( W:\database ).
* Avoir installé 3DSMax et configuré le plugin NEL ( Attention le plugin ne fonctionne qu'avec les version 32bits de 3DSmax et de la versions 9 à la version 2012).
* Conseillé mais non nécessaire : avoir installé l'outil NEL "''tga2dds.exe''".

Pré-requis pour déployer la peluche sur un serveur de jeu :

* Avoir compilé et installé un serveur de jeu et configuré un client pour l'utiliser

Note : il est possible de tester cette peluche IG sans disposer d'un serveur de jeu via une astuce qui sera expliquée plus loin dans ce tutoriel.

Quelques liens utiles pour ces pré-requis :

* Liens de téléchargement des assets et outils : https://ryzomcore.atlassian.net/wiki/display/RC/Downloads+for+Windows
* Configuration des lecteurs : https://ryzomcore.atlassian.net/wiki/display/RC/How+to+set+up+the+Build+Pipeline
* Installation du plugin NEL de 3dsmax : https://ryzomcore.atlassian.net/wiki/display/RC/Installing+the+Max+Plugins

== Étape 1: choisir le modèle qui servira pour notre peluche ==

L'ensemble des modèles 3d de la faune de ryzom sont regroupés dans le dossier « W:\database\stuff\tryker\agents\monsters » par famille de créature. Dans ce tutorial nous allons utiliser le modèle du « Gubani » qui est situé dans le sous-dossier des créatures « chevalines » pour réaliser notre peluche :

W:\database\stuff\tryker\agents\monsters\cheval\h12tr_mo_h12.max

[[File:01-tuto-peluche-dossiers-mobs.png|600px]]

== Étape 2 : Reprendre le modèle et se créer un dossier dédié pour travailler ==

Dans 3dsmax ouvrir le fichier « W:\database\stuff\tryker\agents\monsters\cheval\h12tr_mo_h12.max »

Nous consultons la liste des fichiers utilisés par le modèle, notamment les textures via le menu => «Fichier» => « Manage » => « Asset Tracking ». On note deux fichiers :

* Le modèle 3d : « tr_mo_h12.max »
* La texture du gubani « ju_mo_h12.png »

[[File:02-tuto-peluche-asset-tracking.png|800px]]

Le but ici étant de déployer des peluches monstres pour les objets du mois, nous allons donc se créer un dossier dédié pour nos futures peluches et respecter les conventions de nomination de ryzom.

Nous allons donc créer un dossier « soft-toy » dans le dossier « W:\database\stuff\generique\agents\accessories ». Nous y sauvegarderons notre modèle en le renommant : ge_acc_teddy-gubani_01.max

* le premier préfixe «ge_» du nom de fichier est pour spécifier l'écosystème, ici __gé__nérique (tr : tryker, fy : fyros, etc...)
* le second préfixe du nom du fichier est pour spécifier le type de modèle ( hom : homin masculin, mo : monstre, wea weapon, etc... ), ici « acc » pour __acc__essoire.
* Enfin le nom de notre modèle « teddy-gubani » que nous suffixons par un numéro afin de pouvoir créer plusieurs variantes de peluches gubani.

Pour la texture, nous devrions aussi la copier dans « W:\database\stuff\generique\agents\_textures\accessories », mais nous allons faire plus simple. Nous allons la mettre dans le même dossier que le modèle 3d et la renommer en suivant la même convention : « ge_acc_teddy-gubani_01.png »

Cependant, le moteur de ryzom ne sait afficher que les textures au format ".tga" ou ".dds". TGA est un format brut sans compression ce qui le rend pratique pour l'édition mais moins performant en espace mémoire occupé. le format DDS est un format d'image compressée qui comme le jpep est destructeur. C'est le format utilisé en interne par ryzom pour minimiser l'espace des textures en mémoire. Avec votre éditeur préféré convertissez l'image ".png" en ".tga". C'est elle-ci que nous garderons pour l'édition. Nous allons utiliser l'outil NEL "''tga2dds''" pour générer une image texture au format ".dds" pour le modèle 3d. C'est celle que nous utiliserons dans 3dsmax

tga2dds ge_acc_teddy-gubani_01.tga

Si vous n'avez pas l'outil, vous pouvez garder la version ".tga". Elle fonctionne pour les tests IG.
Dans le dossier soft-toy vous devriez avoir comme résultat :

[[File:03-tuto-peluche-dossier-soft-toy.png|600px]]

== Étape 3 : Nettoyer le modèle 3D sous 3dsmax ==

Le modèle 3D du monstre contient un squelette et toutes ce qu'il faut pour l'animer. Cela n'est pas nécessaire pour un accessoire peluche et surchargerait inutilement le modèle ryzom final. Nous allons dons les supprimer.

[[File:04-tuto-peluche-animation.png|800px]]

Sélectionner le modèle "Gubani" avec la souris. Dans le panneau latéral droit, sélectionner l'onglet "''modify''". Vous devez voir apparaître le mesh dénommé "TR_MO_H12" et dans la pile des "''modifiers''" celui nommé "physique". Nous allons le supprimer

[[File:05-tuto-peluche-physique.png|600px]]

Ensuite nous allons ouvrir l'écran affichant les éléments de la scene via le menu "Tools"=> "New Scene Explorer" et supprimer tous les éléments constituant le squelette du modèle pour ne garder au final que le mesh de l'animal.

[[File:06-tuto-peluche-bones-01.png|800px]]

Au final nous n'avons plus qu'un seul élément dans notre "scène" : le mesh du gubani "TR_MO_H12" :

[[File:07-tuto-peluche-nettoyer-modele.png|800px]]

Dans le panneau latéral droit, nous allons renommer ce mesh en "ge_acc_tedy-gubani_01". C'est ce nom qui sera utilisé par l'export "NEL" pour nommer le fichier "shape" généré lors de l'export.

[[File:07-tuto-peluche-nettoyer-modele-fin.png|800px]]

== Étape 4 : Modifier le mapping des textures du modèle ==

Dans cette partie, nous allons revoir la texturation du modèle 3d. A priori, il faudrait juste changer la texture de base «ju_mo_h12.png» pour pointer sur la notre «ge_acc_teddy-gubani_01.dds» (ou «.tga» à défaut) puis l'adapter comme nous le voulons visuellement. Cependant, cela va être un peu plus compliqué :

Nous allons d'abord ouvrir l'écran "Material Editor" (1), puis sélectionner le seul matériel de la scène (2) en double cliquant dessus. Dans l'écran centrale sélectionnez le noeud dénommé "Map #1 Nel Multi Bitmap" en double cliquant dessus (3). Vous verrez alors s'afficher dans le panneau latéral de droite le détail de ses propriétés (4). Le "Nel Multi Bitmap" permet de définir 8 images différentes. Il ne s'agit pas de multi-texturing, mais de la possibilité de configurer plusieurs images de texture. Seule une est appliqué à un instant donné sur le modèle. Cela est utilisé pour les mobs pour spécifier une texture par écosystème et par certains objets environnementaux pour spécifier une texture différente par saison.

[[File:08-tuto-peluche-texture.png|800px]]
Le slot ID 1 est utilisé pour les textures de l'écosystème tryker, le second (ID 2) pour l'écosystème fyros, le troisième (ID 3) pour l'écosystème zoraï et le quatrième (ID 4) pour l'écosystème des primes racines. Ne cherchez pas de slot matis, en bon esthètes, ils ont compris que la beauté résidait dans la nature zoraï et utilisent donc les textures zoraï pour tous leurs animaux. Notez qu'ici le gubani n'étant présent qu'en jungle et en primes racines, seuls les slots 3 et 4 sont utilisés

Le même système est aussi utilisé pour d'autres objets IG, comme les bâtiments.dans ce cas, les 4 slots correspondent aux quatre saisons. C'est ainsi que l'on peut noter la présence de neige sur certaines bâtisses zoraï en hiver.

[[File:09-tuto-peluche-multi-texture.png]]

De notre coté nous n'allons pas utilisé ce mécanisme. Nous allons donc supprimé le "NEL Multi Bitmap" et le remplacer par un simple "Bitmap" en tirant avec la souris sur la sortie de la "''tTexture 1''" comme le montre l'image ci-dessus. En relâchant la souris, un menu contextuel apparait (2), sélectionner l'entrée "Bitmap" :

[[File:10-tuto-peluche-bitmap.png|800px]]

Puis aller chercher notre image dans "W:\database\stuff\generique\agents\_textures\accessories\soft-toyge_acc_teddy-gubani_01.dds" (ou ".tga").

[[File:11-tuto-peluche-bitmap.png|800px]]

Répéter l'opération pour l'autre "Nel Multi Bitmap" qui référence la même image.

== Étape 5 : Mise à échelle du modèle ==

Note modèle 3d est presque prêt à l'emploi. Cependant sa taille ne correspond pas à celle attendue d'une peluche. Si vous utilisez l'outil de mesure de 3dsmax vous verrez que le gubani mesure plus 2m de haut. Le plus simple pour le mettre à la bonne taille est de charger un modèle d'homin afin d'avoir un comparatif visuel et s'assurer que la peluche peut être prise en main.

On va donc insérer temporairement dans notre scène 3dsmax une référence vers un autre modèle 3d en passant par le menu Fichier (1) => References (2) => Xref Scène (3) et en cliquant sur le bouton Add (4) de la fenêtre qui apparait :

[[File:15-tuto-peluche-xref.png|800px]]

Sélectionner alors le modèle d'homin "W:\database\stuff\generique\agents\actors\male\ge_hom_armor02.max" qui devrait apparaître dans votre scène 3d.

[[File:15-tuto-peluche-xref-02.png]]

Mettre a échelle le modèle de gubani et le déplacer via les outils "Scale" et "Move" du menu contextuel apparaissant lorsqu'on clique sur le modèle avec le bouton droit de la souris.

[[File:16-tuto-peluche-echelle.png]]

Une fois la peluche à la bonne échelle, il ne reste plus qu'a supprimer la référence au modèle d'homin en repassant par le menu Fichier => References => Xref Scene.

Repositionner le modèle gubani à l'origine de la scène (x=0, y=0, z=0), car lorsqu'un objet est porté la position (0,0,0) se place au niveau de la main.

== Étape 6 : modifier la texture pour un rendu peluche ==

Au niveau de la texture, pour donner un effet peluche, laissez libre court à votre imagination

[[File:17-tuto-peluche-texture-source.png]]

Ici j'ai édité l'image "ge_acc_teddy-gubani_01.tga" dans l'outil Gimp. J'ai utilisé le filtre "Artistiques > GIMPressioniste" en utilisant le modèle "canvas" pour obtenir un effet trame de tissu.

[[File:17-tuto-peluche-texture-peluche.png]]

Une fois l'image sauvegardée, j'ai re-généré la texture au format ".dds" via la commande :

tga2dds ge_acc_teddy-gubani_01.tga

Voila le résultat obtenu sur le modèle 3d dans 3dsmax :

[[File:18-tuto-peluche-modele3d.png]]

== Étape 7 : Export du shape ==

Il est temps de tester cette peluche en jeu. Pour cela il va falloir exporter le modèle en générant le fichier "shape" utilisé par le moteur Ryzom

Si ce n'est pas déjà je cas, ajouter le bouton ''d'export NEL'' au panneau latéral droit en cliquant sur l'onglet "''utilities''", puis "''More''" et en sélectionnant l'option "''NEL Export''" :

[[File:20-tuto-peluche-export-nel-01.png]]

Ensuite sélectionner le mesh du gubani puis cliquer sur le bouton "Export Model". Il vous faut alors spécifier le dossier où sera crée le fichier "ge_acc_teddy-gubani-01.shape"

[[File:20-tuto-peluche-export-nel-02.png]]

== Étape 8 : Tester la peluche IG ==

Pour bien faire les choses, il faudrait ajouter le ''datasheet'' de la peluche au serveur de jeu et patcher le client. Cette méthode sera détaillée plus loin. Cependant il existe une solution de contournement si vous n'avez pas votre propre serveur de jeu pour réaliser ces opérations.

Il faut savoir qu'une peluche n'est rien d'autre qu'une arme équipée. Ainsi nous pourrions remplacer le modèle de la dague par celui de notre gubani pour le tester sur le serveur officiel. Il existe une astuce simple pour cela. Le client de jeu recherche les modèles et textures dans le dossier "user" avant d'aller voir le dossier "data". Il suffit de copier notre fichier shape et la texture associée dans le dossier "user", puis de renommer le shape du gubani en celui de la dague : "GE_Wea_Dague.shape"

A présent lorsque vous équiperez une dague IG, vous aurez en main notre peluche "gubani".
Pour retrouver la dague d'origine, il suffit de supprimer le fichier shape du dossier "user" :

[[File:21-gubani-peluche-axe.png|400px]]

En réalisant ce test vous pouvez noter une anomalie : la peluche est tenue par le pied, ce qui n'est pas forcément ce que nous voulons

== Étape 9 : orientation et positionnement d'un objet porté ==

Le point de fixation d'un objet tenu en main correspond au point de coordonnée (0,0,0) de l'objet.Son orientation suit la règle suivante :

l'axe X remonte le long de l'avant-bras ;
l'axe Y part depuis le dos de la main vers l'extérieur ;
l'axe Z pointe vers le haut de l'objet tenu fermement en main.

Nous réorientons la peluche gubani dans 3dsmax comme le montre l'image suivante : l'axe X sort du dos du gubani pour remonter le long du bras qui le portera. L'axe Z sort de la main et est donc dans le prolongement de la tête de la peluche :

[[File:22-gubani-peluche-axe-3dsmax.png]]

Après réorientation du modèle gubani et réexportation du shape nous obtenons enfin une peluche qui est tenue par le tronc :

[[File:22-gubani-peluche-axe.png|400px]]

Pour aller plus loin sur les objets portés, je vous conseille de lire ce tutorial : http://khaganat.net/wikhan/fr:todo:dessiner:creation_d_un_objet_prehensible_en_jeu

== Étape 9 : Créer l’icône pour l'inventaire et la barre d'actions ==

Il faut créer un icône pour l'affichage de l'item peluche gubani dans l'inventaire et dans la barre d'actions.
Cet au icône au format tga doit faire 40x40 pixels avec un fond transparent. Nous le nommerons "icon_teddygubani.tga"

L'icône de 40x40 pixels :

[[File:23-icone-gubani.png|80px]]

Pour des questions de performance, ces icônes ne sont pas stockés individuellement mais regroupés dans une seule image dénommée : "texture_interfaces_v3.tga". Le fichier texte associé dénommé "texture_interfaces_v3.txt" liste les icones présents et leur position dans l'image :

[[File:23-icone-gubani-contexte-txt.png]]

le fichier texte utilise le format suivant pour chaque ligne :

NomFichierIcone u1 v1 u2 v2

Avec :
* u1,v1 la position du point supérieur gauche de l'icône
* u2,v2 la position du coin inférieur droit de l'icône

A la différence des coordonnées en pixels, ces coordonnées qui utilisent la technique du UV Mapping en 3d ont leurs valeurs dans l’intervalle [0 .. 1]. la coordonnée (0,0) correspond au point supérieur gauche de l'image et (1,1) au point inférieur droit de l'image.

Le passage d'un système à l'autre est simple. Soit (x1,y1) la position en pixels du coin haut gauche de notre icône dans l'image globale et (x2,y2) la position du point inférieur droit de l'icône dans l'image, alors :
* u1 = x1 / largeur-image
* v1 = y1 / hauteur-image
* u2 = x2 / largeur-image
* v2 = y2 / hauteur-image

Sachant que la texture "texture_interfaces_v3.tga" fait 1024x1024 pixel, et que dans l'exemple l'icône "icon_teddygubani.tga" se situe à la position (x1=118,y1=798), que le point inférieur gauche étant à la position (x2=157,y2=837), le fichier txt contient donc la ligne :

icon_teddygubani.tga 0.115234375 0.779296875 0.1533203125 0.8173828125

Même si cela peut être ajouté à la main, la bonne méthode et d'utiliser l'outil dédié de NEL ''build_interface'' comme indiqué dans le tutorial https://khaganat.net/wikhan/fr:todo:dessiner:creer_icone_objet qui recrée la texture globale et le fichier txt à partir d'un dossier contenant tous les icones.

Note: L'ajout de l'icône ne suffit pas, il faut également créer le datasheet de l'objet peluche et spécifier dedans le nom de notre icône à utiliser comme nous le verrons plus loin dans ce tutorial. Au final nous obtenons le résultat suivant IG :

[[File:23-icone-gubani-contexte.png]]

== Etape 11 : créer le fichiers des noms ==

A compléter.

[[File:30-tuto-peluche-txtfile.png]]

== Étape 12 : créer le datasheet ==

A la base, une peluche reste est un objet porté comme une arme. De fait le datasheet de la peluche est trs semblable à celui d'une arme une main, comme l'exemple de la dague ci-dessous.

__icrm1pd.sitem ( datasheet de la dague du réfugié ) :__

<pre>
<?xml version="1.0"?>
<FORM Revision="$Revision: 1.2 $" State="modified">
<PARENT Filename="_c_m1pd.sitem"/>
<STRUCT>
<STRUCT Name="basics">
<ATOM Name="name" Value="refugee dagger"/>
<ATOM Name="origin" Value="refugee"/>
<ATOM Name="Drop or Sell" Value="false"/>
<ATOM Name="CraftPlan" Value="bcrmea06.sbrick"/>
<ATOM Name="Saleable" Value="false"/>
</STRUCT>
<STRUCT Name="3d">
<ATOM Name="shape" Value="GE_Wea_Dague.shape"/>
<ATOM Name="shape_female" Value="GE_Wea_Dague.shape"/>
<ATOM Name="map_variant" Value="Low Quality"/>
<ATOM Name="icon background" Value="BK_generic.tga"/>
<STRUCT Name="fx">
<ATOM Name="Trail" Value="GE_Wea_Dague_trail_00.shape"/>
</STRUCT>
</STRUCT>
</STRUCT>
<STRUCT/>
<STRUCT/>
<STRUCT/>
<STRUCT/>
<LOG>
</FORM>
</pre>

Ce qui change c'est :

* la référénce au shape dans la section "3d"

<ATOM Name="shape" Value="ge_acc_teddy-gubani_01.shape"/>
<ATOM Name="shape_female" Value="ge_acc_teddy-gubani_01.shape"/>

* la référence à l'icone utilisé dans la barre d'état et l'inventaire dans la section "3d"

<ATOM Name="icon" Value="icon_teddygubani.tga"/>
<ATOM Name="icon overlay" Value="icon_teddygubani.tga"/>

* les caractéristiques de base qui diffèrent d'une arme : pas de niveau requis, pas de brique de plan, etc..

<STRUCT Name="basics">
<ATOM Name="name" Value="staff"/>
<ATOM Name="origin" Value="common"/>
<ATOM Name="family" Value="handled item"/>
<ATOM Name="ItemType" Value="Staff"/>
<ATOM Name="Bulk" Value="5"/>
<ATOM Name="RequiredCharacQualityFactor" Value="0"/>
<ATOM Name="RequiredCharacQualityOffset" Value="0"/>
</STRUCT>

Voila donc le datasheet de la peluche gubani que nous nommerons "teddygubani.sitem" :

<pre>
<?xml version="1.0"?>
<FORM Revision="$Revision: 1.7 $" State="modified">
<PARENT Filename="_c_m1pd.sitem"/>
<STRUCT>
<STRUCT Name="basics">
<ATOM Name="name" Value="staff"/>
<ATOM Name="origin" Value="common"/>
<ATOM Name="family" Value="handled item"/>
<ATOM Name="ItemType" Value="Staff"/>
<ATOM Name="Bulk" Value="5"/>
<ATOM Name="RequiredCharacQualityFactor" Value="0"/>
<ATOM Name="RequiredCharacQualityOffset" Value="0"/>
</STRUCT>
<STRUCT Name="3d">
<ATOM Name="shape" Value="ge_acc_teddy-gubani_01.shape"/>
<ATOM Name="shape_female" Value="ge_acc_teddy-gubani_01.shape"/>
<ATOM Name="map_variant" Value="Low Quality"/>
<ATOM Name="icon" Value="icon_teddygubani.tga"/>
<ATOM Name="icon background" Value="BK_generic.tga"/>
<ATOM Name="icon overlay" Value="icon_teddygubani.tga"/>
<STRUCT Name="fx">
<ATOM Name="Trail" Value="GE_Wea_Dague_trail_00.shape"/>
</STRUCT>
</STRUCT>
</STRUCT>
<STRUCT/>
<STRUCT/>
<STRUCT/>
<STRUCT/>
<LOG></LOG>
</FORM>
</pre>

== Étape 13 : Déployer la peluche sur le serveur et le client de jeu ==

Afin de déployer la peluche en jeu la méthode officielle consiste à utiliser la pipeline "build_gamedata" (cf. https:''ryzomcore.atlassian.net/wiki/display/RC/Gamedata+Build+Pipeline). Je vais vous proposer une méthode différente, où les opérations seront effectués à la mains, mais uniquement celles nécessaires à notre peluche :

Nous avons besoin des fichiers suivants :

* teddygubani.sitem ( le datasheet de la peluche gunabi )
* ge_acc_teddy-gubani_01.shape ( le modèle 3d NEL de la peluche )
* ge_acc_teddy-gubani_01.dds ( la texture du modèle 3d )

De plus le déploiement de cette peluche va impacter les fichiers suivants :

* les fichiers "*.packed_sheets" utilisée par le serveur et le client qui sont une version compilé des datasheets
* le fichier "sheet_id.bin" qui est un index de tous les datasheets utilisés par le jeu
* le fichier "visual_slot.tab" qui liste les éléments affichables coté client

Pour bien faire les choses, nous allons également créer un fichier "soft-toy.bnp" qui contiendra les shapes et les textures de toutes les futures peluches.

Pour la suite des opérations nous partons du principe que notre serveur de jeu fonctionne sous linux, et que les variables d'envrionnement suivantes sont définies :

* LEVELDESIGNPATH pointe sur le dossier des datas du level design
* RYZOM_HOME sur l'installation des sources du serveur

=== Ajout du datasheet "teddygubani.sitem" au serveur ===

Coté serveur nous allons créer un dossier dédié pour les datasheets des peluches et y placer celui du gubani :

$ mkdir $LEVELDESIGNPATH/leveldesign/game_element/sitem/soft-toy
$ cp teddygubani.sitem $LEVELDESIGNPATH/leveldesign/game_element/sitem/soft-toy

=== Nettoyages préalables ===

=== Re-générer le fichier "sheet_id.bin" ===

La première étape consiste à regénérer le fichier d'index des datasheet via la commande "make_sheet_id". Il reprend le fichier d'index existant et va le compléter avec les datasheets du dossier $RYZOM_LEVELPATH/leveldesign/game_element/sitem/soft-toy c'est-à-dire les datasheets de nos peluches

$ make_sheet_id -o$LEVELDESIGNPATH/leveldesign/Game_elem/sheet_id.bin $LEVELDESIGNPATH/leveldesign/game_element/sitem/soft-toy

=== Re-générer les "*.packed_sheets" et "visual_slot.tab" ===

Il faut regénérer les "*.packed_sheets".Ce sont les versions pré-compilées des datasheets :

$ sheets_packer

Cette commande va également re-générer le fichier visual_slot.tab

=== Copier les fichiers nécessaires coté client ===

* Nous copions le fichier "visual_slot.tab" généré dans le dossier courant dans le dossier "user" du client de jeu
* Nous copions le fichier $LEVELDESIGNPATH/leveldesign/Game_elem/sheet_id.bin dans le dossier "user" du client de jeu
* Nous remplaçons les fichiers packet_sheets du dossier "data" du client par ceux générés ici $RYZOM_HOME/code/ryzom/client/data/*.packed_sheets par la commande ''sheets_packer''

=== Créer un bnp pour le modèle de la peluche ===

Pour finir il faut copier le shape et la texture de la peluche dans le dossier "data" du client.
Cependant pour bien faire les choses, autant créer un fichier ".bnp" dédié.
Un fichier ".bnp" est une sorte de zip regroupant les différents fichiers shape, dds, txt, ou autres par thème.

Créer on dossier "soft-toy", copions y tous les shapes et textures de nos peluche, à savoir pour le moment "ge_acc_teddy-gubani_01.shape" et "ge_acc_teddy-gubani_01.dds" et créons un fichier BNP pour les contenur

bnp_make /p soft-toy

La commande va créer un fichier "soft-toy,bnp" qui contiendra nos deux fichiers. A présent il faut le copier dans le dossier "data" du client.

=== Tester IG ===

Relancer le serveur avec la commande ''shard start'' puis connectez vous avec votre client.

Si tout c'est bien déroulé, en lançant votre client de jeu, vous pouvez créer une peluche dans votre inventaire avec la commande :

/a createItemInBag teddygubani 1 5

{{tag>Tag_a_ajouter}}

FR Peluche

2014-07-25T21:27:23Z

Madi: /* Objets du mois : Déployer en Jeu des peluches « mobs d'atys » */

= Objets du mois : Déployer en Jeu des peluches « mobs d'atys » =

[[File:00-tuto-peluche.png|300px]]

Le but de ce tutorial est de montrer comment réaliser des peluches basées sur les modèles des animaux atysiens.

Pré-requis pour modéliser uniquement la peluche :

* Avoir installé les assets ryzom et configuré correctement les lecteurs (les outils NEL s'attendent à trouver les données des assets dans le dossier ( W:\database ).
* Avoir installé 3DSMax et configuré le plugin NEL ( Attention le plugin ne fonctionne qu'avec les version 32bits de 3DSmax et de la versions 9 à la version 2012).
* Conseillé mais non nécessaire : avoir installé l'outil NEL "''tga2dds.exe''".

Pré-requis pour déployer la peluche sur un serveur de jeu :

* Avoir compilé et installé un serveur de jeu et configuré un client pour l'utiliser

Note : il est possible de tester cette peluche IG sans disposer d'un serveur de jeu via une astuce qui sera expliquée plus loin dans ce tutoriel.

Quelques liens utiles pour ces pré-requis :

* Liens de téléchargement des assets et outils : https://ryzomcore.atlassian.net/wiki/display/RC/Downloads+for+Windows
* Configuration des lecteurs : https://ryzomcore.atlassian.net/wiki/display/RC/How+to+set+up+the+Build+Pipeline
* Installation du plugin NEL de 3dsmax : https://ryzomcore.atlassian.net/wiki/display/RC/Installing+the+Max+Plugins

== Étape 1: choisir le modèle qui servira pour notre peluche ==

L'ensemble des modèles 3d de la faune de ryzom sont regroupés dans le dossier « W:\database\stuff\tryker\agents\monsters » par famille de créature. Dans ce tutorial nous allons utiliser le modèle du « Gubani » qui est situé dans le sous-dossier des créatures « chevalines » pour réaliser notre peluche :

W:\database\stuff\tryker\agents\monsters\cheval\h12tr_mo_h12.max

[[File:01-tuto-peluche-dossiers-mobs.png|600px]]

== Étape 2 : Reprendre le modèle et se créer un dossier dédié pour travailler ==

Dans 3dsmax ouvrir le fichier « W:\database\stuff\tryker\agents\monsters\cheval\h12tr_mo_h12.max »

Nous consultons la liste des fichiers utilisés par le modèle, notamment les textures via le menu => «Fichier» => « Manage » => « Asset Tracking ». On note deux fichiers :

* Le modèle 3d : « tr_mo_h12.max »
* La texture du gubani « ju_mo_h12.png »

[[File:02-tuto-peluche-asset-tracking.png|800px]]

Le but ici étant de déployer des peluches monstres pour les objets du mois, nous allons donc se créer un dossier dédié pour nos futures peluches et respecter les conventions de nomination de ryzom.

Nous allons donc créer un dossier « soft-toy » dans le dossier « W:\database\stuff\generique\agents\accessories ». Nous y sauvegarderons notre modèle en le renommant : ge_acc_teddy-gubani_01.max

* le premier préfixe «ge_» du nom de fichier est pour spécifier l'écosystème, ici __gé__nérique (tr : tryker, fy : fyros, etc...)
* le second préfixe du nom du fichier est pour spécifier le type de modèle ( hom : homin masculin, mo : monstre, wea weapon, etc... ), ici « acc » pour __acc__essoire.
* Enfin le nom de notre modèle « teddy-gubani » que nous suffixons par un numéro afin de pouvoir créer plusieurs variantes de peluches gubani.

Pour la texture, nous devrions aussi la copier dans « W:\database\stuff\generique\agents\_textures\accessories », mais nous allons faire plus simple. Nous allons la mettre dans le même dossier que le modèle 3d et la renommer en suivant la même convention : « ge_acc_teddy-gubani_01.png »

Cependant, le moteur de ryzom ne sait afficher que les textures au format ".tga" ou ".dds". TGA est un format brut sans compression ce qui le rend pratique pour l'édition mais moins performant en espace mémoire occupé. le format DDS est un format d'image compressée qui comme le jpep est destructeur. C'est le format utilisé en interne par ryzom pour minimiser l'espace des textures en mémoire. Avec votre éditeur préféré convertissez l'image ".png" en ".tga". C'est elle-ci que nous garderons pour l'édition. Nous allons utiliser l'outil NEL "''tga2dds''" pour générer une image texture au format ".dds" pour le modèle 3d. C'est celle que nous utiliserons dans 3dsmax

tga2dds ge_acc_teddy-gubani_01.tga

Si vous n'avez pas l'outil, vous pouvez garder la version ".tga". Elle fonctionne pour les tests IG.
Dans le dossier soft-toy vous devriez avoir comme résultat :

[[File:03-tuto-peluche-dossier-soft-toy.png|600px]]

== Étape 3 : Nettoyer le modèle 3D sous 3dsmax ==

Le modèle 3D du monstre contient un squelette et toutes ce qu'il faut pour l'animer. Cela n'est pas nécessaire pour un accessoire peluche et surchargerait inutilement le modèle ryzom final. Nous allons dons les supprimer.

[[File:04-tuto-peluche-animation.png|800px]]

Sélectionner le modèle "Gubani" avec la souris. Dans le panneau latéral droit, sélectionner l'onglet "''modify''". Vous devez voir apparaître le mesh dénommé "TR_MO_H12" et dans la pile des "''modifiers''" celui nommé "physique". Nous allons le supprimer

[[File:05-tuto-peluche-physique.png|600px]]

Ensuite nous allons ouvrir l'écran affichant les éléments de la scene via le menu "Tools"=> "New Scene Explorer" et supprimer tous les éléments constituant le squelette du modèle pour ne garder au final que le mesh de l'animal.

[[File:06-tuto-peluche-bones-01.png|800px]]

Au final nous n'avons plus qu'un seul élément dans notre "scène" : le mesh du gubani "TR_MO_H12" :

[[File:07-tuto-peluche-nettoyer-modele.png|800px]]

Dans le panneau latéral droit, nous allons renommer ce mesh en "ge_acc_tedy-gubani_01". C'est ce nom qui sera utilisé par l'export "NEL" pour nommer le fichier "shape" généré lors de l'export.

[[File:07-tuto-peluche-nettoyer-modele-fin.png|800px]]

== Étape 4 : Modifier le mapping des textures du modèle ==

Dans cette partie, nous allons revoir la texturation du modèle 3d. A priori, il faudrait juste changer la texture de base «ju_mo_h12.png» pour pointer sur la notre «ge_acc_teddy-gubani_01.dds» (ou «.tga» à défaut) puis l'adapter comme nous le voulons visuellement. Cependant, cela va être un peu plus compliqué :

Nous allons d'abord ouvrir l'écran "Material Editor" (1), puis sélectionner le seul matériel de la scène (2) en double cliquant dessus. Dans l'écran centrale sélectionnez le noeud dénommé "Map #1 Nel Multi Bitmap" en double cliquant dessus (3). Vous verrez alors s'afficher dans le panneau latéral de droite le détail de ses propriétés (4). Le "Nel Multi Bitmap" permet de définir 8 images différentes. Il ne s'agit pas de multi-texturing, mais de la possibilité de configurer plusieurs images de texture. Seule une est appliqué à un instant donné sur le modèle. Cela est utilisé pour les mobs pour spécifier une texture par écosystème et par certains objets environnementaux pour spécifier une texture différente par saison.

[[File:08-tuto-peluche-texture.png|800px]]
Le slot ID 1 est utilisé pour les textures de l'écosystème tryker, le second (ID 2) pour l'écosystème fyros, le troisième (ID 3) pour l'écosystème zoraï et le quatrième (ID 4) pour l'écosystème des primes racines. Ne cherchez pas de slot matis, en bon esthètes, ils ont compris que la beauté résidait dans la nature zoraï et utilisent donc les textures zoraï pour tous leurs animaux. Notez qu'ici le gubani n'étant présent qu'en jungle et en primes racines, seuls les slots 3 et 4 sont utilisés

Le même système est aussi utilisé pour d'autres objets IG, comme les bâtiments.dans ce cas, les 4 slots correspondent aux quatre saisons. C'est ainsi que l'on peut noter la présence de neige sur certaines bâtisses zoraï en hiver.

[[File:09-tuto-peluche-multi-texture.png]]

De notre coté nous n'allons pas utilisé ce mécanisme. Nous allons donc supprimé le "NEL Multi Bitmap" et le remplacer par un simple "Bitmap" en tirant avec la souris sur la sortie de la "''tTexture 1''" comme le montre l'image ci-dessus. En relâchant la souris, un menu contextuel apparait (2), sélectionner l'entrée "Bitmap" :

[[File:10-tuto-peluche-bitmap.png|800px]]

Puis aller chercher notre image dans "W:\database\stuff\generique\agents\_textures\accessories\soft-toyge_acc_teddy-gubani_01.dds" (ou ".tga").

[[File:11-tuto-peluche-bitmap.png|800px]]

Répéter l'opération pour l'autre "Nel Multi Bitmap" qui référence la même image.

== Étape 5 : Mise à échelle du modèle ==

Note modèle 3d est presque prêt à l'emploi. Cependant sa taille ne correspond pas à celle attendue d'une peluche. Si vous utilisez l'outil de mesure de 3dsmax vous verrez que le gubani mesure plus 2m de haut. Le plus simple pour le mettre à la bonne taille est de charger un modèle d'homin afin d'avoir un comparatif visuel et s'assurer que la peluche peut être prise en main.

On va donc insérer temporairement dans notre scène 3dsmax une référence vers un autre modèle 3d en passant par le menu Fichier (1) => References (2) => Xref Scène (3) et en cliquant sur le bouton Add (4) de la fenêtre qui apparait :

[[File:15-tuto-peluche-xref.png|800px]]

Sélectionner alors le modèle d'homin "W:\database\stuff\generique\agents\actors\male\ge_hom_armor02.max" qui devrait apparaître dans votre scène 3d.

[[File:15-tuto-peluche-xref-02.png]]

Mettre a échelle le modèle de gubani et le déplacer via les outils "Scale" et "Move" du menu contextuel apparaissant lorsqu'on clique sur le modèle avec le bouton droit de la souris.

[[File:16-tuto-peluche-echelle.png]]

Une fois la peluche à la bonne échelle, il ne reste plus qu'a supprimer la référence au modèle d'homin en repassant par le menu Fichier => References => Xref Scene.

Repositionner le modèle gubani à l'origine de la scène (x=0, y=0, z=0), car lorsqu'un objet est porté la position (0,0,0) se place au niveau de la main.

== Étape 6 : modifier la texture pour un rendu peluche ==

Au niveau de la texture, pour donner un effet peluche, laissez libre court à votre imagination

[[File:17-tuto-peluche-texture-source.png]]

Ici j'ai édité l'image "ge_acc_teddy-gubani_01.tga" dans l'outil Gimp. J'ai utilisé le filtre "Artistiques > GIMPressioniste" en utilisant le modèle "canvas" pour obtenir un effet trame de tissu.

[[File:17-tuto-peluche-texture-peluche.png]]

Une fois l'image sauvegardée, j'ai re-généré la texture au format ".dds" via la commande :

tga2dds ge_acc_teddy-gubani_01.tga

Voila le résultat obtenu sur le modèle 3d dans 3dsmax :

[[File:18-tuto-peluche-modele3d.png]]

== Étape 7 : Export du shape ==

Il est temps de tester cette peluche en jeu. Pour cela il va falloir exporter le modèle en générant le fichier "shape" utilisé par le moteur Ryzom

Si ce n'est pas déjà je cas, ajouter le bouton ''d'export NEL'' au panneau latéral droit en cliquant sur l'onglet "''utilities''", puis "''More''" et en sélectionnant l'option "''NEL Export''" :

[[File:20-tuto-peluche-export-nel-01.png]]

Ensuite sélectionner le mesh du gubani puis cliquer sur le bouton "Export Model". Il vous faut alors spécifier le dossier où sera crée le fichier "ge_acc_teddy-gubani-01.shape"

[[File:20-tuto-peluche-export-nel-02.png]]

== Étape 8 : Tester la peluche IG ==

Pour bien faire les choses, il faudrait ajouter le ''datasheet'' de la peluche au serveur de jeu et patcher le client. Cette méthode sera détaillée plus loin. Cependant il existe une solution de contournement si vous n'avez pas votre propre serveur de jeu pour réaliser ces opérations.

Il faut savoir qu'une peluche n'est rien d'autre qu'une arme équipée. Ainsi nous pourrions remplacer le modèle de la dague par celui de notre gubani pour le tester sur le serveur officiel. Il existe une astuce simple pour cela. Le client de jeu recherche les modèles et textures dans le dossier "user" avant d'aller voir le dossier "data". Il suffit de copier notre fichier shape et la texture associée dans le dossier "user", puis de renommer le shape du gubani en celui de la dague : "GE_Wea_Dague.shape"

A présent lorsque vous équiperez une dague IG, vous aurez en main notre peluche "gubani".
Pour retrouver la dague d'origine, il suffit de supprimer le fichier shape du dossier "user" :

[[File:21-gubani-peluche-axe.png|400px]]

En réalisant ce test vous pouvez noter une anomalie : la peluche est tenue par le pied, ce qui n'est pas forcément ce que nous voulons

== Étape 9 : orientation et positionnement d'un objet porté ==

Le point de fixation d'un objet tenu en main correspond au point de coordonnée (0,0,0) de l'objet.Son orientation suit la règle suivante :

l'axe X remonte le long de l'avant-bras ;
l'axe Y part depuis le dos de la main vers l'extérieur ;
l'axe Z pointe vers le haut de l'objet tenu fermement en main.

Nous réorientons la peluche gubani dans 3dsmax comme le montre l'image suivante : l'axe X sort du dos du gubani pour remonter le long du bras qui le portera. L'axe Z sort de la main et est donc dans le prolongement de la tête de la peluche :

[[File:22-gubani-peluche-axe-3dsmax.png]]

Après réorientation du modèle gubani et réexportation du shape nous obtenons enfin une peluche qui est tenue par le tronc :

[[File:22-gubani-peluche-axe.png|400px]]

Pour aller plus loin sur les objets portés, je vous conseille de lire ce tutorial : http://khaganat.net/wikhan/fr:todo:dessiner:creation_d_un_objet_prehensible_en_jeu

== Étape 9 : Créer l’icône pour l'inventaire et la barre d'actions ==

Il faut créer un icône pour l'affichage de l'item peluche gubani dans l'inventaire et dans la barre d'actions.
Cet au icône au format tga doit faire 40x40 pixels avec un fond transparent. Nous le nommerons "icon_teddygubani.tga"

L'icône de 40x40 pixels :

[[File:23-icone-gubani.png|80px]]

Pour des questions de performance, ces icônes ne sont pas stockés individuellement mais regroupés dans une seule image dénommée : "texture_interfaces_v3.tga". Le fichier texte associé dénommé "texture_interfaces_v3.txt" liste les icones présents et leur position dans l'image :

[[File:23-icone-gubani-contexte-txt.png]]

le fichier texte utilise le format suivant pour chaque ligne :

NomFichierIcone u1 v1 u2 v2

Avec :
* u1,v1 la position du point supérieur gauche de l'icône
* u2,v2 la position du coin inférieur droit de l'icône

A la différence des coordonnées en pixels, ces coordonnées qui utilisent la technique du UV Mapping en 3d ont leurs valeurs dans l’intervalle [0 .. 1]. la coordonnée (0,0) correspond au point supérieur gauche de l'image et (1,1) au point inférieur droit de l'image.

Le passage d'un système à l'autre est simple. Soit (x1,y1) la position en pixels du coin haut gauche de notre icône dans l'image globale et (x2,y2) la position du point inférieur droit de l'icône dans l'image, alors :
* u1 = x1 / largeur-image
* v1 = y1 / hauteur-image
* u2 = x2 / largeur-image
* v2 = y2 / hauteur-image

Sachant que la texture "texture_interfaces_v3.tga" fait 1024x1024 pixel, et que dans l'exemple l'icône "icon_teddygubani.tga" se situe à la position (x1=118,y1=798), que le point inférieur gauche étant à la position (x2=157,y2=837), le fichier txt contient donc la ligne :

icon_teddygubani.tga 0.115234375 0.779296875 0.1533203125 0.8173828125

Même si cela peut être ajouté à la main, la bonne méthode et d'utiliser l'outil dédié de NEL ''build_interface'' comme indiqué dans le tutorial https://khaganat.net/wikhan/fr:todo:dessiner:creer_icone_objet qui recrée la texture globale et le fichier txt à partir d'un dossier contenant tous les icones.

Note: L'ajout de l'icône ne suffit pas, il faut également créer le datasheet de l'objet peluche et spécifier dedans le nom de notre icône à utiliser comme nous le verrons plus loin dans ce tutorial. Au final nous obtenons le résultat suivant IG :

[[File:23-icone-gubani-contexte.png]]

== Etape 11 : créer le fichiers des noms ==

A compléter.

[[File:30-tuto-peluche-txtfile.png]]

== Étape 12 : créer le datasheet ==

A la base, une peluche reste est un objet porté comme une arme. De fait le datasheet de la peluche est trs semblable à celui d'une arme une main, comme l'exemple de la dague ci-dessous.

__icrm1pd.sitem ( datasheet de la dague du réfugié ) :__

<pre>
<?xml version="1.0"?>
<FORM Revision="$Revision: 1.2 $" State="modified">
<PARENT Filename="_c_m1pd.sitem"/>
<STRUCT>
<STRUCT Name="basics">
<ATOM Name="name" Value="refugee dagger"/>
<ATOM Name="origin" Value="refugee"/>
<ATOM Name="Drop or Sell" Value="false"/>
<ATOM Name="CraftPlan" Value="bcrmea06.sbrick"/>
<ATOM Name="Saleable" Value="false"/>
</STRUCT>
<STRUCT Name="3d">
<ATOM Name="shape" Value="GE_Wea_Dague.shape"/>
<ATOM Name="shape_female" Value="GE_Wea_Dague.shape"/>
<ATOM Name="map_variant" Value="Low Quality"/>
<ATOM Name="icon background" Value="BK_generic.tga"/>
<STRUCT Name="fx">
<ATOM Name="Trail" Value="GE_Wea_Dague_trail_00.shape"/>
</STRUCT>
</STRUCT>
</STRUCT>
<STRUCT/>
<STRUCT/>
<STRUCT/>
<STRUCT/>
<LOG>
</FORM>
</pre>

Ce qui change c'est :

* la référénce au shape dans la section "3d"

<ATOM Name="shape" Value="ge_acc_teddy-gubani_01.shape"/>
<ATOM Name="shape_female" Value="ge_acc_teddy-gubani_01.shape"/>

* la référence à l'icone utilisé dans la barre d'état et l'inventaire dans la section "3d"

<ATOM Name="icon" Value="icon_teddygubani.tga"/>
<ATOM Name="icon overlay" Value="icon_teddygubani.tga"/>

* les caractéristiques de base qui diffèrent d'une arme : pas de niveau requis, pas de brique de plan, etc..

<STRUCT Name="basics">
<ATOM Name="name" Value="staff"/>
<ATOM Name="origin" Value="common"/>
<ATOM Name="family" Value="handled item"/>
<ATOM Name="ItemType" Value="Staff"/>
<ATOM Name="Bulk" Value="5"/>
<ATOM Name="RequiredCharacQualityFactor" Value="0"/>
<ATOM Name="RequiredCharacQualityOffset" Value="0"/>
</STRUCT>

Voila donc le datasheet de la peluche gubani que nous nommerons "teddygubani.sitem" :

<pre>
<?xml version="1.0"?>
<FORM Revision="$Revision: 1.7 $" State="modified">
<PARENT Filename="_c_m1pd.sitem"/>
<STRUCT>
<STRUCT Name="basics">
<ATOM Name="name" Value="staff"/>
<ATOM Name="origin" Value="common"/>
<ATOM Name="family" Value="handled item"/>
<ATOM Name="ItemType" Value="Staff"/>
<ATOM Name="Bulk" Value="5"/>
<ATOM Name="RequiredCharacQualityFactor" Value="0"/>
<ATOM Name="RequiredCharacQualityOffset" Value="0"/>
</STRUCT>
<STRUCT Name="3d">
<ATOM Name="shape" Value="ge_acc_teddy-gubani_01.shape"/>
<ATOM Name="shape_female" Value="ge_acc_teddy-gubani_01.shape"/>
<ATOM Name="map_variant" Value="Low Quality"/>
<ATOM Name="icon" Value="icon_teddygubani.tga"/>
<ATOM Name="icon background" Value="BK_generic.tga"/>
<ATOM Name="icon overlay" Value="icon_teddygubani.tga"/>
<STRUCT Name="fx">
<ATOM Name="Trail" Value="GE_Wea_Dague_trail_00.shape"/>
</STRUCT>
</STRUCT>
</STRUCT>
<STRUCT/>
<STRUCT/>
<STRUCT/>
<STRUCT/>
<LOG></LOG>
</FORM>
</pre>

== Étape 13 : Déployer la peluche sur le serveur et le client de jeu ==

Afin de déployer la peluche en jeu la méthode officielle consiste à utiliser la pipeline "build_gamedata" (cf. https:''ryzomcore.atlassian.net/wiki/display/RC/Gamedata+Build+Pipeline). Je vais vous proposer une méthode différente, où les opérations seront effectués à la mains, mais uniquement celles nécessaires à notre peluche :

Nous avons besoin des fichiers suivants :

* teddygubani.sitem ( le datasheet de la peluche gunabi )
* ge_acc_teddy-gubani_01.shape ( le modèle 3d NEL de la peluche )
* ge_acc_teddy-gubani_01.dds ( la texture du modèle 3d )

De plus le déploiement de cette peluche va impacter les fichiers suivants :

* les fichiers "*.packed_sheets" utilisée par le serveur et le client qui sont une version compilé des datasheets
* le fichier "sheet_id.bin" qui est un index de tous les datasheets utilisés par le jeu
* le fichier "visual_slot.tab" qui liste les éléments affichables coté client

Pour bien faire les choses, nous allons également créer un fichier "soft-toy.bnp" qui contiendra les shapes et les textures de toutes les futures peluches.

Pour la suite des opérations nous partons du principe que notre serveur de jeu fonctionne sous linux, et que les variables d'envrionnement suivantes sont définies :

* LEVELDESIGNPATH pointe sur le dossier des datas du level design
* RYZOM_HOME sur l'installation des sources du serveur

=== Ajout du datasheet "teddygubani.sitem" au serveur ===

Coté serveur nous allons créer un dossier dédié pour les datasheets des peluches et y placer celui du gubani :

$ mkdir $LEVELDESIGNPATH/leveldesign/game_element/sitem/soft-toy
$ cp teddygubani.sitem $LEVELDESIGNPATH/leveldesign/game_element/sitem/soft-toy

=== Nettoyages préalables ===

=== Re-générer le fichier "sheet_id.bin" ===

La première étape consiste à regénérer le fichier d'index des datasheet via la commande "make_sheet_id". Il reprend le fichier d'index existant et va le compléter avec les datasheets du dossier $RYZOM_LEVELPATH/leveldesign/game_element/sitem/soft-toy c'est-à-dire les datasheets de nos peluches

$ make_sheet_id -o$LEVELDESIGNPATH/leveldesign/Game_elem/sheet_id.bin $LEVELDESIGNPATH/leveldesign/game_element/sitem/soft-toy

=== Re-générer les "*.packed_sheets" et "visual_slot.tab" ===

Il faut regénérer les "*.packed_sheets".Ce sont les versions pré-compilées des datasheets :

$ sheets_packer

Cette commande va également re-générer le fichier visual_slot.tab

=== Copier les fichiers nécessaires coté client ===

* Nous copions le fichier "visual_slot.tab" généré dans le dossier courant dans le dossier "user" du client de jeu
* Nous copions le fichier $LEVELDESIGNPATH/leveldesign/Game_elem/sheet_id.bin dans le dossier "user" du client de jeu
* Nous remplaçons les fichiers packet_sheets du dossier "data" du client par ceux générés ici $RYZOM_HOME/code/ryzom/client/data/*.packed_sheets par la commande ''sheets_packer''

=== Créer un bnp pour le modèle de la peluche ===

Pour finir il faut copier le shape et la texture de la peluche dans le dossier "data" du client.
Cependant pour bien faire les choses, autant créer un fichier ".bnp" dédié.
Un fichier ".bnp" est une sorte de zip regroupant les différents fichiers shape, dds, txt, ou autres par thème.

Créer on dossier "soft-toy", copions y tous les shapes et textures de nos peluche, à savoir pour le moment "ge_acc_teddy-gubani_01.shape" et "ge_acc_teddy-gubani_01.dds" et créons un fichier BNP pour les contenur

bnp_make /p soft-toy

La commande va créer un fichier "soft-toy,bnp" qui contiendra nos deux fichiers. A présent il faut le copier dans le dossier "data" du client.

=== Tester IG ===

Relancer le serveur avec la commande ''shard start'' puis connectez vous avec votre client.

Si tout c'est bien déroulé, en lançant votre client de jeu, vous pouvez créer une peluche dans votre inventaire avec la commande :

/a createItemInBag teddygubani 1 5

{{tag>Tag_a_ajouter}}

FR Peluche

2014-07-25T21:20:54Z

Madi: /* Objets du mois : Déployer en Jeu des peluches « mobs d'atys » */

= Objets du mois : Déployer en Jeu des peluches « mobs d'atys » =

[[File:00-tuto-peluche.png|300px]]

Le but de ce tutorial est de montrer comment réaliser des peluches basées sur les modèles des animaux atysiens.

Pré-requis pour modéliser uniquement la peluche :

* Avoir installé les assets ryzom et configuré correctement les lecteurs (les outils NEL s'attendent à trouver les données des assets dans le dossier ( W:database ).
* Avoir installé 3DSMax et configuré le plugin NEL ( Attention le plugin ne fonctionne qu'avec les version 32bits de 3DSmax et de la versions 9 à la version 2012).
* Conseillé mais non nécessaire : avoir installé l'outil NEL "''tga2dds.exe''".

Pré-requis pour déployer la peluche sur un serveur de jeu :

* Avoir compilé et installé un serveur de jeu et configuré un client pour l'utiliser

Note : il est possible de tester cette peluche IG sans disposer d'un serveur de jeu via une astuce qui sera expliquée plus loin dans ce tutoriel.

Quelques liens utiles pour ces pré-requis :

* Liens de téléchargement des assets et outils : https://ryzomcore.atlassian.net/wiki/display/RC/Downloads+for+Windows
* Configuration des lecteurs : https://ryzomcore.atlassian.net/wiki/display/RC/How+to+set+up+the+Build+Pipeline
* Installation du plugin NEL de 3dsmax : https://ryzomcore.atlassian.net/wiki/display/RC/Installing+the+Max+Plugins

== Étape 1: choisir le modèle qui servira pour notre peluche ==

L'ensemble des modèles 3d de la faune de ryzom sont regroupés dans le dossier « W:\database\stuff\tryker\agents\monsters » par famille de créature. Dans ce tutorial nous allons utiliser le modèle du « Gubani » qui est situé dans le sous-dossier des créatures « chevalines » pour réaliser notre peluche :

W:\database\stuff\tryker\agents\monsters\cheval\h12tr_mo_h12.max

[[File:01-tuto-peluche-dossiers-mobs.png|600px]]

== Étape 2 : Reprendre le modèle et se créer un dossier dédié pour travailler ==

Dans 3dsmax ouvrir le fichier « W:\database\stuff\tryker\agents\monsters\cheval\h12tr_mo_h12.max »

Nous consultons la liste des fichiers utilisés par le modèle, notamment les textures via le menu => «Fichier» => « Manage » => « Asset Tracking ». On note deux fichiers :

* Le modèle 3d : « tr_mo_h12.max »
* La texture du gubani « ju_mo_h12.png »

[[File:02-tuto-peluche-asset-tracking.png|800px]]

Le but ici étant de déployer des peluches monstres pour les objets du mois, nous allons donc se créer un dossier dédié pour nos futures peluches et respecter les conventions de nomination de ryzom.

Nous allons donc créer un dossier « soft-toy » dans le dossier « W:\database\stuff\generique\agents\accessories ». Nous y sauvegarderons notre modèle en le renommant : ge_acc_teddy-gubani_01.max

* le premier préfixe «ge_» du nom de fichier est pour spécifier l'écosystème, ici __gé__nérique (tr : tryker, fy : fyros, etc...)
* le second préfixe du nom du fichier est pour spécifier le type de modèle ( hom : homin masculin, mo : monstre, wea weapon, etc... ), ici « acc » pour __acc__essoire.
* Enfin le nom de notre modèle « teddy-gubani » que nous suffixons par un numéro afin de pouvoir créer plusieurs variantes de peluches gubani.

Pour la texture, nous devrions aussi la copier dans « W:\database\stuff\generique\agents\_textures\accessories », mais nous allons faire plus simple. Nous allons la mettre dans le même dossier que le modèle 3d et la renommer en suivant la même convention : « ge_acc_teddy-gubani_01.png »

Cependant, le moteur de ryzom ne sait afficher que les textures au format ".tga" ou ".dds". TGA est un format brut sans compression ce qui le rend pratique pour l'édition mais moins performant en espace mémoire occupé. le format DDS est un format d'image compressée qui comme le jpep est destructeur. C'est le format utilisé en interne par ryzom pour minimiser l'espace des textures en mémoire. Avec votre éditeur préféré convertissez l'image ".png" en ".tga". C'est elle-ci que nous garderons pour l'édition. Nous allons utiliser l'outil NEL "''tga2dds''" pour générer une image texture au format ".dds" pour le modèle 3d. C'est celle que nous utiliserons dans 3dsmax

tga2dds ge_acc_teddy-gubani_01.tga

Si vous n'avez pas l'outil, vous pouvez garder la version ".tga". Elle fonctionne pour les tests IG.
Dans le dossier soft-toy vous devriez avoir comme résultat :

[[File:03-tuto-peluche-dossier-soft-toy.png|600px]]

== Étape 3 : Nettoyer le modèle 3D sous 3dsmax ==

Le modèle 3D du monstre contient un squelette et toutes ce qu'il faut pour l'animer. Cela n'est pas nécessaire pour un accessoire peluche et surchargerait inutilement le modèle ryzom final. Nous allons dons les supprimer.

[[File:04-tuto-peluche-animation.png|800px]]

Sélectionner le modèle "Gubani" avec la souris. Dans le panneau latéral droit, sélectionner l'onglet "''modify''". Vous devez voir apparaître le mesh dénommé "TR_MO_H12" et dans la pile des "''modifiers''" celui nommé "physique". Nous allons le supprimer

[[File:05-tuto-peluche-physique.png|600px]]

Ensuite nous allons ouvrir l'écran affichant les éléments de la scene via le menu "Tools"=> "New Scene Explorer" et supprimer tous les éléments constituant le squelette du modèle pour ne garder au final que le mesh de l'animal.

[[File:06-tuto-peluche-bones-01.png|800px]]

Au final nous n'avons plus qu'un seul élément dans notre "scène" : le mesh du gubani "TR_MO_H12" :

[[File:07-tuto-peluche-nettoyer-modele.png|800px]]

Dans le panneau latéral droit, nous allons renommer ce mesh en "ge_acc_tedy-gubani_01". C'est ce nom qui sera utilisé par l'export "NEL" pour nommer le fichier "shape" généré lors de l'export.

[[File:07-tuto-peluche-nettoyer-modele-fin.png|800px]]

== Étape 4 : Modifier le mapping des textures du modèle ==

Dans cette partie, nous allons revoir la texturation du modèle 3d. A priori, il faudrait juste changer la texture de base «ju_mo_h12.png» pour pointer sur la notre «ge_acc_teddy-gubani_01.dds» (ou «.tga» à défaut) puis l'adapter comme nous le voulons visuellement. Cependant, cela va être un peu plus compliqué :

Nous allons d'abord ouvrir l'écran "Material Editor" (1), puis sélectionner le seul matériel de la scène (2) en double cliquant dessus. Dans l'écran centrale sélectionnez le noeud dénommé "Map #1 Nel Multi Bitmap" en double cliquant dessus (3). Vous verrez alors s'afficher dans le panneau latéral de droite le détail de ses propriétés (4). Le "Nel Multi Bitmap" permet de définir 8 images différentes. Il ne s'agit pas de multi-texturing, mais de la possibilité de configurer plusieurs images de texture. Seule une est appliqué à un instant donné sur le modèle. Cela est utilisé pour les mobs pour spécifier une texture par écosystème et par certains objets environnementaux pour spécifier une texture différente par saison.

[[File:08-tuto-peluche-texture.png|800px]]
Le slot ID 1 est utilisé pour les textures de l'écosystème tryker, le second (ID 2) pour l'écosystème fyros, le troisième (ID 3) pour l'écosystème zoraï et le quatrième (ID 4) pour l'écosystème des primes racines. Ne cherchez pas de slot matis, en bon esthètes, ils ont compris que la beauté résidait dans la nature zoraï et utilisent donc les textures zoraï pour tous leurs animaux. Notez qu'ici le gubani n'étant présent qu'en jungle et en primes racines, seuls les slots 3 et 4 sont utilisés

Le même système est aussi utilisé pour d'autres objets IG, comme les bâtiments.dans ce cas, les 4 slots correspondent aux quatre saisons. C'est ainsi que l'on peut noter la présence de neige sur certaines bâtisses zoraï en hiver.

[[File:09-tuto-peluche-multi-texture.png]]

De notre coté nous n'allons pas utilisé ce mécanisme. Nous allons donc supprimé le "NEL Multi Bitmap" et le remplacer par un simple "Bitmap" en tirant avec la souris sur la sortie de la "''tTexture 1''" comme le montre l'image ci-dessus. En relâchant la souris, un menu contextuel apparait (2), sélectionner l'entrée "Bitmap" :

[[File:10-tuto-peluche-bitmap.png|800px]]

Puis aller chercher notre image dans "W:databasestuffgeneriqueagents_texturesaccessoriessoft-toyge_acc_teddy-gubani_01.dds" (ou ".tga").

[[File:11-tuto-peluche-bitmap.png|800px]]

Répéter l'opération pour l'autre "Nel Multi Bitmap" qui référence la même image.

== Étape 5 : Mise à échelle du modèle ==

Note modèle 3d est presque prêt à l'emploi. Cependant sa taille ne correspond pas à celle attendue d'une peluche. Si vous utilisez l'outil de mesure de 3dsmax vous verrez que le gubani mesure plus 2m de haut. Le plus simple pour le mettre à la bonne taille est de charger un modèle d'homin afin d'avoir un comparatif visuel et s'assurer que la peluche peut être prise en main.

On va donc insérer temporairement dans notre scène 3dsmax une référence vers un autre modèle 3d en passant par le menu Fichier (1) => References (2) => Xref Scène (3) et en cliquant sur le bouton Add (4) de la fenêtre qui apparait :

[[File:15-tuto-peluche-xref.png|800px]]

Sélectionner alors le modèle d'homin "W:\database\stuff\generique\agents\actors\male\ge_hom_armor02.max" qui devrait apparaître dans votre scène 3d.

[[File:15-tuto-peluche-xref-02.png]]

Mettre a échelle le modèle de gubani et le déplacer via les outils "Scale" et "Move" du menu contextuel apparaissant lorsqu'on clique sur le modèle avec le bouton droit de la souris.

[[File:16-tuto-peluche-echelle.png]]

Une fois la peluche à la bonne échelle, il ne reste plus qu'a supprimer la référence au modèle d'homin en repassant par le menu Fichier => References => Xref Scene.

Repositionner le modèle gubani à l'origine de la scène (x=0, y=0, z=0), car lorsqu'un objet est porté la position (0,0,0) se place au niveau de la main.

== Étape 6 : modifier la texture pour un rendu peluche ==

Au niveau de la texture, pour donner un effet peluche, laissez libre court à votre imagination

[[File:17-tuto-peluche-texture-source.png]]

Ici j'ai édité l'image "ge_acc_teddy-gubani_01.tga" dans l'outil Gimp. J'ai utilisé le filtre "Artistiques > GIMPressioniste" en utilisant le modèle "canvas" pour obtenir un effet trame de tissu.

[[File:17-tuto-peluche-texture-peluche.png]]

Une fois l'image sauvegardée, j'ai re-généré la texture au format ".dds" via la commande :

tga2dds ge_acc_teddy-gubani_01.tga

Voila le résultat obtenu sur le modèle 3d dans 3dsmax :

[[File:18-tuto-peluche-modele3d.png]]

== Étape 7 : Export du shape ==

Il est temps de tester cette peluche en jeu. Pour cela il va falloir exporter le modèle en générant le fichier "shape" utilisé par le moteur Ryzom

Si ce n'est pas déjà je cas, ajouter le bouton ''d'export NEL'' au panneau latéral droit en cliquant sur l'onglet "''utilities''", puis "''More''" et en sélectionnant l'option "''NEL Export''" :

[[File:20-tuto-peluche-export-nel-01.png]]

Ensuite sélectionner le mesh du gubani puis cliquer sur le bouton "Export Model". Il vous faut alors spécifier le dossier où sera crée le fichier "ge_acc_teddy-gubani-01.shape"

[[File:20-tuto-peluche-export-nel-02.png]]

== Étape 8 : Tester la peluche IG ==

Pour bien faire les choses, il faudrait ajouter le ''datasheet'' de la peluche au serveur de jeu et patcher le client. Cette méthode sera détaillée plus loin. Cependant il existe une solution de contournement si vous n'avez pas votre propre serveur de jeu pour réaliser ces opérations.

Il faut savoir qu'une peluche n'est rien d'autre qu'une arme équipée. Ainsi nous pourrions remplacer le modèle de la dague par celui de notre gubani pour le tester sur le serveur officiel. Il existe une astuce simple pour cela. Le client de jeu recherche les modèles et textures dans le dossier "user" avant d'aller voir le dossier "data". Il suffit de copier notre fichier shape et la texture associée dans le dossier "user", puis de renommer le shape du gubani en celui de la dague : "GE_Wea_Dague.shape"

A présent lorsque vous équiperez une dague IG, vous aurez en main notre peluche "gubani".
Pour retrouver la dague d'origine, il suffit de supprimer le fichier shape du dossier "user" :

[[File:21-gubani-peluche-axe.png|400px]]

En réalisant ce test vous pouvez noter une anomalie : la peluche est tenue par le pied, ce qui n'est pas forcément ce que nous voulons

== Étape 9 : orientation et positionnement d'un objet porté ==

Le point de fixation d'un objet tenu en main correspond au point de coordonnée (0,0,0) de l'objet.Son orientation suit la règle suivante :

l'axe X remonte le long de l'avant-bras ;
l'axe Y part depuis le dos de la main vers l'extérieur ;
l'axe Z pointe vers le haut de l'objet tenu fermement en main.

Nous réorientons la peluche gubani dans 3dsmax comme le montre l'image suivante : l'axe X sort du dos du gubani pour remonter le long du bras qui le portera. L'axe Z sort de la main et est donc dans le prolongement de la tête de la peluche :

[[File:22-gubani-peluche-axe-3dsmax.png]]

Après réorientation du modèle gubani et réexportation du shape nous obtenons enfin une peluche qui est tenue par le tronc :

[[File:22-gubani-peluche-axe.png|400px]]

Pour aller plus loin sur les objets portés, je vous conseille de lire ce tutorial : http:''khaganat.net/wikhan/fr:todo:dessiner:creation_d_un_objet_prehensible_en_jeu

== Étape 9 : Créer l’icône pour l'inventaire et la barre d'actions ==

Il faut créer un icône pour l'affichage de l'item peluche gubani dans l'inventaire et dans la barre d'actions.
Cet au icône au format tga doit faire 40x40 pixels avec un fond transparent. Nous le nommerons "icon_teddygubani.tga"

L'icône de 40x40 pixels :

[[File:23-icone-gubani.png|80px]]

Pour des questions de performance, ces icônes ne sont pas stockés individuellement mais regroupés dans une seule image dénommée : "texture_interfaces_v3.tga". Le fichier texte associé dénommé "texture_interfaces_v3.txt" liste les icones présents et leur position dans l'image :

[[File:23-icone-gubani-contexte-txt.png]]

le fichier texte utilise le format suivant pour chaque ligne :

NomFichierIcone u1 v1 u2 v2

Avec :
* u1,v1 la position du point supérieur gauche de l'icône
* u2,v2 la position du coin inférieur droit de l'icône

A la différence des coordonnées en pixels, ces coordonnées qui utilisent la technique du UV Mapping en 3d ont leurs valeurs dans l’intervalle [0 .. 1]. la coordonnée (0,0) correspond au point supérieur gauche de l'image et (1,1) au point inférieur droit de l'image.

Le passage d'un système à l'autre est simple. Soit (x1,y1) la position en pixels du coin haut gauche de notre icône dans l'image globale et (x2,y2) la position du point inférieur droit de l'icône dans l'image, alors :
* u1 = x1 / largeur-image
* v1 = y1 / hauteur-image
* u2 = x2 / largeur-image
* v2 = y2 / hauteur-image

Sachant que la texture "texture_interfaces_v3.tga" fait 1024x1024 pixel, et que dans l'exemple l'icône "icon_teddygubani.tga" se situe à la position (x1=118,y1=798), que le point inférieur gauche étant à la position (x2=157,y2=837), le fichier txt contient donc la ligne :

icon_teddygubani.tga 0.115234375 0.779296875 0.1533203125 0.8173828125

Même si cela peut être ajouté à la main, la bonne méthode et d'utiliser l'outil dédié de NEL ''build_interface'' comme indiqué dans le tutorial https:''khaganat.net/wikhan/fr:todo:dessiner:creer_icone_objet qui recrée la texture globale et le fichier txt à partir d'un dossier contenant tous les icones.

Note: L'ajout de l'icône ne suffit pas, il faut également créer le datasheet de l'objet peluche et spécifier dedans le nom de notre icône à utiliser comme nous le verrons plus loin dans ce tutorial. Au final nous obtenons le résultat suivant IG :

[[File:23-icone-gubani-contexte.png]]

== Etape 11 : créer le fichiers des noms ==

A compléter.

[[File:30-tuto-peluche-txtfile.png]]

== Étape 12 : créer le datasheet ==

A la base, une peluche reste est un objet porté comme une arme. De fait le datasheet de la peluche est trs semblable à celui d'une arme une main, comme l'exemple de la dague ci-dessous.

__icrm1pd.sitem ( datasheet de la dague du réfugié ) :__

<pre>
<?xml version="1.0"?>
<FORM Revision="$Revision: 1.2 $" State="modified">
<PARENT Filename="_c_m1pd.sitem"/>
<STRUCT>
<STRUCT Name="basics">
<ATOM Name="name" Value="refugee dagger"/>
<ATOM Name="origin" Value="refugee"/>
<ATOM Name="Drop or Sell" Value="false"/>
<ATOM Name="CraftPlan" Value="bcrmea06.sbrick"/>
<ATOM Name="Saleable" Value="false"/>
</STRUCT>
<STRUCT Name="3d">
<ATOM Name="shape" Value="GE_Wea_Dague.shape"/>
<ATOM Name="shape_female" Value="GE_Wea_Dague.shape"/>
<ATOM Name="map_variant" Value="Low Quality"/>
<ATOM Name="icon background" Value="BK_generic.tga"/>
<STRUCT Name="fx">
<ATOM Name="Trail" Value="GE_Wea_Dague_trail_00.shape"/>
</STRUCT>
</STRUCT>
</STRUCT>
<STRUCT/>
<STRUCT/>
<STRUCT/>
<STRUCT/>
<LOG>
</FORM>
</pre>

Ce qui change c'est :

* la référénce au shape dans la section "3d"

<ATOM Name="shape" Value="ge_acc_teddy-gubani_01.shape"/>
<ATOM Name="shape_female" Value="ge_acc_teddy-gubani_01.shape"/>

* la référence à l'icone utilisé dans la barre d'état et l'inventaire dans la section "3d"

<ATOM Name="icon" Value="icon_teddygubani.tga"/>
<ATOM Name="icon overlay" Value="icon_teddygubani.tga"/>

* les caractéristiques de base qui diffèrent d'une arme : pas de niveau requis, pas de brique de plan, etc..

<STRUCT Name="basics">
<ATOM Name="name" Value="staff"/>
<ATOM Name="origin" Value="common"/>
<ATOM Name="family" Value="handled item"/>
<ATOM Name="ItemType" Value="Staff"/>
<ATOM Name="Bulk" Value="5"/>
<ATOM Name="RequiredCharacQualityFactor" Value="0"/>
<ATOM Name="RequiredCharacQualityOffset" Value="0"/>
</STRUCT>

Voila donc le datasheet de la peluche gubani que nous nommerons "teddygubani.sitem" :

<pre>
<?xml version="1.0"?>
<FORM Revision="$Revision: 1.7 $" State="modified">
<PARENT Filename="_c_m1pd.sitem"/>
<STRUCT>
<STRUCT Name="basics">
<ATOM Name="name" Value="staff"/>
<ATOM Name="origin" Value="common"/>
<ATOM Name="family" Value="handled item"/>
<ATOM Name="ItemType" Value="Staff"/>
<ATOM Name="Bulk" Value="5"/>
<ATOM Name="RequiredCharacQualityFactor" Value="0"/>
<ATOM Name="RequiredCharacQualityOffset" Value="0"/>
</STRUCT>
<STRUCT Name="3d">
<ATOM Name="shape" Value="ge_acc_teddy-gubani_01.shape"/>
<ATOM Name="shape_female" Value="ge_acc_teddy-gubani_01.shape"/>
<ATOM Name="map_variant" Value="Low Quality"/>
<ATOM Name="icon" Value="icon_teddygubani.tga"/>
<ATOM Name="icon background" Value="BK_generic.tga"/>
<ATOM Name="icon overlay" Value="icon_teddygubani.tga"/>
<STRUCT Name="fx">
<ATOM Name="Trail" Value="GE_Wea_Dague_trail_00.shape"/>
</STRUCT>
</STRUCT>
</STRUCT>
<STRUCT/>
<STRUCT/>
<STRUCT/>
<STRUCT/>
<LOG></LOG>
</FORM>
</pre>

== Étape 13 : Déployer la peluche sur le serveur et le client de jeu ==

Afin de déployer la peluche en jeu la méthode officielle consiste à utiliser la pipeline "build_gamedata" (cf. https:''ryzomcore.atlassian.net/wiki/display/RC/Gamedata+Build+Pipeline). Je vais vous proposer une méthode différente, où les opérations seront effectués à la mains, mais uniquement celles nécessaires à notre peluche :

Nous avons besoin des fichiers suivants :

* teddygubani.sitem ( le datasheet de la peluche gunabi )
* ge_acc_teddy-gubani_01.shape ( le modèle 3d NEL de la peluche )
* ge_acc_teddy-gubani_01.dds ( la texture du modèle 3d )

De plus le déploiement de cette peluche va impacter les fichiers suivants :

* les fichiers "*.packed_sheets" utilisée par le serveur et le client qui sont une version compilé des datasheets
* le fichier "sheet_id.bin" qui est un index de tous les datasheets utilisés par le jeu
* le fichier "visual_slot.tab" qui liste les éléments affichables coté client

Pour bien faire les choses, nous allons également créer un fichier "soft-toy.bnp" qui contiendra les shapes et les textures de toutes les futures peluches.

Pour la suite des opérations nous partons du principe que notre serveur de jeu fonctionne sous linux, et que les variables d'envrionnement suivantes sont définies :

* LEVELDESIGNPATH pointe sur le dossier des datas du level design
* RYZOM_HOME sur l'installation des sources du serveur

=== Ajout du datasheet "teddygubani.sitem au serveur ===

Coté serveur nous allons créer un dossier dédié pour les datasheets des peluches et y placer celui du gubani :

$ mkdir $LEVELDESIGNPATH/leveldesign/game_element/sitem/soft-toy
$ cp teddygubani.sitem $LEVELDESIGNPATH/leveldesign/game_element/sitem/soft-toy

=== Nettoyages préalables ===

=== Re-générer le fichier "sheet_id.bin" ===

La première étape consiste à regénérer le fichier d'index des datasheet via la commande "make_sheet_id". Il reprend le fichier d'index existant et va le compléter avec les datasheets du dossier $RYZOM_LEVELPATH/leveldesign/game_element/sitem/soft-toy c'est-à-dire les datasheets de nos peluches

$ make_sheet_id -o$LEVELDESIGNPATH/leveldesign/Game_elem/sheet_id.bin $LEVELDESIGNPATH/leveldesign/game_element/sitem/soft-toy

=== Re-générer les "*.packed_sheets" et "visual_slot.tab" ===

Il faut regénérer les "*.packed_sheets".Ce sont les versions pré-compilées des datasheets :

$ sheets_packer

Cette commande va également re-générer le fichier visual_slot.tab

=== Copier les fichiers nécessaires coté client ===

* Nous copions le fichier "visual_slot.tab" généré dans le dossier courant dans le dossier "user" du client de jeu
* Nous copions le fichier $LEVELDESIGNPATH/leveldesign/Game_elem/sheet_id.bin dans le dossier "user" du client de jeu
* Nous remplaçons les fichiers packet_sheets du dossier "data" du client par ceux générés ici $RYZOM_HOME/code/ryzom/client/data/*.packed_sheets par la commande ''sheets_packer''

=== Créer un bnp pour le modèle de la peluche ===

Pour finir il faut copier le shape et la texture de la peluche dans le dossier "data" du client.
Cependant pour bien faire les choses, autant créer un fichier ".bnp" dédié.
Un fichier ".bnp" est une sorte de zip regroupant les différents fichiers shape, dds, txt, ou autres par thème.

Créer on dossier "soft-toy", copions y tous les shapes et textures de nos peluche, à savoir pour le moment "ge_acc_teddy-gubani_01.shape" et "ge_acc_teddy-gubani_01.dds" et créons un fichier BNP pour les contenur

bnp_make /p soft-toy

La commande va créer un fichier "soft-toy,bnp" qui contiendra nos deux fichiers. A présent il faut le copier dans le dossier "data" du client.

=== Tester IG ===

Relancer le serveur avec la commande ''shard start'' puis connectez vous avec votre client.

Si tout c'est bien déroulé, en lançant votre client de jeu, vous pouvez créer une peluche dans votre inventaire avec la commande :

/a createItemInBag teddygubani 1 5

{{tag>Tag_a_ajouter}}

FR Peluche

2014-07-25T20:55:28Z

Madi: /* Ajout du datasheet "teddygubani.sitem au serveur */

= Objets du mois : Déployer en Jeu des peluches « mobs d'atys » =

[[File:00-tuto-peluche.png|300px]]

Le but de ce tutorial est de montrer comment réaliser des peluches basées sur les modèles des animaux atysiens.

Pré-requis pour modéliser uniquement la peluche :

* Avoir installé les assets ryzom et configuré correctement les lecteurs (les outils NEL s'attendent à trouver les données des assets dans le dossier ( W:database ).
* Avoir installé 3DSMax et configuré le plugin NEL ( Attention le plugin ne fonctionne qu'avec les version 32bits de 3DSmax et de la versions 9 à la version 2012).
* Conseillé mais non nécessaire : avoir installé l'outil NEL "''tga2dds.exe''".

Pré-requis pour déployer la peluche sur un serveur de jeu :

* Avoir compilé et installé un serveur de jeu et configuré un client pour l'utiliser

Note : il est possible de tester cette peluche IG sans disposer d'un serveur de jeu via une astuce qui sera expliquée plus loin dans ce tutoriel.

Quelques liens utiles pour ces pré-requis :

* Liens de téléchargement des assets et outils : https:''ryzomcore.atlassian.net/wiki/display/RC/Downloads+for+Windows
* Configuration des lecteurs :https:''ryzomcore.atlassian.net/wiki/display/RC/How+to+set+up+the+Build+Pipeline
* Installation du plugin NEL de 3dsmax :https:''ryzomcore.atlassian.net/wiki/display/RC/Installing+the+Max+Plugins

== Étape 1: choisir le modèle qui servira pour notre peluche ==

L'ensemble des modèles 3d de la faune de ryzom sont regroupés dans le dossier « W:\database\stuff\tryker\agents\monsters » par famille de créature. Dans ce tutorial nous allons utiliser le modèle du « Gubani » qui est situé dans le sous-dossier des créatures « chevalines » pour réaliser notre peluche :

W:\database\stuff\tryker\agents\monsters\cheval\h12tr_mo_h12.max

[[File:01-tuto-peluche-dossiers-mobs.png|600px]]

== Étape 2 : Reprendre le modèle et se créer un dossier dédié pour travailler ==

Dans 3dsmax ouvrir le fichier « W:\database\stuff\tryker\agents\monsters\cheval\h12tr_mo_h12.max »

Nous consultons la liste des fichiers utilisés par le modèle, notamment les textures via le menu => «Fichier» => « Manage » => « Asset Tracking ». On note deux fichiers :

* Le modèle 3d : « tr_mo_h12.max »
* La texture du gubani « ju_mo_h12.png »

[[File:02-tuto-peluche-asset-tracking.png|800px]]

Le but ici étant de déployer des peluches monstres pour les objets du mois, nous allons donc se créer un dossier dédié pour nos futures peluches et respecter les conventions de nomination de ryzom.

Nous allons donc créer un dossier « soft-toy » dans le dossier « W:\database\stuff\generique\agents\accessories ». Nous y sauvegarderons notre modèle en le renommant : ge_acc_teddy-gubani_01.max

* le premier préfixe «ge_» du nom de fichier est pour spécifier l'écosystème, ici __gé__nérique (tr : tryker, fy : fyros, etc...)
* le second préfixe du nom du fichier est pour spécifier le type de modèle ( hom : homin masculin, mo : monstre, wea weapon, etc... ), ici « acc » pour __acc__essoire.
* Enfin le nom de notre modèle « teddy-gubani » que nous suffixons par un numéro afin de pouvoir créer plusieurs variantes de peluches gubani.

Pour la texture, nous devrions aussi la copier dans « W:\database\stuff\generique\agents\_textures\accessories », mais nous allons faire plus simple. Nous allons la mettre dans le même dossier que le modèle 3d et la renommer en suivant la même convention : « ge_acc_teddy-gubani_01.png »

Cependant, le moteur de ryzom ne sait afficher que les textures au format ".tga" ou ".dds". TGA est un format brut sans compression ce qui le rend pratique pour l'édition mais moins performant en espace mémoire occupé. le format DDS est un format d'image compressée qui comme le jpep est destructeur. C'est le format utilisé en interne par ryzom pour minimiser l'espace des textures en mémoire. Avec votre éditeur préféré convertissez l'image ".png" en ".tga". C'est elle-ci que nous garderons pour l'édition. Nous allons utiliser l'outil NEL "''tga2dds''" pour générer une image texture au format ".dds" pour le modèle 3d. C'est celle que nous utiliserons dans 3dsmax

tga2dds ge_acc_teddy-gubani_01.tga

Si vous n'avez pas l'outil, vous pouvez garder la version ".tga". Elle fonctionne pour les tests IG.
Dans le dossier soft-toy vous devriez avoir comme résultat :

[[File:03-tuto-peluche-dossier-soft-toy.png|600px]]

== Étape 3 : Nettoyer le modèle 3D sous 3dsmax ==

Le modèle 3D du monstre contient un squelette et toutes ce qu'il faut pour l'animer. Cela n'est pas nécessaire pour un accessoire peluche et surchargerait inutilement le modèle ryzom final. Nous allons dons les supprimer.

[[File:04-tuto-peluche-animation.png|800px]]

Sélectionner le modèle "Gubani" avec la souris. Dans le panneau latéral droit, sélectionner l'onglet "''modify''". Vous devez voir apparaître le mesh dénommé "TR_MO_H12" et dans la pile des "''modifiers''" celui nommé "physique". Nous allons le supprimer

[[File:05-tuto-peluche-physique.png|600px]]

Ensuite nous allons ouvrir l'écran affichant les éléments de la scene via le menu "Tools"=> "New Scene Explorer" et supprimer tous les éléments constituant le squelette du modèle pour ne garder au final que le mesh de l'animal.

[[File:06-tuto-peluche-bones-01.png|800px]]

Au final nous n'avons plus qu'un seul élément dans notre "scène" : le mesh du gubani "TR_MO_H12" :

[[File:07-tuto-peluche-nettoyer-modele.png|800px]]

Dans le panneau latéral droit, nous allons renommer ce mesh en "ge_acc_tedy-gubani_01". C'est ce nom qui sera utilisé par l'export "NEL" pour nommer le fichier "shape" généré lors de l'export.

[[File:07-tuto-peluche-nettoyer-modele-fin.png|800px]]

== Étape 4 : Modifier le mapping des textures du modèle ==

Dans cette partie, nous allons revoir la texturation du modèle 3d. A priori, il faudrait juste changer la texture de base «ju_mo_h12.png» pour pointer sur la notre «ge_acc_teddy-gubani_01.dds» (ou «.tga» à défaut) puis l'adapter comme nous le voulons visuellement. Cependant, cela va être un peu plus compliqué :

Nous allons d'abord ouvrir l'écran "Material Editor" (1), puis sélectionner le seul matériel de la scène (2) en double cliquant dessus. Dans l'écran centrale sélectionnez le noeud dénommé "Map #1 Nel Multi Bitmap" en double cliquant dessus (3). Vous verrez alors s'afficher dans le panneau latéral de droite le détail de ses propriétés (4). Le "Nel Multi Bitmap" permet de définir 8 images différentes. Il ne s'agit pas de multi-texturing, mais de la possibilité de configurer plusieurs images de texture. Seule une est appliqué à un instant donné sur le modèle. Cela est utilisé pour les mobs pour spécifier une texture par écosystème et par certains objets environnementaux pour spécifier une texture différente par saison.

[[File:08-tuto-peluche-texture.png|800px]]
Le slot ID 1 est utilisé pour les textures de l'écosystème tryker, le second (ID 2) pour l'écosystème fyros, le troisième (ID 3) pour l'écosystème zoraï et le quatrième (ID 4) pour l'écosystème des primes racines. Ne cherchez pas de slot matis, en bon esthètes, ils ont compris que la beauté résidait dans la nature zoraï et utilisent donc les textures zoraï pour tous leurs animaux. Notez qu'ici le gubani n'étant présent qu'en jungle et en primes racines, seuls les slots 3 et 4 sont utilisés

Le même système est aussi utilisé pour d'autres objets IG, comme les bâtiments.dans ce cas, les 4 slots correspondent aux quatre saisons. C'est ainsi que l'on peut noter la présence de neige sur certaines bâtisses zoraï en hiver.

[[File:09-tuto-peluche-multi-texture.png]]

De notre coté nous n'allons pas utilisé ce mécanisme. Nous allons donc supprimé le "NEL Multi Bitmap" et le remplacer par un simple "Bitmap" en tirant avec la souris sur la sortie de la "''tTexture 1''" comme le montre l'image ci-dessus. En relâchant la souris, un menu contextuel apparait (2), sélectionner l'entrée "Bitmap" :

[[File:10-tuto-peluche-bitmap.png|800px]]

Puis aller chercher notre image dans "W:databasestuffgeneriqueagents_texturesaccessoriessoft-toyge_acc_teddy-gubani_01.dds" (ou ".tga").

[[File:11-tuto-peluche-bitmap.png|800px]]

Répéter l'opération pour l'autre "Nel Multi Bitmap" qui référence la même image.

== Étape 5 : Mise à échelle du modèle ==

Note modèle 3d est presque prêt à l'emploi. Cependant sa taille ne correspond pas à celle attendue d'une peluche. Si vous utilisez l'outil de mesure de 3dsmax vous verrez que le gubani mesure plus 2m de haut. Le plus simple pour le mettre à la bonne taille est de charger un modèle d'homin afin d'avoir un comparatif visuel et s'assurer que la peluche peut être prise en main.

On va donc insérer temporairement dans notre scène 3dsmax une référence vers un autre modèle 3d en passant par le menu Fichier (1) => References (2) => Xref Scène (3) et en cliquant sur le bouton Add (4) de la fenêtre qui apparait :

[[File:15-tuto-peluche-xref.png|800px]]

Sélectionner alors le modèle d'homin "W:\database\stuff\generique\agents\actors\male\ge_hom_armor02.max" qui devrait apparaître dans votre scène 3d.

[[File:15-tuto-peluche-xref-02.png]]

Mettre a échelle le modèle de gubani et le déplacer via les outils "Scale" et "Move" du menu contextuel apparaissant lorsqu'on clique sur le modèle avec le bouton droit de la souris.

[[File:16-tuto-peluche-echelle.png]]

Une fois la peluche à la bonne échelle, il ne reste plus qu'a supprimer la référence au modèle d'homin en repassant par le menu Fichier => References => Xref Scene.

Repositionner le modèle gubani à l'origine de la scène (x=0, y=0, z=0), car lorsqu'un objet est porté la position (0,0,0) se place au niveau de la main.

== Étape 6 : modifier la texture pour un rendu peluche ==

Au niveau de la texture, pour donner un effet peluche, laissez libre court à votre imagination

[[File:17-tuto-peluche-texture-source.png]]

Ici j'ai édité l'image "ge_acc_teddy-gubani_01.tga" dans l'outil Gimp. J'ai utilisé le filtre "Artistiques > GIMPressioniste" en utilisant le modèle "canvas" pour obtenir un effet trame de tissu.

[[File:17-tuto-peluche-texture-peluche.png]]

Une fois l'image sauvegardée, j'ai re-généré la texture au format ".dds" via la commande :

tga2dds ge_acc_teddy-gubani_01.tga

Voila le résultat obtenu sur le modèle 3d dans 3dsmax :

[[File:18-tuto-peluche-modele3d.png]]

== Étape 7 : Export du shape ==

Il est temps de tester cette peluche en jeu. Pour cela il va falloir exporter le modèle en générant le fichier "shape" utilisé par le moteur Ryzom

Si ce n'est pas déjà je cas, ajouter le bouton ''d'export NEL'' au panneau latéral droit en cliquant sur l'onglet "''utilities''", puis "''More''" et en sélectionnant l'option "''NEL Export''" :

[[File:20-tuto-peluche-export-nel-01.png]]

Ensuite sélectionner le mesh du gubani puis cliquer sur le bouton "Export Model". Il vous faut alors spécifier le dossier où sera crée le fichier "ge_acc_teddy-gubani-01.shape"

[[File:20-tuto-peluche-export-nel-02.png]]

== Étape 8 : Tester la peluche IG ==

Pour bien faire les choses, il faudrait ajouter le ''datasheet'' de la peluche au serveur de jeu et patcher le client. Cette méthode sera détaillée plus loin. Cependant il existe une solution de contournement si vous n'avez pas votre propre serveur de jeu pour réaliser ces opérations.

Il faut savoir qu'une peluche n'est rien d'autre qu'une arme équipée. Ainsi nous pourrions remplacer le modèle de la dague par celui de notre gubani pour le tester sur le serveur officiel. Il existe une astuce simple pour cela. Le client de jeu recherche les modèles et textures dans le dossier "user" avant d'aller voir le dossier "data". Il suffit de copier notre fichier shape et la texture associée dans le dossier "user", puis de renommer le shape du gubani en celui de la dague : "GE_Wea_Dague.shape"

A présent lorsque vous équiperez une dague IG, vous aurez en main notre peluche "gubani".
Pour retrouver la dague d'origine, il suffit de supprimer le fichier shape du dossier "user" :

[[File:21-gubani-peluche-axe.png|400px]]

En réalisant ce test vous pouvez noter une anomalie : la peluche est tenue par le pied, ce qui n'est pas forcément ce que nous voulons

== Étape 9 : orientation et positionnement d'un objet porté ==

Le point de fixation d'un objet tenu en main correspond au point de coordonnée (0,0,0) de l'objet.Son orientation suit la règle suivante :

l'axe X remonte le long de l'avant-bras ;
l'axe Y part depuis le dos de la main vers l'extérieur ;
l'axe Z pointe vers le haut de l'objet tenu fermement en main.

Nous réorientons la peluche gubani dans 3dsmax comme le montre l'image suivante : l'axe X sort du dos du gubani pour remonter le long du bras qui le portera. L'axe Z sort de la main et est donc dans le prolongement de la tête de la peluche :

[[File:22-gubani-peluche-axe-3dsmax.png]]

Après réorientation du modèle gubani et réexportation du shape nous obtenons enfin une peluche qui est tenue par le tronc :

[[File:22-gubani-peluche-axe.png|400px]]

Pour aller plus loin sur les objets portés, je vous conseille de lire ce tutorial : http:''khaganat.net/wikhan/fr:todo:dessiner:creation_d_un_objet_prehensible_en_jeu

== Étape 9 : Créer l’icône pour l'inventaire et la barre d'actions ==

Il faut créer un icône pour l'affichage de l'item peluche gubani dans l'inventaire et dans la barre d'actions.
Cet au icône au format tga doit faire 40x40 pixels avec un fond transparent. Nous le nommerons "icon_teddygubani.tga"

L'icône de 40x40 pixels :

[[File:23-icone-gubani.png|80px]]

Pour des questions de performance, ces icônes ne sont pas stockés individuellement mais regroupés dans une seule image dénommée : "texture_interfaces_v3.tga". Le fichier texte associé dénommé "texture_interfaces_v3.txt" liste les icones présents et leur position dans l'image :

[[File:23-icone-gubani-contexte-txt.png]]

le fichier texte utilise le format suivant pour chaque ligne :

NomFichierIcone u1 v1 u2 v2

Avec :
* u1,v1 la position du point supérieur gauche de l'icône
* u2,v2 la position du coin inférieur droit de l'icône

A la différence des coordonnées en pixels, ces coordonnées qui utilisent la technique du UV Mapping en 3d ont leurs valeurs dans l’intervalle [0 .. 1]. la coordonnée (0,0) correspond au point supérieur gauche de l'image et (1,1) au point inférieur droit de l'image.

Le passage d'un système à l'autre est simple. Soit (x1,y1) la position en pixels du coin haut gauche de notre icône dans l'image globale et (x2,y2) la position du point inférieur droit de l'icône dans l'image, alors :
* u1 = x1 / largeur-image
* v1 = y1 / hauteur-image
* u2 = x2 / largeur-image
* v2 = y2 / hauteur-image

Sachant que la texture "texture_interfaces_v3.tga" fait 1024x1024 pixel, et que dans l'exemple l'icône "icon_teddygubani.tga" se situe à la position (x1=118,y1=798), que le point inférieur gauche étant à la position (x2=157,y2=837), le fichier txt contient donc la ligne :

icon_teddygubani.tga 0.115234375 0.779296875 0.1533203125 0.8173828125

Même si cela peut être ajouté à la main, la bonne méthode et d'utiliser l'outil dédié de NEL ''build_interface'' comme indiqué dans le tutorial https:''khaganat.net/wikhan/fr:todo:dessiner:creer_icone_objet qui recrée la texture globale et le fichier txt à partir d'un dossier contenant tous les icones.

Note: L'ajout de l'icône ne suffit pas, il faut également créer le datasheet de l'objet peluche et spécifier dedans le nom de notre icône à utiliser comme nous le verrons plus loin dans ce tutorial. Au final nous obtenons le résultat suivant IG :

[[File:23-icone-gubani-contexte.png]]

== Etape 11 : créer le fichiers des noms ==

A compléter.

[[File:30-tuto-peluche-txtfile.png]]

== Étape 12 : créer le datasheet ==

A la base, une peluche reste est un objet porté comme une arme. De fait le datasheet de la peluche est trs semblable à celui d'une arme une main, comme l'exemple de la dague ci-dessous.

__icrm1pd.sitem ( datasheet de la dague du réfugié ) :__

<pre>
<?xml version="1.0"?>
<FORM Revision="$Revision: 1.2 $" State="modified">
<PARENT Filename="_c_m1pd.sitem"/>
<STRUCT>
<STRUCT Name="basics">
<ATOM Name="name" Value="refugee dagger"/>
<ATOM Name="origin" Value="refugee"/>
<ATOM Name="Drop or Sell" Value="false"/>
<ATOM Name="CraftPlan" Value="bcrmea06.sbrick"/>
<ATOM Name="Saleable" Value="false"/>
</STRUCT>
<STRUCT Name="3d">
<ATOM Name="shape" Value="GE_Wea_Dague.shape"/>
<ATOM Name="shape_female" Value="GE_Wea_Dague.shape"/>
<ATOM Name="map_variant" Value="Low Quality"/>
<ATOM Name="icon background" Value="BK_generic.tga"/>
<STRUCT Name="fx">
<ATOM Name="Trail" Value="GE_Wea_Dague_trail_00.shape"/>
</STRUCT>
</STRUCT>
</STRUCT>
<STRUCT/>
<STRUCT/>
<STRUCT/>
<STRUCT/>
<LOG>
</FORM>
</pre>

Ce qui change c'est :

* la référénce au shape dans la section "3d"

<ATOM Name="shape" Value="ge_acc_teddy-gubani_01.shape"/>
<ATOM Name="shape_female" Value="ge_acc_teddy-gubani_01.shape"/>

* la référence à l'icone utilisé dans la barre d'état et l'inventaire dans la section "3d"

<ATOM Name="icon" Value="icon_teddygubani.tga"/>
<ATOM Name="icon overlay" Value="icon_teddygubani.tga"/>

* les caractéristiques de base qui diffèrent d'une arme : pas de niveau requis, pas de brique de plan, etc..

<STRUCT Name="basics">
<ATOM Name="name" Value="staff"/>
<ATOM Name="origin" Value="common"/>
<ATOM Name="family" Value="handled item"/>
<ATOM Name="ItemType" Value="Staff"/>
<ATOM Name="Bulk" Value="5"/>
<ATOM Name="RequiredCharacQualityFactor" Value="0"/>
<ATOM Name="RequiredCharacQualityOffset" Value="0"/>
</STRUCT>

Voila donc le datasheet de la peluche gubani que nous nommerons "teddygubani.sitem" :

<pre>
<?xml version="1.0"?>
<FORM Revision="$Revision: 1.7 $" State="modified">
<PARENT Filename="_c_m1pd.sitem"/>
<STRUCT>
<STRUCT Name="basics">
<ATOM Name="name" Value="staff"/>
<ATOM Name="origin" Value="common"/>
<ATOM Name="family" Value="handled item"/>
<ATOM Name="ItemType" Value="Staff"/>
<ATOM Name="Bulk" Value="5"/>
<ATOM Name="RequiredCharacQualityFactor" Value="0"/>
<ATOM Name="RequiredCharacQualityOffset" Value="0"/>
</STRUCT>
<STRUCT Name="3d">
<ATOM Name="shape" Value="ge_acc_teddy-gubani_01.shape"/>
<ATOM Name="shape_female" Value="ge_acc_teddy-gubani_01.shape"/>
<ATOM Name="map_variant" Value="Low Quality"/>
<ATOM Name="icon" Value="icon_teddygubani.tga"/>
<ATOM Name="icon background" Value="BK_generic.tga"/>
<ATOM Name="icon overlay" Value="icon_teddygubani.tga"/>
<STRUCT Name="fx">
<ATOM Name="Trail" Value="GE_Wea_Dague_trail_00.shape"/>
</STRUCT>
</STRUCT>
</STRUCT>
<STRUCT/>
<STRUCT/>
<STRUCT/>
<STRUCT/>
<LOG></LOG>
</FORM>
</pre>

== Étape 13 : Déployer la peluche sur le serveur et le client de jeu ==

Afin de déployer la peluche en jeu la méthode officielle consiste à utiliser la pipeline "build_gamedata" (cf. https:''ryzomcore.atlassian.net/wiki/display/RC/Gamedata+Build+Pipeline). Je vais vous proposer une méthode différente, où les opérations seront effectués à la mains, mais uniquement celles nécessaires à notre peluche :

Nous avons besoin des fichiers suivants :

* teddygubani.sitem ( le datasheet de la peluche gunabi )
* ge_acc_teddy-gubani_01.shape ( le modèle 3d NEL de la peluche )
* ge_acc_teddy-gubani_01.dds ( la texture du modèle 3d )

De plus le déploiement de cette peluche va impacter les fichiers suivants :

* les fichiers "*.packed_sheets" utilisée par le serveur et le client qui sont une version compilé des datasheets
* le fichier "sheet_id.bin" qui est un index de tous les datasheets utilisés par le jeu
* le fichier "visual_slot.tab" qui liste les éléments affichables coté client

Pour bien faire les choses, nous allons également créer un fichier "soft-toy.bnp" qui contiendra les shapes et les textures de toutes les futures peluches.

Pour la suite des opérations nous partons du principe que notre serveur de jeu fonctionne sous linux, et que les variables d'envrionnement suivantes sont définies :

* LEVELDESIGNPATH pointe sur le dossier des datas du level design
* RYZOM_HOME sur l'installation des sources du serveur

=== Ajout du datasheet "teddygubani.sitem au serveur ===

Coté serveur nous allons créer un dossier dédié pour les datasheets des peluches et y placer celui du gubani :

$ mkdir $LEVELDESIGNPATH/leveldesign/game_element/sitem/soft-toy
$ cp teddygubani.sitem $LEVELDESIGNPATH/leveldesign/game_element/sitem/soft-toy

=== Nettoyages préalables ===

=== Re-générer le fichier "sheet_id.bin" ===

La première étape consiste à regénérer le fichier d'index des datasheet via la commande "make_sheet_id". Il reprend le fichier d'index existant et va le compléter avec les datasheets du dossier $RYZOM_LEVELPATH/leveldesign/game_element/sitem/soft-toy c'est-à-dire les datasheets de nos peluches

$ make_sheet_id -o$LEVELDESIGNPATH/leveldesign/Game_elem/sheet_id.bin $LEVELDESIGNPATH/leveldesign/game_element/sitem/soft-toy

=== Re-générer les "*.packed_sheets" et "visual_slot.tab" ===

Il faut regénérer les "*.packed_sheets".Ce sont les versions pré-compilées des datasheets :

$ sheets_packer

Cette commande va également re-générer le fichier visual_slot.tab

=== Copier les fichiers nécessaires coté client ===

* Nous copions le fichier "visual_slot.tab" généré dans le dossier courant dans le dossier "user" du client de jeu
* Nous copions le fichier $LEVELDESIGNPATH/leveldesign/Game_elem/sheet_id.bin dans le dossier "user" du client de jeu
* Nous remplaçons les fichiers packet_sheets du dossier "data" du client par ceux générés ici $RYZOM_HOME/code/ryzom/client/data/*.packed_sheets par la commande ''sheets_packer''

=== Créer un bnp pour le modèle de la peluche ===

Pour finir il faut copier le shape et la texture de la peluche dans le dossier "data" du client.
Cependant pour bien faire les choses, autant créer un fichier ".bnp" dédié.
Un fichier ".bnp" est une sorte de zip regroupant les différents fichiers shape, dds, txt, ou autres par thème.

Créer on dossier "soft-toy", copions y tous les shapes et textures de nos peluche, à savoir pour le moment "ge_acc_teddy-gubani_01.shape" et "ge_acc_teddy-gubani_01.dds" et créons un fichier BNP pour les contenur

bnp_make /p soft-toy

La commande va créer un fichier "soft-toy,bnp" qui contiendra nos deux fichiers. A présent il faut le copier dans le dossier "data" du client.

=== Tester IG ===

Relancer le serveur avec la commande ''shard start'' puis connectez vous avec votre client.

Si tout c'est bien déroulé, en lançant votre client de jeu, vous pouvez créer une peluche dans votre inventaire avec la commande :

/a createItemInBag teddygubani 1 5

{{tag>Tag_a_ajouter}}

FR Peluche

2014-07-25T20:53:42Z

Madi: /* Étape 12 : créer le datasheet */

= Objets du mois : Déployer en Jeu des peluches « mobs d'atys » =

[[File:00-tuto-peluche.png|300px]]

Le but de ce tutorial est de montrer comment réaliser des peluches basées sur les modèles des animaux atysiens.

Pré-requis pour modéliser uniquement la peluche :

* Avoir installé les assets ryzom et configuré correctement les lecteurs (les outils NEL s'attendent à trouver les données des assets dans le dossier ( W:database ).
* Avoir installé 3DSMax et configuré le plugin NEL ( Attention le plugin ne fonctionne qu'avec les version 32bits de 3DSmax et de la versions 9 à la version 2012).
* Conseillé mais non nécessaire : avoir installé l'outil NEL "''tga2dds.exe''".

Pré-requis pour déployer la peluche sur un serveur de jeu :

* Avoir compilé et installé un serveur de jeu et configuré un client pour l'utiliser

Note : il est possible de tester cette peluche IG sans disposer d'un serveur de jeu via une astuce qui sera expliquée plus loin dans ce tutoriel.

Quelques liens utiles pour ces pré-requis :

* Liens de téléchargement des assets et outils : https:''ryzomcore.atlassian.net/wiki/display/RC/Downloads+for+Windows
* Configuration des lecteurs :https:''ryzomcore.atlassian.net/wiki/display/RC/How+to+set+up+the+Build+Pipeline
* Installation du plugin NEL de 3dsmax :https:''ryzomcore.atlassian.net/wiki/display/RC/Installing+the+Max+Plugins

== Étape 1: choisir le modèle qui servira pour notre peluche ==

L'ensemble des modèles 3d de la faune de ryzom sont regroupés dans le dossier « W:\database\stuff\tryker\agents\monsters » par famille de créature. Dans ce tutorial nous allons utiliser le modèle du « Gubani » qui est situé dans le sous-dossier des créatures « chevalines » pour réaliser notre peluche :

W:\database\stuff\tryker\agents\monsters\cheval\h12tr_mo_h12.max

[[File:01-tuto-peluche-dossiers-mobs.png|600px]]

== Étape 2 : Reprendre le modèle et se créer un dossier dédié pour travailler ==

Dans 3dsmax ouvrir le fichier « W:\database\stuff\tryker\agents\monsters\cheval\h12tr_mo_h12.max »

Nous consultons la liste des fichiers utilisés par le modèle, notamment les textures via le menu => «Fichier» => « Manage » => « Asset Tracking ». On note deux fichiers :

* Le modèle 3d : « tr_mo_h12.max »
* La texture du gubani « ju_mo_h12.png »

[[File:02-tuto-peluche-asset-tracking.png|800px]]

Le but ici étant de déployer des peluches monstres pour les objets du mois, nous allons donc se créer un dossier dédié pour nos futures peluches et respecter les conventions de nomination de ryzom.

Nous allons donc créer un dossier « soft-toy » dans le dossier « W:\database\stuff\generique\agents\accessories ». Nous y sauvegarderons notre modèle en le renommant : ge_acc_teddy-gubani_01.max

* le premier préfixe «ge_» du nom de fichier est pour spécifier l'écosystème, ici __gé__nérique (tr : tryker, fy : fyros, etc...)
* le second préfixe du nom du fichier est pour spécifier le type de modèle ( hom : homin masculin, mo : monstre, wea weapon, etc... ), ici « acc » pour __acc__essoire.
* Enfin le nom de notre modèle « teddy-gubani » que nous suffixons par un numéro afin de pouvoir créer plusieurs variantes de peluches gubani.

Pour la texture, nous devrions aussi la copier dans « W:\database\stuff\generique\agents\_textures\accessories », mais nous allons faire plus simple. Nous allons la mettre dans le même dossier que le modèle 3d et la renommer en suivant la même convention : « ge_acc_teddy-gubani_01.png »

Cependant, le moteur de ryzom ne sait afficher que les textures au format ".tga" ou ".dds". TGA est un format brut sans compression ce qui le rend pratique pour l'édition mais moins performant en espace mémoire occupé. le format DDS est un format d'image compressée qui comme le jpep est destructeur. C'est le format utilisé en interne par ryzom pour minimiser l'espace des textures en mémoire. Avec votre éditeur préféré convertissez l'image ".png" en ".tga". C'est elle-ci que nous garderons pour l'édition. Nous allons utiliser l'outil NEL "''tga2dds''" pour générer une image texture au format ".dds" pour le modèle 3d. C'est celle que nous utiliserons dans 3dsmax

tga2dds ge_acc_teddy-gubani_01.tga

Si vous n'avez pas l'outil, vous pouvez garder la version ".tga". Elle fonctionne pour les tests IG.
Dans le dossier soft-toy vous devriez avoir comme résultat :

[[File:03-tuto-peluche-dossier-soft-toy.png|600px]]

== Étape 3 : Nettoyer le modèle 3D sous 3dsmax ==

Le modèle 3D du monstre contient un squelette et toutes ce qu'il faut pour l'animer. Cela n'est pas nécessaire pour un accessoire peluche et surchargerait inutilement le modèle ryzom final. Nous allons dons les supprimer.

[[File:04-tuto-peluche-animation.png|800px]]

Sélectionner le modèle "Gubani" avec la souris. Dans le panneau latéral droit, sélectionner l'onglet "''modify''". Vous devez voir apparaître le mesh dénommé "TR_MO_H12" et dans la pile des "''modifiers''" celui nommé "physique". Nous allons le supprimer

[[File:05-tuto-peluche-physique.png|600px]]

Ensuite nous allons ouvrir l'écran affichant les éléments de la scene via le menu "Tools"=> "New Scene Explorer" et supprimer tous les éléments constituant le squelette du modèle pour ne garder au final que le mesh de l'animal.

[[File:06-tuto-peluche-bones-01.png|800px]]

Au final nous n'avons plus qu'un seul élément dans notre "scène" : le mesh du gubani "TR_MO_H12" :

[[File:07-tuto-peluche-nettoyer-modele.png|800px]]

Dans le panneau latéral droit, nous allons renommer ce mesh en "ge_acc_tedy-gubani_01". C'est ce nom qui sera utilisé par l'export "NEL" pour nommer le fichier "shape" généré lors de l'export.

[[File:07-tuto-peluche-nettoyer-modele-fin.png|800px]]

== Étape 4 : Modifier le mapping des textures du modèle ==

Dans cette partie, nous allons revoir la texturation du modèle 3d. A priori, il faudrait juste changer la texture de base «ju_mo_h12.png» pour pointer sur la notre «ge_acc_teddy-gubani_01.dds» (ou «.tga» à défaut) puis l'adapter comme nous le voulons visuellement. Cependant, cela va être un peu plus compliqué :

Nous allons d'abord ouvrir l'écran "Material Editor" (1), puis sélectionner le seul matériel de la scène (2) en double cliquant dessus. Dans l'écran centrale sélectionnez le noeud dénommé "Map #1 Nel Multi Bitmap" en double cliquant dessus (3). Vous verrez alors s'afficher dans le panneau latéral de droite le détail de ses propriétés (4). Le "Nel Multi Bitmap" permet de définir 8 images différentes. Il ne s'agit pas de multi-texturing, mais de la possibilité de configurer plusieurs images de texture. Seule une est appliqué à un instant donné sur le modèle. Cela est utilisé pour les mobs pour spécifier une texture par écosystème et par certains objets environnementaux pour spécifier une texture différente par saison.

[[File:08-tuto-peluche-texture.png|800px]]
Le slot ID 1 est utilisé pour les textures de l'écosystème tryker, le second (ID 2) pour l'écosystème fyros, le troisième (ID 3) pour l'écosystème zoraï et le quatrième (ID 4) pour l'écosystème des primes racines. Ne cherchez pas de slot matis, en bon esthètes, ils ont compris que la beauté résidait dans la nature zoraï et utilisent donc les textures zoraï pour tous leurs animaux. Notez qu'ici le gubani n'étant présent qu'en jungle et en primes racines, seuls les slots 3 et 4 sont utilisés

Le même système est aussi utilisé pour d'autres objets IG, comme les bâtiments.dans ce cas, les 4 slots correspondent aux quatre saisons. C'est ainsi que l'on peut noter la présence de neige sur certaines bâtisses zoraï en hiver.

[[File:09-tuto-peluche-multi-texture.png]]

De notre coté nous n'allons pas utilisé ce mécanisme. Nous allons donc supprimé le "NEL Multi Bitmap" et le remplacer par un simple "Bitmap" en tirant avec la souris sur la sortie de la "''tTexture 1''" comme le montre l'image ci-dessus. En relâchant la souris, un menu contextuel apparait (2), sélectionner l'entrée "Bitmap" :

[[File:10-tuto-peluche-bitmap.png|800px]]

Puis aller chercher notre image dans "W:databasestuffgeneriqueagents_texturesaccessoriessoft-toyge_acc_teddy-gubani_01.dds" (ou ".tga").

[[File:11-tuto-peluche-bitmap.png|800px]]

Répéter l'opération pour l'autre "Nel Multi Bitmap" qui référence la même image.

== Étape 5 : Mise à échelle du modèle ==

Note modèle 3d est presque prêt à l'emploi. Cependant sa taille ne correspond pas à celle attendue d'une peluche. Si vous utilisez l'outil de mesure de 3dsmax vous verrez que le gubani mesure plus 2m de haut. Le plus simple pour le mettre à la bonne taille est de charger un modèle d'homin afin d'avoir un comparatif visuel et s'assurer que la peluche peut être prise en main.

On va donc insérer temporairement dans notre scène 3dsmax une référence vers un autre modèle 3d en passant par le menu Fichier (1) => References (2) => Xref Scène (3) et en cliquant sur le bouton Add (4) de la fenêtre qui apparait :

[[File:15-tuto-peluche-xref.png|800px]]

Sélectionner alors le modèle d'homin "W:\database\stuff\generique\agents\actors\male\ge_hom_armor02.max" qui devrait apparaître dans votre scène 3d.

[[File:15-tuto-peluche-xref-02.png]]

Mettre a échelle le modèle de gubani et le déplacer via les outils "Scale" et "Move" du menu contextuel apparaissant lorsqu'on clique sur le modèle avec le bouton droit de la souris.

[[File:16-tuto-peluche-echelle.png]]

Une fois la peluche à la bonne échelle, il ne reste plus qu'a supprimer la référence au modèle d'homin en repassant par le menu Fichier => References => Xref Scene.

Repositionner le modèle gubani à l'origine de la scène (x=0, y=0, z=0), car lorsqu'un objet est porté la position (0,0,0) se place au niveau de la main.

== Étape 6 : modifier la texture pour un rendu peluche ==

Au niveau de la texture, pour donner un effet peluche, laissez libre court à votre imagination

[[File:17-tuto-peluche-texture-source.png]]

Ici j'ai édité l'image "ge_acc_teddy-gubani_01.tga" dans l'outil Gimp. J'ai utilisé le filtre "Artistiques > GIMPressioniste" en utilisant le modèle "canvas" pour obtenir un effet trame de tissu.

[[File:17-tuto-peluche-texture-peluche.png]]

Une fois l'image sauvegardée, j'ai re-généré la texture au format ".dds" via la commande :

tga2dds ge_acc_teddy-gubani_01.tga

Voila le résultat obtenu sur le modèle 3d dans 3dsmax :

[[File:18-tuto-peluche-modele3d.png]]

== Étape 7 : Export du shape ==

Il est temps de tester cette peluche en jeu. Pour cela il va falloir exporter le modèle en générant le fichier "shape" utilisé par le moteur Ryzom

Si ce n'est pas déjà je cas, ajouter le bouton ''d'export NEL'' au panneau latéral droit en cliquant sur l'onglet "''utilities''", puis "''More''" et en sélectionnant l'option "''NEL Export''" :

[[File:20-tuto-peluche-export-nel-01.png]]

Ensuite sélectionner le mesh du gubani puis cliquer sur le bouton "Export Model". Il vous faut alors spécifier le dossier où sera crée le fichier "ge_acc_teddy-gubani-01.shape"

[[File:20-tuto-peluche-export-nel-02.png]]

== Étape 8 : Tester la peluche IG ==

Pour bien faire les choses, il faudrait ajouter le ''datasheet'' de la peluche au serveur de jeu et patcher le client. Cette méthode sera détaillée plus loin. Cependant il existe une solution de contournement si vous n'avez pas votre propre serveur de jeu pour réaliser ces opérations.

Il faut savoir qu'une peluche n'est rien d'autre qu'une arme équipée. Ainsi nous pourrions remplacer le modèle de la dague par celui de notre gubani pour le tester sur le serveur officiel. Il existe une astuce simple pour cela. Le client de jeu recherche les modèles et textures dans le dossier "user" avant d'aller voir le dossier "data". Il suffit de copier notre fichier shape et la texture associée dans le dossier "user", puis de renommer le shape du gubani en celui de la dague : "GE_Wea_Dague.shape"

A présent lorsque vous équiperez une dague IG, vous aurez en main notre peluche "gubani".
Pour retrouver la dague d'origine, il suffit de supprimer le fichier shape du dossier "user" :

[[File:21-gubani-peluche-axe.png|400px]]

En réalisant ce test vous pouvez noter une anomalie : la peluche est tenue par le pied, ce qui n'est pas forcément ce que nous voulons

== Étape 9 : orientation et positionnement d'un objet porté ==

Le point de fixation d'un objet tenu en main correspond au point de coordonnée (0,0,0) de l'objet.Son orientation suit la règle suivante :

l'axe X remonte le long de l'avant-bras ;
l'axe Y part depuis le dos de la main vers l'extérieur ;
l'axe Z pointe vers le haut de l'objet tenu fermement en main.

Nous réorientons la peluche gubani dans 3dsmax comme le montre l'image suivante : l'axe X sort du dos du gubani pour remonter le long du bras qui le portera. L'axe Z sort de la main et est donc dans le prolongement de la tête de la peluche :

[[File:22-gubani-peluche-axe-3dsmax.png]]

Après réorientation du modèle gubani et réexportation du shape nous obtenons enfin une peluche qui est tenue par le tronc :

[[File:22-gubani-peluche-axe.png|400px]]

Pour aller plus loin sur les objets portés, je vous conseille de lire ce tutorial : http:''khaganat.net/wikhan/fr:todo:dessiner:creation_d_un_objet_prehensible_en_jeu

== Étape 9 : Créer l’icône pour l'inventaire et la barre d'actions ==

Il faut créer un icône pour l'affichage de l'item peluche gubani dans l'inventaire et dans la barre d'actions.
Cet au icône au format tga doit faire 40x40 pixels avec un fond transparent. Nous le nommerons "icon_teddygubani.tga"

L'icône de 40x40 pixels :

[[File:23-icone-gubani.png|80px]]

Pour des questions de performance, ces icônes ne sont pas stockés individuellement mais regroupés dans une seule image dénommée : "texture_interfaces_v3.tga". Le fichier texte associé dénommé "texture_interfaces_v3.txt" liste les icones présents et leur position dans l'image :

[[File:23-icone-gubani-contexte-txt.png]]

le fichier texte utilise le format suivant pour chaque ligne :

NomFichierIcone u1 v1 u2 v2

Avec :
* u1,v1 la position du point supérieur gauche de l'icône
* u2,v2 la position du coin inférieur droit de l'icône

A la différence des coordonnées en pixels, ces coordonnées qui utilisent la technique du UV Mapping en 3d ont leurs valeurs dans l’intervalle [0 .. 1]. la coordonnée (0,0) correspond au point supérieur gauche de l'image et (1,1) au point inférieur droit de l'image.

Le passage d'un système à l'autre est simple. Soit (x1,y1) la position en pixels du coin haut gauche de notre icône dans l'image globale et (x2,y2) la position du point inférieur droit de l'icône dans l'image, alors :
* u1 = x1 / largeur-image
* v1 = y1 / hauteur-image
* u2 = x2 / largeur-image
* v2 = y2 / hauteur-image

Sachant que la texture "texture_interfaces_v3.tga" fait 1024x1024 pixel, et que dans l'exemple l'icône "icon_teddygubani.tga" se situe à la position (x1=118,y1=798), que le point inférieur gauche étant à la position (x2=157,y2=837), le fichier txt contient donc la ligne :

icon_teddygubani.tga 0.115234375 0.779296875 0.1533203125 0.8173828125

Même si cela peut être ajouté à la main, la bonne méthode et d'utiliser l'outil dédié de NEL ''build_interface'' comme indiqué dans le tutorial https:''khaganat.net/wikhan/fr:todo:dessiner:creer_icone_objet qui recrée la texture globale et le fichier txt à partir d'un dossier contenant tous les icones.

Note: L'ajout de l'icône ne suffit pas, il faut également créer le datasheet de l'objet peluche et spécifier dedans le nom de notre icône à utiliser comme nous le verrons plus loin dans ce tutorial. Au final nous obtenons le résultat suivant IG :

[[File:23-icone-gubani-contexte.png]]

== Etape 11 : créer le fichiers des noms ==

A compléter.

[[File:30-tuto-peluche-txtfile.png]]

== Étape 12 : créer le datasheet ==

A la base, une peluche reste est un objet porté comme une arme. De fait le datasheet de la peluche est trs semblable à celui d'une arme une main, comme l'exemple de la dague ci-dessous.

__icrm1pd.sitem ( datasheet de la dague du réfugié ) :__

<pre>
<?xml version="1.0"?>
<FORM Revision="$Revision: 1.2 $" State="modified">
<PARENT Filename="_c_m1pd.sitem"/>
<STRUCT>
<STRUCT Name="basics">
<ATOM Name="name" Value="refugee dagger"/>
<ATOM Name="origin" Value="refugee"/>
<ATOM Name="Drop or Sell" Value="false"/>
<ATOM Name="CraftPlan" Value="bcrmea06.sbrick"/>
<ATOM Name="Saleable" Value="false"/>
</STRUCT>
<STRUCT Name="3d">
<ATOM Name="shape" Value="GE_Wea_Dague.shape"/>
<ATOM Name="shape_female" Value="GE_Wea_Dague.shape"/>
<ATOM Name="map_variant" Value="Low Quality"/>
<ATOM Name="icon background" Value="BK_generic.tga"/>
<STRUCT Name="fx">
<ATOM Name="Trail" Value="GE_Wea_Dague_trail_00.shape"/>
</STRUCT>
</STRUCT>
</STRUCT>
<STRUCT/>
<STRUCT/>
<STRUCT/>
<STRUCT/>
<LOG>
</FORM>
</pre>

Ce qui change c'est :

* la référénce au shape dans la section "3d"

<ATOM Name="shape" Value="ge_acc_teddy-gubani_01.shape"/>
<ATOM Name="shape_female" Value="ge_acc_teddy-gubani_01.shape"/>

* la référence à l'icone utilisé dans la barre d'état et l'inventaire dans la section "3d"

<ATOM Name="icon" Value="icon_teddygubani.tga"/>
<ATOM Name="icon overlay" Value="icon_teddygubani.tga"/>

* les caractéristiques de base qui diffèrent d'une arme : pas de niveau requis, pas de brique de plan, etc..

<STRUCT Name="basics">
<ATOM Name="name" Value="staff"/>
<ATOM Name="origin" Value="common"/>
<ATOM Name="family" Value="handled item"/>
<ATOM Name="ItemType" Value="Staff"/>
<ATOM Name="Bulk" Value="5"/>
<ATOM Name="RequiredCharacQualityFactor" Value="0"/>
<ATOM Name="RequiredCharacQualityOffset" Value="0"/>
</STRUCT>

Voila donc le datasheet de la peluche gubani que nous nommerons "teddygubani.sitem" :

<pre>
<?xml version="1.0"?>
<FORM Revision="$Revision: 1.7 $" State="modified">
<PARENT Filename="_c_m1pd.sitem"/>
<STRUCT>
<STRUCT Name="basics">
<ATOM Name="name" Value="staff"/>
<ATOM Name="origin" Value="common"/>
<ATOM Name="family" Value="handled item"/>
<ATOM Name="ItemType" Value="Staff"/>
<ATOM Name="Bulk" Value="5"/>
<ATOM Name="RequiredCharacQualityFactor" Value="0"/>
<ATOM Name="RequiredCharacQualityOffset" Value="0"/>
</STRUCT>
<STRUCT Name="3d">
<ATOM Name="shape" Value="ge_acc_teddy-gubani_01.shape"/>
<ATOM Name="shape_female" Value="ge_acc_teddy-gubani_01.shape"/>
<ATOM Name="map_variant" Value="Low Quality"/>
<ATOM Name="icon" Value="icon_teddygubani.tga"/>
<ATOM Name="icon background" Value="BK_generic.tga"/>
<ATOM Name="icon overlay" Value="icon_teddygubani.tga"/>
<STRUCT Name="fx">
<ATOM Name="Trail" Value="GE_Wea_Dague_trail_00.shape"/>
</STRUCT>
</STRUCT>
</STRUCT>
<STRUCT/>
<STRUCT/>
<STRUCT/>
<STRUCT/>
<LOG></LOG>
</FORM>
</pre>

== Étape 13 : Déployer la peluche sur le serveur et le client de jeu ==

Afin de déployer la peluche en jeu la méthode officielle consiste à utiliser la pipeline "build_gamedata" (cf. https:''ryzomcore.atlassian.net/wiki/display/RC/Gamedata+Build+Pipeline). Je vais vous proposer une méthode différente, où les opérations seront effectués à la mains, mais uniquement celles nécessaires à notre peluche :

Nous avons besoin des fichiers suivants :

* teddygubani.sitem ( le datasheet de la peluche gunabi )
* ge_acc_teddy-gubani_01.shape ( le modèle 3d NEL de la peluche )
* ge_acc_teddy-gubani_01.dds ( la texture du modèle 3d )

De plus le déploiement de cette peluche va impacter les fichiers suivants :

* les fichiers "*.packed_sheets" utilisée par le serveur et le client qui sont une version compilé des datasheets
* le fichier "sheet_id.bin" qui est un index de tous les datasheets utilisés par le jeu
* le fichier "visual_slot.tab" qui liste les éléments affichables coté client

Pour bien faire les choses, nous allons également créer un fichier "soft-toy.bnp" qui contiendra les shapes et les textures de toutes les futures peluches.

Pour la suite des opérations nous partons du principe que notre serveur de jeu fonctionne sous linux, et que les variables d'envrionnement suivantes sont définies :

* LEVELDESIGNPATH pointe sur le dossier des datas du level design
* RYZOM_HOME sur l'installation des sources du serveur

=== Ajout du datasheet "teddygubani.sitem au serveur ===

Coté serveur nous allons créer un dossier dédié pour les datasheets des peluches et y placer celui du gubani :

$ mkdir $LEVELDESIGNPATHleveldesigngame_elementsitemsoft-toy
$ cp teddygubani.sitem $LEVELDESIGNPATHleveldesigngame_elementsitemsoft-toy

=== Nettoyages préalables ===

=== Re-générer le fichier "sheet_id.bin" ===

La première étape consiste à regénérer le fichier d'index des datasheet via la commande "make_sheet_id". Il reprend le fichier d'index existant et va le compléter avec les datasheets du dossier $RYZOM_LEVELPATH/leveldesign/game_element/sitem/soft-toy c'est-à-dire les datasheets de nos peluches

$ make_sheet_id -o$LEVELDESIGNPATH/leveldesign/Game_elem/sheet_id.bin $LEVELDESIGNPATH/leveldesign/game_element/sitem/soft-toy

=== Re-générer les "*.packed_sheets" et "visual_slot.tab" ===

Il faut regénérer les "*.packed_sheets".Ce sont les versions pré-compilées des datasheets :

$ sheets_packer

Cette commande va également re-générer le fichier visual_slot.tab

=== Copier les fichiers nécessaires coté client ===

* Nous copions le fichier "visual_slot.tab" généré dans le dossier courant dans le dossier "user" du client de jeu
* Nous copions le fichier $LEVELDESIGNPATH/leveldesign/Game_elem/sheet_id.bin dans le dossier "user" du client de jeu
* Nous remplaçons les fichiers packet_sheets du dossier "data" du client par ceux générés ici $RYZOM_HOME/code/ryzom/client/data/*.packed_sheets par la commande ''sheets_packer''

=== Créer un bnp pour le modèle de la peluche ===

Pour finir il faut copier le shape et la texture de la peluche dans le dossier "data" du client.
Cependant pour bien faire les choses, autant créer un fichier ".bnp" dédié.
Un fichier ".bnp" est une sorte de zip regroupant les différents fichiers shape, dds, txt, ou autres par thème.

Créer on dossier "soft-toy", copions y tous les shapes et textures de nos peluche, à savoir pour le moment "ge_acc_teddy-gubani_01.shape" et "ge_acc_teddy-gubani_01.dds" et créons un fichier BNP pour les contenur

bnp_make /p soft-toy

La commande va créer un fichier "soft-toy,bnp" qui contiendra nos deux fichiers. A présent il faut le copier dans le dossier "data" du client.

=== Tester IG ===

Relancer le serveur avec la commande ''shard start'' puis connectez vous avec votre client.

Si tout c'est bien déroulé, en lançant votre client de jeu, vous pouvez créer une peluche dans votre inventaire avec la commande :

/a createItemInBag teddygubani 1 5

{{tag>Tag_a_ajouter}}

FR Peluche

2014-07-25T20:37:00Z

Madi: /* Étape 5 : Mise à échelle du modèle */

= Objets du mois : Déployer en Jeu des peluches « mobs d'atys » =

[[File:00-tuto-peluche.png|300px]]

Le but de ce tutorial est de montrer comment réaliser des peluches basées sur les modèles des animaux atysiens.

Pré-requis pour modéliser uniquement la peluche :

* Avoir installé les assets ryzom et configuré correctement les lecteurs (les outils NEL s'attendent à trouver les données des assets dans le dossier ( W:database ).
* Avoir installé 3DSMax et configuré le plugin NEL ( Attention le plugin ne fonctionne qu'avec les version 32bits de 3DSmax et de la versions 9 à la version 2012).
* Conseillé mais non nécessaire : avoir installé l'outil NEL "''tga2dds.exe''".

Pré-requis pour déployer la peluche sur un serveur de jeu :

* Avoir compilé et installé un serveur de jeu et configuré un client pour l'utiliser

Note : il est possible de tester cette peluche IG sans disposer d'un serveur de jeu via une astuce qui sera expliquée plus loin dans ce tutoriel.

Quelques liens utiles pour ces pré-requis :

* Liens de téléchargement des assets et outils : https:''ryzomcore.atlassian.net/wiki/display/RC/Downloads+for+Windows
* Configuration des lecteurs :https:''ryzomcore.atlassian.net/wiki/display/RC/How+to+set+up+the+Build+Pipeline
* Installation du plugin NEL de 3dsmax :https:''ryzomcore.atlassian.net/wiki/display/RC/Installing+the+Max+Plugins

== Étape 1: choisir le modèle qui servira pour notre peluche ==

L'ensemble des modèles 3d de la faune de ryzom sont regroupés dans le dossier « W:\database\stuff\tryker\agents\monsters » par famille de créature. Dans ce tutorial nous allons utiliser le modèle du « Gubani » qui est situé dans le sous-dossier des créatures « chevalines » pour réaliser notre peluche :

W:\database\stuff\tryker\agents\monsters\cheval\h12tr_mo_h12.max

[[File:01-tuto-peluche-dossiers-mobs.png|600px]]

== Étape 2 : Reprendre le modèle et se créer un dossier dédié pour travailler ==

Dans 3dsmax ouvrir le fichier « W:\database\stuff\tryker\agents\monsters\cheval\h12tr_mo_h12.max »

Nous consultons la liste des fichiers utilisés par le modèle, notamment les textures via le menu => «Fichier» => « Manage » => « Asset Tracking ». On note deux fichiers :

* Le modèle 3d : « tr_mo_h12.max »
* La texture du gubani « ju_mo_h12.png »

[[File:02-tuto-peluche-asset-tracking.png|800px]]

Le but ici étant de déployer des peluches monstres pour les objets du mois, nous allons donc se créer un dossier dédié pour nos futures peluches et respecter les conventions de nomination de ryzom.

Nous allons donc créer un dossier « soft-toy » dans le dossier « W:\database\stuff\generique\agents\accessories ». Nous y sauvegarderons notre modèle en le renommant : ge_acc_teddy-gubani_01.max

* le premier préfixe «ge_» du nom de fichier est pour spécifier l'écosystème, ici __gé__nérique (tr : tryker, fy : fyros, etc...)
* le second préfixe du nom du fichier est pour spécifier le type de modèle ( hom : homin masculin, mo : monstre, wea weapon, etc... ), ici « acc » pour __acc__essoire.
* Enfin le nom de notre modèle « teddy-gubani » que nous suffixons par un numéro afin de pouvoir créer plusieurs variantes de peluches gubani.

Pour la texture, nous devrions aussi la copier dans « W:\database\stuff\generique\agents\_textures\accessories », mais nous allons faire plus simple. Nous allons la mettre dans le même dossier que le modèle 3d et la renommer en suivant la même convention : « ge_acc_teddy-gubani_01.png »

Cependant, le moteur de ryzom ne sait afficher que les textures au format ".tga" ou ".dds". TGA est un format brut sans compression ce qui le rend pratique pour l'édition mais moins performant en espace mémoire occupé. le format DDS est un format d'image compressée qui comme le jpep est destructeur. C'est le format utilisé en interne par ryzom pour minimiser l'espace des textures en mémoire. Avec votre éditeur préféré convertissez l'image ".png" en ".tga". C'est elle-ci que nous garderons pour l'édition. Nous allons utiliser l'outil NEL "''tga2dds''" pour générer une image texture au format ".dds" pour le modèle 3d. C'est celle que nous utiliserons dans 3dsmax

tga2dds ge_acc_teddy-gubani_01.tga

Si vous n'avez pas l'outil, vous pouvez garder la version ".tga". Elle fonctionne pour les tests IG.
Dans le dossier soft-toy vous devriez avoir comme résultat :

[[File:03-tuto-peluche-dossier-soft-toy.png|600px]]

== Étape 3 : Nettoyer le modèle 3D sous 3dsmax ==

Le modèle 3D du monstre contient un squelette et toutes ce qu'il faut pour l'animer. Cela n'est pas nécessaire pour un accessoire peluche et surchargerait inutilement le modèle ryzom final. Nous allons dons les supprimer.

[[File:04-tuto-peluche-animation.png|800px]]

Sélectionner le modèle "Gubani" avec la souris. Dans le panneau latéral droit, sélectionner l'onglet "''modify''". Vous devez voir apparaître le mesh dénommé "TR_MO_H12" et dans la pile des "''modifiers''" celui nommé "physique". Nous allons le supprimer

[[File:05-tuto-peluche-physique.png|600px]]

Ensuite nous allons ouvrir l'écran affichant les éléments de la scene via le menu "Tools"=> "New Scene Explorer" et supprimer tous les éléments constituant le squelette du modèle pour ne garder au final que le mesh de l'animal.

[[File:06-tuto-peluche-bones-01.png|800px]]

Au final nous n'avons plus qu'un seul élément dans notre "scène" : le mesh du gubani "TR_MO_H12" :

[[File:07-tuto-peluche-nettoyer-modele.png|800px]]

Dans le panneau latéral droit, nous allons renommer ce mesh en "ge_acc_tedy-gubani_01". C'est ce nom qui sera utilisé par l'export "NEL" pour nommer le fichier "shape" généré lors de l'export.

[[File:07-tuto-peluche-nettoyer-modele-fin.png|800px]]

== Étape 4 : Modifier le mapping des textures du modèle ==

Dans cette partie, nous allons revoir la texturation du modèle 3d. A priori, il faudrait juste changer la texture de base «ju_mo_h12.png» pour pointer sur la notre «ge_acc_teddy-gubani_01.dds» (ou «.tga» à défaut) puis l'adapter comme nous le voulons visuellement. Cependant, cela va être un peu plus compliqué :

Nous allons d'abord ouvrir l'écran "Material Editor" (1), puis sélectionner le seul matériel de la scène (2) en double cliquant dessus. Dans l'écran centrale sélectionnez le noeud dénommé "Map #1 Nel Multi Bitmap" en double cliquant dessus (3). Vous verrez alors s'afficher dans le panneau latéral de droite le détail de ses propriétés (4). Le "Nel Multi Bitmap" permet de définir 8 images différentes. Il ne s'agit pas de multi-texturing, mais de la possibilité de configurer plusieurs images de texture. Seule une est appliqué à un instant donné sur le modèle. Cela est utilisé pour les mobs pour spécifier une texture par écosystème et par certains objets environnementaux pour spécifier une texture différente par saison.

[[File:08-tuto-peluche-texture.png|800px]]
Le slot ID 1 est utilisé pour les textures de l'écosystème tryker, le second (ID 2) pour l'écosystème fyros, le troisième (ID 3) pour l'écosystème zoraï et le quatrième (ID 4) pour l'écosystème des primes racines. Ne cherchez pas de slot matis, en bon esthètes, ils ont compris que la beauté résidait dans la nature zoraï et utilisent donc les textures zoraï pour tous leurs animaux. Notez qu'ici le gubani n'étant présent qu'en jungle et en primes racines, seuls les slots 3 et 4 sont utilisés

Le même système est aussi utilisé pour d'autres objets IG, comme les bâtiments.dans ce cas, les 4 slots correspondent aux quatre saisons. C'est ainsi que l'on peut noter la présence de neige sur certaines bâtisses zoraï en hiver.

[[File:09-tuto-peluche-multi-texture.png]]

De notre coté nous n'allons pas utilisé ce mécanisme. Nous allons donc supprimé le "NEL Multi Bitmap" et le remplacer par un simple "Bitmap" en tirant avec la souris sur la sortie de la "''tTexture 1''" comme le montre l'image ci-dessus. En relâchant la souris, un menu contextuel apparait (2), sélectionner l'entrée "Bitmap" :

[[File:10-tuto-peluche-bitmap.png|800px]]

Puis aller chercher notre image dans "W:databasestuffgeneriqueagents_texturesaccessoriessoft-toyge_acc_teddy-gubani_01.dds" (ou ".tga").

[[File:11-tuto-peluche-bitmap.png|800px]]

Répéter l'opération pour l'autre "Nel Multi Bitmap" qui référence la même image.

== Étape 5 : Mise à échelle du modèle ==

Note modèle 3d est presque prêt à l'emploi. Cependant sa taille ne correspond pas à celle attendue d'une peluche. Si vous utilisez l'outil de mesure de 3dsmax vous verrez que le gubani mesure plus 2m de haut. Le plus simple pour le mettre à la bonne taille est de charger un modèle d'homin afin d'avoir un comparatif visuel et s'assurer que la peluche peut être prise en main.

On va donc insérer temporairement dans notre scène 3dsmax une référence vers un autre modèle 3d en passant par le menu Fichier (1) => References (2) => Xref Scène (3) et en cliquant sur le bouton Add (4) de la fenêtre qui apparait :

[[File:15-tuto-peluche-xref.png|800px]]

Sélectionner alors le modèle d'homin "W:\database\stuff\generique\agents\actors\male\ge_hom_armor02.max" qui devrait apparaître dans votre scène 3d.

[[File:15-tuto-peluche-xref-02.png]]

Mettre a échelle le modèle de gubani et le déplacer via les outils "Scale" et "Move" du menu contextuel apparaissant lorsqu'on clique sur le modèle avec le bouton droit de la souris.

[[File:16-tuto-peluche-echelle.png]]

Une fois la peluche à la bonne échelle, il ne reste plus qu'a supprimer la référence au modèle d'homin en repassant par le menu Fichier => References => Xref Scene.

Repositionner le modèle gubani à l'origine de la scène (x=0, y=0, z=0), car lorsqu'un objet est porté la position (0,0,0) se place au niveau de la main.

== Étape 6 : modifier la texture pour un rendu peluche ==

Au niveau de la texture, pour donner un effet peluche, laissez libre court à votre imagination

[[File:17-tuto-peluche-texture-source.png]]

Ici j'ai édité l'image "ge_acc_teddy-gubani_01.tga" dans l'outil Gimp. J'ai utilisé le filtre "Artistiques > GIMPressioniste" en utilisant le modèle "canvas" pour obtenir un effet trame de tissu.

[[File:17-tuto-peluche-texture-peluche.png]]

Une fois l'image sauvegardée, j'ai re-généré la texture au format ".dds" via la commande :

tga2dds ge_acc_teddy-gubani_01.tga

Voila le résultat obtenu sur le modèle 3d dans 3dsmax :

[[File:18-tuto-peluche-modele3d.png]]

== Étape 7 : Export du shape ==

Il est temps de tester cette peluche en jeu. Pour cela il va falloir exporter le modèle en générant le fichier "shape" utilisé par le moteur Ryzom

Si ce n'est pas déjà je cas, ajouter le bouton ''d'export NEL'' au panneau latéral droit en cliquant sur l'onglet "''utilities''", puis "''More''" et en sélectionnant l'option "''NEL Export''" :

[[File:20-tuto-peluche-export-nel-01.png]]

Ensuite sélectionner le mesh du gubani puis cliquer sur le bouton "Export Model". Il vous faut alors spécifier le dossier où sera crée le fichier "ge_acc_teddy-gubani-01.shape"

[[File:20-tuto-peluche-export-nel-02.png]]

== Étape 8 : Tester la peluche IG ==

Pour bien faire les choses, il faudrait ajouter le ''datasheet'' de la peluche au serveur de jeu et patcher le client. Cette méthode sera détaillée plus loin. Cependant il existe une solution de contournement si vous n'avez pas votre propre serveur de jeu pour réaliser ces opérations.

Il faut savoir qu'une peluche n'est rien d'autre qu'une arme équipée. Ainsi nous pourrions remplacer le modèle de la dague par celui de notre gubani pour le tester sur le serveur officiel. Il existe une astuce simple pour cela. Le client de jeu recherche les modèles et textures dans le dossier "user" avant d'aller voir le dossier "data". Il suffit de copier notre fichier shape et la texture associée dans le dossier "user", puis de renommer le shape du gubani en celui de la dague : "GE_Wea_Dague.shape"

A présent lorsque vous équiperez une dague IG, vous aurez en main notre peluche "gubani".
Pour retrouver la dague d'origine, il suffit de supprimer le fichier shape du dossier "user" :

[[File:21-gubani-peluche-axe.png|400px]]

En réalisant ce test vous pouvez noter une anomalie : la peluche est tenue par le pied, ce qui n'est pas forcément ce que nous voulons

== Étape 9 : orientation et positionnement d'un objet porté ==

Le point de fixation d'un objet tenu en main correspond au point de coordonnée (0,0,0) de l'objet.Son orientation suit la règle suivante :

l'axe X remonte le long de l'avant-bras ;
l'axe Y part depuis le dos de la main vers l'extérieur ;
l'axe Z pointe vers le haut de l'objet tenu fermement en main.

Nous réorientons la peluche gubani dans 3dsmax comme le montre l'image suivante : l'axe X sort du dos du gubani pour remonter le long du bras qui le portera. L'axe Z sort de la main et est donc dans le prolongement de la tête de la peluche :

[[File:22-gubani-peluche-axe-3dsmax.png]]

Après réorientation du modèle gubani et réexportation du shape nous obtenons enfin une peluche qui est tenue par le tronc :

[[File:22-gubani-peluche-axe.png|400px]]

Pour aller plus loin sur les objets portés, je vous conseille de lire ce tutorial : http:''khaganat.net/wikhan/fr:todo:dessiner:creation_d_un_objet_prehensible_en_jeu

== Étape 9 : Créer l’icône pour l'inventaire et la barre d'actions ==

Il faut créer un icône pour l'affichage de l'item peluche gubani dans l'inventaire et dans la barre d'actions.
Cet au icône au format tga doit faire 40x40 pixels avec un fond transparent. Nous le nommerons "icon_teddygubani.tga"

L'icône de 40x40 pixels :

[[File:23-icone-gubani.png|80px]]

Pour des questions de performance, ces icônes ne sont pas stockés individuellement mais regroupés dans une seule image dénommée : "texture_interfaces_v3.tga". Le fichier texte associé dénommé "texture_interfaces_v3.txt" liste les icones présents et leur position dans l'image :

[[File:23-icone-gubani-contexte-txt.png]]

le fichier texte utilise le format suivant pour chaque ligne :

NomFichierIcone u1 v1 u2 v2

Avec :
* u1,v1 la position du point supérieur gauche de l'icône
* u2,v2 la position du coin inférieur droit de l'icône

A la différence des coordonnées en pixels, ces coordonnées qui utilisent la technique du UV Mapping en 3d ont leurs valeurs dans l’intervalle [0 .. 1]. la coordonnée (0,0) correspond au point supérieur gauche de l'image et (1,1) au point inférieur droit de l'image.

Le passage d'un système à l'autre est simple. Soit (x1,y1) la position en pixels du coin haut gauche de notre icône dans l'image globale et (x2,y2) la position du point inférieur droit de l'icône dans l'image, alors :
* u1 = x1 / largeur-image
* v1 = y1 / hauteur-image
* u2 = x2 / largeur-image
* v2 = y2 / hauteur-image

Sachant que la texture "texture_interfaces_v3.tga" fait 1024x1024 pixel, et que dans l'exemple l'icône "icon_teddygubani.tga" se situe à la position (x1=118,y1=798), que le point inférieur gauche étant à la position (x2=157,y2=837), le fichier txt contient donc la ligne :

icon_teddygubani.tga 0.115234375 0.779296875 0.1533203125 0.8173828125

Même si cela peut être ajouté à la main, la bonne méthode et d'utiliser l'outil dédié de NEL ''build_interface'' comme indiqué dans le tutorial https:''khaganat.net/wikhan/fr:todo:dessiner:creer_icone_objet qui recrée la texture globale et le fichier txt à partir d'un dossier contenant tous les icones.

Note: L'ajout de l'icône ne suffit pas, il faut également créer le datasheet de l'objet peluche et spécifier dedans le nom de notre icône à utiliser comme nous le verrons plus loin dans ce tutorial. Au final nous obtenons le résultat suivant IG :

[[File:23-icone-gubani-contexte.png]]

== Etape 11 : créer le fichiers des noms ==

A compléter.

[[File:30-tuto-peluche-txtfile.png]]

== Étape 12 : créer le datasheet ==

A la base, une peluche reste est un objet porté comme une arme. De fait le datasheet de la peluche est trs semblable à celui d'une arme une main, comme l'exemple de la dague ci-dessous.

__icrm1pd.sitem ( datasheet de la dague du réfugié ) :__

<code xml>
<?xml version="1.0"?>
<FORM Revision="$Revision: 1.2 $" State="modified">
<PARENT Filename="_c_m1pd.sitem"/>
<STRUCT>
<STRUCT Name="basics">
<ATOM Name="name" Value="refugee dagger"/>
<ATOM Name="origin" Value="refugee"/>
<ATOM Name="Drop or Sell" Value="false"/>
<ATOM Name="CraftPlan" Value="bcrmea06.sbrick"/>
<ATOM Name="Saleable" Value="false"/>
</STRUCT>
<STRUCT Name="3d">
<ATOM Name="shape" Value="GE_Wea_Dague.shape"/>
<ATOM Name="shape_female" Value="GE_Wea_Dague.shape"/>
<ATOM Name="map_variant" Value="Low Quality"/>
<ATOM Name="icon background" Value="BK_generic.tga"/>
<STRUCT Name="fx">
<ATOM Name="Trail" Value="GE_Wea_Dague_trail_00.shape"/>
</STRUCT>
</STRUCT>
</STRUCT>
<STRUCT/>
<STRUCT/>
<STRUCT/>
<STRUCT/>
<LOG>
</FORM>
<\/pre>

Ce qui change c'est :

* la référénce au shape dans la section "3d"

<ATOM Name="shape" Value="ge_acc_teddy-gubani_01.shape"/>
<ATOM Name="shape_female" Value="ge_acc_teddy-gubani_01.shape"/>

* la référence à l'icone utilisé dans la barre d'état et l'inventaire dans la section "3d"

<ATOM Name="icon" Value="icon_teddygubani.tga"/>
<ATOM Name="icon overlay" Value="icon_teddygubani.tga"/>

* les caractéristiques de base qui diffèrent d'une arme : pas de niveau requis, pas de brique de plan, etc..

<STRUCT Name="basics">
<ATOM Name="name" Value="staff"/>
<ATOM Name="origin" Value="common"/>
<ATOM Name="family" Value="handled item"/>
<ATOM Name="ItemType" Value="Staff"/>
<ATOM Name="Bulk" Value="5"/>
<ATOM Name="RequiredCharacQualityFactor" Value="0"/>
<ATOM Name="RequiredCharacQualityOffset" Value="0"/>
</STRUCT>

Voila donc le datasheet de la peluche gubani que nous nommerons "teddygubani.sitem" :

<code xml>
<?xml version="1.0"?>
<FORM Revision="$Revision: 1.7 $" State="modified">
<PARENT Filename="_c_m1pd.sitem"/>
<STRUCT>
<STRUCT Name="basics">
<ATOM Name="name" Value="staff"/>
<ATOM Name="origin" Value="common"/>
<ATOM Name="family" Value="handled item"/>
<ATOM Name="ItemType" Value="Staff"/>
<ATOM Name="Bulk" Value="5"/>
<ATOM Name="RequiredCharacQualityFactor" Value="0"/>
<ATOM Name="RequiredCharacQualityOffset" Value="0"/>
</STRUCT>
<STRUCT Name="3d">
<ATOM Name="shape" Value="ge_acc_teddy-gubani_01.shape"/>
<ATOM Name="shape_female" Value="ge_acc_teddy-gubani_01.shape"/>
<ATOM Name="map_variant" Value="Low Quality"/>
<ATOM Name="icon" Value="icon_teddygubani.tga"/>
<ATOM Name="icon background" Value="BK_generic.tga"/>
<ATOM Name="icon overlay" Value="icon_teddygubani.tga"/>
<STRUCT Name="fx">
<ATOM Name="Trail" Value="GE_Wea_Dague_trail_00.shape"/>
</STRUCT>
</STRUCT>
</STRUCT>
<STRUCT/>
<STRUCT/>
<STRUCT/>
<STRUCT/>
<LOG></LOG>
</FORM>
<\/pre>

== Étape 13 : Déployer la peluche sur le serveur et le client de jeu ==

Afin de déployer la peluche en jeu la méthode officielle consiste à utiliser la pipeline "build_gamedata" (cf. https:''ryzomcore.atlassian.net/wiki/display/RC/Gamedata+Build+Pipeline). Je vais vous proposer une méthode différente, où les opérations seront effectués à la mains, mais uniquement celles nécessaires à notre peluche :

Nous avons besoin des fichiers suivants :

* teddygubani.sitem ( le datasheet de la peluche gunabi )
* ge_acc_teddy-gubani_01.shape ( le modèle 3d NEL de la peluche )
* ge_acc_teddy-gubani_01.dds ( la texture du modèle 3d )

De plus le déploiement de cette peluche va impacter les fichiers suivants :

* les fichiers "*.packed_sheets" utilisée par le serveur et le client qui sont une version compilé des datasheets
* le fichier "sheet_id.bin" qui est un index de tous les datasheets utilisés par le jeu
* le fichier "visual_slot.tab" qui liste les éléments affichables coté client

Pour bien faire les choses, nous allons également créer un fichier "soft-toy.bnp" qui contiendra les shapes et les textures de toutes les futures peluches.

Pour la suite des opérations nous partons du principe que notre serveur de jeu fonctionne sous linux, et que les variables d'envrionnement suivantes sont définies :

* LEVELDESIGNPATH pointe sur le dossier des datas du level design
* RYZOM_HOME sur l'installation des sources du serveur

=== Ajout du datasheet "teddygubani.sitem au serveur ===

Coté serveur nous allons créer un dossier dédié pour les datasheets des peluches et y placer celui du gubani :

$ mkdir $LEVELDESIGNPATHleveldesigngame_elementsitemsoft-toy
$ cp teddygubani.sitem $LEVELDESIGNPATHleveldesigngame_elementsitemsoft-toy

=== Nettoyages préalables ===

=== Re-générer le fichier "sheet_id.bin" ===

La première étape consiste à regénérer le fichier d'index des datasheet via la commande "make_sheet_id". Il reprend le fichier d'index existant et va le compléter avec les datasheets du dossier $RYZOM_LEVELPATH/leveldesign/game_element/sitem/soft-toy c'est-à-dire les datasheets de nos peluches

$ make_sheet_id -o$LEVELDESIGNPATH/leveldesign/Game_elem/sheet_id.bin $LEVELDESIGNPATH/leveldesign/game_element/sitem/soft-toy

=== Re-générer les "*.packed_sheets" et "visual_slot.tab" ===

Il faut regénérer les "*.packed_sheets".Ce sont les versions pré-compilées des datasheets :

$ sheets_packer

Cette commande va également re-générer le fichier visual_slot.tab

=== Copier les fichiers nécessaires coté client ===

* Nous copions le fichier "visual_slot.tab" généré dans le dossier courant dans le dossier "user" du client de jeu
* Nous copions le fichier $LEVELDESIGNPATH/leveldesign/Game_elem/sheet_id.bin dans le dossier "user" du client de jeu
* Nous remplaçons les fichiers packet_sheets du dossier "data" du client par ceux générés ici $RYZOM_HOME/code/ryzom/client/data/*.packed_sheets par la commande ''sheets_packer''

=== Créer un bnp pour le modèle de la peluche ===

Pour finir il faut copier le shape et la texture de la peluche dans le dossier "data" du client.
Cependant pour bien faire les choses, autant créer un fichier ".bnp" dédié.
Un fichier ".bnp" est une sorte de zip regroupant les différents fichiers shape, dds, txt, ou autres par thème.

Créer on dossier "soft-toy", copions y tous les shapes et textures de nos peluche, à savoir pour le moment "ge_acc_teddy-gubani_01.shape" et "ge_acc_teddy-gubani_01.dds" et créons un fichier BNP pour les contenur

bnp_make /p soft-toy

La commande va créer un fichier "soft-toy,bnp" qui contiendra nos deux fichiers. A présent il faut le copier dans le dossier "data" du client.

=== Tester IG ===

Relancer le serveur avec la commande ''shard start'' puis connectez vous avec votre client.

Si tout c'est bien déroulé, en lançant votre client de jeu, vous pouvez créer une peluche dans votre inventaire avec la commande :

/a createItemInBag teddygubani 1 5

{{tag>Tag_a_ajouter}}

FR Peluche

2014-07-25T20:34:05Z

Madi: /* Étape 2 : Reprendre le modèle et se créer un dossier dédié pour travailler */

= Objets du mois : Déployer en Jeu des peluches « mobs d'atys » =

[[File:00-tuto-peluche.png|300px]]

Le but de ce tutorial est de montrer comment réaliser des peluches basées sur les modèles des animaux atysiens.

Pré-requis pour modéliser uniquement la peluche :

* Avoir installé les assets ryzom et configuré correctement les lecteurs (les outils NEL s'attendent à trouver les données des assets dans le dossier ( W:database ).
* Avoir installé 3DSMax et configuré le plugin NEL ( Attention le plugin ne fonctionne qu'avec les version 32bits de 3DSmax et de la versions 9 à la version 2012).
* Conseillé mais non nécessaire : avoir installé l'outil NEL "''tga2dds.exe''".

Pré-requis pour déployer la peluche sur un serveur de jeu :

* Avoir compilé et installé un serveur de jeu et configuré un client pour l'utiliser

Note : il est possible de tester cette peluche IG sans disposer d'un serveur de jeu via une astuce qui sera expliquée plus loin dans ce tutoriel.

Quelques liens utiles pour ces pré-requis :

* Liens de téléchargement des assets et outils : https:''ryzomcore.atlassian.net/wiki/display/RC/Downloads+for+Windows
* Configuration des lecteurs :https:''ryzomcore.atlassian.net/wiki/display/RC/How+to+set+up+the+Build+Pipeline
* Installation du plugin NEL de 3dsmax :https:''ryzomcore.atlassian.net/wiki/display/RC/Installing+the+Max+Plugins

== Étape 1: choisir le modèle qui servira pour notre peluche ==

L'ensemble des modèles 3d de la faune de ryzom sont regroupés dans le dossier « W:\database\stuff\tryker\agents\monsters » par famille de créature. Dans ce tutorial nous allons utiliser le modèle du « Gubani » qui est situé dans le sous-dossier des créatures « chevalines » pour réaliser notre peluche :

W:\database\stuff\tryker\agents\monsters\cheval\h12tr_mo_h12.max

[[File:01-tuto-peluche-dossiers-mobs.png|600px]]

== Étape 2 : Reprendre le modèle et se créer un dossier dédié pour travailler ==

Dans 3dsmax ouvrir le fichier « W:\database\stuff\tryker\agents\monsters\cheval\h12tr_mo_h12.max »

Nous consultons la liste des fichiers utilisés par le modèle, notamment les textures via le menu => «Fichier» => « Manage » => « Asset Tracking ». On note deux fichiers :

* Le modèle 3d : « tr_mo_h12.max »
* La texture du gubani « ju_mo_h12.png »

[[File:02-tuto-peluche-asset-tracking.png|800px]]

Le but ici étant de déployer des peluches monstres pour les objets du mois, nous allons donc se créer un dossier dédié pour nos futures peluches et respecter les conventions de nomination de ryzom.

Nous allons donc créer un dossier « soft-toy » dans le dossier « W:\database\stuff\generique\agents\accessories ». Nous y sauvegarderons notre modèle en le renommant : ge_acc_teddy-gubani_01.max

* le premier préfixe «ge_» du nom de fichier est pour spécifier l'écosystème, ici __gé__nérique (tr : tryker, fy : fyros, etc...)
* le second préfixe du nom du fichier est pour spécifier le type de modèle ( hom : homin masculin, mo : monstre, wea weapon, etc... ), ici « acc » pour __acc__essoire.
* Enfin le nom de notre modèle « teddy-gubani » que nous suffixons par un numéro afin de pouvoir créer plusieurs variantes de peluches gubani.

Pour la texture, nous devrions aussi la copier dans « W:\database\stuff\generique\agents\_textures\accessories », mais nous allons faire plus simple. Nous allons la mettre dans le même dossier que le modèle 3d et la renommer en suivant la même convention : « ge_acc_teddy-gubani_01.png »

Cependant, le moteur de ryzom ne sait afficher que les textures au format ".tga" ou ".dds". TGA est un format brut sans compression ce qui le rend pratique pour l'édition mais moins performant en espace mémoire occupé. le format DDS est un format d'image compressée qui comme le jpep est destructeur. C'est le format utilisé en interne par ryzom pour minimiser l'espace des textures en mémoire. Avec votre éditeur préféré convertissez l'image ".png" en ".tga". C'est elle-ci que nous garderons pour l'édition. Nous allons utiliser l'outil NEL "''tga2dds''" pour générer une image texture au format ".dds" pour le modèle 3d. C'est celle que nous utiliserons dans 3dsmax

tga2dds ge_acc_teddy-gubani_01.tga

Si vous n'avez pas l'outil, vous pouvez garder la version ".tga". Elle fonctionne pour les tests IG.
Dans le dossier soft-toy vous devriez avoir comme résultat :

[[File:03-tuto-peluche-dossier-soft-toy.png|600px]]

== Étape 3 : Nettoyer le modèle 3D sous 3dsmax ==

Le modèle 3D du monstre contient un squelette et toutes ce qu'il faut pour l'animer. Cela n'est pas nécessaire pour un accessoire peluche et surchargerait inutilement le modèle ryzom final. Nous allons dons les supprimer.

[[File:04-tuto-peluche-animation.png|800px]]

Sélectionner le modèle "Gubani" avec la souris. Dans le panneau latéral droit, sélectionner l'onglet "''modify''". Vous devez voir apparaître le mesh dénommé "TR_MO_H12" et dans la pile des "''modifiers''" celui nommé "physique". Nous allons le supprimer

[[File:05-tuto-peluche-physique.png|600px]]

Ensuite nous allons ouvrir l'écran affichant les éléments de la scene via le menu "Tools"=> "New Scene Explorer" et supprimer tous les éléments constituant le squelette du modèle pour ne garder au final que le mesh de l'animal.

[[File:06-tuto-peluche-bones-01.png|800px]]

Au final nous n'avons plus qu'un seul élément dans notre "scène" : le mesh du gubani "TR_MO_H12" :

[[File:07-tuto-peluche-nettoyer-modele.png|800px]]

Dans le panneau latéral droit, nous allons renommer ce mesh en "ge_acc_tedy-gubani_01". C'est ce nom qui sera utilisé par l'export "NEL" pour nommer le fichier "shape" généré lors de l'export.

[[File:07-tuto-peluche-nettoyer-modele-fin.png|800px]]

== Étape 4 : Modifier le mapping des textures du modèle ==

Dans cette partie, nous allons revoir la texturation du modèle 3d. A priori, il faudrait juste changer la texture de base «ju_mo_h12.png» pour pointer sur la notre «ge_acc_teddy-gubani_01.dds» (ou «.tga» à défaut) puis l'adapter comme nous le voulons visuellement. Cependant, cela va être un peu plus compliqué :

Nous allons d'abord ouvrir l'écran "Material Editor" (1), puis sélectionner le seul matériel de la scène (2) en double cliquant dessus. Dans l'écran centrale sélectionnez le noeud dénommé "Map #1 Nel Multi Bitmap" en double cliquant dessus (3). Vous verrez alors s'afficher dans le panneau latéral de droite le détail de ses propriétés (4). Le "Nel Multi Bitmap" permet de définir 8 images différentes. Il ne s'agit pas de multi-texturing, mais de la possibilité de configurer plusieurs images de texture. Seule une est appliqué à un instant donné sur le modèle. Cela est utilisé pour les mobs pour spécifier une texture par écosystème et par certains objets environnementaux pour spécifier une texture différente par saison.

[[File:08-tuto-peluche-texture.png|800px]]
Le slot ID 1 est utilisé pour les textures de l'écosystème tryker, le second (ID 2) pour l'écosystème fyros, le troisième (ID 3) pour l'écosystème zoraï et le quatrième (ID 4) pour l'écosystème des primes racines. Ne cherchez pas de slot matis, en bon esthètes, ils ont compris que la beauté résidait dans la nature zoraï et utilisent donc les textures zoraï pour tous leurs animaux. Notez qu'ici le gubani n'étant présent qu'en jungle et en primes racines, seuls les slots 3 et 4 sont utilisés

Le même système est aussi utilisé pour d'autres objets IG, comme les bâtiments.dans ce cas, les 4 slots correspondent aux quatre saisons. C'est ainsi que l'on peut noter la présence de neige sur certaines bâtisses zoraï en hiver.

[[File:09-tuto-peluche-multi-texture.png]]

De notre coté nous n'allons pas utilisé ce mécanisme. Nous allons donc supprimé le "NEL Multi Bitmap" et le remplacer par un simple "Bitmap" en tirant avec la souris sur la sortie de la "''tTexture 1''" comme le montre l'image ci-dessus. En relâchant la souris, un menu contextuel apparait (2), sélectionner l'entrée "Bitmap" :

[[File:10-tuto-peluche-bitmap.png|800px]]

Puis aller chercher notre image dans "W:databasestuffgeneriqueagents_texturesaccessoriessoft-toyge_acc_teddy-gubani_01.dds" (ou ".tga").

[[File:11-tuto-peluche-bitmap.png|800px]]

Répéter l'opération pour l'autre "Nel Multi Bitmap" qui référence la même image.

== Étape 5 : Mise à échelle du modèle ==

Note modèle 3d est presque prêt à l'emploi. Cependant sa taille ne correspond pas à celle attendue d'une peluche. Si vous utilisez l'outil de mesure de 3dsmax vous verrez que le gubani mesure plus 2m de haut. Le plus simple pour le mettre à la bonne taille est de charger un modèle d'homin afin d'avoir un comparatif visuel et s'assurer que la peluche peut être prise en main.

On va donc insérer temporairement dans notre scène 3dsmax une référence vers un autre modèle 3d en passant par le menu Fichier (1) => References (2) => Xref Scène (3) et en cliquant sur le bouton Add (4) de la fenêtre qui apparait :

[[File:15-tuto-peluche-xref.png|800px]]

Sélectionner alors le modèle d'homin "W:databasestuffgeneriqueagentsactorsmalege_hom_armor02.max" qui devrait apparaître dans votre scène 3d.

[[File:15-tuto-peluche-xref-02.png]]

Mettre a échelle le modèle de gubani et le déplacer via les outils "Scale" et "Move" du menu contextuel apparaissant lorsqu'on clique sur le modèle avec le bouton droit de la souris.

[[File:16-tuto-peluche-echelle.png]]

Une fois la peluche à la bonne échelle, il ne reste plus qu'a supprimer la référence au modèle d'homin en repassant par le menu Fichier => References => Xref Scene.

Repositionner le modèle gubani à l'origine de la scène (x=0, y=0, z=0), car lorsqu'un objet est porté la position (0,0,0) se place au niveau de la main.

== Étape 6 : modifier la texture pour un rendu peluche ==

Au niveau de la texture, pour donner un effet peluche, laissez libre court à votre imagination

[[File:17-tuto-peluche-texture-source.png]]

Ici j'ai édité l'image "ge_acc_teddy-gubani_01.tga" dans l'outil Gimp. J'ai utilisé le filtre "Artistiques > GIMPressioniste" en utilisant le modèle "canvas" pour obtenir un effet trame de tissu.

[[File:17-tuto-peluche-texture-peluche.png]]

Une fois l'image sauvegardée, j'ai re-généré la texture au format ".dds" via la commande :

tga2dds ge_acc_teddy-gubani_01.tga

Voila le résultat obtenu sur le modèle 3d dans 3dsmax :

[[File:18-tuto-peluche-modele3d.png]]

== Étape 7 : Export du shape ==

Il est temps de tester cette peluche en jeu. Pour cela il va falloir exporter le modèle en générant le fichier "shape" utilisé par le moteur Ryzom

Si ce n'est pas déjà je cas, ajouter le bouton ''d'export NEL'' au panneau latéral droit en cliquant sur l'onglet "''utilities''", puis "''More''" et en sélectionnant l'option "''NEL Export''" :

[[File:20-tuto-peluche-export-nel-01.png]]

Ensuite sélectionner le mesh du gubani puis cliquer sur le bouton "Export Model". Il vous faut alors spécifier le dossier où sera crée le fichier "ge_acc_teddy-gubani-01.shape"

[[File:20-tuto-peluche-export-nel-02.png]]

== Étape 8 : Tester la peluche IG ==

Pour bien faire les choses, il faudrait ajouter le ''datasheet'' de la peluche au serveur de jeu et patcher le client. Cette méthode sera détaillée plus loin. Cependant il existe une solution de contournement si vous n'avez pas votre propre serveur de jeu pour réaliser ces opérations.

Il faut savoir qu'une peluche n'est rien d'autre qu'une arme équipée. Ainsi nous pourrions remplacer le modèle de la dague par celui de notre gubani pour le tester sur le serveur officiel. Il existe une astuce simple pour cela. Le client de jeu recherche les modèles et textures dans le dossier "user" avant d'aller voir le dossier "data". Il suffit de copier notre fichier shape et la texture associée dans le dossier "user", puis de renommer le shape du gubani en celui de la dague : "GE_Wea_Dague.shape"

A présent lorsque vous équiperez une dague IG, vous aurez en main notre peluche "gubani".
Pour retrouver la dague d'origine, il suffit de supprimer le fichier shape du dossier "user" :

[[File:21-gubani-peluche-axe.png|400px]]

En réalisant ce test vous pouvez noter une anomalie : la peluche est tenue par le pied, ce qui n'est pas forcément ce que nous voulons

== Étape 9 : orientation et positionnement d'un objet porté ==

Le point de fixation d'un objet tenu en main correspond au point de coordonnée (0,0,0) de l'objet.Son orientation suit la règle suivante :

l'axe X remonte le long de l'avant-bras ;
l'axe Y part depuis le dos de la main vers l'extérieur ;
l'axe Z pointe vers le haut de l'objet tenu fermement en main.

Nous réorientons la peluche gubani dans 3dsmax comme le montre l'image suivante : l'axe X sort du dos du gubani pour remonter le long du bras qui le portera. L'axe Z sort de la main et est donc dans le prolongement de la tête de la peluche :

[[File:22-gubani-peluche-axe-3dsmax.png]]

Après réorientation du modèle gubani et réexportation du shape nous obtenons enfin une peluche qui est tenue par le tronc :

[[File:22-gubani-peluche-axe.png|400px]]

Pour aller plus loin sur les objets portés, je vous conseille de lire ce tutorial : http:''khaganat.net/wikhan/fr:todo:dessiner:creation_d_un_objet_prehensible_en_jeu

== Étape 9 : Créer l’icône pour l'inventaire et la barre d'actions ==

Il faut créer un icône pour l'affichage de l'item peluche gubani dans l'inventaire et dans la barre d'actions.
Cet au icône au format tga doit faire 40x40 pixels avec un fond transparent. Nous le nommerons "icon_teddygubani.tga"

L'icône de 40x40 pixels :

[[File:23-icone-gubani.png|80px]]

Pour des questions de performance, ces icônes ne sont pas stockés individuellement mais regroupés dans une seule image dénommée : "texture_interfaces_v3.tga". Le fichier texte associé dénommé "texture_interfaces_v3.txt" liste les icones présents et leur position dans l'image :

[[File:23-icone-gubani-contexte-txt.png]]

le fichier texte utilise le format suivant pour chaque ligne :

NomFichierIcone u1 v1 u2 v2

Avec :
* u1,v1 la position du point supérieur gauche de l'icône
* u2,v2 la position du coin inférieur droit de l'icône

A la différence des coordonnées en pixels, ces coordonnées qui utilisent la technique du UV Mapping en 3d ont leurs valeurs dans l’intervalle [0 .. 1]. la coordonnée (0,0) correspond au point supérieur gauche de l'image et (1,1) au point inférieur droit de l'image.

Le passage d'un système à l'autre est simple. Soit (x1,y1) la position en pixels du coin haut gauche de notre icône dans l'image globale et (x2,y2) la position du point inférieur droit de l'icône dans l'image, alors :
* u1 = x1 / largeur-image
* v1 = y1 / hauteur-image
* u2 = x2 / largeur-image
* v2 = y2 / hauteur-image

Sachant que la texture "texture_interfaces_v3.tga" fait 1024x1024 pixel, et que dans l'exemple l'icône "icon_teddygubani.tga" se situe à la position (x1=118,y1=798), que le point inférieur gauche étant à la position (x2=157,y2=837), le fichier txt contient donc la ligne :

icon_teddygubani.tga 0.115234375 0.779296875 0.1533203125 0.8173828125

Même si cela peut être ajouté à la main, la bonne méthode et d'utiliser l'outil dédié de NEL ''build_interface'' comme indiqué dans le tutorial https:''khaganat.net/wikhan/fr:todo:dessiner:creer_icone_objet qui recrée la texture globale et le fichier txt à partir d'un dossier contenant tous les icones.

Note: L'ajout de l'icône ne suffit pas, il faut également créer le datasheet de l'objet peluche et spécifier dedans le nom de notre icône à utiliser comme nous le verrons plus loin dans ce tutorial. Au final nous obtenons le résultat suivant IG :

[[File:23-icone-gubani-contexte.png]]

== Etape 11 : créer le fichiers des noms ==

A compléter.

[[File:30-tuto-peluche-txtfile.png]]

== Étape 12 : créer le datasheet ==

A la base, une peluche reste est un objet porté comme une arme. De fait le datasheet de la peluche est trs semblable à celui d'une arme une main, comme l'exemple de la dague ci-dessous.

__icrm1pd.sitem ( datasheet de la dague du réfugié ) :__

<code xml>
<?xml version="1.0"?>
<FORM Revision="$Revision: 1.2 $" State="modified">
<PARENT Filename="_c_m1pd.sitem"/>
<STRUCT>
<STRUCT Name="basics">
<ATOM Name="name" Value="refugee dagger"/>
<ATOM Name="origin" Value="refugee"/>
<ATOM Name="Drop or Sell" Value="false"/>
<ATOM Name="CraftPlan" Value="bcrmea06.sbrick"/>
<ATOM Name="Saleable" Value="false"/>
</STRUCT>
<STRUCT Name="3d">
<ATOM Name="shape" Value="GE_Wea_Dague.shape"/>
<ATOM Name="shape_female" Value="GE_Wea_Dague.shape"/>
<ATOM Name="map_variant" Value="Low Quality"/>
<ATOM Name="icon background" Value="BK_generic.tga"/>
<STRUCT Name="fx">
<ATOM Name="Trail" Value="GE_Wea_Dague_trail_00.shape"/>
</STRUCT>
</STRUCT>
</STRUCT>
<STRUCT/>
<STRUCT/>
<STRUCT/>
<STRUCT/>
<LOG>
</FORM>
<\/pre>

Ce qui change c'est :

* la référénce au shape dans la section "3d"

<ATOM Name="shape" Value="ge_acc_teddy-gubani_01.shape"/>
<ATOM Name="shape_female" Value="ge_acc_teddy-gubani_01.shape"/>

* la référence à l'icone utilisé dans la barre d'état et l'inventaire dans la section "3d"

<ATOM Name="icon" Value="icon_teddygubani.tga"/>
<ATOM Name="icon overlay" Value="icon_teddygubani.tga"/>

* les caractéristiques de base qui diffèrent d'une arme : pas de niveau requis, pas de brique de plan, etc..

<STRUCT Name="basics">
<ATOM Name="name" Value="staff"/>
<ATOM Name="origin" Value="common"/>
<ATOM Name="family" Value="handled item"/>
<ATOM Name="ItemType" Value="Staff"/>
<ATOM Name="Bulk" Value="5"/>
<ATOM Name="RequiredCharacQualityFactor" Value="0"/>
<ATOM Name="RequiredCharacQualityOffset" Value="0"/>
</STRUCT>

Voila donc le datasheet de la peluche gubani que nous nommerons "teddygubani.sitem" :

<code xml>
<?xml version="1.0"?>
<FORM Revision="$Revision: 1.7 $" State="modified">
<PARENT Filename="_c_m1pd.sitem"/>
<STRUCT>
<STRUCT Name="basics">
<ATOM Name="name" Value="staff"/>
<ATOM Name="origin" Value="common"/>
<ATOM Name="family" Value="handled item"/>
<ATOM Name="ItemType" Value="Staff"/>
<ATOM Name="Bulk" Value="5"/>
<ATOM Name="RequiredCharacQualityFactor" Value="0"/>
<ATOM Name="RequiredCharacQualityOffset" Value="0"/>
</STRUCT>
<STRUCT Name="3d">
<ATOM Name="shape" Value="ge_acc_teddy-gubani_01.shape"/>
<ATOM Name="shape_female" Value="ge_acc_teddy-gubani_01.shape"/>
<ATOM Name="map_variant" Value="Low Quality"/>
<ATOM Name="icon" Value="icon_teddygubani.tga"/>
<ATOM Name="icon background" Value="BK_generic.tga"/>
<ATOM Name="icon overlay" Value="icon_teddygubani.tga"/>
<STRUCT Name="fx">
<ATOM Name="Trail" Value="GE_Wea_Dague_trail_00.shape"/>
</STRUCT>
</STRUCT>
</STRUCT>
<STRUCT/>
<STRUCT/>
<STRUCT/>
<STRUCT/>
<LOG></LOG>
</FORM>
<\/pre>

== Étape 13 : Déployer la peluche sur le serveur et le client de jeu ==

Afin de déployer la peluche en jeu la méthode officielle consiste à utiliser la pipeline "build_gamedata" (cf. https:''ryzomcore.atlassian.net/wiki/display/RC/Gamedata+Build+Pipeline). Je vais vous proposer une méthode différente, où les opérations seront effectués à la mains, mais uniquement celles nécessaires à notre peluche :

Nous avons besoin des fichiers suivants :

* teddygubani.sitem ( le datasheet de la peluche gunabi )
* ge_acc_teddy-gubani_01.shape ( le modèle 3d NEL de la peluche )
* ge_acc_teddy-gubani_01.dds ( la texture du modèle 3d )

De plus le déploiement de cette peluche va impacter les fichiers suivants :

* les fichiers "*.packed_sheets" utilisée par le serveur et le client qui sont une version compilé des datasheets
* le fichier "sheet_id.bin" qui est un index de tous les datasheets utilisés par le jeu
* le fichier "visual_slot.tab" qui liste les éléments affichables coté client

Pour bien faire les choses, nous allons également créer un fichier "soft-toy.bnp" qui contiendra les shapes et les textures de toutes les futures peluches.

Pour la suite des opérations nous partons du principe que notre serveur de jeu fonctionne sous linux, et que les variables d'envrionnement suivantes sont définies :

* LEVELDESIGNPATH pointe sur le dossier des datas du level design
* RYZOM_HOME sur l'installation des sources du serveur

=== Ajout du datasheet "teddygubani.sitem au serveur ===

Coté serveur nous allons créer un dossier dédié pour les datasheets des peluches et y placer celui du gubani :

$ mkdir $LEVELDESIGNPATHleveldesigngame_elementsitemsoft-toy
$ cp teddygubani.sitem $LEVELDESIGNPATHleveldesigngame_elementsitemsoft-toy

=== Nettoyages préalables ===

=== Re-générer le fichier "sheet_id.bin" ===

La première étape consiste à regénérer le fichier d'index des datasheet via la commande "make_sheet_id". Il reprend le fichier d'index existant et va le compléter avec les datasheets du dossier $RYZOM_LEVELPATH/leveldesign/game_element/sitem/soft-toy c'est-à-dire les datasheets de nos peluches

$ make_sheet_id -o$LEVELDESIGNPATH/leveldesign/Game_elem/sheet_id.bin $LEVELDESIGNPATH/leveldesign/game_element/sitem/soft-toy

=== Re-générer les "*.packed_sheets" et "visual_slot.tab" ===

Il faut regénérer les "*.packed_sheets".Ce sont les versions pré-compilées des datasheets :

$ sheets_packer

Cette commande va également re-générer le fichier visual_slot.tab

=== Copier les fichiers nécessaires coté client ===

* Nous copions le fichier "visual_slot.tab" généré dans le dossier courant dans le dossier "user" du client de jeu
* Nous copions le fichier $LEVELDESIGNPATH/leveldesign/Game_elem/sheet_id.bin dans le dossier "user" du client de jeu
* Nous remplaçons les fichiers packet_sheets du dossier "data" du client par ceux générés ici $RYZOM_HOME/code/ryzom/client/data/*.packed_sheets par la commande ''sheets_packer''

=== Créer un bnp pour le modèle de la peluche ===

Pour finir il faut copier le shape et la texture de la peluche dans le dossier "data" du client.
Cependant pour bien faire les choses, autant créer un fichier ".bnp" dédié.
Un fichier ".bnp" est une sorte de zip regroupant les différents fichiers shape, dds, txt, ou autres par thème.

Créer on dossier "soft-toy", copions y tous les shapes et textures de nos peluche, à savoir pour le moment "ge_acc_teddy-gubani_01.shape" et "ge_acc_teddy-gubani_01.dds" et créons un fichier BNP pour les contenur

bnp_make /p soft-toy

La commande va créer un fichier "soft-toy,bnp" qui contiendra nos deux fichiers. A présent il faut le copier dans le dossier "data" du client.

=== Tester IG ===

Relancer le serveur avec la commande ''shard start'' puis connectez vous avec votre client.

Si tout c'est bien déroulé, en lançant votre client de jeu, vous pouvez créer une peluche dans votre inventaire avec la commande :

/a createItemInBag teddygubani 1 5

{{tag>Tag_a_ajouter}}

FR Peluche

2014-07-25T20:31:56Z

Madi: /* Étape 1: choisir le modèle qui servira pour notre peluche */

= Objets du mois : Déployer en Jeu des peluches « mobs d'atys » =

[[File:00-tuto-peluche.png|300px]]

Le but de ce tutorial est de montrer comment réaliser des peluches basées sur les modèles des animaux atysiens.

Pré-requis pour modéliser uniquement la peluche :

* Avoir installé les assets ryzom et configuré correctement les lecteurs (les outils NEL s'attendent à trouver les données des assets dans le dossier ( W:database ).
* Avoir installé 3DSMax et configuré le plugin NEL ( Attention le plugin ne fonctionne qu'avec les version 32bits de 3DSmax et de la versions 9 à la version 2012).
* Conseillé mais non nécessaire : avoir installé l'outil NEL "''tga2dds.exe''".

Pré-requis pour déployer la peluche sur un serveur de jeu :

* Avoir compilé et installé un serveur de jeu et configuré un client pour l'utiliser

Note : il est possible de tester cette peluche IG sans disposer d'un serveur de jeu via une astuce qui sera expliquée plus loin dans ce tutoriel.

Quelques liens utiles pour ces pré-requis :

* Liens de téléchargement des assets et outils : https:''ryzomcore.atlassian.net/wiki/display/RC/Downloads+for+Windows
* Configuration des lecteurs :https:''ryzomcore.atlassian.net/wiki/display/RC/How+to+set+up+the+Build+Pipeline
* Installation du plugin NEL de 3dsmax :https:''ryzomcore.atlassian.net/wiki/display/RC/Installing+the+Max+Plugins

== Étape 1: choisir le modèle qui servira pour notre peluche ==

L'ensemble des modèles 3d de la faune de ryzom sont regroupés dans le dossier « W:\database\stuff\tryker\agents\monsters » par famille de créature. Dans ce tutorial nous allons utiliser le modèle du « Gubani » qui est situé dans le sous-dossier des créatures « chevalines » pour réaliser notre peluche :

W:\database\stuff\tryker\agents\monsters\cheval\h12tr_mo_h12.max

[[File:01-tuto-peluche-dossiers-mobs.png|600px]]

== Étape 2 : Reprendre le modèle et se créer un dossier dédié pour travailler ==

Dans 3ds max ouvrir le fichier « W:databasestufftrykeragentsmonsterschevalh12tr_mo_h12.max »

Nous consultons la liste des fichiers utilisés par le modèle, notamment les textures via le menu => «Fichier» => « Manage » => « Asset Tracking ». On note deux fichiers :

* Le modèle 3d : « tr_mo_h12.max »
* La texture du gubani « ju_mo_h12.png »

[[File:02-tuto-peluche-asset-tracking.png|800px]]

Le but ici étant de déployer des peluches monstres pour les objets du mois, nous allons donc se créer un dossier dédié pour nos futures peluches et respecter les conventions de nomination de ryzom.

Nous allons donc créer un dossier « soft-toy » dans le dossier « W:databasestuffgeneriqueagentsaccessories ». Nous y sauvegarderons notre modèle en le renommant : ge_acc_teddy-gubani_01.max

* le premier préfixe «ge_» du nom de fichier est pour spécifier l'écosystème, ici __gé__nérique (tr : tryker, fy : fyros, etc...)
* le second préfixe du nom du fichier est pour spécifier le type de modèle ( hom : homin masculin, mo : monstre, wea weapon, etc... ), ici « acc » pour __acc__essoire.
* Enfin le nom de notre modèle « teddy-gubani » que nous suffixons par un numéro afin de pouvoir créer plusieurs variantes de peluches gubani.

Pour la texture, nous devrions aussi la copier dans « W:databasestuffgeneriqueagents_texturesaccessories », mais nous allons faire plus simple. Nous allons la mettre dans le même dossier que le modèle 3d et la renommer en suivant la même convention : « ge_acc_teddy-gubani_01.png »

Cependant, le moteur de ryzom ne sait afficher que les textures au format ".tga" ou ".dds". TGA est un format brut sans compression ce qui le rend pratique pour l'édition mais moins performant en espace mémoire occupé. le format DDS est un format d'image compressée qui comme le jpep est destructeur. C'est le format utilisé en interne par ryzom pour minimiser l'espace des textures en mémoire. Avec votre éditeur préféré convertissez l'image ".png" en ".tga". C'est elle-ci que nous garderons pour l'édition. Nous allons utiliser l'outil NEL "''tga2dds''" pour générer une image texture au format ".dds" pour le modèle 3d. C'est celle que nous utiliserons dans 3dsmax

tga2dds ge_acc_teddy-gubani_01.tga

Si vous n'avez pas l'outil, vous pouvez garder la version ".tga". Elle fonctionne pour les tests IG.
Dans le dossier soft-toy vous devriez avoir comme résultat :

[[File:03-tuto-peluche-dossier-soft-toy.png|600px]]

== Étape 3 : Nettoyer le modèle 3D sous 3dsmax ==

Le modèle 3D du monstre contient un squelette et toutes ce qu'il faut pour l'animer. Cela n'est pas nécessaire pour un accessoire peluche et surchargerait inutilement le modèle ryzom final. Nous allons dons les supprimer.

[[File:04-tuto-peluche-animation.png|800px]]

Sélectionner le modèle "Gubani" avec la souris. Dans le panneau latéral droit, sélectionner l'onglet "''modify''". Vous devez voir apparaître le mesh dénommé "TR_MO_H12" et dans la pile des "''modifiers''" celui nommé "physique". Nous allons le supprimer

[[File:05-tuto-peluche-physique.png|600px]]

Ensuite nous allons ouvrir l'écran affichant les éléments de la scene via le menu "Tools"=> "New Scene Explorer" et supprimer tous les éléments constituant le squelette du modèle pour ne garder au final que le mesh de l'animal.

[[File:06-tuto-peluche-bones-01.png|800px]]

Au final nous n'avons plus qu'un seul élément dans notre "scène" : le mesh du gubani "TR_MO_H12" :

[[File:07-tuto-peluche-nettoyer-modele.png|800px]]

Dans le panneau latéral droit, nous allons renommer ce mesh en "ge_acc_tedy-gubani_01". C'est ce nom qui sera utilisé par l'export "NEL" pour nommer le fichier "shape" généré lors de l'export.

[[File:07-tuto-peluche-nettoyer-modele-fin.png|800px]]

== Étape 4 : Modifier le mapping des textures du modèle ==

Dans cette partie, nous allons revoir la texturation du modèle 3d. A priori, il faudrait juste changer la texture de base «ju_mo_h12.png» pour pointer sur la notre «ge_acc_teddy-gubani_01.dds» (ou «.tga» à défaut) puis l'adapter comme nous le voulons visuellement. Cependant, cela va être un peu plus compliqué :

Nous allons d'abord ouvrir l'écran "Material Editor" (1), puis sélectionner le seul matériel de la scène (2) en double cliquant dessus. Dans l'écran centrale sélectionnez le noeud dénommé "Map #1 Nel Multi Bitmap" en double cliquant dessus (3). Vous verrez alors s'afficher dans le panneau latéral de droite le détail de ses propriétés (4). Le "Nel Multi Bitmap" permet de définir 8 images différentes. Il ne s'agit pas de multi-texturing, mais de la possibilité de configurer plusieurs images de texture. Seule une est appliqué à un instant donné sur le modèle. Cela est utilisé pour les mobs pour spécifier une texture par écosystème et par certains objets environnementaux pour spécifier une texture différente par saison.

[[File:08-tuto-peluche-texture.png|800px]]
Le slot ID 1 est utilisé pour les textures de l'écosystème tryker, le second (ID 2) pour l'écosystème fyros, le troisième (ID 3) pour l'écosystème zoraï et le quatrième (ID 4) pour l'écosystème des primes racines. Ne cherchez pas de slot matis, en bon esthètes, ils ont compris que la beauté résidait dans la nature zoraï et utilisent donc les textures zoraï pour tous leurs animaux. Notez qu'ici le gubani n'étant présent qu'en jungle et en primes racines, seuls les slots 3 et 4 sont utilisés

Le même système est aussi utilisé pour d'autres objets IG, comme les bâtiments.dans ce cas, les 4 slots correspondent aux quatre saisons. C'est ainsi que l'on peut noter la présence de neige sur certaines bâtisses zoraï en hiver.

[[File:09-tuto-peluche-multi-texture.png]]

De notre coté nous n'allons pas utilisé ce mécanisme. Nous allons donc supprimé le "NEL Multi Bitmap" et le remplacer par un simple "Bitmap" en tirant avec la souris sur la sortie de la "''tTexture 1''" comme le montre l'image ci-dessus. En relâchant la souris, un menu contextuel apparait (2), sélectionner l'entrée "Bitmap" :

[[File:10-tuto-peluche-bitmap.png|800px]]

Puis aller chercher notre image dans "W:databasestuffgeneriqueagents_texturesaccessoriessoft-toyge_acc_teddy-gubani_01.dds" (ou ".tga").

[[File:11-tuto-peluche-bitmap.png|800px]]

Répéter l'opération pour l'autre "Nel Multi Bitmap" qui référence la même image.

== Étape 5 : Mise à échelle du modèle ==

Note modèle 3d est presque prêt à l'emploi. Cependant sa taille ne correspond pas à celle attendue d'une peluche. Si vous utilisez l'outil de mesure de 3dsmax vous verrez que le gubani mesure plus 2m de haut. Le plus simple pour le mettre à la bonne taille est de charger un modèle d'homin afin d'avoir un comparatif visuel et s'assurer que la peluche peut être prise en main.

On va donc insérer temporairement dans notre scène 3dsmax une référence vers un autre modèle 3d en passant par le menu Fichier (1) => References (2) => Xref Scène (3) et en cliquant sur le bouton Add (4) de la fenêtre qui apparait :

[[File:15-tuto-peluche-xref.png|800px]]

Sélectionner alors le modèle d'homin "W:databasestuffgeneriqueagentsactorsmalege_hom_armor02.max" qui devrait apparaître dans votre scène 3d.

[[File:15-tuto-peluche-xref-02.png]]

Mettre a échelle le modèle de gubani et le déplacer via les outils "Scale" et "Move" du menu contextuel apparaissant lorsqu'on clique sur le modèle avec le bouton droit de la souris.

[[File:16-tuto-peluche-echelle.png]]

Une fois la peluche à la bonne échelle, il ne reste plus qu'a supprimer la référence au modèle d'homin en repassant par le menu Fichier => References => Xref Scene.

Repositionner le modèle gubani à l'origine de la scène (x=0, y=0, z=0), car lorsqu'un objet est porté la position (0,0,0) se place au niveau de la main.

== Étape 6 : modifier la texture pour un rendu peluche ==

Au niveau de la texture, pour donner un effet peluche, laissez libre court à votre imagination

[[File:17-tuto-peluche-texture-source.png]]

Ici j'ai édité l'image "ge_acc_teddy-gubani_01.tga" dans l'outil Gimp. J'ai utilisé le filtre "Artistiques > GIMPressioniste" en utilisant le modèle "canvas" pour obtenir un effet trame de tissu.

[[File:17-tuto-peluche-texture-peluche.png]]

Une fois l'image sauvegardée, j'ai re-généré la texture au format ".dds" via la commande :

tga2dds ge_acc_teddy-gubani_01.tga

Voila le résultat obtenu sur le modèle 3d dans 3dsmax :

[[File:18-tuto-peluche-modele3d.png]]

== Étape 7 : Export du shape ==

Il est temps de tester cette peluche en jeu. Pour cela il va falloir exporter le modèle en générant le fichier "shape" utilisé par le moteur Ryzom

Si ce n'est pas déjà je cas, ajouter le bouton ''d'export NEL'' au panneau latéral droit en cliquant sur l'onglet "''utilities''", puis "''More''" et en sélectionnant l'option "''NEL Export''" :

[[File:20-tuto-peluche-export-nel-01.png]]

Ensuite sélectionner le mesh du gubani puis cliquer sur le bouton "Export Model". Il vous faut alors spécifier le dossier où sera crée le fichier "ge_acc_teddy-gubani-01.shape"

[[File:20-tuto-peluche-export-nel-02.png]]

== Étape 8 : Tester la peluche IG ==

Pour bien faire les choses, il faudrait ajouter le ''datasheet'' de la peluche au serveur de jeu et patcher le client. Cette méthode sera détaillée plus loin. Cependant il existe une solution de contournement si vous n'avez pas votre propre serveur de jeu pour réaliser ces opérations.

Il faut savoir qu'une peluche n'est rien d'autre qu'une arme équipée. Ainsi nous pourrions remplacer le modèle de la dague par celui de notre gubani pour le tester sur le serveur officiel. Il existe une astuce simple pour cela. Le client de jeu recherche les modèles et textures dans le dossier "user" avant d'aller voir le dossier "data". Il suffit de copier notre fichier shape et la texture associée dans le dossier "user", puis de renommer le shape du gubani en celui de la dague : "GE_Wea_Dague.shape"

A présent lorsque vous équiperez une dague IG, vous aurez en main notre peluche "gubani".
Pour retrouver la dague d'origine, il suffit de supprimer le fichier shape du dossier "user" :

[[File:21-gubani-peluche-axe.png|400px]]

En réalisant ce test vous pouvez noter une anomalie : la peluche est tenue par le pied, ce qui n'est pas forcément ce que nous voulons

== Étape 9 : orientation et positionnement d'un objet porté ==

Le point de fixation d'un objet tenu en main correspond au point de coordonnée (0,0,0) de l'objet.Son orientation suit la règle suivante :

l'axe X remonte le long de l'avant-bras ;
l'axe Y part depuis le dos de la main vers l'extérieur ;
l'axe Z pointe vers le haut de l'objet tenu fermement en main.

Nous réorientons la peluche gubani dans 3dsmax comme le montre l'image suivante : l'axe X sort du dos du gubani pour remonter le long du bras qui le portera. L'axe Z sort de la main et est donc dans le prolongement de la tête de la peluche :

[[File:22-gubani-peluche-axe-3dsmax.png]]

Après réorientation du modèle gubani et réexportation du shape nous obtenons enfin une peluche qui est tenue par le tronc :

[[File:22-gubani-peluche-axe.png|400px]]

Pour aller plus loin sur les objets portés, je vous conseille de lire ce tutorial : http:''khaganat.net/wikhan/fr:todo:dessiner:creation_d_un_objet_prehensible_en_jeu

== Étape 9 : Créer l’icône pour l'inventaire et la barre d'actions ==

Il faut créer un icône pour l'affichage de l'item peluche gubani dans l'inventaire et dans la barre d'actions.
Cet au icône au format tga doit faire 40x40 pixels avec un fond transparent. Nous le nommerons "icon_teddygubani.tga"

L'icône de 40x40 pixels :

[[File:23-icone-gubani.png|80px]]

Pour des questions de performance, ces icônes ne sont pas stockés individuellement mais regroupés dans une seule image dénommée : "texture_interfaces_v3.tga". Le fichier texte associé dénommé "texture_interfaces_v3.txt" liste les icones présents et leur position dans l'image :

[[File:23-icone-gubani-contexte-txt.png]]

le fichier texte utilise le format suivant pour chaque ligne :

NomFichierIcone u1 v1 u2 v2

Avec :
* u1,v1 la position du point supérieur gauche de l'icône
* u2,v2 la position du coin inférieur droit de l'icône

A la différence des coordonnées en pixels, ces coordonnées qui utilisent la technique du UV Mapping en 3d ont leurs valeurs dans l’intervalle [0 .. 1]. la coordonnée (0,0) correspond au point supérieur gauche de l'image et (1,1) au point inférieur droit de l'image.

Le passage d'un système à l'autre est simple. Soit (x1,y1) la position en pixels du coin haut gauche de notre icône dans l'image globale et (x2,y2) la position du point inférieur droit de l'icône dans l'image, alors :
* u1 = x1 / largeur-image
* v1 = y1 / hauteur-image
* u2 = x2 / largeur-image
* v2 = y2 / hauteur-image

Sachant que la texture "texture_interfaces_v3.tga" fait 1024x1024 pixel, et que dans l'exemple l'icône "icon_teddygubani.tga" se situe à la position (x1=118,y1=798), que le point inférieur gauche étant à la position (x2=157,y2=837), le fichier txt contient donc la ligne :

icon_teddygubani.tga 0.115234375 0.779296875 0.1533203125 0.8173828125

Même si cela peut être ajouté à la main, la bonne méthode et d'utiliser l'outil dédié de NEL ''build_interface'' comme indiqué dans le tutorial https:''khaganat.net/wikhan/fr:todo:dessiner:creer_icone_objet qui recrée la texture globale et le fichier txt à partir d'un dossier contenant tous les icones.

Note: L'ajout de l'icône ne suffit pas, il faut également créer le datasheet de l'objet peluche et spécifier dedans le nom de notre icône à utiliser comme nous le verrons plus loin dans ce tutorial. Au final nous obtenons le résultat suivant IG :

[[File:23-icone-gubani-contexte.png]]

== Etape 11 : créer le fichiers des noms ==

A compléter.

[[File:30-tuto-peluche-txtfile.png]]

== Étape 12 : créer le datasheet ==

A la base, une peluche reste est un objet porté comme une arme. De fait le datasheet de la peluche est trs semblable à celui d'une arme une main, comme l'exemple de la dague ci-dessous.

__icrm1pd.sitem ( datasheet de la dague du réfugié ) :__

<code xml>
<?xml version="1.0"?>
<FORM Revision="$Revision: 1.2 $" State="modified">
<PARENT Filename="_c_m1pd.sitem"/>
<STRUCT>
<STRUCT Name="basics">
<ATOM Name="name" Value="refugee dagger"/>
<ATOM Name="origin" Value="refugee"/>
<ATOM Name="Drop or Sell" Value="false"/>
<ATOM Name="CraftPlan" Value="bcrmea06.sbrick"/>
<ATOM Name="Saleable" Value="false"/>
</STRUCT>
<STRUCT Name="3d">
<ATOM Name="shape" Value="GE_Wea_Dague.shape"/>
<ATOM Name="shape_female" Value="GE_Wea_Dague.shape"/>
<ATOM Name="map_variant" Value="Low Quality"/>
<ATOM Name="icon background" Value="BK_generic.tga"/>
<STRUCT Name="fx">
<ATOM Name="Trail" Value="GE_Wea_Dague_trail_00.shape"/>
</STRUCT>
</STRUCT>
</STRUCT>
<STRUCT/>
<STRUCT/>
<STRUCT/>
<STRUCT/>
<LOG>
</FORM>
<\/pre>

Ce qui change c'est :

* la référénce au shape dans la section "3d"

<ATOM Name="shape" Value="ge_acc_teddy-gubani_01.shape"/>
<ATOM Name="shape_female" Value="ge_acc_teddy-gubani_01.shape"/>

* la référence à l'icone utilisé dans la barre d'état et l'inventaire dans la section "3d"

<ATOM Name="icon" Value="icon_teddygubani.tga"/>
<ATOM Name="icon overlay" Value="icon_teddygubani.tga"/>

* les caractéristiques de base qui diffèrent d'une arme : pas de niveau requis, pas de brique de plan, etc..

<STRUCT Name="basics">
<ATOM Name="name" Value="staff"/>
<ATOM Name="origin" Value="common"/>
<ATOM Name="family" Value="handled item"/>
<ATOM Name="ItemType" Value="Staff"/>
<ATOM Name="Bulk" Value="5"/>
<ATOM Name="RequiredCharacQualityFactor" Value="0"/>
<ATOM Name="RequiredCharacQualityOffset" Value="0"/>
</STRUCT>

Voila donc le datasheet de la peluche gubani que nous nommerons "teddygubani.sitem" :

<code xml>
<?xml version="1.0"?>
<FORM Revision="$Revision: 1.7 $" State="modified">
<PARENT Filename="_c_m1pd.sitem"/>
<STRUCT>
<STRUCT Name="basics">
<ATOM Name="name" Value="staff"/>
<ATOM Name="origin" Value="common"/>
<ATOM Name="family" Value="handled item"/>
<ATOM Name="ItemType" Value="Staff"/>
<ATOM Name="Bulk" Value="5"/>
<ATOM Name="RequiredCharacQualityFactor" Value="0"/>
<ATOM Name="RequiredCharacQualityOffset" Value="0"/>
</STRUCT>
<STRUCT Name="3d">
<ATOM Name="shape" Value="ge_acc_teddy-gubani_01.shape"/>
<ATOM Name="shape_female" Value="ge_acc_teddy-gubani_01.shape"/>
<ATOM Name="map_variant" Value="Low Quality"/>
<ATOM Name="icon" Value="icon_teddygubani.tga"/>
<ATOM Name="icon background" Value="BK_generic.tga"/>
<ATOM Name="icon overlay" Value="icon_teddygubani.tga"/>
<STRUCT Name="fx">
<ATOM Name="Trail" Value="GE_Wea_Dague_trail_00.shape"/>
</STRUCT>
</STRUCT>
</STRUCT>
<STRUCT/>
<STRUCT/>
<STRUCT/>
<STRUCT/>
<LOG></LOG>
</FORM>
<\/pre>

== Étape 13 : Déployer la peluche sur le serveur et le client de jeu ==

Afin de déployer la peluche en jeu la méthode officielle consiste à utiliser la pipeline "build_gamedata" (cf. https:''ryzomcore.atlassian.net/wiki/display/RC/Gamedata+Build+Pipeline). Je vais vous proposer une méthode différente, où les opérations seront effectués à la mains, mais uniquement celles nécessaires à notre peluche :

Nous avons besoin des fichiers suivants :

* teddygubani.sitem ( le datasheet de la peluche gunabi )
* ge_acc_teddy-gubani_01.shape ( le modèle 3d NEL de la peluche )
* ge_acc_teddy-gubani_01.dds ( la texture du modèle 3d )

De plus le déploiement de cette peluche va impacter les fichiers suivants :

* les fichiers "*.packed_sheets" utilisée par le serveur et le client qui sont une version compilé des datasheets
* le fichier "sheet_id.bin" qui est un index de tous les datasheets utilisés par le jeu
* le fichier "visual_slot.tab" qui liste les éléments affichables coté client

Pour bien faire les choses, nous allons également créer un fichier "soft-toy.bnp" qui contiendra les shapes et les textures de toutes les futures peluches.

Pour la suite des opérations nous partons du principe que notre serveur de jeu fonctionne sous linux, et que les variables d'envrionnement suivantes sont définies :

* LEVELDESIGNPATH pointe sur le dossier des datas du level design
* RYZOM_HOME sur l'installation des sources du serveur

=== Ajout du datasheet "teddygubani.sitem au serveur ===

Coté serveur nous allons créer un dossier dédié pour les datasheets des peluches et y placer celui du gubani :

$ mkdir $LEVELDESIGNPATHleveldesigngame_elementsitemsoft-toy
$ cp teddygubani.sitem $LEVELDESIGNPATHleveldesigngame_elementsitemsoft-toy

=== Nettoyages préalables ===

=== Re-générer le fichier "sheet_id.bin" ===

La première étape consiste à regénérer le fichier d'index des datasheet via la commande "make_sheet_id". Il reprend le fichier d'index existant et va le compléter avec les datasheets du dossier $RYZOM_LEVELPATH/leveldesign/game_element/sitem/soft-toy c'est-à-dire les datasheets de nos peluches

$ make_sheet_id -o$LEVELDESIGNPATH/leveldesign/Game_elem/sheet_id.bin $LEVELDESIGNPATH/leveldesign/game_element/sitem/soft-toy

=== Re-générer les "*.packed_sheets" et "visual_slot.tab" ===

Il faut regénérer les "*.packed_sheets".Ce sont les versions pré-compilées des datasheets :

$ sheets_packer

Cette commande va également re-générer le fichier visual_slot.tab

=== Copier les fichiers nécessaires coté client ===

* Nous copions le fichier "visual_slot.tab" généré dans le dossier courant dans le dossier "user" du client de jeu
* Nous copions le fichier $LEVELDESIGNPATH/leveldesign/Game_elem/sheet_id.bin dans le dossier "user" du client de jeu
* Nous remplaçons les fichiers packet_sheets du dossier "data" du client par ceux générés ici $RYZOM_HOME/code/ryzom/client/data/*.packed_sheets par la commande ''sheets_packer''

=== Créer un bnp pour le modèle de la peluche ===

Pour finir il faut copier le shape et la texture de la peluche dans le dossier "data" du client.
Cependant pour bien faire les choses, autant créer un fichier ".bnp" dédié.
Un fichier ".bnp" est une sorte de zip regroupant les différents fichiers shape, dds, txt, ou autres par thème.

Créer on dossier "soft-toy", copions y tous les shapes et textures de nos peluche, à savoir pour le moment "ge_acc_teddy-gubani_01.shape" et "ge_acc_teddy-gubani_01.dds" et créons un fichier BNP pour les contenur

bnp_make /p soft-toy

La commande va créer un fichier "soft-toy,bnp" qui contiendra nos deux fichiers. A présent il faut le copier dans le dossier "data" du client.

=== Tester IG ===

Relancer le serveur avec la commande ''shard start'' puis connectez vous avec votre client.

Si tout c'est bien déroulé, en lançant votre client de jeu, vous pouvez créer une peluche dans votre inventaire avec la commande :

/a createItemInBag teddygubani 1 5

{{tag>Tag_a_ajouter}}

FR Peluche

2014-07-25T19:38:52Z

Madi: Created page with "= Objets du mois : Déployer en Jeu des peluches « mobs d'atys » = 300px Le but de ce tutorial est de montrer comment réaliser des peluches..."

= Objets du mois : Déployer en Jeu des peluches « mobs d'atys » =

[[File:00-tuto-peluche.png|300px]]

Le but de ce tutorial est de montrer comment réaliser des peluches basées sur les modèles des animaux atysiens.

Pré-requis pour modéliser uniquement la peluche :

* Avoir installé les assets ryzom et configuré correctement les lecteurs (les outils NEL s'attendent à trouver les données des assets dans le dossier ( W:database ).
* Avoir installé 3DSMax et configuré le plugin NEL ( Attention le plugin ne fonctionne qu'avec les version 32bits de 3DSmax et de la versions 9 à la version 2012).
* Conseillé mais non nécessaire : avoir installé l'outil NEL "''tga2dds.exe''".

Pré-requis pour déployer la peluche sur un serveur de jeu :

* Avoir compilé et installé un serveur de jeu et configuré un client pour l'utiliser

Note : il est possible de tester cette peluche IG sans disposer d'un serveur de jeu via une astuce qui sera expliquée plus loin dans ce tutoriel.

Quelques liens utiles pour ces pré-requis :

* Liens de téléchargement des assets et outils : https:''ryzomcore.atlassian.net/wiki/display/RC/Downloads+for+Windows
* Configuration des lecteurs :https:''ryzomcore.atlassian.net/wiki/display/RC/How+to+set+up+the+Build+Pipeline
* Installation du plugin NEL de 3dsmax :https:''ryzomcore.atlassian.net/wiki/display/RC/Installing+the+Max+Plugins

== Étape 1: choisir le modèle qui servira pour notre peluche ==

L'ensemble des modèles 3d de la faune de ryzom sont regroupés dans le dossier « W:databasestufftrykeragentsmonsters » par famille de créature. Dans ce tutorial nous allons utiliser le modèle du « Gubani » qui est situé dans le sous-dossier des créatures « chevalines » pour réaliser notre peluche :

W:databasestufftrykeragentsmonsterschevalh12tr_mo_h12.max

[[File:01-tuto-peluche-dossiers-mobs.png|600px]]

== Étape 2 : Reprendre le modèle et se créer un dossier dédié pour travailler ==

Dans 3ds max ouvrir le fichier « W:databasestufftrykeragentsmonsterschevalh12tr_mo_h12.max »

Nous consultons la liste des fichiers utilisés par le modèle, notamment les textures via le menu => «Fichier» => « Manage » => « Asset Tracking ». On note deux fichiers :

* Le modèle 3d : « tr_mo_h12.max »
* La texture du gubani « ju_mo_h12.png »

[[File:02-tuto-peluche-asset-tracking.png|800px]]

Le but ici étant de déployer des peluches monstres pour les objets du mois, nous allons donc se créer un dossier dédié pour nos futures peluches et respecter les conventions de nomination de ryzom.

Nous allons donc créer un dossier « soft-toy » dans le dossier « W:databasestuffgeneriqueagentsaccessories ». Nous y sauvegarderons notre modèle en le renommant : ge_acc_teddy-gubani_01.max

* le premier préfixe «ge_» du nom de fichier est pour spécifier l'écosystème, ici __gé__nérique (tr : tryker, fy : fyros, etc...)
* le second préfixe du nom du fichier est pour spécifier le type de modèle ( hom : homin masculin, mo : monstre, wea weapon, etc... ), ici « acc » pour __acc__essoire.
* Enfin le nom de notre modèle « teddy-gubani » que nous suffixons par un numéro afin de pouvoir créer plusieurs variantes de peluches gubani.

Pour la texture, nous devrions aussi la copier dans « W:databasestuffgeneriqueagents_texturesaccessories », mais nous allons faire plus simple. Nous allons la mettre dans le même dossier que le modèle 3d et la renommer en suivant la même convention : « ge_acc_teddy-gubani_01.png »

Cependant, le moteur de ryzom ne sait afficher que les textures au format ".tga" ou ".dds". TGA est un format brut sans compression ce qui le rend pratique pour l'édition mais moins performant en espace mémoire occupé. le format DDS est un format d'image compressée qui comme le jpep est destructeur. C'est le format utilisé en interne par ryzom pour minimiser l'espace des textures en mémoire. Avec votre éditeur préféré convertissez l'image ".png" en ".tga". C'est elle-ci que nous garderons pour l'édition. Nous allons utiliser l'outil NEL "''tga2dds''" pour générer une image texture au format ".dds" pour le modèle 3d. C'est celle que nous utiliserons dans 3dsmax

tga2dds ge_acc_teddy-gubani_01.tga

Si vous n'avez pas l'outil, vous pouvez garder la version ".tga". Elle fonctionne pour les tests IG.
Dans le dossier soft-toy vous devriez avoir comme résultat :

[[File:03-tuto-peluche-dossier-soft-toy.png|600px]]

== Étape 3 : Nettoyer le modèle 3D sous 3dsmax ==

Le modèle 3D du monstre contient un squelette et toutes ce qu'il faut pour l'animer. Cela n'est pas nécessaire pour un accessoire peluche et surchargerait inutilement le modèle ryzom final. Nous allons dons les supprimer.

[[File:04-tuto-peluche-animation.png|800px]]

Sélectionner le modèle "Gubani" avec la souris. Dans le panneau latéral droit, sélectionner l'onglet "''modify''". Vous devez voir apparaître le mesh dénommé "TR_MO_H12" et dans la pile des "''modifiers''" celui nommé "physique". Nous allons le supprimer

[[File:05-tuto-peluche-physique.png|600px]]

Ensuite nous allons ouvrir l'écran affichant les éléments de la scene via le menu "Tools"=> "New Scene Explorer" et supprimer tous les éléments constituant le squelette du modèle pour ne garder au final que le mesh de l'animal.

[[File:06-tuto-peluche-bones-01.png|800px]]

Au final nous n'avons plus qu'un seul élément dans notre "scène" : le mesh du gubani "TR_MO_H12" :

[[File:07-tuto-peluche-nettoyer-modele.png|800px]]

Dans le panneau latéral droit, nous allons renommer ce mesh en "ge_acc_tedy-gubani_01". C'est ce nom qui sera utilisé par l'export "NEL" pour nommer le fichier "shape" généré lors de l'export.

[[File:07-tuto-peluche-nettoyer-modele-fin.png|800px]]

== Étape 4 : Modifier le mapping des textures du modèle ==

Dans cette partie, nous allons revoir la texturation du modèle 3d. A priori, il faudrait juste changer la texture de base «ju_mo_h12.png» pour pointer sur la notre «ge_acc_teddy-gubani_01.dds» (ou «.tga» à défaut) puis l'adapter comme nous le voulons visuellement. Cependant, cela va être un peu plus compliqué :

Nous allons d'abord ouvrir l'écran "Material Editor" (1), puis sélectionner le seul matériel de la scène (2) en double cliquant dessus. Dans l'écran centrale sélectionnez le noeud dénommé "Map #1 Nel Multi Bitmap" en double cliquant dessus (3). Vous verrez alors s'afficher dans le panneau latéral de droite le détail de ses propriétés (4). Le "Nel Multi Bitmap" permet de définir 8 images différentes. Il ne s'agit pas de multi-texturing, mais de la possibilité de configurer plusieurs images de texture. Seule une est appliqué à un instant donné sur le modèle. Cela est utilisé pour les mobs pour spécifier une texture par écosystème et par certains objets environnementaux pour spécifier une texture différente par saison.

[[File:08-tuto-peluche-texture.png|800px]]
Le slot ID 1 est utilisé pour les textures de l'écosystème tryker, le second (ID 2) pour l'écosystème fyros, le troisième (ID 3) pour l'écosystème zoraï et le quatrième (ID 4) pour l'écosystème des primes racines. Ne cherchez pas de slot matis, en bon esthètes, ils ont compris que la beauté résidait dans la nature zoraï et utilisent donc les textures zoraï pour tous leurs animaux. Notez qu'ici le gubani n'étant présent qu'en jungle et en primes racines, seuls les slots 3 et 4 sont utilisés

Le même système est aussi utilisé pour d'autres objets IG, comme les bâtiments.dans ce cas, les 4 slots correspondent aux quatre saisons. C'est ainsi que l'on peut noter la présence de neige sur certaines bâtisses zoraï en hiver.

[[File:09-tuto-peluche-multi-texture.png]]

De notre coté nous n'allons pas utilisé ce mécanisme. Nous allons donc supprimé le "NEL Multi Bitmap" et le remplacer par un simple "Bitmap" en tirant avec la souris sur la sortie de la "''tTexture 1''" comme le montre l'image ci-dessus. En relâchant la souris, un menu contextuel apparait (2), sélectionner l'entrée "Bitmap" :

[[File:10-tuto-peluche-bitmap.png|800px]]

Puis aller chercher notre image dans "W:databasestuffgeneriqueagents_texturesaccessoriessoft-toyge_acc_teddy-gubani_01.dds" (ou ".tga").

[[File:11-tuto-peluche-bitmap.png|800px]]

Répéter l'opération pour l'autre "Nel Multi Bitmap" qui référence la même image.

== Étape 5 : Mise à échelle du modèle ==

Note modèle 3d est presque prêt à l'emploi. Cependant sa taille ne correspond pas à celle attendue d'une peluche. Si vous utilisez l'outil de mesure de 3dsmax vous verrez que le gubani mesure plus 2m de haut. Le plus simple pour le mettre à la bonne taille est de charger un modèle d'homin afin d'avoir un comparatif visuel et s'assurer que la peluche peut être prise en main.

On va donc insérer temporairement dans notre scène 3dsmax une référence vers un autre modèle 3d en passant par le menu Fichier (1) => References (2) => Xref Scène (3) et en cliquant sur le bouton Add (4) de la fenêtre qui apparait :

[[File:15-tuto-peluche-xref.png|800px]]

Sélectionner alors le modèle d'homin "W:databasestuffgeneriqueagentsactorsmalege_hom_armor02.max" qui devrait apparaître dans votre scène 3d.

[[File:15-tuto-peluche-xref-02.png]]

Mettre a échelle le modèle de gubani et le déplacer via les outils "Scale" et "Move" du menu contextuel apparaissant lorsqu'on clique sur le modèle avec le bouton droit de la souris.

[[File:16-tuto-peluche-echelle.png]]

Une fois la peluche à la bonne échelle, il ne reste plus qu'a supprimer la référence au modèle d'homin en repassant par le menu Fichier => References => Xref Scene.

Repositionner le modèle gubani à l'origine de la scène (x=0, y=0, z=0), car lorsqu'un objet est porté la position (0,0,0) se place au niveau de la main.

== Étape 6 : modifier la texture pour un rendu peluche ==

Au niveau de la texture, pour donner un effet peluche, laissez libre court à votre imagination

[[File:17-tuto-peluche-texture-source.png]]

Ici j'ai édité l'image "ge_acc_teddy-gubani_01.tga" dans l'outil Gimp. J'ai utilisé le filtre "Artistiques > GIMPressioniste" en utilisant le modèle "canvas" pour obtenir un effet trame de tissu.

[[File:17-tuto-peluche-texture-peluche.png]]

Une fois l'image sauvegardée, j'ai re-généré la texture au format ".dds" via la commande :

tga2dds ge_acc_teddy-gubani_01.tga

Voila le résultat obtenu sur le modèle 3d dans 3dsmax :

[[File:18-tuto-peluche-modele3d.png]]

== Étape 7 : Export du shape ==

Il est temps de tester cette peluche en jeu. Pour cela il va falloir exporter le modèle en générant le fichier "shape" utilisé par le moteur Ryzom

Si ce n'est pas déjà je cas, ajouter le bouton ''d'export NEL'' au panneau latéral droit en cliquant sur l'onglet "''utilities''", puis "''More''" et en sélectionnant l'option "''NEL Export''" :

[[File:20-tuto-peluche-export-nel-01.png]]

Ensuite sélectionner le mesh du gubani puis cliquer sur le bouton "Export Model". Il vous faut alors spécifier le dossier où sera crée le fichier "ge_acc_teddy-gubani-01.shape"

[[File:20-tuto-peluche-export-nel-02.png]]

== Étape 8 : Tester la peluche IG ==

Pour bien faire les choses, il faudrait ajouter le ''datasheet'' de la peluche au serveur de jeu et patcher le client. Cette méthode sera détaillée plus loin. Cependant il existe une solution de contournement si vous n'avez pas votre propre serveur de jeu pour réaliser ces opérations.

Il faut savoir qu'une peluche n'est rien d'autre qu'une arme équipée. Ainsi nous pourrions remplacer le modèle de la dague par celui de notre gubani pour le tester sur le serveur officiel. Il existe une astuce simple pour cela. Le client de jeu recherche les modèles et textures dans le dossier "user" avant d'aller voir le dossier "data". Il suffit de copier notre fichier shape et la texture associée dans le dossier "user", puis de renommer le shape du gubani en celui de la dague : "GE_Wea_Dague.shape"

A présent lorsque vous équiperez une dague IG, vous aurez en main notre peluche "gubani".
Pour retrouver la dague d'origine, il suffit de supprimer le fichier shape du dossier "user" :

[[File:21-gubani-peluche-axe.png|400px]]

En réalisant ce test vous pouvez noter une anomalie : la peluche est tenue par le pied, ce qui n'est pas forcément ce que nous voulons

== Étape 9 : orientation et positionnement d'un objet porté ==

Le point de fixation d'un objet tenu en main correspond au point de coordonnée (0,0,0) de l'objet.Son orientation suit la règle suivante :

l'axe X remonte le long de l'avant-bras ;
l'axe Y part depuis le dos de la main vers l'extérieur ;
l'axe Z pointe vers le haut de l'objet tenu fermement en main.

Nous réorientons la peluche gubani dans 3dsmax comme le montre l'image suivante : l'axe X sort du dos du gubani pour remonter le long du bras qui le portera. L'axe Z sort de la main et est donc dans le prolongement de la tête de la peluche :

[[File:22-gubani-peluche-axe-3dsmax.png]]

Après réorientation du modèle gubani et réexportation du shape nous obtenons enfin une peluche qui est tenue par le tronc :

[[File:22-gubani-peluche-axe.png|400px]]

Pour aller plus loin sur les objets portés, je vous conseille de lire ce tutorial : http:''khaganat.net/wikhan/fr:todo:dessiner:creation_d_un_objet_prehensible_en_jeu

== Étape 9 : Créer l’icône pour l'inventaire et la barre d'actions ==

Il faut créer un icône pour l'affichage de l'item peluche gubani dans l'inventaire et dans la barre d'actions.
Cet au icône au format tga doit faire 40x40 pixels avec un fond transparent. Nous le nommerons "icon_teddygubani.tga"

L'icône de 40x40 pixels :

[[File:23-icone-gubani.png|80px]]

Pour des questions de performance, ces icônes ne sont pas stockés individuellement mais regroupés dans une seule image dénommée : "texture_interfaces_v3.tga". Le fichier texte associé dénommé "texture_interfaces_v3.txt" liste les icones présents et leur position dans l'image :

[[File:23-icone-gubani-contexte-txt.png]]

le fichier texte utilise le format suivant pour chaque ligne :

NomFichierIcone u1 v1 u2 v2

Avec :
* u1,v1 la position du point supérieur gauche de l'icône
* u2,v2 la position du coin inférieur droit de l'icône

A la différence des coordonnées en pixels, ces coordonnées qui utilisent la technique du UV Mapping en 3d ont leurs valeurs dans l’intervalle [0 .. 1]. la coordonnée (0,0) correspond au point supérieur gauche de l'image et (1,1) au point inférieur droit de l'image.

Le passage d'un système à l'autre est simple. Soit (x1,y1) la position en pixels du coin haut gauche de notre icône dans l'image globale et (x2,y2) la position du point inférieur droit de l'icône dans l'image, alors :
* u1 = x1 / largeur-image
* v1 = y1 / hauteur-image
* u2 = x2 / largeur-image
* v2 = y2 / hauteur-image

Sachant que la texture "texture_interfaces_v3.tga" fait 1024x1024 pixel, et que dans l'exemple l'icône "icon_teddygubani.tga" se situe à la position (x1=118,y1=798), que le point inférieur gauche étant à la position (x2=157,y2=837), le fichier txt contient donc la ligne :

icon_teddygubani.tga 0.115234375 0.779296875 0.1533203125 0.8173828125

Même si cela peut être ajouté à la main, la bonne méthode et d'utiliser l'outil dédié de NEL ''build_interface'' comme indiqué dans le tutorial https:''khaganat.net/wikhan/fr:todo:dessiner:creer_icone_objet qui recrée la texture globale et le fichier txt à partir d'un dossier contenant tous les icones.

Note: L'ajout de l'icône ne suffit pas, il faut également créer le datasheet de l'objet peluche et spécifier dedans le nom de notre icône à utiliser comme nous le verrons plus loin dans ce tutorial. Au final nous obtenons le résultat suivant IG :

[[File:23-icone-gubani-contexte.png]]

== Etape 11 : créer le fichiers des noms ==

A compléter.

[[File:30-tuto-peluche-txtfile.png]]

== Étape 12 : créer le datasheet ==

A la base, une peluche reste est un objet porté comme une arme. De fait le datasheet de la peluche est trs semblable à celui d'une arme une main, comme l'exemple de la dague ci-dessous.

__icrm1pd.sitem ( datasheet de la dague du réfugié ) :__

<code xml>
<?xml version="1.0"?>
<FORM Revision="$Revision: 1.2 $" State="modified">
<PARENT Filename="_c_m1pd.sitem"/>
<STRUCT>
<STRUCT Name="basics">
<ATOM Name="name" Value="refugee dagger"/>
<ATOM Name="origin" Value="refugee"/>
<ATOM Name="Drop or Sell" Value="false"/>
<ATOM Name="CraftPlan" Value="bcrmea06.sbrick"/>
<ATOM Name="Saleable" Value="false"/>
</STRUCT>
<STRUCT Name="3d">
<ATOM Name="shape" Value="GE_Wea_Dague.shape"/>
<ATOM Name="shape_female" Value="GE_Wea_Dague.shape"/>
<ATOM Name="map_variant" Value="Low Quality"/>
<ATOM Name="icon background" Value="BK_generic.tga"/>
<STRUCT Name="fx">
<ATOM Name="Trail" Value="GE_Wea_Dague_trail_00.shape"/>
</STRUCT>
</STRUCT>
</STRUCT>
<STRUCT/>
<STRUCT/>
<STRUCT/>
<STRUCT/>
<LOG>
</FORM>
<\/pre>

Ce qui change c'est :

* la référénce au shape dans la section "3d"

<ATOM Name="shape" Value="ge_acc_teddy-gubani_01.shape"/>
<ATOM Name="shape_female" Value="ge_acc_teddy-gubani_01.shape"/>

* la référence à l'icone utilisé dans la barre d'état et l'inventaire dans la section "3d"

<ATOM Name="icon" Value="icon_teddygubani.tga"/>
<ATOM Name="icon overlay" Value="icon_teddygubani.tga"/>

* les caractéristiques de base qui diffèrent d'une arme : pas de niveau requis, pas de brique de plan, etc..

<STRUCT Name="basics">
<ATOM Name="name" Value="staff"/>
<ATOM Name="origin" Value="common"/>
<ATOM Name="family" Value="handled item"/>
<ATOM Name="ItemType" Value="Staff"/>
<ATOM Name="Bulk" Value="5"/>
<ATOM Name="RequiredCharacQualityFactor" Value="0"/>
<ATOM Name="RequiredCharacQualityOffset" Value="0"/>
</STRUCT>

Voila donc le datasheet de la peluche gubani que nous nommerons "teddygubani.sitem" :

<code xml>
<?xml version="1.0"?>
<FORM Revision="$Revision: 1.7 $" State="modified">
<PARENT Filename="_c_m1pd.sitem"/>
<STRUCT>
<STRUCT Name="basics">
<ATOM Name="name" Value="staff"/>
<ATOM Name="origin" Value="common"/>
<ATOM Name="family" Value="handled item"/>
<ATOM Name="ItemType" Value="Staff"/>
<ATOM Name="Bulk" Value="5"/>
<ATOM Name="RequiredCharacQualityFactor" Value="0"/>
<ATOM Name="RequiredCharacQualityOffset" Value="0"/>
</STRUCT>
<STRUCT Name="3d">
<ATOM Name="shape" Value="ge_acc_teddy-gubani_01.shape"/>
<ATOM Name="shape_female" Value="ge_acc_teddy-gubani_01.shape"/>
<ATOM Name="map_variant" Value="Low Quality"/>
<ATOM Name="icon" Value="icon_teddygubani.tga"/>
<ATOM Name="icon background" Value="BK_generic.tga"/>
<ATOM Name="icon overlay" Value="icon_teddygubani.tga"/>
<STRUCT Name="fx">
<ATOM Name="Trail" Value="GE_Wea_Dague_trail_00.shape"/>
</STRUCT>
</STRUCT>
</STRUCT>
<STRUCT/>
<STRUCT/>
<STRUCT/>
<STRUCT/>
<LOG></LOG>
</FORM>
<\/pre>

== Étape 13 : Déployer la peluche sur le serveur et le client de jeu ==

Afin de déployer la peluche en jeu la méthode officielle consiste à utiliser la pipeline "build_gamedata" (cf. https:''ryzomcore.atlassian.net/wiki/display/RC/Gamedata+Build+Pipeline). Je vais vous proposer une méthode différente, où les opérations seront effectués à la mains, mais uniquement celles nécessaires à notre peluche :

Nous avons besoin des fichiers suivants :

* teddygubani.sitem ( le datasheet de la peluche gunabi )
* ge_acc_teddy-gubani_01.shape ( le modèle 3d NEL de la peluche )
* ge_acc_teddy-gubani_01.dds ( la texture du modèle 3d )

De plus le déploiement de cette peluche va impacter les fichiers suivants :

* les fichiers "*.packed_sheets" utilisée par le serveur et le client qui sont une version compilé des datasheets
* le fichier "sheet_id.bin" qui est un index de tous les datasheets utilisés par le jeu
* le fichier "visual_slot.tab" qui liste les éléments affichables coté client

Pour bien faire les choses, nous allons également créer un fichier "soft-toy.bnp" qui contiendra les shapes et les textures de toutes les futures peluches.

Pour la suite des opérations nous partons du principe que notre serveur de jeu fonctionne sous linux, et que les variables d'envrionnement suivantes sont définies :

* LEVELDESIGNPATH pointe sur le dossier des datas du level design
* RYZOM_HOME sur l'installation des sources du serveur

=== Ajout du datasheet "teddygubani.sitem au serveur ===

Coté serveur nous allons créer un dossier dédié pour les datasheets des peluches et y placer celui du gubani :

$ mkdir $LEVELDESIGNPATHleveldesigngame_elementsitemsoft-toy
$ cp teddygubani.sitem $LEVELDESIGNPATHleveldesigngame_elementsitemsoft-toy

=== Nettoyages préalables ===

=== Re-générer le fichier "sheet_id.bin" ===

La première étape consiste à regénérer le fichier d'index des datasheet via la commande "make_sheet_id". Il reprend le fichier d'index existant et va le compléter avec les datasheets du dossier $RYZOM_LEVELPATH/leveldesign/game_element/sitem/soft-toy c'est-à-dire les datasheets de nos peluches

$ make_sheet_id -o$LEVELDESIGNPATH/leveldesign/Game_elem/sheet_id.bin $LEVELDESIGNPATH/leveldesign/game_element/sitem/soft-toy

=== Re-générer les "*.packed_sheets" et "visual_slot.tab" ===

Il faut regénérer les "*.packed_sheets".Ce sont les versions pré-compilées des datasheets :

$ sheets_packer

Cette commande va également re-générer le fichier visual_slot.tab

=== Copier les fichiers nécessaires coté client ===

* Nous copions le fichier "visual_slot.tab" généré dans le dossier courant dans le dossier "user" du client de jeu
* Nous copions le fichier $LEVELDESIGNPATH/leveldesign/Game_elem/sheet_id.bin dans le dossier "user" du client de jeu
* Nous remplaçons les fichiers packet_sheets du dossier "data" du client par ceux générés ici $RYZOM_HOME/code/ryzom/client/data/*.packed_sheets par la commande ''sheets_packer''

=== Créer un bnp pour le modèle de la peluche ===

Pour finir il faut copier le shape et la texture de la peluche dans le dossier "data" du client.
Cependant pour bien faire les choses, autant créer un fichier ".bnp" dédié.
Un fichier ".bnp" est une sorte de zip regroupant les différents fichiers shape, dds, txt, ou autres par thème.

Créer on dossier "soft-toy", copions y tous les shapes et textures de nos peluche, à savoir pour le moment "ge_acc_teddy-gubani_01.shape" et "ge_acc_teddy-gubani_01.dds" et créons un fichier BNP pour les contenur

bnp_make /p soft-toy

La commande va créer un fichier "soft-toy,bnp" qui contiendra nos deux fichiers. A présent il faut le copier dans le dossier "data" du client.

=== Tester IG ===

Relancer le serveur avec la commande ''shard start'' puis connectez vous avec votre client.

Si tout c'est bien déroulé, en lançant votre client de jeu, vous pouvez créer une peluche dans votre inventaire avec la commande :

/a createItemInBag teddygubani 1 5

{{tag>Tag_a_ajouter}}

Homepage

2014-06-11T16:49:26Z

Madi:

== Projet collaboratif : Ryzom Project ==

"''La richesse de Ryzom, c'est ce que les joueurs et ceux qui l'aiment peuvent lui apporter. Pour cela, il faut leur en donner les moyens et l'occasion''."

Cette phrase résume à elle seule l'essence du projet : élargir le Power to Players au-delà du seul Roleplay et donner enfin à la communauté de Ryzom les moyens d'agir sur le jeu lui-même.

=== Comment ? ===

La communauté de Ryzom demande depuis longtemps à pouvoir s'impliquer dans la construction du jeu. Il y a eu quelques essais mais aucun ajout réellement visible.

Pourtant, Ryzom, en libérant son code, a fait depuis longtemps un pas vers le monde du Libre. Cela a donné naissance à Ryzom Core, qui a notamment créé la version Linux de Ryzom, et qui sert aussi de base à d'autres projets de jeux basés sur le code source de Ryzom, tels Kaghanat ou Tempest in the Aether.
Mais aucun projet équivalent n'a vu le jour pour enrichir Ryzom lui-même. Il a peut-être manqué un encouragement officiel, une porte qui s'ouvre et qui invite la communauté à entrer, mais aussi un vrai projet pour fédérer cette communauté.

Aujourd'hui nous voulons ouvrir cette porte. Permettre enfin à la communauté du jeu, et plus largement au monde du Libre, de venir participer, ou tout simplement suivre de près ou de loin ce projet que nous lançons et qui deviendra alors, si vous le souhaitez, le vôtre.

=== Qu'est-ce que Ryzom Project ? ===

Ryzom Project est un projet collaboratif ambitieux, ouvert à la communauté du jeu et la communauté libre, en partenariat avec WinchGate et avec des bénévoles de l'Équipe Ryzom. Le partenariat, d'ores et déjà mis en place avec le projet Khaganat (http://khaganat.net) dès la conception du projet, nous prouve la pertinence de l'ambition d'ouverture à la communauté libre.

Il est prévu de construire ce projet en plusieurs étapes progressives, chacune apportant son propre ajout au jeu :

* La première étape, la plus simple, consistera à enrichir les appartements de nouveaux objets.
* La seconde étape consistera à profiter de la maitrise sur l'ajout d'objets pour proposer des objets équipables inédits.
* La troisième étape, plus élaborée, et qui demandera aussi un travail du côté "level design" des tribus, sera de proposer des plans d'armes via des rites de tribus.
* La dernière étape, nommée projet New Zone, consistera en la création d'une nouvelle zone de jeu.

'''ATTENTION !''' Nous ne pouvons pas certifier que la dernière étape sera atteinte, ni que la première sera dépassée. Mais nous souhaitons vous donner les moyens de relever le défi et serons à vos côtés pour le faire avancer aussi loin que possible.

Pour en savoir plus :

Wiki de Ryzom Project : [http://project.ryzom.kervala.net/ http://project.ryzom.kervala.net/]

Chat général du projet : [http://webchat.freenode.net/?channels=ryzomproject #ryzomproject] sur FreeNode

Si vous avez des questions, souhaitez participer à Ryzom Project ou simplement le suivre de loin, nous vous attendons sur le canal [http://webchat.freenode.net/?channels=ryzomproject #ryzomproject] sur FreeNode !

L'Équipe Ryzom et les participants à Ryzom Project

Homepage

2014-06-11T16:46:23Z

Madi: /* Projet collaboratif : Ryzom Project */

== Projet collaboratif : Ryzom Project ==

"''La richesse de Ryzom, c'est ce que les joueurs et ceux qui l'aiment peuvent lui apporter. Pour cela, il faut leur en donner les moyens et l'occasion''."

Cette phrase résume à elle seule l'essence du projet : élargir le Power to Players au-delà du seul Roleplay et donner enfin à la communauté de Ryzom les moyens d'agir sur le jeu lui-même.

=== Comment ? ===

La communauté de Ryzom demande depuis longtemps à pouvoir s'impliquer dans la construction du jeu. Il y a eu quelques essais mais aucun ajout réellement visible.

Pourtant, Ryzom, en libérant son code, a fait depuis longtemps un pas vers le monde du Libre. Cela a donné naissance à Ryzom Core, qui a notamment créé la version Linux de Ryzom, et qui sert aussi de base à d'autres projets de jeux basés sur le code source de Ryzom, tels Kaghanat ou Tempest in the Aether.
Mais aucun projet équivalent n'a vu le jour pour enrichir Ryzom lui-même. Il a peut-être manqué un encouragement officiel, une porte qui s'ouvre et qui invite la communauté à entrer, mais aussi un vrai projet pour fédérer cette communauté.

Aujourd'hui nous voulons ouvrir cette porte. Permettre enfin à la communauté du jeu, et plus largement au monde du Libre, de venir participer, ou tout simplement suivre de près ou de loin ce projet que nous lançons et qui deviendra alors, si vous le souhaitez, le vôtre.

=== Qu'est-ce que Ryzom Project ? ===

Ryzom Project est un projet collaboratif ambitieux, ouvert à la communauté du jeu et la communauté libre, en partenariat avec WinchGate et avec des bénévoles de l'Équipe Ryzom. Le partenariat, d'ores et déjà mis en place avec le projet Khaganat (http://khaganat.net) dès la conception du projet, nous prouve la pertinence de l'ambition d'ouverture à la communauté libre.

Il est prévu de construire ce projet en plusieurs étapes progressives, chacune apportant son propre ajout au jeu :

* La première étape, la plus simple, consistera à enrichir les appartements de nouveaux objets.
* La seconde étape consistera à profiter de la maitrise sur l'ajout d'objets pour proposer des objets équipables inédits.
* La troisième étape, plus élaborée, et qui demandera aussi un travail du côté "level design" des tribus, sera de proposer des plans d'armes via des rites de tribus.
* La dernière étape, nommée projet New Zone, consistera en la création d'une nouvelle zone de jeu.

'''ATTENTION !''' Nous ne pouvons pas certifier que la dernière étape sera atteinte, ni que la première sera dépassée. Mais nous souhaitons vous donner les moyens de relever le défi et serons à vos côtés pour le faire avancer aussi loin que possible.

Pour en savoir plus :

Wiki de Ryzom Project : [http://project.ryzom.kervala.net/]

Chat général du projet : [http://webchat.freenode.net/?channels=ryzomproject]

Si vous avez des questions, souhaitez participer à Ryzom Project ou simplement le suivre de loin, nous vous attendons sur [http://webchat.freenode.net/?channels=ryzomproject] !

L'Équipe Ryzom et les participants à Ryzom Project

Homepage

2014-06-11T16:39:48Z

Madi: Page d'accueil du projet (première version)

== Projet collaboratif : Ryzom Project ==

"La richesse de Ryzom, c'est ce que les joueurs et ceux qui l'aiment peuvent lui apporter. Pour cela, il faut leur en donner les moyens et l'occasion."

Cette phrase résume à elle seule l'essence du projet : élargir le Power to Players au-delà du seul Roleplay et donner enfin à la communauté de Ryzom les moyens d'agir sur le jeu lui-même.

=== Comment ? ===

La communauté de Ryzom demande depuis longtemps à pouvoir s'impliquer dans la construction du jeu. Il y a eu quelques essais mais aucun ajout réellement visible.

Pourtant, Ryzom, en libérant son code, a fait depuis longtemps un pas vers le monde du Libre. Cela a donné naissance à Ryzom Core, qui a notamment créé la version Linux de Ryzom, et qui sert aussi de base à d'autres projets de jeux basés sur le code source de Ryzom, tels Kaghanat ou Tempest in the Aether.
Mais aucun projet équivalent n'a vu le jour pour enrichir Ryzom lui-même. Il a peut-être manqué un encouragement officiel, une porte qui s'ouvre et qui invite la communauté à entrer, mais aussi un vrai projet pour fédérer cette communauté.

Aujourd'hui nous voulons ouvrir cette porte. Permettre enfin à la communauté du jeu, et plus largement au monde du Libre, de venir participer, ou tout simplement suivre de près ou de loin ce projet que nous lançons et qui deviendra alors, si vous le souhaitez, le vôtre.

=== Qu'est-ce que Ryzom Project ? ===

Ryzom Project est un projet collaboratif ambitieux, ouvert à la communauté du jeu et la communauté libre, en partenariat avec WinchGate et avec des bénévoles de l'Équipe Ryzom. Le partenariat, d'ores et déjà mis en place avec le projet Khaganat (http://khaganat.net) dès la conception du projet, nous prouve la pertinence de l'ambition d'ouverture à la communauté libre.

Il est prévu de construire ce projet en plusieurs étapes progressives, chacune apportant son propre ajout au jeu :

* La première étape, la plus simple, consistera à enrichir les appartements de nouveaux objets.
* La seconde étape consistera à profiter de la maitrise sur l'ajout d'objets pour proposer des objets équipables inédits.
* La troisième étape, plus élaborée, et qui demandera aussi un travail du côté "level design" des tribus, sera de proposer des plans d'armes via des rites de tribus.
* La dernière étape, nommée projet New Zone, consistera en la création d'une nouvelle zone de jeu.

ATTENTION ! Nous ne pouvons pas certifier que la dernière étape sera atteinte, ni que la première sera dépassée. Mais nous souhaitons vous donner les moyens de relever le défi et serons à vos côtés pour le faire avancer aussi loin que possible.
Pour en savoir plus :

Wiki de Ryzom Project : [http://project.ryzom.kervala.net/]

Chat général du projet : [http://webchat.freenode.net/?channels=ryzomproject]

Si vous avez des questions, souhaitez participer à Ryzom Project ou simplement le suivre de loin, nous vous attendons sur [http://webchat.freenode.net/?channels=ryzomproject] !

L'Équipe Ryzom et les participants à Ryzom Project

User:Madi

2014-06-11T12:57:24Z

Madi:

Madi est l'une des trois personnes ayant fondé le projet Khaganat : http://khaganat.net