Utility:Stonesense
| This utility page is about v0.44.12, the current version of DF. |
Stonesense is a third party visualizer, implemented as a DFHack plugin, that lets you view your Dwarf Fortress world in a classic isometric perspective.
There is an official thread for feedback, questions, requests or bug reports. There is also a thread dedicated to screenshots taken using Stonesense.
For Users[edit]
Stonesense is distributed as part of DFHack, and included in the Lazy Newb Pack.
The standard function (dfhack "stonesense") opens a separate viewer window, which has read-only access to the game. It can follow the game view, or be moved independently.
As of June 2014, it is also possible to use Stonesense as a live overlay of the map in the main Dwarf Fortress window, replacing the usual 2D tiles. The DFHack command for this is "stonesense overlay". For best results, edit [segmentsize_z:2] in init.txt, and if you are unable to see the edges of the map with the overlay active try also decreasing the [segmentsize_XY] - normal values are 50 to 80 depending on screen resolution.
| Mouse Controls | |
|---|---|
| Left click | Move debug cursor (if available) |
| Scrollwheel | Move up and down |
| Right click | Recenter screen |
| Ctrl-Scroll | Increase/decrease Z depth shown |
| Keyboard controls | |||
|---|---|---|---|
| Movement controls | View Filters | ||
| F | Cycle Tracking Mode | F2 | Toggle OSD overlay |
| Enter | Rotate view 90 degrees | D | Toggle Designations |
| R | Reload segment | I | Toggle Stocks |
| C | Chop walls | U | Toggle Zones |
| S | Toggle single layer | M | Toggle Creature Moods |
| . (Period) | Zoom in | P | Cycle Professions (off/icons/names) |
| , (Comma) | Zoom out | J | Cycle Jobs (off/icon/description) |
| Alt+(Arrow Key) | Offset view | N | Toggle Creatures Names |
| 9 | Decrease Z-layer | B | Toggle hidden tile transparency |
| 0 | Increase Z-layer | H | Toggle revealing hidden tiles (cheater! :P) |
| / | Toggle hotkey overlay | ||
These lists of key bindings are not exhaustive. The most up-to-date and complete list can be found at the Stonesense Github page. The config file may also be edited to add additional keybindings to Stonesense.
For modders and developers[edit]
- If you just want to add existing content: The Stonesense Content Repository contains content packs that allow you to extend Stonesense functionality. These packs are made by members of the DF community.
- If you want to create your own content: You can learn how to create custom content for Stonesense at Utility:Stonesense/Adding_Content
- If you want to tweak Stonesense's source code : Stonesense is one of the many DFHack plugins. It comes with DFHack's source code, and if you manage to compile DFHack, then you've managed to compile Stonesense.
Credits[edit]
Stonesense's homepage and source code is on Github.
- Stonesense was written by Jonask, peterix, kaypy and Japa.
- Lead graphic development was done by Solifuge.
- Dfhack library was written by peterix.
- Additional Graphics and code were contributed by many many people, including (in alphabetical order):
- 7¢ Nickel, BatCountry, Belal, DeKaFu, Dante, Deon, dyze, Errol, fifth angel, frumpton, IDreamOfGiniCoeff, Impaler, Japa, jarathor, Jiri Petru, Lord Nightmare, McMe, Mike Mayday, Nexii Malthus, peterix, Seuss, soup, Talvara, winner, Xandrin.
(This list is not rigorously updated)
