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.

Editing Utility:Stonesense

Jump to navigation Jump to search

Warning: You are not logged in.
Your IP address will be recorded in this page's edit history.


The edit can be undone. Please check the comparison below to verify that this is what you want to do, and then save the changes below to finish undoing the edit.

Latest revision Your text
Line 1: Line 1:
{{Quality|Superior|01:14, 29 September 2013 (UTC)}}
+
If you are searching for "Stone Sense", the excellent reveal tool by 0x517A5D, see [http://dffd.wimbli.com/file.php?id=836]
{{uv|DF2014}}
 
{{Infobox utility
 
| image = File:stonesense_screen.png
 
| misc  =
 
* [http://www.bay12forums.com/smf/index.php?topic=106497 Bay12Forum Thread]
 
* [https://docs.dfhack.org/en/stable/plugins/stonesense/docs/Stonesense.html Documentation]
 
* [[Utility:Stonesense/Content_repository|Content Repository]]
 
* [https://github.com/peterix/stonesense Github page]
 
}}
 
  
'''Stonesense''' is a 3D visualizer [[utility]] for ''Dwarf Fortress'', implemented as a [[Utility:DFHack|DFHack]] plugin, that lets you view your ''Dwarf Fortress'' world in a classic isometric perspective.  
+
==Stonesense==
 +
Stonesense is a third party visualizer 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. 
+
The official thread for feedback, questions, requests or bug reports is located at [http://www.bay12games.com/forum/index.php?topic=43260.0]
  
==For Users==
+
==Source code==
 +
Project homepage:
 +
http://code.google.com/p/stonesense/
  
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. 
+
==Sprites preview and todo list==
 +
write me!
  
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 "<code>stonesense overlay</code>", but print mode must not be set to "TWBT" for this to run.  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 or increasing the [segmentsize_XY] - normal values are 50 to 80 depending on screen resolution.
 
  
{| class="wikitable collapsible collapsed" style="width:700px;"
+
===Credits===
! colspan="2"| Mouse Controls
+
Stonesense was written by Jonask, peterix, and kaypy.
|-
+
Dfhack library was written by peterix.
| '''Left click'''
+
Initial graphics were provided by Solifuge.
| Move debug cursor (if available)
+
Additional Graphics were contributed by:
|-
+
(fill me in)
| '''Scrollwheel'''
 
| Move up and down
 
|-
 
| '''Right click'''
 
| Recenter screen
 
|-
 
| '''Ctrl-Scroll'''
 
| Increase/decrease Z depth shown
 
|}
 
{|class="wikitable collapsible collapsed"  style="width:700px;"
 
! colspan="4"| Keyboard controls
 
|-
 
! colspan="2"| Movement controls
 
! colspan="2"| View Filters
 
|-
 
| '''F'''
 
| Cycle Tracking Mode
 
| '''F2'''
 
| Toggle OSD overlay
 
|-
 
| '''Enter'''
 
| Rotate view 90 degrees
 
| style="width: 30pt;" | '''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 [https://github.com/DFHack/stonesense/blob/master/resources/keybinds.txt Stonesense Github page]. The config file may also be edited to add additional keybindings to Stonesense.
 
 
 
==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==
 
* 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)
 
 
 
==Gallery==
 
<gallery widths=200px>
 
File:Roadtruss.jpg|Roadtruss, a tower [[megaproject]] by Crossroads Inc.
 
File:Stonesense prev.jpg|...
 
File:STV1.png|Example of Seuss's Tweaked Vegetation
 
</gallery>
 
 
 
[[Category:Utilities]][[Category:Stonesense]]
 
[[ru:Stonesense]]
 

Please note that all contributions to Dwarf Fortress Wiki are considered to be released under the GFDL & MIT (see Dwarf Fortress Wiki:Copyrights for details). If you do not want your writing to be edited mercilessly and redistributed at will, then do not submit it here.
You are also promising us that you wrote this yourself, or copied it from a public domain or similar free resource. Do not submit copyrighted work without permission!

To protect the wiki against automated edit spam, we kindly ask you to solve the following CAPTCHA:

Cancel Editing help (opens in new window)