GitHub - thewonderidiot/stonesense: A retro isometric visualizer for Dwarf Fortress

Branches Tags

Name		Name	Last commit message	Last commit date
Latest commit History 773 Commits
CMake/Modules		CMake/Modules
materials_info		materials_info
resources		resources
utilities		utilities
.gitignore		.gitignore
Block.cpp		Block.cpp
Block.h		Block.h
BlockCondition.cpp		BlockCondition.cpp
BlockCondition.h		BlockCondition.h
BlockFactory.cpp		BlockFactory.cpp
BlockFactory.h		BlockFactory.h
BlockTree.cpp		BlockTree.cpp
BlockTree.h		BlockTree.h
BuildingConfiguration.cpp		BuildingConfiguration.cpp
BuildingConfiguration.h		BuildingConfiguration.h
CMakeLists.txt		CMakeLists.txt
Changelog.txt		Changelog.txt
ColorConfiguration.cpp		ColorConfiguration.cpp
ColorConfiguration.h		ColorConfiguration.h
ConditionalSprite.cpp		ConditionalSprite.cpp
ConditionalSprite.h		ConditionalSprite.h
Config.cpp		Config.cpp
Constructions.cpp		Constructions.cpp
Constructions.h		Constructions.h
ContentBuildingReader.cpp		ContentBuildingReader.cpp
ContentBuildingReader.h		ContentBuildingReader.h
ContentLoader.cpp		ContentLoader.cpp
ContentLoader.h		ContentLoader.h
Contributions.txt		Contributions.txt
CreatureConfiguration.cpp		CreatureConfiguration.cpp
CreatureConfiguration.h		CreatureConfiguration.h
Creatures.cpp		Creatures.cpp
Creatures.h		Creatures.h
DwarfIso.vcxproj		DwarfIso.vcxproj
FluidConfiguration.cpp		FluidConfiguration.cpp
FluidConfiguration.h		FluidConfiguration.h
GUI.cpp		GUI.cpp
GUI.h		GUI.h
GameBuildings.cpp		GameBuildings.cpp
GameBuildings.h		GameBuildings.h
GroundMaterialConfiguration.cpp		GroundMaterialConfiguration.cpp
GroundMaterialConfiguration.h		GroundMaterialConfiguration.h
MapLoading.cpp		MapLoading.cpp
MapLoading.h		MapLoading.h
ON COMPILING.txt		ON COMPILING.txt
Occlusion_Test.cpp		Occlusion_Test.cpp
Occlusion_Test.h		Occlusion_Test.h
README.txt		README.txt
SpriteColors.cpp		SpriteColors.cpp
SpriteColors.h		SpriteColors.h
SpriteMaps.cpp		SpriteMaps.cpp
SpriteMaps.h		SpriteMaps.h
SpriteObjects.cpp		SpriteObjects.cpp
SpriteObjects.h		SpriteObjects.h
StonesenseSolution.sln		StonesenseSolution.sln
TODO.txt		TODO.txt
UserInput.cpp		UserInput.cpp
VegetationConfiguration.cpp		VegetationConfiguration.cpp
VegetationConfiguration.h		VegetationConfiguration.h
WorldSegment.cpp		WorldSegment.cpp
WorldSegment.h		WorldSegment.h
common.h		common.h
commonTypes.h		commonTypes.h
main.cpp		main.cpp
res.rc		res.rc
stonesense.ico		stonesense.ico
stonesense.xpm		stonesense.xpm

Repository files navigation

Welcome to Stonesense Felsite(3.1)

Thank you for trying out our little visualizer,
as always, we appreciate any feedback.

Please note, that for the time being Stonesense Felsite ONLY supports DF 31_25.

To run stonesense, Copy DFHack into the dwarf fortress folder, and run DwarfFortress.exe.
When DFHack console appears, type in stonesense and press enter.

--== Configuration ==--

Application options are set and documented in the init.txt file

--== Controls ==--

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

-- Keyboard --
Arrow keys: Move around (hold shift for large moves)
PG UP/PG Down: Move up and down
9 and 0: Alternative move up and down
1 and 2: Increase/decrease Z depth shown
Enter: Rotate view 90 degrees
ESC: Exit program
U: Toggle stockpiles.
I: Toggle zones.
C: Toggle truncated walls.
F: Toggle follow mode.
H: Toggle hidden blocks.
B: Toggle blacked out areas.
S: Toggle single layer view.
N: Toggle creature names.
M: Toggle creature emotion icons.
O: Toggle occlusion culling.
F2: Screenshot mode/hide display overlays
F5: Save Screenshot
CTRL + F5: Save Screenshot of entire fortress with the current Z level settings.
CTRL + SHIFT + F5: Save a screenshot of the entire fortress from the current top Z level down to the bottom of the map.
ALT + F5: Save a volumetric thing I'm testing out.
Numpad + and -: Increase/Decrease AutoReload Rate
CTRL + navigation: Adjusts follow mode offset

-- Debug Keys --
(prolly not useful for you guys)
D: redraw screen
R: reload memory from DF
G: reload sprites & config from disk
F10: display available sprites
Numpad numbers: Move debug cursor (if available)
Ctrl+F: Toggle Cursor Follow Mode

-- Follow mode --
When you turn on follow mode, the screen will jump to the location of the DF window.
You can adjust the position of the follow mode relative to the DF window by
holding Ctrl while using the keyboard window movement keys.

When you turn on cursor follow mode, the debug cursor will follow the DF cursor when it exists.

-- Occlusion Culling --
There is an experimental feature that hides blocks that are not visible, for a speed increase.
This is a work in progress, and very buggy. It can be turned off with 'o', if something is missing.

--== Contacts ==--

Stonesense mailing list:
http://groups.google.com/group/stonesense

Stonesense on Bay12Games forums:
http://www.bay12games.com/forum/index.php?topic=43260.0

--== Known Issues ==--

We have seen some crash bugs from time to times.

Good Luck!
- The Stonesense Crew