Editing Recreation

<noinclude>
<!--Top Nav Box-->
{| align=center
| {{Architect_Nav}}
|}
----
<!-- End of Nav -->
{{Rewrite|reason=Severely outdated, desperately in need of cleanup, need overview/comparative analysis of recreation items and strats.}}
</noinclude>
<!--
Data found in
JobDefs\Jobs_Joy.xml
JoyGiverDefs\JoyGivers.xml
JoyKindDefs\JoyKinds.xml
ThingDefs\Items_Luxury.xml
ThingDefs\Items_Meals.xml
ThingDefs\Items_Resources.xml
ThoughtDefs\Thoughts_Needs.xml
-->
{{TOCright}}
{{Stat
| default base value = 1
| to string style = PercentZero
| description = Recreation is the need to have fun. Repeating the same kind of activity makes it less fun, so variety is necessary.
}}
'''Recreation''' is one of a colonist's [[needs]]. [[Prisoners]], visitors, enemy pawns, [[animals]], and [[slaves]]{{IdeologyIcon}} do not have the recreation need. 

Colonists gain recreation in two ways:
* Consuming something pleasurable, such as [[chocolate]] or [[beer]].
* Doing an activity, such as playing [[horseshoes pin|horseshoes]] or watching [[tube television|television]]

Colonists may do recreation activities when their [[Menus#Restrict|timetable]] allows. Some activities require nothing more than an allotted time while certain activities require the relevant building or item. Certain items can only be purchased from traders. Some activities have an added benefit of improving skill experience points. Colonists develop an increasing tolerance, or resistance, to a kind of activity the more it is done. Tolerances are shown in the Recreation tooltip (hover the mouse over the recreation meter) and are listed by kind and percentage. A variety of kinds of activities should be made available to avoid tolerance buildup. Currently there are 9 types of recreation - solitary relaxation, social interaction, television watching, cerebral play, dexterity play, music, telescope study, chemical consumption, and food consumption.

Injured colonists will only ever engage in recreational activities that can be done in bed, such as watching television. A television is therefore a good investment for every hospital.

Colonists on [[caravan]] gain recreation while stopped at a rate of 10% per hour, of the Solitary type if they are alone, or a mix of Solitary and Social if two or more colonists are on the same caravan. Tolerance is gained at an equivalent rate to Extremely Low Expectations, regardless of the expectations at the colony or the amount of wealth taken on the caravan.

==Recreation Needs==
{{Stub|section=1|Reason=Mechanics, Gain and loss rates, table of times till etc}}
===Recreation thresholds===
The recreation meter has thresholds that trigger [[mood]]-altering thoughts. No thoughts are triggered from 30% to 69%.

{| class="wikitable" style="text-align:left; padding-left: 6px;"
! Threshold !! Label !!  Mood Effect !! Thought
|- 
| style="text-align:center;" | 85 - 100 || &nbsp;Recreation fully satisfied || style="text-align:center;" | {{+|10}} || &nbsp;I've been enjoying myself so much, I love it!
|-
| style="text-align:center;" | 70 - 85 || &nbsp;Recreation satisfied || style="text-align:center;" | {{+|5}} || &nbsp;I've been having a great time doing various things I like to do.
|-
| style="text-align:center;" | 15 - 30 || &nbsp;Recreation unfulfilled || style="text-align:center;" | {{--|5}} || &nbsp;I could really use a break for something enjoyable.
|-
| style="text-align:center;" | 0 - 15  || &nbsp;Recreation deprived || style="text-align:center;" | {{--|10}} || &nbsp;We need more variation in recreation activities, and i need time to enjoy them. This place is really dull.
|-
| style="text-align:center;" | 0 || &nbsp;Recreation-starved || style="text-align:center;" | {{--|20}} || &nbsp;It's been so long since I did anything for fun on my own time.
|}

===Recreation tolerance===
Colonists develop an increasing tolerance, or resistance, to specific types of recreation the more it is performed. Tolerances are shown in the Recreation tooltip (hover the mouse over the recreation meter) and are listed by kind and percentage. A variety of kinds of activities should be made available to avoid tolerance buildup.

Recreation tolerance reduces recreation gained proportionally. Recreation tolerance gained is 2/3 of the recreation value increase from the activity. For instance, A colonist consuming 4 units of chocolate at 0% gluttonous tolerance would gain 40% recreation and 26.7% gluttonous tolerance. Eating another 4 immediately would only provide 73.3% of 40% or 29.3% recreation gain and 2/3 of 29.3% or 19.6% gluttonous tolerance. Recreation tolerance only increases when an action increases recreation.

Recreation tolerance decreases while awake at a rate dependent on the wealth of the colony, with higher wealth colonies needing more recreation variety to combat the lower rate of tolerance decrease. It has 6 stages at different wealth values. 

Additionally, [[conceited noble]]s {{RoyaltyIcon}} have Noble and Royal Expectations at the ranks of Baron and Count respectively. These expectations replace the effects of regular expectations. Note that despite only being seen in-game with the [[Royalty DLC]] activated, these expectations are defined in the Core game. 

Finally, [[Ideoligion#Roles|Ideoligious Roles]] can increase the expectations of the pawn by two levels, so a pawn that would normally have Low Expectations would then have High Expectations. To prevent these "going off the scale", at High and Sky-High, Elite and Supreme are used instead. Note that despite only being seen in-game with the [[Ideology DLC]] activated, these expectations are defined in the Core game. 

{| class="wikitable"
|-
! Name !! Wealth Limits !! Recreation Tolerance<br>Loss/Day !! Num. of Recommended<br>Recreation Types
|-
| Extremely low expectations          || 0 - 15,000               || 18% || 2
|-
| Very low expectations               || 15,000 - 31,000          || 13% || 3
|-
| Low expectations                    || 31,000 - 81,000          || 11% || 3
|-
| Moderate expectations               || 81,000 - 182,000         || 10% || 4
|-
| High expectations                   || 182,000 - 308,000        || 8% || 5
|-
| Sky-high expectations               || 308,000 -  1,000,000,000 || 7% || 6
|-
| Noble expectations {{RoyaltyIcon}}  || N/A                      || 7% || 6
|-
| Royal expectations {{RoyaltyIcon}}  || N/A                      || 7% || 6
|-
| Elite expectations{{IdeologyIcon}}  || See above                || 7% || 6
|-
| Supreme expectations{{IdeologyIcon}}|| See above                || 7% || 6
|}

==Activities table==
{{Stub|section=1|reason= Add required Capacities and chances from JoyGivers.xml}}
{| {{STDT| sortable c_05 text-center}}
! Activity !! Duration !! Gain Rate !! Recreation kind !! Interaction !! Improves Skill !! +XP Per Tick
|- 
| style="text-align:left;" | Skygazing || {{ticks|4000}} || 1 || Solitary relaxation || Solitary || - || -
|-
| style="text-align:left;" | Meditating || {{ticks|4000}} || 1 || Solitary relaxation || Solitary || - || -
|-
| style="text-align:left;" | Praying || {{ticks|3000}} || 1 || Solitary relaxation || Solitary || - || -
|- 
| style="text-align:left;" | Going for a walk || {{ticks|8000}} || 1 || Solitary relaxation || Solitary || - || -
|- 
| style="text-align:left;" | [[Snowman|Building snowman]] || {{ticks|8000}} || 1 || Solitary relaxation || Solitary || - || -
|-
| style="text-align:left;" | Visiting grave || {{ticks|4000}} || 1 || Solitary relaxation || Building || - || -
|-
| style="text-align:left;" | Viewing art || {{ticks|4000}} || 1 || Solitary relaxation || Building || - || -
|-
| style="text-align:left;" | Relaxing socially || {{ticks|4000}} || 1 || Social interaction || Social || - || -
|-
| style="text-align:left;" | Cheering up patient <NAME> || {{ticks|1500}} || 1 || Social interaction  || Social || - || -
|-
| style="text-align:left;" | [[Horseshoes pin|Playing horseshoes]]<ref name="NewArrivalsOnly">Only craftable when playing as New Arrivals. Can still be acquired from traders otherwise.</ref> || {{ticks|4000}} || 1 || Dexterity play || Building || Shooting || 0.003
|-
| style="text-align:left;" | [[Hoopstone ring|Playing hoopstone ring]]<ref name="TribeOnly">Only craftable when playing as New Tribe. Can still be acquired from traders otherwise.</ref> || {{ticks|4000}} || 1 || Dexterity play || Building || Shooting || 0.003
|-
| style="text-align:left;" | [[Chess table|Playing chess]]<ref name="NewArrivalsOnly" /> || {{ticks|4000}} || 1 || Cerebral play || Building  || Intellectual || 0.002
|-
| style="text-align:left;" | [[Game-of-Ur board|Playing the game of Ur]]<ref name="TribeOnly" /> || {{ticks|4000}} || 0.8 || Cerebral play || Building  || Intellectual || 0.0015
|-
| style="text-align:left;" | [[Billiards table|Playing billiards]] || {{ticks|4000}} || 1.3 || Dexterity play || Building || Shooting || 0.004
|-
| style="text-align:left;" | [[Poker table|Playing poker]] || {{ticks|4000}} || 1.3 || Cerebral play || Building || Intellectual || 0.004
|-
| style="text-align:left;" | [[Telescope|Using telescope]]<ref name="TradersOnly">Only acquired from traders.</ref><ref name="Installed">Must be installed before use.</ref> || {{ticks|4000}} || 1.2 || Telescope study|| Building || Intellectual || 0.004
|-
| style="text-align:left;" | [[Tube television|Watching television]]<ref name="Installed" /> || {{ticks|4000}} || 1.2 || Television watching || Building || - || -
|-
| style="text-align:left;" | [[Flatscreen television|Watching flatscreen television]]<ref name="Installed" /> || {{ticks|4000}} || 1.4 || Television watching || Building || - || -
|-
| style="text-align:left;" | [[Megascreen television|Watching megascreen television]]<ref name="TradersOnly" /><ref name="Installed" /> || {{ticks|4000}} || 1.6 || Television watching || Building || - || -
|-
| style="text-align:left;" | [[Harp|Playing harp]] {{RoyaltyIcon}} || {{ticks|4000}} || 1 || Music || Building || Artistic || 0.0015
|-
| style="text-align:left;" | [[Harpsichord|Playing harpsichord]] {{RoyaltyIcon}} || {{ticks|4000}} || 1 || Music || Building || Artistic || 0.0015
|-
| style="text-align:left;" | [[Piano|Playing piano]] {{RoyaltyIcon}} || {{ticks|4000}} || 1 || Music || Building || Artistic || 0.0015
|-
| style="text-align:left;" | Meditating royally at ?{{Check Tag|At What?}} {{RoyaltyIcon}} || {{ticks|6250}} || 1 || Solitary relaxation || Building || - || -
|}
Note: the above Recreation gain rates are based on normal quality buildings when applicable.
<references />

==Consumables table==

{| {{STDT| sortable c_05 text-center}}
! Item !! +Recreation (%) !! Kind
|- 
| style="text-align:left;" | [[Chocolate]]  || 10 || Food Consumption
|-
| style="text-align:left;" | [[Insect jelly]]  || 8 || Food Consumption
|-
| style="text-align:left;" | [[Ambrosia]] || 50 || Chemical
|- 
| style="text-align:left;" | [[Beer]] || 17 || Chemical
|- 
| style="text-align:left;" | [[Smokeleaf joint]] || 80 || Chemical
|-
| style="text-align:left;" | [[Psychite tea]]  || 40 || Chemical
|-
| style="text-align:left;" | [[Go-juice]]  || 40 || Chemical
|-
| style="text-align:left;" | [[Wake-up]]  || 40 || Chemical
|-
| style="text-align:left;" | [[Yayo]]  || 80 || Chemical
|-
| style="text-align:left;" | [[Flake]]  || 70 || Chemical
|-
|}

==Buildings==
The following can be built from the '''Architect - Recreation''' menu.
{| {{STDT| sortable c_05 text-center}}
! Item !! recreation spots !! recreation power (%) !! Kind !! improves
|- 
| style="text-align:left;" | [[Horseshoes]]  || 12 || 100 || {{Q|Horseshoes pin|Recreation Type}} || shooting
|-
| style="text-align:left;" | [[Hoopstone ring]] || 12 || 100 || {{Q|Hoopstone ring|Recreation Type}} ||shooting
|-
| style="text-align:left;" | [[Chess table]] || 2  || 100 || {{Q|Chess table|Recreation Type}} || intellectual
|- 
| style="text-align:left;" | [[Game-of-Ur]] || 2 || 80 || {{Q|Game-of-Ur board|Recreation Type}} || none
|- 
| style="text-align:left;" | [[Billiards table]] || 2 || 130 || {{Q|Billiards table|Recreation Type}} ||shooting
|-
| style="text-align:left;" | [[Poker table]]  || 8(max 4) || 130 || {{Q|Poker table|Recreation Type}} ||none
|-
| style="text-align:left;" | [[Telescope]]  || 1 || 120 || {{Q|Telescope|Recreation Type}} || none
|-
| style="text-align:left;" | [[Tube television]]  || 15 || 120 || {{Q|tube television|Recreation Type}} || none
|-
| style="text-align:left;" | [[Flatscreen television]]  || 30 || 140 || {{Q|flatscreen television|Recreation Type}} || none
|-
| style="text-align:left;" | [[Megascreen television]]  || 42 || 160 || {{Q|megascreen television|Recreation Type}} || none
|-
|}

== Activities ==

=== Building snowman ===
{{Stub|section=1|reason=Requirements, snowing, snow on the ground, both, range to area, effects etc.}}
In cold biomes after [[snow]], a colonist may build a [[snowman]].

=== Going for a walk ===
When a colonist goes for a walk, this means that they aimlessly path around the area they started from. This takes twice as long as most other activities to finish and yet still has the same tolerance gain rate.

=== Meditating ===
Meditating is the act of your colonists going into their private room and sitting in a corner for a while while in solitary. Like most other activities, this has a length of 4000 ticks and an average tolerance gain rate.

=== Playing billiards ===
One or more colonists will wander around the billiards table, taking shots. Raises the Shooting skill in a similar way as horseshoes.

=== Playing chess ===
A chess table requires adjacent chairs to be used. Up to two colonists can use a chess table at once. Slowly raises the Intellectual skill.

=== Playing hoopstone ===
One to three colonists take turns throwing stones through the ring from approximately 5 blocks away. Playing hoopstone raises the Shooting skill.

=== Playing horseshoes ===
One to three colonists take turns throwing horseshoes at the post from approximately 5 blocks away. Playing horseshoes raises the Shooting skill.

=== Playing poker ===
One to four colonists will sit at chairs adjacent to the table and play poker. Playing poker raises the Intellectual skill.

=== Playing the game of Ur ===
A Game-of-Ur board does not require adjacent chairs to be used. Up to two colonists can use a Game-of-Ur board at once. Slowly raises the Intellectual skill.

=== Praying ===
Similar to Meditating, but lasts shorter and is only done by certain colonists. <br>
In the game files, each colonist has a value determining whether or not they will pray.

=== Relaxing socially ===
[[File:Gather spot.png|64px|left]]

A '''gather spot''' or '''gathering spot''' works like a loosely defined social "zone", allowing your pawns who are idle or seeking Social recreation to gather together in a specifically centered area. This also can keep them from getting lost when they're not doing anything productive.

If you have a "gather spot" enabled, colonists will gather here to socialize for recreation, especially when idle. Colonists will stand in the vicinity of the campfire, or sit at a chair or stool beside a table.  If beer is available, a colonist may carry a bottle while relaxing, without actually consuming the item. This action has been shown to occur among colonists with the Chemical Interest trait, the Teetotaler trait, and no trait in regards to alcohol.

[[Table]]s and [[campfire]]s (only) can be designated as gather spots, and are so designated by default when constructed.   You can have more than one gather spot, in which case an idle/social pawn appears(?) to choose the closest one when the mood to gather hits them. This should be toggled '''off''' on all tables/campfires except for one in your preferred rec/dining room. Not toggling can cause people to gather and have parties at any table (or campfire), perhaps in the middle of an ugly, dirty, dangerous abandoned mining site, making everybody unhappy. Gather spots can be turned off by toggling a command while that object is selected (bottom of the screen).

Contradictory to its name, colonists can carry out this activity when alone, while still gaining Recreation at the same rate.

=== Skygazing ===
Skygazing is the act of your colonists simply laying on the ground in an outdoor (area without a [[roof]]) area and facing upwards. The game has a few flavor text names such as "Cloudwatching". This activity is the same length of time that most others are and the same tolerance gain rate.

=== Using telescope ===
A colonist will stand behind the telescope's viewfinder for some time. The telescope must be placed outside and will not degrade from weather.

Oddly, colonists may use it during daytime.

=== Visiting grave ===
{{Stub|section=1|reason=Reports that tomb impressiveness affects recreation rate}}
Colonists will visit a filled [[grave]] or [[sarcophagus]].

=== Viewing art ===

{{stub|section=1}}

=== Watching the eclipse ===

{{stub|section=1}}

[[Events#Eclipse|Eclipse]]...

=== Watching the sunset ===

{{stub|section=1}}

<!-- can happen around 19 hours with clear weather sometimes -->

=== Stargazing ===

{{stub|section=1}}

<!-- can happen between 20 hours and 1 hours with clear weather sometimes -->

=== Cloudwatching ===

{{stub|section=1}}

<!-- can happen with clear day, around between 7h and 9h sometimes -->

== Version history ==
* [[Version/0.10.785|0.10.785]] - Added as '''Joy''' with Skygazing, Meditating/praying, Social relaxation, Horseshoes game, Chess, Billiards, Television, and Telescope as the initial sources.
* [[Version/0.11.877|0.11.877]] - Added new joy activity: build snowman.
* [[Version/0.12.906|0.12.906]] - Added grave and sarcophagus visiting as joy activity.
* B19/1.0 - Doing passionate work now affects mood instead of recreation.
* [[Version/1.1.0|1.1.0]] - Pawns no longer engage in recreational activities when injured, unless the activity can be done in bed.

{{nav|status levels|wide}}
{{nav|joy}}
[[Category:Buildings]]
[[Category:Status Level]]