Dwarf Fortress companion app turns raws into a searchable reference book

Overseer’s Reference Manual takes the installed files in your own Dwarf Fortress setup and turns them into a searchable reference book instead of a pile of text entries. Instead of trusting the wiki as your only map, you can pull answers from the game’s actual data.

What the app is really doing

Overseer’s Reference Manual is a local companion app built to inspect the raws already sitting in your installation. The project is built with Tauri, SolidJS, TailwindCSS, daisyUI, and Rust, and it uses dfraw_json_parser to turn those files into something the app can browse. On first run, it asks you to point it at a valid game directory so it can parse your own data automatically.

That approach gives it a very different feel from a static dump. Instead of asking you to trust an external database, it reads the game you actually have installed and presents that information in a cleaner, searchable form.

What you can search right now

The app currently surfaces most creature information, some plant information, and basic inorganic material information. That sounds narrow on paper, but in Dwarf Fortress those are three of the most useful categories to have at your fingertips. Creatures drive danger, labor, hauling, food, and weird edge cases; plants feed cooking, brewing, and farming; inorganics sit underneath everything from construction to industry.

That scope makes the app especially useful when you are trying to answer a small but annoying question quickly. Maybe you want to know what a creature definition looks like without scrolling through files by hand, or you are checking how a plant is represented in the raws before you build around it. Maybe you are comparing an inorganic entry against the material behavior you expect in a fort plan or mod. The app is not trying to be all of Dwarf Fortress in one window, but it covers the pieces that most often turn into a file hunt.

Why it beats digging through raws by hand

Anyone who has opened raw files directly knows the routine: search, scroll, jump between definitions, then lose your place the moment you tab away. Overseer’s Reference Manual cuts that friction down by letting you search directly and browse the parsed output instead of spelunking through text.

For ordinary play, that means you spend less time decoding file structure and more time making decisions. If you are planning a fort, that matters when you are trying to understand what a creature brings to the table, what a plant can support, or which materials are available in the world you generated.

Where modders get the biggest payoff

Modding Dwarf Fortress often means balancing a creature, checking material properties, or figuring out how a plant is represented before you change it. Overseer’s Reference Manual gets you to those definitions faster, which lowers the barrier between an idea and an actual testable edit.

If you have ever tried to tune a new creature and had to bounce between raw files to see how its tags interact, you already know why a local reference tool helps. The same goes for item-related research, where you are usually trying to understand how the game treats a class of materials or definitions before you commit to a change.

Why the project feels established, not throwaway

The repository history shows this is not a weekend experiment that got abandoned after one clever idea. It shows hundreds of commits and a release history with active versioning in the repo metadata. That kind of continuity matters for a tool like this, because a raws browser only stays useful if it keeps up with the game it is parsing.

The app is a searchable overview of the installed raws, not a one-off export or a frozen snapshot.

Who will actually use this every week

The players who get the most out of Overseer’s Reference Manual are the ones who have outgrown the wiki but still need quick answers. If you are planning forts with an eye toward creatures, plants, and inorganics, the app gives you a faster way to inspect the raw data that shapes those choices. If you mod, balance, or just like understanding how Dwarf Fortress actually labels its own world, the app gives you quick answers.