https://github.com/nornagon/erthur

A mapping tool for Dwarf Fortress
https://github.com/nornagon/erthur

dfhack dwarf-fortress

Last synced: 4 months ago
JSON representation

A mapping tool for Dwarf Fortress

• Host: GitHub
• URL: https://github.com/nornagon/erthur
• Owner: nornagon
• Created: 2020-06-18T15:49:53.000Z (over 5 years ago)
• Default Branch: master
• Last Pushed: 2022-03-26T22:39:35.000Z (almost 4 years ago)
• Last Synced: 2025-02-23T06:45:59.948Z (12 months ago)
• Topics: dfhack, dwarf-fortress
• Language: JavaScript
• Size: 34.9 MB
• Stars: 5
• Watchers: 3
• Forks: 0
• Open Issues: 3
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          
# Êrthur, The Infinite Universe

Êrthur is a tool to extract a high-resolution, zoomable embark map of an entire

[Dwarf Fortress](https://bay12games.com/dwarves/) world.

Here's an [example](https://nornagon.github.io/erthur/index.html).

[![](https://i.imgur.com/j65UtXg.png)](https://nornagon.github.io/erthur/index.html)

It's not in a well-packaged format for ease of use currently, but if you'd like

to try it out for yourself despite that, here's a description of the parts

you'll need to run and how they work.

You'll need [DFHack](https://docs.dfhack.org/en/stable/) and

[NodeJS](https://nodejs.org/).

1. Clone this repo in the root of your DF install, and copy

   `export-embark-map.lua` to the `hack/scripts` DFHack folder.

2. Enter the embark screen. If your save is mid-fortress, make a copy of your

   save and retire the fortress, and enter the embark screen on the copy.

3. Run `export-embark-map` from the DFHack console. This will take a while, and

   when it's done it will produce a `map.json` file in the root DF folder.

4. Run `npm install` in the `erthur` folder to fetch the dependencies.

5. Run `node draw.js` in the `erthur` folder. This will read the `map.json`

   file as well as the palette in `../data/init/colors.txt`.

6. Once this script is done, open `index.html`. Tada!