Grand Theft Auto(III, VC, SA) img-archive reader.


Allows you to get data from GTA [III, VC, SA] img archive

Example

$3

GTA SA does not have a .dir archive, it is included inside the .img. You can put one buffer in both loadDIR and loadIMG methods
``ts
const resource = readFileSync('./assets/gta3.img').buffer;
imgReader.loadDIR(resource);
imgReader.loadIMG(resource);
`

$3

save infernus.txd + infernus.dff
`ts
import {ImgReader} from "rw-img-reader";
import {readFileSync, writeFileSync} from 'fs';

const imgReader = new ImgReader();
imgReader.loadDIR(readFileSync('./assets/gta3.dir').buffer);
imgReader.loadIMG(readFileSync('./assets/gta3.img').buffer);

for (const asset of imgReader.getAssetList()) {
if (asset.name.includes('infernus')) {
// save file
writeFileSync('./assets/unpacked/' + asset.name , Buffer.from(imgReader.loadAsset(asset)))
}
}
`

$3

write all resources in browser console
`ts
import {ImgReader} from "rw-img-reader";

async function example() {
const imgReader = new ImgReader();

const dirResource = ((await fetch('http://localhost:5173/gta3.dir')).arrayBuffer());
imgReader.loadDIR(await dirResource);

const imgResource = (await fetch('http://localhost:5173/gta3.img')).arrayBuffer();
imgReader.loadIMG(await imgResource);

console.log(imgReader.getAssetList())
}

example();
`

using with rw-parser

`ts

const dffAsset = imgReader.getAssetByName('infernus.dff');
if (dffAsset) {
const dffParser = new DffParser(Buffer.from(imgReader.loadAsset(dffAsset)))
console.log(dffParser.parse());
}

const txdAsset = imgReader.getAssetByName('infernus.txd');
if (txdAsset) {
const dffParser = new TxdParser(Buffer.from(imgReader.loadAsset(txdAsset)))
console.log(dffParser.parse());
}
``