Reading Bonus

Reading Bonus is a stat: Provides a bonus to research speed, XP gained from reading, and recreation gained from reading in the same room as the bookcase. This is increased by placing more and higher quality books in the bookcase. Its minimum allowed value is 100%. Its default value is 100%.

This is only used to communicate information in the special stats page for bookcases.

It depends entirely on the following room stat:

Room Stat	Custom Label
Reading bonus	Reading bonus

Reading Bonus is determined by the number of books in bookcases in a room. Books on the floor do not count towards this stat.

There are diminishing returns on reading bonus for the number of books:

Books	Reading Bonus Offset Per Book
1-5	+0.8%
6-10	+0.4%
11-15	+0.2%
16+	+0.1%

Books 1-5 give a total of +4%, books 6-10 a total +2, 11-15 a total +1%, and 16+ a mere +0.1% per book. To reach the maximum bonus of 120%, it would require a total of 155 books.

Although the stat description might imply that higher quality books give higher reading bonuses, there is no evidence within the code that supports that case. However, there are several factors that do depend on book quality when reading a book:

Schematic research experience gain:

Quality	Research Exp/Tick	60 ticks (1 sec)	2,500 ticks (1 in-game hour)	60,000 ticks (1 in-game day)
Awful	0.008	0.48	20	480
Poor	0.012	0.72	30	720
Normal	0.016	0.96	40	960
Good	0.02	1.2	50	1200
Excellent	0.024	1.44	60	1440
Masterwork	0.028	1.68	70	1680
Legendary	0.032	1.92	80	1920

Tome Knowledge experience gain:

Quality	Knowledge Exp/Tick	60 ticks (1 sec)	2,500 ticks (1 in-game hour)	60,000 ticks (1 in-game day)
Awful	0.00003	0.0018	0.075	1.8
Poor	0.00006	0.0036	0.15	3.6
Normal	0.00009	0.0054	0.225	5.4
Good	0.00012	0.0072	0.3	7.2
Excellent	0.00015	0.009	0.375	9
Masterwork	0.00018	0.0108	0.45	10.8
Legendary	0.00021	0.0126	0.525	12.6

Textbook skill experience gain:

Quality	Skill Exp/Tick	60 ticks (1 sec)	2,500 ticks (1 in-game hour)	60,000 ticks (1 in-game day)
Awful	0.05	3	125	3000
Poor	0.075	4.5	187.5	4500
Normal	0.1	6	250	6000
Good	0.125	7.5	312.5	7500
Excellent	0.15	9	375	9000
Masterwork	0.175	10.5	437.5	10500
Legendary	0.2	12	500	12000

Novel recreation factor:

Quality	Joy Factor
Awful	1.2
Poor	1.4
Normal	1.6
Good	1.8
Excellent	2
Masterwork	2.25
Legendary	2.5

All of these factors are further multiplied by the Reading Bonus of the room.

Calculating Reading Bonus

For reference, bookcases hold 5 books per cell, where Bookcases have 2 cells and Small bookcases have 1. Cells Filled Percentage refers to the ratio of books held within a bookcase cell to the maximum, i.e. 5, so each book adds 20%.

Since Reading Bonus depends on Room Reading Bonus, they are essentially the same thing.

Room Reading Bonus is calculated with:

num = 0

num2 = 0

for each bookcase in the room: add Cells Filled Percentage for each cell to num2

num2 = sum of all bookcase cells filled percentages.

num4 = 0

while num2 > 0 and num < 0.2:

1. num5 = num2, or 1 if num2 is >= 1
2. subtract num5 from num2
3. add (num5 * CellFilledFactor[index = the smaller of num4 and 3]) to num
   • add 1 to num4

Index	Factor
0	0.04
1	0.02
2	0.01
3	0.005

Room Reading Bonus = 1 + the smaller of num and 0.2

So if you have 20 cells worth of full bookcases (100 total books):

num2 = 20

Iteration	num5	num2	num
1	1	19	0.04 (0 + 0.04)
2	1	18	0.06 (0.04 + 0.02)
3	1	17	0.07 (0.06 + 0.01)
4	1	16	0.075 (0.07 + 0.005)
5	1	15	0.08 (0.075 + 0.005)
6	1	14	0.085 (0.08 + 0.005)

With our current example, this would be repeated 14 more times, to where num = 0.155

The Room Reading Bonus would therefore be 1.155, or 115.5%, for 100 books.

Here is a table with the total number of books (in bookcases) in a room, and the resulting room reading bonus:

Books	Room Reading Bonus
0	1
1	1.008
2	1.016
3	1.024
4	1.032
5	1.04
6	1.044
7	1.048
8	1.052
9	1.056
10	1.06
11	1.062
12	1.064
13	1.066
14	1.068
15	1.07
16	1.071
17	1.072
18	1.073
19	1.074
20	1.075
25	1.08
100	1.155
155	1.2

Stat Def Data

Def Name Label Label For Full Stat List Offset Label Attributes	Description	Category	Parameters	Complex Parameters	Display Priority In Category
Def Name: RoomReadingBonus Label: reading bonus	Provides a bonus to research speed, XP gained from reading, and recreation gained from reading in the same room as the bookcase. This is increased by placing more and higher quality books in the bookcase.	Display Order: 50 Def Name: Building Label: Building Display All By Default: false	Worker Class: StatWorker_RoomReadingBonus Default Base Value: 100% Min Value: 100% To String Style: PercentZero	Parts: StatPart_RoomStat: Room Stat: Reading bonus Custom Label: Reading bonus	4200

Version history

• 1.5.4062 - Added.

---

Stats

Capacities

Pain • Consciousness • Moving • Manipulation • Talking • Eating • Sight • Hearing • Breathing • Blood Filtration  • Blood Pumping • Digestion

Basics - Important

Market Value • Market Value Ignoring Hitpoints • Honor Value

Basics - Non Pawn Important

Nutrition • Medical Potency • Medical Tend Quality Maximum • Max Hit Points

Basics - Basics

Mass • Flammability • Psychic Sensitivity Factor • Psychic Sensitivity Offset • Neural Heat Limit Offset • Neural Heat Recovery Rate Offset • Slave Suppression Offset • Terror (Source) • Max Install Count

Basics - Pawn

Recreation Fall Rate • Sleep Fall Rate • Eating Speed • Foraged Food Amount • Minimum Handling Skill • Mental Break Threshold • Immunity Gain Speed • Pain Shock Threshold • Lifespan Factor • Minimum Comfortable Temperature • Maximum Comfortable Temperature • Injury Healing Factor • Caravan Riding Speed • Carrying Capacity • Filth Rate • Crawl Speed • Move Speed • Max Nutrition • Rest Rate Multiplier • Toxic Environment Resistance • Toxic Resistance • Animals Learning Factor • Global Learning Factor • Neural Heat Limit • Psychic Sensitivity • Leather Amount • Meat Amount • Neural Heat Recovery Rate • Meditation Psyfocus Gain • Neural Heat Gain (Factor) • Ideoligion Spread Chance • Global Certainty Loss Factor • Terror • Raw Nutrition Multiplier • Learning Rate Factor • Cancer Rate Factor • Fertility • Hemogen Gain Multiplier

Basics - Non Pawn

Construction Speed (Material Factor) • Deterioration Rate • Sell Price Multiplier • Beauty • Outdoor Beauty • Cleanliness • Comfort • Work To Make • Food Poison Chance (Food Stat) • Shooting Accuracy (Turrets) • Style Dominance

Mechanoid

EMP Resistance • Bandwidth Cost • Energy Usage Multiplier • Wastepacks Per Recharge • Control Taking Time • Repair Energy Cost

Meditation

Meditation Psyfocus Bonus • Meditation Plant Growth Offset

Terrain

Cleaning Time Multiplier • Filth Multiplier

Apparel

Armor - Material Effect Multiplier • Insulation - Cold - Material Effect Multiplier • Insulation - Heat - Material Effect Multiplier • Equip Delay • Pack Radius • Shield Recharge Rate • Shield Max Energy • Insulation - Heat • Insulation - Cold • Armor - Heat • Armor - Blunt • Armor - Sharp • Jump Range

Weapon (Ranged)

Damage Multiplier • Ranged Cooldown • Accuracy (Long) • Accuracy (Medium) • Accuracy (Short) • Accuracy (Close)

Weapon (Melee)

Melee Damage Multiplier • Melee Weapon Average Armor Penetration • Melee Damage Per Second

Building

Research Speed Factor • Max Power Output • Medical Tend Quality Offset • Work Speed Factor • Work Efficiency Factor • Work To Build • Door Opening Speed • Rest Effectiveness • Immunity Gain Speed Factor • Recreation Power • Surgery Success Chance Factor • Reading Bonus • Trap Spring Chance • Trap Melee Damage • Biosculpter Pod Speed Factor • Assembly Speed Factor • Baby Play Power • Birth Quality Offset • Genetic Complexity Increase

Ability

Detection Chance • Goodwill Impact • Effect Radius • Duration • Range • Psyfocus Cost • Neural Heat Gain • Casting Time • Psylink Level

Stuff Stat Factors (Multipliers when made of this)

Melee Cooldown • Sharp Damage • Blunt Damage • Insulation - Heat (Material Factor) • Insulation - Cold (Material Factor) • Armor - Heat (Material Factor) • Armor - Blunt (Material Factor) • Armor - Sharp (Material Factor)

Mechanitor

Mech Bandwidth • Mech Control Groups • Mech Gestation Speed • Mech Remote Repair Distance • Mech Remote Shield Distance • Mech Remote Shield Energy • Mech Repair Speed • Subcore Encoding Speed • Mech Work Speed Offset

Pawn - Combat

Stagger Time Multiplier • Ranged Cooldown Multiplier • Aiming Time • Pawn Trap Spring Chance • Incoming Damage Multiplier • Accuracy Factor (Long) • Accuracy Factor (Medium) • Accuracy Factor (Short) • Accuracy Factor (Close) • Shooting Accuracy (Indoors Dark • Indoors Lit • Outdoors Dark • Outdoors Lit ) • Mortar Miss Radius Multiplier • Melee Armor Penetration • Melee Dodge Chance (Indoors Dark • Indoors Lit • Outdoors Night • Outdoors Day ) • Melee Hit Chance (Indoors Dark • Indoors Lit • Outdoors Dark • Outdoors Lit ) • Melee DPS • Melee Damage Factor • Melee Cooldown • Melee Door Damage Factor • Shooting Accuracy Multiplier (Child)

Pawn - Social

Bond Chance Factor • Train Animal Chance • Tame Animal Chance • Arrest Success Chance • Pawn Beauty • Social Impact • Drug Sell Price Improvement • Trade Price Improvement • Negotiation Ability • Suppression Power • Conversion Power • Slave Suppression Fall Rate • Animal Products Price Improvement

Pawn - Misc

Biosculpter Occupant Speed • Growth Vat Occupant Speed

Pawn - Work

Cleaning Speed Multiplier • Butchery Speed • Mechanoid Shredding Speed • Hunting Stealth • Research Speed • Smelting Speed • Smoothing Speed • Animal Gather Speed • Animal Gather Yield • Drug Cooking Speed • Drug Synthesis Speed • Butchery Efficiency • Mechanoid Shredding Efficiency • Cooking Speed • Food Poison Chance • Plant Work Speed • Plant Harvest Yield • Drug Crop Harvest Yield • Reading Speed • Repair Success Chance • Construct Success Chance • Construction Speed • Medical Tend Speed • Medical Tend Quality • Medical Operation Speed • Medical Surgery Success Chance • Mining Speed • Deep Drilling Speed • Mining Yield • General Labor Speed • Global Work Speed • Hacking Speed • Pruning Speed • Activity Suppression Speed • Study Efficiency • Entity Study Rate

Psychic Ritual

Psychic Ritual Quality • Psychic Ritual Quality Offset

Containment

Cold Containment Bonus • Containment Strength • Minimum Containment Strength

Hidden

Bed Hunger Rate Multiplier