Guidebook Species Lore Alignment & Mechanical Species Audit#112
Guidebook Species Lore Alignment & Mechanical Species Audit#112rebaserHEAD wants to merge 41 commits into
Conversation
Adds a Respirator override on BaseMobArachnid with Asphyxiation: 1.5, aligning the prototype with the guidebook claim that arachnids suffocate 50% faster than other species.
- Hunger.baseDecayRate 0.03 -> 0.036 (exactly 2x the human 0.018), so the guidebook claim of "2x hunger rate" is now literally true. - OrganAvaliStomach.specialDigestible drops Crayon and Paper, leaving Meat, Pill, and AvianFood, to match the guidebook claim that avali can only digest meat-related items and pills.
Protogen damageModifierSet Cold 1.15 -> 1.3, aligning with the guidebook claim of "30% more cold damage".
TemperatureStatusEffects.minimumTemperature 322 -> 320.15 (= 47C), so the heat-boost mechanic kicks in at the temperature claimed by the guidebook.
Adds two heat-side TemperatureSpeed thresholds (303K = ~30C -> 0.8, 310K = ~37C -> 0.6) alongside the existing cold-side thresholds, so the guidebook claim of "suffering at just 30C" is now mechanically true. The 310K stop sits below the existing heatDamageThreshold of 320.15 K to give the player a slowdown warning before damage starts.
- Thirst.baseDecayRate 0.2 -> 0.15 (= 2x the 0.075 human default), so the guidebook claim of "thirsty 100% faster" is true. - OrganFeroxiStomach.specialDigestible reduced to Meat and Pill only, dropping ReptilianFood/Crayon/Paper, so the guidebook claim that feroxi can ONLY eat meat (and pills) is true.
- BonusMeleeDamage Blunt 1.2 -> 1.35 and Asphyxiation 1.2 -> 1.35, so the guidebook's "+35% Blunt/Asphyx unarmed damage" claim holds. - pryTimeMultiplier 0.6 -> 0.5, so oni pry airlocks in half the time of other species (the guidebook's "50% less time" claim).
Comments out the Hydrakin-specific Oxygenate effect on CarbonDioxide. The guidebook says hydrakin breathe all gases EXCEPT CO2 and water vapor; this aligns the metabolism with that claim. The existing HealthChange exclusion (shouldHave: false on OrganType Hydrakin) is left alone, so CO2 still doesn't poison them - they just don't gain oxygen from it any more.
Overrides Stamina with critThreshold 85 (default 100) and decay 2.55 (default 5), so felinids have slightly less stamina capacity and recover from stamina damage more slowly than humans — matching the guidebook's "slightly less stamina" claim.
Restructures the Human guidebook page into the unified species template: - Single intro paragraph (merged from two short lines). - ## Benefits section with bulleted entries. - Color palette normalized: "20% faster" recoloured #ffa500 -> #1e90ff because it's a beneficial mechanic, not a hazard.
Restructures the Moth People guidebook page into the unified template with ## Diet / ## Benefits / ## Drawbacks sections and bulleted entries. No mechanical changes - existing color tags already match the palette (#1e90ff for benefits, #ffa500 for drawbacks).
Restructures the Vox guidebook page: - Hazard preamble preserved (orange). - Intro paragraph condensed to one block (was 3 lines). - ## Atmospherics section covers breathing rules, internals, and the poison-recovery mechanic as bullets (multi-paragraph recovery prose kept inline in the relevant bullet rather than split). - ## Benefits records the Slash unarmed attack.
- Restructured into ## Benefits / ## Drawbacks bullets. - Cold modifier text updated to "30% more Cold" (was "30% more cold") to match the Cold 1.15 -> 1.3 prototype change. - Adds a benefit bullet noting Slash unarmed (previously undocumented).
Restructures the Arachnid page: - Intro condensed. - ## Diet bullets pull out the raw-meat-OK / chocolate-onion-poisons rules already implied in the original prose. - ## Benefits records pocket slots and Piercing unarmed attack. - ## Special preserves the Sericulture section with the existing entity-embed grid. - ## Drawbacks calls out the 50% faster suffocation (matches the Step 1 Respirator override) and the Copper-blood replenishment.
Restructures the Slime People page into intro + ## Atmospherics / ## Benefits / ## Drawbacks bullets. Removes the "pressure damage 9% faster" claim (the corresponding row K was dropped from Step 1 because the current Barotrauma override uses absolute damage values rather than a coefficient).
Restructures the Resomi page into ## Diet / ## Benefits / ## Drawbacks bullets. Adds the new mechanical reality from Step 1 row F: warmth above 30C slows them and the slowdown deepens at 37C, with heat damage starting at 47C.
Restructures the Avali page into ## Diet / ## Benefits / ## Drawbacks bullets. Updates the hunger claim from "2x Hunger rate" to "double that of humans" - Step 1 row B set Avali Hunger.baseDecayRate to 0.036, exactly 2x the human 0.018, so the literal claim is true and the wording is more direct. Also folds in the previously-undocumented heat threshold of ~37C.
Restructures the Tajaran page into the unified template. Adds previously-undocumented mechanics: - Night Vision (NightVision component). - ~16% faster hunger rate. - Reduced stamina. Normalizes the [color=turquoise] for Ahdomai to [color=yellow] (the unified palette uses yellow for in-world place names and emphasis). Normalizes the [color=#ec3a3a] red-warning shade to the standard [color=#ffa500] orange for drawbacks.
…nics Restructures the Hydrakin page into the unified template (## Diet / ## Benefits / ## Atmospherics / ## Temperature / ## Drawbacks). The CO2-exclusion claim was already present and is now mechanically backed by the Step 1 row L change. Folds in: - Unarmed Slash attack. - +20% damage from low-pressure / vacuum (PressureProtection 1.2). Normalizes colors: #4169E1 royal blue -> #1e90ff dodger blue; #FFA500 case lowered; #FF0000 -> red where applicable (handled inline).
Preserves the existing mechanic-specific sections (Recharging / Integrated Radio / Repairing) with their entity-embed grids - these are a strong existing pattern worth keeping. Adds: - Recharging list converted from short paragraphs to bullets. - New ## Resistances section documenting heat/shock weakness from the IPC / IPCWeakened damage modifier sets.
Restructures the Dwarf page (live NF copy, not the dead base) into the unified template. Adds the previously-undocumented drawback that dwarves suffocate roughly twice as fast as humans (Respirator override Asphyxiation: 2 in the prototype). Preserves the existing ore-sense paragraph and entity grid above the bullet sections to keep the lore flavour.
Restructures the Diona page (live _NF copy) into the unified template, preserving the Tree and Nymph sub-sections as ### sub-headings under ## Special. Adds the previously-undocumented benefit: - Immune to step-trigger hazards (ProtectedFromStepTriggers).
Restructures the live MonoReptilian page (the base Reptilian.xml is a dead duplicate left untouched). Preserves the claw-stage table and heating-up section as ### sub-headings under ## Special so the mechanic-dense content stays readable. Adds: - Previously-undocumented +30% Cold damage from the Mono-fork modifier set under ## Drawbacks. - Aligns the heat-boost threshold prose with the Step 1 row E change (47C is now the actual threshold). Color palette normalized: #FFA500 -> #ffa500 (case), #FF0000 -> #ffa500, #4169E1 -> #1e90ff, #FFDEAD callouts dropped where redundant.
Restructures the Goblin page into the unified template. Adds three previously-undocumented benefits: - -10% Caustic damage (Goblin modifier set). - Reduced fall/impact damage. - Less slow-on-damage. Normalizes the [color=lime] toxin-resistance highlight to [color=#1e90ff] (the unified beneficial-mechanic colour); keeps the red on the Slash-damage callout because it matches the warning palette.
Already templated; minor wording polish. Adds the [color=#1e90ff] highlight to the +35% Blunt/Asphyxiation melee callout and the half-pry-time callout, which are now accurate to the prototype after Step 1 row I/J set Blunt: 1.35, Asphyxiation: 1.35, and pryTimeMultiplier: 0.5.
…nd stamina Updates the Felinid page to match implementation reality: - Removes the "Immunity to the OwOnavirus disease" bullet - the disease system is commented out, so the claim is infeasible. - Adds bullets for the previously-undocumented reduced fall damage (DamageOnHighSpeedImpact softened) and reduced SlowOnDamage. - Documents the new Step 1 row M2 stamina override (critThreshold 85, decay 2.55), giving the "slightly less stamina" claim mechanical backing it didn't have before.
Restructures into the unified template. Updates: - Diet now says "meat AND pills" (the OrganFeroxiStomach specialDigestible was narrowed in Step 1 row H from ReptilianFood/Meat/Pill/Crayon/Paper down to Meat/Pill). - Removes the "Their biology allow them to breathe water vapour" benefit claim - no WaterVapor reagent exists in the gas system. Adds a ## Special footnote explaining the deferral so the design intent is preserved without a false mechanical claim.
Already templated; tightens bullet wording and normalizes the [color=#ff0f0f] bright-red Chitzite warning to [color=#ffa500] orange (it's a hazard caveat, not a hard "do not" rule).
Restructures the double-respiration explanation from a wall of inline sub-bullets into a flat ## Atmospherics section, which matches the template used by Vox and Slime. The mechanics themselves are unchanged.
Already templated; no mechanical changes. Tightens bullet wording and applies the [color=#ffa500] palette to drawbacks consistently.
…beds Final pass over all 22 dossiers, layering several intertwined polishes: Banner narrowing 60 -> 54 chars (header, footer, section dividers). Reduced after the 60-char design wrapped at 75% UI scale in narrowed guidebook windows. The matching GuidebookWindow MinSize bump (belt-and-suspenders) lives in the matching feat commit. Switched <GuideEntityEmbed Entity="MobX"/> to "MobXDossierExemplar" on every dossier so the paper doll uses the new randomized BuPers exemplar instead of a static live-mob preview. Janssen quote rework: replaced openers and topical sprinkle quotes with situational one-off clarifications to subordinates, per the post-corporate canon (Janssen as long-serving veteran, curious + warm + dry deadpan, human himself but bias-aware of that). The format is now anchored as the canonical Janssen voice across the dossier set. Dietary range: schema standardized across all dietary blocks. Toxin callouts (theobromine, allicin, etc.) now use a Warning eyecatch. Human de-baselining: rewrote Subject paragraph and Janssen opener so humans read as one species among many, not the implicit measuring stick. Janssen acknowledges his own human identity in the bias-aware quote. Em-dash cleanup in prose. Em dashes still appear in formatting flair (bylines, mono data rows, header separators) where they read as typographic separators, not sentence filler. Affected dossiers: Arachnid, Avali, Chitinid, Diona, Dwarf, Felinid, Feroxi, Goblin, Harpy, Human, Hydrakin, IPC, MonoReptilian, Moth, Oni, Protogen, Resomi, Rodentia, SlimePerson, Tajaran, Vox, Vulpkanin (22 total).
8215b74 to
0595860
Compare
|
Repushed since SOMEONE pushed their commits to my PR on accident lol. |
|
Another note, update for slime guidebook perhaps |
…anges Rodentia now runs on Rat organs (OrganRatHeart/Lungs/Stomach). The heart metabolizes the Poison group, and theobromine/allicin poison effects are gated `Rat shouldHave: false`, so neither fires anymore. Replaced the toxicity warning with a tolerance note. Slime core gained specialDigestible (cloth/paper/pill/trash/moth-food) and its metabolizer types went [Slime] -> [Slime, Animal, Goblin, Moth, Vox]. Documented the expanded digestion and raw/species-restricted-food tolerance. Lungs stayed [Slime], so breathing and the Vox oxygen-poison are unaffected.
| Starving: 100 | ||
| Dead: 0 | ||
| baseDecayRate: 0.03 | ||
| baseDecayRate: 0.036 |
There was a problem hiding this comment.
| baseDecayRate: 0.036 | |
| baseDecayRate: 0.036 # Triad (0.03 -> 0.036) |
| coefficients: | ||
| Heat: 1.3 | ||
| Cold: 1.15 | ||
| Cold: 1.3 |
There was a problem hiding this comment.
| Cold: 1.3 | |
| Cold: 1.3 # Triad (1.15 -> 1.3) |
| - Crayon | ||
| - Paper |
There was a problem hiding this comment.
Comment the two out instead
| 303: 0.8 # ~30C, heat-side slowdown (matches guidebook "suffering at 30C") | ||
| 310: 0.6 # ~37C, deeper heat slowdown before damage threshold at 320.15 |
There was a problem hiding this comment.
| 303: 0.8 # ~30C, heat-side slowdown (matches guidebook "suffering at 30C") | |
| 310: 0.6 # ~37C, deeper heat slowdown before damage threshold at 320.15 | |
| 303: 0.8 # Triad - ~30C, heat-side slowdown | |
| 310: 0.6 # Triad - ~37C, deeper heat slowdown before damage threshold at 320.15 |
| speciesId: feroxi | ||
| - type: Thirst | ||
| baseDecayRate: 0.2 | ||
| baseDecayRate: 0.15 |
There was a problem hiding this comment.
| baseDecayRate: 0.15 | |
| baseDecayRate: 0.15 # Triad (0.2 -> 0.15) |
| - ReptilianFood | ||
| - Meat | ||
| - Pill | ||
| - Crayon | ||
| - Paper |
There was a problem hiding this comment.
Comment them out like the previous review as well instead of simply deleting the lines
There was a problem hiding this comment.
Also, just straight up remove this whitelist - dietary restrictions shouldn't be added
If we wanted to make certain items make certain species sick, that is fine, but it shouldn't be straight up blacklisted
If that were to be added, there should be some chemicals to alleviate the sickness
| critThreshold: 85 # slightly less stamina than humans (default 100), per guidebook | ||
| decay: 2.55 # recovers slower than humans (default 5) |
There was a problem hiding this comment.
| critThreshold: 85 # slightly less stamina than humans (default 100), per guidebook | |
| decay: 2.55 # recovers slower than humans (default 5) | |
| critThreshold: 85 # Triad - slightly less stamina than humans (default 100) | |
| decay: 2.55 # Triad - recovers slower than humans (default 5) |
| scale: 1.2, 1.2 | ||
| - type: PlayerToolModifier | ||
| pryTimeMultiplier: 0.6 | ||
| pryTimeMultiplier: 0.5 |
There was a problem hiding this comment.
| pryTimeMultiplier: 0.5 | |
| pryTimeMultiplier: 0.5 # Triad (0.6 -> 0.5) |
| damageModifierSet: | ||
| coefficients: | ||
| Blunt: 1.2 | ||
| Blunt: 1.35 |
There was a problem hiding this comment.
| Blunt: 1.35 | |
| Blunt: 1.35 # Triad (1.2 -> 1.35) |
| Slash: 1.2 | ||
| Piercing: 1.2 | ||
| Asphyxiation: 1.2 | ||
| Asphyxiation: 1.35 |
There was a problem hiding this comment.
| Asphyxiation: 1.35 | |
| Asphyxiation: 1.35 # Triad (1.2 -> 1.35) |
| @@ -18,7 +18,7 @@ | |||
| id: UndergarmentBottomBriefs | |||
| bodyPart: UndergarmentBottom | |||
| markingCategory: UndergarmentBottom | |||
| speciesRestriction: [Arachnid, Diona, Human, Dwarf, Moth, SlimePerson, IPC, Felinid, Oni, Avali, Chitinid, Harpy, Rodentia, Vulpkanin, Feroxi, Goblin, Tajaran, Yowie, Protogen] # Triad - Underwear. | |||
| speciesRestriction: [Arachnid, Diona, Human, Dwarf, Moth, SlimePerson, IPC, Felinid, Oni, Avali, Chitinid, Harpy, Hydrakin, Resomi, Rodentia, Vulpkanin, Feroxi, Goblin, Tajaran, Yowie, Protogen] # Triad - Underwear. | |||
| coloring: | |||
| default: | |||
| type: null | |||
| @@ -31,7 +31,7 @@ | |||
| id: UndergarmentBottomSatin | |||
| bodyPart: UndergarmentBottom | |||
| markingCategory: UndergarmentBottom | |||
| speciesRestriction: [Arachnid, Diona, Human, Dwarf, Moth, SlimePerson, IPC, Felinid, Oni, Avali, Chitinid, Harpy, Rodentia, Vulpkanin, Feroxi, Goblin, Tajaran, Yowie, Protogen] # Triad - Underwear. | |||
| speciesRestriction: [Arachnid, Diona, Human, Dwarf, Moth, SlimePerson, IPC, Felinid, Oni, Avali, Chitinid, Harpy, Hydrakin, Resomi, Rodentia, Vulpkanin, Feroxi, Goblin, Tajaran, Yowie, Protogen] # Triad - Underwear. | |||
| coloring: | |||
| default: | |||
| type: null | |||
| @@ -44,7 +44,7 @@ | |||
| id: UndergarmentTopBra | |||
| bodyPart: UndergarmentTop | |||
| markingCategory: UndergarmentTop | |||
| speciesRestriction: [Arachnid, Diona, Human, Dwarf, Moth, Reptilian, SlimePerson, IPC, Felinid, Oni, Avali, Chitinid, Harpy, Rodentia, Vulpkanin, Feroxi, Goblin, Tajaran, Yowie, Asakim, Protogen] # Triad - Underwear. | |||
| speciesRestriction: [Arachnid, Diona, Human, Dwarf, Moth, Reptilian, SlimePerson, IPC, Felinid, Oni, Avali, Chitinid, Harpy, Hydrakin, Resomi, Rodentia, Vulpkanin, Feroxi, Goblin, Tajaran, Yowie, Asakim, Protogen] # Triad - Underwear. | |||
| coloring: | |||
| default: | |||
| type: null | |||
| @@ -57,7 +57,7 @@ | |||
| id: UndergarmentTopSportsbra | |||
| bodyPart: UndergarmentTop | |||
| markingCategory: UndergarmentTop | |||
| speciesRestriction: [Arachnid, Diona, Human, Dwarf, Moth, Reptilian, SlimePerson, IPC, Felinid, Oni, Avali, Chitinid, Harpy, Rodentia, Vulpkanin, Feroxi, Goblin, Tajaran, Yowie, Asakim, Protogen] # Triad - Underwear. | |||
| speciesRestriction: [Arachnid, Diona, Human, Dwarf, Moth, Reptilian, SlimePerson, IPC, Felinid, Oni, Avali, Chitinid, Harpy, Hydrakin, Resomi, Rodentia, Vulpkanin, Feroxi, Goblin, Tajaran, Yowie, Asakim, Protogen] # Triad - Underwear. | |||
| coloring: | |||
| default: | |||
| type: null | |||
| @@ -70,7 +70,7 @@ | |||
| id: UndergarmentTopBinder | |||
| bodyPart: UndergarmentTop | |||
| markingCategory: UndergarmentTop | |||
| speciesRestriction: [Arachnid, Diona, Human, Dwarf, Moth, Reptilian, SlimePerson, IPC, Felinid, Oni, Avali, Chitinid, Harpy, Rodentia, Vulpkanin, Feroxi, Goblin, Tajaran, Yowie, Asakim, Protogen] # Triad - Underwear. | |||
| speciesRestriction: [Arachnid, Diona, Human, Dwarf, Moth, Reptilian, SlimePerson, IPC, Felinid, Oni, Avali, Chitinid, Harpy, Hydrakin, Resomi, Rodentia, Vulpkanin, Feroxi, Goblin, Tajaran, Yowie, Asakim, Protogen] # Triad - Underwear. | |||
| coloring: | |||
| default: | |||
| type: null | |||
| @@ -83,7 +83,7 @@ | |||
| id: UndergarmentTopTanktop | |||
| bodyPart: UndergarmentTop | |||
| markingCategory: UndergarmentTop | |||
| speciesRestriction: [Arachnid, Diona, Human, Dwarf, Moth, Reptilian, SlimePerson, IPC, Felinid, Oni, Avali, Chitinid, Harpy, Rodentia, Vulpkanin, Feroxi, Goblin, Tajaran, Yowie, Asakim, Protogen] # Triad - Underwear. | |||
| speciesRestriction: [Arachnid, Diona, Human, Dwarf, Moth, Reptilian, SlimePerson, IPC, Felinid, Oni, Avali, Chitinid, Harpy, Hydrakin, Resomi, Rodentia, Vulpkanin, Feroxi, Goblin, Tajaran, Yowie, Asakim, Protogen] # Triad - Underwear. | |||
| coloring: | |||
| default: | |||
| type: null | |||
There was a problem hiding this comment.
Keep Resomi and Hydrakin underwear off until they get their own underwear variants
Their body shapes don't work with undergarments
|
Me getting 30 emails lol. I'll look at it this week. |
|
This pull request has conflicts, please resolve those before we can evaluate the pull request. |


About the PR
End-to-end audit of the 22 playable-species guidebook pages in four coordinated passes.
Step 1 — code fixes (guidebook is authoritative). Prototype mechanics moved to match the dossier numbers players were already reading. Full list in the changelog.
Step 2 — dossier restyle (Bureau of Personnel). All 22 species pages rewritten on the new BuPers template with a randomized paperdoll embed.
Step 3 — lore-doc flavor. Canon-name ORIGINs, Subject paragraph enrichment, and PROVENANCE NOTE blocks on four species with explicit corporate-era context.
Step 4 — paper-doll exemplars + final polish. New
DossierExemplarsystem inContent.Shared/_Triad/Dossier/randomizes HumanoidAppearance and injects species-appropriate undergarment markings. Final-pass cleanup of banner widths, dietary schema, em dashes, and Human de-baselining.Why / Balance
Steps 2-4 are pure UX: same mechanics, more legible setting voice, randomized paper doll, every species page in line with the same template so a player learning a new species sees the same shape every time.
The Step 1 prototype changes are corrective: closes long-standing drift where the guidebook promised one number and the YAML delivered another. Direction of correction was decided per the audit handoff: the guidebook is authoritative (player expectations were already calibrated to the dossier numbers), so the YAML moved. These are under further review and tweaking now that we have a clear picture so don't panic!
Media
Requirements
How to test
Breaking changes
None player-facing. New entities (
Mob<X>DossierExemplar) live in[HideSpawnMenu], so they don't show up in admin spawn menus. The baseMob<X>prototypes are untouched.For downstream forks:
DossierExemplarComponentandDossierExemplarSystemare net-new and live inContent.Shared/_Triad/Dossier/. Inventorydisplacements:behavior unchanged. Step 1 changes alter species balance numbers but no IDs/prototypes are removed.Changelog
🆑