# przemek031/rollercoinbot architecture

> Architecture diagram of the GitHub repository przemek031/rollercoinbot, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-30). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/przemek031/rollercoinbot
- Repository: https://github.com/przemek031/rollercoinbot

## Overview

RollerCoin AutoBot Master is a single-file desktop automation app. The user configures a game region and can run a selected mini-game or start an infinite autoplay cycle. Autoplay navigates the game grid, starts games, monitors results, and handles rewards or losses; game bots detect targets and issue game actions. All implementation nodes point to the sole source file. The README documents several capabilities whose internal implementation is only partially excerpted, so the graph shows documented links without inferring finer call structure.

Main entry points: [`RollerCoinAutoBotMaster.py`](https://github.com/przemek031/rollercoinbot/blob/main/RollerCoinAutoBotMaster.py) (Game Bots)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Desktop Controls"]
  node_gui["App GUI"]
end

subgraph group_play["Game Automation"]
  node_game_bots["Game Bots"]
  node_coin_click["CoinClick Logic"]
  node_coin_fisher["Coin Fisher Logic"]
  node_hamster["Hamster Logic"]
end

subgraph group_cycle["Autoplay Flow"]
  node_autoplay["Autoplay Controller"]
  node_menu_vision["Menu Detection"]
  node_result_handling["Result Handling"]
end

subgraph group_settings["Configuration"]
  node_settings_store["Settings Manager"]
end

node_user(("User"))
node_rollercoin["RollerCoin Game UI"]

node_user -->|"controls"| node_gui
node_gui -->|"loads and saves"| node_settings_store
node_gui -->|"starts game"| node_game_bots
node_gui -->|"starts autoplay"| node_autoplay
node_settings_store -->|"provides settings"| node_game_bots
node_game_bots -->|"dispatches"| node_coin_click
node_game_bots -->|"dispatches"| node_coin_fisher
node_game_bots -->|"dispatches"| node_hamster
node_autoplay -->|"starts game"| node_game_bots
node_autoplay -->|"detects menu"| node_menu_vision
node_autoplay -->|"handles results"| node_result_handling
node_menu_vision -->|"reads screen"| node_rollercoin
node_result_handling -->|"clicks controls"| node_rollercoin
node_game_bots -->|"plays games"| node_rollercoin
node_autoplay -->|"navigates menus"| node_rollercoin

click node_gui "https://github.com/przemek031/rollercoinbot/blob/main/RollerCoinAutoBotMaster.py"
click node_settings_store "https://github.com/przemek031/rollercoinbot/blob/main/RollerCoinAutoBotMaster.py"
click node_game_bots "https://github.com/przemek031/rollercoinbot/blob/main/RollerCoinAutoBotMaster.py"
click node_coin_click "https://github.com/przemek031/rollercoinbot/blob/main/RollerCoinAutoBotMaster.py"
click node_coin_fisher "https://github.com/przemek031/rollercoinbot/blob/main/RollerCoinAutoBotMaster.py"
click node_hamster "https://github.com/przemek031/rollercoinbot/blob/main/RollerCoinAutoBotMaster.py"
click node_autoplay "https://github.com/przemek031/rollercoinbot/blob/main/RollerCoinAutoBotMaster.py"
click node_menu_vision "https://github.com/przemek031/rollercoinbot/blob/main/RollerCoinAutoBotMaster.py"
click node_result_handling "https://github.com/przemek031/rollercoinbot/blob/main/RollerCoinAutoBotMaster.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_gui,node_user,node_rollercoin toneBlue
class node_game_bots,node_coin_click,node_coin_fisher,node_hamster toneAmber
class node_autoplay,node_menu_vision,node_result_handling toneMint
class node_settings_store toneRose
```

## Components

### Desktop Controls

- [App GUI](https://github.com/przemek031/rollercoinbot/blob/main/RollerCoinAutoBotMaster.py): `RollerCoinAutoBotMaster.py`

### Game Automation

- [Game Bots](https://github.com/przemek031/rollercoinbot/blob/main/RollerCoinAutoBotMaster.py): `RollerCoinAutoBotMaster.py`
- [CoinClick Logic](https://github.com/przemek031/rollercoinbot/blob/main/RollerCoinAutoBotMaster.py): `RollerCoinAutoBotMaster.py`
- [Coin Fisher Logic](https://github.com/przemek031/rollercoinbot/blob/main/RollerCoinAutoBotMaster.py): `RollerCoinAutoBotMaster.py`
- [Hamster Logic](https://github.com/przemek031/rollercoinbot/blob/main/RollerCoinAutoBotMaster.py): `RollerCoinAutoBotMaster.py`

### Autoplay Flow

- [Autoplay Controller](https://github.com/przemek031/rollercoinbot/blob/main/RollerCoinAutoBotMaster.py): `RollerCoinAutoBotMaster.py`
- [Menu Detection](https://github.com/przemek031/rollercoinbot/blob/main/RollerCoinAutoBotMaster.py): `RollerCoinAutoBotMaster.py`
- [Result Handling](https://github.com/przemek031/rollercoinbot/blob/main/RollerCoinAutoBotMaster.py): `RollerCoinAutoBotMaster.py`

### Configuration

- [Settings Manager](https://github.com/przemek031/rollercoinbot/blob/main/RollerCoinAutoBotMaster.py): `RollerCoinAutoBotMaster.py`

### Other components

- **User**
- **RollerCoin Game UI**

## Connections

- User → App GUI: controls (evidence: `README.md`)
- App GUI → Settings Manager: loads and saves (evidence: `RollerCoinAutoBotMaster.py`)
- App GUI → Game Bots: starts game (evidence: `RollerCoinAutoBotMaster.py`)
- App GUI → Autoplay Controller: starts autoplay (evidence: `RollerCoinAutoBotMaster.py`)
- Settings Manager → Game Bots: provides settings (evidence: `RollerCoinAutoBotMaster.py`)
- Game Bots → CoinClick Logic: dispatches (evidence: `RollerCoinAutoBotMaster.py`)
- Game Bots → Coin Fisher Logic: dispatches (evidence: `RollerCoinAutoBotMaster.py`)
- Game Bots → Hamster Logic: dispatches (evidence: `RollerCoinAutoBotMaster.py`)
- Autoplay Controller → Game Bots: starts game (evidence: `RollerCoinAutoBotMaster.py`)
- Autoplay Controller → Menu Detection: detects menu (evidence: `README.md`)
- Autoplay Controller → Result Handling: handles results (evidence: `README.md`)
- Menu Detection → RollerCoin Game UI: reads screen (evidence: `README.md`)
- Result Handling → RollerCoin Game UI: clicks controls (evidence: `README.md`)
- Game Bots → RollerCoin Game UI: plays games (evidence: `README.md`)
- Autoplay Controller → RollerCoin Game UI: navigates menus (evidence: `README.md`)