Fix the suite link in the Ward wiki page

It pointed at flan/rimworld-institution -- the local directory name, not the repo. This one is public, so the 404 was facing outward.
Remove README badge wall; drop heading emoji and extra emphasis
2026-09-14 18:25:48 +00:00 · 2026-08-03 23:43:00 +00:00 · 2026-08-03 20:03:18 +00:00 · 2026-08-03 19:28:35 +00:00 · 2026-08-03 19:09:26 +00:00 · 2026-08-03 18:46:24 +00:00
84 changed files with 6347 additions and 74 deletions
@@ -0,0 +1,6 @@
 obj/
 bin/
 *.user
 # The assembled drop-in ships from this repo: the vendored Assemblies/ and Defs/ are committed so
 # the repo IS a complete, installable mod. Re-sync them with Tools/package.sh after changing a layer.
@@ -0,0 +1,44 @@
 <?xml version="1.0" encoding="utf-8"?>
 <ModMetaData>
  <packageId>flan.institution</packageId>
  <name>Institution</name>
  <author>flan</author>
  <url>https://git.arch.fyi/flan/institution/wiki</url>
  <supportedVersions>
    <li>1.6</li>
  </supportedVersions>
  <description>Prison Architect in RimWorld: every pawn has a criminal propensity on a spectrum -- nature (traits) x nurture (mood, mistreatment, treatment) -- and the colony can police it. Catching and punishing ONE pawn changes the disposition of the rest.
 This is the whole Institution suite in one install, mirroring a real justice system -- police, prison, parole -- with a checkbox per layer in the mod settings (all ON by default):
 - Contraband -- the physical smuggling loop. Prisoners conceal what they walk in with, whittle shivs from their cell's own furniture, and dig Prison-Architect tunnels under the wall. Wardens search the right prisoner first, by the record -- and a bent warden looks the other way, or smuggles for them.
 - Policing -- enforcement and order. Your own colonists offend on the propensity spectrum (rarer in a small, tight colony); witnesses and a constable's work name the culprit, and a weighed arrest can end in a cell or a resisted breakout. A climate of order that crime erodes and visible justice restores feeds back into everyone's disposition. Plus prison riots when order collapses.
 - Corrections -- the prison. Classification grades every held pawn by what they have actually done, and a wall-mounted marker grades a whole wing. Discipline hardens or reforms; parole lets the reformed out as free colonists; regime gives prisoners the recreation, yard time, and visits vanilla denies them.
 - Gangs -- the social layer. Disposed pawns band together along the lines they already share and move contraband among themselves; rival gangs fight, inside the wire or out, and the fight is a crime. A well-run colony grows few gangs, if any.
 - Ward -- psychiatric care. Commit a prisoner for treatment instead of punishment: sustained counselling reduces the disorder that broke them and builds a recovery track toward discharge. Neglect a committed patient and they deteriorate.
 Turn any layer off in Options -> Mod Settings and it goes inert immediately. The shared Core engine -- propensity, the criminal record, the treatment engine -- ships inside this mod, so there is no separate dependency to install.
 Requires Harmony. Pairs with the standalone Foul Play (the vessel/substance framework), which bridges in when both are present.
 FULL GUIDE, per-layer detail, and a "what do I do when..." scenario FAQ -- the wiki:
 https://git.arch.fyi/flan/institution/wiki
 Part of the Institution suite.
  </description>
  <modDependencies>
    <li>
      <packageId>brrainz.harmony</packageId>
      <displayName>Harmony</displayName>
      <steamWorkshopUrl>steam://url/CommunityFilePage/2009463077</steamWorkshopUrl>
    </li>
  </modDependencies>
  <loadAfter>
    <li>Ludeon.RimWorld</li>
    <li>brrainz.harmony</li>
  </loadAfter>
 </ModMetaData>
@@ -0,0 +1,24 @@
 # Changelog
 Format: [Keep a Changelog](https://keepachangelog.com/en/1.1.0/). Versioning: [SemVer](https://semver.org/spec/v2.0.0.html).
 ## [0.1.0] - 2026-07-16
 ### Added
 - **Institution** — the aggregate mod. One install bundles the whole suite: the **Core** propensity /
  record engine plus the **Contraband**, **Justice**, and **Gangs** feature layers, each behind its own
  in-game toggle (all on by default). The layers remain modular — the suite can be split back into
  separate mods at any time; this is packaging, not a merge.
 - **Settings panel** — a checkbox per layer:
  - **Contraband** — concealment, search, escape tunnels.
  - **Justice** — classification, deterrence, discipline & reform, parole, regime.
  - **Gangs** — prison contraband economies and social capstone.
  - **Policing** — colony crime and weighed arrests. A large behavioural change, so it carries its own
    switch (on by default): your own colonists commit crimes on the propensity spectrum, and a weighed
    arrest can end in a cell or a resisted breakout.
  Toggling a layer off disables its systems in place, without uninstalling anything.
 ### Notes
 - Requires **Harmony**. The suite's only Harmony-using code is Justice's prisoner-recreation postfix.
 - The standalone **Foul Play** framework bridges into this suite when both are installed.
@@ -0,0 +1,65 @@
 <?xml version="1.0" encoding="utf-8"?>
 <Defs>
  <!--
    The visible reform track, on Core's shared treatment engine (the same one Ward's recovery rides).
    A rehab session advances it; it decays without sustained sessions, so rehabilitation has to be
    kept up. It is a readout and a pressure, not the parole gate itself: parole keys off the reform
    SCORE and the security grade, and the "Ready for parole" alert fires from that.
  -->
  <HediffDef>
    <defName>Institution_Reforming</defName>
    <label>reforming</label>
    <description>This prisoner is being rehabilitated — worked with toward turning a corner. Progress decays without sustained sessions. When they have reformed enough and their security grade is low enough, they can be paroled back into the colony.</description>
    <hediffClass>HediffWithComps</hediffClass>
    <defaultLabelColor>(0.55, 0.85, 0.65)</defaultLabelColor>
    <scenarioCanAdd>false</scenarioCanAdd>
    <maxSeverity>1.0</maxSeverity>
    <isBad>false</isBad>
    <comps>
      <li Class="HediffCompProperties_SeverityPerDay">
        <severityPerDay>-0.08</severityPerDay>
      </li>
    </comps>
    <stages>
      <li>
        <minSeverity>0</minSeverity>
        <label>reforming</label>
      </li>
      <li>
        <minSeverity>0.999</minSeverity>
        <label>reformed</label>
      </li>
    </stages>
  </HediffDef>
  <!--
    The solitary status: a marker that the prisoner is serving a discipline term. It gates the warden
    from re-disciplining while it lasts (roughly two days, decaying), carries the on-edge cost of
    isolation, and shows on the inspect pane. The mood hit itself is the Institution_Disciplined memory.
  -->
  <HediffDef>
    <defName>Institution_InSolitary</defName>
    <label>in solitary</label>
    <description>Held in solitary confinement, privileges revoked, as discipline. Isolation grates: they are closer to the edge, and they will not forget it.</description>
    <hediffClass>HediffWithComps</hediffClass>
    <defaultLabelColor>(0.7, 0.5, 0.5)</defaultLabelColor>
    <scenarioCanAdd>false</scenarioCanAdd>
    <maxSeverity>1.0</maxSeverity>
    <isBad>true</isBad>
    <comps>
      <li Class="HediffCompProperties_SeverityPerDay">
        <severityPerDay>-0.5</severityPerDay>
      </li>
    </comps>
    <stages>
      <li>
        <minSeverity>0</minSeverity>
        <statOffsets>
          <MentalBreakThreshold>0.05</MentalBreakThreshold>
        </statOffsets>
      </li>
    </stages>
  </HediffDef>
 </Defs>
@@ -0,0 +1,27 @@
 <?xml version="1.0" encoding="utf-8"?>
 <Defs>
  <!-- Distinct defNames from the interaction modes: [DefOf] binds by name, so a job and a mode that
       shared one name could not both be reached. -->
  <JobDef>
    <defName>Institution_RehabilitateJob</defName>
    <driverClass>Institution.JobDriver_Rehabilitate</driverClass>
    <reportString>rehabilitating TargetA.</reportString>
    <casualInterruptible>false</casualInterruptible>
  </JobDef>
  <JobDef>
    <defName>Institution_ParoleJob</defName>
    <driverClass>Institution.JobDriver_Parole</driverClass>
    <reportString>paroling TargetA.</reportString>
    <casualInterruptible>false</casualInterruptible>
  </JobDef>
  <JobDef>
    <defName>Institution_DisciplineJob</defName>
    <driverClass>Institution.JobDriver_Discipline</driverClass>
    <reportString>disciplining TargetA.</reportString>
    <casualInterruptible>false</casualInterruptible>
  </JobDef>
 </Defs>
@@ -0,0 +1,11 @@
 <?xml version="1.0" encoding="utf-8"?>
 <Defs>
  <JobDef>
    <defName>Institution_Investigate</defName>
    <driverClass>Institution.JobDriver_Investigate</driverClass>
    <reportString>investigating a crime scene.</reportString>
    <casualInterruptible>true</casualInterruptible>
  </JobDef>
 </Defs>
@@ -0,0 +1,134 @@
 <?xml version="1.0" encoding="utf-8"?>
 <Defs>
  <!--
    The "locked cabinet of sedatives" in the treatment station's description, made real. Sedation is
    the other lever a ward has: not therapy, but a way to buy calm through a crisis. It costs a dose
    and a groggy, useless day from the patient — it settles a breakdown, it does not treat what
    causes them. A warden administers one to a patient at the edge of a break.
  -->
  <ThingDef ParentName="ResourceBase">
    <defName>Ward_Sedative</defName>
    <label>sedative</label>
    <description>A measured dose of fast-acting sedative. A warden can administer one to a patient on the edge of a breakdown to buy calm — at the cost of a groggy, near-useless day. It settles a crisis; it does not treat one.</description>
    <graphicData>
      <!-- Placeholder: reuse vanilla industrial medicine's art until Ward ships its own. -->
      <texPath>Things/Item/Resource/Medicine/MedicineIndustrial</texPath>
      <graphicClass>Graphic_StackCount</graphicClass>
    </graphicData>
    <stackLimit>25</stackLimit>
    <healthAffectsPrice>false</healthAffectsPrice>
    <statBases>
      <MarketValue>14</MarketValue>
      <Mass>0.05</Mass>
      <Flammability>0.7</Flammability>
      <DeteriorationRate>2</DeteriorationRate>
    </statBases>
    <thingCategories>
      <li>Medicine</li>
    </thingCategories>
    <tradeTags>
      <li>Medicine</li>
    </tradeTags>
  </ThingDef>
  <RecipeDef>
    <defName>Ward_MakeSedative</defName>
    <label>make sedatives</label>
    <description>Synthesize a batch of sedatives from neutroamine.</description>
    <jobString>Making sedatives.</jobString>
    <workAmount>800</workAmount>
    <workSpeedStat>DrugSynthesisSpeed</workSpeedStat>
    <effectWorking>Cook</effectWorking>
    <soundWorking>Recipe_Drug</soundWorking>
    <workSkill>Intellectual</workSkill>
    <ingredients>
      <li>
        <filter>
          <thingDefs>
            <li>Neutroamine</li>
          </thingDefs>
        </filter>
        <count>1</count>
      </li>
    </ingredients>
    <fixedIngredientFilter>
      <thingDefs>
        <li>Neutroamine</li>
      </thingDefs>
    </fixedIngredientFilter>
    <products>
      <Ward_Sedative>4</Ward_Sedative>
    </products>
    <recipeUsers>
      <li>DrugLab</li>
    </recipeUsers>
    <researchPrerequisite>DrugProduction</researchPrerequisite>
  </RecipeDef>
  <!--
    The sedated state: very calm (a large negative break-threshold offset = breaks far less), but
    groggy and barely productive, and gone in about a day. Deliberately a bad hediff — it is a crutch
    with a cost, not free stability.
  -->
  <HediffDef>
    <defName>Ward_Sedated</defName>
    <label>sedated</label>
    <description>Dosed with a sedative. Very unlikely to break — and too groggy to do much of anything.</description>
    <hediffClass>HediffWithComps</hediffClass>
    <defaultLabelColor>(0.6, 0.6, 0.9)</defaultLabelColor>
    <scenarioCanAdd>false</scenarioCanAdd>
    <isBad>true</isBad>
    <maxSeverity>1.0</maxSeverity>
    <comps>
      <!-- About one in-game day from a full dose to nothing. -->
      <li Class="HediffCompProperties_SeverityPerDay">
        <severityPerDay>-1.0</severityPerDay>
      </li>
    </comps>
    <stages>
      <li>
        <statOffsets>
          <!-- Negative = breaks at a much lower mood = breaks far less. -->
          <MentalBreakThreshold>-0.40</MentalBreakThreshold>
        </statOffsets>
        <capMods>
          <li>
            <capacity>Consciousness</capacity>
            <offset>-0.25</offset>
          </li>
          <li>
            <capacity>Moving</capacity>
            <offset>-0.15</offset>
          </li>
        </capMods>
      </li>
    </stages>
  </HediffDef>
  <!--
    A NEW warden work-giver, above treatment in priority: a crisis pre-empts a counselling session.
    Like the treatment giver it inherits WorkGiver_Warden.ShouldSkip, so it respects prison-commons
    areas for free.
  -->
  <WorkGiverDef>
    <defName>Ward_WardenAdministerSedative</defName>
    <label>administer sedative</label>
    <giverClass>Ward.WorkGiver_Warden_Sedate</giverClass>
    <workType>Warden</workType>
    <verb>sedate</verb>
    <gerund>sedating</gerund>
    <priorityInType>90</priorityInType>
    <requiredCapacities>
      <li>Manipulation</li>
    </requiredCapacities>
  </WorkGiverDef>
  <JobDef>
    <defName>Ward_AdministerSedative</defName>
    <driverClass>Ward.JobDriver_AdministerSedative</driverClass>
    <reportString>administering a sedative to TargetA.</reportString>
    <casualInterruptible>false</casualInterruptible>
  </JobDef>
 </Defs>
@@ -0,0 +1,24 @@
 <?xml version="1.0" encoding="utf-8"?>
 <Defs>
  <!--
    The Yard/Lockup schedule blocks. They show in the Restrict tab for any pawn that HAS a timetable;
    vanilla prisoners do not, so this pairs with Prison Labor (which gives prisoners a timetable). Yard
    allows recreation, so with the prisoner Joy need enabled the held head out to a rec area; Lockup
    denies it and confines them to the cell. MapComponent_Lockup adds the mood cost of being locked up.
  -->
  <TimeAssignmentDef>
    <defName>Institution_Yard</defName>
    <label>yard</label>
    <color>(74, 138, 90)</color>
  </TimeAssignmentDef>
  <TimeAssignmentDef>
    <defName>Institution_Lockup</defName>
    <label>lockup</label>
    <color>(120, 70, 70)</color>
    <allowJoy>false</allowJoy>
    <allowRest>true</allowRest>
  </TimeAssignmentDef>
 </Defs>
@@ -0,0 +1,35 @@
 <?xml version="1.0" encoding="utf-8" ?>
 <Defs>
  <JobDef>
    <defName>Contraband_SearchPawn</defName>
    <driverClass>Institution.JobDriver_SearchPawn</driverClass>
    <reportString>searching TargetA.</reportString>
  </JobDef>
  <!--
    A NEW WorkGiver class, not a patch on a vanilla one. That is what keeps this mod out of a
    fight with the rest of the prison ecosystem:
      - Custom Prisoner Interactions patches the NAMED vanilla warden givers (_Chat, _Convert,
        _Enslave, _ReleasePrisoner). It cannot see this one.
      - Prison Commons postfixes WorkGiver_Warden.ShouldSkip on the BASE class, which this
        inherits and does not override, so searches respect prison-commons areas for free.
    Priority sits below feeding: a starving prisoner matters more than a hidden shiv.
  -->
  <WorkGiverDef>
    <defName>Contraband_WardenSearch</defName>
    <label>search prisoners for contraband</label>
    <giverClass>Institution.WorkGiver_Warden_Search</giverClass>
    <workType>Warden</workType>
    <verb>search</verb>
    <gerund>searching</gerund>
    <priorityInType>40</priorityInType>
    <requiredCapacities>
      <li>Manipulation</li>
      <li>Sight</li>
    </requiredCapacities>
  </WorkGiverDef>
 </Defs>
@@ -0,0 +1,165 @@
 <?xml version="1.0" encoding="utf-8"?>
 <Defs>
  <!--
    The warden's job. This is a NEW WorkGiver class, which is the reason Ward survives contact
    with the prison-mod ecosystem:
      - Custom Prisoner Interactions patches the named vanilla warden givers (_Chat, _Convert,
        _Enslave, _ReleasePrisoner). It cannot see this one, so it cannot break it.
      - Prison Commons patches WorkGiver_Warden.ShouldSkip on the BASE class. Ward inherits
        from WorkGiver_Warden and does not override ShouldSkip, so Ward's warden work respects
        prison-commons areas for free, without Ward knowing Prison Commons exists.
  -->
  <WorkGiverDef>
    <defName>Ward_WardenPsychiatricCare</defName>
    <label>provide psychiatric care</label>
    <giverClass>Ward.WorkGiver_Warden_PsychiatricCare</giverClass>
    <workType>Warden</workType>
    <verb>treat</verb>
    <gerund>treating</gerund>
    <!-- Above chat (60) and below feeding: an untreated patient deteriorates, a bored one doesn't. -->
    <priorityInType>70</priorityInType>
    <requiredCapacities>
      <li>Talking</li>
      <li>Hearing</li>
    </requiredCapacities>
  </WorkGiverDef>
  <!-- Distinct from the PrisonerInteractionModeDef's defName: [DefOf] binds fields to defNames
       by name, so two defs sharing one name cannot both be reached from a DefOf class. -->
  <JobDef>
    <defName>Ward_ProvidePsychiatricCare</defName>
    <driverClass>Ward.JobDriver_PsychiatricCare</driverClass>
    <reportString>treating TargetA.</reportString>
    <casualInterruptible>false</casualInterruptible>
  </JobDef>
  <!--
    What treatment actually buys the patient: a lower chance of breaking. Severity decays, so
    an untreated patient slides back. This is the entire feedback loop: treat them and they
    stabilise, neglect them and they don't.
  -->
  <HediffDef>
    <defName>Ward_UnderTreatment</defName>
    <label>under psychiatric care</label>
    <description>This person is receiving regular counselling. They are less likely to suffer a mental break.</description>
    <hediffClass>HediffWithComps</hediffClass>
    <defaultLabelColor>(0.6, 0.8, 0.9)</defaultLabelColor>
    <scenarioCanAdd>false</scenarioCanAdd>
    <maxSeverity>1.0</maxSeverity>
    <isBad>false</isBad>
    <comps>
      <!-- Roughly a week from a full course back to nothing, with no wardens attending. -->
      <li Class="HediffCompProperties_SeverityPerDay">
        <severityPerDay>-0.15</severityPerDay>
      </li>
    </comps>
    <stages>
      <li>
        <minSeverity>0</minSeverity>
        <statOffsets>
          <!-- Negative offset = breaks at a LOWER mood = breaks less often. -->
          <MentalBreakThreshold>-0.10</MentalBreakThreshold>
        </statOffsets>
      </li>
    </stages>
  </HediffDef>
  <ThoughtDef>
    <defName>Ward_Counselled</defName>
    <thoughtClass>Thought_Memory</thoughtClass>
    <durationDays>2</durationDays>
    <stackLimit>3</stackLimit>
    <stages>
      <li>
        <label>counselled</label>
        <description>Someone sat with me and listened. It helped, a little.</description>
        <baseMoodEffect>6</baseMoodEffect>
      </li>
    </stages>
  </ThoughtDef>
  <!--
    The other half of the design. A ward you do not staff is not a neutral place to keep
    someone. It is a worse one. Held under psychiatric care and left untreated, the patient
    resents it, which pushes them back toward the break that got them committed.
  -->
  <ThoughtDef>
    <defName>Ward_Neglected</defName>
    <thoughtClass>Thought_Memory</thoughtClass>
    <durationDays>3</durationDays>
    <stackLimit>4</stackLimit>
    <stages>
      <li>
        <label>left in the ward</label>
        <description>They locked me in here for my own good and then forgot about me.</description>
        <baseMoodEffect>-8</baseMoodEffect>
      </li>
    </stages>
  </ThoughtDef>
  <!--
    Recovery: the arc that turns commitment from a one-way park into a treatment with an ending.
    It only advances once the patient has no treatable condition left (see the job) and, like
    everything here, decays without sustained attention. When it reaches the "stabilised" stage the
    discharge alert fires: the patient is well enough to let go.
  -->
  <HediffDef>
    <defName>Ward_Recovery</defName>
    <label>recovering</label>
    <description>This person has worked through what they were committed for and is stabilising. Once fully recovered they can safely be discharged — held longer, they will start to resent it.</description>
    <hediffClass>HediffWithComps</hediffClass>
    <defaultLabelColor>(0.55, 0.85, 0.65)</defaultLabelColor>
    <scenarioCanAdd>false</scenarioCanAdd>
    <maxSeverity>1.0</maxSeverity>
    <isBad>false</isBad>
    <comps>
      <!-- Recovery has to be sustained too: a couple of days of no attention and it slips back. -->
      <li Class="HediffCompProperties_SeverityPerDay">
        <severityPerDay>-0.10</severityPerDay>
      </li>
    </comps>
    <stages>
      <li>
        <minSeverity>0</minSeverity>
        <label>on the mend</label>
      </li>
      <li>
        <minSeverity>0.999</minSeverity>
        <label>stabilised</label>
      </li>
    </stages>
  </HediffDef>
  <!-- Applied as recovery progresses: the patient can feel it working. -->
  <ThoughtDef>
    <defName>Ward_Recovering</defName>
    <thoughtClass>Thought_Memory</thoughtClass>
    <durationDays>2</durationDays>
    <stackLimit>3</stackLimit>
    <stages>
      <li>
        <label>on the mend</label>
        <description>Whatever was wrong with me, it's easing. I think I might be getting better.</description>
        <baseMoodEffect>4</baseMoodEffect>
      </li>
    </stages>
  </ThoughtDef>
  <!-- A breakthrough: the rare day the work pays off all at once. -->
  <ThoughtDef>
    <defName>Ward_Breakthrough</defName>
    <thoughtClass>Thought_Memory</thoughtClass>
    <durationDays>5</durationDays>
    <stackLimit>1</stackLimit>
    <stages>
      <li>
        <label>a breakthrough</label>
        <description>Something finally shifted. For the first time in a long while, I feel like myself.</description>
        <baseMoodEffect>10</baseMoodEffect>
      </li>
    </stages>
  </ThoughtDef>
 </Defs>
@@ -0,0 +1,42 @@
 <?xml version="1.0" encoding="utf-8"?>
 <Defs>
  <!--
    Two non-exclusive prisoner modes, exactly the shape Ward's psychiatric-care mode uses (and Prison
    Labor's seven). Non-exclusive so they STACK: set Rehabilitate to run the reform programme, and
    Parole so a warden releases them the moment they are eligible; or set Rehabilitate alone and
    parole by hand when the alert fires.
  -->
  <PrisonerInteractionModeDef>
    <defName>Institution_Rehabilitate</defName>
    <label>rehabilitate</label>
    <listOrder>120</listOrder>
    <isNonExclusiveInteraction>true</isNonExclusiveInteraction>
    <mustBeAwake>false</mustBeAwake>
    <allowOnWildMan>false</allowOnWildMan>
    <allowInClassicIdeoMode>true</allowInClassicIdeoMode>
  </PrisonerInteractionModeDef>
  <PrisonerInteractionModeDef>
    <defName>Institution_Parole</defName>
    <label>parole when reformed</label>
    <listOrder>210</listOrder>
    <isNonExclusiveInteraction>true</isNonExclusiveInteraction>
    <mustBeAwake>false</mustBeAwake>
    <allowOnWildMan>false</allowOnWildMan>
    <allowInClassicIdeoMode>true</allowInClassicIdeoMode>
  </PrisonerInteractionModeDef>
  <!-- Punishment-as-order: solitary / privilege revocation. Harsh, so it holds order but hardens the
       punished (reform falls). Non-exclusive, and it fires at most once per term (see the workgiver). -->
  <PrisonerInteractionModeDef>
    <defName>Institution_Discipline</defName>
    <label>discipline</label>
    <listOrder>130</listOrder>
    <isNonExclusiveInteraction>true</isNonExclusiveInteraction>
    <mustBeAwake>false</mustBeAwake>
    <allowOnWildMan>false</allowOnWildMan>
    <allowInClassicIdeoMode>true</allowInClassicIdeoMode>
  </PrisonerInteractionModeDef>
 </Defs>
@@ -0,0 +1,31 @@
 <?xml version="1.0" encoding="utf-8"?>
 <Defs>
  <!--
    The whole mod hangs off this def.
    RimWorld.GuestStatus is a compiled 3-value enum (Guest / Prisoner / Slave). A mod cannot
    add a fourth. That is exactly why Hospitality carries ~74 Harmony patches: it wants a pawn
    who is in your colony but is not your colonist, the enum has no slot for one, so it keeps a
    shadow guest system alive by patching bed validity, allowed areas and the work JobGiver.
    Ward does not pay that tax. A committed pawn IS a prisoner in vanilla's own sense of the
    word. Arresting your own colonist already performs the colonist to prisoner transition.
    All Ward adds is a new *mode* to hold them under, and PrisonerInteractionModeDef is a Def,
    not an enum. Prison Labor already proves this works: it ships seven of them.
    Non-exclusive, so it stacks rather than competing for the radio button. That is what lets
    Ward coexist with Prison Labor's work modes and with Custom Prisoner Interactions instead
    of fighting them for the same slot.
  -->
  <PrisonerInteractionModeDef>
    <defName>Ward_PsychiatricCare</defName>
    <label>psychiatric care</label>
    <listOrder>150</listOrder>  <!-- between ReduceResistance (100) and Release (200) -->
    <isNonExclusiveInteraction>true</isNonExclusiveInteraction>
    <mustBeAwake>false</mustBeAwake>
    <allowOnWildMan>false</allowOnWildMan>
    <allowInClassicIdeoMode>true</allowInClassicIdeoMode>
  </PrisonerInteractionModeDef>
 </Defs>
@@ -0,0 +1,24 @@
 <?xml version="1.0" encoding="utf-8"?>
 <Defs>
  <!--
    RoomRoleDef.workerClass is a public field, so a new room role is XML plus one worker class
    and zero patches. Vanilla already ships PrisonCell, PrisonBarracks and Hospital on exactly
    this rail; the ward is the fourth sibling.
    The score has to beat PrisonCell's, or a ward full of prisoner beds just reads as a cell.
    RoomRoleWorker_PsychWard only scores at all when a treatment station is present, so an
    ordinary prison cell is untouched and keeps its vanilla role.
  -->
  <RoomRoleDef>
    <defName>Ward_PsychWard</defName>
    <label>psychiatric ward</label>
    <workerClass>Ward.RoomRoleWorker_PsychWard</workerClass>
    <relatedStats>
      <li>Impressiveness</li>
      <li>Cleanliness</li>
      <li>Space</li>
    </relatedStats>
  </RoomRoleDef>
 </Defs>
@@ -0,0 +1,51 @@
 <?xml version="1.0" encoding="utf-8"?>
 <Defs>
  <!--
    The security marker: a wall placard that grades the WING it stands in (Minimum..Supermax). One
    marker covers a whole cell block — a prisoner takes the grade of the nearest marker within range,
    so you tag a block's corridor once rather than cluttering every small cell. Classification then
    warns when a prisoner is held in a wing too weak for their grade. Wall-mounted, so it costs no
    floor space.
  -->
  <ThingDef ParentName="BuildingBase">
    <defName>Institution_SecurityMarker</defName>
    <label>security marker</label>
    <description>A steel wall placard that grades its security wing, from Minimum to Supermax — set with the button on it. One marker covers a whole cell block: a prisoner takes the grade of the nearest marker in range. The colony's classification then warns you when a prisoner is held in a wing too weak to hold them, so you can move them before they walk out.</description>
    <thingClass>Building</thingClass>
    <graphicData>
      <texPath>Things/Building/Justice/SecurityMarker</texPath>
      <graphicClass>Graphic_Single</graphicClass>
      <drawSize>(1,1)</drawSize>
    </graphicData>
    <altitudeLayer>BuildingOnTop</altitudeLayer>
    <passability>Standable</passability>
    <fillPercent>0</fillPercent>
    <rotatable>false</rotatable>
    <selectable>true</selectable>
    <statBases>
      <MaxHitPoints>60</MaxHitPoints>
      <WorkToBuild>400</WorkToBuild>
      <Flammability>0.5</Flammability>
      <Beauty>0</Beauty>
    </statBases>
    <size>(1,1)</size>
    <costList>
      <Steel>15</Steel>
    </costList>
    <comps>
      <li Class="Institution.CompProperties_SecurityGrade" />
    </comps>
    <building>
      <isEdifice>false</isEdifice>
      <isAttachment>true</isAttachment>
      <ai_chillDestination>false</ai_chillDestination>
    </building>
    <placeWorkers>
      <li>Placeworker_AttachedToWall</li>
    </placeWorkers>
    <designationCategory>Security</designationCategory>
    <terrainAffordanceNeeded>Light</terrainAffordanceNeeded>
  </ThingDef>
 </Defs>
@@ -0,0 +1,52 @@
 <?xml version="1.0" encoding="utf-8"?>
 <Defs>
  <!--
    The thing that turns a room full of prisoner beds into a ward rather than a cell block.
    It is deliberately cheap: the cost of a ward is not the furniture, it is the warden hours
    and the labour you give up by not putting the patient to work.
  -->
  <ThingDef ParentName="BuildingBase">
    <defName>Ward_TreatmentStation</defName>
    <label>treatment station</label>
    <description>A desk, a chair bolted to the floor, and a locked cabinet of sedatives. A warden set to psychiatric care will use it to counsel patients held in this room.\n\nA room containing one is treated as a psychiatric ward rather than a prison cell. Whether that is a mercy depends entirely on how you run it.</description>
    <thingClass>Building</thingClass>
    <graphicData>
      <texPath>Things/Building/Ward/TreatmentStation</texPath>
      <!-- Single, not Multi: one texture, no _north/_east/_south/_west set to keep in sync. -->
      <graphicClass>Graphic_Single</graphicClass>
      <drawSize>(2,1)</drawSize>
      <damageData>
        <rect>(0,0.05,2,0.9)</rect>
      </damageData>
    </graphicData>
    <castEdgeShadows>true</castEdgeShadows>
    <altitudeLayer>Building</altitudeLayer>
    <passability>PassThroughOnly</passability>
    <pathCost>60</pathCost>
    <blockWind>false</blockWind>
    <fillPercent>0.4</fillPercent>
    <statBases>
      <MaxHitPoints>120</MaxHitPoints>
      <WorkToBuild>1600</WorkToBuild>
      <Flammability>1.0</Flammability>
      <Beauty>0</Beauty>
    </statBases>
    <size>(2,1)</size>
    <costList>
      <Steel>40</Steel>
      <MedicineIndustrial>2</MedicineIndustrial>
    </costList>
    <researchPrerequisites>
      <li>MedicineProduction</li>
    </researchPrerequisites>
    <designationCategory>Misc</designationCategory>
    <rotatable>true</rotatable>
    <selectable>true</selectable>
    <terrainAffordanceNeeded>Light</terrainAffordanceNeeded>
    <building>
      <ai_chillDestination>false</ai_chillDestination>
    </building>
  </ThingDef>
 </Defs>
@@ -0,0 +1,41 @@
 <?xml version="1.0" encoding="utf-8" ?>
 <Defs>
  <!--
    A crude pick, filed the same way a shiv is: off the cell's own furniture, over quiet days, the
    damage to the source the visible tell. Where the shiv is a weapon, this is a way OUT: its whole
    purpose is the tunnel (escapeWorker), so it carries no weapon stats and is never equipped.
    A finished pick starts a Prison-Architect dig: the holder tunnels under the ground and everything
    on it toward the nearest wilderness, surfacing beyond the perimeter wall or fence. The dig itself
    is a second secret; a warden's cell search can turn it up, and the deeper the shaft the harder it
    is to miss. It works for any held pawn (prisoner, ward patient, slave) because the disposition
    to dig, not a prison-only mental break, is what drives it.
  -->
  <ThingDef ParentName="ResourceBase">
    <defName>CB_DiggingTool</defName>
    <label>crude pick</label>
    <description>A stubby digging pick filed off a bed frame, its point hardened in a cell wall. Useless as a weapon and useless above ground -- but pointed downward, patiently, it is a way out that no lock and no guard can see.</description>
    <techLevel>Neolithic</techLevel>
    <graphicData>
      <texPath>Things/Item/Contraband/CrudePick</texPath>
      <graphicClass>Graphic_Single</graphicClass>
    </graphicData>
    <statBases>
      <MaxHitPoints>60</MaxHitPoints>
      <Mass>1.2</Mass>
      <Beauty>-4</Beauty>
      <DeteriorationRate>2.0</DeteriorationRate>
    </statBases>
    <stackLimit>1</stackLimit>
    <comps>
      <li Class="Institution.CompProperties_Contraband">
        <concealability>0.5</concealability>
        <hideIn>InCell</hideIn>
        <acquireWorker>Institution.AcquireWorker_Improvise</acquireWorker>
        <escapeWorker>Institution.EscapeTunnelWorker</escapeWorker>
      </li>
    </comps>
  </ThingDef>
 </Defs>
@@ -0,0 +1,59 @@
 <?xml version="1.0" encoding="utf-8" ?>
 <Defs>
  <!--
    A crude shiv, whittled from whatever the cell was furnished with. Stuffable, so its stats come
    from the harvested material for free: a wood shiv is feeble, a plasteel one is vicious. This is
    the whole point of the harvest-by-damage mechanic: the prison's own construction materials
    become the weapon materials, and a luxury block is a worse idea than it looks.
    Registered as brewable contraband: a held pawn improvises it (AcquireWorker_Improvise), and the
    generic use-during-a-break path equips it (no useWorker; an armed prisoner IS the payload,
    and JobGiver_UseContraband only lets the disposed pick it up).
  -->
  <ThingDef ParentName="BaseMeleeWeapon_Sharp">
    <defName>CB_Shiv</defName>
    <label>shiv</label>
    <description>A blade filed off a bed frame and wrapped in cloth for a grip. Barely a weapon -- but a barely-a-weapon in a cell you thought was empty is a dead guard.</description>
    <techLevel>Neolithic</techLevel>
    <graphicData>
      <texPath>Things/Item/Contraband/Shiv</texPath>  <!-- light greys: stuffable, so the material tint reads -->
      <graphicClass>Graphic_Single</graphicClass>
    </graphicData>
    <stuffCategories>
      <li>Metallic</li>
      <li>Woody</li>
      <li>Stony</li>
    </stuffCategories>
    <costStuffCount>15</costStuffCount>
    <statBases>
      <WorkToMake>1500</WorkToMake>
      <Mass>0.4</Mass>
    </statBases>
    <weaponClasses>
      <li>Melee</li>
    </weaponClasses>
    <comps>
      <li Class="Institution.CompProperties_Contraband">
        <concealability>0.75</concealability>
        <hideIn>OnBody, InCell</hideIn>
        <acquireWorker>Institution.AcquireWorker_Improvise</acquireWorker>
      </li>
    </comps>
    <tools>
      <li>
        <label>point</label>
        <capacities><li>Stab</li></capacities>
        <power>7</power>
        <cooldownTime>1.5</cooldownTime>
      </li>
      <li>
        <label>handle</label>
        <capacities><li>Blunt</li></capacities>
        <power>5</power>
        <cooldownTime>1.6</cooldownTime>
      </li>
    </tools>
  </ThingDef>
 </Defs>
@@ -0,0 +1,107 @@
 <?xml version="1.0" encoding="utf-8"?>
 <Defs>
  <ThoughtDef>
    <defName>Institution_Rehabilitated</defName>
    <thoughtClass>Thought_Memory</thoughtClass>
    <durationDays>2</durationDays>
    <stackLimit>3</stackLimit>
    <stages>
      <li>
        <label>counselled</label>
        <description>Someone sat with me and talked it through. Maybe I can turn this around.</description>
        <baseMoodEffect>5</baseMoodEffect>
      </li>
    </stages>
  </ThoughtDef>
  <ThoughtDef>
    <defName>Institution_Paroled</defName>
    <thoughtClass>Thought_Memory</thoughtClass>
    <durationDays>8</durationDays>
    <stackLimit>1</stackLimit>
    <stages>
      <li>
        <label>paroled</label>
        <description>They gave me a second chance and let me back in. I mean to earn it.</description>
        <baseMoodEffect>12</baseMoodEffect>
      </li>
    </stages>
  </ThoughtDef>
  <ThoughtDef>
    <defName>Institution_ReformNeglected</defName>
    <thoughtClass>Thought_Memory</thoughtClass>
    <durationDays>3</durationDays>
    <stackLimit>4</stackLimit>
    <stages>
      <li>
        <label>left to rot</label>
        <description>They said they would help me change, then forgot I exist. Why should I bother?</description>
        <baseMoodEffect>-6</baseMoodEffect>
      </li>
    </stages>
  </ThoughtDef>
  <ThoughtDef>
    <defName>Institution_Disciplined</defName>
    <thoughtClass>Thought_Memory</thoughtClass>
    <durationDays>3</durationDays>
    <stackLimit>3</stackLimit>
    <stages>
      <li>
        <label>disciplined</label>
        <description>They threw me in solitary. I will not forget it.</description>
        <baseMoodEffect>-8</baseMoodEffect>
      </li>
    </stages>
  </ThoughtDef>
  <!-- Regime: a visitor came. A break from isolation, thematically strongest for a ward patient
       whose family visits. -->
  <ThoughtDef>
    <defName>Institution_Visited</defName>
    <thoughtClass>Thought_Memory</thoughtClass>
    <durationDays>4</durationDays>
    <stackLimit>2</stackLimit>
    <stages>
      <li>
        <label>had a visitor</label>
        <description>Someone came to see me. For a while, the walls felt further away.</description>
        <baseMoodEffect>8</baseMoodEffect>
      </li>
    </stages>
  </ThoughtDef>
  <!-- Regime: kept on the Lockup schedule (confined, no yard). A short recurring memory. -->
  <ThoughtDef>
    <defName>Institution_Confined</defName>
    <thoughtClass>Thought_Memory</thoughtClass>
    <durationDays>0.5</durationDays>
    <stackLimit>3</stackLimit>
    <stages>
      <li>
        <label>locked up</label>
        <description>Confined to my cell, no yard, no company. The walls press in.</description>
        <baseMoodEffect>-4</baseMoodEffect>
      </li>
    </stages>
  </ThoughtDef>
  <!-- Regime: caged with a dangerous cellmate. A short memory refreshed while the danger persists
       and fading once segregated, so it tracks housing rather than piling up. -->
  <ThoughtDef>
    <defName>Institution_Unsafe</defName>
    <thoughtClass>Thought_Memory</thoughtClass>
    <durationDays>0.5</durationDays>
    <stackLimit>2</stackLimit>
    <stages>
      <li>
        <label>unsafe cellmate</label>
        <description>There's a dangerous one caged in here with me. I sleep with one eye open.</description>
        <baseMoodEffect>-5</baseMoodEffect>
      </li>
    </stages>
  </ThoughtDef>
 </Defs>
@@ -0,0 +1,34 @@
 <?xml version="1.0" encoding="utf-8"?>
 <Defs>
  <!-- Crime frays relationships. These are social memories: they lower one pawn's OPINION of another,
       which ripples through the whole social web (mood, recruitment, who will work with whom). Both
       are used only by the policing layer, which is off by default. -->
  <ThoughtDef>
    <defName>Institution_Victimized</defName>
    <durationDays>15</durationDays>
    <thoughtClass>Thought_MemorySocial</thoughtClass>
    <stackLimit>3</stackLimit>
    <stages>
      <li>
        <label>attacked me</label>
        <baseOpinionOffset>-25</baseOpinionOffset>
      </li>
    </stages>
  </ThoughtDef>
  <ThoughtDef>
    <defName>Institution_KnownCriminal</defName>
    <durationDays>30</durationDays>
    <thoughtClass>Thought_MemorySocial</thoughtClass>
    <stackLimit>1</stackLimit>
    <stages>
      <li>
        <label>convicted criminal</label>
        <baseOpinionOffset>-15</baseOpinionOffset>
      </li>
    </stages>
  </ThoughtDef>
 </Defs>
@@ -0,0 +1,49 @@
 <?xml version="1.0" encoding="utf-8"?>
 <Defs>
  <!--
    New WorkGiver subclasses, not patches: they inherit WorkGiver_Warden.ShouldSkip (so they respect
    Prison Commons areas for free) and are invisible to Custom Prisoner Interactions, which only
    patches the named vanilla warden givers.
  -->
  <WorkGiverDef>
    <defName>Institution_WardenRehabilitate</defName>
    <label>rehabilitate prisoner</label>
    <giverClass>Institution.WorkGiver_Warden_Rehabilitate</giverClass>
    <workType>Warden</workType>
    <verb>rehabilitate</verb>
    <gerund>rehabilitating</gerund>
    <priorityInType>65</priorityInType>
    <requiredCapacities>
      <li>Talking</li>
      <li>Hearing</li>
    </requiredCapacities>
  </WorkGiverDef>
  <WorkGiverDef>
    <defName>Institution_WardenParole</defName>
    <label>parole prisoner</label>
    <giverClass>Institution.WorkGiver_Warden_Parole</giverClass>
    <workType>Warden</workType>
    <verb>parole</verb>
    <gerund>paroling</gerund>
    <priorityInType>85</priorityInType>
    <requiredCapacities>
      <li>Talking</li>
    </requiredCapacities>
  </WorkGiverDef>
  <WorkGiverDef>
    <defName>Institution_WardenDiscipline</defName>
    <label>discipline prisoner</label>
    <giverClass>Institution.WorkGiver_Warden_Discipline</giverClass>
    <workType>Warden</workType>
    <verb>discipline</verb>
    <gerund>disciplining</gerund>
    <priorityInType>75</priorityInType>
    <requiredCapacities>
      <li>Moving</li>
    </requiredCapacities>
  </WorkGiverDef>
 </Defs>
@@ -0,0 +1,18 @@
 <?xml version="1.0" encoding="utf-8"?>
 <Defs>
  <WorkGiverDef>
    <defName>Institution_Investigate</defName>
    <label>investigate crimes</label>
    <giverClass>Institution.WorkGiver_Investigate</giverClass>
    <workType>Institution_Investigating</workType>
    <verb>investigate</verb>
    <gerund>investigating</gerund>
    <priorityInType>100</priorityInType>
    <requiredCapacities>
      <li>Manipulation</li>
      <li>Sight</li>
    </requiredCapacities>
  </WorkGiverDef>
 </Defs>
@@ -0,0 +1,22 @@
 <?xml version="1.0" encoding="utf-8"?>
 <Defs>
  <WorkTypeDef>
    <defName>Institution_Investigating</defName>
    <labelShort>police</labelShort>
    <pawnLabel>Constable</pawnLabel>
    <gerundLabel>investigating</gerundLabel>
    <description>Working open crime scenes to gather evidence and identify the culprit.</description>
    <verb>investigate</verb>
    <naturalPriority>455</naturalPriority>
    <relevantSkills>
      <li>Intellectual</li>
      <li>Social</li>
    </relevantSkills>
    <workTags>
      <li>Intellectual</li>
      <li>Social</li>
    </workTags>
  </WorkTypeDef>
 </Defs>
@@ -0,0 +1,24 @@
 Institution
 Copyright (c) 2026 flan
 This work is licensed under the Creative Commons
 Attribution-NonCommercial-ShareAlike 4.0 International License (CC BY-NC-SA 4.0).
 To view a copy of this license, visit:
  https://creativecommons.org/licenses/by-nc-sa/4.0/
 Full legal text:
  https://creativecommons.org/licenses/by-nc-sa/4.0/legalcode
 You are free to:
  - Share  — copy and redistribute the material in any medium or format
  - Adapt  — remix, transform, and build upon the material
 Under the following terms:
  - Attribution  — You must give appropriate credit, provide a link to the
    license, and indicate if changes were made.
  - NonCommercial — You may not use the material for commercial purposes.
  - ShareAlike   — If you remix, transform, or build upon the material, you
    must distribute your contributions under the same license as the original.
 No warranties are given. The license may not give you all of the permissions
 necessary for your intended use (e.g. other rights such as publicity or privacy).
@@ -0,0 +1,12 @@
 <?xml version="1.0" encoding="utf-8" ?>
 <LanguageData>
  <Contraband_Found>{0} searched {1} and found hidden {2}.</Contraband_Found>
  <Contraband_TunnelFound>{0} searched {1} and uncovered a tunnel dug with a hidden {2}.</Contraband_TunnelFound>
  <Contraband_TunnelBreached>{0} has tunnelled out under the perimeter and escaped.</Contraband_TunnelBreached>
  <Contraband_VesselBurst>A {0} has burst under its own pressure.</Contraband_VesselBurst>
  <Contraband_Fermentation>Fermentation: {0}%</Contraband_Fermentation>
  <Contraband_FermentOverdue>Overdue. The pressure has to go somewhere.</Contraband_FermentOverdue>
 </LanguageData>
@@ -0,0 +1,5 @@
 Institution
 Part of the Institution suite for RimWorld 1.6.
 Developed with substantial assistance from Claude (Anthropic).
@@ -0,0 +1,72 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!--
  Soft integration with [RF] Rim Disorders (Continued). The README's whole pitch is that its chronic
  hediffs are Ward's admission criteria; this is what makes that true in the game rather than on
  paper. Each operation is CONDITIONAL on the hediff existing, so the file is a silent no-op when Rim
  Disorders is not loaded — Ward never hard-depends on it.
  Attached only to the clinical, distress-causing conditions: major depression, generalized anxiety,
  PTSD, cleanliness-OCD. Deliberately NOT Autism or ADHD — those are neurotypes, and a ward that
  "treats away" who someone is would be a worse mod, not a more featureful one.
  A player or another mod can opt any hediff in the same way: add the Institution.TreatableConditionExtension extension.
 -->
 <Patch>
  <Operation Class="PatchOperationConditional">
    <xpath>/Defs/HediffDef[defName="MajorDepression"]</xpath>
    <match Class="PatchOperationAdd">
      <xpath>/Defs/HediffDef[defName="MajorDepression"]</xpath>
      <value>
        <modExtensions>
          <li Class="Institution.TreatableConditionExtension">
            <reductionPerSession>0.10</reductionPerSession>
          </li>
        </modExtensions>
      </value>
    </match>
  </Operation>
  <Operation Class="PatchOperationConditional">
    <xpath>/Defs/HediffDef[defName="GeneralizedAnxiety"]</xpath>
    <match Class="PatchOperationAdd">
      <xpath>/Defs/HediffDef[defName="GeneralizedAnxiety"]</xpath>
      <value>
        <modExtensions>
          <li Class="Institution.TreatableConditionExtension">
            <reductionPerSession>0.12</reductionPerSession>
          </li>
        </modExtensions>
      </value>
    </match>
  </Operation>
  <Operation Class="PatchOperationConditional">
    <xpath>/Defs/HediffDef[defName="PTSD"]</xpath>
    <match Class="PatchOperationAdd">
      <xpath>/Defs/HediffDef[defName="PTSD"]</xpath>
      <value>
        <modExtensions>
          <li Class="Institution.TreatableConditionExtension">
            <reductionPerSession>0.08</reductionPerSession>
          </li>
        </modExtensions>
      </value>
    </match>
  </Operation>
  <Operation Class="PatchOperationConditional">
    <xpath>/Defs/HediffDef[defName="COCD"]</xpath>
    <match Class="PatchOperationAdd">
      <xpath>/Defs/HediffDef[defName="COCD"]</xpath>
      <value>
        <modExtensions>
          <li Class="Institution.TreatableConditionExtension">
            <reductionPerSession>0.10</reductionPerSession>
          </li>
        </modExtensions>
      </value>
    </match>
  </Operation>
 </Patch>
@@ -1,61 +1,68 @@
-# The Institution suite
+# Institution — Prison Architect in RimWorld
-A set of RimWorld 1.6 mods about **what an institution does to the people inside it** — and the
+Every pawn has a criminal propensity on a spectrum — nature (traits) × nurture (mood, mistreatment,
-crime, policing, and justice that put them there. Each mod stands alone and requires none of the
+treatment) — and the colony can police it. Catching and punishing one pawn changes the disposition of
-others; together they form one system.
+the rest.
-## The thesis
+Institution is the whole suite in **one install**, with a **checkbox per layer** in the mod settings
 (all on by default). It turns RimWorld's forgotten rap sheet into a living justice system — police,
 prison, parole — mirroring the real separation of powers.
-> Every pawn has a criminal propensity on a spectrum — **nature** (traits) × **nurture**
+## Documentation
 > (circumstance, mood, treatment) — and the colony can **police** it.
-The suite is the two halves of that: colonists commit crimes and a policing layer catches them
+The [Institution wiki](https://git.arch.fyi/flan/institution/wiki) is the full guide: the
-(pre-arrest), and prison / contraband / wards / secure areas hold and reform them (post-arrest).
+gameplay loop, every layer, and how the pieces feed each other. Each layer below links to
-Arrest is the hinge. Nothing hard-codes "prisoner" — every held-person system keys off a
+its wiki page.
 **secured context**: prisoner, ward patient, slave, or secure-area occupant.
-## The mods
+## The six layers
-| Mod | What it is | Status |
+Turn any off in **Options → Mod Settings** and it goes inert immediately. All build on a shared
 **Core** engine that ships inside — no separate dependency.
 | Layer | In play | Wiki |
 |---|---|---|
-| [Foul Play](https://git.onetick.ninja/flan/rimworld-foulplay) | throw a container of something off a body; vessels + substances + the **Piss Nuke** flagship | shipping |
+| **Core** | The engine every layer agrees on: propensity, the criminal record, the treatment engine. Invisible on its own. | [Core](https://git.arch.fyi/flan/institution/wiki/core/Home) |
-| [Institution: Contraband](https://git.onetick.ninja/flan/rimworld-contraband) | conceal / improvise / search / confiscate; intake, escape, secure areas | building |
+| **Contraband** | Prisoners conceal what they walked in with, whittle shivs from their cell's furniture, and dig tunnels under the wall. Wardens search the likeliest prisoner first — and a bent warden looks the other way. | [Contraband](https://git.arch.fyi/flan/institution/wiki/contraband/Home) |
-| [Institution: Ward](https://git.onetick.ninja/flan/rimworld-ward) | involuntary psychiatric commitment — the third pawn state, neither free nor guilty | shipping |
+| **Policing** | Your own colonists offend on the spectrum. Witnesses and a constable name the culprit; a weighed arrest can end in a cell or a resisted breakout. A climate of order feeds back into everyone — plus riots when it collapses. | [Policing](https://git.arch.fyi/flan/institution/wiki/policing/Home) |
-| Institution: Regime | daily schedule (vanilla Restrict) + modest needs + visitation | planned |
+| **Corrections** | Classification grades every prisoner by what they've done (a wall marker grades a whole wing). Discipline hardens or reforms; parole frees the reformed; regime gives them recreation, yard time, and visits. | [Corrections](https://git.arch.fyi/flan/institution/wiki/corrections/Home) |
-| Institution: Justice | the crime loop, the policing officer, parole / discharge / manumission | planned |
+| **Gangs** | Disposed prisoners band together and move contraband among themselves. Rival gangs fight — inside the wire or out — and the fight is a crime. A well-run colony grows few gangs. | [Gangs](https://git.arch.fyi/flan/institution/wiki/gangs/Home) |
-| Institution: Discipline | security classification, punishment-as-order, corruption | planned |
+| **Ward** | Commit a prisoner for **psychiatric treatment** instead of punishment: counselling reduces the disorder that broke them and builds a recovery track toward discharge. Neglect them and they deteriorate. | [Ward](https://git.arch.fyi/flan/institution/wiki/ward/Home) |
 | Institution: Gangs | prisoner & colony gangs, rivalries, contraband networks | planned |
-## Principles
+## The loop
- **Self-complete, dependency-free.** Every mod works alone; none requires another suite mod or any
+Disposition → Crime → Detection → **Arrest** → Contraband / Gangs → Corrections → Parole — and back to
-  third-party mod. Integrations are always `MayRequire`-soft — features light up if a mod is
+the start: reforming or punishing one pawn moves the colony's climate of order, which bends who else
-  present and the loop still closes without it.
+decides that crime pays here. (A future **Judiciary** layer — a court that tries and sentences — is
- **Coexist, don't duplicate.** We test against the all-time most-subscribed Workshop mods and
+reserved to sit between arrest and prison.)
  never rebuild what a genuinely good mod already does well — judged by quality, not sub count.
 - **Extend by capability, not by list.** New content registers via `IsWeapon` / `IsDrug` /
  category, so modded items are covered without being named.
-## The plan
+## Install
-The full design, module scope, build order, and prior-art verdicts are in
+**Steam Workshop:** subscribe, and enable **Harmony** + **Institution** in the mod list. *(Workshop link
-[ROADMAP.md](ROADMAP.md). Per-mod roadmaps live in each repo (e.g. Contraband's item build list).
+coming with the 0.1.0 upload.)*
-## Compatibility
+**Or drop it straight onto your machine** (auto-detects the Steam Mods folder on Linux/Mac):
-The in-game harness (`Tools/run-compat-test.sh` in the Ward repo) boots a real headless RimWorld
+```bash
-with the suite plus the popular psych/prison mods **and** the all-time most-subscribed mods loaded
+D=$(ls -d ~/Library/Application\ Support/Steam/steamapps/common/RimWorld/RimWorldMac.app/Mods \
-at once, and fails on any error naming our code. Combat Extended gets its own dedicated pass. It
+      ~/.steam/steam/steamapps/common/RimWorld/Mods \
-needs a licensed RimWorld + xvfb, so it is a LOCAL step, not CI.
+      ~/.local/share/Steam/steamapps/common/RimWorld/Mods 2>/dev/null | head -1)
 git clone --depth 1 https://git.arch.fyi/flan/institution.git "$D/Institution"
 ```
-## CI
+Update later with `git -C "$D/Institution" pull`.
-Each code repo runs a Gitea Actions workflow (`.gitea/workflows/ci.yml`) on push: **lint def XML**
+## Requires
 (catches malformed XML and relative-xpath silent no-ops) + **dotnet build** against the Krafs
 RimWorld reference assemblies (no game install needed). Runs on the self-hosted `truenas-runner`
 (host mode, label `ubuntu-latest`); .NET is provisioned per-run via `setup-dotnet`. Green across
 Foul Play, Contraband, and Ward.
-## AI disclosure
+**RimWorld 1.6** and **[Harmony](https://steamcommunity.com/sharedfiles/filedetails/?id=2009463077)**.
 Pairs with the standalone **Foul Play** (a vessel/substance framework), which bridges in when both are
 present.
-Designed and built with substantial assistance from Claude (Anthropic).
+---
 **License:** CC BY-NC-SA 4.0 · **Version:** 0.1.0 · Attribution in [NOTICE](NOTICE).
 Modding or curious how it fits together? The design notes live in [ROADMAP.md](ROADMAP.md).
 ## Support
 If you enjoy the Institution suite, consider supporting development via
 [GitHub Sponsors](https://github.com/sponsors/sudolulo) or [Ko-fi](https://ko-fi.com/sudolulo).
@@ -1,7 +1,26 @@
 # The Institution suite — master roadmap
 A set of RimWorld mods about **what an institution does to the people inside it** — and the crime,
-policing, and justice that put them there. Each mod stands alone; together they form one system.
+policing, and justice that put them there. Each mod is a separate install on a shared **Core**;
 together they form one system.
 > **Status (2026-07-16): a six-layer suite behind one install, at 0.1.0.** Along the separation of
 > powers the suite is: **Core** (propensity, criminal record, secured context, the shared treatment
 > engine, the deterrence seam), **Contraband** (the physical smuggling loop), **Policing** (colony
 > crime → investigation → a weighed arrest → the deterrence feedback loop → riots), **Corrections**
 > (classification, discipline & reform, parole, regime), **Gangs** (contraband economies), and **Ward**
 > (psychiatric care). The former **Justice** module was split into **Policing** + **Corrections** and is
 > deprecated/archived. All six bundle into the single **Institution** mod with a toggle each while
 > staying separate repos; **Foul Play** stands alone and bridges in. See the [README](README.md) for the
 > current mod table.
 >
 > The full loop — crime → witnesses → investigate → weighed arrest → contraband/gangs → rehabilitate →
 > parole, on the shared treatment engine — is **wired and harness-verified (45/0)**, and two audit→zero
 > passes plus a headless tuning run are behind it. The shared code namespace is now `Institution` (was
 > `Contraband`). A future **Judiciary** layer (a court: charge → trial → sentence) is reserved as a Core
 > `sentence` seam — no dead code added. What remains before a real release is, above all, **playtesting**
 > to tune the numbers (they are still first guesses) and the Steam Workshop upload. The design sections
 > below predate the split in how they *group* modules, but the mechanics and north star are unchanged.
 ## North star
@@ -48,7 +67,11 @@ afterthoughts.
 - **A. A shared substrate (build FIRST).** One implementation, in Contraband (the central
  framework), that every module reads and writes: a **propensity** stat (nature × nurture, the
-  `Disposition` engine generalized), the **`SecuredContextOf(pawn)`** predicate
+  `Disposition` engine generalized). **Cross-mod merge shipped 2026-07-15:** Foul Play answers "how
  disposed is this pawn" through a `Disposition.Source` seam that defaults to its own light read; when
  Contraband is present, the bridge repoints it at Contraband's full nature×nurture, so the two mods
  never disagree about the same person (harness: `FPBRIDGE propensity.merged = True`). This is the
  substrate principle applied ACROSS mods, not just within one. Also the **`SecuredContextOf(pawn)`** predicate
  (prisoner/ward/slave/zone), and a per-pawn **`CriminalRecord`** (crimes committed, escapes,
  contraband made, reform progress). Without this, each module reinvents "how criminal is this
  pawn" and they disagree — the crime system thinks a pawn is dangerous while classification
@@ -72,19 +95,37 @@ afterthoughts.
 A/B/C are load-bearing; D rounds it out. These are the *wiring*; everything in the module table
 below is the *features* that hang off it.
 **Design constraint (2026-07-15): defer the depth, never the payoff.** The propensity → contraband
 → detection → record *spine* is entirely ours and is self-complete without any third-party mod — it
 is what the suite is *about*, and deferring PR's prisoner-behaviour sims (recidivism, riot,
 solitary-toll, institutionalization, mood-contagion) leaves no hole in it, because none of those sit
 *on* that spine. The one place the deferral could ring hollow solo is the RESPONSE side: Discipline
 and Parole. So each response action must carry its **own minimal self-complete effect** — parole
 gives an immediate faction-goodwill / relationship nudge; discipline revokes privileges with a
 modest mood/record consequence — rather than borrowing PR's deeper toll. That is *not* a rebuild of
 PR (no returning raiders, no 3-tier solitary): it is our own decision having an immediate payoff,
 which PR then *enriches* when present. The test of a healthy deferral: with PR absent the loop still
 *closes* (the decision has an effect); with PR present the effect gets *deeper*, never doubled.
 ## Suite modules
-| Mod | Scope | Status |
+| Layer (repo) | Scope | Status |
 |---|---|---|
-| **Foul Play** | throw a container of something off a body; vessels + substances + Piss Nuke flagship | built |
+| **Core** | propensity, criminal record, secured context, the shared treatment engine, the deterrence seam | **shipped** |
-| **Institution: Contraband** | conceal / improvise / search / confiscate / intake / escape / secure-areas | building |
+| **Contraband** | conceal / improvise / search / confiscate / intake / escape / secure-areas / corruption | **shipped** |
-| **Institution: Ward** | involuntary psychiatric commitment — the third pawn state | built |
+| **Justice** | policing (crime → witnesses → investigate → weighed arrest), classification, deterrence feedback, discipline, parole, rehabilitation, regime | **shipped** |
-| **Institution: Regime** | daily schedule (vanilla Restrict) + modest needs + visitation, for every secured context | planned |
+| **Gangs** | prisoner & colony gangs, rivalries, contraband networks | **shipped** |
-| **Institution: Justice** | the crime loop (commit → discover → investigate → attribute → arrest), policing officer, parole/discharge/manumission | planned |
+| **Ward** | involuntary psychiatric care — the third pawn state, on Core's treatment engine | **shipped** (folded in) |
-| **Institution: Discipline** | security classification / segregation, punishment-as-order, corruption | planned |
+| **Foul Play** | throw a container of something off a body; vessels + substances + Piss Nuke flagship | **shipped** (standalone, bridges in) |
 | **Institution: Gangs** | prisoner & colony gangs, rivalries, contraband networks | planned |
-Seven mods is the ceiling. Prefer folding a slot into an existing module over minting a new one.
+The seven-mod plan became **five layers over Core**: **Regime** and **Discipline** folded into
 **Justice** rather than minting separate mods. Discipline-as-order, classification enforcement (grade
 readout, a dangerous-prisoner alert, and **wing-routing** — a wall-mounted security marker grades a
 whole cell block and flags a prisoner held in a wing too weak for them), cell safety,
 ideology-flavoured parole, visitation, and the **Yard/Lockup schedule** (via Prison Labor's prisoner
 timetable — read, never fought) all ship. **The roadmap's feature list is complete.** What remains is
 not features but **playtesting** — none of the suite is tuned by real play, and that is the single
 largest thing between here and a good release.
 ---
@@ -203,32 +244,156 @@ ideology-driven *decision*, not another timer.
 - **Punishment as a player order.** Issue solitary / lockdown / privilege-revocation as a
  discipline *action*. Distinct from Prisoner Realism's *passive* solitary toll — we add the
  order and its interface; defer the mood consequence to Realism where present.
- **Corruption.** Wardens/guards take bribes, smuggle, or look away — a guard-integrity stat. Seeds
+- **Warden personality & corruption (expanded 2026-07-15).** A search is only as thorough as the
-  the bent-warden contraband supply route already in Contraband's plan.
+  warden running it. Diligence is a function of the warden's **personality** (traits: a Kind or Lazy
  warden frisks gently; an Abrasive or dutiful one turns the cell over) and **circumstance** (mood,
  their relationship to the prisoner, how run-down the prison is). Three faces of the same
  guard-integrity axis, all reading the same warden→prisoner state:
  - **Search intensity.** Personality + circumstance scale find-chance and how often a warden bothers
    — the lax warden misses what the hard-ass finds. (Extends `WorkGiver_Warden_Search` +
    `JobDriver_SearchPawn`'s find roll, which already take Social skill; add the warden's disposition.)
  - **Forgiveness.** A warden may *deliberately overlook* certain items — a sympathetic guard ignores
    a prisoner's smokeleaf, a jar of hooch, a family photo. Per-warden tolerance, per-item, so the
    same contraband survives one guard and not another.
  - **Bent wardens smuggle IN.** A corrupt/bribed/romantically-entangled warden becomes a **supply
    route** — they hand contraband TO a prisoner (the `Conceal` door already noted in Contraband as
    "a bent warden"). This is the corruption payoff and the thing that feeds a Gang's network.
  - **Secure zones are the counter-play.** A search-zone checkpoint frisks *anyone* passing through,
    **guards included** — so a bent warden carrying contraband in can be caught at the door. This
    wires corruption ↔ secure zones (the generalized secure-area search) ↔ the search loop: the same
    `JobDriver_SearchPawn` that turns over a prisoner turns over a guard at a checkpoint.
  Self-complete (reads vanilla traits/mood/relationships); no dependency. This is where the
  contraband loop stops being "the game vs. the player" and becomes "the player's own guards, who
  each have their own angle."
 ---
-## Gangs
+## Gangs — as contraband economies (NOT mood)
-Untouched by any mod. Prisoners (and colonists) form gangs / factions with rivalries that drive
+Re-scoped 2026-07-15: Prisoner Realism's **Ringleader** already owns mood contagion from a dominant
-violence and run contraband networks. Ties to disposition (who joins), contraband (what they move),
+prisoner, and it is good — so we do not touch mood. Our gap is the **contraband network**: prisoners
 (and colonists) form factions that *move contraband* — a supply chain with a supplier, runners, and a
 tax, where segregating rivals (Classification) starves a network and a bent warden (Corruption) feeds
 one. Ties to disposition (who joins), contraband (what they move, the one system PR has nothing like),
 and classification (segregate rivals). The richest, latest module — build after the loop works.
 ---
 ## Build order (fills the meta-gap: don't build it all at once)
-1. **The crime loop core** — discover + witnesses + investigate + attribute. Without it the whole
+1. **The crime loop core** — discover + witnesses + investigate + attribute, applied to **free
   colonists** (the uncontested gap: vanilla+PR already handle prisoner arrest). Without it the whole
   crime thesis is inert. Build *before* individual crime types.
 2. **Regime** — schedule (vanilla Restrict) + one or two modest needs. Cheap, high-value, and it
   feeds the disposition engine (neglect → crime).
 3. **Visitation** — greenfield, thematically strong for the ward, doubles as a contraband route.
-4. **Parole / discharge / manumission** — gives Ward and good behaviour a payoff; ideology-driven.
+4. **Parole / discharge / manumission** — the *release decision*, ideology-driven, PLUS its
-5. **Classification**, then **punishment-orders**, then **corruption**.
+   substrate-native payoffs: **prisonization** (the regime reshapes propensity over the sentence) and
-6. **Gangs** — last; needs the rest in place.
+   **reintegrated-reoffending** (a parolee who joins the colony carries their record and may reoffend).
   PR's departed-raider return layers on top when present. Gives Ward and good behaviour a real payoff.
 5. **Classification** (a router that reads the record + propensity and assigns a tier), then
   **punishment-orders**, then **corruption**.
 6. **Gangs** as contraband economies — last; needs the rest in place.
 Deferred to Prisoner Realism on 2026-07-15 (it owns them, and it is good), as MECHANICS we do not
 rebuild: the isolation toll, mood-contagion gangs, and the departed-prisoner return. We still own the
 substrate-native, differently-axised versions of institutionalization (prisonization) and recidivism
 (reintegrated-reoffending) — the namesake themes — because only our propensity/record engine can.
 Already in flight (Contraband/Foul Play): hooch, improvised weapons, fire-starter, escape tools,
-intake search, secure areas. See [Contraband ROADMAP](https://git.onetick.ninja/flan/rimworld-contraband).
+intake search, secure areas. See [Contraband ROADMAP](https://git.arch.fyi/flan/rimworld-contraband).
 Intake shipped **Harmony-free** (2026-07-15): rather than the planned patch on the contested
 `SetGuestStatus`, it polls from the MapComponent tick that already visits every held pawn — a pawn
 not yet processed is one newly in custody. Keeps Contraband's zero-Harmony core intact and steers
 clear of the method Hospitality/Prison Labor already stack three patches on.
 ### Foul Play — substance system, expanded (2026-07-15)
 The chosen "finish substances" work grew into a full **substance-cocktail** system. Three parts,
 built on the existing `SubstanceDef` (data) + `CompVessel` (delivery) + `CompFerment` split:
 - **Hooch.** A fermentable substance whose harm is **incendiary** — set its `damageDef` to a flame
  def and the framework's own `GenExplosion` splash starts fires (a Molotov), no splash-code change.
  Fermentation makes a *ripe* (high-alcohol) hooch a stronger firebomb — the harm-vs-time axis, but
  running the other way. Also **drinkable** as alcohol (share vanilla `Chemical_Alcohol` if cheap).
 - **Ferment in any liquid-holding furniture, not just toilets.** Generalise to a capability: a
  fermentation SITE is any *building that can hold liquid* — a DBH toilet/tub/sink, a vanilla
  `FermentingBarrel`, a modded vat. Detected by recognizable identity (defName/label vocabulary:
  toilet, barrel, tub, sink, tank, vat, trough, cistern, latrine, urinal, basin) + known vanilla
  defs, **dependency-free**. Hooch *requires* a site (pruno needs a vessel); piss can *use* one for a
  bigger/faster batch but still brews from the body. Fits Foul Play's standing "works with all
  containers" rule.
 - **Mixing — combine any substances.** A vessel's contents become a **blend** of `SubstanceDef`s
  (piss + feces + semen + …), and `SubstanceSplash` applies each one's effects together — caustic +
  disease + humiliation in one throw. "Mix everything": the blend is a runtime list on the vessel,
  defaulting to the def's single substance when unmixed, so every existing vessel still works.
 **Universality principle (2026-07-15): Foul Play is for EVERY pawn; Contraband is the prison lens.**
 Filling a vessel, fermenting it, throwing it, drinking it, and addicting to it are behaviours of *any*
 pawn — colonist, prisoner, slave, raider, visitor — gated by **disposition (propensity)**, never by
 prisoner status. "Not just prisoners fill vessels; any pawn can and will." That is the propensity
 engine (already universal) driving substance behaviour, and it is the mechanics-level expression of
 the whole thesis: every pawn on a spectrum. The prisoner-only concept is **concealment/search**, which
 is Contraband's held-pawn overlay: a prisoner *hides* the vessel they filled as a secret; a free
 colonist just has it. So the prisoner gate lives ONLY on the conceal path (`AcquireWorker`), never on
 the fill/ferment/throw/drink behaviours. A universal "a disposed pawn fills a vessel" job is its own
 piece, separate from the contraband brew that hides the result.
 **Reframed 2026-07-15 (user directive): vessels are GENERIC, contents are RUNTIME.** Hooch is not a
 bespoke item — it 1:1 models piss *except it is flammable*. A vessel is a generic container; what is in
 it (piss, hooch, feces, a blend) is instance state that can be **filled, fermented, poured between
 vessels, drunk, and mixed**. So there is no `FP_Weapon_Hooch`; there is `FP_Hooch` (a substance with a
 `Flame` damageDef) and a `CompVessel` whose `substance` is now runtime. Any fluid is **drinkable with
 different consequences** — a substance carries a *drink outcome* (hooch → alcohol, piss → sickness,
 feces → disease) alongside its *throw* outcome. Staged, each green, piss harness guarding throughout:
  1. **Runtime substance on `CompVessel`** — instance field (default = def's substance), scribed;
     throw/splash/label read it. Vessels become substance-agnostic. (Def names kept to avoid a
     breaking rename; label shows contents at runtime — "jar of hooch".)
  2. **Drink any fluid, with different consequences** — `SubstanceDef.drinkOutcome`; vessels
     ingestible, applying the current substance's consequence (hooch → alcohol high, piss → sickness,
     feces → gut rot, **blood** → nutrition + a disturbing thought / possible disease). Every fluid is
     a valid drink, just a worse or better idea. **Blood is a substance too** — a liquid like any
     other, drinkable and throwable. And **any drink can breed addiction like a drug**: each
     `SubstanceDef` carries an addiction *rarity* (hooch common, most fluids extremely rare), and the
     per-drink roll is modified by mental health + circumstances (a despairing, mistreated pawn
     addicts to things a content one never would) — same nature×nurture spine as propensity.
  3. **Contraband content tag** — a concealed vessel carries a generic content tag (Contraband stays
     ignorant of `SubstanceDef`; the bridge interprets it), so "a hidden jar of hooch" redeems correctly.
  4. **Pour between vessels + mixing** — a blend is a weighted amount-table; splash and drink apply
     every constituent scaled by its share. **Container physics (user spec, 2026-07-15):** vessels
     have a **capacity**; you can only mix into one with **headroom**, and a pour takes only up to
     that (a 50%-full jar of piss + cum poured in = 50/50, filled and no more). `CompVessel.Pour`
     moves liquid between carryable vessels in their current ratios, the destination reacting. STILL
     TO BUILD (the next layer): **furniture containers hold liquid too** (a DBH toilet, a barrel of
     wort) — but a fixed fixture cannot be *tipped*, so you **dip** a small vessel into it (fill the
     carryable from the fixture) rather than pour it out; and **the one pawn action is pouring** —
     a pawn-driven pour/dip job (uses the `Pour` primitive), which is what makes mixing happen in the
     world instead of only in code. This subsumes "ferment in a toilet": a fixture is just a big
     container you dip into.
  5. **Fermentation-model overhaul** — age + top-up dilution + sealed/open + temperature (mirror
     `CompRottable`) + spoil threshold; applies to every vessel, piss included. **[SHIPPED]**
 **Potency model (corrected 2026-07-15): age + storage, NOT container size.** A liquid's potency is a
 function of how long it has fermented and how it is stored (a *sealed* vessel ripens and holds; an
 *open* one ferments differently and loses to evaporation) — never of how big the container is. Size
 already only drives fill-time and blast (VesselProfile), so `CompFerment.Potency` stays age-driven;
 the correction is that **topping up dilutes age**. A shared bucket/carboy that several prisoners keep
 using stays *fresh* (each fresh addition pulls the volume-weighted average age down), while a jar one
 prisoner fills once and hides *ages to full potency*. So "a jar of old piss and a bucket of fresh"
 both make sense — it is the usage pattern, not the vessel, that decides. Implementation: track age as
 a volume-weighted average, diluted on each add; sealed/open scales the ripen rate.
 **Temperature + spoilage (2026-07-15): mirror vanilla food rot.** Fermentation is temperature-driven,
 exactly like meat — warm speeds it, a freezer nearly halts it, and past a point it **spoils** (goes
 from potent to ruined/maximally foul). Rather than invent this, reuse the vanilla mechanic:
 `CompRottable` already tracks temperature-weighted rot progress for food. The ferment model should
 lean on that same curve (or `GenTemperature`-driven accumulation) so "spoils like meat" is literally
 the meat code path — a prisoner's stash left in a hot cell turns fast, one in a cold one keeps. This
 makes the whole substance model a **fermentation-model overhaul** of `CompFerment` (age + dilution +
 sealed/open + temperature + spoil threshold), sequenced AFTER the hooch item ships, since it applies
 to every vessel — piss included — not just hooch.
 ## Compatibility — the non-negotiable
@@ -283,17 +448,78 @@ What this changes vs. a naive "defer to whoever got there first":
 - **Recreation is ours to enable.** Prisoner Recreation (38k) and Prisoner Realism (11k) ship no
  custom need — they just flip on the *vanilla Joy need* for prisoners. We do the same in our
  needs system: idempotent, coexists, zero dependency, no citing.
- **Release-outcome / recidivism** — build a modest self-complete version (reformed → less return;
+- **Recidivism → split by population, don't defer wholesale.** (Revised twice: first "build modest",
-  abused → returns hostile). Prisoner Realism's deeper recidivism coexists; we don't require it.
+  then "defer entirely", now corrected — see the namesake correction in the deep scan below.) PR's
- **Solitary/isolation consequence** — a light version of our own so Discipline is self-complete;
+  Recidivism handles the pawns who **leave** (released/escaped → return ally-or-raider by treatment);
-  Realism's deeper toll coexists.
+  that is good and we do not rebuild it. We own the **mirror**: the paroled pawn who **stays**, joins
- **Escape** is already self-complete: vanilla mental-break breaks + our disposition-driven arming
+  the colony, and can reoffend inside it (their `CriminalRecord` + residual propensity → wiring gap D).
-  + our patient tunnel. Realism's lockpick/ringleaders are enhancements on top, not gaps we leave.
+  Different population, no overlap. The release *decision* stays self-complete (ideology-driven);
  the *reintegrated-reoffending* is ours; the *departed-return* is PR's.
 - **Solitary / isolation toll → DEFER to Prisoner Realism.** PR's Solitary is a full 3-tier
  deterioration hediff with a Ringleader counterplay. Our Classification module does NOT
  reimplement the toll; it is a **router** — it reads the shared record + propensity and *assigns*
  the security tier (including whether to isolate). PR (or vanilla) then supplies the consequence of
  that assignment. Routing is the gap; the isolation sim is not.
 - **Escape** is self-complete: vanilla mental-break breaks + our disposition-driven arming + our
  **contraband-tool wall-cut**, which is scoped precisely to the pawns PR's break system does NOT
  move — chiefly ward patients (never "mood prisoners") and pawns too low-skill to pick a lock. PR
  owns the skilled-lockpick-a-DOOR-during-a-break path; we own the slow-file-through-a-WALL path for
  the calmly-committed. Complementary, not overlapping.
 Genuinely leave alone (giant + redundant + not a gap in our loops): forced labor (Prison Labor
 176k), hygiene (Dubs Bad Hygiene 632k), crime *traits* (Vanilla Traits Expanded 646k — we consume
 them as nature inputs), guest hosting (Hospitality 798k). Coexist with all; depend on none.
 ### Prisoner Realism deep scan (2026-07-15) — the big incumbent, mapped feature-by-feature
 Prisoner Realism (Steam `3760196312`, **11,286 subs / 1,090 favs / 5-star**, published 2026-07-07)
 is the one incumbent large enough to reshape our roadmap. It is a *good* mod (clean documented C#,
 multi-factor balance, defers to other mods where they overlap), so the standing rule says keep it
 and cut our overlaps. Its 20 features and our verdicts:
 | PR feature | What it does | Institution verdict |
 |---|---|---|
 | PrisonBreak rework | MTB scaled by mood/relation/captor/strength | Defer. Our arming rides vanilla/PR breaks. |
 | No-mining / melee breakout | strips sapper-dig; escapees bash doors | Defer. Our wall-cut is a *tool* route, additive. |
 | Keys / Lockpick | skilled prisoner picks a DOOR, fast, no item | Defer. We own file-through-a-WALL for non-break pawns. |
 | Recidivism | released/escaped return ally-or-raider by treatment | Defer PR's mechanic; own the MIRROR — the reintegrated who STAY and reoffend (see below). |
 | Institutionalized | expectation/mood decay + reintegration struggle | Defer the mood axis; own the PROPENSITY axis — prisonization (see below). |
 | Solitary | 3-tier isolation deterioration | Defer the toll; Classification only *routes* to it. |
 | Ringleader | mood contagion from dominant prisoner | Defer. Re-scopes our Gangs to contraband-networks. |
 | Riot | securely-caged-but-miserable → lash out | Defer. |
 | ArrestGrace / ArrestHere | in-place arrest, no immediate bolt | Defer. Our intake (keep-inventory + search) coexists. |
 | Recreation | flips on vanilla Joy for prisoners | We enable the same idempotently (no citing). |
 | Surrender, ForceFeed, RecruitOffer, Despair, Turrets, Cleaning, Carry, BedOwner, Surgery, Commons, AssistedBreak | assorted prisoner-behavior sims | Defer all; coexist. |
 Net effect: **two modules re-scoped** (Classification → pure router; Gangs → contraband economy, not
 mood) and the reintegration module **re-founded on our substrate** (see next). What remains is
 Institution's uncontested core: hidden-contraband + search, propensity across *all* pawns, Ward, Foul
 Play, classification-as-router, and the standout nobody touches — **policing free colonists**.
 #### Namesake correction (2026-07-15): institutionalization & recidivism ARE ours — on a different axis
 "Defer entirely" was an over-correction: in a suite named **Institution**, these are the namesake, and
 our substrate lets us build them on an axis PR structurally cannot, so it is complementary, not a
 rebuild. The rule: **don't duplicate PR's mechanic; own the substrate-native version only we can.**
 - **Institutionalization → prisonization, and it is NOT a new system (2026-07-15).** The lean form:
  `Propensity.Nurture` *already* raises criminal disposition for a badly-kept held pawn, dynamically.
  The only thing incarceration adds is PERMANENCE — an effect that outlasts the sentence — and we
  already have the field for it: `CriminalRecord.reform` (signed: harsh regime → negative/prisonized →
  propensity up; rehabilitative → positive/reformed → propensity down). So prisonization = have the
  EXISTING Nurture read that ONE existing field, which Discipline/Parole write. No parallel mechanic,
  no new stat. And we do **not** patch PR's institutionalization (that would make us depend on a
  one-week-old, fast-moving mod): when PR is present we *soft-read* its hediff as one more Nurture
  input (`MayRequire`, reflective, no patch) — the same additive-not-override posture as the tunnel.
 - **Recidivism → the reintegrated who STAY (not the departed who leave).** PR returns released/escaped
  pawns as allies-or-raiders. We own the mirror population: a paroled pawn who *joins the colony*
  carries their `CriminalRecord` + residual propensity and can **reoffend inside your own walls** —
  wiring gap D, closing the colonist-crime cycle. PR handles who left; we handle who stayed. No overlap.
 These two are also the **self-complete payoffs** for Discipline and Parole (per the "defer the depth,
 never the payoff" constraint above): the regime you run visibly reshapes people, and a badly-reformed
 parolee bites you later — both work with PR absent, and PR's departed-raider return deepens it when present.
 ### Prior-art sweeps done (2026-07-14/15)
 Uncontested gaps, safe to build clean: contraband/search, improvised weapons, keep-inventory
@@ -310,6 +536,3 @@ Zero hard dependencies anywhere: Foul Play stands alone, Contraband is optional
 `LoadFolders` bridge loads only when both are present), Ward stands alone, and every DLC/mod
 tie-in is `MayRequire`. No suite mod requires another suite mod or any third-party mod.
 ## AI disclosure
 Designed and built with substantial assistance from Claude (Anthropic).
@@ -0,0 +1,29 @@
 <Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <TargetFramework>net472</TargetFramework>
    <AssemblyName>Institution</AssemblyName>
    <RootNamespace>InstitutionSuite</RootNamespace>
    <LangVersion>latest</LangVersion>
    <Nullable>disable</Nullable>
    <AppendTargetFrameworkToOutputPath>false</AppendTargetFrameworkToOutputPath>
    <GenerateDependencyFile>false</GenerateDependencyFile>
    <DebugType>none</DebugType>
    <OutputPath>..\..\Assemblies\</OutputPath>
    <CopyLocalLockFileAssemblies>false</CopyLocalLockFileAssemblies>
  </PropertyGroup>
  <!-- The aggregate mod's only own code: a settings shim that writes the player's checkboxes into
       Core's shared InstitutionSettings. The feature DLLs (Contraband/Justice/Gangs) are vendored in
       at package time, not referenced here. Core holds the flags, so this references only Core. -->
  <ItemGroup>
    <PackageReference Include="Microsoft.NETFramework.ReferenceAssemblies" Version="1.0.3" PrivateAssets="all" />
    <PackageReference Include="Krafs.Rimworld.Ref" Version="1.6.4871" ExcludeAssets="runtime" />
    <Reference Include="InstitutionCore">
      <HintPath>$(MSBuildThisFileDirectory)..\..\..\rimworld-core\Assemblies\InstitutionCore.dll</HintPath>
      <Private>false</Private>
    </Reference>
  </ItemGroup>
 </Project>
@@ -0,0 +1,86 @@
 using UnityEngine;
 using Verse;
 namespace InstitutionSuite
 {
    /// <summary>
    /// The single player-facing mod. It bundles the Institution feature layers -- Contraband,
    /// Justice, Gangs, Ward -- into one install with a checkbox per layer, and it owns NO gameplay code of
    /// its own. All it does is read the player's choices and write them into Core's shared
    /// <see cref="Institution.InstitutionSettings"/>, which the feature assemblies (shipped alongside
    /// in this same mod) read at their entry points.
    ///
    /// This is the whole "merge": a thin settings shim on top of the unchanged, still-separate feature
    /// DLLs. Everything defaults ON, so a fresh install is the full experience and the player opts out
    /// of pieces they don't want. Pull this mod apart into its layers again and nothing here is missed
    /// -- the features default their flags to true on their own.
    /// </summary>
    public class InstitutionMod : Mod
    {
        private readonly InstitutionModSettings settings;
        public InstitutionMod(ModContentPack content) : base(content)
        {
            settings = GetSettings<InstitutionModSettings>();
            settings.Apply();   // push the loaded choices into Core before the features' static ctors run
        }
        public override string SettingsCategory() => "Institution";
        public override void DoSettingsWindowContents(Rect inRect)
        {
            Listing_Standard l = new Listing_Standard();
            l.Begin(inRect);
            l.CheckboxLabeled("Contraband",
                ref settings.contraband,
                "Concealment and intake, improvised shivs, Prison-Architect tunnels, warden search, and warden corruption.");
            l.Gap();
            l.CheckboxLabeled("Corrections",
                ref settings.corrections,
                "Classification, discipline and reform, parole, and prisoner recreation (Regime).");
            l.Gap();
            l.CheckboxLabeled("Gangs",
                ref settings.gangs,
                "Gangs as contraband economies: joining by disposition, smuggling networks, rivalry, and fights-as-crime. Leans on Contraband and Corrections.");
            l.Gap();
            l.CheckboxLabeled("Policing (colony crime)",
                ref settings.policing,
                "The enforcement and order layer: your own colonists commit crimes on a spectrum (rarer in small, tight colonies), witnesses and a constable's work name the culprit, and a weighed arrest can end in a cell -- or a resisted breakout. Also owns the deterrence feedback loop and prison riots. A big behavioural change; turn it off to run the rest of the suite without colony crime.");
            l.Gap();
            l.CheckboxLabeled("Ward (psychiatric care)",
                ref settings.ward,
                "Commit a prisoner for treatment instead of punishment: sustained counselling in a proper ward reduces the disorder that broke them and builds a recovery track toward discharge. Neglect a committed patient and they deteriorate. Uses Harmony.");
            l.End();
            settings.Apply();   // live: a toggle takes effect immediately for the gated behaviour
        }
    }
    public class InstitutionModSettings : ModSettings
    {
        public bool contraband = true;
        public bool corrections = true;
        public bool gangs = true;
        public bool policing = true;
        public bool ward = true;
        /// <summary>Mirror the choices into Core's shared flags that every feature reads.</summary>
        public void Apply()
        {
            Institution.InstitutionSettings.contraband = contraband;
            Institution.InstitutionSettings.corrections = corrections;
            Institution.InstitutionSettings.gangs = gangs;
            Institution.InstitutionSettings.policing = policing;
            Institution.InstitutionSettings.ward = ward;
        }
        public override void ExposeData()
        {
            Scribe_Values.Look(ref contraband, "contraband", true);
            Scribe_Values.Look(ref corrections, "corrections", true);
            Scribe_Values.Look(ref gangs, "gangs", true);
            Scribe_Values.Look(ref policing, "policing", true);
            Scribe_Values.Look(ref ward, "ward", true);
            base.ExposeData();
        }
    }
 }
@@ -0,0 +1,87 @@
 # Institution — tuning reference
 The suite's stochastic systems are paced by a handful of constants. This file records, for each,
 the **design intent** (what the rate should feel like in play), the **target band**, the **measured**
 value from the CBTUNE telemetry pass (Gangs `_CompatTest.RunTuning`, full-stack harness), and the
 **verdict**. Re-run the harness and read the `CBTUNE` lines to refresh the measured column.
 Measurement method: the crime and reform rows are *sampled from the real code* (the crime row runs
 the actual `Propensity.Would` roll over 200 in-game days of windows per pawn tier; the reform row
 runs one real `CorrectionsUtility.RunReformSession`). The remaining rows are deterministic — fixed by
 a formula or a tick cadence — so they are recorded, not sampled.
 **Boot of record:** full-stack harness `rimworld-wardcompat.N5Xo2C` — 45 CBTEST True / 0 False,
 0 NotImplementedException, clean watchdog shutdown. **Every measured rate fell inside its
 pre-registered band; no constant was changed.** Two rows carry a WATCH note for real playtest.
 ## Crime — free colonists offending
 `MapComponent_Crime`: every 2500 ticks (24 windows/day) each eligible colonist rolls
 `Propensity.Would(p, 0.02 × CrimeCover, …)`. `CrimeCover = Lerp(0.1, 0.5, (freeColonists−3)/10)` — crime
 rises with colony size (a crowd is cover). `Would` folds in Nature (traits) × Nurture (mood, held,
 reform, deterrence). Design intent: ordinary colonists almost never offend; a dangerous pawn offends
 occasionally; a dangerous **and** mistreated pawn is a near-daily problem you must house, treat, or police.
 | Tier | cover 0.1 (small colony) | cover 0.5 (big colony) | target band (big colony) | verdict |
 |---|---|---|---|---|
 | ordinary (no dark traits) | 0.010 /day | 0.030 /day | < 0.05 /day | ✓ in band |
 | dangerous (psychopath, content) | 0.030 /day | 0.185 /day | 0.10 – 0.40 /day | ✓ in band |
 | powderkeg (dangerous + miserable + held) | 0.205 /day | 1.115 /day | 0.50 – 1.50 /day | ✓ in band |
 Nature/Nurture measured: ordinary & dangerous nurture 0.83 (decent mood, a well-policed colony's
 deterrence pulls below 1); powderkeg nurture 2.89 (floored mood ×2.5, held+unhappy ×1.4, deterrence back).
 The curve is well-shaped across the whole propensity spectrum — no change.
 ## Reform — turning a prisoner around
 `CorrectionsUtility.RunReformSession`: `AdvanceRecovery(0.34 × quality[0.5–1.5] × skillFactor[0.5–1.0])`
 on Core's treatment track, plus `record.reform += 0.10`. Design intent: rehabilitation is a **multi-day
 investment** that needs sustained warden attention and a decent cell — not instant, not a grind.
 | Scenario | measured gain/session | sessions to full | days @ 3 sessions/day | target | verdict |
 |---|---|---|---|---|---|
 | bare cell, social-10 warden (slow end) | 0.165 | 6.1 | 2.0 days | 2 – 5 days | ✓ in band |
 | good cell, skilled warden (fast end, derived) | ~0.51 | ~2 | ~0.7 day | ≥ ~0.5 day | ✓ but quick — **WATCH** |
 WATCH: the luxury fast-end (~0.7 day) is in band but brushes the "multi-day" intent. Left as-is; if
 playtest shows corrections feels like catch-and-release, halve the `0.34` base in `AdvanceRecovery`.
 ## Smuggling supply route
 `MapComponent_Contraband.TickSmuggle`: every 250 ticks (240/day), a held pawn with a non-hostile
 visitor or a corrupt warden (`Corruption ≥ 0.25`) within 3 cells has a `0.05` chance to receive a
 concealed OnBody item via `Corruption.Smuggle`. Design intent: the outside world resupplies the cell
 occasionally — a payoff for visits and a cost of a bent warden — countered by warden searches.
 | Metric | value | note |
 |---|---|---|
 | route yields an OnBody item | **True** (a `MeleeWeapon_Gladius`) | route works; the pool has hideable items |
 | per-check chance | 0.05 | |
 | max items/day **if a smuggler is adjacent all day** | 12.0 | upper bound only; real adjacency is brief (wardens move) |
 | **WATCH** | a full sword passed `OnBodyMassLimit = 2.0` | a smuggled blade is sharper than a shiv; no flood observed, so `0.05` left as-is |
 Realistic estimate (unmeasured — needs a longer sim than the 12000-tick watchdog allows): a bent warden
 is within 3 cells of a prisoner only during warden duties, so ~0.3–0.5 items/day, largely cancelled by
 warden searches (find 0.35–0.95/search). If a longer playtest shows contraband accumulating faster than
 searches clear it, drop `SmuggleChancePerCheck` to 0.02–0.03; the trigger has not fired yet.
 ## Deterministic rates (formula / cadence — recorded, not sampled)
 | System | rate | design intent | verdict |
 |---|---|---|---|
 | Warden search find-chance | 0.35 (social-0) → 0.59 (social-8) → 0.83 (social-16), cap 0.95 | a rookie is leaky, a competent warden finds most | sane |
 | Tunnel escape | 3 – 15 days to breach (normalised to wall distance) | a multi-day project the player can interrupt by finding the shaft | sane |
 | Riot | ≤ 1/day (60000-tick cooldown), only when order < 0.25 | a rare crisis when order collapses, not routine | sane |
 | Gang recruitment | 12 checks/day (5000-tick), only disposition ≥ 0.90 | only the strongly-inclined join, and gradually | sane |
 | Visitation | mean ~9 days between visits per eligible prisoner | occasional flavour + resupply, roughly weekly | sane |
 ## Notes
 - The `ThinkNode_PrioritySorter GetPriority: NotImplementedException` seen at the tail of *some* harness
  logs is a **vanilla** `JobGiver_GetRest.GetPriority` firing during the watchdog's forced shutdown
  (tick 12000), not a suite fault — it never appears during the 0–11999 gameplay ticks, and the boot of
  record above logged **zero** of them. Nondeterministic teardown noise, not a tuning or correctness issue.
 - What a headless harness *cannot* measure: emergent adjacency/occupancy (how often a smuggler is
  actually next to a prisoner), long-horizon reform decay, and player-driven pacing. Those are the real
  remaining playtest questions; the two WATCH rows above are where to look first.
 </content>
@@ -0,0 +1,626 @@
 #!/usr/bin/env python3
 """
 Generate the Institution suite's Workshop Preview.png images. Pure stdlib -- no Pillow, no CUDA,
 no AI/diffusion, nothing ripped. Every pixel is drawn by the code below, exactly like the per-repo
 Tools/make_textures.py sprite generators, so the copyright story stays clean.
    Tools/make_preview.py            # run from anywhere; writes into every sibling repo
 Reuses the same from-scratch machinery the texture generators use: a hand-rolled RGBA PNG writer
 (zlib + struct, see png()) and analytic signed-distance-field shapes supersampled for clean edges
 (see _raster). Nothing beyond the standard library, so it runs on a box with no image tools at all.
 Writes About/Preview.png (640x360, a safe 16:9 Workshop size) into each of:
    rimworld-institution   flagship: a barred cell window over the nature->nurture crime spectrum
    rimworld-core          the invisible engine: a nature x nurture node feeding a 0..1 spectrum bar
    rimworld-contraband    a filed shiv against a brick wall breached by an escape tunnel
    rimworld-justice       a level balance -- the corrections layer weighing what a pawn has done
    rimworld-gangs         a network of pawn tokens, two rival clusters bridged by a contraband line
 They are one SET: shared muted institutional green-grey / tin palette, the same embossed-tin border,
 the same faint grain, and a shared propensity spectrum ribbon (green -> amber -> red) along the
 bottom of every image -- the suite's signature, the spectrum every layer reads from.
 """
 import os
 import zlib
 import struct
 import math
 REPO = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))   # rimworld-institution
 SUITE = os.path.dirname(REPO)                                        # holds all the sibling repos
 W, H = 640, 360
 AS = W / H                      # aspect; everything is normalised by HEIGHT so circles stay round
 SS = int(os.environ.get("SS", "3"))
 # ---------------------------------------------------------------------------
 # PNG encoder + supersampled rasteriser (pure stdlib) -- same as make_textures.py
 # ---------------------------------------------------------------------------
 def png(path, w, h, pixel_fn):
    """Write an 8-bit RGBA PNG from scratch. pixel_fn(x, y) -> (r, g, b, a)."""
    raw = bytearray()
    for y in range(h):
        raw.append(0)                       # filter byte: 0 = None, once per scanline
        row = bytearray()
        for x in range(w):
            r, g, b, a = pixel_fn(x, y)
            row += bytes((r & 255, g & 255, b & 255, a & 255))
        raw += row
    def chunk(typ, data):
        return (struct.pack(">I", len(data)) + typ + data
                + struct.pack(">I", zlib.crc32(typ + data) & 0xffffffff))
    ihdr = struct.pack(">IIBBBBB", w, h, 8, 6, 0, 0, 0)   # 8-bit depth, colour type 6 = RGBA
    idat = zlib.compress(bytes(raw), 9)
    os.makedirs(os.path.dirname(path), exist_ok=True)
    with open(path, "wb") as f:
        f.write(b"\x89PNG\r\n\x1a\n")
        f.write(chunk(b"IHDR", ihdr))
        f.write(chunk(b"IDAT", idat))
        f.write(chunk(b"IEND", b""))
 def _raster(w, h, sample, ss=SS):
    """Wrap an analytic sample(fx, fy) -> (r, g, b, a) into a supersampled pixel_fn."""
    inv = 1.0 / ss
    n = ss * ss
    def pixel(x, y):
        pr = pg = pb = pa = 0.0
        for j in range(ss):
            fy = y + (j + 0.5) * inv
            for i in range(ss):
                r, g, b, a = sample(x + (i + 0.5) * inv, fy)
                if a:
                    af = a * (1.0 / 255.0)
                    pr += r * af
                    pg += g * af
                    pb += b * af
                    pa += af
        if pa <= 1e-6:
            return (0, 0, 0, 0)
        return (_cb(pr / pa), _cb(pg / pa), _cb(pb / pa), _cb(pa / n * 255.0))
    return pixel
 # ---------------------------------------------------------------------------
 # colour + geometry helpers (normalised coords; u in 0..AS, v in 0..1)
 # ---------------------------------------------------------------------------
 def _cb(x):
    x = int(x)
    return 0 if x < 0 else (255 if x > 255 else x)
 def _clamp01(x):
    return 0.0 if x < 0.0 else (1.0 if x > 1.0 else x)
 def _shade(c, f):
    return (_cb(c[0] * f), _cb(c[1] * f), _cb(c[2] * f))
 def _mix(a, b, t):
    return (_cb(a[0] + (b[0] - a[0]) * t),
            _cb(a[1] + (b[1] - a[1]) * t),
            _cb(a[2] + (b[2] - a[2]) * t))
 def _grain(ix, iy):
    """Deterministic faint speckle so fills aren't dead-flat."""
    n = (ix * 374761393 + iy * 668265263) & 0xffffffff
    n ^= (n >> 13)
    n = (n * 1274126177) & 0xffffffff
    return ((n >> 9) & 7) - 3          # -3..+4
 def _grainy(c, u, v):
    g = _grain(int(u * 300), int(v * 300))
    return (_cb(c[0] + g), _cb(c[1] + g), _cb(c[2] + g))
 def _seg(px, py, ax, ay, bx, by):
    """Distance from P to segment AB, and the clamped projection param t in [0, 1]."""
    dx, dy = bx - ax, by - ay
    l2 = dx * dx + dy * dy
    if l2 < 1e-12:
        return math.hypot(px - ax, py - ay), 0.0
    t = ((px - ax) * dx + (py - ay) * dy) / l2
    t = 0.0 if t < 0 else (1.0 if t > 1 else t)
    cx, cy = ax + dx * t, ay + dy * t
    return math.hypot(px - cx, py - cy), t
 def _ellipse(u, v, cx, cy, rx, ry):
    """Approximate signed distance to an ellipse. Negative inside."""
    k = math.hypot((u - cx) / rx, (v - cy) / ry)
    return (k - 1.0) * min(rx, ry)
 def _rrect(u, v, cx, cy, hw, hh, r):
    """Signed distance to a rounded rectangle. Negative inside."""
    qx = abs(u - cx) - (hw - r)
    qy = abs(v - cy) - (hh - r)
    ox = qx if qx > 0 else 0.0
    oy = qy if qy > 0 else 0.0
    return math.hypot(ox, oy) + min(max(qx, qy), 0.0) - r
 def _convex(u, v, pts):
    """Signed distance to a convex polygon (negative inside). Winding-agnostic."""
    n = len(pts)
    cxp = sum(p[0] for p in pts) / n
    cyp = sum(p[1] for p in pts) / n
    dmax = -1e9
    for i in range(n):
        ax, ay = pts[i]
        bx, by = pts[(i + 1) % n]
        ex, ey = bx - ax, by - ay
        L = math.hypot(ex, ey) or 1e-9
        nx, ny = ey / L, -ex / L                 # a normal to the edge
        dp = (u - ax) * nx + (v - ay) * ny
        dc = (cxp - ax) * nx + (cyp - ay) * ny   # which side the interior is on
        if dc > 0:
            dp = -dp
        if dp > dmax:
            dmax = dp
    return dmax
 # ---------------------------------------------------------------------------
 # shared palette -- muted institutional green-grey / tin, dark outline
 # ---------------------------------------------------------------------------
 OUTLINE  = (22, 26, 20)
 BG_TOP   = (56, 64, 55)
 BG_BOT   = (31, 37, 31)
 TIN      = (138, 142, 126)
 TIN_HI   = (178, 182, 162)
 TIN_DK   = (92, 96, 82)
 TIN_DDK  = (62, 66, 56)
 STEEL    = (180, 184, 178)
 STEEL_HI = (210, 214, 208)
 STEEL_DK = (120, 124, 118)
 BRICK    = (94, 98, 88)
 BRICK2   = (110, 114, 102)
 MORTAR   = (54, 58, 50)
 EARTH    = (46, 39, 29)
 EARTH_DK = (24, 20, 14)
 # the propensity spectrum: calm green (low) -> amber -> dangerous red (high)
 SPEC_LOW = (104, 150, 100)
 SPEC_MID = (198, 160, 74)
 SPEC_HI  = (176, 68, 54)
 def spec(t):
    """Colour along the nature->nurture propensity spectrum, t in 0..1."""
    t = _clamp01(t)
    if t < 0.5:
        return _mix(SPEC_LOW, SPEC_MID, t * 2.0)
    return _mix(SPEC_MID, SPEC_HI, (t - 0.5) * 2.0)
 # ---------------------------------------------------------------------------
 # shared frame + background + spectrum ribbon (identical on every preview)
 # ---------------------------------------------------------------------------
 CX, CY = AS / 2.0, 0.5
 FR_M = 0.050            # outer margin
 FR_R = 0.038           # corner radius
 FR_W = 0.026           # frame band width
 FHW, FHH = CX - FR_M, CY - FR_M
 IL, IR = FR_M + FR_W + 0.004, AS - FR_M - FR_W - 0.004    # inner content bounds
 IT, IB = FR_M + FR_W + 0.004, 1.0 - FR_M - FR_W - 0.004
 RIB_B = IB - 0.006
 RIB_T = RIB_B - 0.036
 RIB_L, RIB_R = IL + 0.004, IR - 0.004
 def _bg(u, v):
    c = _mix(BG_TOP, BG_BOT, _clamp01(v))
    dx, dy = (u - CX) / CX, (v - CY) / CY
    c = _shade(c, 1.0 - 0.24 * _clamp01(dx * dx + dy * dy))
    return _grainy(c, u, v)
 def _frame(u, v, d):
    """Embossed-tin border colour for a point whose rounded-rect distance is d."""
    if d > -0.004:
        return OUTLINE                          # crisp outer edge line
    p = (-0.004 - d) / (FR_W - 0.004)           # 0 outer .. 1 inner
    if p > 0.90:
        return OUTLINE                          # crisp inner edge line
    nx, ny = (u - CX), (v - CY)
    lit = -(nx * 0.55 + ny * 0.85)              # light from the top-left
    if lit > 0:
        c = _mix(TIN, TIN_HI, _clamp01(lit * 2.4))
    else:
        c = _mix(TIN, TIN_DDK, _clamp01(-lit * 2.4))
    return _grainy(c, u, v)
 def _ribbon(u, v):
    t = (u - RIB_L) / (RIB_R - RIB_L)
    c = _shade(spec(t), 0.86)
    if v - RIB_T < 0.004:
        return OUTLINE                          # dark lintel over the ribbon
    if RIB_B - v < 0.004:
        c = _shade(c, 0.62)
    if (t * 8.0) % 1.0 < 0.035:                 # eighth-tick divisions
        c = _shade(c, 0.68)
    return _grainy(c, u, v)
 def preview(motif):
    """Compose background + shared ribbon + motif + border into one supersampled pixel_fn."""
    def sample(fx, fy):
        u, v = fx / H, fy / H
        d = _rrect(u, v, CX, CY, FHW, FHH, FR_R)
        if d > 0.004:
            return _grainy(_shade(BG_BOT, 0.72), u, v) + (255,)     # rounded corner falloff
        if d > -FR_W:
            return _frame(u, v, d) + (255,)
        if RIB_T <= v <= RIB_B and RIB_L <= u <= RIB_R:
            return _ribbon(u, v) + (255,)
        m = motif(u, v)
        if m is not None:
            return m if len(m) == 4 else (m + (255,))
        return _bg(u, v) + (255,)
    return _raster(W, H, sample)
 # ===========================================================================
 # INSTITUTION -- the flagship. A barred cell window; behind the bars the whole
 # nature->nurture crime spectrum glows. Prison + a spectrum of crime, in one image.
 # ===========================================================================
 WIN_CX, WIN_CY = CX, 0.45
 WIN_HW, WIN_HH = 0.62, 0.30
 NBARS = 6
 def m_institution(u, v):
    d = _rrect(u, v, WIN_CX, WIN_CY, WIN_HW, WIN_HH, 0.028)
    if d > 0.030:
        return None
    if d > -0.006:
        return OUTLINE                                   # window outer edge
    if d > -0.036:                                       # tin window frame, bevelled
        nx, ny = (u - WIN_CX), (v - WIN_CY)
        lit = -(nx * 0.5 + ny * 0.9)
        c = _mix(TIN, TIN_HI, _clamp01(lit * 3.0)) if lit > 0 else _mix(TIN, TIN_DK, _clamp01(-lit * 3.0))
        return _grainy(c, u, v)
    L, R = WIN_CX - WIN_HW, WIN_CX + WIN_HW
    t = (u - L) / (R - L)
    # bars: NBARS vertical + two horizontal, in front of the spectrum
    s = (2 * WIN_HW) / NBARS
    i = int((u - L) / s)
    xc = L + s * (i + 0.5)
    dvb = abs(u - xc)
    bw = 0.016
    hb = min(abs(v - (WIN_CY - 0.175)), abs(v - (WIN_CY + 0.175)))
    hh = 0.014
    is_v = dvb < bw
    is_h = hb < hh
    if is_v or is_h:
        vertical = is_v and (not is_h or (dvb / bw) <= (hb / hh))
        if vertical:
            if dvb > bw - 0.0035:
                return OUTLINE
            p = (u - (xc - bw)) / (2 * bw)               # 0 left .. 1 right
            c = _mix(STEEL_DK, STEEL, 1.0 - p * 0.85)
            c = _mix(c, STEEL_HI, _clamp01(0.5 - p) * 0.7)
            return _grainy(c, u, v)
        else:
            if hb > hh - 0.0035:
                return OUTLINE
            near = WIN_CY - 0.175 if abs(v - (WIN_CY - 0.175)) < abs(v - (WIN_CY + 0.175)) else WIN_CY + 0.175
            p = (v - (near - hh)) / (2 * hh)
            c = _mix(STEEL_DK, STEEL, 1.0 - p * 0.85)
            c = _mix(c, STEEL_HI, _clamp01(0.5 - p) * 0.7)
            return _grainy(c, u, v)
    # interior: the spectrum, brighter through the middle so it reads as light behind bars
    base = spec(t)
    gy = 1.0 - _clamp01(abs(v - WIN_CY) / WIN_HH)
    base = _shade(base, 0.58 + 0.55 * gy)
    if d > -0.020:                                       # inner shadow just inside the frame
        base = _shade(base, 0.80)
    return _grainy(base, u, v)
 # ===========================================================================
 # CORE -- the invisible foundation. Two faint axes, NATURE (vertical) x NURTURE
 # (horizontal), meet at the engine node, which drives the 0..1 spectrum bar below.
 # Deliberately subdued: on its own it changes nothing you can see.
 # ===========================================================================
 NODE_X, NODE_Y = CX, 0.38
 BAR_Y, BAR_HW, BAR_HH = 0.60, 0.62, 0.052
 def m_core(u, v):
    # 0..1 spectrum bar (the hero, low and central)
    db = _rrect(u, v, CX, BAR_Y, BAR_HW, BAR_HH, 0.024)
    if db <= 0.005:
        if db > -0.005:
            return OUTLINE
        t = (u - (CX - BAR_HW)) / (2 * BAR_HW)
        c = spec(t)
        if (t * 10.0) % 1.0 < 0.028 and abs(v - BAR_Y) > BAR_HH - 0.016:
            c = _shade(c, 0.6)                           # scale ticks along the rim
        if abs(v - (BAR_Y - BAR_HH * 0.45)) < 0.006:
            c = _mix(c, (255, 255, 255), 0.12)           # a faint sheen line
        return _grainy(c, u, v)
    # engine node at the crossing
    dn = math.hypot(u - NODE_X, v - NODE_Y)
    if dn < 0.058:
        if dn > 0.050:
            return OUTLINE
        c = _mix(TIN, STEEL_HI, _clamp01(1.0 - dn / 0.050))
        return _grainy(c, u, v)
    # faint NATURE x NURTURE axes behind everything
    if abs(u - NODE_X) < 0.0035 and 0.14 < v < 0.62:
        return _grainy(TIN_DK, u, v)
    if abs(v - NODE_Y) < 0.0035 and (CX - 0.54) < u < (CX + 0.54):
        return _grainy(TIN_DK, u, v)
    # end caps on the axes -> small pips (nature high/low, nurture low/high)
    for (px, py) in ((NODE_X, 0.15), (NODE_X, 0.61), (CX - 0.54, NODE_Y), (CX + 0.54, NODE_Y)):
        if math.hypot(u - px, v - py) < 0.016:
            return _grainy(TIN, u, v)
    return None
 # ===========================================================================
 # CONTRABAND -- a filed shiv lying against a brick wall that an escape tunnel has
 # breached. The physical smuggling loop: a whittled weapon and a hole under the wall.
 # ===========================================================================
 BX, BY, BRX, BRY = CX + 0.44, 0.54, 0.28, 0.25         # the tunnel breach
 def _brick(u, v):
    bh, bw = 0.078, 0.180
    row = int((v - IT) / bh)
    x = u + (bw * 0.5 if row % 2 else 0.0)
    col = int(x / bw)
    ly = (v - IT) - row * bh
    lx = x - col * bw
    if ly < 0.012 or lx < 0.012:
        return MORTAR
    h = (row * 928371 + col * 123457) & 255
    return _shade(_mix(BRICK, BRICK2, h / 255.0), 0.94 + 0.12 * (((h >> 3) & 3) / 3.0))
 def _breach(u, v):
    ang = math.atan2(v - BY, u - BX)
    wob = 0.028 * math.sin(ang * 7.0 + 0.7) + 0.020 * math.sin(ang * 3.0)
    k = math.hypot((u - BX) / (BRX + wob), (v - BY) / (BRY + wob))
    return (k - 1.0) * min(BRX, BRY)
 def _shiv(u, v):
    Bx, By = 0.30, 0.80        # cloth grip low-left
    Jx, Jy = 0.44, 0.60
    Tx, Ty = 0.78, 0.24        # filed point high-right
    db, tb = _seg(u, v, Jx, Jy, Tx, Ty)
    half = 0.030 * (1.0 - tb) + 0.004 * tb
    d_blade = db - half
    dg, tg = _seg(u, v, Bx, By, Jx, Jy)
    d_grip = dg - 0.040
    d = min(d_blade, d_grip)
    if d > 0:
        return None
    if d > -0.006:
        return OUTLINE
    if d_grip <= d_blade:
        wind = (110, 110, 104) if (tg * 4.3) % 1.0 < 0.34 else (150, 150, 142)
        return _grainy(_shade(wind, 0.95 + 0.10 * tg), u, v)
    bevel = 1.0 - _clamp01(db / max(1e-6, half))
    c = _mix(STEEL_DK, STEEL, _clamp01(bevel * 1.6))
    c = _mix(c, STEEL_HI, _clamp01(bevel - 0.55) * 1.4)
    return _grainy(c, u, v)
 def m_contraband(u, v):
    s = _shiv(u, v)                                    # the shiv sits on top of the wall
    if s is not None:
        return s
    db = _breach(u, v)
    if db < 0:                                          # tunnel mouth: dark earth, deeper = darker
        f = _clamp01(-db / BRY)
        return _grainy(_mix(EARTH, EARTH_DK, f), u, v)
    if db < 0.020:                                      # broken, crumbling brick edge
        return _grainy(_shade(MORTAR, 0.7), u, v)
    return _grainy(_brick(u, v), u, v)
 # ===========================================================================
 # JUSTICE -- a level balance. Corrections weighing what a pawn has actually done:
 # classification, deterrence, discipline. A gavel-less balance, held even.
 # ===========================================================================
 J_BEAM_Y = 0.28
 J_BEAM_HW = 0.40
 J_BASE_Y = 0.74
 J_PAN_Y = 0.54
 def _pan(u, v, px):
    d = _ellipse(u, v, px, J_PAN_Y, 0.15, 0.058)
    if v < J_PAN_Y:                                     # keep the lower half -> a shallow bowl
        d = max(d, (J_PAN_Y - v))
    return d
 def m_justice(u, v):
    OW = 0.006
    d_post = _rrect(u, v, CX, (J_BASE_Y + J_BEAM_Y) / 2.0, 0.018, (J_BASE_Y - J_BEAM_Y) / 2.0, 0.006)
    d_base = min(_rrect(u, v, CX, J_BASE_Y, 0.150, 0.026, 0.012),
                 _convex(u, v, [(CX - 0.055, J_BASE_Y - 0.055), (CX + 0.055, J_BASE_Y - 0.055),
                                (CX + 0.100, J_BASE_Y - 0.020), (CX - 0.100, J_BASE_Y - 0.020)]))
    d_beam = _rrect(u, v, CX, J_BEAM_Y, J_BEAM_HW, 0.015, 0.008)
    d_fulc = _convex(u, v, [(CX, J_BEAM_Y - 0.055), (CX + 0.052, J_BEAM_Y),
                            (CX - 0.052, J_BEAM_Y)])
    d_panL = _pan(u, v, CX - J_BEAM_HW)
    d_panR = _pan(u, v, CX + J_BEAM_HW)
    d_solid = min(d_post, d_base, d_beam, d_fulc, d_panL, d_panR)
    # hangers: a thin line from each beam end down to its pan
    dcl, _ = _seg(u, v, CX - J_BEAM_HW, J_BEAM_Y, CX - J_BEAM_HW, J_PAN_Y - 0.05)
    dcr, _ = _seg(u, v, CX + J_BEAM_HW, J_BEAM_Y, CX + J_BEAM_HW, J_PAN_Y - 0.05)
    d_chain = min(dcl, dcr) - 0.004
    if d_chain <= 0 and d_chain < d_solid:
        return _grainy(TIN_DK, u, v) if d_chain > -0.004 else _grainy(TIN, u, v)
    if d_solid > 0:
        return None
    if d_solid > -OW:
        return OUTLINE
    # tin, lit from the top
    lit = 1.0 - _clamp01((v - J_BEAM_Y) / (J_BASE_Y - J_BEAM_Y))
    c = _mix(TIN_DK, TIN, 0.55 + 0.45 * lit)
    if d_solid <= d_panL or d_solid <= d_panR or d_solid <= d_beam:
        c = _mix(c, TIN_HI, 0.25 * lit)
    return _grainy(c, u, v)
 # ===========================================================================
 # GANGS -- a contraband network. Pawn tokens band into two rival clusters (amber
 # vs red) that a bright contraband line bridges through a broker in the middle.
 # ===========================================================================
 GANG_A, GANG_A_HI = (190, 150, 72), (216, 180, 98)
 GANG_B, GANG_B_HI = (176, 70, 56), (208, 100, 84)
 CONDUIT = (200, 202, 182)
 NODES = [
    (CX - 0.50, 0.34, 'A'), (CX - 0.62, 0.50, 'A'), (CX - 0.52, 0.66, 'A'), (CX - 0.36, 0.48, 'A'),
    (CX, 0.44, 'X'),
    (CX + 0.36, 0.36, 'B'), (CX + 0.54, 0.50, 'B'), (CX + 0.42, 0.66, 'B'), (CX + 0.24, 0.52, 'B'),
 ]
 EDGES = [
    (0, 1, 'A'), (1, 2, 'A'), (0, 3, 'A'), (3, 2, 'A'), (1, 3, 'A'),
    (5, 6, 'B'), (6, 7, 'B'), (5, 8, 'B'), (8, 7, 'B'), (6, 8, 'B'),
    (3, 4, 'X'), (4, 8, 'X'),
 ]
 def _token(u, v, nx, ny, base, hi):
    d_head = math.hypot(u - nx, v - (ny - 0.024)) - 0.020
    d_body = _rrect(u, v, nx, ny + 0.014, 0.032, 0.024, 0.012)
    d = min(d_head, d_body)
    if d > 0:
        return None
    if d > -0.005:
        return OUTLINE
    return _grainy(hi if d_head < d_body else base, u, v)
 def m_gangs(u, v):
    for (nx, ny, g) in NODES:                           # tokens sit on top of the wires
        if abs(u - nx) < 0.06 and abs(v - ny) < 0.06:
            if g == 'A':
                r = _token(u, v, nx, ny, GANG_A, GANG_A_HI)
            elif g == 'B':
                r = _token(u, v, nx, ny, GANG_B, GANG_B_HI)
            else:
                r = _token(u, v, nx, ny, TIN, TIN_HI)
            if r is not None:
                return r
    best, kind, bt = 1e9, None, 0.0
    for (i, j, k) in EDGES:
        ax, ay = NODES[i][0], NODES[i][1]
        bx, by = NODES[j][0], NODES[j][1]
        dd, tt = _seg(u, v, ax, ay, bx, by)
        if dd < best:
            best, kind, bt = dd, k, tt
    hw = 0.005
    if best < hw:
        if kind == 'X':                                 # the contraband conduit: a bright dashed line
            return _grainy(CONDUIT, u, v) if int(bt * 24) % 2 == 0 else None
        col = _shade(GANG_A, 0.62) if kind == 'A' else _shade(GANG_B, 0.62)
        if best > hw - 0.0018:
            return _shade(col, 0.7)
        return _grainy(col, u, v)
    return None
 # ===========================================================================
 # verify: decode a PNG we wrote and confirm it is non-trivial (varied pixels)
 # ===========================================================================
 def verify(path):
    data = open(path, "rb").read()
    assert data[:8] == b"\x89PNG\r\n\x1a\n", "not a PNG"
    i, idat, w, h = 8, b"", 0, 0
    while i < len(data):
        ln = struct.unpack(">I", data[i:i + 4])[0]
        typ = data[i + 4:i + 8]
        body = data[i + 8:i + 8 + ln]
        if typ == b"IHDR":
            w, h = struct.unpack(">II", body[:8])
        elif typ == b"IDAT":
            idat += body
        i += 12 + ln
    raw = zlib.decompress(idat)                          # rows: filter byte 0 + w*4 RGBA bytes
    stride = w * 4 + 1
    seen = set()
    lo = [255, 255, 255]
    hi = [0, 0, 0]
    for y in range(0, h, 7):                             # sparse sample is plenty to prove variety
        base = y * stride + 1
        for x in range(0, w, 7):
            o = base + x * 4
            px = (raw[o], raw[o + 1], raw[o + 2])
            seen.add(px)
            for c in range(3):
                lo[c] = min(lo[c], px[c])
                hi[c] = max(hi[c], px[c])
    spread = max(hi[c] - lo[c] for c in range(3))
    return {"bytes": len(data), "w": w, "h": h, "distinct": len(seen), "spread": spread}
 TARGETS = [
    ("institution", m_institution, "barred cell window over the nature->nurture crime spectrum"),
    ("core",        m_core,        "nature x nurture engine node driving a 0..1 spectrum bar"),
    ("contraband",  m_contraband,  "filed shiv against a brick wall breached by an escape tunnel"),
    ("justice",     m_justice,     "a level balance weighing what a pawn has done"),
    ("gangs",       m_gangs,       "two rival pawn clusters bridged by a contraband line"),
 ]
 def main():
    for name, motif, desc in TARGETS:
        path = os.path.join(SUITE, "rimworld-" + name, "About", "Preview.png")
        png(path, W, H, preview(motif))
        info = verify(path)
        ok = "OK" if info["distinct"] > 200 and info["spread"] > 80 else "?? CHECK"
        print(f"{ok}  {os.path.relpath(path, SUITE)}  "
              f"{info['w']}x{info['h']}  {info['bytes']:,}B  "
              f"distinct~{info['distinct']}  spread={info['spread']}  -- {desc}")
 if __name__ == "__main__":
    main()
@@ -0,0 +1,83 @@
 #!/usr/bin/env bash
 # Assemble the shippable, drop-in "Institution" mod into this repo.
 #
 # The Institution suite's code lives in SEPARATE sibling repos (rimworld-core, -contraband, -policing,
 # -corrections, -gangs, -ward) as independent projects/DLLs -- that is what keeps it modular and splittable. For DISTRIBUTION
 # they are vendored into ONE mod folder (this repo) with one About.xml and a settings shim that toggles
 # each layer. This script rebuilds the sibling DLLs clean (no self-test) and copies them + Contraband's
 # Defs in here, so the repo is a complete installable mod.
 #
 # To split back into separate mods later: stop running this, and ship each sibling repo as its own mod
 # (their About.xml files still exist). Nothing in the code changes.
 #
 # Usage:  Tools/package.sh          (assumes siblings at ../rimworld-<name>)
 set -euo pipefail
 HERE="$(cd "$(dirname "$0")/.." && pwd)"
 SIB="$(dirname "$HERE")"
 CORE="$SIB/rimworld-core"
 CB="$SIB/rimworld-contraband"
 POL="$SIB/rimworld-policing"
 COR="$SIB/rimworld-corrections"
 GANGS="$SIB/rimworld-gangs"
 WARD="$SIB/rimworld-ward"
 command -v dotnet >/dev/null || { echo "dotnet not on PATH" >&2; exit 1; }
 echo "==> building the engine + feature DLLs (clean, no self-test)"
 dotnet build "$CORE/Source/Core/Core.csproj"                   -c Release -v q --nologo
 dotnet build "$POL/Source/Policing/Policing.csproj"           -c Release -v q --nologo
 dotnet build "$COR/Source/Corrections/Corrections.csproj"     -c Release -v q --nologo
 dotnet build "$CB/Source/Contraband/Contraband.csproj"        -c Release -v q --nologo
 dotnet build "$GANGS/Source/Gangs/Gangs.csproj"               -c Release -v q --nologo
 dotnet build "$WARD/Source/Ward/Ward.csproj"                  -c Release -v q --nologo
 echo "==> vendoring DLLs into Assemblies/"
 mkdir -p "$HERE/Assemblies"
 rm -f "$HERE/Assemblies/"*.dll                                                        # clear old layout
 dotnet build "$HERE/Source/Institution/Institution.csproj" -c Release -v q --nologo   # (re-)emit Institution.dll here
 cp "$CORE/Assemblies/InstitutionCore.dll"          "$HERE/Assemblies/"
 cp "$CB/Assemblies/Contraband.dll"                 "$HERE/Assemblies/"
 cp "$POL/Assemblies/InstitutionPolicing.dll"       "$HERE/Assemblies/"
 cp "$COR/Assemblies/InstitutionCorrections.dll"    "$HERE/Assemblies/"
 cp "$GANGS/Assemblies/InstitutionGangs.dll"        "$HERE/Assemblies/"
 cp "$WARD/Assemblies/Ward.dll"                     "$HERE/Assemblies/"
 echo "==> vendoring the feature content"
 for d in Defs Patches Languages Textures; do
  rm -rf "$HERE/$d"
  [[ -e "$CB/$d" ]] && cp -r "$CB/$d" "$HERE/$d"
 done
 # Policing + Corrections ship defs of their own (crime thoughts; corrections hediffs/jobs/interaction
 # modes/thoughts/regime/marker); merge them into the same Defs/ tree.
 for M in "$POL" "$COR"; do
  if [[ -e "$M/Defs" ]]; then
    mkdir -p "$HERE/Defs"
    cp -r "$M/Defs/." "$HERE/Defs/"
  fi
 done
 # Corrections ships a texture (the security marker); vendor it so the aggregate isn't magenta.
 if [[ -e "$COR/Textures" ]]; then
  mkdir -p "$HERE/Textures"
  cp -r "$COR/Textures/." "$HERE/Textures/"
 fi
 # Ward ships defs (interaction mode, hediffs, treatment station, room role), its own textures, AND a
 # Patches/ dir -- the Rim Disorders integration that marks disorders treatable (conditional, so it
 # no-ops without that mod). Miss the Patches/ and treatment silently does nothing to the illness. All
 # its files are *_Ward*.xml or under a Ward/ texture subdir, so nothing collides with the others.
 if [[ -e "$WARD/Defs" ]]; then
  mkdir -p "$HERE/Defs"
  cp -r "$WARD/Defs/." "$HERE/Defs/"
 fi
 if [[ -e "$WARD/Textures" ]]; then
  mkdir -p "$HERE/Textures"
  cp -r "$WARD/Textures/." "$HERE/Textures/"
 fi
 if [[ -e "$WARD/Patches" ]]; then
  mkdir -p "$HERE/Patches"
  cp -r "$WARD/Patches/." "$HERE/Patches/"
 fi
 echo "==> done. Assemblies:"
 ls -1 "$HERE/Assemblies/" | sed 's/^/    /'
 echo "The repo is now a complete drop-in Institution mod (Core bundled). Requires only Harmony."
@@ -0,0 +1,42 @@
 #!/usr/bin/env bash
 # Consolidate every layer's Wiki/ into THIS repo's Wiki/, so the Institution page is the single place
 # to read the whole suite's documentation. Each layer's pages land under Wiki/<layer>/ with their own
 # internal links intact. The layer repos stay the canonical source (each ships its own wiki for a
 # standalone install); re-run this whenever a layer's wiki changes to re-sync the aggregated copy.
 #
 # Wiki/Home.md (the suite index) is hand-written and lives at the top level -- this script never
 # touches it, only the per-layer subfolders.
 #
 # Usage:  Tools/sync-wiki.sh      (assumes siblings at ../rimworld-<name>)
 set -euo pipefail
 HERE="$(cd "$(dirname "$0")/.." && pwd)"
 SIB="$(dirname "$HERE")"
 # layer folder -> sibling repo
 LAYERS=(
  "core:rimworld-core"
  "contraband:rimworld-contraband"
  "policing:rimworld-policing"
  "corrections:rimworld-corrections"
  "gangs:rimworld-gangs"
  "ward:rimworld-ward"
 )
 echo "==> mirroring layer wikis into $HERE/Wiki/"
 for entry in "${LAYERS[@]}"; do
  layer="${entry%%:*}"
  repo="${entry##*:}"
  src="$SIB/$repo/Wiki"
  dst="$HERE/Wiki/$layer"
  if [[ -d "$src" ]]; then
    rm -rf "$dst"
    mkdir -p "$dst"
    cp "$src"/*.md "$dst"/
    echo "    $layer: $(ls "$dst" | wc -l | tr -d ' ') pages"
  else
    echo "    $layer: no Wiki/ in $repo -- skipped"
  fi
 done
 echo "==> done. The Institution wiki now mirrors every layer under Wiki/<layer>/; Wiki/Home.md is the index."
@@ -0,0 +1,145 @@
 # FAQ — handling what Institution throws at you
 New situations the suite introduces, and what to actually do about them. Grouped by where the trouble
 comes from. Every layer is a checkbox in **Options → Mod Settings** — if a whole category of problem
 isn't for you, turn that layer off and it stops immediately.
 ---
 ## Escapes & contraband
 **A prisoner is digging a tunnel under my wall!**
 Order a warden to **search** them — a search can turn up the digging tool and end the tunnel, and a
 half-dug shaft is easier to spot than the pick that started it. Tunnels take days, so you have time.
 Prevention: house dangerous prisoners in **interior** cells with no short line to the wilderness, and
 keep them searched. See [Tunnels](contraband/Tunnels.md) and [Warden Search](contraband/Warden-Search.md).
 **My prisoner keeps having a shiv / weapon on them.**
 Contraband is hidden — you won't see it in the gear tab; that's the point. Order **searches**, and
 search the *likely* prisoner first: a prisoner with a bad record and a gnawed bed is the one to turn
 over. If searches keep coming up empty but weapons keep appearing, suspect a **bent warden** or a
 **gang** resupplying them (below). See [Concealment & Intake](contraband/Concealment-and-Intake.md).
 **Where is all this contraband coming from? I keep searching!**
 Three doors: prisoners **make** it (from their cell's own furniture), a **bent warden** smuggles it in,
 or a **gang** moves it from a stashed member to a searched one. Deny the materials (barer cells), watch
 your wardens, and **segregate** gang rivals so the network can't reach across the wing.
 **One of my wardens is corrupt / letting things through.**
 Warden corruption is a hidden disposition — a greedy or low-conduct colonist makes a leakier warden and
 may even smuggle. You can't get a clean readout, so if a wing stays dirty no matter how you search,
 rotate who wardens it. See [Corruption](contraband/Corruption.md).
 ---
 ## Prisoners who won't reform
 **I'm warding a prisoner but their reform isn't moving.**
 Reform only moves when a warden actually runs **rehabilitation** sessions — assign a warden to the
 prisoner and let them work. A **better cell** (more impressive) and a **higher-Social** warden reform
 faster; a bare cell and a rookie crawl. Don't leave a flagged prisoner untended: **neglect hardens**
 them. See [Rehabilitation](corrections/Rehabilitation.md).
 **A prisoner is "prisonized" / getting worse the longer I hold them.**
 Harsh **discipline** (solitary) raises the colony's order but **hardens** the prisoner — held long and
 handled roughly, they turn more dangerous, not less. If you want them out reformed, counsel more and
 discipline less. Discipline is a tool for *order*, not for *rehabilitation*. See
 [Discipline & Reform](corrections/Discipline-and-Reform.md).
 **How do I actually release a reformed prisoner?**
 Set their interaction mode to **Parole**. They go free when their **reform** is high enough **and** their
 **security grade** is low enough (a Supermax pawn won't parole). With Ideology, an execution-happy
 ideoligion sets a *high* bar (paroles rarely); an execution-abhorring one lets them out readily. A
 "Ready for parole" alert tells you when one qualifies. See [Parole](corrections/Parole.md).
 ---
 ## Classification & housing
 **I got a "dangerous prisoner unsecured" alert.**
 A high-grade prisoner (Maximum/Supermax) is being held somewhere too weak for their grade — in the open,
 or sharing a cell. Move them to a stronger wing. Place a wall-mounted **security marker** to grade a
 whole cell block at once, then the game knows which prisoners are misplaced. See
 [Classification](corrections/Classification.md).
 **A prisoner is miserable and I don't know why.**
 Two common Institution causes: they're **caged with a dangerous cellmate** (cell-safety mood hit — give
 them a solo cell) or they're on a **Lockup** schedule with no recreation. Give dangerous prisoners their
 own cells and hand prisoners some **Yard** time. See [Regime](corrections/Regime.md).
 ---
 ## Colony crime (Policing layer)
 **My own colonists are committing crimes now!**
 That's the **Policing** layer — colonists offend on the same propensity spectrum as everyone else, more
 often when they're mistreated, dangerous by nature, or living in a big anonymous colony. Keep colonists
 happy and the colony tight and it's rare. If you don't want colony crime at all, turn off the
 **Policing** toggle and the rest of the suite keeps working. See [Policing](policing/Policing.md).
 **A crime happened but no one was caught.**
 Witnesses and a **constable's** investigation accrue evidence over time before a culprit is named — give
 it a few days and assign someone capable to police work. Not every crime is solved. See
 [Policing](policing/Policing.md).
 **I don't want to arrest my star colonist over a petty theft.**
 You often won't have to — arrests are **weighed**: a valuable colonist and a minor crime tips toward
 letting it slide, and a small colony (or no free prison bed) won't arrest at all. And a disposed culprit
 may **resist** the arrest and try to break out.
 **A riot broke out!**
 The colony's **climate of order** collapsed. Order falls when crime goes unanswered and rises with
 **visible justice** — arrests and discipline. Riots only catch when order is already low, so the fix is
 to stop letting crime pay: catch and punish, and order recovers. See [Deterrence](policing/Deterrence.md).
 **Why does punishing one prisoner seem to calm the whole colony?**
 By design — the order climate feeds back into **everyone's** disposition. Catching and punishing one
 pawn deters the rest a little; letting crime slide emboldens them. That feedback is the whole point of
 the suite. See [Deterrence](policing/Deterrence.md).
 ---
 ## Gangs
 **A gang formed in my prison.**
 Gangs are a **symptom of a badly-run colony** — disposed prisoners band together along ties they already
 share. The counter-play is the rest of the suite: **segregate** rivals into different wings (a network
 whose members can't reach each other is starved), keep prisoners reformed, and don't let contraband
 flow. A well-run colony grows few gangs, if any. See [Joining](gangs/Joining.md) and
 [Affiliations & Segregation](gangs/Affiliations-and-Segregation.md).
 **Two prisoners keep fighting.**
 Rival-gang brawls are booked as **crimes** — they land on the attacker's record and erode the colony's
 order, so they matter beyond the moment. Segregating the rivals is how you stop it. See
 [Rivalry & Fights](gangs/Rivalry-and-Fights.md).
 ---
 ## Psychiatric care (Ward layer)
 **A prisoner broke mentally — I'd rather treat them than punish them.**
 Commit them to the **Ward**: sustained counselling reduces the disorder that broke them and builds a
 recovery track toward **discharge**. It's the other door out of the prison — recovery instead of
 punishment. Don't neglect a committed patient, or they deteriorate. A **sedative** can calm a patient
 who's about to break. See [Commitment](ward/Commitment.md).
 ---
 ## Settings & compatibility
 **This is too much / I only want part of it.**
 Every layer is independent. Open **Options → Mod Settings → Institution** and untick any of Contraband,
 Policing, Corrections, Gangs, or Ward. The one you turn off goes inert immediately; the rest still work.
 **Does it play nice with other prison / psychiatry mods?**
 Yes — Institution rides vanilla's own prisoner rail and is tested against the popular psych/prison mods.
 It extends rather than replaces, so it coexists with the mods that own the parts it doesn't. Ward in
 particular is built to sit alongside Hospitality, Psychology, Rim Disorders and friends.
 **Do I need anything else?**
 Just **[Harmony](https://steamcommunity.com/sharedfiles/filedetails/?id=2009463077)**. The shared Core
 engine ships inside the mod. **Foul Play** (a separate mod) bridges in if you also run it.
 ---
 *Back to the [Wiki home](Home.md).*
@@ -0,0 +1,104 @@
 # Institution — Wiki
 *Prison Architect in RimWorld. One install, six toggleable layers, over one shared engine.*
 > **Every pawn has a criminal propensity on a spectrum — nature (traits) × nurture (mood,
 > mistreatment, treatment) — and the colony can police it.**
 That one sentence is the whole suite. Colonists, prisoners, and slaves drift toward crime on a
 continuous spectrum; a policing-and-corrections machine discovers, catches, weighs, punishes, reforms,
 treats, and releases them — and catching one pawn changes the disposition of the rest.
 **Institution** is the single mod that ships all of it — every layer bundled into one install with a
 **checkbox per layer** (all on by default), so you run as much or as little of the suite as you like.
 > **New to it?** The **[FAQ](FAQ.md)** covers what to do when the mod throws something new at you — an
 > escape tunnel, a gang in the wing, a riot, a prisoner who won't reform, a "dangerous prisoner
 > unsecured" alert.
 ---
 ## The gameplay loop
 The suite is a closed loop, and each turn of it lives in a different layer — mirroring the real
 separation of powers: police, (courts,) prison, parole.
 1. **Disposition** *(Core)* — every pawn carries a seeded propensity: *would this one do it?*
 2. **Crime** *(Policing)* — free colonists offend on that spectrum (rare in a small, tight,
   well-deterred colony), with visible consequences — theft, vandalism, assault — that fray
   relationships.
 3. **Detection** *(Policing)* — witnesses and a **constable** work an open case until the culprit is named.
 4. **The weighed arrest** *(Policing)* — an arrest is made only when the crime is grave enough to
   justify losing the pawn and the colony can afford to hold a prisoner; the disposed **resist**, and a
   subdued resister is taken in. *(A future **Judiciary** layer — a court that tries and sentences —
   is reserved to sit here, between arrest and imprisonment; today the arrest imprisons directly.)*
 5. **Contraband** *(Contraband)* — once held, a pawn conceals and improvises: shivs, brews, tunnels
   under the perimeter, all countered by warden search — and a bent warden who smuggles for them.
 6. **Gangs** *(Gangs)* — held pawns organise into contraband economies: joining by disposition,
   smuggling networks, rivalry, fights that book as crimes.
 7. **Corrections** *(Corrections)* — a warden **rehabilitates** a prisoner: counselling sessions move a
   **reform** score and raise the colony's climate of **order** (classification re-grades as reform
   rises), that order feeds back into everyone's disposition, and a **parole** alert releases the
   genuinely reformed back into the colony. Neglect a flagged prisoner and they harden.
 8. **Treatment** *(Ward)* — the other door: a prisoner committed for **psychiatric care** rather than
   punished. Counselling reduces the disorder that broke them and builds a recovery track toward
   discharge; neglect a committed patient and they deteriorate.
 Steps 7 and 8 close the loop back onto step 1: catching, punishing, reforming, or treating one pawn
 moves the colony's climate of order, which bends the disposition of everyone still deciding whether
 crime pays here.
 ---
 ## The six layers
 Each is a separate repo and DLL, bundled here behind a toggle. Every layer defaults **on**; turning
 one off disables its systems in place without uninstalling anything.
 | Layer | Toggle | What it adds | Wiki |
 |---|---|---|---|
 | **Core** | *(always on — the engine)* | propensity, the criminal record, secured context, the shared **treatment engine**, the deterrence seam | [Core](core/Home.md) |
 | **Contraband** | Contraband | concealment & intake, improvised shivs, Prison-Architect tunnels, warden search, warden corruption | [Contraband](contraband/Home.md) |
 | **Policing** | Policing | colony crime on the spectrum, witnesses, a constable, the weighed arrest, the deterrence feedback loop, prison riots, recidivism alerts | [Policing](policing/Home.md) |
 | **Corrections** | Corrections | classification (with whole-wing markers), discipline & reform, **rehabilitation** + parole, regime (recreation/visitation/cell-safety) | [Corrections](corrections/Home.md) |
 | **Gangs** | Gangs | gangs as contraband economies — joining, smuggling networks, rivalry, fights-as-crime | [Gangs](gangs/Home.md) |
 | **Ward** | Ward | psychiatric care — treatment, recovery, discharge, ward neglect, sedation | [Ward](ward/Home.md) |
 **Policing** and **Corrections** are separate layers — the enforcement half and the prison half of the
 former *Justice* module, split along the separation of powers. Policing has its own toggle because
 colony crime is a large behavioural change: a player can run the prison (Corrections) without their own
 colonists committing crimes. Corrections depends on Policing for the shared climate of order.
 ---
 ## Why one Core, many layers
 The suite runs on a small **Core** that owns exactly what every layer must agree on — *is this pawn
 dangerous?*, *what have they actually done?*, *what hold are they under?* — plus two shared services:
 the **treatment engine** (Ward's psychiatric care and Corrections' rehabilitation point the same loop
 at different states) and the **deterrence seam** (a neutral hook Policing fills so the order-climate
 feedback runs *through* Core without Core ever depending on the policing layer). A future **Judiciary**
 layer will slot in through the same style of Core seam — a *sentence* on the criminal record that
 Policing writes a default of today and a court would fill tomorrow.
 Everything else builds up from there: Contraband, Policing, and Corrections on Core (Corrections also
 on Policing); Gangs on Core + Contraband + Policing; Ward on Core. Cross-layer integrations that aren't
 hard dependencies stay soft — a feature lights up if its sibling is present and the loop still closes
 without it. That is what keeps the suite genuinely modular: this aggregate is a convenience, not a merge.
 ---
 ## Requirements & install
 - **RimWorld 1.6.**
 - **[Harmony](https://steamcommunity.com/sharedfiles/filedetails/?id=2009463077)** — required (the
  suite's Harmony-using code is Corrections' prisoner-recreation patch and Ward's).
 - Install **Institution**, enable Harmony, and load Institution after it. That is the whole suite in
  one mod; open the settings to toggle any layer.
 The standalone **[Foul Play](https://git.arch.fyi/flan/rimworld-foulplay/wiki)** framework is a
 separate install that bridges into the suite when both are present.
 ---
 *The **Institution** suite for RimWorld 1.6: Core · Contraband · Policing · Corrections · Gangs · Ward.*
@@ -0,0 +1,116 @@
 # Compatibility
 *Contraband adds its own content and reads from the base game rather than rewriting it. That is why it
 composes with other mods instead of colliding with them.*
 ## Requires: Institution: Core
 Contraband has a hard dependency on **Institution: Core** and loads after it. This is not optional —
 after the split, everything Contraband reads lives in Core:
 | Core provides | Contraband uses it for |
 |---|---|
 | Which pawns count as "in custody," and who can hide things | who counts as a concealer; who can be intaken, whittle, or dig |
 | A pawn's criminal propensity (nature × nurture) | every disposition roll — intake (0.6), improvise (0.10), dig (0.08), all scaled and settled per pawn |
 | The criminal record | times searched, times caught, escape attempts, contraband made — written by search and acquisition, read by search priority |
 Install Contraband without Core and it will not run. Everything else on this page is optional interplay
 that degrades gracefully when the other mod is absent.
 ## It plays nicely with other prison mods
 Contraband adds its own content rather than rewriting the base game's. It:
 - **Adds a new warden job** (search) rather than changing an existing one.
 - **Reuses vanilla warden behaviour** rather than overriding it, so anything that adjusts warden
  behaviour on the base class flows through to searches for free.
 - **Extends two escape-related behaviours at startup** so prisoners arm themselves and use what they
  are hiding when they break — inserted at a specific point, and it logs a warning if that anchor is
  missing rather than failing silently.
 - **Runs on a heartbeat** over held pawns for intake, improvisation, and tunnels — no hook on the
  capture event is needed because the heartbeat already visits every held pawn.
 The net effect: the surfaces other prison mods touch are mostly untouched here, so conflicts are the
 exception, not the rule.
 ## Foul Play — the carboy bridge
 **Foul Play** (the "Piss Nuke" mod) stays its own mod with its own front door, and yet its **carboy is
 a first-class contraband item.** This is the flagship demonstration of Contraband's *"items are
 content, subsystems are shared, mods are audiences"* principle, and it works two ways:
 1. **The carboy brings its own behaviour.** The carboy simply declares itself as contraband and points
   at the throw-the-carboy behaviour that lives in *Foul Play*. Contraband never has to know that
   behaviour exists — it just runs whatever the item brought with it.
 2. **A concealed carboy keeps its contents.** A carboy is not just "a jar" — it is a jar *of* a
   fermented blend, and that blend has to survive being concealed. When a carboy is intaken or
   smuggled, Contraband captures a label for its contents blindly; on redemption it hands the label
   back to Foul Play to restore the blend. **Contraband knows nothing about substances or
   fermentation** — that framework lives entirely in Foul Play. If Foul Play is absent, no content is
   captured and nothing breaks: a jar is just a jar. See
   [Concealment and Intake](Concealment-and-Intake.md).
 The dependency runs one way only: Foul Play bridges *to* Contraband (and to Core) if they are present;
 Contraband takes **no** dependency on Foul Play.
 ## Institution: Justice — the record is the shared bus
 Contraband and **Justice** never call each other. They meet on Core's criminal record — Contraband
 writes to it, Justice reads from it:
 | Contraband writes | Justice reads it into |
 |---|---|
 | times searched | Classification (security grade) |
 | times caught | Deterrence (colony-wide signal) |
 | escape attempts | Discipline / Parole (reform) |
 | contraband made | |
 - **Catching contraband feeds classification.** A prisoner repeatedly caught with shivs or foiled
  mid-tunnel racks up catches and escape attempts, which Justice's classification weighs into a higher
  security grade.
 - **And it feeds back.** Justice's deterrence signal flows *back* through Core's propensity, nudging
  every future intake / improvise / dig roll a Contraband pawn makes. A prison that catches and
  disciplines becomes a prison where fewer prisoners bother trying — without either mod referencing the
  other. Run Contraband alone and deterrence is a neutral 1.0; the record still routes the warden.
 ## Institution: Gangs — the contraband economy
 **Gangs** depends on Core, **Contraband**, and Justice, because a gang *is* a contraband economy:
 - Gang smuggling moves contraband through the same door intake and corruption use.
 - A gang's outside members are the natural caller for the **reach-in corruption** — paying a bent
  warden to make a delivery. That ability exists in Contraband but has no in-game trigger of its own;
  Gangs is what drives it. See [Corruption](Corruption.md).
 - Gang fights route to Justice's crime record, which then raises search priority here. The loop closes
  through Core again.
 ## Prison mods the suite is tested against
 | Mod | Interaction | Verdict |
 |---|---|---|
 | **Prison Commons** | it adjusts warden behaviour on the base class, and Contraband's search inherits that, so searches respect prison-commons/allowed areas **for free** | works by inheritance |
 | **Custom Prisoner Interactions** | it only touches the *named* vanilla warden jobs (chat, convert, enslave, release); it cannot see a brand-new job | no conflict |
 | **Prisoner Realism** | its escapes are for "mood prisoners" mid-break; a tunnel breakout hands off to the vanilla prison-break flow, which Prisoner Realism layers on. Tunnels **complement** it — they let ward patients and slaves who would never mood-break still, patiently, dig out | complementary |
 | **Prison Labor** | prisoners working outside the cell are still held pawns and still tracked; Contraband adds nothing to labor jobs. A work assignment is simply another place a disposed prisoner might come by materials | no conflict |
 | **Prisoner Recreation** | overlaps the *regime* feature — which now lives in **Institution: Justice**, not here, and is written to coexist with Prisoner Recreation | not Contraband's concern post-split |
 ## Load order
 1. Base game
 2. **Institution: Core** — required, loads before Contraband
 3. **Institution: Contraband** — this mod
 4. **Foul Play / Justice / Gangs** — any order after Core; each bridges if present
 ## The general rule
 If a mod adds prisoner behaviour by **changing vanilla warden jobs or the escape flow by name**, it
 will not see Contraband's additions, and Contraband will not see its — they pass each other harmlessly.
 If a mod adds a *new* warden job or escape behaviour of its own, it stacks. The one place to watch is
 another mod that *also* rewrites the same two escape-related behaviours wholesale; Contraband inserts
 its part at a specific point and logs a warning if that point is missing, so a load-order or conflict
 problem is visible in the log rather than silent.
 ---
 *Part of the **Institution** suite — Core · Contraband · Justice · Gangs, alongside Foul Play and
 Ward. Each stands alone; together they interlock.*
@@ -0,0 +1,201 @@
 # Concealment and Intake
 *How a hidden item exists without existing, how it gets onto a prisoner in the first place, and how
 it becomes real again.*
 This is the spine of the whole mod. Everything else — shivs, tunnels, searches, corruption — is a
 different way to add to, or remove from, the private stash this page describes.
 ## While it is concealed, there is no item
 The single most important rule:
 > The prison quietly tracks what each pawn is hiding. **Concealed contraband is not an item on the
 > map. It is a secret.** It is not in the gear tab, there is no icon, and the player is told nothing —
 > because an item you can see in the UI is not contraband, it is inventory, and there would be nothing
 > for a warden to discover and no reason to ever order a search.
 A concealed item is only a hidden fact about a pawn: what it is, how far along it is, what material it
 ended up made of, an optional source it is being whittled from, its tunnel state if it is a pick, and
 whatever it holds inside. It has **no physical object** anywhere in the world until one of two things
 happens:
 | Moment | What happens |
 |---|---|
 | The prisoner **uses** it | It materialises into their inventory as a real item |
 | A warden **finds** it | It is deleted; it never becomes an item at all |
 A corollary the search page leans on hard: **an empty search must still cost time.** If the search
 job only ever appeared when there was genuinely something to find, the mere *offer* of the job would
 be the discovery. You have to be able to toss a clean cell and come up with nothing.
 ## Where a thing can hide
 Every piece of contraband can hide in one of two places, and this decides **who can ever find it**:
 | Site | Holds | Found by |
 |---|---|---|
 | **On the body** | small: a shiv, pills, a phone | searching the **pawn** |
 | **In the cell** | bulky: a rifle, a carboy, a crude pick | tossing the **room** |
 A warden turning over a prisoner and their cell reaches both. The reason the two are split at all: a
 **constable** in Justice's policing layer, frisking a colonist named in a street crime, only reaches
 what is on the body, so whatever is under their floorboards stays there until somebody has grounds to
 search the *room*. The split between "who may search" and "what a search reaches" is deliberate — see
 [Warden Search](Warden-Search.md).
 ## Three kinds of contraband, and no list of items
 There is no hardcoded list of contraband item names. At the start of a game, the mod looks at every
 item in the game and decides, once, whether it counts as contraband, in one of three ways:
 1. **Explicit.** Anything a mod has deliberately marked as contraband. This is the opt-in, and it is
   how a mod plugs in its own behaviour for how the item is acquired, used, or used to escape.
 2. **Every drug** — recognised automatically.
 3. **Every weapon** that isn't destroyed when dropped — recognised from its **mass**.
 For anything not marked explicitly, the mod fills in how well it hides and where, so a modder never
 has to:
 | Kind | Test | Concealability | Hides |
 |---|---|---|---|
 | Hard drug | drug rated Hard | **0.75** | on body or in cell |
 | Other drug | any other drug | **0.5** | on body or in cell |
 | Light weapon | mass ≤ 2.0 kg | **0.7** | on body or in cell |
 | Heavy weapon | 2.0 kg < mass ≤ 10.0 kg | **0.35** | in cell only |
 | Very heavy weapon | mass > 10.0 kg | — | **not contraband** (a minigun hides nowhere) |
 **Concealability** runs 0 to 1, where **0 = a warden finds it every time and 1 = never**; higher is
 harder to find. Drugs and inferred weapons get **no crafting route** (you cannot synthesise yayo in a
 bare cell, and you cannot conjure a rifle) and **no special use behaviour** — because vanilla already
 knows what to do with them. A prisoner takes a drug on their own; an armed prisoner *is* the payload.
 Getting the item into the cell is the entire problem, and that is all these routes solve.
 Nothing here edits another mod's items. It is a one-time reading of each item's own stats. Modded
 drugs and weapons are covered without ever being named.
 ## The heartbeat
 The prison does its ongoing work on a heartbeat. Every **250 ticks** it visits every pawn who could
 be concealing something and does all the ongoing work: intake, tunnel progress, and improvisation. If
 nothing on the map can be self-made and no escape tools are in play, it does nothing and costs
 nothing.
 Because the heartbeat already visits every held pawn, intake needs no special trigger on the capture
 event: a pawn who is in custody but has not yet been processed is, by definition, one who was newly
 taken.
 ### Who counts as a concealer
 The set of pawns being tracked is **not** just prisoners. It is every pawn whose belongings are
 anyone's business — prisoners, slaves, ward patients, **and free colonists**:
 > A free colonist forbidden their drug by a drug policy or an ideoligion is precisely the pawn who
 > keeps a private stash — and vanilla already denies them, with no valve.
 Whether anyone may *search* a given concealer is a separate question with a separate answer (the
 warden's authority reaches prisoners; a future cop's reaches colonists). Tracking is pawn-agnostic;
 authority is not.
 ## Intake: the moment of capture
 Vanilla never strips a captive *on capture* — a downed pawn keeps whatever they walked in with, and
 the warden just hauls them to a cell. Intake is Contraband's answer to that gap, and it runs on the
 first heartbeat that sees a newly-held pawn:
 1. **Held only.** The pawn must be a person and in custody — prisoner, slave, or ward patient. A free
   colonist is tracked, but nobody frisks and processes *them* on the way into a cell, so their
   carried gear is never intaken.
 2. **Once.** Each captive is processed a single time; a later pass finds them already done and moves
   on. (It remembers by an ID, so it holds no ghost of a captive who has since died.)
 3. **Even while downed.** Intake runs *before* the "must be awake" gate. The stash a captive walked in
   with is hidden the moment they are in custody, not when they wake — everything *after* intake
   (whittling, digging) needs them awake, but hiding what is already on you does not.
 4. **Only what can ride on a body.** A thing can be intaken only if it is small enough to hide on the
   body. A shiv up a sleeve is intaken; a rifle or a suit of armour is too bulky to palm and stays as
   ordinary strippable gear the player confiscates for free.
 5. **Per-item disposition.** For each concealable thing the captive carries, the mod rolls whether
   *this* pawn would hide *this* item — a base chance of **0.6**, then scaled by the pawn's nature ×
   nurture (Core's propensity). The roll is **fixed per (pawn, item)** — a settled fact, not a fresh
   coin each tick. The frightened cook surrenders the knife; the disposed lifer palms it, and always
   would have.
 When a pawn does hide an item, the real object is **removed from the game** and a hidden secret takes
 its place, preserving what the item was made of and — critically — anything it holds inside.
 ## Preserving contents without understanding them
 A concealed vessel is not just "a jar" — it is a jar *of* something (hooch, piss, a fermented blend),
 and that something has to survive being hidden and come back when the item is used. Contraband stores
 what a vessel contains as a single opaque label and **has no idea what it means**.
 When the item is concealed, that label is captured; when the item comes back out, the label is used
 to pour the contents back into the freshly-made thing. This is the exact seam **Foul Play** uses to
 keep a smuggled carboy's contents intact. Without a bridge mod, no content is captured and nothing is
 lost — a shiv is just a shiv.
 Fermentation itself lives in Foul Play, not here. A concealed vessel comes back out **fresh** and
 ferments afterward like any other, which suits the theme: fresh-brewed piss is weak, and time is what
 makes it a weapon. (The prison remembers how long the vessel was hidden, for any bridge mod that
 wants to restore its aging, but it never acts on that number itself.) See
 [Compatibility](Compatibility.md).
 ## Redemption: the secret becomes real
 When a hidden item is finally used, it turns real:
 1. It is made from the material it was whittled from (or the item's default material, if it was never
   made from a material).
 2. Anything it held inside is poured back in.
 3. It is placed into the pawn's inventory. If that somehow fails, nothing is dropped and nothing is
   lost.
 4. The secret is cleared from the stash.
 The trigger for this is a breakout. When a prisoner enters an escape or assault-the-colony state, they
 will arm themselves and then use whatever they are hiding — the same moment a base-game prisoner would
 reach for a combat drug. The one contraband hook Ludeon wrote and then left reading an always-empty
 inventory is exactly where this slots in. For each thing a pawn is hiding:
 - **Inert contraband** (a drug, a stashed rifle — nothing special to "use"): just materialise it and
  get out of the way. Vanilla takes the drug on its own; a weapon in inventory is a weapon. But a
  stashed **weapon** only comes out for someone who would actually use it — the same person who would
  not stop to pick a rifle off the floor does not become a fighter because the knife was in their
  sock, and a pawn incapable of violence never does at all. If they qualify, the weapon moves into
  their hands; otherwise it stays hidden and they run. See [Improvised Weapons](Improvised-Weapons.md).
 - **Active contraband** (something with a special use — e.g. Foul Play's throw-the-carboy):
  materialise it, then hand off to that item's own use behaviour.
 ## Confiscation, and the door every route comes through
 When a warden finds contraband, it is simply removed. It **never becomes a real item** — the warden
 found it, and there is nothing to drop on the floor. (This is why searching is not a way for the
 colony to *acquire* a prisoner's drugs; it is a way to *deny* them.)
 At the other end, there is one single door that **every** supply route comes through — intake uses it,
 a bent warden uses it ([Corruption](Corruption.md)), and a smuggling gangmate
 ([Institution: Gangs](Compatibility.md)) uses it. It hands a prisoner something already finished and
 hidden, optionally with contents. One door, many keys.
 ## Saving
 Concealed contraband is saved with your game — the whole stash, the per-pawn search cooldowns, and who
 has already been intaken. On load, any secret whose pawn or item no longer exists is quietly dropped:
 prisoners who died or left take their secrets with them.
 ## Quick reference
 | Constant | Value | Meaning |
 |---|---|---|
 | Heartbeat | every 250 ticks | poll cadence for intake / tunnels / improvisation |
 | Intake base chance | 0.60 | per-item, before nature × nurture |
 | Intake gate | held + body-hideable | only pawns in custody, only items small enough to palm |
 | Hard-drug concealability | 0.75 | inferred from being a hard drug |
 | Other-drug concealability | 0.50 | inferred |
 | Light-weapon concealability | 0.70 | mass ≤ 2.0 kg, hides on body |
 | Heavy-weapon concealability | 0.35 | 2.0–10.0 kg, in cell only |
 | Unhideable mass | > 10.0 kg | not contraband |
 ---
 *Part of the **Institution** suite — Core · Contraband · Justice · Gangs, alongside Foul Play and
 Ward. Each stands alone; together they interlock.*
@@ -0,0 +1,111 @@
 # Corruption
 *A search is only as thorough as the warden running it, and a warden is a person with their own
 diligence and their own price.*
 The counter to contraband is the [warden search](Warden-Search.md) — but a search is not a machine. It
 is a human being with traits and a mood, and Contraband models that human being on **two axes, both
 read off the same vanilla traits, mood, and relationships — no new stat to maintain**:
 | Axis | Question | Effect on a search |
 |---|---|---|
 | **Diligence** | How hard do they look? | multiplies the find chance |
 | **Corruption** | How bent are they? | a flat chance to look away — and a route *into* the prison |
 This is *"what turns 'the game vs the player' into 'the player's own guards, each with an angle.'"* The
 prisoner you can control. The guard you assigned to watch them, you cannot.
 ## Diligence — how hard they look
 Diligence runs 0 to 1 and multiplies the whole find chance. A lax or miserable warden misses things a
 dutiful one would turn up. It starts from a baseline of **0.55** and moves with traits and mood:
 | Trait / factor | Δ Diligence | Reasoning |
 |---|---|---|
 | Industrious | +0.1 per degree | a hard worker searches hard |
 | Lazy | −0.1 per degree | a lazy one frisks gently |
 | Abrasive | +0.15 | happy to toss a cell |
 | Psychopath | +0.10 | thoroughness without squeamishness |
 | Kind | −0.20 | reluctant to be rough |
 | Mood | ×0.6 (miserable) .. ×1.1 (content) | morale is thoroughness |
 ## Corruption — their price
 Corruption also runs 0 to 1. In a search, a bent warden gets a flat chance to **look away** on each
 item they would otherwise have a shot at finding — that chance is their Corruption × 0.6, rolled per
 hidden item before the find roll. Corruption starts from a baseline of **0.04** (most guards are
 mostly honest) and moves with traits and mood:
 | Trait / factor | Δ Corruption | Reasoning |
 |---|---|---|
 | Greedy | +0.40 | the classic bent guard — everyone has a number |
 | Kind | +0.15 | looks the other way out of sympathy, not money |
 | Ascetic | −0.10 | wants nothing, so cannot be bought |
 | Abrasive | −0.05 | too surly to do anyone a favour |
 | Mood | ×1.6 (miserable) .. ×0.7 (content) | a happy guard is harder to tempt |
 ## The Kind warden is a double liability
 Read the two tables together and one trait jumps out. **Kind** *lowers* Diligence (−0.20) **and**
 *raises* Corruption (+0.15). The gentle guard both frisks softly and bends the rules out of pity — the
 worst warden you can put on a contraband detail, and the least obvious one, because "kind" reads as a
 virtue everywhere else in the game. Meanwhile **mood** cuts the same way on both axes: a miserable
 warden looks *less* hard and is *more* temptable. A depressed guard is a sieve at both ends.
 ## Worked examples
 Find chance for a hidden item is roughly the base find chance × Diligence, with a separate look-away
 chance (Corruption × 0.6) to ignore it entirely. Assume a mid-skill warden whose raw find chance on a
 shiv is around 0.30 before disposition:
 | Warden | Diligence | Corruption | Look-away/item | Net on a 0.30 shiv |
 |---|---|---|---|---|
 | Neutral, content | ~0.61 | ~0.03 | ~2% | thorough-ish: ~0.18 find |
 | Abrasive + Psychopath, content | ~0.88 | ~0.02 | ~1% | a nightmare for prisoners: ~0.26 find |
 | Greedy, content | ~0.61 | ~0.31 | ~18% | looks capable, pockets bribes |
 | Greedy, **miserable** | ~0.37 | ~0.62 | ~37% | ignores contraband over a third of the time |
 | Kind + **miserable** | ~0.25 | ~0.27 | ~16% | a sieve at both ends: ~0.07 find |
 (Numbers rounded; mood taken as content ≈ 100% or miserable ≈ 20%.) The takeaway is that **who you
 assign to search matters as much as whether you search at all.** A greedy, miserable warden is not a
 guard — he is a supply line you are paying to pretend otherwise.
 ## The bent warden as a supply route *in*
 Corruption is not only "looks away." The other half is reaching *in* — a bent guard who slips a
 prisoner contraband through the very same door a smuggler or a gangmate uses. Only what can ride on a
 body gets slipped across a handshake. Whether and when a guard does this is gated on that guard's
 Corruption.
 In Contraband on its own, this "smuggle in" ability exists but is not yet wired to an in-game trigger.
 It is the seam **Institution: Gangs** drives when a gang's outside members pay a bent warden to make a
 delivery, and the thing a planned secure-zone checkpoint that frisks *guards* is meant to catch.
 Search-side corruption (looking away) is fully live today; reach-in corruption is the hook the rest of
 the suite plugs into. See [Compatibility](Compatibility.md).
 ## How to play with it
 - **Vet your wardens.** A Greedy or Kind pawn on prison duty is a liability the trait tooltip won't
  warn you about. Ascetic and Industrious make the best searchers; Psychopath and Abrasive are
  brutally effective if you can stomach them.
 - **Watch mood.** A prison-duty warden in a slump is failing at both jobs — searching *and* not
  smuggling. Keep your guards content or rotate them out.
 - **Redundancy beats brilliance.** Because each search is one shot per prisoner per day and even a good
  warden misses a well-hidden shiv, a *second* diligent warden over time matters more than a single
  perfect search.
 ## Quick reference
 | Constant | Value | Meaning |
 |---|---|---|
 | Diligence baseline | 0.55 | before traits and mood |
 | Corruption baseline | 0.04 | most guards are mostly honest |
 | Diligence mood scale | ×0.6 .. ×1.1 | miserable → content |
 | Corruption mood scale | ×1.6 .. ×0.7 | miserable → content |
 | Look-away multiplier | ×0.6 | applied to Corruption, per item |
 | Smuggle payload | body-hideable contraband only | what fits in a handshake |
 ---
 *Part of the **Institution** suite — Core · Contraband · Justice · Gangs, alongside Foul Play and
 Ward. Each stands alone; together they interlock.*
@@ -0,0 +1,126 @@
 # Institution: Contraband
 *Prisoners get hold of things they should not have. Wardens turn the cell over looking for them.*
 This is the player-facing wiki for **Institution: Contraband**, a RimWorld 1.6 mod. It documents
 every mechanic with the real numbers, explains why each one works the way it does, and tells you how
 to play with them — and against them.
 > **Note on scope.** Contraband was recently *split*. It is now one thing: the **physical smuggling
 > loop** of a prison. The engine it used to carry — a pawn's criminal propensity, the criminal
 > record, and which pawns count as "in custody" — now lives in **Institution: Core**, which this mod
 > requires. The response systems (classification, deterrence, discipline, parole, regime) went to
 > **Institution: Justice**, and the gang network to **Institution: Gangs**. When this page mentions
 > "the record" or "a pawn's propensity," those belong to Core; Contraband reads them.
 ## The one idea
 The whole Institution suite rests on a single sentence:
 > **Every pawn has a criminal propensity on a spectrum — nature (traits) × nurture (circumstance,
 > mood, treatment) — and the colony can police it.**
 Contraband is the half of that sentence you can *hold in your hand*. A propensity is abstract until a
 disposed prisoner files a blade off his bunk, palms a twist of yayo on the way into a cell, or starts
 digging. Contraband is where the spectrum becomes an object with edges.
 ## Vanilla built the demand and forgot the supply chain
 RimWorld already ships a fully-built junkie. Raiders spawn addicted and carrying combat drugs. You
 down one, capture strips everything, and now withdrawal grips them in the cell. A prisoner already
 *seeks* a drug on their own, and already *ignores* the forbidden flag inside their own cell.
 Put a drug within reach of an addicted prisoner and the base game makes them take it. Today. The
 consumer, the craving, the reach, the ignore-forbidden — all of it already works.
 What does **not** exist is any answer to two questions:
 | Vanilla has | Vanilla lacks |
 |---|---|
 | A prisoner who wants contraband | Any route for contraband to reach the cell |
 | A warden with fifteen jobs | A sixteenth called *search* |
 The base game's warden can chat, convert, feed, execute, enslave, release, suppress — and cannot look
 in a pocket. Contraband builds exactly the missing two halves: **supply** and **search**. It does not
 need to build the junkie, because Ludeon already did.
 ## Concealment is a secret, not an item
 This is the load-bearing design decision:
 > **While it is concealed, there is no item.**
 A hidden shiv is not in the gear tab. There is no icon. There is no stack on a shelf. The player is
 told **nothing**. The item does not become a real object in the world until exactly two moments:
 - when the prisoner **uses** it (it appears in their inventory), and
 - when a warden **finds** it in a search (it is confiscated and never becomes an item at all).
 Why go to the trouble? Because *an item you can see in the UI is not contraband* — it's inventory, and
 there would be nothing to discover and no reason to ever order a search. The whole tension of the
 system is that **you never know**. A warden you send to toss a cell might find a blade, might foil a
 tunnel, or might waste twenty minutes on a prisoner who was hiding nothing — and that empty search
 still has to cost, or the mere *offer* of the job would be the discovery.
 Read the full lifecycle in **[Concealment and Intake](Concealment-and-Intake.md)**.
 ## The four supply routes and the one counter
 | Route | What it is | Page |
 |---|---|---|
 | **Intake** | A captive hides the small contraband they walked in with | [Concealment and Intake](Concealment-and-Intake.md) |
 | **Improvise** | Whittle a shiv from the cell's own furniture | [Improvised Weapons](Improvised-Weapons.md) |
 | **Tunnel** | Dig out under the perimeter with a filed pick | [Tunnels](Tunnels.md) |
 | **A bent warden** | A greedy or over-kind guard smuggles *for* a prisoner | [Corruption](Corruption.md) |
 | **The counter** | A prioritized cell toss that reads the tells | [Warden Search](Warden-Search.md) |
 And because every guard is a person with their own diligence and their own price, the search is only
 as good as who you send — see **[Corruption](Corruption.md)**.
 ## How everything is contraband without a list
 Contraband names no items. It recognises three kinds of thing:
 1. **Anything explicitly marked as contraband** — the opt-in, with pluggable behaviour a mod can
   supply.
 2. **Every drug** — vanilla's, Vanilla Expanded's, mods that don't exist yet. Hard drugs conceal
   better (0.75 vs 0.5).
 3. **Every weapon** — how well it hides, and where, is decided by its **mass**. A knife rides on the
   body; a heavy gun goes under the floor; a minigun (over 10 kg) hides nowhere.
 It reads the item's own stats rather than editing anything. Nothing changes another mod's items.
 Details in [Concealment and Intake](Concealment-and-Intake.md) and [Compatibility](Compatibility.md).
 ## Index
 - **[Concealment and Intake](Concealment-and-Intake.md)** — the secret model, where a thing can hide,
  the three kinds of contraband, intake on capture, redemption, and how a smuggled vessel keeps its
  contents.
 - **[Improvised Weapons](Improvised-Weapons.md)** — the shiv whittled from furniture, how its
  material carries through, the damage tell, and who reaches for it in a breakout.
 - **[Tunnels](Tunnels.md)** — the Prison-Architect dig under the perimeter, which pawns dig, and how a
  search uncovers the shaft.
 - **[Warden Search](Warden-Search.md)** — the prioritized search, how tells and the record drive
  priority, what a search does, and how it feeds back.
 - **[Corruption](Corruption.md)** — Diligence and Corruption from traits and mood, how they scale a
  find, and the bent warden who looks away or smuggles in.
 - **[Compatibility](Compatibility.md)** — the Core dependency, the Foul Play bridge, Justice/Gangs
  interplay, and the prison mods the suite is tested against.
 ## The suite
 Each mod stands alone as an install; together they form one system.
 | Mod | Owns | Depends on |
 |---|---|---|
 | **Institution: Core** | propensity, criminal record, secured context | base game |
 | **Institution: Contraband** (this) | concealment, intake, shivs, tunnels, search, corruption | Core |
 | **Institution: Justice** | classification, deterrence, discipline, parole, regime | Core |
 | **Institution: Gangs** | gangs as contraband economies | Core, Contraband, Justice |
 | **Foul Play** | vessel + substance + throw framework; the Piss Nuke; bridges its carboy in as contraband | standalone |
 | **Ward** | a ward prison mode | — |
 ---
 *Part of the **Institution** suite — Core · Contraband · Justice · Gangs, alongside Foul Play and
 Ward. Each stands alone; together they interlock.*
@@ -0,0 +1,176 @@
 # Improvised Weapons
 *The supply route you cannot deny — because you are obliged to furnish the cell, and the furniture is
 the raw material.*
 You have to give a prisoner a bed. RimWorld will nag you until you do. That bed is a frame of wood, or
 steel, or — if you built a nice prison — plasteel. Give a disposed prisoner a season of unsupervised
 time with it and they will file a blade off it. **The prison's own furnishings are the arsenal, and
 better furniture is worse.**
 ## The shiv
 The shiv is a crude stabbing weapon: *"A blade filed off a bed frame and wrapped in cloth for a grip.
 Barely a weapon — but a barely-a-weapon in a cell you thought was empty is a dead guard."*
 | Stat | Value |
 |---|---|
 | Tech level | Neolithic |
 | Mass | 0.4 kg |
 | Concealability | **0.75** (hides very well — it rides on the body) |
 | Hides | on body or in cell |
 | Point (Stab) | power 7, cooldown 1.5 s |
 | Handle (Blunt) | power 5, cooldown 1.6 s |
 | Use | none — an armed prisoner *is* the payload |
 Its stats come from its material: it can be made of metal, wood, or stone. A wood shiv is feeble; a
 plasteel one is vicious. That is the whole point of the harvest mechanic — you never furnished a cell
 thinking of it as an armoury, but that is what it is.
 ## Who whittles: the disposition gate
 Not just "any prisoner." Three things must all be true:
 1. **Held.** The pawn is a prisoner, slave, or ward patient. Free colonists do not whittle shivs in
   the commons — *yet* (the concealment layer already tracks them; only the authority to act on them
   is missing).
 2. **Disposed.** A base chance of **0.10**, scaled by Core's nature × nurture. It is a *fixed fact*
   about the pawn — the mistreated, high-propensity lifer chews his bed apart; the frightened cook
   never does, and never would have, no matter how many times you reload.
 3. **Material in reach.** There is a workable source (see below).
 The base is deliberately low. Most prisoners are not making weapons. When one is, that is a fact about
 *who they are and how you keep them*, and the tell it leaves is meant to point you at exactly that
 pawn.
 ## The source: what counts as raw material
 The prisoner looks for the nearest reachable, damageable, usefully-made piece of furniture:
 - **Their own assigned bed first** — it is right there in the cell.
 - Otherwise the **closest artificial building within 12 tiles** that qualifies.
 To be a workable source, a piece of furniture must be:
 | Requirement | Why |
 |---|---|
 | Made of a material | you cannot whittle a blade out of nothing |
 | Damageable | it has to take a beating |
 | Made of metal, wood, or stone | cloth and leather cannot be filed into a blade |
 | Reachable, even through danger | they have to get to it |
 This is also the counter-play. A cell furnished only in cloth and hydroponics offers nothing to file.
 A steel bed offers a steel shiv. **What you build the cell out of decides whether it can become a
 weapon, and how nasty that weapon is.**
 ## Harvest by damage: the tell *is* the mechanic
 Each heartbeat, a whittling prisoner chips at the source — roughly **1.2% of its max hit points per
 worked poll**, as blunt damage.
 The damage is not a side effect — it is the point. A gnawed bed is **probable cause**. The same tick
 that advances the shiv damages the furniture, and that visible wear is what
 [Warden Search](Warden-Search.md) reads to send a guard to the *right* prisoner first: a badly damaged
 bed shoots a prisoner to the top of the search priority list. Whittling a shiv is loud, in the only
 sense that matters — it leaves a mark you can act on.
 Because the source takes real damage, a determined prisoner can **reduce a piece of furniture to
 wreckage and move on to the next**: if the source is destroyed before the shiv is finished, they look
 for another, and if there is none, the route **stalls** (progress is kept, not lost). A materially
 poor cell is a real defence — the prisoner cannot make progress with nothing to file.
 ## How long, and the material it becomes
 A shiv takes roughly **1.5 unsupervised days** of active work, jittered ±25% each poll so no two
 shivs finish on the same schedule.
 When it is finished, it happens **silently** — the player is told nothing. Two things happen:
 - **Material carry-through.** The shiv is made of whatever the source was made of. A wood bed yields a
  wood shiv, a plasteel bunk a plasteel one, and its combat stats follow.
 - **The record.** The pawn's tally of contraband made ticks up (in Core's record). That number feeds
  the warden's future suspicion of this pawn and, if you run **Institution: Justice**, their security
  classification.
 ## The shiv comes out in a break — and who reaches for it
 A hidden shiv is inert until a breakout. When a prisoner enters an escape or assault-the-colony state,
 they will use what they are hiding — but a **weapon** only comes out for someone who would actually
 use it. That is the same test that decides whether an escapee even bothers to pick a weapon off the
 floor.
 This matters because **vanilla escapees never arm themselves at all.** The base game has the behaviour
 for opportunistically grabbing a weapon, and simply leaves it out of the escape flow, so a base-game
 prisoner walks out unarmed, always. Arming is genuinely new behaviour, so it is kept rare enough that
 when it happens you recognise *who* did it.
 ### Would this pawn arm itself?
 First a **hard gate**: a pawn who is incapable of violence never arms, ever — a pacifist who picks up
 a rifle is not a rare event, it is a bug. Otherwise the chance is the pawn's **disposition** (who they
 are, fixed) times their **circumstance** (what is happening right now), capped at **0.85** and settled
 once per pawn as a fixed fact.
 **Disposition** — who they are, fixed, nothing about today changes it. A base of 0.10, scaled by trait
 and skill:
 | Factor | Value |
 |---|---|
 | Bloodlust | ×2.5 (highest applicable trait only — not a stack) |
 | Psychopath | ×2.0 |
 | Brawler | ×1.8 |
 | Wimp | ×0.3 |
 | Kind | ×0.4 |
 | skill | scales with their best of Shooting or Melee → range **0.5 .. 2.0** |
 *Being captured in a raid does not make someone a fighter* — plenty of prisoners are cooks and
 conscripts. A weapon is only worth grabbing if you know what to do with it, hence the skill term.
 **Circumstance** — what is happening right now, live:
 | Condition | Effect | Reasoning |
 |---|---|---|
 | Health < 50% | ×0.4 | badly hurt people run or crawl; they don't seek a fight |
 | ≥ 2 other prisoners escaping within 12 tiles | ×2.0 | a crowd emboldens; one man slips out, six men riot |
 | An armed colonist within 20 tiles | ×1.8 | now a weapon is not bravado, it's the plan |
 ### Which weapon they reach for
 An arming escapee prefers, in order:
 1. **Their own dropped weapon** — the gun they carried when you downed them, still lying where it fell
   within 45 tiles. The base game remembers where it fell and then never uses that for prisoners. *"A
   man walking back to the spot where his own rifle fell is a better story than a man rummaging through
   your stockpile."* A prisoner does not care that you marked it forbidden.
 2. **Anything to hand** within 18 tiles — but only for a pawn over a higher disposition floor (0.35).
   Rummaging a stockpile is a further step than grabbing your own gun back.
 A concealed shiv slots into this the natural way: a prisoner who has been sitting on a blade and who is
 the sort to use it does not leave it in his pocket — it goes straight into his hand. The pawn who
 would *not* arm keeps it hidden and runs — and the shiv survives to be found in a later search, or
 used in a later break.
 ## Not only shivs: the crude pick
 The same whittling behaviour makes the **crude pick** — filed off furniture exactly the same way, with
 the same disposition gate and the same damage tell — but its purpose is a tunnel rather than a fight.
 See [Tunnels](Tunnels.md).
 ## Quick reference
 | Constant | Value | Meaning |
 |---|---|---|
 | Improvise base chance | 0.10 | before nature × nurture; fixed per pawn |
 | Damage per worked poll | ~1.2% of source max HP | blunt; the visible tell |
 | Source search radius | 12 tiles | own bed first, then nearest workable furniture |
 | Time to finish a shiv | ~1.5 active days | jittered ±25% per poll |
 | Workable material | metal / wood / stone | cloth and leather cannot be whittled |
 | Shiv concealability | 0.75 | hard to find on the body |
 | Arm chance cap | 0.85 | after disposition × circumstance |
 | Own-weapon reach | 45 tiles | their dropped weapon |
 | Any-weapon reach | 18 tiles | scavenge floor 0.35 disposition |
 ---
 *Part of the **Institution** suite — Core · Contraband · Justice · Gangs, alongside Foul Play and
 Ward. Each stands alone; together they interlock.*
@@ -0,0 +1,158 @@
 # Tunnels
 *The Prison-Architect dig: a disposed pawn goes down, not through — under the ground and everything
 built on it, out past the last wall you were relying on.*
 A locked door stops a prisoner who wants to walk out. It does nothing at all about a prisoner who
 digs. This is the escape that ignores your perimeter, because it does not cross it — it goes beneath
 it. It is slow, it is quiet, and it works for pawns who would never join a mood-driven riot.
 ## The crude pick
 The dig needs a tool. The crude pick is filed off the cell's own furniture exactly the way a shiv is —
 same disposition gate, same damage-to-furniture tell; see
 [Improvised Weapons](Improvised-Weapons.md). Where the shiv is a weapon, this is a *way out*: it
 carries no combat stats and is never equipped.
 | Stat | Value |
 |---|---|
 | Description | *"Useless as a weapon and useless above ground — but pointed downward, patiently, it is a way out that no lock and no guard can see."* |
 | Max HP | 60 |
 | Mass | 1.2 kg |
 | Concealability | **0.5** |
 | Hides | in cell only (too bulky to ride on a body) |
 | Deteriorates | yes |
 Because it can only hide in the cell, a warden turning over the *room* can find the pick itself — and,
 far more easily, the hole it is digging.
 ## A second secret riding on the first
 A tunnel is *"the third thing a contraband item can be, after 'made' and 'used in a break': a thing
 you dig your way OUT with, quietly, over days."* It is deliberately **not a job** you can catch a pawn
 performing. There is no supervised task a warden could walk in on and interrupt — only a secret that
 grows and a wall that eventually gives. The dig advances on the same 250-tick heartbeat that makes
 contraband, so *the same search that finds a shiv can find the tunnel*.
 The pick must first be **made** (or smuggled). Only once it is finished does the dig begin, as a
 second, longer secret carried on the same hidden pick.
 ## Who digs
 Digging gates on three things:
 1. **A person, and held** — prisoner, slave, or ward patient.
 2. **The disposition to dig for weeks:** a base chance of **0.08** — deliberately below the shiv's
   0.10. *"Fewer pawns will dig for weeks than will palm a shiv."* It is a fixed fact about the pawn.
 3. **A viable plan exists** — there has to be somewhere to surface (see below).
 This is the entire reason tunnels live in Contraband and not in a prisoner-only escape mod:
 > It works for prisoners **and ward patients** alike. Prisoner Realism's escapes are for "mood
 > prisoners" mid-break bashing a door, and a committed ward patient is never that pawn. A patient with
 > a filed-down pick and the disposition to use it can still, slowly, dig out — and nothing else in the
 > ecosystem lets them.
 ## Planning the dig: aim for the wilderness
 The target is **not** the cell wall. *"You do not go through the wall, you go under it."* The pawn
 aims for the **nearest wilderness** — the first standable spot, scanning outward up to **60 tiles**,
 that opens onto the map edge and is not the room they are held in.
 Two consequences fall straight out of that:
 - **Depth is your defence, and a single wall is not.** A tunnel from a deep bunker is a long dig; a
  tunnel from a shack against the map edge is a short one. Wrapping one more wall around a cell does
  almost nothing — the dig already ignores intervening walls entirely.
 - **A fully enclosed, map-locked base with no reachable edge has nowhere to surface.** The plan fails,
  no progress is made, and the tunnel **stalls** — progress is kept, not lost. Seal the map and the
  shaft simply waits.
 ### How long
 Dig time scales with how deep the cell sits — about **6 cells of depth per day**, clamped between 3
 and 15 days, and jittered ±25% each poll:
 | | Days |
 |---|---|
 | Minimum (shallow cell near the edge) | **3** |
 | Maximum (deep bunker) | **15** |
 | Per day of digging | ~6 cells of depth |
 The floor of 3 days keeps even the shortest tunnel a *real threat window* you have time to catch; the
 ceiling of 15 keeps the deepest from being effectively forever.
 ## The tell: spoil
 A dig has to go somewhere, and the dirt is where you notice it. Each dig tick, about half the time,
 the pawn drops one tile of dirt filth where they are digging:
 > A dirt floor swallows it; a paved cell shows it — exactly where a player might notice.
 It is cheap and occasional on purpose: enough that a paved cell slowly accumulates a suspicious mess,
 not so much that it spams filth or litters a clean cell every tick. If you floor your cells, spoil is a
 genuine visual cue that someone is digging.
 ## Finding a tunnel in a search
 A tunnel is *"a second, far less hideable secret."* The pick hides at concealability 0.5, but the
 **shaft** gives itself away in proportion to how far along it is. When a warden search reaches the
 cell, an extra find chance is added on top of the tool's normal find chance — scaling up to **+0.40**
 at a nearly-finished tunnel.
 So a routine cell toss that finds a shiv can also catch a dig in progress — *"the same guard patrol
 that finds a shiv finds the hole"* — and the deeper the shaft, the harder it is to miss. A foiled dig
 counts against the prisoner the same as one that ran: on discovery, their escape-attempt tally ticks
 up, which raises this pawn's future search priority sharply (a known tunneller is the prisoner a warden
 checks first — see [Warden Search](Warden-Search.md)). The full find math is on the
 [Warden Search](Warden-Search.md) page.
 ## Breakout
 When the dig finishes:
 1. **Re-plan the exit** so it is correct even if the base changed during the weeks of digging.
 2. **Breach the outer wall or fence** the tunnel comes up beside — the *outermost* impassable wall or
   fence between the cell and the surfacing point. It is destroyed, leaving a visible hole the colony
   must repair, and proof of how they got out. An open perimeter needs no breach.
 3. **Record the attempt** — it happened whether or not they get clear of the map.
 4. **Surface beyond the perimeter.** They dug all the way out, so they emerge *outside*, not in the
   yard, with a little spoil dirt to mark where they came up.
 5. **Hand off to vanilla.** Now that they are loose and outside, the base game's prison-break flow —
   and anything layered on it, e.g. **Prisoner Realism** — takes it from there. A pawn already outside
   who no longer qualifies as an in-prison escapee simply flees on their own; the breach and the
   emergence are the real outcome regardless.
 The player gets one message: *"{pawn} has tunnelled out under the perimeter and escaped."* The tunnel
 and the pick are spent together.
 ## How to defend against it
 | Defence | Effect |
 |---|---|
 | **Floor the cells** | spoil dirt becomes visible; you can *see* a dig |
 | **Search known offenders** | a logged escape attempt is the heaviest single term in search priority |
 | **Deny the pick's raw material** | no workable furniture, no pick — same starve as the shiv |
 | **Depth** | a deeper cell is a longer dig and a wider window to catch it |
 | **Seal the map** | no reachable edge means the tunnel stalls indefinitely |
 Note what does **not** help much: adding perimeter walls. The dig goes under them and only breaches the
 *last* one on the way out.
 ## Quick reference
 | Constant | Value | Meaning |
 |---|---|---|
 | Dig base chance | 0.08 | before nature × nurture; fixed per pawn |
 | Wilderness search radius | 60 tiles | how far out it looks for a surfacing point |
 | Cells per day | 6 | dig speed vs. cell depth |
 | Min / max dig time | 3 / 15 days | clamps on depth ÷ 6 |
 | Spoil chance per dig tick | 50% | one tile of dirt filth |
 | Extra find chance | up to +0.40 | scales with how far along the dig is |
 | Pick concealability | 0.5 | in cell only |
 | On discovery / breakout | escape attempt logged | counted either way |
 ---
 *Part of the **Institution** suite — Core · Contraband · Justice · Gangs, alongside Foul Play and
 Ward. Each stands alone; together they interlock.*
@@ -0,0 +1,181 @@
 # Warden Search
 *The sixteenth warden job vanilla never wrote. A guard turns the cell over, and might find nothing —
 which is exactly why it has to cost.*
 The warden can chat, convert, feed, execute, enslave, release, suppress, and eleven other things.
 Searching a prisoner is not one of them, and no such job exists anywhere in the base game. Contraband
 adds it as a **new** warden job, not a change to an existing one, and builds it around a single hard
 rule: **the search must be able to come up empty.**
 ## Authority vs. act
 The design splits one job into two halves:
 | Half | Question it answers | Notes |
 |---|---|---|
 | The search **assignment** | **Who** may be searched? | it is ordinary warden work — a warden already has the run of the prison, so no new authority is invented |
 | The search **act** | **What** is a search? | walk to the pawn, turn them over, resolve |
 > The assignment is the authority. The act is just the act.
 Why bother splitting them? Because the enforcement layer is meant to grow. A future **Institution:
 Police** module adds a *second* authority — a cop who may stop and frisk a **free colonist** — reusing
 the same act with a **narrower reach** (a street frisk gets what is on the body, not what is under the
 floorboards). That module is an *addition*, not a rewrite, precisely because "who may search" and
 "what a search reaches" were never welded together.
 ## Who gets searched
 The search is warden work, and it sits at a deliberate spot in the warden's priorities:
 | Property | Value | Why |
 |---|---|---|
 | Work type | Warden | it is warden work |
 | Priority within warden work | **below feeding** | a starving prisoner matters more than a hidden shiv |
 | Capacities needed | Manipulation, Sight | you search with your hands and eyes |
 | Ranked by suspicion | **yes** | pick the right prisoner, not the nearest |
 That last one — ranking by suspicion rather than distance — is what lets a gnawed bed and a thick
 record send the warden to the *right* prisoner first.
 A search is offered only if all of these hold: the warden should be looking after this prisoner, the
 per-prisoner cooldown is up, the prisoner is **awake, not downed, and not in a mental state**, and the
 warden can reach them.
 Note what is **not** checked:
 > Whether the prisoner is actually hiding anything. **The warden does not know. Nobody knows until the
 > cell is turned over.** If the job were only offered when there was something to find, the mere
 > appearance of the job would BE the discovery, and searching would stop being a gamble the player
 > pays for in warden-hours. An empty search has to be possible, and has to cost.
 ### The cooldown
 The same prisoner cannot be turned over more than **once per day** (60,000 ticks). You cannot
 brute-force a well-hidden shiv by re-searching the same prisoner ten times in an hour. Every search is
 one shot, and then that prisoner is off the list for a day.
 ## Priority: the search reads the tells
 Everyone is worth a routine toss; the tells push a prisoner up the queue. Priority is built up like
 this:
 - **Base 4** — a routine toss for every prisoner.
 - **Up to +12 for a gnawed bed** — scaled by how damaged their owned bed is. A badly damaged bed
  shoots to the top.
 - **Up to +8 for their record** — prior catches (×2 each), contraband made in the past (×0.5 each),
  and foiled escape attempts (×3 each, **the heaviest term**), capped at +8 so the record cannot
  completely swamp fresh probable cause.
 | Term | Weight | Meaning |
 |---|---|---|
 | Base | 4 | a routine toss for every prisoner |
 | Gnawed bed | up to +12 | how far below full HP their owned bed sits |
 | Times caught | ×2 | already caught with contraband before |
 | Contraband made | ×0.5 | has finished contraband in the past |
 | Escape attempts | ×3 | **the heaviest term** — a known tunneller is checked first, every time |
 | (record cap) | +8 max | the record cannot completely swamp fresh probable cause |
 The record is only read here, never created. The base of 4 for everyone is not an accident —
 **innocent prisoners still get frisked**, because the search must be able to come up empty or its mere
 offer would be the discovery.
 **Worked example.** A prisoner whose bed sits at 40% HP (so 60% missing), with 2 prior catches and 1
 foiled tunnel:
 > 4 + (12 × 0.6) + min(8, 2×2 + 1×3) = 4 + 7.2 + 7 = **18.2**
 versus **4** for a clean prisoner with an intact bed. The warden walks past the quiet one and goes
 straight for the one who has been busy. This closes the loop
 [Improvised Weapons](Improvised-Weapons.md) opens: whittling a shiv chews the bed, the damage is
 probable cause, and the warden's *suspicion* — not the player's eye — sends them to search.
 ## The act: what a search does
 The searcher walks to the subject, spends a **900-tick** turn with a progress bar, then resolves.
 Resolution always does two things, hit or miss:
 1. Starts the daily cooldown on that prisoner.
 2. Ticks up how many times this pawn has been searched — *"classification and the guard's future
   suspicion read how often this pawn has been turned over."*
 Then it goes through everything the subject is hiding that this search can **reach** (a full warden
 search reaches both the body and the cell; a narrower future street-frisk reaches only the body). If
 nothing is reachable, the job ends here — the time was still spent, and the player is told nothing.
 ### Find math, per hidden item
 For each reachable secret, the chance to find it is built like this:
 - Start from a **base of 0.35**, plus **0.03 for each level of the warden's Social skill**.
 - Scale by how concealable the item is: the factor pivots at concealability 0.5. A drug at 0.5 is
  average (×1.0), a shiv at 0.75 is halved (×0.5), a heavy weapon at 0.35 is boosted (×1.3).
 - If the item is a **tunnel in progress**, add its extra find chance (up to +0.40 for a nearly
  finished shaft), and the ceiling rises.
 - Multiply the whole thing by the warden's **Diligence** — a lax, kind, or miserable guard scales it
  down.
 - Before the find roll, a **bent** warden gets a flat chance to look the other way (their Corruption ×
  0.6) even on an item they would otherwise have found.
 - The chance is clamped to between 0.02 and 0.95 (0.98 for a tunnel).
 Reading it in plain terms:
 - **Skill raises the ceiling; concealability lowers it.** Each level of the warden's Social skill adds
  a little; a well-hidden item takes a lot of it back.
 - **A good warden still misses a well-hidden shiv more often than not.** A level-8 Social warden
  searching for a 0.75-concealability shiv is already well under a coin-flip *before* Diligence scales
  it down further.
 - **A tunnel is a different story.** The pick hides at 0.5, but a nearly-finished shaft adds up to
  +0.40 and the cap rises to 0.98 — the deeper the dig, the harder it is to miss. A routine cell toss
  catches a dig in progress.
 - **The warden's own thoroughness and price** enter last: Diligence multiplies the whole chance down
  for a lax, kind, or miserable guard, and Corruption gives a bent guard a flat chance to look the
  other way even on an item they would otherwise have found. Both are on the
  [Corruption](Corruption.md) page.
 ### On a find
 - The item is confiscated — it **never becomes a real object**, nothing drops on the floor.
 - The prisoner's times-caught tally ticks up (raising future suspicion, feeding classification).
 - If it was a tunnel, their escape-attempt tally ticks up too — a foiled dig counts the same as one
  that ran.
 The player gets a message — *"{warden} searched {prisoner} and found hidden {item}"*, or the tunnel
 variant. If nothing is found the player is told **nothing**: they do not learn there *was* something,
 only that the warden's time was spent.
 ## Writing back to the record
 Every outcome updates Core's criminal record, which is what makes the search a *loop* rather than a
 one-off dice roll:
 | Tally | Updated when | Read by |
 |---|---|---|
 | Times searched | every search, hit or miss | priority, suspicion, classification |
 | Times caught | a find | priority (×2), classification |
 | Escape attempts | a foiled tunnel | priority (×3, heaviest), classification |
 If you run **Institution: Justice**, those same tallies drive a prisoner's security classification and
 feed the deterrence signal — a prison that catches contraband becomes a prison that classifies its
 troublemakers correctly and deters the next attempt. If you run Contraband alone, the tallies still
 route the warden. See [Compatibility](Compatibility.md).
 ## Quick reference
 | Constant | Value | Meaning |
 |---|---|---|
 | Base find chance | 0.35 | before skill and concealability |
 | Per Social level | +0.03 | skill raises the ceiling |
 | Find chance clamp | 0.02 .. 0.95 | (0.98 for a tunnel) |
 | Search duration | 900 ticks | one turn, hit or miss |
 | Search cooldown | 60,000 ticks (1 day) | per prisoner |
 | Priority base | 4 | every prisoner is worth a routine toss |
 | Gnawed-bed weight | up to +12 | how far below full HP their bed sits |
 | Record weight | up to +8 | caught ×2 + made ×0.5 + escapes ×3 |
 | Default reach | body + cell | narrowed by a future street-frisk |
 ---
 *Part of the **Institution** suite — Core · Contraband · Justice · Gangs, alongside Foul Play and
 Ward. Each stands alone; together they interlock.*
@@ -0,0 +1,102 @@
 # Criminal Record — the history of fact
 If [Propensity](Propensity.md) is *suspicion* — "this pawn seems dangerous" — the criminal record is
 *fact*: "this pawn **has** escaped twice and shanked a guard." The two are deliberately different
 kinds of thing. Propensity is computed fresh from who a pawn is and how they're treated; a record is a
 durable log of what they've actually done, written once when it happens and read forever after.
 There is exactly **one criminal record per pawn**, and the whole suite shares it. Classification grades
 on it, parole gates on it, the deterrence loop reacts to it, and reintegration remembers it. Because
 everyone reads the same record, no two parts of the suite can disagree about a pawn's past.
 ---
 ## What a record remembers
 A record is a small set of counters plus two special marks. Core provides the record and keeps it
 safe; the individual events are logged by whichever mod they happen in.
 | What it tracks | Starts at | Meaning | Tracked by | Used by |
 |---|---:|---|---|---|
 | Crimes committed | 0 | count of committed crimes | Justice (and gang fights) | classification risk score, deterrence |
 | Escape attempts | 0 | breakout attempts | Contraband | classification risk score |
 | Contraband made | 0 | items brewed / whittled | Contraband | classification risk score |
 | Times searched | 0 | how often searched | Contraband (warden search) | search prioritisation |
 | Times caught | 0 | searches that found something | Contraband (warden search) | classification risk score |
 | Last crime | never | when the most recent crime happened | Justice | recency / cooldown checks |
 | Reform | 0 | rehabilitation score (see below) | Justice (discipline, parole) | **Propensity's Nurture**, parole gate, reintegration |
 | Pardoned | no | granted a clean slate after genuine reform | Justice (on release) | parole gate, reintegration |
 "Last crime" starts at *never* — a distinct value from "at the very first moment of the game."
 Everything else starts at zero / no.
 > **Who logs what.** Core is the *vault*, not the *clerk*. It hands out records and keeps them; the
 > actual "a crime just happened, add one" logging lives in the mod where the event occurs. The columns
 > above name which mod does that — Core itself only holds the fields.
 ## Reform — the pivot of the suite
 Most of a record is inert tallies. **Reform** is the one entry that feeds back into behaviour, and it's
 worth its own section. It's raised by good treatment and good conduct, decays without either, and can
 be driven negative by harsh punishment. A record is where a sentence's *outcome* is stored, and three
 systems lean on that one number:
 - **[Propensity](Propensity.md)'s Nurture** scales a pawn's disposition by their reform score — so a
  genuinely rehabilitated pawn (reform above 0) is calmer *for good*, and a prisonized one (reform
  below 0) is inflamed *for good*. This is how institutionalization and recidivism enter the game
  without a separate mechanic bolted on.
 - **Parole** (Justice) gates release on it: a pawn is only releasable once reform clears a threshold.
  It's the number that says "this one is ready."
 - **Reintegration** reads it to decide when a clean slate is earned — which is what the *pardoned*
  mark records.
 The negative range isn't a bug — it's the "hardened" end of the spectrum, and Nurture is written to
 expect it.
 ## Pardoned and blank records
 The **pardoned** mark flips on exactly once, after genuine reform, so reintegration can grant a clean
 slate without erasing the history that earned it — the counters stay, but the pawn is marked forgiven.
 A record counts as **blank** when nothing meaningful has ever been written to it: no crimes, no escape
 attempts, no contraband, never caught, reform still 0, not pardoned. Note what blankness *ignores*:
 times searched and the last-crime time aren't part of the test. A pawn who was searched and found clean
 — searched but never caught, never a crime — still counts as blank. That's intentional: being
 *checked* is not a mark against you, only being *found* is.
 ---
 ## Records are created only when needed
 Records are made lazily. A pawn only gets a record the first time something is actually **written** to
 it — a crime, a search that found something, a reform change. Simply **reading** a pawn's disposition
 never creates one.
 That distinction matters because Propensity's Nurture reads a pawn's reform score constantly, on every
 pawn on the map, as part of judging their mood. If merely checking disposition created a record, every
 mood check would stamp a criminal file onto every innocent pawn on the map. Because reading only peeks
 — and tolerates a pawn having no record at all — the innocent stay off the books.
 The rule the whole suite follows: **something happened → a record is created and written; just looking
 → no record is created.**
 ---
 ## Persistence
 Records save with your game and reload with it, and there's exactly one shared store for the whole
 colony — no mod keeps its own private copy, which is what keeps them all agreeing with each other.
 On load, that store cleans itself up. Three kinds of record get dropped:
 1. **Records of pawns who are gone** — dead or removed. They take their records with them.
 2. **Corrupt entries** — a guard against a broken save.
 3. **Blank records** — anything still blank. There's no reason to keep a file that records nothing.
 The upshot: **records are cheap and self-cleaning.** Anything that never got a real mark written to it
 simply evaporates on the next load, so the save never bloats with one empty file per pawn ever glanced
 at.
 ---
 *Part of the **Institution** suite.*
@@ -0,0 +1,88 @@
 # Institution: Core — Wiki
 *The shared foundation of the **Institution** suite: a set of RimWorld 1.6 mods about what an
 institution does to the people inside it, and the crime, policing, and justice that put them there.*
 Core is the engine every other Institution mod runs on. **On its own it changes nothing you can
 see** — no items, no jobs, no new menus. It sits completely quiet until another Institution mod is
 installed on top of it. You install Core only because something else asks for it.
 This wiki explains what that hidden engine actually does once a mod above it puts it to work — down to
 the exact numbers, because knowing how the numbers move is half the fun of running a prison.
 ---
 ## The one idea
 > **Every pawn has a criminal propensity on a spectrum — nature (traits) × nurture (circumstance,
 > mood, treatment) — and the colony can police it.**
 That single sentence is the whole suite. Colonists, prisoners, and slaves drift toward crime on a
 continuous spectrum; a policing and justice layer discovers, catches, punishes, reforms, or paroles
 them. Core is where the *spectrum* itself lives — before anyone is caught, before there is a record to
 read, before there is a warden to search them.
 ## Why a shared engine
 The propensity idea didn't start out abstract. It grew up twice, in two different mods: one deciding
 which drunk, miserable pawn starts a mess, and one deciding which prisoner whittles a shiv the moment a
 door opens. Both were asking the same real question — *would **this** pawn do it?* — and each answered
 it its own way, which meant they could disagree about who was dangerous.
 Core exists so they stop disagreeing. When the contraband system, the justice system, and the gang
 system all read one disposition engine, they agree about who is dangerous instead of each judging it
 separately and drifting apart. The pawn who is "the scary one" is the scary one to every part of the
 suite at once. That coherence — not any single number — is the point of a shared foundation.
 Core carries exactly the three things every Institution mod needs and none should own alone, and
 nothing else:
 | Pillar | Answers | Page |
 |---|---|---|
 | **Propensity** | *Would this pawn do it?* (nature × nurture) | [Propensity](Propensity.md) |
 | **Criminal record** | *What has this pawn actually done?* (one history per pawn) | [Criminal Record](Criminal-Record.md) |
 | **Secured context** | *What kind of hold is this pawn under, and who may search them?* | [Secured Context](Secured-Context.md) |
 The distinction between the first two is the spine of the whole design: **propensity is suspicion, a
 record is fact.** Propensity says "this pawn *seems* dangerous"; a record says "this pawn *has*
 escaped twice and shanked a guard." Keeping them separate is what lets the colony act on evidence
 instead of on vibes.
 ## The pages of this wiki
 - **[Propensity](Propensity.md)** — nature × nurture in full: the trait-weight table, the nurture
  multiplier ladder, the disposition formula with worked examples, and why each pawn's roll is fixed
  rather than re-rolled.
 - **[Criminal Record](Criminal-Record.md)** — everything a record remembers, who fills in each part,
  how it persists across saves, and why *reform* is the pivot of the whole suite.
 - **[Secured Context](Secured-Context.md)** — the Free / Prisoner / Slave kinds, what counts as
  "held" versus what counts as "able to hide something," and why the suite keys off this instead of
  "is a prisoner."
 - **[Treatment Engine](Treatment-Engine.md)** — the shared rehabilitation maths: mark a condition
  treatable, reduce it a little each session by skill and facility quality, and build a recovery track
  toward discharge. Ward's psychiatric care and Justice's reform run on this one engine.
 - **[Modder API](Modder-API.md)** — the "for modders" page: the tools any mod can call to build on
  Core. Players can skip it.
 ## The suite
 Each mod stands alone as an install; together they form one system. Core sits underneath everything
 else.
 | Mod | What it adds | Needs |
 |---|---|---|
 | **Institution: Core** (this) | the propensity / record / context engine | base game only |
 | **Institution: Contraband** | concealment, improvised shivs, tunnels, warden search, warden corruption | Core |
 | **Institution: Justice** | classification, deterrence, discipline, parole, regime, and **policing** (colony crime → weighed arrest) | Core, Harmony |
 | **Institution: Gangs** | gangs as contraband economies: joining, smuggling, rivalry, fights-as-crime | Core, Contraband, Justice |
 | **Institution: Ward** | psychiatric care — a prisoner treated, not punished, on Core's treatment engine | Core, Harmony |
 | **Foul Play** | the vessel + substance + throw framework, home of the "Piss Nuke" | standalone; bridges to Core + Contraband |
 ## Requirements & load order
 - **RimWorld 1.6.** Core needs only the base game — no Harmony, no DLC, no other mod.
 - Load Core **before** any other Institution mod in your mod list.
 ---
 *Part of the **Institution** suite.*
@@ -0,0 +1,238 @@
 # Modder API — building on Core
 Core is a library. It has no XML, no defs, no UI — its entire purpose is to be *called*, by the other
 Institution mods and by yours. This page is the public surface, with the one seam that matters most
 (`Propensity.DeterrenceFactor`) explained in full.
 > **This page is for modders.** Every other page in this wiki is written for players; this one is the
 > technical surface for building on Core. If you just want to know how the mod plays, start at the
 > [Home](Home.md) page and the [Propensity](Propensity.md) / [Criminal Record](Criminal-Record.md) /
 > [Secured Context](Secured-Context.md) / [Treatment Engine](Treatment-Engine.md) pages instead.
 Everything here is verified against the three source files in `Source/Core/`.
 ---
 ## The namespace is `Contraband`
 Before anything else: **all of Core's types live in `namespace Contraband`**, not `Core` and not
 `Institution`. This is historical — the engine was extracted from Institution: Contraband — and it is
 not going to change under you, but it does mean your `using` looks slightly surprising:
 ```csharp
 using Contraband;   // Propensity, CriminalRecord, GameComponent_CriminalRecords,
                    // SecuredKind, SecuredContext, SecuredContexts,
                    // TreatmentProgram, TreatableConditionExtension
 ```
 Reference the assembly `InstitutionCore.dll` (packageId `flan.institution.core`) and load your mod
 after Core.
 ## The public surface at a glance
 | Call | Returns | Creates state? | Use for |
 |---|---|---|---|
 | `Propensity.Nature(pawn)` | `float 0..1` | no | fixed trait-based disposition |
 | `Propensity.Nurture(pawn)` | `float` (multiplier) | no | live circumstance multiplier |
 | `Propensity.Would(pawn, baseChance, salt, cap=0.85)` | `bool` | no | the seeded yes/no for a behaviour |
 | `Propensity.DeterrenceFactor` | `Func<Pawn,float>` field | — | the seam a justice layer fills |
 | `GameComponent_CriminalRecords.For(pawn)` | `CriminalRecord` | **yes** (blank on first ask) | write paths |
 | `GameComponent_CriminalRecords.PeekFor(pawn)` | `CriminalRecord?` | no | read paths |
 | `SecuredContexts.Of(pawn)` | `SecuredContext?` | no | one pawn's hold kind |
 | `SecuredContexts.OnMap(map)` | `IEnumerable<SecuredContext>` | no | every held/free pawn on a map |
 | `TreatmentProgram.HasTreatableCondition(pawn)` | `bool` | no | is there a marked condition to work through? |
 | `TreatmentProgram.ReduceConditions(pawn, strength)` | `void` | mutates hediffs | run one session's worth of treatment |
 | `TreatmentProgram.FacilityQuality(pawn)` | `float 0.5..1.5` | no | scale a session by the room's quality |
 | `TreatmentProgram.AdvanceRecovery(pawn, def, amount)` | `float` | **yes** (recovery hediff) | build a discharge / parole track |
 All of these are `static` and null-safe. None throws on a null pawn; they return `0.05`/`1f`/`null`/
 `false` as appropriate. See the [Propensity](Propensity.md), [Criminal Record](Criminal-Record.md),
 and [Secured Context](Secured-Context.md) pages for the mechanics behind each.
 ---
 ## Asking "would this pawn?"
 The idiomatic pattern for a new behaviour is: pick a **base rate**, pick a **stable salt** unique to
 your question, and call `Would`. Do not re-implement the nature/nurture math — that is the whole point
 of the shared engine.
 ```csharp
 using Contraband;
 // A unique, STABLE salt for this specific question. Any constant int works; keep it
 // distinct from other questions so the rolls stay independent per behaviour.
 private const int Salt_WouldStealMeds = 0x5EED01;
 if (Propensity.Would(pawn, baseChance: 0.08f, salt: Salt_WouldStealMeds))
 {
    // this pawn, under these conditions, is the kind who does this
 }
 ```
 Because the roll is seeded on `pawn.thingIDNumber ^ salt`, the answer is a stable fact per pawn per
 question and survives save/reload — so you can ask it repeatedly and get a consistent character, and
 different salts give you independent facts about the same pawn. Pass a custom `cap` if `0.85` is the
 wrong ceiling for your behaviour (e.g. a lower cap for something that should always keep a large
 chance of not happening).
 If you only need the ingredients — say, to display a disposition readout or gate a threshold — read
 `Nature` and `Nurture` directly. Institution: Gangs, for instance, joins a pawn to a gang when
 `Nature(pawn) * Nurture(pawn)` clears its own threshold, computed from these two calls rather than
 from `Would`.
 ## Reading and writing records
 Follow the one rule from the [Criminal Record](Criminal-Record.md) page — **write with `For`, read
 with `PeekFor`** — so read paths never litter the save with blank records.
 ```csharp
 using Contraband;
 // WRITE: an event happened, so we need a record to write to.
 CriminalRecord rec = GameComponent_CriminalRecords.For(pawn);
 rec.contrabandMade++;
 // READ: peek, and tolerate null (the pawn may have no record yet).
 CriminalRecord existing = GameComponent_CriminalRecords.PeekFor(pawn);
 if (existing != null && existing.reform < 0f)
 {
    // this pawn has been hardened
 }
 ```
 Core owns the storage and persistence; you own the meaning of your own events. Do not keep your own
 per-pawn crime dictionary — that is exactly the fragmentation Core exists to prevent.
 ## Working across hold kinds
 Reduce a pawn to its context and branch on the *predicate*, not the label:
 ```csharp
 using Contraband;
 SecuredContext? maybe = SecuredContexts.Of(pawn);
 if (maybe is SecuredContext ctx && ctx.IsHeld)
 {
    // prisoner OR slave OR ward patient -- all covered, no special cases
 }
 // Sweep everyone the suite cares about on a map:
 foreach (SecuredContext c in SecuredContexts.OnMap(map))
 {
    if (c.CanConceal) { /* consider hoarders too, not just the held */ }
 }
 ```
 `Of` returns `null` for anything the suite does not model (animals, mechs, the dead), so a `null`
 check is your "not our business" branch.
 ## Running a treatment programme
 Core carries the maths of "sustained attention in a secured facility reduces a marked condition and
 builds a recovery track toward discharge" — the shared engine behind Ward's psychiatric care and
 Justice's rehabilitation. Mark a hediff treatable with `TreatableConditionExtension`, then drive it
 from your own job or interaction:
 ```csharp
 using Contraband;
 float strength = skill * TreatmentProgram.FacilityQuality(pawn) * share;   // your own blend
 TreatmentProgram.ReduceConditions(pawn, strength);                          // lower the condition
 if (!TreatmentProgram.HasTreatableCondition(pawn))
 {
    TreatmentProgram.AdvanceRecovery(pawn, MyDefOf.Recovery, 0.15f * strength);   // build discharge
 }
 ```
 You own the interaction mode, the job, the recovery hediff (give it a negative `severityPerDay` so it
 decays without attention), and the discharge alert; Core owns only the numbers. Full formulas and the
 consumer contract are on the **[Treatment Engine](Treatment-Engine.md)** page.
 ---
 ## The `DeterrenceFactor` seam
 This is the most important extension point in Core, and the reason Core can remain a **dependency-free
 leaf** while a colony-wide deterrence feedback loop runs *through* it.
 ### What it is
 ```csharp
 // In Propensity:
 public static System.Func<Pawn, float> DeterrenceFactor = _ => 1f;
 ```
 A single static delegate. `Nurture` multiplies its result by `DeterrenceFactor(pawn)` as its last
 step. Out of the box the delegate returns `1f` for every pawn — perfectly neutral — so **Core alone
 behaves as if deterrence did not exist.**
 ### What it is *for*
 Deterrence is a property of the whole colony's climate of order: a well-policed colony should deter
 everyone a little; a lawless one should embolden them. That is a feedback loop — catching and
 punishing *one* pawn changes the disposition of *the rest*. But deterrence itself is a justice-layer
 concept, and Core must not know the justice layer exists.
 The seam resolves the tension. Core defines *where* the colony's climate multiplies into disposition
 (the last line of `Nurture`) without defining *what* that climate is. From the source:
 > *"Deterrence lives in the Justice layer, so Core reads it through the seam above — neutral until
 > Justice fills it. This one seam is what keeps Core a dependency-free leaf despite the deterrence
 > feedback loop running through it."*
 ### How Institution: Justice fills it
 When Institution: Justice loads, it assigns the delegate, pointing it at its own live deterrence
 level. The shape it installs maps a `0..1` deterrence reading to a multiplier that straddles `1.0`:
 ```csharp
 // Illustrative — this lives in Institution: Justice, not Core.
 Propensity.DeterrenceFactor = pawn =>
 {
    float level = DeterrenceLevelFor(pawn.Map);      // 0 = lawless, 1 = tightly policed
    return Mathf.Lerp(1.3f, 0.7f, level);            // lawless emboldens, order deters; neutral at 0.5
 };
 ```
 | Deterrence level | Factor | Effect on disposition |
 |---|---:|---|
 | `0.0` (lawless) | `1.3` | everyone ~30% more inclined |
 | `0.5` (baseline) | `1.0` | neutral — a default colony sits exactly here |
 | `1.0` (tightly policed) | `0.7` | everyone ~30% less inclined |
 *(The `1.3 → 0.7` range, neutral at the `0.5` baseline, are Justice's numbers, documented here for context;
 Core only guarantees the neutral `1f` default. Confirm against Institution: Justice's own source for
 its current values.)*
 ### How to fill it yourself
 If you are writing your own policing or morale layer and want it to feed disposition the same way,
 just assign the delegate — ideally at game load, and ideally composing with whatever is already there
 rather than clobbering it:
 ```csharp
 using Contraband;
 using UnityEngine;
 // Compose: fold your factor into any existing one (e.g. Justice's) instead of overwriting.
 var previous = Propensity.DeterrenceFactor;
 Propensity.DeterrenceFactor = pawn => previous(pawn) * MyClimateFactorFor(pawn);
 ```
 Two cautions. First, it is a single static field — if two mods both *assign* it (rather than compose),
 the last one wins, so compose when you can. Second, keep your factor bounded and centred near `1.0`:
 `Nurture` has no clamp on this term, so an extreme factor multiplies straight through into every
 pawn's `Would` roll. Return `1f` when you have nothing to say, exactly as the default does.
 ### Why a delegate and not a dependency
 The alternative — Core calling into Justice — would make Core depend on Justice, inverting the whole
 topology and breaking Core's promise that it references *only the base game*. A single assignable
 `Func<Pawn,float>`, neutral by default, lets the feedback loop run through Core while the arrow of
 dependency still points only *at* Core. It is the smallest possible seam that buys the largest possible
 decoupling, and it is why Core can sit at the bottom of the suite with zero dependencies of its own.
 ---
 *Part of the **Institution** suite.*
@@ -0,0 +1,212 @@
 # Propensity — nature × nurture
 Propensity is the suite's disposition engine. It answers one question and only one: *"would **this**
 pawn do it?"* — never *"would a prisoner,"* never *"would a colonist."* Every behaviour in the suite
 that hinges on a pawn's character comes back to this, so crime, contraband brewing, escape arming, and
 gang recruitment all read the same answer instead of each guessing.
 The model is deliberately old-fashioned: **nature × nurture.**
 - **Nature** is a fixed property of the person — their traits. Almost nobody is strongly disposed, and
  this never changes over a pawn's life.
 - **Nurture** is what the colony has done *to* them — mood, mistreatment, unmet needs, the shadow a
  sentence leaves. This is the half **you** control, and the half no other mod models.
 Good conditions pull nurture down; neglect and cruelty push it up. A saint left to rot can cross the
 line; a monster kept content and deterred may never act. Both of those stories are possible by design.
 ---
 ## Nature — who they are
 Every pawn starts from a **baseline of 0.05** — the floor of the human condition in this model:
 everyone is capable of *something*, most people barely. From there, each trait the pawn has adds or
 subtracts, and the total is held to the 0–1 range (never below 0, never above 1).
 ### Trait weights
 Traits are matched **by name**, so if a trait's mod isn't installed that entry is simply skipped.
 That's how Core uses Vanilla Traits Expanded's dark traits when VTE is present without *requiring* VTE
 to be installed.
 | Trait | Weight | Source | Note |
 |---|---:|---|---|
 | Psychopath | **+0.45** | Vanilla | no empathy; the heaviest single input |
 | Kleptomaniac | **+0.40** | Vanilla Traits Expanded | counted if VTE is installed |
 | Bloodlust | **+0.35** | Vanilla | enjoys violence |
 | Pyromaniac | **+0.30** | Vanilla Traits Expanded | counted if VTE is installed |
 | Greedy | **+0.25** | Vanilla | wants more than their share |
 | Abrasive | **+0.15** | Vanilla | friction with everyone |
 | Ascetic | **−0.15** | Vanilla | wants little, takes little |
 | Kind | **−0.30** | Vanilla | the strongest pull *down* |
 Core adds no traits of its own — it reads the ones the game and your other mods already provide.
 Vanilla's own dark traits count right alongside VTE's.
 ### Worked Nature values
 Because weights simply add and then clamp, Nature is easy to read by hand:
 | Pawn | Arithmetic | Nature |
 |---|---|---:|
 | Ordinary pawn (none of the above) | 0.05 | **0.05** |
 | Kind pawn | 0.05 − 0.30 = −0.25 → clamp | **0.00** |
 | A single Greedy trait | 0.05 + 0.25 | **0.30** |
 | Psychopath | 0.05 + 0.45 | **0.50** |
 | Psychopath **and** Kind | 0.05 + 0.45 − 0.30 | **0.20** |
 | Greedy + Abrasive | 0.05 + 0.25 + 0.15 | **0.45** |
 | Psychopath + Bloodlust + Kleptomaniac | 0.05 + 0.45 + 0.35 + 0.40 = 1.25 → clamp | **1.00** |
 Two things fall out of this. First, the clamp isn't decorative: a Kind pawn floors at exactly `0`
 (nature can never make them *disposed*, only never disposed), and a stacked monster ceilings at `1`.
 Second, traits genuinely net against each other — a Kind Psychopath is a real, middling `0.20`, not a
 contradiction.
 Most rolled pawns sit at or near the `0.05` floor. That's intended: a colony full of ordinary people
 is supposed to be mostly safe on nature alone. What makes them dangerous is nurture.
 ---
 ## Nurture — what you have done to them
 Nurture is a **multiplier**. An ordinary pawn under ordinary conditions sits at **1.0**. The number
 rises as things go wrong and falls as they go right. Each lever below stacks on top of the last.
 ### The multiplier ladder
 | Lever | Factor | Applies when | Stacks? |
 |---|---|---|---|
 | **Despair** | ×2.5 | mood below 20% | mutually exclusive with "badly kept" |
 | **Badly kept** | ×1.6 | mood 20–35% | mutually exclusive with "despair" |
 | **Held & unhappy** | ×1.4 | held **and** mood below 40% | on top of the mood lever |
 | **Prisonization** | × (depends on reform, see below) | the pawn has a non-zero reform score | on top |
 | **Deterrence** | × (the colony's climate of order) | always (neutral 1.0 with only Core) | on top |
 The two mood levers are either/or: a pawn is either in despair *or* badly kept, never both. "Held &
 unhappy" is separate and multiplies again — so a mistreated prisoner in despair compounds
 `2.5 × 1.4 = 3.5` before anything else. That is a badly run cell.
 ### Prisonization — the reform lever
 The reform lever is where a sentence leaves a permanent mark. A pawn's **reform score** runs from
 about −1 to +1 and turns into a multiplier:
 | Reform score | Meaning | Factor |
 |---:|---|---:|
 | **+1.0** | fully rehabilitated | 0.50 |
 | +0.5 | improving | 0.75 |
 | 0 | untouched (no effect) | *1.00* |
 | −0.5 | hardening | 1.25 |
 | **−1.0** | prisonized | 1.50 |
 | beyond +1.2 | (over-reformed) | floors at **0.40** |
 | beyond −2.0 | (utterly broken) | ceilings at **2.00** |
 Reform is nominally a 0-to-1 rehabilitation score, but harsh punishment can drive it **negative** —
 that's the "hardened, prisonized" end. Within the realistic −1…+1 range the factor spans 0.5…1.5; the
 0.4 / 2.0 limits only bite at the extremes, catching a pawn who's been endlessly punished or endlessly
 rehabilitated.
 Propensity only *reads* this score — nothing in Core moves it. The Justice layer's discipline and
 parole are what nudge it up or down, which is how institutionalization and recidivism enter the game
 without a separate mechanic. A pawn broken by a brutal prison stays broken (nurture ×1.5) after
 release; a pawn genuinely reformed stays calmer (×0.5) for good. The scar rides on one number.
 ### Deterrence — the climate of order
 The final lever multiplies by the colony's overall **climate of order**. **With only Core installed
 it's neutral — a flat 1.0** — because Core by itself doesn't know what deterrence is. Install
 **Institution: Justice** and it fills this in: a well-policed colony pulls the factor below 1 and
 deters everyone a little; a lawless one pushes it above 1 and emboldens them. That's what makes
 catching and punishing *one* pawn matter to the disposition of *the rest*.
 With only Core installed, this lever does nothing, and that is correct. The technical details of how a
 mod fills in deterrence are on the [Modder API](Modder-API.md) page.
 ---
 ## Would — the full roll
 Nature and Nurture are ingredients. The full roll is the meal: the actual yes/no for a specific
 behaviour at a specific base rate. For a given behaviour, the chance works out to:
 > **chance = base rate × (0.1 + Nature × 2) × Nurture**, capped at 85%.
 Three things are happening there:
 1. **Base rate** is the behaviour's own dial — how likely an *average* pawn is to do this particular
   thing (a rare act uses a small number, a common one a larger). Core doesn't decide it; whichever
   system is asking does.
 2. **(0.1 + Nature × 2)** is the nature amplifier. It spans **×0.1** (a saint, Nature 0) to **×2.1**
   (Nature 1). At the common `0.05` floor it's **×0.2** — so an ordinary pawn is one-fifth as likely
   as the base rate, while a maxed monster is over twice as likely — *before* nurture.
 3. **× Nurture** applies circumstance on top, and the whole thing is capped at **85%** by default.
   Nobody is ever a dead certainty; there's always slack. A behaviour that wants a harder or softer
   ceiling can set its own cap.
 ### Worked example 1 — an ordinary colonist, content
 Base rate 10%, an ordinary pawn (Nature 0.05), good mood so Nurture 1.0:
 - nature term = 0.1 + 0.05 × 2 = 0.2
 - chance = 0.10 × 0.2 × 1.0 = 0.02 → **2%**
 Two percent — and, critically, **fixed**. For this pawn and this question it's a settled 2% coin that
 either comes up or doesn't; it isn't re-flipped every moment.
 ### Worked example 2 — a mistreated psychopath prisoner
 A Psychopath + Bloodlust prisoner (Nature 0.85), mood 15% (despair ×2.5), held and unhappy (×1.4),
 reform −0.5 (hardening → ×1.25), Core-only so deterrence 1.0. Base rate 10%:
 - nature term = 0.1 + 0.85 × 2 = 1.8
 - nurture = 2.5 × 1.4 × 1.25 = 4.375
 - chance = 0.10 × 1.8 × 4.375 = 0.7875 → **~79%**
 Same base rate as example 1, same engine — but nature and a badly-run cell have turned a 2% pawn into
 a near-certainty. The player did that, lever by lever.
 ### Worked example 3 — hitting the cap
 A fully stacked monster (Nature clamps to 1.0), in despair (×2.5) and held & unhappy (×1.4), in a
 lawless colony where Justice has set deterrence to 1.4. Base rate 10%:
 - nature term = 0.1 + 1.0 × 2 = 2.1
 - nurture = 2.5 × 1.4 × 1.4 = 4.9
 - raw chance = 0.10 × 2.1 × 4.9 = 1.029
 - capped at **85%**
 The raw product blew past 100%; the cap reins it to 85%. Even here, a 15% sliver of "not today"
 survives. That sliver is deliberate — it keeps the worst pawn a character with a bad day coming, not a
 scripted event.
 ---
 ## The fixed roll — characters, not a dice cup
 Each pawn's answer to "would they?" is **fixed** by two things: who the pawn is (their permanent
 identity) and which behaviour is being asked about. It is not re-rolled from scratch each time. This is
 the single most important design decision on this page, and it's worth being precise about why.
 **Save/reload stability.** Because the answer is tied to the pawn's permanent identity and the specific
 question — not to the live random stream — asking "would they?" gives the same answer before and after
 a save/reload, as long as the inputs (traits, mood, reform) are the same. You can't scum a reload to
 re-roll a pawn into a different person. *Who* they are doesn't shift under them on a reload.
 **A character, not a moment-to-moment lottery.** If the game flipped a fresh coin every tick, any pawn
 would eventually do anything if you waited long enough. Fixing the roll instead makes "would this pawn
 pocket a shiv?" a settled fact about that pawn under those conditions — what makes them a character,
 not a dice cup.
 **Live circumstance still bites.** The roll freezes the *identity*, not the *situation*. Nurture is
 recomputed live, so as mood collapses or reform hardens, the same pawn's chance climbs and the same
 fixed coin can flip from "no" to "yes." The pawn who wouldn't have acted last month acts now — not
 because the dice changed, but because you let their world get worse.
 **Different questions, independent answers.** Each behaviour is its own separate question, so the
 answers don't leak into each other: a pawn who would pocket a shiv is not therefore a pawn who would
 inform on a cellmate. One pawn can be reliably one kind of trouble and reliably not another, and that
 pattern is stable across the whole game.
 ---
 *Part of the **Institution** suite.*
@@ -0,0 +1,88 @@
 # Secured Context — the kind of hold a pawn is under
 The suite has a rule that looks small and is load-bearing: **nothing keys off "is this a prisoner."**
 It keys off the *kind of hold* a pawn is under. That one step of indirection is why a ward patient, a
 slave, and (later) anyone inside a secure zone get the same concealment, search, schedule, and needs
 machinery for free, without any feature hard-coding a single pawn status.
 A pawn's secured context boils down to one of three kinds and the question "who, if anyone, may search
 them." Everything downstream reads that, so a new feature works across every kind of hold the day it's
 written, and a new *kind of hold* works across every existing feature the day it's added.
 ---
 ## The three kinds
 | Kind | Who it is | May search them | Can conceal? | Held against their will? |
 |---|---|---|---|---|
 | **Free** | a free colonist | *no one* — until a secure-area or policing layer grants standing | **yes** — they can hoard | no |
 | **Prisoner** | a prisoner of the colony | the **warden** | yes | **yes** |
 | **Slave** | a slave (Ideology DLC) | the **overseer** | yes | **yes** |
 Two subtleties fall out of this table:
 - **Free colonists can still conceal.** A free colonist can hoard contraband, but no one has standing
  to search them until a secure-area or policing layer grants it. Freedom isn't innocence — it's only
  the absence of an authority allowed to check.
 - **Prisoner and Slave differ only in who holds the keys.** Both are "held"; the search authority is
  the warden for one and the overseer for the other. Features that only care "is someone entitled to
  search this pawn" read whether the pawn is *held* and never branch on which.
 ## Two questions, two axes
 The context answers two different questions, and picking the right one is the whole skill of using it:
 | Question | True for | Ask it when you care about… |
 |---|---|---|
 | **Is this pawn held?** | Prisoner, Slave | **custody** — who is under the colony's control, who can be disciplined, whose cell can be searched |
 | **Could this pawn be hiding something?** | Free, Prisoner, Slave (any real pawn) | **contraband** — who could be *hiding* something, regardless of status |
 For example, [Propensity](Propensity.md)'s Nurture uses *held* in its "held & unhappy compounds" lever
 — it only wants to pile the ×1.4 penalty on a pawn the colony actually holds and mistreats, not on a
 grumpy free colonist. A warden-search feature, by contrast, cares who *could* be hiding something to
 decide who's even worth checking, and then checks standing to decide whether it's *allowed* to.
 ---
 ## How a pawn gets classified
 Any pawn resolves to one context, or to **nothing at all** if the suite doesn't model them:
 - Animals, mechs, and the dead are simply not the suite's business — they resolve to nothing, and
  every sweep and check skips them without a special case.
 - A pawn is tested as **prisoner** first, then **slave**, then **free colonist**. So a pawn who is
  somehow both a colonist and imprisoned is classified by their *hold* first.
 Keeping "nothing at all" separate from "a free pawn we track" is deliberate: there's a real difference
 between "a free pawn we watch" and "a pawn we don't model at all," and collapsing them would let
 non-colony pawns leak into colony machinery. A single sweep can walk every prisoner, slave, and
 colonist on a map in one pass, skipping everything that resolves to nothing.
 ---
 ## Why not just "prisoner"?
 This is the design decision the whole page exists to justify. If every feature checked "is this pawn a
 prisoner" directly, then:
 - adding **slaves** to a feature would mean revisiting every feature;
 - adding a **ward patient** mode would mean revisiting every feature;
 - adding a future **secure-zone** concept would mean revisiting every feature.
 By routing all of them through one question — *what kind of hold is this?* — a new kind of hold is
 added *once*, and every existing feature inherits it. The concealment, search, and needs machinery
 never has to learn what a slave is; it only ever asked whether the pawn is *held* and whether they
 *could conceal*.
 ### The deliberately-absent Ward kind
 There's no separate "ward patient" kind, and its absence is intentional. A committed ward patient
 **is** a prisoner in the game's own sense — Institution: Ward builds its committed-patient mode on top
 of vanilla's prisoner system — so such a pawn already counts as **Prisoner** here, with no special case
 and no dependency from Core (or Contraband) onto Ward. Every feature treats a ward patient exactly as
 it treats any prisoner. The right amount of new work to support Ward's hold semantics was zero, and
 that's the payoff of keying off the kind of hold instead of the label.
 ---
 *Part of the **Institution** suite.*
@@ -0,0 +1,94 @@
 # The Treatment Engine — shared rehabilitation
 *The shared maths behind every "fix a held pawn over time" system in the suite.*
 Core carries one more thing every rehabilitation-style system needs and none should own alone: the
 maths of a **treatment programme**. Sustained attention in a secured facility reduces a marked
 condition, the room's quality helps or hurts, and once there's nothing left to reduce a **recovery
 track** builds toward a state where the pawn can be discharged.
 It exists for the same reason the propensity engine does. Two systems want the identical loop pointed
 at different things — **Ward** treats the mental illness that got a pawn committed; **Justice**
 rehabilitates the disposition that got one imprisoned — and without a shared engine each would grow its
 own copy and drift apart. Core owns **only the maths**. Which interaction enrols a pawn, which
 conditions and moods carry the flavour, which jobs run the sessions, and which alert fires on discharge
 all live in the mod using it.
 > The engine does something only when there's a real condition to work through, and does nothing
 > otherwise. A colony that never marks anything treatable never notices it exists.
 ---
 ## How treatment plays out
 A condition has to be **marked treatable** before a programme can touch it (Ward marks mental illness
 this way; a modder or player can mark anything — see the [Modder API](Modder-API.md) page). Once a
 condition is marked, treatment runs in sessions:
 1. **Each completed session removes a slice of the condition's severity.** The base amount is **0.12
   severity per session**, *before* it's scaled by the treating pawn's skill, the facility's quality,
   and how much of the session that patient actually gets. When a condition's severity reaches zero
   it's gone.
 2. **A full course is several sessions by design.** The programme has to be *sustained* — you can't
   fix a pawn in a single visit.
 3. **Once nothing is left to treat, continued care builds a recovery track** from 0 toward 1
   (discharge-ready). Fix the illness first, then stabilise.
 4. **The recovery track decays on its own if you stop.** Recovery you stop maintaining slips back down
   — which is what makes the whole thing a loop you keep up, not a one-time unlock.
 ---
 ## The numbers
 ### Facility quality
 The room the treatment happens in scales every session between **0.5×** (grim) and **1.5×**
 (excellent):
 | Room | Factor |
 |---|---:|
 | Bare (0 impressiveness) | 0.60 |
 | Decent (~48 impressiveness) | 1.00 |
 | Impressive (108+ impressiveness) | 1.50 (capped) |
 | Outdoors / no room | 0.75 |
 The limits are deliberate: a grim, filthy, cramped facility heals worse and a calm clean one better,
 but a palace can't trivialise the work the programme costs (1.5× ceiling), and even treating a pawn out
 in the open is a poor makeshift room (0.75×), not a hard zero.
 ### Reducing a condition
 Each marked condition drops by **0.12 × the session's combined strength** per session, and vanishes
 when it hits zero. That combined strength is the treating pawn's skill × the facility quality above ×
 the patient's share of the session — so all three inputs matter, and a good therapist in a good room
 working one-on-one is worth many times a poor one splitting attention in a bad room.
 ### Building recovery
 The recovery track is a plain 0-to-1 progress bar toward discharge. Continued care adds to it (capped
 at 1.0) and — crucially — it carries a slow decay, so it slips back down without sustained attention.
 The mod using the engine decides what reaching the top actually *unlocks* (Ward: a "ready for
 discharge" alert).
 ---
 ## Who uses it
 - **[Institution: Ward](https://git.arch.fyi/flan/rimworld-ward)** — psychiatric care. Marks
  mental-illness conditions treatable (Rim Disorders' depression, anxiety, PTSD, and OCD, when that mod
  is present), runs warden counselling sessions, and builds a recovery track toward a "ready for
  discharge" alert. The reference example.
 - **Institution: Justice** — rehabilitation. Its *reform* score is the disposition axis punishment
  moves; the recovery track is the natural home for a *sustained rehabilitation programme* that gates
  parole on the same shared engine, so the two systems agree on "getting better" instead of each
  inventing it.
 "Reduce the condition, *then* build recovery" is the shape Ward uses, but it isn't forced: a
 rehabilitation system with no clinical condition to clear (like Justice's reform) can build a recovery
 track from the very first session and read its level to gate a parole.
 The point, exactly as with propensity: one engine, two uses, no drift.
 ---
 *Part of the **Institution** suite.*
@@ -0,0 +1,115 @@
 # Classification
 *The intelligence layer over the wings you already build by hand.*
 You already build a minimum wing and a max block. You already put the psychopath behind steel and the
 teenage pickpocket behind a wooden door. Classification does not replace those walls, cells and locks —
 it answers the question vanilla never does: **who belongs where.** It reads the one shared record every
 part of the suite writes to and turns it into a single verdict, so the crime system, the search, the
 escape and the classifier all agree on how dangerous a pawn is, because they read the same number.
 Grade drives everything downstream: search frequency, privileges, escape risk, and — critically —
 parole eligibility ([Parole](Parole.md) gates on grade).
 > The isolation *toll* of a max/solitary placement is Prisoner Realism's (good) sim. Corrections only
 > decides the placement.
 ---
 ## The tiers
 Every held pawn falls into one of four security grades, low to high — the tiers you already build,
 named:
 | Grade | Risk score | Reading |
 |---|---|---|
 | **Minimum** | below 0.35 | Barely a disposition, clean record. Open dorm, light watch. |
 | **Medium** | 0.35 – 0.79 | A real record or a real nature. Proper cell, routine search. The parole ceiling. |
 | **Maximum** | 0.80 – 1.49 | Repeat offender or proven flight risk. Steel, solitary door, frequent search. |
 | **Supermax** | 1.5 and up | The headline cases. Escapes plus crimes plus a dark nature. Never let them near a wall. |
 Note the ceiling at **Medium**: [Parole](Parole.md) will only consider a pawn graded Medium or below.
 Grade is therefore not just a placement hint — it is the gate a pawn has to fall back through before
 they can be released.
 ---
 ## The risk score
 Risk is a number from 0 to about 3: baseline disposition, plus everything on the record, minus reform
 earned. Each thing a prisoner has done adds a fixed amount:
 | What it counts | Adds to risk | Why this weight |
 |---|---|---|
 | **Nature** (0 to 1) | nature × 0.5 | Disposition alone can carry a pawn to Medium (nature 0.7+), but never past it on its own. Character is a suspicion, not a conviction. |
 | **Each escape attempt** | +0.35 | The heaviest per-event term. A pawn who *runs* is the one who ends up armed in your base. One attempt is worth nearly two crimes. |
 | **Each crime committed** | +0.20 | The staple. Steady, cumulative. |
 | **Each time caught** | +0.15 | Caught contraband is worse than merely suspected. |
 | **Each contraband item made** | +0.10 | The lightest term — making a shiv is common; escaping with one is not. |
 | **Reform earned** | up to −0.4 | The only thing that *lowers* the grade. At most −0.4, since reform caps at 1.0. |
 The total is never allowed below zero.
 Two facts fall out of the numbers, and both matter for how you play:
 - **Searching a prisoner does not raise their risk.** Only *finding* something does — a search that
  turns up nothing costs the prisoner no grade. Search freely.
 - **Reform can shift at most 0.4 of risk.** At full reform (1.0), the downgrade is −0.4. So a pawn
  whose record *without reform* already totals 1.2 or more can never fall to Medium (below 0.8) no
  matter how thoroughly they reform — and therefore can **never be paroled**. A prolific offender is a
  life sentence. You will hold them, work them, or execute them; you will not release them. This is a
  deliberate property of the weights, not an accident.
 ---
 ## Worked example — grading a record
 **Bram**, an Abrasive raider, has a nature of 0.20. He has three crimes, one escape attempt, was caught
 twice, made two shivs, and has not been reformed. Add it up:
 | Source | Contribution |
 |---|---|
 | nature 0.20 × 0.5 | 0.100 |
 | 1 escape × 0.35 | 0.350 (the headline) |
 | 3 crimes × 0.20 | 0.600 |
 | caught twice × 0.15 | 0.300 |
 | 2 shivs × 0.10 | 0.200 |
 | no reform | 0.000 |
 | **total** | **1.550** → Supermax |
 Now treat him. Say patient handling and good conduct lift his reform to 0.40. That subtracts
 0.40 × 0.4 = 0.16, dropping his risk to **1.39 → Maximum.** He falls a band.
 But notice: his reform-*less* risk is 1.55, well above 1.2. Even at perfect reform (1.0) he lands at
 1.55 − 0.40 = 1.15 — still Maximum. **Bram is beyond parole for the rest of his life.** His record
 decided that, not his disposition.
 Contrast **Cass**, a Kind pickpocket whose gentle nature floors her nature term at 0. She has one
 crime, was caught once, no escapes, no contraband, no reform yet. Her risk is
 (1 × 0.20) + (1 × 0.15) = **0.35 → Medium**, exactly on the line.
 Give Cass the standard treatment up to reform 0.30. That subtracts 0.30 × 0.4 = 0.12, dropping her to
 **0.23 → Minimum.** Cass is now Minimum, and — being Medium-or-below with reform at least 0.30 —
 **paroleable.** Same institution, two futures, and the record told you which was which before you had
 to guess.
 ---
 ## How to play with grades
 - **Segregate by grade, not by vibe.** Sort your cells to the four bands and put a pawn where their
  score, not your hunch, says. The whole suite reads the record; you can too.
 - **Escapes are the alarm.** One escape attempt (+0.35) will jump a middling pawn a band. If a pawn
  crosses into Maximum after a break attempt, believe it — treat them as the flight risk the number
  says they are.
 - **A clean nature is not a clean record.** A Kind pawn who has escaped twice still grades Maximum;
  disposition is only half the score.
 - **Watch the parole ceiling.** If you intend to release someone, keep their reform-less risk under
  1.2 — mostly that means limiting how deep their record gets *before* you start treating them. A pawn
  you let rack up escapes and catches has sentenced themselves.
 - **Reform is the only lever that lowers a grade.** See [Discipline & Reform](Discipline-and-Reform.md)
  for how to move it, and [Parole](Parole.md) for where the grade gate lands.
 ---
 *Part of the **Institution** suite for RimWorld 1.6: Core · Contraband · Policing · Corrections · Gangs · Ward.*
@@ -0,0 +1,111 @@
 # Discipline & Reform
 *Punishment as an action, with a self-complete payoff — and the seat of institutionalization.*
 > This page is the **numbers** — what a disciplinary act does to reform and order. What *drives* it in
 > play (a warden's rehabilitation sessions, and neglect that hardens) is [Rehabilitation](Rehabilitation.md).
 Punishment does two things at once, on two different axes:
 1. **It deters the colony.** Order seen to be done raises the climate of order for everyone: any act of
   discipline adds **+0.12** to the colony's order. See [Deterrence](Deterrence.md).
 2. **It reshapes the punished.** A harsh hand *prisonizes* — the pawn hardens, reform falls, their
   disposition climbs for good. A corrective hand *rehabilitates* — reform rises, their disposition
   cools for good.
 Both effects belong to Corrections, so discipline is never inert. Prisoner Realism owns the passive
 *toll* of isolation (a good sim of how solitary *feels*); Corrections owns the *order* it produces and
 the persistent *shift* it leaves on the pawn. When both mods are present, PR's solitary deterioration
 deepens the felt experience on top — it does not replace this.
 ---
 ## The two hands
 Every disciplinary act moves the prisoner's **reform** score, in one of two directions:
 | The hand | Reform change | Meaning |
 |---|---|---|
 | **Harsh** | **−0.15** | Beatings, deprivation, the hard hand. Hardens — "prisonization." |
 | **Corrective** | **+0.10** | Correction, structure, rewarded good conduct. Rehabilitates. |
 Either way, the act also adds **+0.12** to the colony's order — the colony sees order done, whoever it
 was done to.
 Reform lives on the shared record, clamped between −1 and +1:
 | Reform | Reading |
 |---|---|
 | **+1.0** | Fully rehabilitated |
 | **0.0** | Untouched — as they came in |
 | **−1.0** | Fully hardened, institutionalized |
 Note the asymmetry: **harsh (−0.15) moves faster than gentle (+0.10).** It takes three corrective acts
 to build +0.30 of reform; two harsh acts to tear down −0.30. Damage is quicker than repair — as it
 should be.
 ---
 ## How reform becomes disposition
 Reform is not a status effect or a mood buff. It feeds straight back into a pawn's **disposition** —
 Core's underlying "would they act out?" multiplier — scaling their whole disposition up or down and
 keeping it there. The size of that scaling is set entirely by reform:
 | Reform | Disposition factor | Effect |
 |---|---|---|
 | −1.00 (hardened) | **1.500** | +50% more disposed — permanently |
 | −0.30 | 1.150 | +15% |
 | −0.15 (one harsh act) | 1.075 | +7.5% |
 | 0.00 | 1.000 | untouched |
 | +0.10 (one gentle act) | 0.950 | −5% |
 | +0.30 (parole threshold) | 0.850 | −15% |
 | +1.00 (rehabilitated) | **0.500** | −50% less disposed — permanently |
 Because reform is clamped between −1 and +1, the factor spans 0.5× to 1.5×. **This is the whole
 trick.** Institutionalization and recidivism are not a parallel mechanic bolted on the side — they are
 *one number the disposition already reads*. A hardened pawn is not flagged "recidivist"; they simply
 carry a negative reform that makes every "would they?" roll for the rest of their life come up hot.
 Discipline and Parole are what *move* reform; disposition only *reads* it — which is how
 institutionalization emerges without a second system.
 ---
 ## Worked example — two sentences
 Take a fresh prisoner with reform 0, badly kept: mood 0.30, held. Before any reform, their disposition
 is already running hot — a bad mood (×1.6) and a held-and-unhappy cell (×1.4) combine, and with the
 colony at baseline the pawn sits around **2.35× disposition**.
 **The hard hand.** You beat them into line — three harsh punishments take reform to −0.45. At that
 reform the disposition factor is 1.225, so their disposition is now 2.35 × 1.225 ≈ **2.88 — +22% hotter
 than when they arrived**, forever, independent of mood. You have made them more criminal, not less.
 This is prisonization: the sentence itself became the cause. (You did buy +0.36 of colony order along
 the way — order today, at the cost of the pawn's tomorrow.)
 **The corrective hand.** Instead you structure and reward — three gentle punishments *and* you fix
 their conditions (recreation, decent cell) so mood recovers to 0.55. Reform rises to +0.30, and the
 recovered mood drops the "badly kept" and "held-and-unhappy" penalties entirely. The disposition factor
 at +0.30 reform is 0.85, so their disposition is now roughly **0.89 — below neutral.** The same pawn who
 would have been 2.88 disposed is now 0.89. And at reform 0.30 with a low enough grade they have crossed
 the [Parole](Parole.md) threshold. Same institution, opposite outcomes — decided by which hand you used.
 ---
 ## How to play with discipline
 - **Harsh is a lever, not a punishment button.** It buys colony order *now* (+0.12) at the price of the
  pawn's disposition *forever* (−0.15 reform → hotter disposition). Use it when you need the deterrence
  and never intend to release the pawn — a Supermax lifer you are only ever going to hold.
 - **Gentle is how anyone gets out.** Parole needs reform 0.30 or higher; only the corrective hand
  builds it. Three gentle acts is the floor.
 - **Damage compounds; repair is slow.** −0.15 vs +0.10 means a pawn you brutalize early is expensive to
  bring back — and a hardened pawn commits more crime, which sinks the climate, which makes *everyone*
  worse. Don't harden pawns you might want later.
 - **Conditions and discipline stack.** Reform shifts disposition permanently; mood, neglect and
  deterrence shift it live (see [Regime](Regime.md) and [Deterrence](Deterrence.md)). A reformed pawn
  in a well-run wing is calm on two axes at once.
 ---
 *Part of the **Institution** suite for RimWorld 1.6: Core · Contraband · Policing · Corrections · Gangs · Ward.*
@@ -0,0 +1,49 @@
 # Institution: Corrections
 *The prison layer — what the colony **does** with a pawn once they are in custody — of the
 **Institution** suite of RimWorld 1.6 mods.*
 Vanilla RimWorld's prisoners are interchangeable mood-boxes; a "maximum security" wing is a decoration
 the sim never acknowledges, and a warden's work never changes who a pawn becomes. **Corrections turns
 the prison into a regime you run** — it grades every held pawn from what they have actually done,
 tracks a *reform* score that decides whether a sentence hardens or heals a prisoner, gates release on
 it, and gives prisoners the recreation need vanilla flatly denies them.
 ---
 ## The pages
 | Page | What it covers |
 |---|---|
 | **[Classification](Classification.md)** | Grades held pawns Minimum..Supermax from a risk score over their record; wall-mounted security markers grade a whole wing; misplacement alerts. |
 | **[Discipline & Reform](Discipline-and-Reform.md)** | Punishment moves the reform score — harden ("prisonized") vs. rehabilitate. The seat of institutionalization and recidivism. |
 | **[Rehabilitation](Rehabilitation.md)** | The warden work that drives the arc: counselling sessions move reform and colony order, a parole alert and release, neglect that hardens. |
 | **[Parole](Parole.md)** | Release a reformed, low-grade prisoner as a free colonist; with Ideology, your execution stance sets the bar. |
 | **[Regime](Regime.md)** | Prisoner recreation (Yard/Lockup schedule via Prison Labor's timetable), visitation, cell-safety. |
 ---
 ## One shared record
 Corrections keeps no crime history of its own. Every held pawn carries a single record that
 **Institution: Core** maintains — the same record Contraband, Policing, and the gang systems all read
 and write. Discipline and Parole write the *reform* and *pardon* onto it; classification grades and the
 release gate read back over every counter its siblings feed in. Reform and rehabilitation run on Core's
 shared treatment system, the same one Ward's psychiatric care uses — so a prisoner's whole arc, from
 first crime to parole, is one continuous history rather than a pile of separate flags.
 ---
 ## Requirements & load order
 - **RimWorld 1.6**
 - **Institution: Core** — required (the disposition, record, and treatment systems)
 - **Institution: Policing** — required (the shared climate of order: discipline and rehab nudge it, the
  inspect pane reads it)
 - **Harmony** — required (Regime's prisoner-recreation feature)
 - Load **after** Core, Policing, and Harmony.
 ---
 *Part of the **Institution** suite for RimWorld 1.6: Core · Contraband · Policing · Corrections · Gangs
 · Ward. Split out of the former Institution: Justice.*
@@ -0,0 +1,115 @@
 # Parole
 *Release, driven by what the pawn has become.*
 > This page is the release **decision**. The warden work that acts on it — the "Ready for parole" alert
 > and the release that frees a parolee back into the colony — is [Rehabilitation](Rehabilitation.md).
 Parole is the end of the arc, and it is deliberately a *decision*, not a mechanic that rebuilds the
 game's release flow. It asks one question — **is this pawn ready?** — and answers it from two things
 already on the record: the reform the sentence earned (or failed to earn), and the grade the record
 warrants.
 > The *return* outcome — a grateful ally, a vengeful raider — is Prisoner Realism's Recidivism, a good
 > sim Corrections does not rebuild. Corrections' mirror is the parolee who **stays** and may reoffend,
 > carrying their record into the colony.
 ---
 ## The gate
 A prisoner can be paroled only when **all three** of these hold:
 | Condition | Threshold | Why |
 |---|---|---|
 | Not already pardoned | never released before | Release is one-way; you can't re-parole. |
 | Genuinely reformed | reform 0.30 or higher | Proof the sentence *healed* rather than hardened. Three corrective acts minimum. |
 | Low enough grade | grade Medium or below (risk under 0.8) | Reform of attitude is not enough — the *record* must have cooled to something you'd let out. |
 A pawn with **no record at all** is releasable trivially (there is nothing to hold them). Everyone else
 has to earn all three.
 The grade gate and the reform gate interact in a way worth internalizing. Because reform subtracts at
 most 0.4 from risk ([Classification](Classification.md)), a pawn whose reform-*less* risk is 1.2 or more
 can never reach Medium — so **no amount of reform will ever parole a prolific offender.** Parole is for
 pawns whose record stayed shallow enough that treatment can pull them back under the ceiling. Let a pawn
 rack up escapes and catches and you have quietly converted them into a lifer, whatever their attitude.
 ---
 ## Release
 Releasing a parolee marks a **pardon** on their record. Vanilla does the actual freeing; the pardon is
 Corrections' memory that this pawn was let out after genuine reform, so reintegration can grant a clean
 slate and the pawn won't be offered for parole twice. A modest faction-goodwill / relationship nudge for
 a well-handled release is the immediate payoff.
 ---
 ## The whole arc
 The pawn moves through every stage in turn, and each one writes the record the next one reads:
 | Stage | Where it lives | What moves | What's recorded |
 |---|---|---|---|
 | 1. Crime | [Deterrence](Deterrence.md) | Climate −0.08; the colony runs hot | a crime, and when it happened |
 | 2. Caught & held | [Classification](Classification.md) | A grade is assigned from the record | reads every counter |
 | 3. Discipline | [Discipline](Discipline-and-Reform.md) | Reform moves ±; climate +0.12 | reform |
 | 4. Reform | [Discipline](Discipline-and-Reform.md) → Core | Disposition cools as reform rises | reform (read by disposition) |
 | 5. Regrade | [Classification](Classification.md) | Reform subtracts risk; grade falls | reads reform |
 | 6. **Parole** | this page | Gate opens at reform 0.30 **and** grade Medium or below | reads reform and pardon; sets pardon |
 It is a loop, not a line: the crime that opens stage 1 also cools the colony's climate, which the *next*
 pawn's disposition reads — so one pawn's whole sentence is faintly present in every other pawn's odds.
 ---
 ## Worked example — a sentence that ends in release
 **Cass**, a Kind pickpocket whose gentle nature floors her nature term at 0. She arrives with one crime,
 caught once, no escapes, no contraband, no reform yet. Her risk is (1 × 0.20) + (1 × 0.15) = **0.35 →
 Medium.** She is already Medium-or-below, so the *grade* gate is met — but her reform is 0, so she is not
 yet releasable.
 You give her the corrective hand three times (structure, rewarded conduct) and fix her cell so she
 isn't stewing. Reform rises to 0.30, which subtracts 0.30 × 0.4 = 0.12 from her risk, dropping her to
 **0.23 → Minimum.** Now all three gates are met — reform at least 0.30, Minimum is below Medium, and
 she's never been pardoned — so **Cass is paroleable.** Pardon her and she walks.
 Contrast **Bram** from the Classification page, whose reform-less risk of 1.55 keeps him at Maximum even
 at full reform — the grade gate never opens for him, so he can never be paroled. Two prisoners, the same
 treatment, and the record decides which one you can ever let go.
 ---
 ## A note on record cleanup
 A pawn with a completely empty record — no crimes, no escapes, no contraband, no catches, no reform, no
 pardon — is forgotten on save/load (Core prunes blank and dead-pawn records). A *pardoned* pawn is
 therefore **not** empty, and their record persists: the pardon is remembered. This is why a released
 parolee who stays and reoffends still carries their history — Corrections does not forget that they were
 once let out.
 ---
 ## Ideology-flavoured thresholds
 Precepts layer on top of this baseline, not under it: an execution-favouring ideoligion paroles rarely,
 a lenient one readily. The gate above is the baseline those precepts modulate — the floor beneath the
 flavour, so the decision is coherent whether or not Ideology is installed.
 ---
 ## How to play with parole
 - **Parole is earned, not granted.** You cannot release your way out of a deep record. Decide early
  whether a pawn is a keep-or-release case and treat (gently) the ones you mean to free.
 - **Reform 0.30 is three gentle acts, minimum.** Nothing faster reaches it. Start early.
 - **Keep the record shallow if you want the option.** Every escape (+0.35) and catch (+0.15) you let
  accumulate pushes a pawn toward the unparoleable side of the 1.2 line.
 - **A parolee who stays is a Corrections case, not a farewell.** They carry their record; if conditions
  sour, their disposition (still reading their history) can put them back on it.
 ---
 *Part of the **Institution** suite for RimWorld 1.6: Core · Contraband · Policing · Corrections · Gangs · Ward.*
@@ -0,0 +1,89 @@
 # Regime
 *The daily life of the held — and the one lever vanilla withholds.*
 Most of what a prison regime needs, vanilla already gives you. The schedule is the Restrict tab. The
 mood-driven disposition already flows through the colony's underlying systems — a neglected prisoner
 runs hotter with no new machinery. So Regime does not rebuild any of that. It adds the single thing
 vanilla flatly refuses to model: **recreation.**
 ---
 ## What vanilla does, and what Regime flips
 Vanilla denies prisoners the **Joy** (recreation) need outright — the need is flagged colonists-only, so
 it simply never appears on a prisoner. A caged pawn has no recreation bar, cannot take joy from
 anything, and never suffers for its absence.
 Regime flips exactly that one bit on — the same approach the good, popular **Prisoner Recreation** mod
 takes. It grants the recreation need to **humanlike prisoners of your colony** and nothing else: animals,
 guests, slaves and colonists are untouched, only the recreation need is affected, and it only ever
 *adds* the need where vanilla withheld it — it never removes a need another mod granted.
 That is the entire mechanism. Enabling recreation is trivial — once the need exists, vanilla does all
 the rest (joy sources, the recreation bar, the mood effects of a full or empty one). The *value* is not
 the plumbing; it is what an empty bar now costs.
 ---
 ## Why a need you can neglect is the point
 Giving prisoners recreation is not a mercy toggle — it is a **lever with two ends**, and the down end is
 the one that matters to the suite. Once a prisoner *has* the Joy need, they can be **starved** of it, and
 vanilla's own machinery then does the work: no recreation lowers Joy, which lowers mood, and a low mood
 raises the pawn's disposition — their odds on every "would they?" roll.
 Every one of those steps already exists. Regime only opens the first door; mood is wired to disposition
 in Core, so a prisoner who gets no yard time stews, their mood sinks, and their disposition climbs.
 From [Deterrence](Deterrence.md) and [Discipline & Reform](Discipline-and-Reform.md) you already know
 disposition is the multiplier the whole system keys off; Regime is what lets *neglect* feed it.
 Concretely, a prisoner's mood pushes their disposition into these brackets:
 | Prisoner condition | Disposition contribution |
 |---|---|
 | Mood below 0.20 (recreation-starved, at the floor of despair) | ×2.5 |
 | Mood below 0.35 (badly kept) | ×1.6 |
 | Held **and** mood below 0.40 (a badly run cell) | an additional ×1.4 |
 A prisoner you give no recreation is a prisoner you are pushing up those brackets. Regime turns "I
 didn't bother building a rec room" from a non-event into a disposition cost you pay on every roll.
 ---
 ## Works alongside Prisoner Recreation
 If you also run the **Prisoner Recreation** mod, nothing breaks. Both mods do the same thing — grant the
 recreation need to prisoners — and because Regime only acts when the need isn't already granted,
 whichever runs first grants it and the other sees it already done. Running both is harmless. Running
 either alone is sufficient. There is no double-need, no conflict, no load-order sensitivity between them.
 Regime prints a short startup message so you can confirm it loaded and prisoner recreation is enabled.
 ---
 ## Content on top
 Yard time, safety needs, and visitation are *content* on this foundation, not new machinery. Each of
 them is just another thing that moves a prisoner's mood — and mood is already wired to disposition — so
 they build on the same spine that this one recreation change put in place. When they land, they make a
 well-run regime feel richer without adding new systems underneath.
 ---
 ## How to play with Regime
 - **Build the rec room.** A prisoner with recreation settles; the mood brackets above stay off, and
  their disposition sits near baseline. A cheap horseshoe pin or chess table earns its keep in crimes
  that don't happen.
 - **Neglect is a choice with a number.** Leaving prisoners with nothing to do isn't neutral — it drives
  mood into the ×1.6 and ×2.5 disposition brackets, and a hotter prisoner reoffends, which cools your
  colony's climate of order, which heats *everyone*. The rec room is deterrence you build once.
 - **Recreation and reform stack.** Regime cools disposition *live* (through mood); reform cools it
  *permanently* (through [Discipline & Reform](Discipline-and-Reform.md)). A reformed prisoner in a
  well-run wing is calm on both axes — which is exactly the pawn you can eventually [parole](Parole.md).
 - **You don't need Prisoner Recreation too** — but if you have it, keep it. They coexist.
 ---
 *Part of the **Institution** suite for RimWorld 1.6: Core · Contraband · Policing · Corrections · Gangs · Ward.*
@@ -0,0 +1,151 @@
 # Rehabilitation
 *The warden work that drives discipline, reform, and parole.*
 Classification, discipline, deterrence, and parole set the rules — a grade over the record, a reform
 score punishment moves, an order climate, a release decision. Rehabilitation is what a warden actually
 *does* day to day to move a prisoner through them. Without it, reform sits still, classification never
 re-grades, and parole never fires; with it, the whole post-arrest arc comes alive.
 It gives corrections the same shape Ward gives psychiatric care — a **prisoner interaction mode**,
 **warden work**, an **alert**, and an **inspect readout** — so a warden reforms a prisoner over time and
 paroles them when they have turned a corner.
 ---
 ## The two modes
 Both are non-exclusive prisoner interaction modes (the same kind Prison Labor and Ward use), so they
 stack with each other and with recruit / reduce-resistance.
 | Mode | What a warden does | Result |
 |---|---|---|
 | **Rehabilitate** | Runs counselling sessions on the prisoner | Reform rises, the reform bar fills, colony order rises |
 | **Parole when reformed** | Releases the prisoner **once they are eligible** | A paroled colonist, back in the colony |
 Set **Rehabilitate** alone to run the programme and parole by hand when the alert fires; set **both**
 for a hands-off "reform, then release" pipeline. A prisoner flagged for parole who is *not yet* eligible
 is simply not acted on — the warden waits.
 ---
 ## A rehabilitation session
 A warden walks to the prisoner and counsels them for about 20 in-game minutes, with Social as the
 active skill. On completion (never on interruption — you only earn credit for a finished session), one
 session does three things:
 1. **Corrective discipline** — a gentle disciplinary act: reform **+0.10**, and it raises the colony's
   **order** by **+0.12**. This is the deterrence-up half that punishment alone never triggered —
   visible corrective justice deters everyone else.
 2. **The reform bar** — the visible progress bar fills, by **0.34 × cell quality × skill** per session,
   and it **decays −0.08/day**, so rehabilitation has to be *sustained*.
 3. **A memory** — the prisoner feels counselled (a small mood lift).
 | Input | Range | Depends on |
 |---|---|---|
 | skill factor | 0.5 … 1.0 | the warden's Social level |
 | cell quality | 0.5 … 1.5 | the cell's impressiveness |
 | reform per session | +0.10 | fixed |
 | order per session | +0.12 | fixed |
 Reform reaches the parole bar (0.30) in roughly **three completed sessions** — faster than a bad cell or
 a poor counsellor fills the visible bar. So the "Ready for parole" alert keys off the real gate, not the
 bar you see filling.
 ---
 ## Neglect — the teeth
 A prisoner you flag for rehabilitation and then never attend **hardens**, exactly as a ward you don't
 staff does. Once more than **two days** pass since the last real session, reform falls **−0.15/day** and
 they resent it (a mood hit). This hardening lowers reform *directly*, not as an act of visible justice —
 neglect is passive prisonization, so unlike a session it does **not** raise the colony's order.
 Attend the prisoner and the clock resets; flag them and walk away and they slide back toward the record
 that put them in. "A reform programme you don't staff is worse than none."
 ---
 ## Parole — the release that stays
 When a rehabilitated prisoner clears the parole gate — reform 0.30 or higher, security grade Medium or
 below, not already pardoned — the **Ready for parole** alert names them. A warden set to Parole then
 processes the release:
 - marks the **pardon** on the record;
 - clears the prisoner hold so a former prisoner becomes a **free colonist again** — a parolee who
  *stays* in the colony carrying their record, not vanilla's release that ejects them from the map;
 - a grateful memory, and a small **+0.03** to order (a lawful release is visible justice too).
 The parolee keeps their record, so if they reoffend the [policing](Policing.md) loop catches them again
 — recidivism, closing back onto the start.
 ---
 ## Discipline — the other lever
 Rehabilitation is the carrot; **discipline** is the stick, and its opposite. Set a prisoner to
 **Discipline** and a warden puts them in **solitary**: harsh discipline *hardens* them — reform falls —
 yet raises the colony's order (visible harsh justice deters the rest), and it stings: a mood hit and an
 on-edge *in solitary* status. It fires at most once per term (the status blocks re-discipline for about
 two days), so it holds order without cratering reform in a single day. The tension is the point: lean on
 discipline to keep order and you make the punished harder to reform.
 ## Classification enforcement
 Classification always computed a **security grade** (Minimum..Supermax); now it is actionable:
 - **The grade shows** on every prisoner's inspect pane — the game tells you who is dangerous instead of
  leaving you to guess.
 - **Wing-routing.** A wall-mounted **security marker** grades the cell block it stands in
  (Minimum..Supermax, set with a gizmo). One marker covers a *whole block* — a prisoner takes the grade
  of the nearest marker in range, so you tag a corridor once rather than cluttering every cell. A
  **"Dangerous prisoner unsecured" alert** then flags any prisoner held in a wing too weak for their
  grade, and the inspect pane shows their wing and a **MISPLACED** warning — move them to a stronger
  wing. An ungraded wing falls back to flagging an unsegregated Maximum/Supermax pawn.
 - **Cell safety:** a prisoner caged with a dangerous one suffers a mood penalty. Segregate your
  dangerous prisoners, or their cellmates pay for it — the grade made to matter on the *housing* side,
  not only at parole.
 ## Regime — yard, lockup, and visitors
 Beyond punishment and reform, the held have a **daily life**:
 - **Yard / Lockup schedule.** Two timetable blocks set a held pawn's day: **Yard** allows recreation
  (with the prisoner recreation need Regime enables, they head out to a rec area), **Lockup** confines
  them to the cell and stews their mood. The timetable itself is **Prison Labor's** — Corrections reads
  it when PL is present and does nothing without it, so PL stays compatible.
 - **Visitors.** A prisoner or ward patient with family or a bond gets **visitors** — a friendly party
  walks in under the game's own visitor AI and congregates by their cell, and the break from isolation
  lifts their mood. Thematically strongest for a ward patient whose family comes to see them.
 ---
 ## Seeing it
 Every colony prisoner's inspect pane now carries the corrections readout:
 > *Security grade: Maximum* · *In solitary* · *Rehabilitation: reforming (40%) — neglected (3d)* ·
 > *reformed — ready for parole*
 The **grade** shows for every held pawn; *in solitary* while a discipline term runs; the
 **rehabilitation** line for a pawn set to reform. And because the colony's **order climate** otherwise
 has no readout at all, the same pane surfaces it when it is far enough from ordinary to matter —
 *Colony order: low (28%) — crime pays here* / *high (71%) — order holds*.
 ---
 ## What this closes
 With rehabilitation in play, the whole post-arrest arc runs: **discipline** moves reform,
 **classification** re-grades as reform rises, **deterrence** climbs on visible justice (not just falls
 on crime), **parole** releases the reformed, and Core's **treatment** carries the reform bar the same
 way it carries Ward's recovery. The loop closes back onto disposition — catching, reforming, and
 releasing one pawn moves the climate every other pawn is judged against.
 The whole corrections layer can be toggled off in the mod's settings, like the rest of the suite.
 ---
 *Part of the **Institution** suite.*
@@ -0,0 +1,91 @@
 # Affiliations and segregation
 *Gangs grow out of who pawns **already are** — and the counter-play is to keep the wrong pawns apart.*
 A gang in this mod is never invented from nowhere. It crystallises along the bonds a colony already
 contains: shared faction, shared faith, or real friendship. This page covers the formation rule — which
 bonds count and why the *same room* requirement matters — and then the segregation counter-play that
 turns those same bonds against the network.
 ## The formation rule
 On each 5000-tick pass, the game walks everyone currently over the join bar (Nature × Nurture ≥ 0.9)
 and tries to pair each unaffiliated pawn with a mate. A pawn pairs up with someone who is, at that
 moment, **in the same room** *and* someone they **already share a bond with**.
 Two conditions, both required: they must be **in the same room** at the moment of the check, **and**
 they must **share an affiliation**. A disposed pawn does not fall in with a stranger across the map; it
 falls in with someone it is standing next to *and* already connected to.
 Pairing binds them together: if either already runs with a gang, the other joins that gang; otherwise a
 fresh gang is founded. So gangs accrete — a new member pairing with an existing member is absorbed
 into the existing crew rather than starting a rival one.
 ### What counts as an affiliation
 | Bond | Condition | Notes |
 |---|---|---|
 | **Same faction** | both belong to the same (non-empty) faction | your colonists share one; captured raiders share theirs |
 | **Same ideoligion** | both follow the same ideoligion, only if the Ideology DLC is active | needs Ideology enabled |
 | **Friendship** | an opinion of at least **+20** of each other | a real positive relationship, not mere acquaintance |
 The design intent:
 > Gangs grow out of who pawns ALREADY are, not out of nowhere — so a prisoner's gang on the outside is
 > their old faction/friends, and rival factions run as rival gangs.
 This is why the system feels coherent rather than arbitrary. A crew is a faction bloc, a congregation,
 or a friend group — social lines the colony *already has*. Gangs mesh with them instead of stamping
 random groupings over the top.
 ## Rival factions become rival gangs
 Follow the rule to its conclusion. Two captured raiders from **different** hostile factions each share
 an affiliation with *their own* side but not with each other. Housed in the same wing, each pairs up
 along its own faction line — and now you have **two gangs**. As the
 [Rivalry and Fights](Rivalry-and-Fights.md) page explains, members of two different gangs are
 automatically **rivals**, and rival-gang violence between them is booked as a crime.
 So the affiliation rule and the rivalry rule are two ends of one idea: **who bands together** and **who
 is opposed** both derive from pre-existing loyalties. Mix hostile factions or clashing ideoligions in
 one room and you have not made one big gang — you have made two rival ones and lit the fuse between
 them. This is a housing decision with mechanical teeth.
 ## Segregation: the counter-play
 Here is where the formation rule and the network rule meet, and where the rest of the suite earns its
 keep. A gang can only *do* anything — resupply itself — if its members can **reach** each other.
 Passing contraband requires two things: the pawns must be in the same gang, **and** two pawns both on
 the map must have a walkable path between them. Break the path and you break the network.
 The design calls this out as the intended answer to the whole mod:
 > The counter-play is the rest of the suite: Classification SEGREGATES rivals into different wings, and
 > a network whose members cannot REACH each other is starved.
 **Classification** lives in **Institution: Justice**. It grades pawns by risk and lets you sort them
 into separate, walled wings. Two gangmates graded into different wings, with no walkable route between
 them, fail the reach test on every network pass. The gang still *exists* — they are still the same crew,
 still rivals of the other crew — but it can no longer pass a shiv from a holder to a have-not. **A
 network that cannot reach itself is a network that cannot supply itself.**
 This is the elegant part of the design: the very bonds that formed the gang tell you *who to keep
 apart*, and the reach requirement makes keeping them apart actually starve the supply chain. You do not
 disband a gang; you **cut it off from itself** until nothing can move along it.
 ## How to play it
 - **Read affiliations before you house pawns.** Same-faction and same-ideoligion prisoners will band
  together; hostile factions in one wing will form *rival* gangs and fight. Sort deliberately.
 - **Segregate by Classification, not by hope.** Putting rivals in "different areas" is not enough —
  resupply only needs a *walkable path* between two gangmates. A shared corridor is a supply line. Use
  genuinely separate, walled wings.
 - **Starve, don't chase.** You will rarely delete a gang outright. The durable win is to keep its
  members unable to reach one another so the network dries up, while keeping mood and deterrence high so
  few pawns cross the join bar in the first place (see [Joining](Joining.md)).
 - **Watch the outside valve.** Segregation starves *internal* resupply; a bent warden can still inject
  new contraband from outside (see [Networks and Smuggling](Networks-and-Smuggling.md)). Partition the
  wing *and* clean up your wardens for a network that genuinely goes dark.
 ---
 *Part of the **Institution** suite — Core · Contraband · Justice · Gangs (this). Each mod stands alone; together they are one system.*
@@ -0,0 +1,88 @@
 # Institution: Gangs
 *Gangs as **contraband economies** — not mood. The social capstone of the **Institution** suite of
 RimWorld 1.6 mods.*
 ---
 ## What Gangs is
 Gangs turns the loose, disposed pawns in your colony — colonists, prisoners, slaves — into a
 **network** that moves contraband. When disposition and circumstance line up, pawns who already share
 a bond band together, and a member who holds a stash quietly resupplies a member who has none. A
 search that turns up nothing on one prisoner has therefore *not* cleaned out the wing: the wing is a
 supply chain, and you only searched one link.
 That is the entire point, and it is a deliberately narrow one. Gangs does not do mood. It does not do
 a "gang leader buff." It does the one thing nothing else in the ecosystem does — it makes contraband
 **flow between pawns**, and then hands you the tools to cut the flow.
 ## The gap it fills (and the one it doesn't)
 If you run **Prisoner Realism**, its *Ringleader* system already models a dominant prisoner spreading
 unrest and mood contagion through a wing. That system is good, and Gangs does not touch it. Ringleader
 owns *influence and mood*.
 Gangs owns the thing Ringleader has no equivalent for: **the network as a supply chain.** Contraband
 physically changes hands along social lines. A stash on one pawn is a stash available to the whole
 gang. The two systems are complementary — run both. Ringleader tells you *who stirs the pot*; Gangs
 tells you *how the shivs get around*.
 ## Why it needs the whole suite
 Gangs is the module built **last**, because it needs every other Institution mod already in place. It
 is not a standalone feature; it is the suite working together, and it is honest about that in its
 dependencies:
 | It asks... | ...and the answer comes from |
 |---|---|
 | *Who is disposed enough to join?* | **Institution: Core** — the propensity engine that scores each pawn's Nature and Nurture |
 | *What do they move?* | **Institution: Contraband** — concealment, stashes, search, and the bent-warden supply route |
 | *Where does a fight get booked, and how are rivals kept apart?* | **Institution: Justice** — the crime/deterrence loop, and Classification's segregation |
 Remove any one of those and Gangs has nothing to stand on. It is the place where Core's spectrum,
 Contraband's stashes, and Justice's policing all cash out at once.
 ## A healthy colony grows few gangs — or none
 This is the thesis, and it is enforced in the numbers, not just the flavour. Membership is gated at a
 Nature × Nurture score of **0.9 or higher** — a high bar on purpose. A disposed pawn who is
 **well-kept and well-policed** does not band up: their nurture multiplier stays low, and deterrence
 pulls it lower still. It takes a foul streak (nature) *and* a badly-run situation (nurture) at the
 same time.
 So a gang problem is a **symptom**. It is the game telling you that a wing is mistreated, under-policed,
 or both. The fix is never "fight the gang system" — it is to run a better prison. Feed them, give them
 recreation, keep deterrence high, segregate rivals, and the networks starve on their own.
 > A gang is a symptom of a badly-run colony, not furniture.
 ## The pages
 - **[Joining](Joining.md)** — why the join bar (Nature × Nurture ≥ 0.9) is high, why good treatment and
  deterrence keep pawns *out*, and how membership is re-checked for every kind of pawn.
 - **[Networks and Smuggling](Networks-and-Smuggling.md)** — how a holder resupplies a needy gangmate,
  the *same-gang-and-can-reach* rule, why this defeats a single search, and how a bent warden refills a
  starved network from outside.
 - **[Rivalry and Fights](Rivalry-and-Fights.md)** — how a gang fight is booked as a crime through
  Justice, why inside-the-wire and out-on-the-street are the same offence, and how it feeds deterrence.
 - **[Affiliations and Segregation](Affiliations-and-Segregation.md)** — shared faction, faith, or
  friendship plus *same room* as the formation rule, why rival factions become rival gangs, and how
  Classification's segregation is the counter-play that starves a network which cannot reach itself.
 ## The suite
 Part of the **Institution** suite of RimWorld 1.6 mods:
 - **Institution: Core** — the propensity engine (Nature × Nurture), criminal records, secured context.
 - **Institution: Contraband** — concealment, improvised shivs, tunnels, warden search and corruption.
 - **Institution: Justice** — Classification, Deterrence, Discipline, Parole, Regime.
 - **Institution: Gangs** — this mod: joining, networks/smuggling, rivalry/fights.
 Sibling projects: **Foul Play** (the vessel/substance framework and the "Piss Nuke") and **Ward** (a
 ward/treatment prison mode).
 Each mod stands alone as an install; together they form one system.
 ---
 *Part of the **Institution** suite — Core · Contraband · Justice · Gangs (this). Each mod stands alone; together they are one system.*
@@ -0,0 +1,113 @@
 # Joining a gang
 *How Gangs decides who runs with a crew — and why a well-run colony keeps almost everyone out.*
 Membership is not random, and it is not a mood event. A pawn joins a gang only when their **disposition
 and their circumstances line up at once** — the same Nature × Nurture propensity that drives every
 other behaviour in the Institution suite. This page covers the exact test, why the bar is set where it
 is, and how you keep pawns on the right side of it.
 ## The rule
 A pawn joins when their **Nature multiplied by their Nurture reaches 0.9 or higher**. Only humanlike
 pawns are ever eligible — animals and mechs never join.
 Beyond that it is one line of arithmetic: multiply the pawn's **Nature** by their **Nurture** and
 compare to **0.9**. There is no dice roll here. The same pawn in the same situation always gives the
 same answer — join, or don't. (That makes membership different from one-off acts like a piss spree,
 which *do* roll the dice each time. Gang membership is a standing condition, so it uses the raw product
 with no randomness.)
 ### The two halves
 Both terms come from **Institution: Core** — see Core's own documentation for the full tables — but you
 need the shape of them to understand the bar:
 - **Nature** (`0` to `1`) is *who the pawn is*: a base of `0.05`, plus trait weights, floored at `0`
  and capped at `1`. Psychopath `+0.45`, Bloodlust `+0.35`, Kleptomaniac `+0.40`, Greedy `+0.25`,
  Abrasive `+0.15`; and it goes **down** for Kind `−0.30` or Ascetic `−0.15`. This is fixed at pawn
  creation and barely moves.
 - **Nurture** (a multiplier, roughly `0.4` at the floor, `1.0` at baseline) is *the situation you put
  them in*: a floored mood multiplies it up hard (roughly `×2.5` under 0.20 mood, `×1.6` under 0.35),
  being held while miserable adds more (`×1.4`), a hardened record (negative reform) raises it, and —
  critically — **deterrence pulls it down** (toward about `0.7` in a high-deterrence colony; a neutral,
  baseline order sits at `1.0`). This is the half you control.
 ## Why the bar is high
 `0.9` is a deliberately steep threshold. In the design's own words:
 > A high bar, on purpose: gangs are a symptom of a badly-run colony, not furniture. A healthy Rimworld
 > — content pawns, an orderly colony — grows few gangs, if any.
 Because the two terms are **multiplied**, both have to be substantial for the product to clear `0.9`.
 A nasty pawn in a happy, policed colony has a low nurture and stays out. A saintly pawn in a hellhole
 has a near-zero nature and stays out. You only get a gang when a genuinely disposed pawn is *also*
 neglected or unpoliced — foul streak **and** bad situation, together.
 That is the design speaking through the arithmetic: a gang is never bad luck. It is feedback.
 ## Worked examples
 All numbers below use Core's documented factors; the intermediate nurture figures are rounded to show
 the shape of the decision.
 | Pawn | Nature | Situation → Nurture | Product | Joins? |
 |---|---|---|---|---|
 | **Kind colonist**, ordinary life | `0.05 − 0.30`, floored at `0.00` | content, `≈ 1.0` | `0.00` | **No** — nature floors it |
 | **Greedy prisoner**, content, policed | `0.30` | fed & high deterrence, `≈ 0.7` | `≈ 0.21` | **No** |
 | **Greedy prisoner**, starved & neglected | `0.30` | mood floored + held, `≈ 3.5` | `≈ 1.05` | **Yes** |
 | ...same pawn, but you raise deterrence | `0.30` | `× ≈ 0.7` → `≈ 2.45` | `≈ 0.74` | **No** — deterrence tipped them out |
 | **Psychopath + Bloodlust**, mood floored | `≈ 0.85` | mood floored + held, `≈ 3.5` | `≈ 2.9` | **Yes** — nothing short of reform pulls this back |
 The middle rows are the whole game of it. The **same greedy prisoner** joins or abstains purely on how
 you run the wing. The Kind colonist and the near-maxed psychopath are the fixed poles: one essentially
 cannot join, the other essentially always will if you neglect them. Everyone in between is a policy
 choice.
 ## It works for every pawn, everywhere
 There is no "prisoners only" special case: any pawn — colonist, prisoner, slave — can run with a crew,
 wherever they are.
 Membership pays no attention to a pawn's secured status. A disposed **free colonist** can run with a
 crew on the outside; a **prisoner** can run with theirs on the inside; a **slave** likewise. This is
 what lets a gang span the wall — an outside member and an inside member of the same crew (see
 [Networks and Smuggling](Networks-and-Smuggling.md)). Being held raises nurture (misery), but it is not
 a requirement.
 ## The cadence: every 5000 ticks
 Gang membership is re-evaluated on a fixed interval — every **5000 ticks**, which is about **2 in-game
 hours** (a RimWorld day is 60,000 ticks), or roughly **80 seconds** of real time at normal (1×) speed.
 On each pass, the game:
 1. Gathers everyone on the map who currently meets the Nature × Nurture ≥ 0.9 join bar.
 2. Pairs up unaffiliated members who **share a room and a bond** into gangs (see
   [Affiliations and Segregation](Affiliations-and-Segregation.md)).
 3. Runs one round of network resupply inside each gang (see
   [Networks and Smuggling](Networks-and-Smuggling.md)).
 Because the join bar is re-checked from scratch every pass, membership is *live*: a pawn whose situation
 improves until the product drops back under `0.9` simply stops being eligible to form new bonds. The
 bar is not a one-time gate at recruitment — it is a standing condition the colony is continuously graded
 against.
 ## How to keep pawns out
 You do not fight the gang system. You lower nurture, which lowers the product, which drops pawns below
 `0.9`:
 - **Feed them and give them recreation.** Mood is the biggest nurture multiplier by far. A wing above
  0.35 mood loses the `×2.5`/`×1.6` spikes entirely.
 - **Keep deterrence high** (Institution: Justice). Deterrence scales nurture down toward `0.7`; a
  well-policed colony is *arithmetically* less gang-prone. This is the row in the table above where the
  same greedy prisoner flips from *joins* to *abstains*.
 - **Reform, don't just punish.** A hardened record (negative reform) *raises* nurture; discipline that
  actually reforms (positive reform) lowers it. Harsh punishment that prisonizes a pawn makes the
  gang problem worse, not better.
 - **Accept the two poles.** A near-maxed psychopath will run with someone the moment you slip; a Kind
  pawn essentially never will. Spend your attention on the middle.
 ---
 *Part of the **Institution** suite — Core · Contraband · Justice · Gangs (this). Each mod stands alone; together they are one system.*
@@ -0,0 +1,105 @@
 # Networks and smuggling
 *The one thing nothing else models: contraband that flows **between** pawns. A gang is a supply chain.*
 This is the core of the mod. Everything else — who joins, who fights, who is kept apart — exists to
 serve or to break the network described here. A gang is not a mood aura; it is a **supply chain**, and
 contraband flows along it.
 ## The move
 The heart of it is a single transfer: a gangmate who is holding a stash passes one piece of it to a
 gangmate who has none. Here is everything that has to be true for a piece to move:
 - both pawns are in the **same gang**;
 - if both are on the map, the supplier has a **walkable path** to the customer (touch range, willing to
  cross deadly danger to get there);
 - there is contraband in play on the map at all;
 - the supplier is actually holding at least one concealed item.
 When all of that holds, the supplier's first concealed item leaves their hands and arrives — still
 hidden — on the customer.
 A few things worth reading carefully:
 - **One item per move.** It moves the first concealed item on the supplier, and exactly that. It is a
  redistribution, not a duplication: the item leaves the supplier and arrives concealed on the customer.
  The gang's total stash is unchanged; only *who holds it* changes.
 - **Same gang, always.** Both pawns must belong to the same gang. There is no smuggling to a stranger —
  the network only moves along membership.
 - **The reach requirement only applies to pawns both on the map.** Two pawns physically present must
  have a walkable path between them. If a member is off the active map, the reach check is skipped —
  which is what allows a gang to reach across the wall to a member who is not on the map right now.
 ## Why this defeats a single search
 Consider a wing of four gangmates and one shiv. You search Prisoner A and find nothing — clean. You
 tick a box: *cell searched, no contraband.* But the shiv was on Prisoner C the whole time, and on the
 next 5000-tick network pass it will move to whoever is out. Search C tomorrow and it may already be on
 A again.
 Put plainly:
 > A gangmate holding a stash supplies one who has none, so a search that turns up nothing on one
 > prisoner has not cleaned out the wing.
 A single search is a snapshot of one pawn in a network that reshuffles itself. This is the whole reason
 contraband-as-a-network is worth modelling: **the unit of contraband is the wing, not the pawn.** To
 clean it out you have to either search faster than it moves, or — far better — break the network.
 ## The automatic resupply pass
 You never trigger a transfer by hand; the game runs it automatically on the 5000-tick pass. After
 forming gangs for the pass, it runs one resupply round **per gang**: it finds the first member who *is*
 hiding contraband and the first member who is *not*, and if both exist, moves one item from the holder
 to the empty-handed member.
 So on each interval, every gang that has both a haves-member and a have-not-member performs **one**
 transfer, moving a single item from a holder to someone empty-handed. Over several passes the effect is
 that a gang tends to keep its members supplied and to spread a stash out — which is exactly what makes
 a scattershot search miss it. (Only members who currently meet the join bar take part in this automatic
 pass.)
 ## The cross-wall move
 Because neither the join bar nor gang membership cares about a pawn's secured status, a gang can have a
 **free** member and a **held** member. If the free member is holding the stash, the network resupplies
 *into* the prison — the outside man passes to the inside man. A free colonist and a prisoner can be in
 one gang with the stash on the free member; the transfer succeeds, and afterwards the prisoner is hiding
 contraband and the colonist is not. Your prison's contraband problem is not sealed inside your prison.
 ## Resupply from outside: the bent warden
 The transfer only *redistributes* what a gang already has. So what happens when you finally search the
 whole wing on the same day and strip every member clean — there is nothing left to pass around? The
 gang is starved. It stays starved until contraband **re-enters** from outside.
 That external source is not part of Gangs; it is **Institution: Contraband's** corruption route. A
 warden's honesty varies by personality (a Greedy warden has a price), and a bent warden can *smuggle
 contraband in to a prisoner*, planting a concealed item directly. That single planted item is then all
 the network needs: one holder, and the next 5000-tick pass spreads it back out across everyone who can
 reach.
 So the two halves of the supply picture are:
 | Mechanism | Owner | What it does |
 |---|---|---|
 | Passing contraband between gangmates | **Gangs** | moves existing contraband *between* gangmates who can reach each other |
 | Warden smuggling | **Contraband** | injects *new* contraband from outside via a corruptible warden |
 Cut both and a gang genuinely dries up. Cut only the redistribution and a bent warden re-seeds it; cut
 only the warden and any stash you missed keeps circulating.
 ## How to break a network
 - **Search the whole wing at once**, not one pawn at a time. A partial sweep is a snapshot the network
  routes around.
 - **Segregate rivals into different, unreachable wings** (Classification, in Institution: Justice). The
  reach requirement is the lever — a network whose members cannot walk to each other cannot pass
  anything. This is the primary counter-play; see
  [Affiliations and Segregation](Affiliations-and-Segregation.md).
 - **Clean up your wardens.** If searches never seem to finish the job, you may have a Greedy warden
  re-seeding the wing. Corruption is the resupply valve; personality is the fix.
 ---
 *Part of the **Institution** suite — Core · Contraband · Justice · Gangs (this). Each mod stands alone; together they are one system.*
@@ -0,0 +1,98 @@
 # Rivalry and fights
 *Two gangs, one grudge. A gang fight is a **crime** — booked, attributed, and fed back into the colony's
 climate of order.*
 Gangs do not just supply themselves; they collide. Where the network is about who shares, rivalry is
 about who is opposed — and, crucially, about turning gang violence into something the rest of the
 suite can *see* and *police*.
 ## Who is a rival
 The rule is exactly as blunt as it sounds: **two pawns in two different gangs are rivals.** Both must
 actually be in a gang, and it must be a *different* gang for each. As the design puts it:
 > Two pawns of DIFFERENT gangs are rivals — inside the wire or out on the street.
 Note what is *not* required. There is no separate "hostility" flag, no rival-declaration event, no
 threshold to cross. The moment two crews exist, their members are rivals of one another. Rivalry is a
 structural fact about who is in which gang, not a mood or a relationship value.
 Two consequences fall straight out of that:
 - **Non-members are nobody's rival.** A pawn in no gang — everyone in a healthy colony — is never a
  rival to anyone, because rivalry needs *both* pawns to be in a gang. No gangs, no rivalry.
 - **Same gang, never rivals.** Members of one crew are in the *same* gang, so they are not rivals.
  Within a gang there is no rivalry to book; there is the network (see
  [Networks and Smuggling](Networks-and-Smuggling.md)).
 Where do two *different* gangs come from in the first place? From the affiliations pawns already have —
 rival factions and rival ideoligions form into separate crews. That is the subject of
 [Affiliations and Segregation](Affiliations-and-Segregation.md); the short version is that gangs mesh
 with the colony's existing social fault lines, so **rival factions run as rival gangs.**
 ## A fight is a crime
 The payoff of tracking rivalry is what happens when rivals fight. When a rival-gang attack happens, it
 is not treated as generic brawling — it is booked as a crime through the same Justice pipeline as any
 other offence.
 Only rival-gang violence counts: the two pawns must be in different gangs for anything to be recorded.
 A scuffle between gangmates, or between two non-members, is not a *gang* fight and is not booked. When
 it *is* rival-gang violence, the whole event is recorded as a crime against the **attacker**, and that
 does three things at once (they live in Institution: Justice, but this is what Gangs is leaning on):
 | Effect of booking a gang fight | Where it lands |
 |---|---|
 | the attacker's crime count goes up | their criminal record (Core) |
 | the time of the crime is stamped to now | their criminal record (Core) |
 | the colony's **deterrence** nudges **down** (a crime happened; order slipped) | Justice's deterrence system |
 ## Inside the wire and out on the street are the same offence
 This is the design point the mod is emphatic about:
 > A gang fight is a CRIME — it goes on the attacker's record and moves the colony's climate through
 > the same Justice loop as any other, so it can be investigated, attributed and policed. Rival-gang
 > violence inside a prison and out on the street are the same offence.
 There is no separate rule for a prison-yard shanking versus a colonists' brawl in the dining room. A
 fight is booked purely on whether the two pawns are rivals. A free colonist who is a gang member
 attacking a rival is booked identically to a prisoner doing the same in a cell block. The gang system
 does not care which side of the wall the violence is on — only that it was between rivals.
 This is what makes gang violence *legible* to the rest of the suite. A fight is not a one-off flavour
 event that scrolls past in the log; it is a record entry with an attributed perpetrator and a timestamp,
 which means it can be investigated, blamed on a specific pawn, and answered.
 ## How it feeds deterrence — and back into joining
 Here is the loop that closes the whole suite:
 1. A rival-gang fight is booked as a crime against the attacker.
 2. That nudges the colony's **deterrence down**. Order has visibly slipped.
 3. Lower deterrence *raises* the nurture multiplier for **every** disposed pawn on the map (less
   deterrence means a bigger multiplier).
 4. Higher nurture pushes more pawns over the Nature × Nurture ≥ 0.9 join bar (see
   [Joining](Joining.md)).
 5. More members → more rivals → more fights available to be booked.
 Left unanswered, gang violence is self-reinforcing: each booked fight makes the next one likelier. The
 brake is the other half of Justice — **punishment raises deterrence back up**, which lowers nurture,
 which drops borderline pawns back under the bar. The seesaw works both ways: punishing a pawn raises the
 deterrence level, and a fresh crime lowers it again.
 ## How to play it
 - **Respond to booked fights.** A gang fight is real feedback that deterrence has slipped. Punishing the
  attributed attacker is not just retribution — it is the mechanical lever that pulls deterrence back
  up and cools the whole map's propensity.
 - **Don't manufacture two gangs where there was one.** Rivalry needs two different crews. Housing pawns
  of hostile factions or clashing ideoligions together is what creates the second gang and the fights
  between them — see the next page.
 - **Read the record, not the moment.** Because every fight is attributed to a perpetrator, a thick
  record of gang violence points you at *who* to segregate, discipline, or parole — the same tools the
  rest of the suite already gives you.
 ---
 *Part of the **Institution** suite — Core · Contraband · Justice · Gangs (this). Each mod stands alone; together they are one system.*
@@ -0,0 +1,130 @@
 # Deterrence — the feedback loop
 *The connection that turns the pipeline into a cycle.*
 This is the part that makes policing **govern** rather than merely clean up. Everything else in Justice
 reacts to one pawn: this reacts to the *whole colony*, and it feeds **back** into every pawn's
 disposition. Crime that goes unanswered emboldens everyone a little; visible justice deters everyone a
 little. The reason to punish is not just this prisoner — it is the message it sends the rest, and here
 that message is a number they all read.
 ---
 ## The climate of order
 Every colony carries one order value:
 | | |
 |---|---|
 | **Range** | 0.0 (lawless) … 1.0 (iron) |
 | **Baseline** | 0.5 — an ordinary colony |
 | **Below baseline** | crime pays; dispositions run **hot** |
 | **Above baseline** | order holds; dispositions run **cool** |
 It is nudged by two events and, left alone, forgets.
 ### The nudges
 | Event | Nudge |
 |---|---|
 | A crime, unanswered | **−0.08** |
 | Visible justice done (a punishment) | **+0.12** |
 Both stay clamped to the 0–1 range. Note the asymmetry: **punishment (+0.12) outweighs crime (−0.08)
 by 1.5×.** A colony that answers every offence does not merely break even — it ratchets *above*
 baseline into "order holds" territory. This is the deterrence dividend, and it is deliberate: justice
 seen to be done buys more order than the crime cost.
 The same crime that moves the climate also marks the culprit's record — the offence that shifts the
 colony's mood is the one classification and parole will remember later. A punishment moves only the
 climate; the reform side of a punishment — how the offender themselves changes — is
 [Discipline](Discipline-and-Reform.md)'s job.
 ### The drift
 Memory fades. With nothing happening, the climate creeps back toward ordinary at about **0.0015 every
 in-game while (roughly one nudge every 2500 ticks)** — which works out to:
 **drift per in-game day ≈ 0.036**
 So a single unanswered crime (−0.08) takes roughly `0.08 / 0.036 ≈ 2.2 days` to heal on its own — or
 one punishment (+0.12) to over-answer instantly. An iron colony you stop maintaining slides back to
 baseline over about two weeks; it does not stay stern for free.
 ---
 ## The feedback — how it reaches every pawn
 This is the loop. The climate is read back into every colonist's upbringing as a multiplier on their
 propensity:
 | Order level | Factor | Effect on every pawn's disposition |
 |---|---|---|
 | 0.00 (lawless) | **1.300** | +30% hotter — crime pays, everyone feels it |
 | 0.30 | 1.120 | +12% |
 | **0.50 (baseline)** | **1.000** | **neutral — a default colony sits exactly here** |
 | 0.70 | 0.880 | −12% |
 | 0.90 | 0.760 | −24% |
 | 1.00 (iron) | **0.700** | −30% cooler — order holds, everyone calms |
 Two things to notice:
 - **Baseline is the neutral point, by design.** A default colony sits at 0.5, which is a factor of
  exactly 1.0 — ordinary order neither inflames nor calms. That symmetry is deliberate. If baseline
  ran hot, ordinary order would nudge propensity up, breed a little more crime, drop order, and feed a
  slow runaway. Neutral-at-baseline means only a colony that lets order *slide below* ordinary earns
  the hot multiplier, and only one that pushes *above* it earns the calm.
 - **The swing is 0.7× to 1.3×, symmetric around 1.0** — a ±30% spread applied to *everyone's*
  disposition at once. This is the multiplier that makes catching one pawn matter to the disposition of
  the rest.
 ### When it applies
 This bending of behaviour only happens while **Policing is installed**. Core on its own reads a flat,
 neutral 1.0 — colonists are indifferent to order — and only Policing wires the climate into their
 disposition. A colonist who is off the map (in a caravan, in transit) has no local climate to read, so
 they fall back to neutral too.
 ---
 ## Worked example — a day at the institution
 The colony starts at baseline 0.5 (factor 1.05). Over one day:
 | Step | Event | Order level | Factor |
 |---|---|---|---|
 | start | — | 0.50 | 1.050 |
 | 1 | Prisoner A shanks a guard (crime, unanswered) | 0.42 | 1.106 |
 | 2 | Prisoner B foments trouble (crime, unanswered) | 0.34 | 1.162 |
 | 3 | Warden punishes A | 0.46 | 1.078 |
 | 4 | Warden punishes B | 0.58 | 0.994 |
 | overnight | nothing happens, drift ≈ −0.036 toward 0.5 | 0.544 | 1.019 |
 Two crimes cost −0.16; two punishments returned +0.24. The colony ends the day at 0.58 — **above**
 where it started — because punishment out-answers crime. Every pawn's disposition dipped hotter as the
 crimes landed (1.05 → 1.16) and then cooled below neutral once order was reasserted (0.994). By morning
 the drift has begun erasing the gain, and if nothing keeps the pressure on, the colony sinks back to its
 slightly-hot baseline over the next couple of weeks.
 That arc — hot when crime pays, cool when justice is seen, forgetful when neither happens — is the
 whole reason discipline is not inert. You are not punishing a pawn; you are setting the temperature of
 the room.
 ---
 ## How to play with deterrence
 - **Answer crime, visibly and promptly.** Each punishment is worth 1.5 crimes of order. A colony that
  reliably punishes climbs *above* baseline and cools everyone; a colony that lets offences slide
  sinks below and heats everyone — a spiral, because hotter pawns commit more crime.
 - **Don't coast on a past crackdown.** The climate drifts back to baseline at 0.036/day. Order is a
  maintenance cost, not a one-time purchase.
 - **Push past baseline if you want calm.** Neutral disposition needs an order level of about 0.571;
  ordinary (0.5) still runs 5% hot. A steady rhythm of caught-and-punished offences is what holds you
  there.
 - **A lawless spell is self-feeding.** At an order level of 0.3 every pawn is 1.19× more disposed; more
  crime follows, driving the level lower still. Break the cycle with punishments, not patience.
 ---
 *Part of the **Institution** suite for RimWorld 1.6: Core · Contraband · Policing · Corrections · Gangs · Ward.*
@@ -0,0 +1,53 @@
 # Institution: Policing
 *The enforcement and order layer — the pre-arrest half of the law — of the **Institution** suite of
 RimWorld 1.6 mods.*
 Vanilla RimWorld keeps a rap sheet no one reads, and your own colonists never break the law. Policing
 gives the colony a **climate of law and order**: colonists offend on a spectrum of criminal
 propensity, the law catches them, and catching one changes how the rest behave.
 > **Catching and punishing one pawn changes the disposition of the rest.**
 That is the difference between enforcement that *cleans up* and enforcement that **governs** — the
 reason to punish an offender is the message it sends everyone else quietly deciding whether crime pays.
 ---
 ## The pages
 | Page | What it covers |
 |---|---|
 | **[Policing](Policing.md)** | Colony crime on the propensity spectrum, witnesses and the constable's investigation, the weighed arrest and resisting it, prison riots, and the recidivism alert. |
 | **[Deterrence](Deterrence.md)** | The colony's climate of order (0 lawless … 1 iron), moved by crime and punishment, drifting back to baseline, and fed back into every colonist's disposition. |
 The climate of order only steers your colonists while Policing is installed. Core on its own keeps the
 records but leaves behaviour untouched; add Policing and the feedback loop comes alive — visible
 justice starts calming the colony, unanswered crime starts emboldening it.
 ---
 ## The one shared record
 Policing keeps no crime record of its own. It reads and writes the single criminal record that
 **Institution: Core** holds for every colonist — the same rap sheet Contraband, Corrections, and the
 gang systems read. A crime here adds to that record; Corrections grades and reforms over the same
 history.
 ---
 ## Requirements & load order
 - **RimWorld 1.6**
 - **Institution: Core** — required (the propensity and record system)
 - **Harmony** — required
 - Load **after** Core and Harmony.
 The prison half — classification, discipline, reform, parole, regime — lives in **Institution:
 Corrections**, which depends on this layer for the shared climate of order. A future **Judiciary** layer
 — a court that tries and sentences — is planned; for now an arrest sends the culprit straight to a cell.
 ---
 *Part of the **Institution** suite for RimWorld 1.6: Core · Contraband · Policing · Corrections · Gangs
 · Ward. Split out of the former Institution: Justice.*
@@ -0,0 +1,114 @@
 # Policing — the pre-arrest half
 *The other half of the loop. Where the rest of Justice deals with people the colony has already
 caught, **policing** is what happens before the cell door: your own colonists commit crimes on the
 propensity spectrum, the colony investigates, and — sometimes — arrests.*
 It is a big behavioural change (your colonists become potential criminals), so it has **its own
 toggle** in the mod settings, on by default. Turn it off to run the rest of Justice — classification,
 deterrence, discipline, parole, regime — without colony crime.
 ---
 ## The loop
 **crime → witnessed / investigated → weighed arrest (resist?) → prison → … → parole → recidivism**
 Every stage draws on the same shared systems — each colonist's propensity, the one shared criminal
 record, the climate of order — so policing is not a bolt-on: the record it writes is the record
 classification grades on and discipline reforms.
 ## Crime — and why small colonies stay honest
 Every ~40 seconds, each free colonist gets a hidden roll to offend. The base chance is low (about
 6% per roll) and it is multiplied hard by nature × nurture — almost nobody with an ordinary
 disposition ever does anything. But it is *also* multiplied by **crime cover**:
 | Free colonists | Crime cover |
 |---|---|
 | ≤ 3 | 0.15 |
 | ~8 | ~0.6 |
 | ≥ 13 | 1.0 |
 In a tight 2–3 pawn colony everyone knows everyone and retribution is certain even without a jail, so
 crime is **rare**; a larger, more anonymous colony offers cover. This is a deliberate inversion of the
 naive "no enforcement → more crime": a small colony is kept honest by its own closeness, not by a
 constable.
 A crime is one of **theft**, **vandalism**, or **assault** — leaning on who the culprit is (a
 kleptomaniac steals, a bloodlusty pawn assaults, a pyromaniac vandalizes).
 ## Consequences — the stakes
 A crime leaves a mark the colony can *see*:
 - **Theft** lifts a small stack of the colony's goods and the thief **pockets it**. RimWorld has no
  per-person property (stockpiles are communal), so theft is theft from the common store — but the
  culprit now physically carries what they took, a natural evidence trail a search can pick up.
 - **Vandalism** damages a nearby colony building.
 - **Assault** gives a nearby colonist a light, down-safe knock — and the culprit chooses their mark
  **wisely**: someone they resent (motive), who is weak (little retribution), and unwatched (few
  witnesses).
 - **Relationships fray.** An assault victim thinks much worse of their attacker immediately (they saw
  who did it); and when investigation *names* a culprit, the whole colony's opinion of them drops.
 - The colony is **notified** a crime happened — culprit unknown.
 ## Witnesses and investigation
 A crime is not equally solvable. Colonists who were near enough to **see** it are witnesses, and each
 is a partial lead — a witnessed crime starts up to 80% of the way to solved before anyone lifts a
 finger; an unseen one is a **cold case** worked from nothing.
 Investigation then builds evidence toward a full, named solve two ways:
 - **Ambient** progress, scaled by how many colonists the colony can spare — a background trickle from
  everyone keeping an eye out, faster when the colony has people to spare.
 - **The policing work type.** Assign a colonist to *policing* and they walk to open **crime scenes**
  and work them, adding a chunk of evidence scaled by their Intellectual + Social skill. A sharp
  constable cracks cases fast; a colony that spares no one lets them go cold.
 ## The weighed arrest
 A solved case does **not** mean an automatic arrest. Fellow-colonist cops will not gut the colony to
 jail someone over a petty crime — the arrest is a cost/benefit call, and it goes ahead only when both
 are true: the colony can **afford a prison**, and the crime is **serious enough** to clear a bar that
 rises with how valuable the culprit is.
 - **Severity** — the crime's kind (theft 1 · vandalism 1.5 · assault 2.5), escalated by the culprit's
  record (a rap sheet and prior escapes compound).
 - **Value** — 0..1 from the culprit's best skills. The bar sits at about 1.5 for an expendable pawn
  and climbs by three times the culprit's value — so a star colonist raises it to about 4.5.
 - **Capacity** — **below ~5 colonists, or with no prison bed, the colony arrests no one.** A prisoner
  plus a warden would cripple a small colony. Capacity ramps up as the colony grows.
 So a petty crime by your only doctor → they walk. A murder → arrested regardless. And a crime that
 paid, unanswered, erodes the climate of order a little more (crime emboldens).
 ## Resisting arrest
 The disposed do not go quietly (seeded by nature × nurture):
 - **Comply** → taken in cleanly (they become a prisoner of the colony — imprisonment is direct, and it
  survives guest-management mods like Hospitality).
 - **Resist** → the violent turn **berserk**, the rest **flee**. A botched arrest becomes a crisis the
  colony must handle the hard way, and openly defying arrest emboldens the lawless.
 - **Subdued** → a resister the colony beats down is then **imprisoned** — the resist path resolves to a
  cell once the colony wins the confrontation. One who flees the map gets away.
 ## Prison riots
 When the climate of order **collapses** (deterrence at the floor) in a colony holding prisoners, a
 neglected prison boils over into a **riot**: disposed prisoners turn violent together, and the unrest
 shatters order further. A well-run colony (high deterrence) never sees one — a riot is the thing a
 badly-run institution *earns*.
 ## Recidivism, made visible
 The loop closes on itself: a pawn hardened in prison (negative reform) runs a higher propensity and
 reoffends. When investigation names a culprit the colony had **paroled**, it says so out loud — the
 recidivism loop turning in the open, the payoff for everything classification, discipline, and parole
 did upstream.
 ---
 Part of **Institution: Policing**, in the Institution suite.
@@ -0,0 +1,221 @@
 # Commitment
 How involuntary psychiatric commitment actually works in play: how a colonist becomes a ward patient,
 what the treatment station does, how a room turns into a ward, who does the counselling, what the
 treatment buys, and what happens if you commit someone and then forget about them.
 ---
 ## The loop in one paragraph
 You **arrest** a colonist (or otherwise take a prisoner) and set their interaction mode to
 **psychiatric care**. You build a **treatment station** in their cell, which turns the room into a
 **psychiatric ward**. A warden walks over, sits, and **counsels** them; each session builds up their
 **treatment**, which **lowers their mental-break threshold** so they break less often. That progress
 **fades** over about a week if nobody keeps attending, so it has to be sustained. Counselling also
 gives the patient a small mood lift. Neglect a committed patient — leave them with no ongoing
 treatment — and once a day they pick up a **neglected** mood penalty that drags them back toward the
 break that got them committed. Treat them and they stabilise; forget them and they don't. That
 feedback loop is the entire mod.
 ---
 ## Step 1 — Becoming a ward patient
 Commitment reuses vanilla's arrest → prisoner transition. You don't get a new pawn state; you take a
 prisoner (arrest your own colonist, or a captured raider) and then switch on a new interaction mode.
 ### Psychiatric care — the interaction mode
 In the prisoner's interaction dropdown you'll find a new option, **psychiatric care**, sitting between
 *Reduce resistance* and *Release*. A few things make it behave the way it does:
 - **It stacks.** Unlike recruit / convert / enslave / release / execute — which are one-at-a-time
  choices — psychiatric care is a toggle that layers *on top* of whatever else you've picked, the
  same way vanilla's *Bloodfeed* and *Study* toggles do. So a patient can be set to **recruit AND
  psychiatric care at once**: you counsel a sad captured colonist toward stability while also chipping
  at their resistance.
 - **You can flag a downed or sleeping patient.** Setting the mode doesn't require them to be awake —
  the warden decides when to actually treat.
 - **Not for wild men**, and it works fine **without Ideology's ideoligion system**.
 Because the mode stacks, it also lets Ward coexist cleanly with work-your-prisoners mods like *Prison
 Labor* — see **Compatibility**.
 ---
 ## Step 2 — The treatment station
 Flagging a patient for care does nothing on its own. Treatment happens *at a station, in the
 patient's own room*. Without one, a patient flagged for care in an ordinary cell simply goes
 untreated — which is the point of the neglect penalty (Step 6).
 ### The treatment station — the building
 > *"A desk, a chair bolted to the floor, and a locked cabinet of sedatives. A warden set to
 > psychiatric care will use it to counsel patients held in this room."*
 | What | Value |
 |---|---|
 | Cost | **40 Steel + 2 medicine** — deliberately cheap |
 | Build time | Quick |
 | Research needed | **Medicine Production** — the one gate |
 | Size | A two-tile desk; pawns squeeze past it, so it doesn't wall off a cell |
 | Notes | It burns |
 **It's cheap on purpose.** The real cost of running a ward is not the 40 steel. It's the **warden
 hours** you spend counselling and the **labour you give up** by not putting the patient to work. The
 building is just the gate that says "this room is set up to treat people."
 And the locked cabinet isn't only flavour: a patient sliding toward a break faster than counselling
 can steady them is the moment a **sedative** earns its keep — something to calm a patient who's close
 to going over the edge.
 ---
 ## Step 3 — The room becomes a ward
 Once a treatment station stands in a room that already holds prisoner beds, the room's role changes
 from prison cell to **psychiatric ward**. Vanilla already has Prison Cell, Prison Barracks and
 Hospital; the ward is the fourth sibling. Two things are worth knowing:
 - **It's gated on the station.** A room only reads as a ward if it actually contains a treatment
  station *and* at least one prisoner bed. Without that, an ordinary prison cell full of beds keeps
  its normal Prison Cell role, untouched. Build the station and it's a ward; don't and nothing
  changes.
 - **It's still a prison cell.** Re-labelling the role does not release anyone. A ward is a prison cell
  *and* a ward at the same time, so containment, food delivery, and prison breaks all keep working.
 ---
 ## Step 4 — The warden does the work
 Counselling is **warden work**. Assign it the way you assign any warden task, and a warden will walk
 over and treat the patient. A few rules govern when a session can start:
 - The warden needs to be able to **talk and hear** — a mute or deaf warden can't counsel.
 - The patient must be **awake, not downed, and not mid-break** — you can't counsel someone who's
  unconscious or already spiralling.
 - There must be a **treatment station in the patient's own room** (not out in the open). You can't
  treat someone through a wall from a station two cells over.
 - Its priority sits **above chatting** but **below feeding** — an untreated patient deteriorates, a
  bored one doesn't — so wardens won't skip meals to run a session.
 ### A session
 - **Length:** about **20 in-game minutes**, with a progress bar while it runs.
 - It **fails out** if the patient despawns, is forbidden, falls asleep, or breaks partway through.
 - On completion it applies the treatment, gives the patient a "counselled" mood memory, runs a
  deep-talk conversation (so the relationship builds and the *next* session lands harder), and awards
  the warden **60 Social XP**.
 Because psychiatric care is its own separate warden job rather than a rewrite of vanilla's, it doesn't
 collide with mods that modify the built-in warden interactions — again, **Compatibility**.
 ---
 ## Step 5 — What treatment buys
 Each completed session adds to the patient's treatment, and how much depends on the warden's **Social
 skill**:
 | Warden Social skill | Treatment gained per session |
 |---|---|
 | 0 | 0.20 |
 | 5 | 0.275 |
 | 10 | 0.35 |
 | 15 | 0.425 |
 | 20 | 0.50 |
 The floor is deliberate: even an unskilled warden buys **0.20** a session. A bad ward is *neglect*,
 not *zero* — a clumsy counsellor is still worth something. Treatment tops out at **1.0**, a full
 course.
 **What it does:** while treatment is active it **lowers the patient's mental-break threshold by
 0.10** — a lower threshold means they break at a worse mood, i.e. **break less often**.
 **Decay is the mechanic.** Treatment bleeds off at **0.15 per day**, so a full course fades back to
 nothing in **about a week** if nobody keeps attending. A patient treated once and then ignored slides
 right back. Sustained counselling keeps it topped up and the break threshold suppressed; stopping lets
 it fade. Treatment is a *programme*, not a one-time cure.
 > The −0.10 break-threshold figure is a first pass and not yet heavily playtested — expect it to be
 > tuned.
 ---
 ## Step 6 — The other half: neglect
 A ward you don't staff is not a neutral place to keep someone. It's a *worse* one. Without a cost,
 "arrest the sad colonist and park them" would be a free way to remove a problem pawn from play. It
 isn't free.
 **Once per in-game day**, Ward checks every prisoner flagged for psychiatric care. Any patient who
 isn't currently under treatment — meaning no warden has been near them in days — picks up a
 **neglected** mood penalty. (The check keys off active treatment, and since treatment decays on its
 own, its absence is the tell that the patient has genuinely been left alone, not merely that nobody
 happens to be counselling them this exact minute.)
 ### The two moods
 | Mood | Value | Duration | Stacks to | Meaning |
 |---|---|---|---|---|
 | **Counselled** | **+6** | 2 days | 3 | "Someone sat with me and listened. It helped, a little." |
 | **Neglected** | **−8** | 3 days | 4 | "They locked me in here for my own good and then forgot about me." |
 Neglect is **asymmetric** — a −8 penalty stacking four deep (−32) badly outweighs three counselling
 lifts (+18). That's intentional: a neglected patient's mood falls, which raises their break risk,
 which is exactly the crisis you committed them to avoid. A ward can *manufacture* the break it was
 built to prevent. Staff it, or don't build it.
 > **Known rough edge:** neglect keys off "not currently under treatment," so a patient treated once a
 > week can technically dodge the penalty on the single day their treatment runs out. It's a documented
 > quirk, not yet smoothed.
 ---
 ## How it stacks with recruitment (and everything else)
 Because psychiatric care is a non-exclusive toggle, it layers onto whatever else you've set:
 | You want to… | Set | Result |
 |---|---|---|
 | Just stabilise a broken colonist | Psychiatric care | Wardens counsel; break threshold drops |
 | Talk a captured raider down *and* recruit them | Psychiatric care **+** Attempt recruit | Both run — counselling lifts mood while resistance is chipped |
 | Convert *and* treat | Psychiatric care **+** convert | Both toggle on |
 | Work a patient *and* treat them | Psychiatric care **+** Prison Labor's work mode | Both apply. Working a fragile patient is bleak — and it's your call |
 The last row is the darkest option the mod exposes, and it exposes it on purpose: Ward doesn't forbid
 working a patient, it just makes the trade-off visible.
 Because a ward patient is a genuine vanilla prisoner, everything the wider Institution suite does to
 prisoners applies to them unchanged — a committed patient can be classified, disciplined, paroled,
 searched, and can conceal or improvise contraband. See **Home** for the suite map and **Compatibility**
 for how Ward stays out of other mods' way.
 ---
 ## Quick reference — the numbers
 | Thing | Number |
 |---|---|
 | Treatment station cost | 40 steel + 2 medicine; needs Medicine Production research |
 | Counselling session | ~20 in-game minutes |
 | Treatment per session | 0.20 (unskilled) → 0.50 (Social 20) |
 | Treatment cap | 1.0 (a full course) |
 | Treatment decay | −0.15/day (~a week from full to nothing) |
 | Break-threshold effect | −0.10 while treated (breaks less often) |
 | Counselled mood | +6, 2 days, stacks to 3 |
 | Neglected mood | −8, 3 days, stacks to 4 |
 | Neglect check | once per in-game day |
 | Warden reward | 60 Social XP per session |
 ---
 ## Part of the Institution suite
 Institution: Ward is one mod in the **Institution** suite of RimWorld 1.6 mods — Ward, plus
 **Institution: Core**, **Institution: Contraband**, **Institution: Justice**, **Institution: Gangs**,
 and **Foul Play**. Each stands alone; together they interlock. A committed patient rides the same
 prisoner rail the rest of the suite polices, so a psychiatric ward is also a secure context where a
 patient can conceal and improvise contraband exactly as a prisoner can.
@@ -0,0 +1,93 @@
 # Institution: Ward
 **Involuntary psychiatric commitment for RimWorld 1.6 — the third pawn state, neither free nor guilty.**
 > **The psychiatric-care layer of the [Institution](https://git.arch.fyi/flan/institution)
 > suite.** Ward runs on Core's shared treatment engine and ships bundled in the single Institution
 > install with a toggle of its own; it still installs standalone (needing only Institution: Core and
 > Harmony). Once a separate sister mod, now folded in.
 RimWorld gives a person exactly two places to stand: **colonist**, or **prisoner**. There is no
 third state for someone who is neither free nor guilty. Out of the box you cannot commit anyone. A
 colonist breaks, wanders off, punches a wall, recovers on their own, and goes back to hauling steel
 as though nothing happened. Mental breaks are episodic and amnesiac — nothing persists, nothing is
 *done* about them.
 Ward adds the missing state, and the room to put it in. A colonist you arrest can be set to
 **psychiatric care**. Wardens counsel them at a **treatment station**. A room with prisoner beds
 and a treatment station is a **psychiatric ward**, not a prison cell. Treatment lowers the patient's
 mental-break threshold while it lasts — and it fades, so it has to be *sustained*. A ward you don't
 staff is worse than no ward at all.
 ---
 ## The third state RimWorld doesn't have
 The reason "commit a colonist" isn't a stock button is simple: vanilla only knows two kinds of held
 person — a free colonist and a prisoner. There's no built-in slot for someone who is neither free nor
 guilty, which is why other mods that keep a not-quite-colonist around (like *Hospitality* and its
 guests) have to work so hard to maintain them.
 **Ward takes the cheap road.** A committed pawn *is* a prisoner — arresting your own colonist already
 does that. Ward just adds a new **way to handle** that prisoner: a "psychiatric care" mode you toggle
 on, sitting alongside vanilla's recruit / convert / release options. Nothing exotic — it's the same
 kind of custom prisoner mode other prison mods already add.
 So committing someone is entirely ordinary from the game's point of view:
 - **psychiatric care** — a new prisoner interaction mode you switch on
 - **the psychiatric ward** — a new room role a cell earns once it holds a treatment station
 - **counselling** — a new warden job, handled like any other warden work
 - the **treatment station**, the **recovery**, the **neglect** — new content layered on top
 Because Ward *adds* things rather than rewriting how vanilla prisoners behave, it sits quietly next to
 the popular psych and prison mods instead of fighting them. Which mods, and why, is on the
 **Compatibility** page.
 ---
 ## Riding the prisoner rail (why the suite cares)
 The choice that makes Ward *cheap* also makes it *interesting* inside the wider Institution suite. A
 committed patient is a genuine vanilla prisoner. That means they're a **held pawn** in exactly the
 sense the rest of the suite understands: someone who can be searched, and who can conceal and
 improvise contraband. A patient in a psych ward can hoard a shiv or brew something foul in a smuggled
 vessel, because the contraband, search, corruption and gang systems already work on any held
 prisoner — and a ward patient is one, for free.
 **And re-labelling a cell as a ward never lets anyone out.** A ward is a prison cell that also happens
 to be a ward — the two roles coexist. Containment, food delivery, and prison breaks all keep working
 exactly as they did before you built the station.
 ---
 ## Wiki index
 | Page | What's on it |
 |---|---|
 | **Home** (this page) | What Ward is, the third-state problem, the suite |
 | **Commitment** | How commitment works in play: the care mode, the station, the ward room, the warden's job, treatment, recovery, neglect, and how it stacks with recruitment — with the real numbers |
 | **Compatibility** | Which popular psych and prison mods Ward plays nicely with, and why it doesn't fight them |
 ---
 ## Part of the Institution suite
 A set of RimWorld 1.6 mods about what an institution does to the people inside it. Each mod stands
 alone as an install; together they interlock into one system — colonists and prisoners drift toward
 crime on a spectrum of nature × nurture, and a policing/justice layer discovers, catches, punishes,
 reforms, or paroles them. Ward's psychiatric ward is a secure context where a committed patient can
 conceal and improvise contraband exactly as a prisoner can, because they ride the same prisoner rail.
 | Mod | What it is |
 |---|---|
 | **Institution: Ward** (this) | Involuntary psychiatric commitment — the third pawn state, neither free nor guilty. |
 | **Institution: Core** | The shared engine — propensity (nature × nurture), the criminal record, secured context. |
 | **Institution: Contraband** | The physical smuggling loop — conceal, improvise shivs, dig Prison-Architect tunnels, warden search, warden corruption. |
 | **Institution: Justice** | Corrections & policing — classification, deterrence, discipline, parole, regime. |
 | **Institution: Gangs** | Gangs as contraband economies — joining, smuggling networks, rivalry, fights-as-crime. |
 | **Foul Play** | The vessel + substance + throw framework, and the "Piss Nuke" flagship; bridges to Core + Contraband when both are present. |
 Reference sibling mods by name — the mods are separate repositories and cross-repo links break.
 ---
@@ -0,0 +1,36 @@
 # Compatibility
 Ward is built to sit alongside your existing mod list rather than elbow it aside. The trick is that
 Ward mostly **adds** things — a new "psychiatric care" prisoner mode, a new building, a new room role,
 new jobs — instead of rewriting how vanilla prisoners already behave. And a committed patient isn't a
 new kind of pawn: they're an ordinary vanilla prisoner with an extra "treat me" flag switched on. So
 any mod that already works with prisoners keeps working with a ward patient, and Ward stays out of its
 way.
 Here's how Ward gets along with the popular psych and prison mods:
 | Mod | How it coexists with Ward |
 |---|---|
 | **Hospitality** | Hospitality manages *guests*; Ward manages *prisoners*. They ride two completely separate rails and never touch. |
 | **Prison Labor** | Psychiatric care is a toggle, so you can put a patient **to work *and* in treatment at the same time**. No conflict, no either/or. |
 | **Custom Prisoner Interactions** | That mod tweaks the built-in warden interactions (chat, convert, enslave, release). Ward's counselling is a *separate* job of its own, so the two don't overlap. |
 | **Prison Commons** | Ward's warden work automatically respects prison-commons areas — you get that for free, without either mod knowing about the other. |
 | **Psychology (unofficial) · Rim Disorders · More Mental Breaks** | These reshape the mental-break and mental-illness machinery. Ward doesn't touch that machinery — it just nudges the break *threshold* the way a mood effect would — so they all stack. |
 | **Prisoner Realism** | It changes how the game decides what counts as a prison cell. Ward's ward role sits on top of that without breaking containment — a ward is still a prison cell. |
 | **Locks · Restraints · Prisoner Recreation** | All fine. They touch prisoner behaviours Ward leaves alone. |
 | **Dubs Bad Hygiene** | No overlap at all. |
 | **Royalty · Ideology · Biotech** | Ward works with or without the DLC. Psychiatric care is available even if you don't run Ideology's ideoligions. |
 The general rule: because Ward *adds* rather than *overrides*, it should also coexist with prison and
 psych mods that aren't on this list. If you ever find one it genuinely fights, that's a bug worth
 reporting — Ward's whole design is built around not doing that.
 ---
 ## Part of the Institution suite
 The Institution suite — **Institution: Core**, **Institution: Contraband**, **Institution: Justice**,
 **Institution: Gangs**, **Foul Play**, and **Institution: Ward** — is a set of RimWorld 1.6 mods about
 what an institution does to the people inside it. Each stands alone; together they interlock. Ward's
 psychiatric ward is a secure context where a committed patient can conceal and improvise contraband
 exactly as a prisoner can, because they ride the same prisoner rail the rest of the suite polices.
Author	SHA1	Message	Date
flan	9c6bd2db73	Fix the suite link in the Ward wiki page It pointed at flan/rimworld-institution -- the local directory name, not the repo. This one is public, so the 404 was facing outward.	2026-09-14 18:25:48 +00:00
flan	2b9d53abc4	Remove README badge wall; drop heading emoji and extra emphasis	2026-08-03 23:43:00 +00:00
flan	cb163ff596	Repoint forge references from git.onetick.ninja to git.arch.fyi	2026-08-03 20:03:18 +00:00
flan	7484a9bf70	Add project badges	2026-08-03 19:28:35 +00:00
flan	b813cb8b4f	Add sponsor badges to README	2026-08-03 19:09:26 +00:00
flan	17462eefc8	Add donation links (GitHub Sponsors, Ko-fi)	2026-08-03 18:46:24 +00:00
flan	d4fa0bec17	Add the wiki link to the store description + the mod <url>	2026-07-16 02:59:54 +00:00
flan	8250dcb369	Wiki: player-facing rewrite of every layer + add a scenario FAQ, linked from Home	2026-07-16 02:18:25 +00:00
flan	ff703271ba	Rewrite the README for players: what each layer does in play, the wiki linked front-and-center	2026-07-16 02:05:56 +00:00
flan	5465f64a3d	Rewrite the store description to the six-layer split (Policing/Corrections/Ward)	2026-07-16 01:57:14 +00:00
flan	1b3403efff	Aggregate: vendored Defs follow the namespace rename (Class=Institution.*)	2026-07-16 01:51:20 +00:00
flan	d0a4c001fa	Release 0.1.0	2026-07-16 01:48:01 +00:00
flan	3fc4ef7a1d	Rename the shared code namespace Contraband -> Institution; add license The suite's classes all lived in namespace Contraband -- a historical artifact from the original Contraband monolith, which read oddly for a class in Corrections or Policing. Renamed to namespace Institution across every layer (46 .cs, the XML Class= refs, RootNamespace, the aggregate shim). The Contraband MODULE, its Contraband.dll assembly, and the Contraband-named classes (CompContraband, MapComponent_Contraband, ContrabandUtility, ...) are unchanged. Harness-verified 45/0. Also adds a CC-BY-NC-SA 4.0 LICENSE file. Aggregate: the settings shim now writes Institution.InstitutionSettings; Assemblies re-vendored with the renamed DLLs; ROADMAP status refreshed to the six-layer suite at 0.1.0.	2026-07-16 01:45:34 +00:00
flan	e96ac23949	Move AI attribution to a single NOTICE file Per the updated project policy, AI/Claude attribution lives in exactly one NOTICE file per repo and nowhere else -- removed it from the About description, README, wiki, and roadmap.	2026-07-16 01:30:09 +00:00
flan	ac68350662	Re-aggregate wiki after the NOTICE migration	2026-07-16 01:12:46 +00:00
flan	8007f4e4e2	Re-aggregate wiki + repackage for the split sync-wiki.sh mirrors policing + corrections instead of justice; the aggregate Wiki index and the per-layer folders reflect the six-layer suite (Core - Contraband - Policing - Corrections - Gangs - Ward) and the reserved Judiciary seam. Assemblies re-vendored with the fresh module DLLs.	2026-07-16 01:07:06 +00:00
flan	7ce9c045c3	Repackage the aggregate onto the Policing + Corrections split package.sh builds and vendors InstitutionPolicing + InstitutionCorrections (Policing first) instead of InstitutionJustice, and merges both modules' Defs. The settings shim's 'Justice' checkbox becomes 'Corrections'; deterrence and riots move under the Policing toggle.	2026-07-16 00:45:41 +00:00
flan	d44b7887d9	Repackage aggregate onto the smuggling-route build; add TUNING.md Vendors the Contraband build that wires Corruption.Smuggle (visitors and bent wardens deliver contraband). TUNING.md records the measured per-day rates from the full-stack harness against their pre-registered target bands -- all in band: ordinary colonists ~never offend, a mistreated psychopath ~1 crime/day, reform is a 0.7-2 day investment. No constant was changed; the run validated the pacing.	2026-07-15 23:21:55 +00:00
flan	3d4f1b0052	Re-package with the security marker + texture bundled; ROADMAP: feature list complete, only playtesting remains	2026-07-15 22:30:03 +00:00
flan	8fe98b4560	Sync wiki: Regime section (yard/lockup + visitors)	2026-07-15 22:07:18 +00:00
flan	fe8971c1db	Re-package with visitation + Yard/Lockup bundled; ROADMAP: these ship now	2026-07-15 22:05:59 +00:00
flan	26205b9206	Re-package with the enforcement layer; refresh the stale ROADMAP; sync wiki	2026-07-15 21:40:35 +00:00
flan	7d8c376047	Wiki: link Foul Play to its wiki rather than its repo	2026-07-15 21:14:24 +00:00
flan	18a983b7cc	Re-package with the corrections layer bundled; sync the wiki (Rehabilitation page, loop update)	2026-07-15 21:01:28 +00:00
flan	3530100ed5	Aggregate the whole suite wiki onto the Institution page Wiki/Home.md is the suite's front door; every layer's wiki now mirrors here under Wiki/<layer>/ (core, contraband, justice, gangs, ward), so the whole suite reads in one place with the index linking to the local pages. The layer repos stay canonical -- Tools/sync-wiki.sh refreshes the aggregated copy on demand. The README's main page points to it.	2026-07-15 20:30:38 +00:00
flan	25eb3a77db	Fix: bundle Ward's Patches into the aggregate (Rim Disorders integration) The re-package vendored Ward's Defs and Textures but not its Patches/ dir, so the disorder-treatable marking never applied -- psychiatric treatment silently did nothing to the illness a patient was committed for. package.sh now vendors Ward's Patches too. The folded-suite compat harness confirms it: integration.disorderMarkedTreatable now passes with Ward bundled in the aggregate. Add the suite-overview wiki (Wiki/Home.md).	2026-07-15 20:27:57 +00:00
flan	2d46fef192	Re-package the aggregate: bundle Ward + ship the policing layer Fold Ward into the single Institution install as its psychiatric-care layer. package.sh now builds Ward clean and vendors Ward.dll plus its defs and textures alongside the other layers, and the settings shim gains a Ward (psychiatric care) checkbox that writes the shared InstitutionSettings.ward flag. Re-assembling also carries in Justice's now-shipping policing defs (the constable work type and crime thoughts), so the aggregate finally bundles colony crime and the weighed arrest as well. README updated to five layers over one Core with policing shipped and Ward folded in; adds the changelog, the Workshop preview, and the preview generator.	2026-07-15 20:10:56 +00:00
flan	bd96c2c516	Add the Policing settings toggle; re-vendor Core + Justice DLLs A fourth checkbox (Policing, default on) drives colony crime independently, and the re-vendored drop-in carries the flipped-on Core flag, the enrichments, and prison riots.	2026-07-15 18:37:17 +00:00
flan	703317b507	Re-vendor the Justice DLL with the resistible arrest into the drop-in	2026-07-15 18:09:26 +00:00
flan	0a26804626	Re-vendor the Justice DLL with the weighed arrest into the drop-in	2026-07-15 17:50:12 +00:00
flan	6fd3c3eb9b	Vendor Justice's crime ThoughtDefs + updated DLL into the drop-in package.sh now merges Justice's Defs (the crime relationship thoughts) into the aggregate's Defs tree alongside Contraband's, so the shipped one-mod Institution carries them. Re-vendors the Justice DLL with the consequences/relationship code.	2026-07-15 17:06:54 +00:00
flan	7fd3d32eb2	Re-vendor the Justice DLL with the cops investigation loop	2026-07-15 16:47:32 +00:00
flan	18fc44c728	Consolidate the suite into one installable Institution mod with toggles This repo is now the single player-facing mod. It bundles the whole engine and all three feature layers into one folder -- Core, Contraband, Justice, and Gangs DLLs plus Contraband's Defs -- with one About.xml and a settings shim that turns each layer on or off from a checkbox (all on by default). A player installs one mod (this) and Harmony; no separate Core dependency. - Source/Institution: the only new code, a settings shim (InstitutionMod + InstitutionModSettings) that writes the player's choices into Core's shared InstitutionSettings. It owns no gameplay. - Tools/package.sh: rebuilds the sibling DLLs clean and vendors them + Contraband's content in here, so the repo stays a complete drop-in. - Assemblies/, Defs/, Textures/, Languages/: the vendored, assembled mod. Still fully modular and splittable: the feature code stays in its own repos and DLLs (their About.xml files remain), so breaking this back into separate mods is just shipping them individually -- no code change.	2026-07-15 16:11:56 +00:00
flan	401d34f390	Note the four-mod split at the top of the roadmap Adds a status callout establishing the shipped Core/Contraband/Justice/Gangs topology and pointing at the README, so the older design sections (which group modules the pre-split way) don't mislead. The north star and secured-context principle are unchanged.	2026-07-15 08:08:39 +00:00
flan	094f531ca0	Update the suite map for the four-mod split Core / Contraband / Justice / Gangs replace the old monolith-plus-planned layout: adds Institution: Core, slims Contraband to the physical smuggling loop, and promotes Justice (with Regime/Discipline folded in) and Gangs from planned to shipping. Updates the dependency notes and the standalone-vs-Core principle to match the real topology.	2026-07-15 07:56:03 +00:00
flan	5284dbf067	roadmap: container physics (capacity, pour, dip furniture) + stage 5 shipped	2026-07-15 05:53:53 +00:00
flan	4a250435a8	roadmap: propensity merge shipped (Disposition.Source seam, stage 2)	2026-07-15 04:27:10 +00:00
flan	8c029eba88	roadmap: Foul Play is universal (any pawn fills vessels); the eight-liquid catalogue - Universality principle: filling/fermenting/throwing/drinking/addicting are any pawn's behaviours, gated by disposition, not prisoner status. Contraband is the held-pawn CONCEALMENT lens on top. Prisoner gate lives only on the conceal path. - Drink-any-fluid stage now includes blood as a substance and per-fluid addiction rarity modified by mental health + circumstances.	2026-07-15 04:04:56 +00:00
flan	036facab29	roadmap: generic vessels + runtime contents (Noita-flask model) Hooch reframed per user directive: not a bespoke item but FP_Hooch the substance, in generic vessels whose contents are runtime state -- fill, ferment, pour, drink, mix. Staged: runtime substance -> drink-any-fluid -> contraband content tag -> pour+mix -> ferment-model overhaul (age+dilution+sealed/open+temperature+spoil, mirroring CompRottable). Any fluid drinkable with different consequences; blood is a substance; any drink can breed addiction at a per-fluid rarity, modified by mental health + circumstances.	2026-07-15 03:48:54 +00:00
flan	fcfb32fff7	roadmap: secure-zone guard frisk + age/storage potency model - Secure-zone checkpoints frisk guards too -> the counter-play to a bent warden smuggling contraband in. Wires corruption <-> secure zones <-> the search loop. - Potency = age + storage (sealed/open), never container size. Topping up dilutes age (volume-weighted), so a shared bucket stays fresh while a hidden jar ages to full potency -- "a jar of old piss and a bucket of fresh" both make sense.	2026-07-15 03:18:13 +00:00
flan	78fe129911	roadmap: capture the expanded substance + warden-personality vision Foul Play "finish substances" grew into a substance-cocktail system, staged so each ships green: - Hooch: fermentable, incendiary flame-splash firebomb (no splash-code change -- just a flame damageDef through the existing GenExplosion path), also drinkable. - Ferment in ANY liquid-holding furniture (toilet, barrel, tub, sink, vat), capability-detected by recognizable identity + known vanilla defs, no DBH dependency. Hooch requires a site; piss can use one but still brews from body. - Mixing: a vessel's contents become a runtime blend of SubstanceDefs and the splash applies all effects together; defaults to the single substance unmixed. Contraband warden-personality/corruption (queued under Discipline): search intensity by trait + circumstance, per-warden item forgiveness, and bent wardens who smuggle contraband IN -- the corruption supply route that feeds a gang.	2026-07-15 03:13:27 +00:00
flan	5a8b4becac	roadmap: intake shipped Harmony-free (poll-based, not a SetGuestStatus patch)	2026-07-15 03:03:31 +00:00
flan	dbd6ea0e03	roadmap: institutionalization & recidivism are ours, on our own axis Corrected an over-correction. In a suite named Institution these are the namesake, and our substrate builds them on an axis Prisoner Realism has no engine for, so it is complementary, not a rebuild: - Institutionalization -> prisonization, and NOT a new system: the existing Propensity.Nurture reads the existing CriminalRecord.reform field (signed: harsh regime prisonizes, rehabilitative reforms). One field, additive. When PR is present we soft-read its hediff as one more input -- no patch, no dependency. - Recidivism -> we own the reintegrated who STAY and reoffend inside the colony (wiring gap D); PR owns the departed who return as raiders. Different population, no overlap. Also records the governing constraint "defer the depth, never the payoff": the propensity -> contraband -> detection spine is fully ours and self-complete; only the response side (Discipline, Parole) needs its own minimal effect so nothing dangles when PR is absent.	2026-07-15 02:50:38 +00:00
flan	f90da721a4	Re-cut roadmap after Prisoner Realism deep scan Mapped Prisoner Realism (11.3k subs, good) feature-by-feature. It owns 20 prisoner-behavior systems, several of which were on our build list. Under the standing "keep good incumbents" rule: - DELETE our reintegration+recidivism module. PR's Recidivism is complete and good. Parole keeps only the ideology-driven release decision (self-complete); PR supplies the return outcome when present. - RE-SCOPE Classification to a pure router (reads record + propensity, assigns a tier). PR's Solitary owns the isolation toll. - RE-SCOPE Gangs to contraband economies. PR's Ringleader owns mood contagion. - NARROW the escape tool to the wall-cut path for ward patients and low-skill pawns PR's break/lockpick system never moves. Sharpens Institution's uncontested core: hidden-contraband + search, propensity across all pawns, Ward, Foul Play, classification-as-router, and policing free colonists (the crime loop turned on your own colony).	2026-07-15 02:16:58 +00:00