Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
A retro isometric visualizer for Dwarf Fortress
Failed to load latest commit information.
CMake/Modules updated trunk to the new graphics engine, and the latest DFhack
materials_info fixed up the buildings, but they won't work right till the occupancy …
resources Improve, clarify, and expand documentation
utilities updated trunk to the new graphics engine, and the latest DFhack
.gitignore Add allegro-osx to .gitignore
BuildingConfiguration.cpp Fixed custom workshops not being properly applied.
BuildingConfiguration.h Fixed custom workshops not being properly applied.
CMakeLists.txt Fixed CMakeLists.txt to point to the new readme.
Changelog.txt Improve, clarify, and expand documentation
ColorConfiguration.cpp Made Designations semitransparent.
ColorConfiguration.h added std:: to a whole slew of places where it was needed.
ConditionalSprite.cpp Fix whitespace issues
ConditionalSprite.h Fix whitespace issues
Config.cpp Fix whitespace issues
Config.h Fix whitespace issues
ConnectionState.cpp Added support for tree growths.
ConnectionState.h Added support for tree growths.
Constructions.cpp Fix whitespace issues
Constructions.h Fix whitespace issues
ContentBuildingReader.cpp Fix whitespace issues
ContentBuildingReader.h Fix whitespace issues
ContentLoader.cpp Fix whitespace issues
ContentLoader.h Fix whitespace issues
Contributions.txt Added self to list of contributors.
CreatureConfiguration.cpp Put invalid job errors under verbose logs
CreatureConfiguration.h Fix whitespace issues
Creatures.cpp Fix whitespace issues
Creatures.h Fix whitespace issues
DumpInfo.cpp Fix whitespace issues
DumpInfo.h Moved assorted information dumping to its own file. Access to these f…
DwarfIso.vcxproj All references to "block" have been replaced by "tile" or "wall" as a…
EnumToString.cpp Depreciated terrain values. Now we use TOKENS! other stuff pending.
EnumToString.h Depreciated terrain values. Now we use TOKENS! other stuff pending.
FluidConfiguration.cpp Fix a crash related to the occlusion fix and flows. Fixed an error in…
FluidConfiguration.h Fix a crash related to the occlusion fix and flows. Fixed an error in…
GUI.cpp Fix whitespace issues
GUI.h Fix whitespace issues
GameBuildings.cpp Added some debug info for tree branches.
GameBuildings.h Fix whitespace issues
GroundMaterialConfiguration.cpp Fix whitespace issues
GroundMaterialConfiguration.h added std:: to a whole slew of places where it was needed.
ItemConfiguration.cpp Fixed a crash from opening stonesense twice.
ItemConfiguration.h added std:: to a whole slew of places where it was needed.
Keybinds.cpp Fix whitespace issues
LICENSE License for stonesense code and artwork.
MapLoading.cpp Fix whitespace issues
MapLoading.h Fix whitespace issues
MaterialMatcher.cpp Fixed MaterialMatcher and made it actually work.
MaterialMatcher.h Fixed MaterialMatcher and made it actually work.
OcclusionTest.cpp Fix whitespace issues
OcclusionTest.h Fix whitespace issues
Overlay.cpp Rename OS X hooks
Overlay.h Fix whitespace issues
README.md Improve, clarify, and expand documentation
SegmentProcessing.cpp Fix whitespace issues
SegmentProcessing.h Fix whitespace issues
SpriteColors.cpp Fix whitespace issues
SpriteColors.h Fix whitespace issues
SpriteMaps.cpp Fix whitespace issues
SpriteMaps.h Fix whitespace issues
SpriteObjects.cpp Fix whitespace issues
SpriteObjects.h Fix whitespace issues
StonesenseSolution.sln Put in the new DFhack headers.
TODO.txt Improve, clarify, and expand documentation
Tile.cpp Fix whitespace issues
Tile.h Fix whitespace issues
TileCondition.cpp Fix whitespace issues
TileCondition.h Fix whitespace issues
TileDirection.h Started moving things over to using RPC functions instead of reading …
TileTree.cpp Fix whitespace issues
TileTree.h Fix whitespace issues
TiletypeMatcher.cpp Started moving things over to using RPC functions instead of reading …
TiletypeMatcher.h Started moving things over to using RPC functions instead of reading …
TrackingModes.cpp Fix whitespace issues
TrackingModes.h added cursor-follow tracking mode, and fixed the old camera-position bug
TreeGrowthConfiguration.cpp Added support for tree growths.
TreeGrowthConfiguration.h Added support for tree growths.
UserInput.cpp Fix whitespace issues
UserInput.h Fix whitespace issues
VegetationConfiguration.cpp Fix whitespace issues
VegetationConfiguration.h Fix whitespace issues
WorldSegment.cpp Fix whitespace issues
WorldSegment.h Fix whitespace issues
common.h Fix whitespace issues
commonTypes.h Fix whitespace issues
fix-libs-stonesense.sh Update fix-libs script
main.cpp Fix whitespace issues
res.rc updated trunk to the new graphics engine, and the latest DFhack
stonesense.ico updated trunk to the new graphics engine, and the latest DFhack
stonesense.xpm Update stonesense for current dfhack, make sure it's buildable as a p…

README.md

Welcome to Stonesense

Stonesense is a third party visualizer that lets you view your Dwarf Fortress world in a classic isometric perspective.

Compatibility

All versions of Stonesense since DF2010 must be compiled with the appropriate DFHack version. Stonesense is thus usually distributed with DFHack, and will not work with any other version.

Usage

To run Stonesense in a separate window, use the DFHack command stonesense, alias ssense.

You can try the in-game overlay with stonesense overlay; be aware it's incomplete and not yet suitable for use as your only interface.

Configuration options can be pre-set and are documented in the init.txt file. Many can be toggled by the controls listed in keybinds.txt.

Controls

Mouse

Mouse controls are hard-coded and cannot be changed.

Left click:    Move debug cursor (if available)
Right click:   Recenter screen
Scrollwheel:   Move up and down 
Ctrl-Scroll:   Increase/decrease Z depth shown

Keyboard

Check keybinds.txt for the configured key bindings and descriptions, including zooming , changing the dimensions of the rendered area, toggling various views, fog, and rotation.

Follow mode

Follow mode makes the Stonesense view follow the location of the DF window. The offset can be adjusted by holding Ctrl while using the keyboard window movement keys. When you turn on cursor follow mode, the Stonesense debug cursor will follow the DF cursor when the latter exists.

Contacts

Known Issues

See the issue tracker on GitHub for recent bugs and issues.

  • If Stonesense gives an error saying that it can't load creatures/large_256/*.png, your video card cannot handle the high detail sprites used. Either open creatures/init.txt and remove the line containing that folder, or use these smaller sprites.
Something went wrong with that request. Please try again.