Editing Filth

 <!-- Game data for this page can be found in \ThingDefs_Misc\Filth_Various.xml -->
'''Filth''' is a broad term for any of several types of tile effects, all of which possess unique in-game appearances. Most types of filth have negative '''[[beauty]]''' and '''[[cleanliness]]''' stats. Filth does not hinder movement, manipulation, or field of view, and cannot be picked up. Filth is often spontaneous and unpreventable, with potentially disastrous consequences. 

Many colonist tasks are directly impacted by the nearby presence of filth. The cleanliness room stat affects [[food poisoning]], [[room]] quality, [[research speed]], [[medical tend quality]], and [[surgery]] success chance. 

Filth is also a major factor on your colonists' [[mood]]. Pawns who have been in a filthy, ugly environment too long will gain a negative thought. Filth can quickly destroy the quality rating of an otherwise fine room, too, depriving your colonists of potential positive thoughts.

== Generation ==

Filth is most frequently a problem on '''hard floors''' like [[concrete]], [[wood floor]], or [[rough stone]]. These hard floor-types accumulate dirt from pawns much faster than natural terrain, like soil or sand. Several types of filth may stack on the same tile at the same time, with cumulative beauty effects. 

Some types of filth like '''"foot-traffic"''' dirt and colonists' '''trash''' are passively emitted periodically. An animal's [[filth rate]] determines how often it spontaneously produces '''animal filth''' on hard floors. In general, large animals produce a lot of animal filth and should thus be kept off of hard floors using [[zones]]. Smaller animals like the [[husky]] or [[cat]] have filth rates equal to or lower than humans.
[[Straw matting]] can be used to absorb some animal filth, but it is highly flammable.

When a pawn is moving from terrain to floors, there is a chance for a pawn to track filth along their path for some number of tiles.{{Check Tag|Detail needed|What filth, what chance, how many tiles. Also add detail to Floors page}}

== Interactions ==
{{stub|section=1|reason=Account for floor clean time multi}}
Filth is removed from a tile by colonists assigned to [[Work#Clean|Cleaning]] or by rain if [[Roof|unroofed]]. Only filth in the [[Home area]] will be cleaned; tiles outside the home area will be ignored.

Limiting the home area of your colony will substantially reduce cleaning demands on your colonists. By default, a home area is automatically designated around new player structures and zones (this setting may be toggled in the lower right corner icon bar). However, home area designation is '''''not''''' automatically removed from an area, even if player structures are removed.

All colonists clean tiles at the same rate regardless of [[trait]]s or [[capacities]], but some types of floors, like [[Steel tile]]s and [[sterile tile]]s, are faster to clean than others. Some types of filth, like pawn trash, are faster to clean than others, like '''bugblood'''.

Outdoors: Soil does not collect dirt from foot traffic  (it only adds dirt to the shoe soles of pawns), and therefore may be more beautiful to use outdoors than constructed streets.
However, in comparison to streets/paths in the base state soil tiles are only of neutral beauty and have a walk speed penalty.

Indoors: Soil does collect dirt from foot traffic and spreads it to pawns’ shoes, has -1 cleanliness and -3 beauty per tile indoors.

== Summary table ==
{{Stub|section=1|reason=Sources of [[Ideology DLC]] filths. Add [[Biotech DLC]] filths}}
Certain unsightly objects, i.e. vomit, have one value when under a roof and a lower value when unroofed. This simulates the general disgust of seeing eyesores indoors versus encountering them outside. Some messes can be spread by pawns tracking through them and others can be washed away by rain.

The effect of filth on outdoors beauty is 30% of the effect indoors.
<!--Default values-->{{#vardefine:beautyI|-15}}{{#vardefine:beautyO|{{#expr:{{#var:beautyI}}*0.3 round 0}}}}{{#vardefine:cleanliness|-5}}
{| {{STDT| sortable c_25 text-center}}
! Name !! Source !! Beauty indoors (outdoors) !! Cleanliness !! Ignores filth multiplier !! Trackable !! Washes away !! <abbr title="Ticks required to clean 1 layer of the filth">Work to clean</abbr> !! <abbr title="Will automatically disappear after this many days">Days to disappear</abbr> !! Notes
|- id = "Amniotic fluid"
! style="text-align:left;" | Amniotic fluid 
| Fluid produced when an animal or a [[Reproduction|pregnant colonist]]{{BiotechIcon}} gives birth
| -30 ({{#expr:-30*0.3 round 0}})     ||  -5                  || {{Check}} || {{Check}} || {{Check}} ||  70 || 35 - 40 ||
|- id = "Ash"
! style="text-align:left;" | Ash
| Produced after flammables catch fire
| -12 ({{#expr:-12*0.3 round 0}})     || -15                  || {{Check}} || {{Check}} || {{Cross}} ||  70 || 10 - 15 ||
|- id = "Animal filth"
! style="text-align:left;" | Animal filth
| Produced by animals when walking on constructed floors
| {{#var:beautyI}} ({{#var:beautyO}}) || {{#var:cleanliness}} || {{Cross}} || {{Check}} || {{Check}} ||  35 || 45 - 50 ||
|- id = "Blood"
! style="text-align:left;" | Blood
| From a bleeding human or animal
| -30 ({{#expr:-30*0.3 round 0}})     || -10                  || {{Check}} || {{Check}} || {{Check}} ||  70 || 35 - 40 ||
|- id = "Bugblood"
! style="text-align:left;" | Bugblood
| From a bleeding insectoid
| -40 ({{#expr:-40*0.3 round 0}})     || -15                  || {{Check}} || {{Check}} || {{Check}} ||  80 || 35 - 40 ||
|- id = "Building rubble"
! style="text-align:left;" | Building rubble
| Debris created by collapsed structures or during [[mental break]]
| {{#var:beautyI}} ({{#var:beautyO}}) || {{#var:cleanliness}} || {{Cross}} || {{Cross}} || {{Cross}} ||  35 || 45 - 50 ||
|- id = "Chemfuel puddle"
! style="text-align:left;" | Chemfuel puddle
| Flammable puddles created by incendiary weapons.
| -10 ({{#expr:-10*0.3 round 0}})     || -15                  || {{Check}} || {{Check}} || {{Check}} ||  70 || 35 - 40 || style="text-align:left;" | Can be lit on fire. 150 {{HP}} and 200% flammability. Max thickness 1.
|- id = "Corpse bile"
! style="text-align:left;" | Corpse bile
| From a rotting corpse
| -50 ({{#expr:-50*0.3 round 0}})     || -20                  || {{Check}} || {{Check}} || {{Check}} ||  80 || 35 - 40 ||
|- id = "Dirt"
! style="text-align:left;" | Dirt
| Produced by humans when walking on constructed floors or rough stone after dirt
| {{#var:beautyI}} ({{#var:beautyO}}) || {{#var:cleanliness}} || {{Cross}} || {{Check}} || {{Check}} ||  35 || 45 - 50 ||
|- id = "Firefoam"
! style="text-align:left;" | [[Firefoam]]
| Fireproof foam from a firefoam popper
| -25 ({{#expr:-25*0.3 round 0}})     ||  -5                  || {{Check}} || {{Check}} || {{Check}} || 100 ||  5 - 10 || style="text-align:left;" | Prevents fire from igniting.
|- id = "Hair"
! style="text-align:left;" | Hair
| Produced by changing hair at a [[Styling station]]{{IdeologyIcon}}
| -10 ({{#expr:-10*0.3 round 0}})     ||  -5                  || {{Check}} || {{Cross}} || {{Cross}} ||  35 || 30 - 40 ||
|- id = "Machine bits"
! style="text-align:left;" | Machine bits
| Produced from completing the "Shred Mechanoid" bill
| -10 ({{#expr:-10*0.3 round 0}})     ||  -5                  || {{Check}} || {{Cross}} || {{Cross}} ||  35 || 45 - 50 ||
|- id = "Rock rubble"
! style="text-align:left;" | Rock rubble
| Debris created by digging into mineral rocks
| {{#var:beautyI}} ({{#var:beautyO}}) || {{#var:cleanliness}} || {{Cross}} || {{Cross}} || {{Cross}} ||  35 || 45 - 50 ||
|- id = "Sand"
! style="text-align:left;" | Sand
| Produced by pawns when walking on constructed floors or rough stone after sand
| {{#var:beautyI}} ({{#var:beautyO}}) || {{#var:cleanliness}} || {{Cross}} || {{Check}} || {{Cross}} ||  35 || 45 - 50 ||
|- id = "Scattered sandbags"
! style="text-align:left;" | Scattered sandbags
| Remnants from damaged or destroyed sandbags
| {{#var:beautyI}} ({{#var:beautyO}}) || {{#var:cleanliness}} || {{Cross}} || {{Cross}} || {{Cross}} ||  35 || 45 - 50 ||
|- id = "Scattered slag"
! style="text-align:left;" | Scattered slag
| Spawned by crashed ships
| {{#var:beautyI}} ({{#var:beautyO}}) || {{#var:cleanliness}} || {{Cross}} || {{Cross}} || {{Cross}} ||  35 || 45 - 50 ||
|- id = "Slime"
! style="text-align:left;" | Slime
| Found after opening a cryptosleep casket or during infestations
| -25 ({{#expr:-25*0.3 round 0}})     || -5                   || {{Cross}} || {{Check}} || {{Check}} ||  70 || 35 - 40 ||
|- id = "Trash"
! style="text-align:left;" | Trash
| Produced by humans when walking on constructed floors
| {{#var:beautyI}} ({{#var:beautyO}}) || {{#var:cleanliness}} || {{Cross}} || {{Check}} || {{Cross}} ||  35 || 45 - 50 ||
|- id = "Vomit"
! style="text-align:left;" | Vomit
| Created from a [[vomiting]] human or animal
| -40 ({{#expr:-40*0.3 round 0}})     || -15                  || {{Check}} || {{Check}} || {{Check}} ||  70 ||  35 - 40 ||
|- id = "Water puddle"
! style="text-align:left;" | Water puddle
| Produced by [[psycast#Waterskip|Waterskip]] psycast{{RoyaltyIcon}}
| -10 ({{#expr:-10*0.3 round 0}})     ||  -5                  || {{Cross}} || {{Check}} || {{Cross}} ||  30 || 0.2 - 0.4 || style="text-align:left;" | Prevents fire from igniting.

|- id = "Dried blood"
! style="text-align:left;" | Dried blood {{IdeologyIcon}}
| Placed during map generation (rarely)
| -10 ({{#expr:-10*0.3 round 0}})     ||  -5                  || {{Cross}} || {{Cross}} || {{Check}} ||  90 || 35 - 40 ||
|- id = "Oil smear"
! style="text-align:left;" | Oil smear {{IdeologyIcon}}
| ?
| -10 ({{#expr:-10*0.3 round 0}})     || -15                  || {{Cross}} || {{Check}} || {{Check}} ||  70 || 35 - 40 || style="text-align:left;" | Can be lit on fire. 250 {{HP}} and 150% flammability. Max thickness 1.
|- id = "Pod slime"
! style="text-align:left;" | Pod slime {{IdeologyIcon}}
| Produced from a completed or rejected cycle in a [[Biosculpter pod]] {{IdeologyIcon}}.
| -30 ({{#expr:-30*0.3 round 0}})     ||  -5                  || {{Cross}} || {{Check}} || {{Check}} ||  70 || 35 - 40 ||
|- id = "Ragged uniform"
! style="text-align:left;" | Ragged uniform {{IdeologyIcon}}
| Rarely spawned in ancient complexes
| {{#var:beautyI}} ({{#var:beautyO}}) || {{#var:cleanliness}} || {{Check}} || {{Check}} || {{Cross}} ||  25 || 35 - 40 ||
|- id = "Scattered documents"
! style="text-align:left;" | Scattered documents {{IdeologyIcon}}
| Rarely spawned in ancient complexes
| {{#var:beautyI}} ({{#var:beautyO}}) || {{#var:cleanliness}} || {{Cross}} || {{Cross}} || {{Check}} ||  25 || 35 - 40 ||

|- id = "Flammable bile"
! style="text-align:left;" | Flammable bile {{BiotechIcon}}
| Flammable puddles created by the [[Genes#Ability|Fire spew]]{{BiotechIcon}} ability
| ? (-4) || ? || ? || {{Check}} || {{Check}} || ? || ? || style="text-align:left;" | Can be lit on fire; has properties similar to chemfuel puddles.
|- id = "Floor drawing"
! style="text-align:left;" | Floor drawing {{BiotechIcon}}
| Drawn by a [[Children_and_reproduction|child]]{{BiotechIcon}} colonist
| 0 (0) || 0 || ? || {{Check}} || {{Check}} || ? || ? ||
|- id = "Spent acid"
! style="text-align:left;" | Spent acid {{BiotechIcon}}
| ? || ? || ? || ? || ? || ? || ? || ? ||
|- id = "Metalhorror debris"
! style="text-align:left;" | Metalhorror debris {{AnomalyIcon}}
| From a destroyed [[Metalhorror]]{{AnomalyIcon}} || -9 || ? || ? || ? || ? || ? || ? ||
|- id = "Dark blood"
! style="text-align:left;" | Dark blood {{AnomalyIcon}}
| From any non-[[fleshbeast]] [[entity]]{{AnomalyIcon}} that can bleed || -9 || ? || ? || ? || ? || ? || ? ||
|- id = "Twisted flesh"
! style="text-align:left;" | Twisted flesh {{AnomalyIcon}}
| From a fleshbeast splitting or being destroyed, also spawns naturally in a [[pit gate]]{{AnomalyIcon}} || -15 || ? || ? || ? || ? || ? || ? ||
|- id = "Fleshmass debris"
! style="text-align:left;" | Fleshmass debris {{AnomalyIcon}}
| From a destroyed chunk of fleshmass{{AnomalyIcon}} || -15 || ? || ? || ? || ? || ? || ? ||
|- id = "Gray flesh"
! style="text-align:left;" | Gray flesh {{AnomalyIcon}}
| Appears on the tile that a gray flesh sample{{AnomalyIcon}} drops on || -8 || ? || ? || ? || ? || ? || ? ||
|}

== Gallery ==
<gallery>
File:BloodA.png|Blood variant A
File:BloodB.png|Blood variant B
File:BloodC.png|Blood variant C
</gallery>
<gallery>
File:RubbleA.png|Rubble
File:SandbagsA.png|Scattered sandbags
File:SlagBitsA.png|Scattered slag
</gallery>

== Version history ==
* [[Version/1.1.0|1.1.0]] - Ashes from burned plants and buildings now survive rain and disappear after 10-15 days. They’re also visually larger.
* [[Version/1.2.2753|1.2.2753]] - Dirt now washes away in rain.
* [[Ideology DLC]] Release - Added pod slime.
* [[Version/1.3.3066|1.3.3066]] - Rain washes away more filth types. Added an alert which tells the player high filth-producing animals are indoors without straw matting floor type. Indoor rooms with non-water flooring can have animal filth or trash spread on them.
* [[Biotech DLC]] Release - Added floor drawing, spent acid, and flammable bile.
* [[Anomaly DLC]] Release - Added metalhorror debris, dark blood, twisted flesh, gray flesh and fleshmass debris.

[[Category:Environment]]