Wakfu Tools

Binary Decoder of the game Wakfu for NodeJS (but not for browsers) and is inspired by WakfuDecrypt. It works in environments that have the game installed.

Installation

With NodeJS installed, run the command:

npm i wakfu-tools

Usage

CommonJS:

const wakfuTools = require('wakfu-tools')

EcmaScript6:

import wakfuTools from 'wakfu-tools'

Example

Example of using WakfuTools to return a Spell that has a specific image:

import wakfuTools from 'wakfu-tools'

const { SPELL } = wakfuTools.IndexBinaries
const wakfuPath = 'YOUR_WAKFU_GAME_PATH\Ankama\zaap\wakfu'

const spells = wakfuTools.loadDocument(wakfuPath, SPELL)

console.log(spells.find(e => e.gfx_id === 7005))

API

Indexes

Wakfu Tools has indexes to facilitate the choice of the resource.

IndexBinaries

It contains all the documents that can be retrieved from the binary files.

// Can be used literally
const spellIndex = wakfuTools.IndexBinaries.SPELL

// or destructuring
const { SPELL } = wakfuTools.IndexBinaries

To constant values check IndexBinaries.js.

IndexAnimations

It contains all the animations that can be retrieved from the binary files.

// Can be used literally
const npcIndex = wakfuTools.IndexAnimations.NPC

// or destructuring
const { NPC } = wakfuTools.IndexAnimations

Constant Values:

DYNAMIC, EQUIPMENT, GUI, INTERACTIVE, NPC, PET, PLAYER, RESOURCE

IndexTranslate

It contains all the translations that can be retrieved from each language file.

// Can be used literally
const spellNameIndex = wakfuTools.IndexTranslate.SPELL_NAME

// or destructuring
const { SPELL_NAME } = wakfuTools.IndexTranslate

To constant values check IndexTranslate.js.

Methods

loadWorldInfo (wakfuPath)

Returns an array with all the worlds decoded.

import wakfuTools from 'wakfu-tools'

const wakfuPath = 'YOUR_WAKFU_GAME_PATH\Ankama\zaap\wakfu'

console.log(wakfuTools.loadWorldInfo(wakfuPath))

loadDocument (wakfuPath, indexBinary)

Returns an array of all decoded resources.

import wakfuTools from 'wakfu-tools'

const { EMOTE } = wakfuTools.IndexBinaries
const wakfuPath = 'YOUR_WAKFU_GAME_PATH\Ankama\zaap\wakfu'

const emotes = wakfuTools.loadDocument(wakfuPath, EMOTE)

console.log(emotes.find(e => e.cmd === '/hi'))

loadAnimations (wakfuPath, indexAnimation)

Returns an array of all decoded resources.

import fs from 'fs'
import wakfuTools from 'wakfu-tools'

const { NPC } = wakfuTools.IndexAnimations
const wakfuPath = 'YOUR_WAKFU_GAME_PATH\Ankama\zaap\wakfu'

const animations = wakfuTools.loadAnimations(wakfuPath, NPC)
const animation = animations.loadAnimation(1007)
const textureFile = animations.loadTexture(animation.texture.name)

fs.writeFileSync(`./texture.png`, textureFile)

loadTranslations (wakfuPath, language)

Returns an object of all translated resources.

import wakfuTools from 'wakfu-tools'

const lang = 'en'
const { SPELL_NAME } = wakfuTools.IndexTranslate
const wakfuPath = 'YOUR_WAKFU_GAME_PATH\Ankama\zaap\wakfu'

const translate = wakfuTools.loadTranslations(wakfuPath, lang)

console.log(translate[SPELL_NAME][7052])

Language can be:

pt, en, fr, de, es

Most complete example:

import wakfuTools from 'wakfu-tools'

const lang = 'en'
const { SPELL } = wakfuTools.IndexBinaries
const { SPELL_NAME, SPELL_BACKGROUND_DESCRIPTION } = wakfuTools.IndexTranslate
const wakfuPath = 'YOUR_WAKFU_GAME_PATH\Ankama\zaap\wakfu'

const translate = wakfuTools.loadTranslations(wakfuPath, lang)
const spells = wakfuTools.loadDocument(wakfuPath, SPELL)

const AllSpellNamesAndDescriptions = spells.map(spell => ({
    name: translate[SPELL_NAME][spell.id],
    description: translate[SPELL_BACKGROUND_DESCRIPTION][spell.id]
}))

console.log(AllSpellNamesAndDescriptions)