aviuz/prisonlabor

Purpose and Runtime

Prison Labor is a RimWorld mod that extends prisoner management so designated prisoners can perform colony work under supervision. It runs as a C# RimWorld assembly, loaded with version-specific XML content for game versions 1.0–1.6. Primary bootstrapping is Source/Initialization.cs; project entry/build definition is Source/PrisonLabor.csproj. Mod metadata and load-folder routing are About/About.xml and LoadFolders.xml.

Definition-Driven Game Integration

Each supported RimWorld version has a content root (1.0 through 1.6) containing compiled assemblies and XML Defs. The Def layer registers jobs, work types/givers, needs, thoughts, incidents, prisoner interaction modes, and AI think-tree changes—for example 1.6/Defs/JobDef.xml, 1.6/Defs/WorkGiverDef.xml, and 1.6/Defs/ThinkTreeDef.xml. This is the boundary where RimWorld’s data loader discovers mod behavior.

Prisoner State and Policy

PrisonerComp is the per-prisoner state model, with properties and related trackers for cuffs, escape risk, and inspiration. It supports work eligibility, restraints, treatment, and operational status that downstream AI and UI consume. Core paths: Source/Core/Components/PrisonerComp.cs, Source/Core/Trackers/EscapeTracker.cs, Source/Core/LaborWorkSettings/WorkSettings.cs.

AI, Work, and Supervision Flow

RimWorld’s think trees select prisoner-specific job givers; labor-enabled prisoners are assigned jobs subject to motivation, schedules, reachable labor areas, reservations, and permissions. Supervisors receive dedicated work/jobs, while prisoner job drivers handle restraints and related actions. Relevant implementation: Source/Core/AI/JobGivers/JobGiver_Labor.cs, Source/Core/AI/WorkGivers/WorkGiver_Supervise.cs, Source/Core/AI/JobDrivers/JobDriver_Supervise.cs.

Labor Boundaries and Game Patching

Harmony patches alter vanilla work scanning, job execution, food, arrest, forbidden/reservation logic, work settings, and escape behavior so prisoners can perform work without violating vanilla faction/prisoner assumptions. The patch layer is the key compatibility boundary with RimWorld internals: Source/HarmonyPatches/HPatcher.cs, Source/HarmonyPatches/Patches_Work/Patch_WorkGiver_PrisonerFaction.cs, Source/HarmonyPatches/Patches_LaborArea/Patch_Scanner_HasJob.cs.

Management UI and Player Control

A custom main prisoner-management window exposes overview, labor assignments, schedules, and prisoner-specific columns such as motivation, treatment, work state, restraints, and escape tracking. Labor-area designators define where prisoners may work. Paths: Source/Core/MainButton_Window/PrisonerButtonWindow.cs, Source/Core/MainButton_Window/MainTabWindow_Labor.cs, Source/Core/LaborArea/Designator_AreaLabor.cs.

Needs, Outcomes, and Events

Motivation and treatment are custom needs feeding thoughts and behavior; low motivation can affect prisoner handling. The mod also introduces prisoner incidents and supports recreation, chains, and interrogation/Ideology ritual mechanics in newer versions. Paths: Source/Core/Needs/Need_Motivation.cs, Source/Core/Incidents/IncidentWorker_Revolt.cs, Source/Core/Interrogation/Comp_Interrogation.cs.

Persistence, Expansions, and Mod Compatibility

Save cleanup/upgrading and version patches preserve old-save compatibility. Optional content and independently compiled Harmony adapters integrate third-party mods such as Hospitality, Quarry, Cash Registry, Therapy, Kijin, and Colony Groups; their assemblies are deployed under versioned folders. Paths: Source/Core/GameSaves/SaveUpgrader.cs, Source/CompatibilityPatches/OlderVersions.cs, Source/CompatibilityProjects/HospitalityCompatibility/HarmonyInit.cs.