Prisoner Diplomacy

Prisoner Diplomacy

RimWorld 1.6 | Version 1.2.1

• One diplomacy hub: review every known faction from the vanilla comms console.
• Meaningful deals: trade prisoners for silver, supplies, goodwill, ceasefires, intelligence, or hostages.
• Lasting consequences: factions remember care, cruelty, broken promises, and executions.
• Story with rules: neutral exchanges, infiltration, trials, rescue operations, and pirate ambushes.
• Built to extend: versioned APIs support race adapters, special rewards, personas, and add-ons.

Negotiation and fulfillment

• Open the hub through a powered comms console, or respond to faction letters. A crafted portable diplomacy terminal can review known contacts without a console.
• Negotiate silver, faction-appropriate supplies, goodwill, 5-30 day ceasefires, one-use early-warning intelligence, prisoner exchanges, and adapter-defined rewards.
• A deal is not paid when you click accept. Use the marked release command on the correct prisoner and let the vanilla release workflow complete the safe map exit.
• Death, escape, recruitment, enslavement, sale, or an improper release can invalidate a deal. Exactly-once guards prevent duplicate rewards after save/load.

Memory and events

Factions track reliability, prisoner treatment, and resentment. Medical care and honored agreements can improve relations; organ harvesting, cruelty, broken promises, and executions can create lasting hostility.

Neutral world-map exchange points use a real Caravan handoff. False surrender and infiltration, public trials, rescue retaliation, ceasefires, early-warning reports, and ransom ambushes add costs beyond the original offer. Pirate risks are disclosed before release.

Optional AI

AI is disabled by default and is never required. When enabled, it can use faction persona, ideology, injuries, relationships, history, and a player note to write a distinctive reply.

AI text is narrative-only by default. Formal terms, payment, deadlines, Pawn state, and event outcomes remain deterministic game state. An independent opt-in may advise on an unaccepted counteroffer, but the core revalidates reserves, inventory, legal rewards, and stale context. Without a provider, the mod remains fully localized and offline.

API, compatibility, and privacy

The public versioned API lets add-ons register race/faction adapters, special ThingDef rewards, personas, event metadata, and bounded UI extensions. The core owns pricing, caps, persistence, release validation, and fulfillment. Start with PrisonerDiplomacyApi.md and the developer docs.

RimWorld 1.6 and Harmony are required. RimChat, Humanoid Alien Races, Hospitality, Combat Extended, and other race/faction mods are optional integrations; the core has no AI or RimChat dependency.

Anonymous error reports are optional and consent-gated. Reports are sanitized, asynchronous, and cannot modify the installation. They may contain error/version data, anonymous deal state, and active Package IDs, but not saves, Pawn names, colonies, hardware IDs, or API keys. Detailed reports expire after 30 days; aggregate and repair-audit data after 180 days. Production analysis uses Gemini 3.7 Flash and sends only high-confidence internal defects to AI-HUB for a GPT-5.6 SOL repair candidate. Provider failure never affects gameplay.

FAQ

Do I need AI or RimChat?
No. The deterministic negotiation system, localized replies, and every transaction work without either one.

What is the main entry point?
The vanilla comms console exposes one persistent Prisoner Diplomacy hub. Letters still handle incoming offers. The portable terminal is an optional in-game item for reviewing contacts away from a console.

Why must I release the prisoner through the marked command?
The marked vanilla release flow verifies the correct Pawn, map, deadline, and handoff before any reward is fulfilled. Death, escape, sale, recruitment, enslavement, or an unmarked release can fail the deal.

Can other race or faction mods add their own rewards?
Yes. Add-ons use the versioned adapter API to register prices, special items, personas, or events. The core still validates and fulfills them.

Where are the source and beginner guides?
The project is open source on GitHub. The five-language beginner guide, compatibility notes, API docs, and debug test guide are included there. Join the QQ discussion group (211784688).

This mod was 100% produced by Codex (GPT-5.6 SOL); the project owner provided the ideas only.