Skip to content
Go to file

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

Cataclysm DDA Item/Recipe Browser

Note: this is no longer maintained.

This is a simple tool to browse through the items and recipes available in Cataclysm: Dark Days Ahead, this is done by reading the game's data files and creating an optimized database linking everything together.

A copy of this code currently hosted by Sergio Duran (Sheco) at


  • Search for items and monsters.
  • Show how an item can be crafted.
  • Show recipes using each item.
  • Automatic item catalogs, clothing, melee, ranged weapons, consumables, books, materials, qualities, flags, skills and gun mods.
  • Monster catalogs.


This can be used in a Vagrant environment. The current scripts provided have been tested on the official ubuntu/trusty32 vagrant box.

On windows, you will need an appropiate rsync.exe and ssh.exe on the path, (msys gets the job done). rsync was used instead of the default shared folders, because the shared folders are very slow.

To setup and run the environment, execute:

vagrant up

Everything should be up and running in a few minutes, you should be able to access the webapp at the appropiate address, it will probably be http://localhost:8000

Manual instalation

If you don't want to run a vagrant setup, you only need to make sure you have the appropiate dependencies.

  • composer
  • php5.4 (with the mcrypt extension)
  • memcached
  • A webserver

Then you can run the script, which will download the game's source code and composer dependencies.

The webserver should be able to read and write the files in the "storage" directory inside the data file path.


Please read the hacking guide to get an idea about how to read the code so you can update it.

You should then follow regular github guidelines to clone, commit and create pull requests.


This application is open-sourced software licensed under the MIT license


Cataclysm DDA: Item Browser




No releases published


No packages published


You can’t perform that action at this time.