update docs for changelayer
myk002
parent
ddd2e5003a
commit
fae5f0635a
@ -1,60 +1,72 @@
|
||||
changelayer
|
||||
===========
|
||||
Changes material of the geology layer under cursor to the specified inorganic
|
||||
RAW material. Can have impact on all surrounding regions, not only your embark!
|
||||
By default changing stone to soil and vice versa is not allowed. By default
|
||||
changes only the layer at the cursor position. Note that one layer can stretch
|
||||
across lots of z levels. By default changes only the geology which is linked
|
||||
to the biome under the cursor. That geology might be linked to other biomes
|
||||
as well, though. Mineral veins and gem clusters will stay on the map. Use
|
||||
`changevein` for them.
|
||||
|
||||
tl;dr: You will end up with changing quite big areas in one go, especially if
|
||||
you use it in lower z levels. Use with care.
|
||||
|
||||
Options:
|
||||
|
||||
:all_biomes: Change selected layer for all biomes on your map.
|
||||
Result may be undesirable since the same layer can AND WILL
|
||||
be on different z-levels for different biomes. Use the tool
|
||||
'probe' to get an idea how layers and biomes are distributed
|
||||
on your map.
|
||||
:all_layers: Change all layers on your map (only for the selected biome
|
||||
unless 'all_biomes' is added).
|
||||
Candy mountain, anyone? Will make your map quite boring,
|
||||
but tidy.
|
||||
:force: Allow changing stone to soil and vice versa. !!THIS CAN HAVE
|
||||
WEIRD EFFECTS, USE WITH CARE!!
|
||||
Note that soil will not be magically replaced with stone.
|
||||
You will, however, get a stone floor after digging so it
|
||||
will allow the floor to be engraved.
|
||||
Note that stone will not be magically replaced with soil.
|
||||
You will, however, get a soil floor after digging so it
|
||||
could be helpful for creating farm plots on maps with no
|
||||
soil.
|
||||
:verbose: Give some details about what is being changed.
|
||||
:trouble: Give some advice about known problems.
|
||||
|
||||
Examples:
|
||||
|
||||
Tags:
|
||||
:dfhack-keybind:
|
||||
|
||||
Change the material of an entire geology layer. Note that one layer can stretch
|
||||
across many z-levels, and changes to the geology layer will affect all
|
||||
surrounding regions, not just your embark! Mineral veins and gem clusters will
|
||||
not be affected. Use `changevein` if you want to modify those.
|
||||
|
||||
tl;dr: You will end up with changing large areas in one go, especially if you
|
||||
use it in lower z levels. Use this command with care!
|
||||
|
||||
Usage::
|
||||
|
||||
changelayer <material RAW id> [<options>]
|
||||
|
||||
When run without options, ``changelayer`` will:
|
||||
|
||||
- only affect the geology layer at the current cursor position
|
||||
- only affect the biome that covers the current cursor position
|
||||
- not allow changing stone to soil and vice versa
|
||||
|
||||
You can use the `probe` command on various tiles around your map to find valid
|
||||
material RAW ids and to get an idea how layers and biomes are distributed.
|
||||
|
||||
Options
|
||||
-------
|
||||
|
||||
- ``all_biomes``
|
||||
Change the corresponding geology layer for all biomes on your map. Be aware
|
||||
that the same geology layer can AND WILL be on different z-levels for
|
||||
different biomes.
|
||||
- ``all_layers``
|
||||
Change all geology layers on your map (only for the selected biome unless
|
||||
``all_biomes`` is also specified). Candy mountain, anyone? Will make your map
|
||||
quite boring, but tidy.
|
||||
- ``force``
|
||||
Allow changing stone to soil and vice versa. **THIS CAN HAVE WEIRD EFFECTS,
|
||||
USE WITH CARE AND SAVE FIRST**. Note that soil will not be magically replaced
|
||||
with stone. You will, however, get a stone floor after digging, so it will
|
||||
allow the floor to be engraved. Similarly, stone will not be magically
|
||||
replaced with soil, but you will get a soil floor after digging, so it could
|
||||
be helpful for creating farm plots on maps with no soil.
|
||||
- ``verbose``
|
||||
Output details about what is being changed.
|
||||
|
||||
Examples
|
||||
--------
|
||||
|
||||
``changelayer GRANITE``
|
||||
Convert layer at cursor position into granite.
|
||||
Convert the layer at the cursor position into granite.
|
||||
``changelayer SILTY_CLAY force``
|
||||
Convert layer at cursor position into clay even if it's stone.
|
||||
Convert teh layer at the cursor position into clay, even if it's stone.
|
||||
``changelayer MARBLE all_biomes all_layers``
|
||||
Convert all layers of all biomes which are not soil into marble.
|
||||
|
||||
.. note::
|
||||
|
||||
* If you use changelayer and nothing happens, try to pause/unpause the game
|
||||
for a while and try to move the cursor to another tile. Then try again.
|
||||
If that doesn't help try temporarily changing some other layer, undo your
|
||||
changes and try again for the layer you want to change. Saving
|
||||
and reloading your map might also help.
|
||||
for a while and move the cursor to another tile. Then try again. If that
|
||||
doesn't help, then try to temporarily change some other layer, undo your
|
||||
changes, and try again for the layer you want to change. Saving and
|
||||
reloading your map also sometimes helps.
|
||||
* You should be fine if you only change single layers without the use
|
||||
of 'force'. Still it's advisable to save your game before messing with
|
||||
of 'force'. Still, it's advisable to save your game before messing with
|
||||
the map.
|
||||
* When you force changelayer to convert soil to stone you might experience
|
||||
weird stuff (flashing tiles, tiles changed all over place etc).
|
||||
Try reverting the changes manually or even better use an older savegame.
|
||||
You did save your game, right?
|
||||
* When you force changelayer to convert soil to stone, you might see some
|
||||
weird stuff (flashing tiles, tiles changed all over place etc). Try
|
||||
reverting the changes manually or even better use an older savegame. You
|
||||
did save your game, right?
|
||||
|
||||
Loading…
Reference in New Issue