breach (Formerly Breacher)

A puzzle solver for the Cyberpunk 2077 breach minigame.

Tip Jar

If you like this software feel free to leave a tip :)

Output

This puzzle solver requires you give the input in the format detailed below and will print the best possible solution in matrix format. Input can be given from a file or stdin.

Example output (From puzzle 37)

Install with dotnet

1. Install the dotnet CLI (.NET SDK 6)

   or

   You can now install dotnet with winget:

   winget install Microsoft.dotnet
   

2. Install with dotnet

   dotnet tool install --global breach
   

   which installs from https://www.nuget.org/packages/breach/.

   After installing you can just run breach. The screen shots below use dist\breach.exe since I was running the locally built executable.

3. You can update to new releases via

   dotnet tool update --global breach
   

Using the tool

Manual entry on the cli

Enter input manually by running the program with no arguments. e.g.

Input File

Enter input with an input file. The input file should not have a q at the end.

Piping from stdin

Enter input by pipeing from stdin. The input file should not have a q at the end.

(The | (vertical bar) is what we call the pipe operator.)

Puzzle Input Format

<buffer-size: single digit>
<blank-line>
<puzzle: one row per line>
<blank-line>
<targets: one per line>

Target and Solution Weights

The targets you enter are weighted in the order they are entered. For example:

e9 55 55 55 bd
e9 1c 1c 55 e9
1c 55 1c bd 55
55 55 1c 1c 1c
bd e9 1c 55 e9

55 55     <- target 1 weight 1
bd 55     <- target 2 weight 2
e9 1c 55  <- target 3 weight 4
...       # weight 8

So a solution weight means:

Set buffer size with env var BREACH_BUFFER

You can use set your buffer size with the env var BREACH_BUFFER so you don't have to input it every time.

Note that running these commands in your terminal only sets them for that terminal session. A new terminal will not have them set.

Windows

set BREACH_BUFFER=6

OSX / Linux

export BREACH_BUFFER=6

For examples see the demo puzzles.

Puzzle txt/01.txt is:

7

1c 55 ff bd e9
bd 1c e9 ff e9
55 bd ff 1c 1c
e9 bd 1c 55 55
55 e9 bd 55 ff

e9 55
55 bd e9
ff 1c bd e9
55 1c ff 55

Run/build from source

1. Install the dotnet CLI (.NET SDK 5.0.101)
2. Install Git for your operating system.
3. Open a terminal and clone this repo.

   git clone https://github.com/kyle-rader/breach.git
   

4. cd into the repo.
5. Compile the program

   publish.cmd
   

   This will make a folder called dist in which you will find the self-contained executable. You can then run it via

   dist\breach.exe
   

Future Work

• Print the solution visually to make it easier to follow.
• Build GUI to allow pasting screen shots and parse puzzle input using ML for ultimate laziness.

Closing Notes

I found this to be one of the more interesting mini game puzzles in a video game. Programming a solution was simply out of interest and for fun to check myself. The mini-game is to emulate "hacking" so I don't feel bad about actually "hacking" the game ;)

Suggestions welcome. Feel free to open a pull request!