KAAPSULE RPF VERS RESSOURCE  v1.0.0
www.kaapsule.com/tools/rpf-resource


À QUOI ÇA SERT

Tu télécharges un véhicule add-on et tu reçois un dlc.rpf, parfois dans un zip.
Cet utilitaire l'ouvre et t'en fait une ressource FiveM prête à lancer :

   nom_du_vehicule/
      fxmanifest.lua     les data_file remplis selon ce qui est vraiment dans le pack
      stream/            les modèles et les textures (.yft .ytd .ydr ...)
      data/              les metas et les .dat (vehicles, handling, carcols ...)

À la fin, tu as le nom de spawn, le nombre de fichiers, le poids total, et un
avertissement si une texture dépasse 16 Mio.


CE QU'IL TE FAUT

1. Windows.
2. GTA V installé sur cette machine. Un .rpf est chiffré : les clés sont lues dans
   le jeu, il n'y a pas d'autre moyen. C'est aussi pour ça que ça ne peut pas se
   faire sur un site web.
3. CodeWalker 30. Télécharge le dossier complet, pas seulement le .exe, et garde
   CodeWalker.Core.dll avec. L'utilitaire le cherche tout seul dans tes Documents,
   sur le Bureau, dans Téléchargements et à la racine de tes disques.


COMMENT ON S'EN SERT

Le plus simple : attrape ton dlc.rpf (ou ton zip) et lâche-le sur
KAAPSULE-RPF-vers-ressource.bat.

Sinon, double-clique sur le .bat : une fenêtre te demande le fichier.

La ressource est écrite à côté de ton fichier de départ, dans un dossier qui porte
le nom de spawn du véhicule.


OPTIONS

Si tu veux piloter à la main, lance le .ps1 depuis un terminal :

   powershell -NoProfile -ExecutionPolicy Bypass -File rpf-vers-ressource.ps1 -Source "C:\...\dlc.rpf"

   -Source      le .rpf ou le .zip à convertir
   -Name        le nom de la ressource (par défaut : le nom de spawn du véhicule)
   -OutDir      le dossier qui contiendra la ressource
   -CodeWalker  le chemin de CodeWalker.Core.dll, s'il n'est pas trouvé
   -Gta         le dossier de GTA V, s'il n'est pas trouvé
   -Force       écrire dans un dossier déjà rempli sans poser la question

Tu peux aussi poser les chemins une fois pour toutes dans deux variables
d'environnement : KP_CODEWALKER et KP_GTA.


CE QU'IL NE FAIT PAS

Rien n'est supprimé, rien n'est envoyé sur internet. Si le dossier de sortie existe
déjà et qu'il contient des fichiers, on te demande avant d'écrire.

Les .gxt2 du pack ne sont pas repris : ce sont les textes du jeu. Pour renommer ton
véhicule, passe par AddTextEntry dans un script.

Les content.xml, setup2.xml et _manifest.ymf sont de la plomberie de DLC : FiveM ne
s'en sert pas, ils sont laissés de côté.


LE FXMANIFEST

Les types data_file écrits dans le fxmanifest sont ceux de la documentation
officielle FiveM (docs.fivem.net/docs/game-references/data-files).

Quand un fichier existe dans le pack mais que son type n'est pas confirmé par cette
documentation, la ligne est écrite en commentaire dans le fxmanifest, prête à
décommenter si tu sais que ton pack en a besoin. C'est le cas de explosionfx.dat et
de dlctext.meta.


APRÈS

1. Copie le dossier dans le resources de ton serveur.
2. Ajoute   ensure nom_du_vehicule   dans ton server.cfg.
3. Redémarre et regarde la console : si une ligne passe en rouge, elle te dit quel
   fichier pose problème.


Un souci, une idée : discord.gg/kaapsule