# ClickReducer

ClickReducer is a Windows accessibility helper for reducing repetitive multibox key presses. It listens for configured hotkeys only from your assigned main window, maps those hotkeys to per-box outputs, briefly sends normal Windows input to the target windows, and returns you to the main window.

Use ClickReducer only where your server rules allow input broadcasting. ClickReducer is not affiliated with any game studio, publisher, server operator, or third-party multiboxing tool.

## Download

For normal users, do this:

1. Open the ClickReducer download page.
2. Download `ClickReducer-v0.9.0-win-x64.zip`.
3. Extract the zip.
4. Double-click `ClickReducer.exe`.
5. Follow the setup screen.

Do not use the source code unless you are a developer.

![ClickReducer main window](docs/assets/screenshots/main-window.png)

## What It Does

- Assigns detected game windows as Box 1 through Box 6.
- Accepts broadcast triggers only from assigned Box 1.
- Supports profiles for different groups, raids, or character sets.
- Lets each trigger send one default output or per-box custom outputs.
- Lets rules be enabled or disabled without deleting them.
- Provides named boxes, such as Tank, Healer, Crowd Control, or DPS.
- Provides a draggable overlay that shows off, paused, active, or broadcasting state.
- Includes group text helpers for sending a message or command to all or one assigned box.
- Stores settings locally under `%APPDATA%\ClickReducer\settings.json`.

## What It Does Not Do

- Does not inject into the game client.
- Does not read or write game memory.
- Does not automate game decisions.
- Does not include scripts, rotations, pathing, targeting logic, or combat logic.
- Does not send telemetry or use a network connection.
- Does not currently support arbitrary games or arbitrary process names.

## First Setup

The first time ClickReducer opens, it walks you through setup:

1. Open your game windows separately, then arrange the application icons from left to right on your start bar with the main character first. Each character needs its own normal taskbar window.

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

2. Choose how many boxes this profile uses.
3. Click `Assign Left-to-Right`.
4. Optionally create a starter rule: pressing `E` on your main sends `1` to the other boxes.
5. Click `Finish`.

If you need one desktop icon per account, see [Creating Separate Game Shortcuts](docs/USER_GUIDE.md#creating-separate-game-shortcuts).

After setup, play from Box 1. Broadcast hotkeys only work while Box 1 is focused.

## Example Rule

To press `E` on your main and have Boxes 2 through 6 press `1`:

1. Capture `E` in `When`.
2. Type or capture `1` in `Default`.
3. Turn on Boxes 2 through 6 in `Output Map`.
4. Leave Box 1 off unless you also want the main window to receive the mapped output.
5. Click `Add Rule` or `Update`.

For per-box outputs, keep the default output for most boxes and override individual rows. For example, `Shift+E` can send `Shift+2` to Box 2, `8` to Box 3, and `7` to Boxes 4 through 6.

## Screenshots

### Output Map

![Output Map](docs/assets/screenshots/output-map.png)

### Application Window Assignment

![Application Window Assignment](docs/assets/screenshots/application-windows.png)

## Documentation

- [User Guide](docs/USER_GUIDE.md)
- [Troubleshooting](docs/TROUBLESHOOTING.md)
- [FAQ](docs/FAQ.md)
- [Privacy and Safety](docs/PRIVACY_AND_SAFETY.md)
- [Changelog](CHANGELOG.md)

## Repository Layout

Normal users can ignore the repository files and download the release zip from the ClickReducer website.

- `src/ClickReducer` contains the Windows application source code.
- `site` contains the public static website.
- `docs` contains user guides and screenshots.
- `scripts` contains release packaging tools.
- `.github` contains GitHub issue templates and build automation.

## Requirements

- Windows 10 or Windows 11, 64-bit.
- Game client windows using the supported window format for this release.
- Matching privilege level: if the game runs as Administrator, ClickReducer must also run as Administrator.
