Editing Utility:Stonesense

{{Quality|Superior|01:14, 29 September 2013 (UTC)}}
{{uv|DF2012}}
[[File:stonesense_screen.png|thumb|right|Stonesense Screenshot]]

Stonesense is a third party visualizer, implemented as a [[Utility:DFHack|DFHack]] plugin, that lets you view your Dwarf Fortress world in a classic isometric perspective.

There is an [http://www.bay12forums.com/smf/index.php?topic=106497 official thread] for feedback, questions, requests or bug reports.  There is also [http://www.bay12forums.com/smf/index.php?topic=48172.0 a thread dedicated to screenshots] taken using Stonesense.  

==For Users==

Stonesense is distributed as part of [[Utility:DFHack|DFHack]], and included in the [[Utility:Lazy_Newb_Pack|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.

==For modders and developers==

* If you just want to '''add existing content''': The [[Utility:Stonesense/Content_repository|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==
[https://github.com/peterix/stonesense 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 vigorously updated)

[[Category:Utilities]][[Category:Stonesense]]