Skip to content

wothers/ktane-random-rules-mod

Repository files navigation

KTaNE Random Rules Mod

A BepInEx mod for Keep Talking and Nobody Explodes that randomizes the defusal rules for every bomb using a seed-based system.

About

In the base game, all bombs follow the same fixed rules from the Bomb Defusal Manual. After enough play, these rules can be memorized, reducing the challenge.

This mod replaces the fixed rules with randomly generated ones. Each bomb gets a unique seed code (e.g. A3F7B201) that determines the full set of rules for all 12 vanilla modules:

  • Wires
  • The Button
  • Keypads
  • Simon Says
  • Who's on First
  • Memory
  • Morse Code
  • Complicated Wires
  • Wire Sequences
  • Mazes
  • Passwords
  • Knobs (Needy)

The Defuser sees the seed in-game, tells it to the Expert, and the Expert enters it on the companion website to generate the matching manual -- ensuring both players are always working from the same randomized ruleset.

Installation

Prerequisites

  • Keep Talking and Nobody Explodes (Steam version)
  • BepInEx 5.x (x64) installed into the game directory

Steps

  1. Install BepInEx if you haven't already:

    • Download the latest BepInEx 5.x x64 release.
    • Extract it into your KTaNE game folder (e.g. C:\Program Files (x86)\Steam\steamapps\common\Keep Talking and Nobody Explodes).
    • Run the game once so BepInEx creates its folder structure, then close it.
  2. Install the mod:

    • Download RandomRulesMod.dll from the Releases page.
    • Place the DLL into BepInEx\plugins\ inside your game folder.
  3. Launch the game -- the mod loads automatically.

How to Play

  1. Defuser: Launch a bomb as normal. A seed code appears in the top-left corner of the screen.
  2. Defuser: Tell the Expert the seed code.
  3. Expert: Open the Random Rules Manual website.
  4. Expert: Enter the seed code and click Generate Manual. The page produces a complete defusal manual matching the Defuser's bomb.
  5. Play the game using the generated manual instead of the standard one. The Expert can also print the manual for a more traditional experience.

Seed Modes

Press F8 in-game to open the mod's settings panel. Three seed modes are available:

Mode Behavior
Random (default) A new random seed is generated after each bomb.
Manual Enter a specific seed code to use for every bomb. Useful for practice or replaying a particular ruleset.
Default Disables the mod and uses the game's original fixed rules.

Building from Source

Prerequisites

  • Visual Studio 2022+ or MSBuild 17+
  • .NET Framework 3.5 targeting pack (Unity 2017.4 compatibility)
  • Keep Talking and Nobody Explodes installed locally

Setup

  1. Clone the repository.
  2. The build needs to find your KTaNE install for the Unity engine DLLs. The project checks common Steam paths automatically. If your game is installed elsewhere, create a Directory.Build.props.user file in the repo root:
    <Project>
      <PropertyGroup>
        <KtaneGameDir>D:\YourPath\Keep Talking and Nobody Explodes</KtaneGameDir>
      </PropertyGroup>
    </Project>
  3. Open RandomRules.slnx in Visual Studio, or build from the command line:
    msbuild RandomRules.slnx
    
  4. The compiled DLL will be in RandomRulesMod\bin\Debug\.

Dependencies

License

This project is not affiliated with or endorsed by Steel Crate Games.

About

Mod for Keep Talking and Nobody Explodes to randomize the bomb defusal rules

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Languages