# ClickReducer User Guide

This guide is written for normal users. You do not need Visual Studio, .NET commands, or source code.

## Install

1. Download `ClickReducer-v0.9.0-win-x64.zip` from the ClickReducer website.
2. Extract the zip.
3. Double-click `ClickReducer.exe`.
4. Follow the setup screen.
5. If Windows SmartScreen appears, choose `More info`, then `Run anyway`, but only if you downloaded the file from the official download page.
6. If the game is running as Administrator, run ClickReducer as Administrator too.

ClickReducer is portable. It does not need an installer.

## Main Concepts

`Box 1` is your main window. Broadcast triggers are accepted only when Box 1 is focused.

`Application Windows` shows the detected game windows and their assigned box numbers.

`Profiles` let you keep separate rule sets for different groups. For example, you can keep one profile for six-box play and another profile for a three-character raid setup.

`Rules` map one trigger to one or more outputs. A rule can send the same output to every target box or different outputs to specific boxes.

`Output Map` controls what each box receives for the selected rule. The `Default` row is the output used by every enabled box unless that box has its own override.

`Box Identifiers` let you rename Box 1 through Box 6 for the current profile. If an identifier is blank, ClickReducer falls back to `Box 1`, `Box 2`, and so on.

## First Setup

1. Open your game windows, then arrange the application icons from left to right on your start bar in the order you want them assigned. Each character needs its own normal taskbar window.

   ![Game windows arranged left to right](assets/screenshots/left-to-right-windows.png)

2. Open ClickReducer.
3. The setup screen appears automatically on a fresh install.
4. Choose the number of boxes in this profile.
5. Click `Assign Left-to-Right`.
6. Optionally create the starter rule.
7. Click `Finish`.

After setup, use the `Setup` button to run the same setup screen again.

If you do not use a left-to-right layout, close setup and use `Assign 1-N`, then activate each game window in the order you want them assigned.

ClickReducer does not launch the game for you. A launcher shortcut is fine only if it creates separate normal game windows. If a launcher or shortcut keeps clients inside another tool, wrapper, or container window, ClickReducer may not detect them.

## Creating Separate Game Shortcuts

Each character should open as its own normal game window, with its own taskbar button. Do not use a launch method that keeps all characters nested inside one launcher, wrapper, or container window.

If you want one desktop icon per account, copy or create shortcuts. Do not copy the actual game executable file.

1. Right-click your existing game shortcut and choose `Copy`.
2. Right-click your desktop and choose `Paste`.
3. Rename the new shortcut for that character, such as `Tank`, `Healer`, or `DPS`.

   ![Desktop shortcut for one box](assets/screenshots/desktop-shortcut.png)

4. Right-click the new shortcut and choose `Properties`.
5. Open the `Shortcut` tab.
6. Edit `Target` so it launches that account directly.

   ![Shortcut target with direct account login](assets/screenshots/shortcut-target-properties.png)

The target format should look like this, adjusted for your own game folder and account name:

```text
"C:\Games\Game\game.exe" patchme /login:EXAMPLE
```

Keep the quotes around the executable path. Replace `EXAMPLE` with that box's account name. Repeat this for each character/account you want to launch separately.

## Create A Basic Rule

1. Select the profile you want to edit.
2. Click `Capture` beside `When`.
3. Press the trigger key or hotkey, such as `E` or `Shift+F`.
4. Enter the default output in the `Default` row of `Output Map`, or click its `Capture` button.
5. Turn on the target boxes that should receive the output.
6. Click `Add Rule`.

To edit an existing rule, select it, make changes, and click `Update`.

To temporarily stop a rule, uncheck the box beside the rule in the rule list.

## Per-Box Outputs

Use per-box outputs when one trigger should send different keys to different characters.

Example:

- Trigger: `Shift+E`
- Box 2 output: `Shift+2`
- Box 3 output: `8`
- Boxes 4, 5, and 6 output: `7`

Set `Default` to `7`, turn on Boxes 4 through 6, then turn on Boxes 2 and 3 with their own row overrides.

## Profiles

Profiles are useful when you play different group sizes.

Example profiles:

- `6box - Normal`
- `3box - Raid`
- `2box - Utility`

Each profile has its own rules, box identifiers, and box count.

When you add a profile, ClickReducer copies the current profile so you can remove targets or disable rules without rebuilding everything.

## Overlay

The overlay is a small topmost status widget.

- Grey X: broadcasting is off.
- Yellow pause icon: broadcasting is paused.
- Green play icon: broadcasting is on.
- Blue active icon: a broadcast sweep is currently running.

Drag the overlay from anywhere on it. Right-click it to toggle broadcasting or reset its position.

Use `Overlay ON/OFF` in the main window to show or hide it.

## Box Text

The `Box text` row sends text or commands to boxes using the same focus-sweep approach as normal key rules.

- `Send All` sends to the assigned boxes for the current profile.
- Individual box buttons send only to that box.
- `Wait ms` controls the delay used inside the text send sequence.

Text send reliability can be affected by mouse-hover focus tools. Avoid moving the mouse across game windows while text send is running.

## Daily Use

1. Start the game clients.
2. Arrange windows.
3. Open ClickReducer.
4. If setup appears, follow it.
5. Select the correct profile.
6. Assign windows with `Auto Left-to-Right` if needed.
7. Click `Start` if it is not already listening.
8. Play from Box 1.

## Settings Location

Settings are saved here:

```text
%APPDATA%\ClickReducer\settings.json
```

To reset ClickReducer, close the app and rename or delete that file.
