v0.34:Minecart

xTATTEREDx  · +FINE+  · *SUPERIOR*  · ≡EXCEPTIONAL≡  · ☼MASTERWORK☼

v50.12 · v0.47 · v0.34.11 · v0.31 · v0.28 · v0.23 This article is about an older version of DF. More Info · V

A minecart is a tool used mostly for hauling. It is made of wood or metal at a carpenter's workshop or a metalsmith's forge, respectively. Minecarts store up to five times as many items as wheelbarrows and are quite faster than hauling dwarves, but have the disadvantage of requiring dedicated track network and a complex route setup. Minecart tracks also take up a lot of space, may be complicated to construct and can be very expensive to build, resource-wise.

Just like wheelbarrows, minecarts are considered items and are stored in a furniture stockpile. Despite their five times greater capacity, they are only one third larger than wheelbarrows and are identical in base value when made from the same material (the value may differ due to the item quality). As items, thieves or even mischievous animals can steal minecarts, even when moving on a track. If a minecart is moving fast enough, or if it has a rider, thieves will be unable to steal the minecarts.

Although most of the utility of minecarts is in fortress mode, an adventurer can also ride in a minecart. Adventurers can also pick up and relocate minecarts.

Since their introduction in version 0.34.08, a new hauling labor preference was added to all dwarves, called "Push/Haul Vehicles", turned on by default.

The invention of minecarts revolutionized the Science of Dwarfputing.

Track

Tracks can be built in two ways:

• A single-tile wide strip of natural stone can be designated to be carved (with d T), which will create a straight two-way track. The creation of corners, crossings and T-junctions is as simple as designating another strip of track that overlaps an existant or newly-designated track. Engraved tracks are removed by smoothing the rock they're on, which results in a smooth floor which can be re-engraved if necessary, or by building a floor on top and subsequently removing it.
  • The carving of natural ramps is a little more confusing: to carve a two-way track on a (natural) ramp, you must designate the ramp and one square beyond in the direction you want the track to go. Take into account that minecart ramps must have a solid block on the side opposite to the track, or it will be unusable (despite not being marked so in-game).

• Tracks can also be built as regular constructions (through b C T). This method is resource-expensive, since each track tile requires one stone, bar or block for construction, and time-consuming, since you can't designate strips larger than 10 tiles at a time, and corners, crossings, T-junctions and ramps have to be designated individually. However, it is the only way to build tracks above ground (barring the creation of obsidian), and the only way to create one-way tracks. Constructed tracks are designated for removal like any regular construction; be aware that removing track ramps built on top of natural ones will also remove the original ramp, leaving a flat floor.

Every track, when complete, will designate the tile with a low-priority traffic order. This reduces the odds of dwarves walking into a high-speed minecart; however, it should be noted that pets and livestock ignore traffic orders. Note that removing the track doesn't reset that tile back to normal traffic priority, so you may wish to manually clean up traffic designation afterward. Also note that bridges that are used as tracks don't have their traffic priority changed automatically (since they're just normal bridges), which could cause dwarves to pathfind normally through dangerous minecart entrances in your fort's walls if you're not careful.

As constructions or tile features, doors and other furniture can be built on tracks. A door or floodgate can be turned on or off by a lever, effectively controlling the flow of automated minecarts. This may be dangerous, however.

Bridges can also act as tracks, but only if they're lowered or not retracted. This property can enable levers to turn tracks on and off. However, care should be taken to ensure that such bridges are never operated while a cart is on top of them, as the cart will be flung off the track. It's worth noting that it's often faster, and cheaper, to construct large bridges than long striates of constructed track. It's also worth noting that bridges do not automatically have a low pathfinding traffic priority assigned to them, however.

Hauling route

The proper setting up of routes is essential for a working rail system. Routes, stops, departure conditions and stockpile links are managed from the hauling menu.

Route

New routes are created with the route key. Existing ones can be removed (without confirmation) with the x key, and also nicknamed. Before operating, the route must have at least one vehicle assigned to it (this can be done with either the route or a stop selected).

Stop

Stops are designated by moving the cursor on top of the desired tile and pressing the s key afterwards. They can be removed with and nicknamed with the same hotkeys as routes. Stops can also be reordered with the promote key. Without a definition, however, a stop is fairly useless: pressing the Enter key with a stop selected in the route menu opens its stop definition screen, from which departure conditions and stockpile links can be set up.

Stockpile links

By placing the cursor on top of a stockpile and using s, you can create stockpile links for a track stop. Links can also be redefined by selecting them, placing the cursor over a different stockpile, and pressing p.

Departure condition

Departure conditions involve setting conditions in which the minecart will leave on the route. Each condition includes:

1. A departure mode (Guide, Ride or Push).
2. A departure direction (NSEW).
3. A timer, before which the departure condition cannot be met.
4. Conditions on the amount of items in the cart.

Departure conditions are created with the n key. A new departure condition will read: "guide north immediately when empty of desired items". This condition can be changed between basic presets with c. "Advanced" mode (C) allows for more precise control over departure conditions: fine tuning the percentage from 0 to 100 in 25% steps (f and F), switching it being either the maximum or the minimum amount of items for the condition to be met (m), and whether the cart accepts all or only a specific set of items (l). Common to both screens are the departure mode (p, Push, Ride or Guide), direction, and timer (t and T) options.

To have a cart only carry a specific set of items, the stop can be set to only carry "desired" items, opening the selection screen with the Enter key while having said stop condition selected, and toggling as desired, or it can simply be linked to a restricted stockpile and set to depart with any items.

Physics

Minecart physics depend greatly on the departure mode set in the route stop conditions.

When set to "Push" or "Ride", minecarts will move according to the regular laws of momentum, gaining speed when going downhill, losing it due to friction when on a flat plane, and more quickly when going uphill. In these modes, minecarts will move along the track in a straight line until they either run off the tracks or encounter a turn. Behavior at T-intersections has not yet been conclusively determined^[Verify]. The cart's behavior also depends on the weight of its contents (including fluids and dwarves): heavily loaded carts are harder to accelerate and to stop, and gain more momentum when going downhill. In either case, dwarves can not push nor ride an unpowered cart up a ramp, bouncing back the direction it came. At best, this is a waste of time; at worst, it will give your cart-pushing dwarf a fun surprise. To solve this, the player can either use Rollers (see below) or set the cart to be Guided.

When set to "Guide", minecarts seem to ignore all laws of physics. They:

• Ignore the weight of any and all items inside. Therefore:
  • Move at the speed of the dwarf that is guiding them. It is thus recommended to pick the most agile of your dwarves for cart-guiding tasks.
• Ignore working rollers.
• Will not collide with other guided carts even when a full frontal collision would be expected.
• Will go up ramps like nobody's business.

This is therefore the recommended method of transport for simple non-powered rail systems, despite it diverting a dwarf from other, potentially more important tasks.

Some samples with behavior:

 A <-> B     A <-> C               A <-> B      
   B╥          B╥                     B╥
    ║           ║                      ║ 
A╞══╝       A╞══╩══╡C              A╞══╬╗
            You can only go A->B       ╚╝
  Works      when the cart           Works
             is in Guide mode.       

In the second example above, if you attempt to "Push" from B to A or C, the cart will go careening off of the tracks.

Skipping

If a minecart is moving fast enough, it can skip over water or magma, making splashes of mist (or magma mist) as it attempts to move on them horizontally. This horizontal movement is independent of the minecart and its content's weight.

Falling

When falling, a minecart appears to cause no damage upon collision with a creature, possibly to allow cart "stacking" across Z-levels. ^[Verify]

Stacking

If a minecart lands on another minecart in exactly the perfect orientation and time, they may form a stack (effectively a pillar) of minecarts. This pillar, aside from the megaprojects uses possible, is also useful for trap design with minecarts as the weaponry.

The location of the upper minecarts, above what seems to be thin air, can be confusing. These minecarts generally need to be struck with another minecart to move out, or have their support removed. The latter option can be somewhat dangerous, however.

Danger

Minecarts are not without danger. Although designating a track automatically sets the traffic designation to low, dwarves may still walk on them, and creatures ignore traffic designations altogether. If an unlucky dwarf or creature fails to dodge a minecart, they can be injured. Most of this danger can be avoided by setting the minecart hauling commands to guide instead of push or ride, as dwarves guiding minecarts will ignore traffic restrictions, by pasturing domestic animals, and preventing the access of other creatures to the tracks.

Danger does not always involve living victims: careless route designation can also result in minecarts careening off tracks or colliding with each other. If this occurs, the items may be scattered; this can cause even more hauling jobs than the minecart aimed to eliminate. Even better worse, scattered items, especially weapons, can injure passing dwarves or other creatures; in the words of Toady One the Great, "Accidental grapeshotting of the dining room should be possible now."

Of course, the danger of using minecarts means they can also be used as weapons by imaginative players.

Automation

Track stop

Track stops are constructions that allow further automation of minecart systems via adjustable features such as breaking by friction and automatic dumping of contents. They can be built from logs, bars and blocks through b C S, and must be built on top of an existing piece of track; friction amount, dumping toggle and dumping direction must be set before construction, and these settings can be neither changed nor seen thereafter; however, track stops can be linked to pressure plates or levers to toggle friction upon activation. Take care not to set track stops at a loading site to dump their contents, or dwarves will never be able to fill the cart.

Track stops are not mandatory; in fact, their main use is in automated rail systems, to stop and hold extremely fast-moving minecarts or to dump contents mid-way without stopping. However, even in basic rail systems it can be useful to set a track stop to dump items: this saves time that dwarves would otherwise spend in removing items from the cart, time that is better spent driving the cart back to where it's needed.

Counter-intuitive to their construction method, track stops are considered buildings and must be removed by q x.

Roller

A roller is a powered machine component for the automated propulsion of minecarts. They are built with b M r, requiring a mechanic, one or more mechanisms and a rope. Rollers are very useful to maintain a cart's momentum along long routes, to get them to climb Z-levels without dwarfpower involved, and to get them to reach speeds unattainable by guiding dwarves. These devices are variable-length, variable-direction, and variable-power, all traits that can be set at construction time; at the highest speed, a roller uses two units of power per tile it is long.

Rollers may apparently be placed directly on ramps to help pull carts up Z levels^[Verify]. Currently rollers can only be placed on ramps if it would result in it being connected to a preexisting power connection (gears, axles, or pumps).

Care must be taken in glaciers and other extremely cold biomes, since rollers can be rendered inoperable when exposed to freezing temperatures.

Because of their one-way nature, rollers are unsuitable for most two-way minecart tracks. However, a minecart set to be guided is not affected by rollers at all — this allows a one-way track to be used in both directions.

Rollers cannot be powered from above.

Switching

A rudimentary track switch can be constructed by building a T-junction as illustrated below.

     B╥
      ║
      RO
      RO
A╞════R════╡C

The 'O's represent walls that keep the cart on the track during the switching process The 'R's are a single 3 tile roller pushing from South to North on slow speed (slowest is too slow to get the minecart to change directions, and I have not yet experimented with higher speeds). If the cart is pushed East from the stop at 'A' while the roller is activated, it will arrive at 'B'. If the roller is not running, it will arrive at 'C'.

Troubleshooting

Because of the complexity of the system, all but the most careful and experienced minecart users will encounter issues. Most route issues can be diagnosed and fixed from the hauling menu.

Symptom: ! Set dir/connect track message appears to the right of one or more stops
Possible Causes:

• The departure direction of the stop might be invalid. Edit the stop using Enter and pressd until it is pointing in a valid direction.
• The track stop might not be built on top of a track. The track stop must be deconstructed to remedy this issue.
• Your track might not be built correctly. Make sure all connected tracks between destinations are not one-way tracks.
  • This can be especially confusing with ramps. To carve a two-way track on a (natural) ramp, you must designate the ramp and one square beyond in the direction you want the track to go.
  • Ramps must have a solid block on the side opposite to the track, or they will neither work nor be marked as "unusable". The solid block can be natural or constructed.
• The desired/kept items might not be configured correctly.

Symptom: The status 0% V always appears to the right of one stop.
Possible Causes:

• The stop may not be set to take from a stockpile. Edit the Stop using Enter and make sure you see a message like "Take from Stockpile #1".
• The take conditions must correspond with the contents of the stockpile.
• The track stop may be set to dump. A track stop set to dump cannot be filled. You must either set the stop to a time-based departure or deconstruct the track stop and rebuild it without dumping.
• Make sure the minecart itself has not been designated to be dumped (such as when using mass-dump).

Capacity

Minecarts have five times the capacity of wheelbarrows, which is an enormous amount. A single minecart can carry 2500 rolls of cloth, for example, or even a hundred stone blocks. Unfortunately, loading 2500 boulders onto a minecart is not possible.

Water and magma can also be loaded into minecarts by submerging them to a depth of at least 6/7, and dumped by a constructed track stop. Loading fluids onto minecarts can be difficult because their weight can slow the minecart down greatly. Curiously, filling a minecart with magma does not injure a dwarf riding it.

The capacity in a minecart affects whether a pressure plate triggers or not, based on the pressure plate's setting.

Bugs

• If you set up lots of routes and stops and then resize your screen, the list will scroll off-screen in the hauling menu. You can still navigate the list with keyboard commands, but cannot see the stop/route name. This will be fixed in the next release.
• A dwarf will drop its baby, if it has one, when boarding a minecart set to be ridden.
• Tracks block wagon access to trade depots. Bug 0006040