gryn010 / datafus

The Dofus database in a json file. Restful API for a lighter usage. Includes the python tool to build the database by sraping the website.

Datafus

Datafus is a small python3 tool to build the dofus database by scrapping the website. The final databases is a JSON file.

Download the database

If you need the database in local for your project, you download it here :

• French database
• English database
• German database
• Spanish database
• Itanian database
• Portuguese database

Use the RESTFULL API

If you don't need the database in local, you can use the RESTFUL API setup on GitHub pages. Simply do a get request with the following url :

• List all the items in the category :

https://lucberge.github.io/Datafus/{date}/{language}{category}

Exemple :

Get all the monsters : https://lucberge.github.io/Datafus/21.01.27/fr/monsters

• Find an item from it's id :

https://lucberge.github.io/Datafus/{date}/{language}/{category}/{id}

You need to remove the s in the category value.

Exemple :

Get the monsters with a specific id: https://lucberge.github.io/Datafus/21.01.27/fr/monster/1047

File structure

• monsters List of Item: List of monsters in the game
• weapons List of Item: List of weapons in the game
• equipments List of Item: List of equipments in the game
• sets List of Item: List of sets in the game
• pets List of Item: List of pets in the game
• mounts List of Item: List of mounts in the game
• consumables List of Item: List of consumables in the game
• resources List of Item: List of resources in the game
• ceremonial_items List of Item: List of ceremonial items in the game
• sidekicks List of Item: List of sidekicks items in the game
• idols List of Item: List of idols in the game
• harnesses List of Item: List of harnesses in the game

Item structure

The following table show the feilds which exists or not for a given item.

✔️ The field is mandatory

⚫ The field is optionnal

❌ The field doesn't exists

Field	Monster	Weapon	Equipment	Set	Pet	Mount	Consumable	Resource	Cremonial item	Sidekick	Idol	Harnesse
url key	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️
id	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️
name	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️
img	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️
type	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️
level	✔️	✔️	✔️	✔️	✔️	❌	✔️	✔️	✔️	❌	✔️	✔️
description	❌	✔️	✔️	❌	✔️	❌	✔️	✔️	✔️	✔️	✔️	✔️
effects	❌	⚫	⚫	❌	❌	⚫	⚫	⚫	⚫	❌	❌	❌
conditions	❌	⚫	⚫	❌	❌	❌	⚫	⚫	⚫	❌	❌	⚫
characteristics	✔️	✔️	❌	❌	❌	✔️	❌	❌	⚫	✔️	❌	❌
resistances	✔️	❌	❌	❌	❌	❌	❌	❌	❌	❌	❌	❌
craft	❌	⚫	⚫	❌	❌	❌	⚫	⚫	⚫	❌	✔️	⚫
bonuses	❌	❌	❌	❌	❌	❌	❌	❌	❌	❌	✔️	❌
items	❌	❌	❌	✔️	❌	❌	❌	❌	❌	❌	❌	❌
set_bonuses	❌	❌	❌	✔️	❌	❌	❌	❌	❌	❌	❌	❌
set_total_bonuses	❌	❌	❌	⚫	❌	❌	❌	❌	❌	❌	❌	❌
evolutionary_effects	❌	❌	❌	❌	⚫	❌	❌	❌	❌	❌	❌	❌
spells	❌	❌	❌	❌	❌	❌	❌	❌	❌	❌	✔️	❌

Fields description

• url String: Url of the item. Unique for each item.

"url":...

• id Integer: Id of the item.

"id":...

• name String: Name of the item.

"name":...

• img String: Image url of the item.

"img":...

• type String: Type of the item (Bow, Cereal, Ore, Beer...)

"type":...

• level Integer (Monsters exclude): Level of the item from 1 to 200.

"level":...

• level Tuple of Integer (Monsters only): Minimal and Maximal value of the monster from 1 to 200.

"level":[
  ...,
  ...
]

• description String: Description of the item.

"description":...

• effects List of String : List of string effects.

"effects":[
  ...,
  ...
]

• conditions List of String : List of string conditions.

"conditions":[
  ...,
  ...
]

• characteristics List of String: List of string characteristics.

"characteristics":[
  ...,
  ...
]

• resistances List of String: List of string resistances.

"resistances":[
  ...,
  ...
]

• craft List of Craft : How to craft the item.

"craft":[
  {
    "url":...,
    "quantity":...
  },
  {
    "url":...,
    "quantity":...
  },
  ...
]

• bonuses List of String: List of string bonuses.

"bonuses":[
  ...,
  ...
]

• items List of String: List of items url.

"items":[
  ...,
  ...
]

• set_bonuses List of String: List of string set bonuses.

"set_bonuses":[
  ...,
  ...
]

• set_total_bonuses List of String : List of string set total bonuses.

"set_total_bonuses":[
  ...,
  ...
]

• evolutionary_effects List of String : List of string evolutionary effects.

"evolutionary_effects":[
  ...,
  ...
]

• spells List of String: List of string spells.

"spells":[
  ...,
  ...
]