Eng)
"Oh look!" you probably thought "Fistful of Frags has a workshop!". "Hmm... these mods look cool and all, but wouldn't it be cool if..." you thought as you started looking through your system files. "Wait a second, what the heck is a .vpk file? I can't open it! ARGGG!". Never fear! this guide is right here! You're reading it right now, aren't you?

Fr)
Cette traduction française a été fournie par Mca, donc un grand merci à lui!

« Oh tiens ! » vous vous exclamez en voyant le workshop de Fistful of Frags. « Hmm… tous ces mods sont vraiment cool, mais ce serait pas génial si... » vous vous dites en commençant à fouiller dans les fichiers du jeu. « Attend c'est quoi ce truc, des fichiers .vpk ? Quelle est cette immondice ?! Je ne peux l'ouvrir ! ARGGG ! ». Pas de panique ! Vous avez bien ce guide sous les yeux n'est-ce pas ?

Eng)
Go into your system files to this location: Program Files (x86)\Steam\steamapps\common\Fistful of Frags\fof\custom. Notice this file is empty. This is where you will put your masterpiece mod in order to test it, once you make one, of course. Once you are done staring at this blank canvas of purity, go back a page to the fof page. Scroll down until you see a file named fof_dir.vpk. This file houses most of the files you as a modder are interested in. Valve uses these special files to hold assets, and though you cannot curently open .vpk files, we will soon remedy this. Head on over to this site[nemesis.thewavelength.net] and download the tool provided. Assuming you download this application properly, you can now magically open .vpk files. Hurrah!


Fr)
Tout d'abord, allez là où les fichiers du jeu sont installés. Tout dépend sur quelle partition vous avez installé steam. Si c'est sur la principale, le chemin sera le suivant :

Cliquer sur démarrer en bas à gauche > ordinateur > Disque local (C:) > Program Files (x86) > Steam > steamapps > common > Fistful of Frags > fof > custom.

Si c'est une autre partition, le chemin devrait être le même, sauf que ce sera certainement à la racine, pas de « Program Files » donc. Par exemple :

e:\Steam\steamapps\common\Fistful of Frags\fof\custom

Pour l'instant ce dossier est vide, mais vous y reviendrez très souvent au début, donc ne fermez pas cette fenêtre ! Vous l'avez peut-être compris, c'est ici que vous mettrez votre magnifique mod, une fois qu'il sera fait bien sûr. Quand vous aurez fini d'admirer la puretée de ce blanc immaculé (sauf si votre écran est sale), retournez à la page « fof », simplement une fois en arrière donc. Descendez jusqu'à apercevoir un fichier nommé « fof_dir.vpk ».

C'est le fichier maître qui nous intéresse le plus en tant que modder. Valve utilise ces fichiers spéciaux notamment pour les assets, certaines ressources du jeu en gros. Pour l'instant vous ne pouvez pas l'ouvrir, mais nous allons très vite y remédier. Allez sur ce site[nemesis.thewavelength.net] je vous prie, et télécharger l'outil mis à disposition (l'« Installer » devrait suffire, sachez aussi qu'il vous faut Microsoft .NET Framework Version 3.5, ou .NET Framework 2.0, ET Visual C++ 2008 SP1). Une fois que vous avez bien tout installé, vous devriez pouvoir ouvrir les fichiers .vpk, comme par magie. Hourra !

Eng)
"Ooh, look at all these files!" you think as you peek into fof_dir.vpk for the first time. "What should I mod first?" The easiest type of mod to create (in my opinion) is a sound mod. Extract the sounds foulder to your dekstop to get started. Look through the files and choose one you would like to modify, and then choose a sound to replace it with. Sound Bible[soundbible.com] is a good resource for free sound effects. Be sure the sound file you use is in your mod is the same format as the one you are replacing (.wav or .MP3). Now go through your copy pasted file and delete any files you would not like to change. Once only the sound you would like to mod (along with the files that lead to it) are left, replace that sound file with your sound file. Be sure it is named the same name the previous file had. Now put your modded sound folder into another folder named whatever you like, and plop it into the "custom" section of the "fof" file. Go into the game and make sure your sound works. If it doesn't, go back through these steps, paying special attention that you don't change the file structure leading up to the sound file. Huzzah! You have created your first mod! If you want to publish it now, go down to the publishing section.

To summerize: Extract the "sounds" file from the base game, find the sounds you want to change, delete the other sounds you arn't changing (being sure to maintain the .wav or MP3 format), replace the original sounds with the your custom ones, and plop your new mod file into the "custom" file.


Fr)
« Punaise, regarde moi tous ces fichiers ! » vous manquez de jurer en explorant pour la première fois le ficher fof_dir.vpk. « Que devrais-je modder en premier lieu ? » Eh bien, le type de mod le plus facile à créer pour débuter (à mon humble avis), est le mod sonore, celui qui touche à des modifications de son. Cliquez droit sur le dossier « Sound » tout en bas, faites la première option : « Extract », et choisissez la destination, admettons le bureau. Je vous conseil d'en faire une copie, pour pouvoir le bidouiller comme il vous plaira, et ne pas avoir à re-extraire.

Regardez un peu tous les fichiers sons, et choisissez-en un que vous voulez modifier, et ensuite, choisissez un autre son qui le remplacera; sur une banque de son, ou où vous voulez ailleurs. Par exemple, prenez un son d'un piano qui fait un accord dissonant, pour remplacer le bruit d'une arme qui recharge.

Apparemment, il faut que les deux fichiers sois de la même extension. Si c'est du MP3 que vous voulez remplacer, il vous faudra du MP3. En l’occurrence, il me semble que tous les fichiers sons du jeux sont en .WAV, donc soyez sûr que votre fichier ait cette extension.

Maintenant, retournez à votre dossier Sound fraîchement extrait, et supprimer TOUS les sons et dossiers que VOUS NE VOULEZ PAS MODIFIER, tout en gardant la structure des fichiers qui amènent à celui que vous allez remplacer.

En gros, imaginons voulez modifier le rechargement du 357, plus précisément le fichier « 357_reload1 ». Pour cela, supprimez les deux autres présents dans ce dossier, ensuite dans le dossier précédent, faites de même. Supprimez tous les dossiers et fichiers pour ne garder que le dossier « 357 ». Encore en arrière, il ne doit rester que le dossier « weapons ». Ce qui donne le chemin suivant :

Sound\weapons\357\357_reload1

Si vous vous demandez, oui on peut remplacer plusieurs sons à la fois, et il suffit de faire de même: garder la seule structure de dossier qui puisse amener aux fichiers que vous voulez modifier, et supprimer tout le reste.

Une fois que tout cela est fait, et qu'il ne vous reste que le son à remplacer avec le chemin qui l'y amène, copier/coller dans ce même dossier votre fichier « pianodissonant.WAV », pour suivre l'exemple donné précédemment, puis supprimer 357_reload1.WAV, et enfin renommez pianodissonant.WAV avec le nom du fichier que vous venez de supprimer. Si vous n'êtes pas sûr de ce que vous avez fait, lisez le fichier remplacé, et si c'est bien le son désiré, c'est bingo.

Mettez le dossier Sound dans un autre dossier que vous pouvez nommer comme bon vous semble. Et enfin placez ce dossier dans le « custom » dont on parlait au tout début.

Démarrez le jeu et vérifiez que ça marche bien. Si ce n'est pas le cas, reprenez tout depuis le début, calmement, en relisant bien. Si ça ne marche toujours pas, n'hésitez pas à poser des questions, c'est comme ça qu'on améliore le guide et qu'on rend le modding plus accessible. Aussi, en ayant fait ça, vous comprenez qu'il suffit de recréer le(s) seul(s) chemin(s) menant au(x) fichier(s) customisé(s), les prochaines fois vous n'aurez pas besoin de faire tout ça; c'était juste pour l'aspect didactique et bien faire comprendre ce qui doit y avoir dans un dossier de mod.

Yay ! Vous avez créé votre premier mod ! Vous voulez maintenant certainement le publier, alors descendez tout en bas du guide pour trouver la section publication.


Pour résumer : Extrayez le dossier « Sound » à la racine du jeu, trouvez le son que vous voulez changez, supprimez le reste qui ne vous intéresse pas, et remplacez le son original avec votre son personnalisé, tout en gardant le même format audio et le même nom. Mettez le dossier Sound dans un autre dossier, et mettez tout ça dans le dossier « custom ».

Eng)
"It's alive!" you think as you hear the custom sound you just added travels through your speakers. "It gives this gun so much more personality! But... this gun might sound like Nicolas Cage, but it doesn't look like Nicolas Cage." I have two things to say to that. First: why? And second: you are ready to make your first weapon texture! Head back over to the fof_dir.vpk file and open it. You will notice there are files named models and materials. The models folder holds the actual models of things in the game, not the textures. The materials file holds the 2D textures of stuff, so open that one. Now go to the models file, and you will see a list of files that houses the different textures. The .vtf files are the ones that actually have the textures. Again, you cannot open these (yet). Go to this site[nemesis.thewavelength.net] and download the vtfEditor. Et voila! You can open those files. To actually edit them, though, open the texture in vtfEdit and click files\export. This converts the texture file into an editable format, and you can now edit it with your favorite image editor. I recommend GIMP[www.gimp.org], but most editors will do. Once you are done plastering Nicolas Cage's face all over the weapon texture, open vtfEdit and click file\save as. Now that you have your edited .vtf file, put it in the fof\custom file, being sure put the edited file in all the folders that held the original unedited file. For a weapon texture this means place your edited file in this series of folders: materials\models\weapons\myEditedFile.vpk. Remember your edited file must have the same name as the file it replaces. Once you have this folder of folders, put it in your fof\custom folder. Notice this is the same file structure used in fof_dir.vpk for holding the original weapon texture, the difference being it is placed in the fof\custom folder and it holds your edited file(s).

Some Notes:
Keep in mind that for weapons there are usually a weaponname.vtf file, and then a w_weaponname.vtf file. You have to replace both if you want to view your weapon texture in both first person view and as a item on the ground. Not all weapons have easy names to find, so you should look around if you don't see both types of files at first. For example, the Peacemaker has a world model texture named w_saa_col.vtf, and a first peron texture of name of saa_col.vtf. Keep in mind that the w_.vtf file is usually has a lower number of pixels.


Fr)
Si vous vous lancez directement dans cette partie-là, je vous conseil de jeter d'abord un œil à la partie précédente, sur les mods sonores, car ces deux types de mods se font un peu de la même manière (ou du moins leur finalisation), et ici je me suis permis de prendre des raccourcies, notamment sur le point des dossiers dans les dossiers. Donc si vous ne comprenez pas bien, référez-vous d'abord aux explications plus en haut.


« It's alive ! » vous vous écriez en entendant à travers vos hauts-parleurs le mod personnalisé que vous venez d'ajouter. « Ca rend cette arme tellement plus unique ! Reste que… ce pistolet sonne peut-être comme Nicolas Cage, mais il ne ressemble pas à Nicolas Cage ». J'ai deux choses à dire face à ce propos. Déjà, pourquoi ? Et secundo, vous êtes prêt à accomplir votre première texure d'arme !

Pour commencer, retournons au fichier fof_dir.vpk de tout à l'heure, et rouvrez-le.

Vous remarquez qu'il y a un dossier nommé « materials », et un autre « models ». Le dossier models ne contient pas de textures à proprement parler, donc nous allons nous intéresser au dossier materials, qui lui, contient les textures en 2D, alors ouvrez-le. Maintenant allez dans le dossier « models », et ici l'on parle du dossier models qui se trouve dans le dossier materials, vous suivez toujours ? Celui-ci contient plusieurs dossiers qui hébergent les différentes textures du jeu. Les fichiers .VTF sont ceux qui contiennent véritablement les textures qui nous intéressent. Encore une fois, on ne peut pas les ouvrir comme ça. Allez sur ce site[nemesis.thewavelength.net], et téléchargez et installez le vtfEditor (vous avez besoin de .NET Framework v1.1 pour qu'il fonctionne correctement). Et voilà ! Vous pouvez maintenant ouvrir ces fichiers. Pour pouvoir les éditer, il faut ouvrir la texture dans vtfEdit, et cliquer sur File > Export. Ceci convertira le fichier texture dans un format retouchable, et comme ça vous pouvez maintenant le modifier avec votre éditeur d'image favori ! Je recommande GIMP[www.gimp.org], mais n'importe quel autre éditeur devrait faire l'affaire. Une fois que vous avez fini d'appliquer la face de Nicolas Cage partout sur votre texture d'arme, ouvrez vtfEdit et cliquez sur File > Save as (en gros on fait le processus inverse). Maintenant que vous avez votre fichier .vtf customisé, mettez-le dans le sacrosaint dossier custom, et placez-le ensuite dans la même structure de dossiers que celle qui amène au fichier original. Et renommez votre fichier personnalisé par le nom du fichier texture à remplacer.

Pour une texture d'arme, cela se résume à placer votre fichier édité dans cette série de dossiers : materials\models\weapons\monFichierEdite.vpk.

Tout ceci doit se tenir dans le dossier custom, qui lui-même se trouve dans le dossier fof, n'oubliez pas. Remarquez que c'est exactement le même chemin d'accès utilisé dans fof_dir.vpk pour amener au fichier de texture d'arme original, la différence est qu'il est placé dans le dossier custom, et qu'il contient seulement votre/vos fichier(s) édité(s).


Quelques notes :

Sachez que pour les armes, il y a souvent un weaponname.vtf, et un w_weaponname.vtf. Vous devez donc remplacez les deux fichiers si vous voulez voir votre arme re-texturée pour la première personne, et en tant qu'objet au sol.

Toutes les armes n'ont pas des noms faciles à retrouver, donc vous devriez revérifier un peu partout si vous ne trouvez pas les deux types de fichiers d'un coup. Par exemple, le Peacemaker a un modèle de texture environnemental nommé w_saa_col.vtf, et une texture pour la première personne nommée saa_col.vtf.

Gardez aussi à l'esprit qu'un fichier w_.vtf a en général un nombre réduit de pixels.

Eng)
Use this guide to publish your mod.

Fr)
Utilisez ce guide pour publier votre mod.

Eng)
Thank you for taking the time to read my guide! If you have any questions or comments, please post them in the comments section. Have fun with your new Nicolas Cage themed mod, and happy future modding!

Fr)
Merci d'avoir pris le temps de lire ce tutoriel ! Encore une fois, si vous avez des questions ou des avis à partager, n'hésitez pas à commenter dans la section appropriée en bas. Amusez-vous bien avec votre revolver Nicolas Cage, et bon voyage dans l'art du modding !