@2003scape/rsc-archiver

rsc-archiver

compress and decompress runescape classic .jag/.mem cache files. these files contain a proprietary header describing the size of the archive, and of each individual entry (file). filenames are stored with a "hash" so it's impossible to recover the originals without bruteforcing (unless they're under ~5 characters).

install

$ npm install @2003scape/rsc-archiver

usage

cli

rsc-archiver <command>

Commands:
  rsc-archiver x <archive> <file> [<out>]  extract a file from an archive
                                                              [aliases: extract]
  rsc-archiver a <archive> <file> [-g]     add a file to an archive
                                                                  [aliases: add]
  rsc-archiver d <archive> <file>          remove a file from an archive
                                                               [aliases: delete]
  rsc-archiver l <archive>                 list hashes and file sizes in an
                                           archive               [aliases: list]

Options:
  --help     Show help                                                 [boolean]
  --version  Show version number                                       [boolean]

api

const fs = require('fs');
const { JagArchive } = require('./src');

let rawJag = fs.readFileSync('./data204/sounds1.mem');
let archive = new JagArchive();
archive.readArchive(rawJag);
console.log(`cache has ${archive.entries.size} files`);
fs.writeFileSync('death.pcm', archive.getEntry('death.pcm'));

const testArchive = new JagArchive();
testArchive.putEntry('test.txt', Buffer.from('test string'));
fs.writeFileSync('./data204/test.jag', testArchive.toArchive(true));

rawJag = fs.readFileSync('./data204/test.jag');
archive = new JagArchive();
archive.readArchive(rawJag);
console.log(`cache has ${archive.entries.size} files`);
console.log(archive.getEntry('test.txt').toString());

license

Copyright 2019 2003Scape Team

This program is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more details.

You should have received a copy of the GNU Affero General Public License along with this program. If not, see http://www.gnu.org/licenses/.