Dofus 2.0 data mapper

Note

The scripts in this repository are deprecated due to the release of Dofus 3 and the ongoing development of a new version of Cori, which aims to handle information even more effectively. However, they can still serve as a useful reference for mapping data in Dofus 3.

About

This is not a game unpacker, but a collection of scripts designed to transform game data into easy to skim information. In order to unpack the game and get the input files required here, you must first use other scripts like PyDofus.

Files

• 📝 The exported .md files are useful for context injection into Corinna's AI-based responses; the information is splitted into sections and rarely exceeds 300 tokens each.
• 🔗 Data uploaded to the database (or exported as JSON files) are treated as menu components on Discord.
• ⚠ Input data must be located in the /input folder in JSON format.

Corinna is a hispanic community management system, therefore the exported data is by default in spanish. The language can be changed by changing the i18n_(lang).json file and some phrases around the scripts.

---

Scripts

Decode & Export Challenges

Information and criterions for ingame challenges.

$ node DecodeChallenges
# Database root updated 'dofus_challenges'
$ node ExportChallenges
# Output: pages/challenges/*.md

Decode Spells

Decode all character/monster spells including effects, criterions and details.

$ node DecodeSpells
# Database root updated 'dofus_spells'

Decode & Export Quests

Decode and update quest information.

$ node DecodeQuests
# Database root updated 'dofus_quests'
$ node ExportQuests
# Output: pages/quests/*.md

Decode & Export NPCs

• Generate NPC descriptions based on their dialogues.
• Update NPC coords for each quest involved.
• Export all collected NPC information.

$ node DecodeNpcs
# Fill the *NPCS_TO_UPDATE* array with the IDs you want to decode, or leave it empty to decode everything.
# Database root updated 'dofus_npcs'
$ node ExportNpcs
# Output: pages/npcs/*.md

Decode & Export Dungeons

Decode and update key information about every dungeon.

$ node DecodeDungeons
# Database root updated 'dofus_dungeons'
$ node ExportDungeons
# Output: pages/dungeons/*.md

Decode & Export Monsters

Decode all monsters information.

$ node DecodeMonsters
# Database root updated 'dofus_monsters'
$ node ExportMonsters
# Output: pages/monsters/*.md

Decode Achievements

$ node DecodeAchievements
# Database root updated 'dofus_achievements'

Decode & Export Items

Main information about each item of the game.

$ node DecodeItems
# Database root updated 'dofus_items'
$ node ExportItems
# Output: pages/items/*.md

Decode Maps

Decode the information of every map in the game.

$ node DecodeMaps
# Database root updated 'dofus_maps'

Decode Recipes

Decode all item recipes.

$ node DecodeRecipes
# Database root updated 'dofus_recipes'

Decode SubAreas

• Decode and update all subareas data.
• Update NPCs positions based on subareas data.
• Export markdown files with named-maps info and image urls.

$ node DecodeSubAreas
# Database root updated 'dofus_subareas'
# Database root updated 'dofus_npcs'
# Output: pages/subareas/*.md

Decode Jobs

Decode the information of all jobs.

$ node DecodeJobs
# Output: pages/jobs/*.md
# Database root updated 'dofus_jobs'

Decode Breeds

A brief introduction to Dofus breeds and their gameplay.

$ node DecodeBreeds
# Output: pages/breeds/*.md
# Database root updated 'dofus_breeds'

Export Hints

Export coords of key places in Dofus.

$ node ExportHints
# Output: pages/hints/*.md

Export Documents

Transcription of game books and documents with their respective images.

$ node ExportDocuments
# Output: pages/documents/*.md

Export Feature Descriptions

Information about the main features of Dofus.

$ node ExportFeatures
# Output: pages/guides/*.md
# Output: data/guidebookImageNames.json

Map captions

Add captions and watermark to map images.

$ node AddMapCaptions
# Input: output/maps/map-images/*.jpg
# Output: output/maps/map-coords/*.jpg