v50 Steam/Premium information for editors
  • v50 information can now be added to pages in the main namespace. v0.47 information can still be found in the DF2014 namespace. See here for more details on the new versioning policy.
  • Use this page to report any issues related to the migration.
This notice may be cached—the current version can be found here.

Difference between revisions of "Utility:Stonesense"

From Dwarf Fortress Wiki
Jump to navigation Jump to search
(→‎For Users: added info about the overlay)
(→‎For Users: remove backslashes)
Line 13: Line 13:
 
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.   
 
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.
+
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==
 
==For modders and developers==

Revision as of 02:34, 24 June 2014

This utility page is about v0.34.11, an older version of DF.
Stonesense Screenshot

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

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.

For modders and developers

  • 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

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)