Editing Environment

<!--Top Nav Box-->
{| align=center
| {{Gameplay_Nav}}
|}
----
<!-- End of Nav -->

{{TOCright}}

The map '''environment''' are all aspects of the map that often can not be directly influenced by the player, such as terrain, weather conditions and lighting.

== Beauty ==
{{Main|Beauty}}
Terrain, flooring, objects, and plants attribute to a tile's beauty, which in turn can affect a colonist's mood.
The contents of a tile have a cumulative effect on its beauty; i.e. a granite chunk (beauty of -10) on a carpeted floor (beauty of +2) gives the tile a net beauty of -8.
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.

== Space ==
Environment space (as opposed to the [[Space|Need for Space]]) is the count of how much space there is to freely move around in a room. This is all the floor tiles that are either empty or have objects that can be passed through at full speed, such as chairs, building materials, and the various "spots". All objects that either slow down or prevent movement through are not counted towards Environment Space. The "Space" number shown in the Environment display is this count x 1.4. This number is a measure of the entire room, and does not change depending on where a pawn is standing.

== Flora ==
{{Main|Plants}}
Certain plants and trees have beauty, and may also provide [[cover]] to colonists.

== Light ==
{{For|the standard furniture item|standing lamp}}

Light can be generated artificially or naturally. Artificial light is produced by appliances in a limited range. Natural light is generated throughout the map on unroofed tiles. Roofed tiles will be dark unless lit artificially.

Occasionally an [[Events#Eclipse|eclipse]] befalls the planet. Natural daytime light is no longer generated until it ends.

Light's importance lies in the following effects:
* Plant growth - With the exception of [[Decorative Plants|decorative plants]], plants only grow when the light level is at least 51%.
* Power - Solar generators only produce power when naturally lit.
* Colonists want 30% light or better. This effects...
:* Colonists' mood - Colonists in sustained darkness will have the [[Thoughts list#In darkness|'In darkness']] thought. Sleeping colonists will not have this thought. Therefore, lighting is not needed in areas only used for sleeping.
:* Colonists' movement speed - Colonists in darkness will have a reduced movement speed, scaling to 80% at a light level of 0%. Due to this, combat at night or under unlit roofed areas can lead to a disadvantage against non-human opponents, such as insects, manhunter animals, or mechanoids.
:* Colonists' global work speed - Similarly to their movement speed, colonists will have a work speed penalty when working in darkness, scaling to 80% at a light level of 0%.
:* [[Decorative Plants|Decorative plants]] will grow in any light 30% or more.
* [[Surgery success chance factor]] is optimized at 50% light or better.

There are three light levels: ''Dark'' (0-29%), ''Lit'' (30-89%), and ''Brightly lit'' (90-100%). Each tile on the map has one of these light levels. The light level of a tile is listed in the tile's information area located above the Architect menu (when the menu is minimized). The light level is immediately followed by the brightness given in a percentage (%).

{| class="wikitable" style = "text-align:center; border-width=10;" width="260"
| colspan = 4 | '''Light levels according to Light (%)'''
|-
| style = "text-align:left;" | Light (%) 
| style="background-color:#B8C0B8" | 0-29 
| style="background-color:#FFFFF0" | 30-89 
| style="background-color:#FFFFD8" | 90-100
|-
| style = "text-align:left;" | Light level 
| style="background-color:#B8C0B8" | Dark 
| style="background-color:#FFFFF0" | Lit 
| style="background-color:#FFFFD8" | Brightly lit 
|}

=== Artificial light sources ===
Light in roofed areas is provided by the following appliances: 

{| class="wikitable sortable"
|-
! Name !! data-sort-type="number" | Radius Lit >=30%
|-
| [[Torch lamp]] || {{Q|Torch lamp|Light Radius}} tiles
|-
| [[Standing lamp]] || {{Q|Standing lamp|Light Radius}} tiles
|-
| [[Standing lamp (red)]]/[[Standing lamp (green)|(green)]]/[[Standing lamp (blue)|(blue)]] || {{Q|Standing lamp (blue)|Light Radius}} tiles
|-
| [[Sun lamp]] || {{Q|Sun lamp|Light Radius}} tiles
|-
| [[Campfire]] || {{Q|Campfire|Light Radius}} tiles
|-
| [[Brazier]] {{RoyaltyIcon}} || {{Q|Brazier|Light Radius}} tiles
|-
| [[Darklight brazier]] {{RoyaltyIcon}}{{IdeologyIcon}} || {{Q| Darklight brazier|Light Radius}} tiles
|-
| [[Darktorch]]{{IdeologyIcon}} || {{Q| Darktorch|Light Radius}} tiles
|-
| [[Fungus darktorch]]{{IdeologyIcon}} || {{Q| Fungus darktorch|Light Radius}} tiles
|-
| [[Standing darklamp]]{{IdeologyIcon}} || {{Q| Standing darklamp|Light Radius}} tiles
|}

Additionally, there are a variety of objects that incidentally generate light including, but not limited to, the [[electric crematorium]], [[electric smelter]], [[heater]], [[wood-fired generator]], and [[chemfuel powered generator]].

=== Daylight timing and latitude ===
The timing and strength of daylight is affected by latitude and time of year, due to the planet's apparent axial tilt.

This effect is more pronounced at extreme northern and southern latitudes, which can result in light levels not reaching 0% at night or 100% at daytime.

Near the central latitude, light level change throughout the day as follows:
{| class = "wikitable" width="180"
! Start time
! Light level
|- style="background-color:#FFFFF0"
| 4h || Lit
|- style="background-color:#FFFFD8"
| 7h || Brightly lit
|- style="background-color:#FFFFF0"
| 17h || Lit
|- style="background-color:#B8C0B8"
| 20h || Dark
|}

==== Daylight Math ====
Where <code>N</code> is the normal vector at the latitude and <code>P</code> is the sun position vector (both of magnitude <code>1.0</code>), the daylight percentage is based on the scalar product of the two, with a linear relationship between <code>0.0</code> and <code>0.7</code> (corresponding to 0% and 100% daylight) with <code>0.7</code> to <code>1.0</code> being clamped to 100% daylight.

[[File:Sun_position_rotation.png|thumb|right|Rotation towards latitude normal vector (latitude to degrees rotation)]]

The latitude normal vector <code>N</code> is always orthogonal to the Z-axis (note that the Y-axis passes through the planet's poles, not the Z-axis) with a positive X-value, meaning its possible values form a semicircle along the Y-axis. This means it can be represented as <code>{cos(''latitude''), sin(''latitude''), 0}</code>. For example, the latitude normal vector at the equator would be <code>{1, 0, 0}</code> while at 45° N it would be <code>{0.707, 0.707, 0}</code>

To calculate the sun position vector <code>P</code>, normalize the vector <code>{sin(''day_percent'' &times; 360°), -cos(''day_of_year''/60 &times; 360°) &times; latitude_fraction(''latitude''), cos(''day_percent'' &times; 360°)}</code> then rotate it an amount towards the latitude normal vector based on the graph on the right, but not passing it (if applicable). The function <code>latitude_fraction(''latitude'')</code> equals <code>0.2</code> below latitude <code>70</code>, <code>1.5</code> above latitude <code>75</code>, and is linearly interpolated between.

Interestingly, while some effects are applied differently above latitude <code>70</code> (70° N), these do not seem to apply below <code>-70</code> (70° S).

<!-- Based on <code>Assembly-CSharp/RimWorld/GenCelestial</code> -->

== Openness ==
{{stub|section=1|reason=Large enough enclosed spaces seem to blur these boundaries}} 
Openness refers to the often critical aspect of structures being open to the outside. It affects many things such as temperature, item deterioration, light, exposure to weather, and certain events.

Every tile on the map falls into one of three categories:
* Outdoors - not enclosed by any structure, even if there is a roof. 
* Indoors - completely enclosed structure, completely roofed.
* Unroofed - completely enclosed structure, but with one or more unroofed tiles.

== Temperature ==
{{Main|Temperature}}
Environmental temperature is affected outdoors mainly by the map's biome and by the current season. Temperature affects a plant's ability to grow. Temperature affects a human's comfort, and health in extreme temperatures.

== Terrain ==
Terrain consists of the map's walking surface, terrain features, and mountain areas. Terrain affects things including walking speed, where plants can grow, and may prohibit construction.

'''Natural surface terrain''' includes soil, rich soil, marshy soil, marsh, mud, sand, lichen-covered dirt, gravel, rough stone (granite, marble, etc.), rough-hewn stone, shallow water, and deep water.

'''Terrain features''' include steam geysers and mountains. The steam from a geyser produces heat and an enclosed area around it will heat up unless unroofed. A mountain cannot be destroyed, even if all of its stone and ore has been mined out. What remains are terrain tiles listed as 'overhead mountain'.

=== Naturally generated surfaces ===
{{For|the player-built flooring|Floors#Types of Flooring{{!}}Floors}}
{| {{STDT| sortable c_25 text-center}}
! Type !! Move Speed Modifier !! [[Fertility]] !! Terrain Support
|-
! Broken asphalt
| 100% || 0% || Heavy
|-
! Chest-deep moving water
| 22% || 0% || None
|-
! Deep ocean water
| 0% || 0% || None
|-
! Deep water
| 0% || 0% || None
|-
! Ice
| 52% || 0% || Heavy
|-
! Lichen-covered soil
| 81% || 100% || Heavy
|-
! Marsh
| 30% || 0% || None
|-
! Marshy soil
| 46% || 100% || Light
|-
! Mud
| 52% || 0% || None
|-
! Packed dirt
| 100% || 0% || Heavy
|-
! Rich soil
| 87% || 140% || Heavy
|-
! [[Rough stone]]
| {{%|{{Q|Rough stone|Move Speed Factor}} }} || 0% || Heavy
|-
! [[Rough-hewn stone]]
| {{%|{{Q|Rough-hewn stone|Move Speed Factor}} }}|| 0% || Heavy
|-
! Sand
| 76% || 10% || Heavy
|-
! Shallow ocean water
| 30% || 0% || None
|-
! Shallow moving water
| 30% || 0% || None
|-
! Shallow water
| 30% || 0% || None
|-
! Soft sand
| 52% || 0% || Light
|-
! Soil
| 87% || 100% || Heavy
|-
! Stony soil
| 87% || 70% || Heavy
|}

=== Steam geyser ===
{{stub|section=1|reason=Specific numbers on heat needed}}
[[File:Steam geyser.png|frameless|64px]] Steam geysers are terrain features that allow the placement of a [[geothermal generator]] on them and also output a significant amount of [[temperature|heat]] when sealed in a roofed room. 

The steam geyser sprays after a random delay between {{Ticks|500}} and {{Ticks|2000}}. It will then spray for between {{Ticks|200}} and {{Ticks|500}}. While spraying, it will output 40 heat every {{ticks|20}}. Thus, it averages {{#expr: (60*40*((500+200)/2)/20)/((2000+500/2) + (200+500)/2) round 2}} heat per second, with no maximum temperature.

Besides their use in power generation, they can also be used to heat bases and greenhouses without the need for electricity or fuel by sealing them in.

== Weather ==
{{stub|section=1|reason=Exact details of how large fires on the map cause rain needed}}
<!--When a number of fires are detected on a map, the "firewatcher" process will increment progress to rainy weather. Exact mechanics are unknown -->
Weather events occur from time to time depending on the biome and time of year, with the current weather listed at the right edge of the screen. When a weather event ends the weather returns to Clear. Each weather event has a general effect on wind speed. Wind speed continually varies between 0% to 100% but it is not displayed onscreen. Wind speed is a direct multiplier of a wind turbine's power output. At 50% wind speed a wind turbine produces 1500W of its 3450W max. The [[Condition causer#Weather controller|"weather controller" condition causer]] can force a single type of weather to constantly appear, and will only allow natural changes in weather once it is destroyed. 

{| class = "wikitable sortable"
|+ style = "text-align: left; font-size:120%;" | Weather types
|-
!Label
!Time of year
!Temperature range <ref>Can continue even if the temperature exits the appropriate range, once started.</ref>
!Accuracy modifier
!Movement speed modifier
!Wind speed
!Wind speed modifier
!Can put out fires
!Snowing rate
!Notes
|-
|Clear
|Any
|Any
|100%
|100%
|None to Moderate
|100%
|No
|None
|
|-
|Fog
|Any
|Any
|50%
|100%
|None to Calm
|50%
|No
|None
|Can accompany rain to create Foggy Rain
|-
|Rain
|Any
| {{Temperature|0|100}}
|80%
|90%
|Calm to Moderate
|80%
|Yes
|None
|Rain intensity can vary. Rain will put out any outdoor fires on the map. Rain can cause electronic objects to short circuit.
|-
|Dry Thunderstorm
|Any
|Any
|100%
|100%
|Moderate to Extreme
|150%
|No
|None
|[[Lightning]] strikes from thunderstorms can ignite flammable objects, including flora. If accompanied by rain the fires should be extinguished without becoming a threat.
|-
|Rainy Thunderstorm
|Any
|Any
|80%
|80%
|Moderate to Extreme
|150%
|Yes
|None
|
|-
|Foggy rain
|Any
|Any
|50%
|90%
|None to Calm
|150%
|Yes
|None
|
|-
|Hard snow
|Mainly Winter
| {{Temperature|-270|-0.5}}
|80%
|80%
|None to Moderate
|150%
|Yes
|120%
|Weather event that can distribute [[Snow]] onto the terrain.
|-
|Soft snow
|Mainly Winter
| {{Temperature|-270|-0.5}}
|80%
|100%
|None to Moderate
|150%
|Yes
|80%
|Weather event that can distribute [[Snow]] onto the terrain.
|-
|[[Events#Flashstorm|Flashstorm]]
|Any
|Any
|100%
|100%
|None to moderate
|100%
|No
|None
|An extreme version of the dry thunderstorm, and an event of its own (rather than normal weather changes). [[Lightning]] strike many times in a row in a small area, igniting anything flammable and causing giant wildfires which can spread to your base easily. It also disables rain for a short time.
|}
<references/>

== Lightning ==
[[File:Dry Thunderstorm.png|400px|thumb|right|Lightning in a [[Environment#Weather|Dry thunderstorm]] ]]
'''Lightning''' is created either naturally through thunderstorms, or artificially with the [[Psycasts#Flashstorm|flashstorm]] psycast{{RoyaltyIcon}}. These do 10 [[Damage types#Flame|Flame]] damage in a 3x3 area (1.9 block radius) and start [[fire]]s in the area of effect. Dry thunderstorms can be especially dangerous, starting fires around the map without rain to put them out. The flashstorm psycast should be used with caution, preferably in areas without vegetation or during rain. Lightning can also be spawned in with a debug command in [[development mode]].

Lightning is bright enough to momentarily power [[solar generator]]s and grow [[plants]].

== Version history ==
* [[Version/0.0.245|0.0.245]] - Weather (rain/fog) now affects chances of hitting a target
* [[Version/0.3.410|0.3.410]] - Rain now slowly washes away [[Filth|blood]]. Added rich dirt patches.
* Beta 19/ 1.0 - Sand fertility 6% -> 10%.
[[Category:RimWorld game]]