Structure de s4_weapon.x4

Mihawk

Bonjour / Bonsoir à toutes et à tous !
 
Aujourd'hui je vais vous expliquer la structure du fichier "s4_weapon.x4" qui est un des éléments essentiel du jeu.
 
Qu'est ce que s4_weapon.x4 ?
 
s4_weapon.x4 est un fichier regroupant les armes du jeu (logique) mais c'est aussi le fichier qui gère l’interprétation de celles-ci une fois dans le jeu / shop.
Ce fichier va permettre de fixer plusieurs choses (lisez bien tout c'est important pour la suite du développement) :
 
<ul><li>Le prix d'une arme (Seulement "l'affichage" car le prix qui sera soutiré au compte est fixé par la BDD => Base de donnée que nous irons voir plus tard dans un prochain tutoriel !)</li>
<li>La durabilité et la durée de l'achat avant disparition.</li>
<li>Où l'arme sera placé dans le shop</li>
<li>Définir si l'arme est "nouvelle" ou non</li>
<li>Le skin qui sera chargé sur l'arme (format .dds)</li>
<li>La forme sur laquelle sera "plaqué" le skin (format .scn)</li>
<li>Les dégâts de l'arme, la vitesse à laquelle on se déplace avec etc..</li>
<li>Description de l'arme, suivant les différents langages</li>
<li>Et d'autres propriétés que vous comprendrez par vous même si vous maîtrisez l'anglais ! </li></ul> 
Comment obtenir ce fichier ?
 
Pour cela, vous devez avoir en possession le "Ressource Tool" que j'ai partagé par ici ! : <iframe data-embed-src="<base_url>/topic/1237-partage-ressource-outil-de-d%C3%A9veloppement/?do=embed" data-embedcontent="" frameborder="0" src="//melinyel.net/applications/core/interface/js/spacer.png"></iframe>
 
Puis, vous devez choisir votre dossier S4L pour charger les ressources dans un premier temps (Appuyez sur "Load" et chercher votre dossier S4L) :
 
<img alt="1414753735-ss-2014-10-31-at-12-07-13.png" src="<base_url>/applications/sslimageproxy/interface/image.php?url=http://image.noelshack.com/fichiers/2014/44/1414753735-ss-2014-10-31-at-12-07-13.png"/>
 
Une fois chargé, Allez dans le dossier "xml" et trouvez tout en bas le fichier s4_weapons.x4 et faites un save sur votre bureau avec un clic droit dessus :
 
<img alt="1414753694-99998f169e2.png" src="<base_url>/applications/sslimageproxy/interface/image.php?url=http://image.noelshack.com/fichiers/2014/44/1414753694-99998f169e2.png"/>
 
Vous n'avez plus qu'à l'ouvrir avec Notepad++ pour votre éditeur de texte préféré 
Allez ! maintenant on regarde en détail avec un exemple d'arme dans ce fichier!
<pre class="ipsCode prettyprint">
<sub_category id="5">
<item number="1">
<product id="1" term_contract="NO_TIME_LIMIT" gm_price="40000" cash_price="0" durability_inital_value="2400" remaining_second="-1" refund_enable="true" />
<product id="2" term_contract="TS_5_HOURS" gm_price="5000" cash_price="0" durability_inital_value="-1" remaining_second="18000" refund_enable="true" />
<base name="그레네이드 건" require_level="0" exp_boost_percent="0" require_license="license_mine_gun" sale_mode="0" />
<client icon_image="Resources/Image/Weapon/icon_gun_mine.tga" attrib_comment="{A-L}{F-2002_12}볼 형태로 압축된 폭발성 에너지를{N}원하는 타이밍에 투척할 수 있도록{N}제작한 무기. 신체와 물체에 닿을 시{N}폭발하도록 설계되어 있다.{N}포물선으로 날아가는 에너지 볼의 {N}궤적을 연구할 필요가 있다.{N}{CB-0,255,0,255}[조작법]{N}마우스 왼쪽 버튼 : 에너지볼 발사{N}{CB-255,0,0,255}시범무기로써 라이센스로 획득한 무기만{N}사용할 수 있습니다.{N}추후 밸런스 조정 가능성이 있습니다." feature_comment="투척 무기" />
<license script_file="license_MineGun.lua" script_func="OnMineGunLicenseTest" license_map="104" />
<attach />
<weapon type="10" rate_of_fire="" power="45.0" move_speed_rate="1.0" attack_move_speed_rate="1.0" magazine_capacity="1" cracked_magazine_capacity="1" max_ammo="4" accuracy="" range="500.0" support_sniper_mode="0" sniper_mode_fov="15" reload_sound_file="Resources/Sound/grenade_reload.ogg" slot_image_file="Resources/Image/Weapon/slot_gun_mine.tga" crosshair_file="Resources/Image/Weapon/crosshair_gun_mine" crosshair_zoomin_file="Resources/Image/Weapon/crosshair_gun_mine" auto_target_distance="0.0">
<scene value="resources/Model/Weapon/minegun.scn" />
</weapon>
<lang>
<nation id="2" name_code="Mine Gun" attrib_comment_code="{A-L}{F-2002_12}Waffe, die zur gewünschten Zeit mit{N}konzentrierter Energie in Ballform angreift.{N}Eingerichtet, um bei physischem Kontakt zu{N}explodieren. Die Flugformation des Energieballs ist {N}noch unerforscht.{N}{CB-0,255,0,255}[Anwendung]{N}Linke Maustaste: Energieball abschießen{N}{CB-255,0,0,255}Dies ist eine befristete Waffe, die nur{N}durch den License Test erworben werden kann.{N}Spätere Änderungen zur Anpassung möglich." feature_comment_code="Throwing Weapon" />
<nation id="3" name_code="Mine Gun" attrib_comment_code="{A-L}{F-2002_12}Weapon with compressed explosive energy{N}in ball form for carefully timed sniping. It is made to{N}explode on physical contact. Research into the{N}flight of the ball is essential.{N}{CB-0,255,0,255}[Operation]{N}Click left mouse button: Fire weapon.{N}{CB-255,0,0,255}This is a temporary weapon{N}which can only be used by acquiring a weapons license.{N}Balance adjustment might be required afterwards." feature_comment_code="Throwing Weapon" />
<nation id="4" name_code="Mine Gun" attrib_comment_code="{A-L}{F-2002_12}Arme avec de l'énergie explosive compressée{N}sous la forme d'une balle pour tirer selon un timing précis. Elles sont faites{N}pour exploser au contact physique. Des recherches{N}sur le comportement de l'energyball sont nécessaires.{N}{CB-0,255,0,255}[Utilisation]{N}Clic gauche: tirer {N}{CB-255,0,0,255}C'est une arme temporaire{N}qui peut uniquement être utilisée pendant la licence{N}Des ajustements pourraient être nécessaires." feature_comment_code="Throwing Weapon" />
<nation id="5" name_code="Mine Gun" attrib_comment_code="{A-L}{F-2002_12}Weapon with compressed explosive energy{N}in ball form for sniping on desired timing. It is made{N}to explode on physical contact. Research of the{N}energyball flight formation is needed.{N}{CB-0,255,0,255}[Controls]{N}Left mouse button : Fire energyball {N}{CB-255,0,0,255}This is a temporary weapon{N}which can only be used by license acquired weapons{N}Balance adjustment might be required afterwards." feature_comment_code="Throwing Weapon" />
<nation id="6" name_code="Mine Gun" attrib_comment_code="{A-L}{F-2002_12}Arma ad energia compressa in una sfera{N}che esplode in un momento preciso.{N}Esplode a contatto. Fai attenzione{N}alla sua traettoria.{N}{CB-0,255,0,255}[Comandi]{N}Tasto sinistro: spara la energyball{N}{CB-255,0,0,255}Arma temporanea{N}da usare con armi di cui si ha la licenza.{N}Può essere necessario ribilanciarle." feature_comment_code="Throwing Weapon" />
<nation id="7" name_code="Mine Gun" attrib_comment_code="{A-L}{F-2002_12}Оружие со спресованной в шар{N}взрывной энергией для точных выстрелов с учетом{N}поправки на траекторию. Взрывается при физическом{N}контакте с противником.{N}{CB-0,255,0,255}[Управление]{N}Левая кнопка мыши: выстрелить шаром{N}{CB-255,0,0,255}Это временное оружие,{N}получить которое можно только через{N}Лицензию. Проводится балансировка." feature_comment_code="Throwing Weapon" />
</lang>
</item>
</pre>
Place à l'explication de ce qui figure dans ce fichier ! 
 
sub_category : sous catégorie de l'arme. (Les armes ont toutes une Category de "2" qui correspond aux armes)
<pre class="ipsCode prettyprint">
sub_category id="0" => Armes au corps à corps
sub_category id="1" => Armes à distance (Légères Automatiques & Semi automatiques)
sub_category id="2" => Armes à distance (Lourdes Automatiques & Semi automatiques)
sub_category id="3" => Armes à longue distance (Snipers)
sub_category id="4" => Armes stationnaires (SentyNell, SentryGun)
sub_category id="5" => Armes de lancer (Il n'y en a qu'une à cette version, le MineGun, lance grenade)
sub_category id="6" => Armes "autres" (MindEnergy, MindShock)
</pre>
item_number : ID unique de l'objet dans la sub_category (il ne peut pas y avoir deux fois un item_number "1" dans une même sub category)
 
product_id : Ceci correspond à l'ensemble des propriétés du produit dans le shop (Si vous voulez ajouter cette arme au shop (j'expliquerais comment dans un autre tutoriel) avec le product id 1, cela chargera donc toutes les propriétés à droite de ce product_id)
 
weapon_type : Type de l'arme (c'est défini dans les .lua du jeu, je vous conseille de ne pas y toucher sans une maîtrise complète du langage lua, sinon tout le jeu ne marchera plus normalement ..)
 
scene value : Valeur de ce qu'on appelle la "scène" qui correspond à la forme de l'arme, ainsi que d'autres propriétés telles que des animations, ou une éventuelle transparence. (Tout ceci est contenu dans un fichier .scn)
 
Et là vous allez me dire (si vous avez lu en haut) mais où est la texture qui est censé être juste en dessous de la scène ? Et bien c'est tout simple il ne demande pas d'en charger.
Pourquoi ?
Si vous n'indiquez pas de texture à l'arme avec un texture_suffix diffuse, le jeu va donc comprendre que la texture porte le même nom que le .scn chargé plus haut, et donc la charger automatiquement
Si vous vouliez charger une autre texture pour cette arme, voilà ce qu'il faudrait avoir :
<pre class="ipsCode prettyprint">
<scene value="resources/Model/Weapon/minegun.scn">
<texture_suffix diffuse="_1" />
</scene>
</pre>
et dans le cas là, la texture chargée sera minegun_1.dds et non dans le cas précédent minegun.dds
 
nation_id : ID de la région, et donc des textes chargés.
Pour les plus curieux d'entre vous, vous aurez remarqué d'ailleurs que ce chiffre figure dans le Launcher que je vous ai mis dans le dossier S4League :
 
<img alt="1414753355-bf07ff84d32.png" src="<base_url>/applications/sslimageproxy/interface/image.php?url=http://image.noelshack.com/fichiers/2014/44/1414753355-bf07ff84d32.png"/>
 
Si vous voulez changer la langue chargée au démarrage du jeu, changez juste le "3" qui correspond à l'anglais en "4" pour français. 
 
Voilà j'ai fini de vous expliquer les détails de ce fichier pour pouvaient pour paraître un peu "flou"
Si vous avez des remarques, suggestions, ou que vous aimeriez que je détail autre chose, n'hésitez pas !

Azad

Excellent tutoriel, bien imagé et bien expliqué. 
Un très bon sujet pour les débutants. 
Merci du partage et +1 points de réputation.

Mihawk

Merci Azad !

Mihawk

Message automatiqueLe sujet a été déplacé de « <a href="<base_url>/forum/59-%C3%A9mulation/">Émulation</a> → <a href="<base_url>/forum/194-s4-league/">S4 League</a> » à « <a href="<base_url>/forum/59-%C3%A9mulation/">Émulation</a> → <a href="<base_url>/forum/194-s4-league/">S4 League</a> → <a href="<base_url>/forum/195-tutoriel/">Tutoriel</a> ».

Tsukasa

Salut, j'essaye d'utilisé la commande du /additem mais un problème se pose cela ne me give rien.Aurais-tu un exemple d'armes que tu t'es add est comment tu la fait car la commande est assez complexe mine de rien.Et saurais tu si c'est possible de tout bonnement rajouter les armes des nouvelle saisons ???

Tsukasa

Tout compte fait je viens de vérifier avec un ami et on dirait que toute les commandes ne fonctionne pas.Peut-être y aurais-t-il une erreur dans le script des plugins.

FaryBlood

Recompile l'émulateur Cordialement

Darkshwadox

Le fichier a été supprimé on peut plus le télécharger :/

Mihawk

Je m'occupe de re-upload, merci de l'avoir signalé.

NodeBB

Structure de s4_weapon.x4