# annasajkh/bettercommand architecture

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

- Interactive diagram: https://gitdiagram.com/annasajkh/bettercommand
- Repository: https://github.com/annasajkh/bettercommand

## Overview

BetterCommand is a Risk of Rain 2 mod that protects a player and their minions while the Artifact of Command picker is open. The flow starts at the picker’s display lifecycle: the plugin applies the effect directly when running on the server, or sends an add/remove message to the server otherwise. Server-side handling applies or removes buffs and adjusts minion aim behavior. The source excerpts show these runtime paths; the README documents the gameplay effects.

Main entry points: [`BetterCommand/Source/Utils/Helper.cs`](https://github.com/annasajkh/bettercommand/blob/main/BetterCommand/Source/Utils/Helper.cs) (Effect handler), [`BetterCommand/Source/BetterCommand.cs`](https://github.com/annasajkh/bettercommand/blob/main/BetterCommand/Source/BetterCommand.cs) (Lifecycle hooks), [`BetterCommand/Source/NetworkMessages/PickupPickerMessage.cs`](https://github.com/annasajkh/bettercommand/blob/main/BetterCommand/Source/NetworkMessages/PickupPickerMessage.cs) (Picker message), [`BetterCommand/Source/Utils/Log.cs`](https://github.com/annasajkh/bettercommand/blob/main/BetterCommand/Source/Utils/Log.cs) (Logging)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Picker integration"]
  node_picker["Command picker"]
  node_plugin["Lifecycle hooks<br/>[BetterCommand.cs]"]
end

subgraph group_network["Server messaging"]
  node_message["Picker message"]
  node_server{{"Network server"}}
end

subgraph group_effects["Gameplay effects"]
  node_effects["Effect handler<br/>[Helper.cs]"]
  node_player_state["Player buffs<br/>[Helper.cs]"]
  node_minions["Minion buffs and AI<br/>[Helper.cs]"]
  node_logger["Logging<br/>[Log.cs]"]
end

node_player(("Player"))

node_player -->|"opens or closes"| node_picker
node_picker -->|"triggers lifecycle hooks"| node_plugin
node_plugin -->|"applies on server"| node_effects
node_plugin -->|"sends add/remove"| node_message
node_message -->|"dispatches to"| node_server
node_server -->|"delivers message"| node_message
node_message -->|"invokes on receipt"| node_effects
node_effects -->|"adds or removes buffs"| node_player_state
node_effects -->|"updates buffs and aim"| node_minions
node_plugin -->|"initializes and logs"| node_logger
node_effects -->|"logs errors"| node_logger

click node_plugin "https://github.com/annasajkh/bettercommand/blob/main/BetterCommand/Source/BetterCommand.cs"
click node_message "https://github.com/annasajkh/bettercommand/blob/main/BetterCommand/Source/NetworkMessages/PickupPickerMessage.cs"
click node_effects "https://github.com/annasajkh/bettercommand/blob/main/BetterCommand/Source/Utils/Helper.cs"
click node_player_state "https://github.com/annasajkh/bettercommand/blob/main/BetterCommand/Source/Utils/Helper.cs"
click node_minions "https://github.com/annasajkh/bettercommand/blob/main/BetterCommand/Source/Utils/Helper.cs"
click node_logger "https://github.com/annasajkh/bettercommand/blob/main/BetterCommand/Source/Utils/Log.cs"

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_picker,node_plugin toneBlue
class node_message,node_server toneAmber
class node_effects,node_player_state,node_minions,node_logger toneMint
class node_player toneIndigo
```

## Components

### Picker integration

- **Command picker**
- [Lifecycle hooks](https://github.com/annasajkh/bettercommand/blob/main/BetterCommand/Source/BetterCommand.cs): `BetterCommand/Source/BetterCommand.cs`

### Server messaging

- [Picker message](https://github.com/annasajkh/bettercommand/blob/main/BetterCommand/Source/NetworkMessages/PickupPickerMessage.cs): `BetterCommand/Source/NetworkMessages/PickupPickerMessage.cs`
- **Network server**

### Gameplay effects

- [Effect handler](https://github.com/annasajkh/bettercommand/blob/main/BetterCommand/Source/Utils/Helper.cs): `BetterCommand/Source/Utils/Helper.cs`
- [Player buffs](https://github.com/annasajkh/bettercommand/blob/main/BetterCommand/Source/Utils/Helper.cs): `BetterCommand/Source/Utils/Helper.cs`
- [Minion buffs and AI](https://github.com/annasajkh/bettercommand/blob/main/BetterCommand/Source/Utils/Helper.cs): `BetterCommand/Source/Utils/Helper.cs`
- [Logging](https://github.com/annasajkh/bettercommand/blob/main/BetterCommand/Source/Utils/Log.cs): `BetterCommand/Source/Utils/Log.cs`

### Other components

- **Player**

## Connections

- Player → Command picker: opens or closes (evidence: `README.md`)
- Command picker → Lifecycle hooks: triggers lifecycle hooks (evidence: `BetterCommand/Source/BetterCommand.cs`)
- Lifecycle hooks → Effect handler: applies on server (evidence: `BetterCommand/Source/BetterCommand.cs`)
- Lifecycle hooks → Picker message: sends add/remove (evidence: `BetterCommand/Source/BetterCommand.cs`)
- Picker message → Network server: dispatches to
- Network server → Picker message: delivers message (evidence: `BetterCommand/Source/NetworkMessages/PickupPickerMessage.cs`)
- Picker message → Effect handler: invokes on receipt (evidence: `BetterCommand/Source/NetworkMessages/PickupPickerMessage.cs`)
- Effect handler → Player buffs: adds or removes buffs (evidence: `BetterCommand/Source/Utils/Helper.cs`)
- Effect handler → Minion buffs and AI: updates buffs and aim (evidence: `BetterCommand/Source/Utils/Helper.cs`)
- Lifecycle hooks → Logging: initializes and logs (evidence: `BetterCommand/Source/BetterCommand.cs`)
- Effect handler → Logging: logs errors (evidence: `BetterCommand/Source/Utils/Helper.cs`)
