tnajdek / rafiki

RAFIKI - Riot Archive File extractor & packer

Python API for reading and writing to a raf format used by RIOT's game Leauge of Legends. Tested on Mac and Windows (for platform's native version of the game).

*** This is low-level API exclusively for dealign with RAF files. If you're after multi-screen/ultrawide resolution support mod, see: lol-eyefinity-surround-fixhud.

Helper/Example Scripts

Extract all files containing hud string in its path. This will create a new folder extracted wher relevant files will be placed (under their full RAF path):

python bin/rafiki.py extract -s full/path/to/lol -f "hud/elements" -o extracted

Find all files containing string hud, then search for file overrides in a folder named extracted and if an override exists, replace the file before packing everything back into archives. A new folder overrides will be created where relevant raf archives will be placed. You need to copy these files manually to actually include overrides in the game.

python bin/rafiki.py pack -s full/path/to/lol -f "hud/elements" -r extracted -o overrides

Note: Running on Windows

All above should run ok on Windows. Bear in mind you need to change all "/" to "". Obviously you need to install Python for Windows

You will most likely need a 64 bit version of python (and 64 bit version of Windows) as 32 bit version tends to come up with a Memory Error on writing raf files. Patches welcome.

rafiki's Issues

Cannot extract using Windows (Python 64bit)

My lol path is C:\Riot\lol .. did i do something wrong?

C:\Riot>python rafiki.py extract -s lol -f "hud/elements" -o extracted
Traceback (most recent call last):
File "rafiki.py", line 75, in
collection = RafCollection(source_path)
File "C:\Riot\raf.py", line 143, in init
self.index[item] = RafArchive(os.path.join(path, item, filename))
File "C:\Riot\raf.py", line 71, in init
path = path.strip('\x00')
TypeError: Type str doesn't support the buffer API

C:\Riot>

Extract raf files in right order

when extracting all files,
raf.py #148:

for item,raf in self.index.iteritems():

will follow python dict order which is not correct order
so sometimes old files will overwrite new files

dict order :
hash of string .. seems pretty random
right order :
0.0.0.old -> 0.0.0.new

solution :

sortlist = [(key,value) for key,value in self.index.iteritems() ]
sortlist.sort(key = lambda i:(len(i[0]),i[0]))
for item,raf in sortlist: