Print

Please login or register.
1 Hour 1 Day 1 Week 1 Month Forever
Login with username, password and session length

[Exponent]

The Wiki Page, with installation instructions, and eventually usage information.
Dwarf Fortress File Depot Download (current version:  0.6 Beta)

This is a module for Gibbed's Dwarf Fortress Tweak utility that can conditionally alter tiles of the map. By supplying a condition and a set of operations, the program is able to evaluate the condition for each tile, and if the condition is true, then the operations are executed, altering that particular tile is some fashion. This flexibility potentially provides numerous uses. This utility was originally designed to be a smarter version of Reveal, but grew to become much more. Not only can this utility show or hide tiles, but it can change whether or not they are outside, inside, light, dark, subterranean, or above ground. It can alter water and magma levels, mining designations, and in some cases substantially alter tile types, such as when creating a river source tile.

I was waiting to release this with the next version of DF, as I know for a fact that the new viewport code will break portions of this program, and I was meaning to spend some more tile polishing the program, but I think it is good enough now for me to release it to the public so that I can get some user feedback.  I'm calling it a beta version for the moment, but I have spent a decent amount of time trying to polish it beyond just basic functionality.

I will eventually try to add more documentation on the wiki page, but the tooltips available by hovering the mouse over items in the insert menu or their corresponding toolbar buttons (which are enabled when the focus is on either of the two lowest text boxes) should be enough to guide those who are sufficiently adventuresome.  Be warned that this program can occasionally do weird things to your map (or at least I suspect as much), especially when altering fundamental tile types (such as changing a tile to grass), so save your map and be ready to kill DF through the task manager if things go horribly wrong.

Basic usage, though, is to write a condition and a set of one or more operations (some defaults are already supplied as examples), and then click the lightning bolt icon on the right side corresponding to the condition/operation set that you are editing or wish to execute.  After a short time (usually no more that two or three seconds on my machine) the hourglass mouse cursor should go away and the DF window should update to reflect any changes.  I have added an undo/redo feature that applies to the DF map tiles to make experimentation easier.  If you didn't like the effect you had, just hit undo, tweak the condition or operations, and try it again.  This feature eats memory, though, so either edit the xml file that comes as part of the zip to change the maximum undo/redo depth to some small number, or occasionally go to the Execute menu and clear the buffer.

Any comments, suggestions, ideas for new functions, or ideas on creative ways to use existing functions are all welcome.

[edit:  2008/08/08 23:39]
Improved error reporting at least marginally in some cases, and significantly in others.  Version 0.2 is now available from DFFD:  http://dffd.wimbli.com/file.php?id=404

[edit:  2008/08/09 13:53]
Fixed some errors regarding the reading of optional memory addresses/offsets, and updated the code to work with the new DF v0.28.181.39f.  Version 0.3 is now available from DFFD (link above).

[edit:  2008/08/15 16:39]
Version 0.4 is now available from DFFD (link above).  Changes:

• general interface improvements
• fixed undo bug, when the maximum undo/redo depth was infinite
• added z_distance_to_surface
• renamed is_ramp to is_upward_ramp
• added is_ramp, is_downward_ramp, is_above_upward_ramp and make_downward_ramp
• renamed is_lava to is_magma_source, and make_lava to make_magma_source
• added traffic designation queries, which had erroneously been left out
• added a few additional example operation sets to the included file

[edit:  2008/08/15 18:20]
Less than two hours, and version 0.5 is now available.  Just a single bug fix:

• set_liquid_type_to_water was not working, now it is

[edit:  2008/08/18 22:42]
Version 0.6 is now available from DFFD (link above).  Changes:

• added bodily fluid functions (blood, pus, ichor, goo, slime) in the Occupancy categories, along with related constants in the Constants category
• renamed is_vomit to has_vomit, and moved it and set_vomit to the Occupancy categories
• renamed is_snow_covered to has_snow, and set_snow_covered to set_snow, and moved them to the Occupancy categories
• added support for the string type, including a to_string function and the concatenation operator (+)
• added print and print_line functions for writing to the output panel
• added the is_allocated function
• added a new Experimental category, including functions for reading/writing type, matgloss id, and biome id
• provided a variation for most query functions to accept specific x, y, z coordinates, instaed of just defaulting to the current tile's x, y, z coordinates
• fixed various bugs with the functions in the Raw category, and added mask_and_set_ versions of each
• various small improvements to the interface
• updated viewport calculation code to properly handle changes in the latest DF version (0.28.181.40a)

[Apegrape]

Whoa.. So you could.. Flood the entire world with a couple of clicks? 

[Exponent]

Yes, it's actually very powerful.  Too powerful for some, perhaps.  There are some legitimate uses, too, for example, modifying above ground/subterranean values to minimize the harm of the entrance dance.  But if you are uncontrollably drawn to cheating, but find that by doing so you cheapen the experience of playing the game, then be warned.  This program might be considered dangerous to you.

[Apegrape]

I will probably try some completely cruel things, but during serious play, I doubt I will use it's more "powerful" features.

[Slappy Moose]

It sounds very useful, but I keep getting an error, I may have installed it wrongly.


I will keep trying and let you know if I can't find a fix...




Hah, I fixed it. I just added the 39e version code and it worked 
Thanks for this utility, it's fantastic! I love being able to designate every tree for chopping and all that, adn the "make your own program" is awesome!
Wooo!


Quick question: What do trees need to grow? A "light" tile? Do they need to eb outdoors? I want to make a massive underground tree farm.

[Exponent]

I don't actually know the details.  I haven't had a chance to experiment with all the possibilities that aren't normally doable.  As far as I'm aware, grass is the only thing that is needed, though it could be more than that.  It would certainly be a useful experiment.  Proper biome support might be necessary too, unfortunately, and that is presently beyond the abilities of my program to change.

[Slappy Moose]

Alright, I'll probably make a few rooms, and apply different characteristics too each. I'll try to remember to come back and post my findings.

[Sprout]

This looks like the exact thing I've been looking for for my various dark purposes, but whenever I try to run an operation, I get the error message:


Reading of the map data resulted in an unknown exeption


Do you know how to fix this, and what's causing it?

[Slappy Moose]

I got the same error.


I got around it by doing a bunch of crap, but here is an easier way.

Copy this

Code: [Select]

<?xml version="1.0" encoding="UTF-8"?>
<memory>
<address name="menu_state" value="0x0132FDB0"/>
<address name="focused_creature" value="0x00D23C4C"/>
<address name="creature_vector" value="0x0151F93C"/>
<address name="mouse_x" value="0x009E3284"/>
<address name="mouse_y" value="0x009E3288"/>
<address name="mouse_z" value="0x009E328C"/>
<address name="map_data" value="0x01561470"/>
<address name="map_x_count" value="0x01561488"/>
<address name="map_y_count" value="0x0156148C"/>
<address name="map_z_count" value="0x01561490"/>
<address name="starting_dwarf_count" value="0x0083F244"/>
<address name="starting_point_count" value="0x0083E333"/>
<offset name="map_data_map_x_offset" value="0x0058"/>
<offset name="map_data_map_y_offset" value="0x005A"/>
<offset name="map_data_type_offset" value="0x0062"/>
<offset name="map_data_designation_offset" value="0x0264"/>
<offset name="map_data_occupancy_offset" value="0x0664"/>
<offset name="map_data_0a60_offset" value="0x0A64"/>
<offset name="map_data_pathfinding_offset" value="0x0B64"/>
<offset name="map_data_1160_offset" value="0x1164"/>
<offset name="map_data_1360_offset" value="0x1364"/>
<offset name="map_data_temperature1_offset" value="0x1564"/>
<offset name="map_data_temperature2_offset" value="0x1764"/>
<offset name="map_data_1960_offset" value="0x1964"/>
<offset name="map_data_1b60_offset" value="0x1B64"/>
<offset name="creature_name_offset" value="0x0000"/>
<offset name="creature_body_part_health_vector_offset" value="0x02FC"/>
<offset name="creature_x_offset" value="0x0094"/>
<offset name="creature_y_offset" value="0x0096"/>
<offset name="creature_z_offset" value="0x0098"/>
</memory>into your "tweak/versions/39e/core.xml"

Make a backup though, in case it doesn't work for you.

[Sprout]

It doesn't seem to be effecting anything one way or another, unfourtunatly.


EDIT: On closer inspection, it appears that I already had that exact text in my core.xml file. Hmm...

[Slappy Moose]

I may have done other things, but I forget. Sorry I couldn't help.

[Exponent]

Well drat.  Looks like I'll probably have to improve my error catching (and more importantly, error reporting) code.  If all the correct addresses/offsets are in one of the xml files, and if the game is indeed 39e, and you've loaded a map and aren't just sitting at the main menu in DF, then it's not clear what might be happening, or how you might go about troubleshooting the problem.

[Sprout]

I guess my plan to create an artificial cave river complete with forest won't work for a bit... but at least I tried.

[Slappy Moose]

Sprout, I zipped my tweak folder, so if the problem was something with your tweak and not your game, then using my version should work.

http://www.mediafire.com/?sharekey=59e31971f46c4c82d2db6fb9a8902bda

If this works, in return for my help, you need to tell me how to get trees to grow underground, if you figure it out. 

[Exponent]

Okay, I improved error reporting at least marginally in some cases, and significantly in others.  Version 0.2 is now available from DFFD:  http://dffd.wimbli.com/file.php?id=404.  It may not solve any problem, but it might shed at least a little more light than previously on any errors people are getting.