# evaera/cmdr architecture

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

- Interactive diagram: https://gitdiagram.com/evaera/cmdr
- Repository: https://github.com/evaera/cmdr

## Overview

Cmdr is a Roblox command framework: users enter or trigger commands, which are validated and dispatched for execution, with results integrated into the experience. The map preserves documented capabilities including autocomplete, custom types and commands, bindings, composition, programmatic execution, and built-ins. The supplied excerpts do not include runtime Luau source, so runtime relationships below are based on README statements; internal call ownership and finer execution details cannot be verified here.

Main entry points: [`Cmdr/CmdrClient/Shared/Dispatcher.luau`](https://github.com/evaera/cmdr/blob/master/Cmdr/CmdrClient/Shared/Dispatcher.luau) (Client dispatcher), [`Cmdr/BuiltInCommands`](https://github.com/evaera/cmdr/tree/master/Cmdr/BuiltInCommands) (Server commands), [`Cmdr/CmdrClient/Shared/Argument.luau`](https://github.com/evaera/cmdr/blob/master/Cmdr/CmdrClient/Shared/Argument.luau) (Argument validation), [`Cmdr/CmdrClient/CmdrInterface`](https://github.com/evaera/cmdr/tree/master/Cmdr/CmdrClient/CmdrInterface) (Command interface)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Client experience"]
  node_console["Command interface"]
  node_autocomplete["Autocomplete<br/>[AutoComplete.luau]"]
  node_bindings["Input bindings<br/>[bind.luau]"]
  node_client_dispatch["Client dispatcher<br/>[Dispatcher.luau]"]
end

subgraph group_shared["Command framework"]
  node_registry["Command registry<br/>[Registry.luau]"]
  node_argument["Argument validation<br/>[Argument.luau]"]
  node_types["Built-in types"]
  node_guards["Input guards"]
end

subgraph group_server["Server execution"]
  node_server["Server authority<br/>[init.luau]"]
  node_server_commands["Server commands"]
end

subgraph group_extensions["Commands and extensions"]
  node_admin["Admin commands"]
  node_utility["Utility commands"]
  node_debug["Debug commands"]
  node_custom["Game integrations"]
end

node_user(("Player or developer"))
node_game_systems["Game systems"]

node_user -->|"enters commands"| node_console
node_console -->|"suggests inputs"| node_autocomplete
node_console -.->|"requests execution"| node_client_dispatch
node_bindings -->|"triggers commands"| node_client_dispatch
node_client_dispatch -->|"validates input"| node_argument
node_argument -->|"checks types"| node_types
node_argument -->|"applies validators"| node_guards
node_client_dispatch -.->|"submits for execution"| node_server
node_server -->|"validates independently"| node_argument
node_server -.->|"dispatches commands"| node_server_commands
node_server_commands -->|"includes"| node_admin
node_server_commands -->|"includes"| node_utility
node_server_commands -->|"includes"| node_debug
node_user -->|"invokes commands"| node_custom
node_custom -->|"integrates with"| node_game_systems
node_utility -->|"composes commands"| node_client_dispatch
node_registry -.->|"provides suggestions"| node_autocomplete
node_user -->|"runs commands programmatically"| node_client_dispatch

click node_console "https://github.com/evaera/cmdr/tree/master/Cmdr/CmdrClient/CmdrInterface"
click node_autocomplete "https://github.com/evaera/cmdr/blob/master/Cmdr/CmdrClient/CmdrInterface/AutoComplete.luau"
click node_bindings "https://github.com/evaera/cmdr/blob/master/Cmdr/BuiltInCommands/Utility/bind.luau"
click node_client_dispatch "https://github.com/evaera/cmdr/blob/master/Cmdr/CmdrClient/Shared/Dispatcher.luau"
click node_registry "https://github.com/evaera/cmdr/blob/master/Cmdr/CmdrClient/Shared/Registry.luau"
click node_argument "https://github.com/evaera/cmdr/blob/master/Cmdr/CmdrClient/Shared/Argument.luau"
click node_types "https://github.com/evaera/cmdr/tree/master/Cmdr/BuiltInTypes"
click node_guards "https://github.com/evaera/cmdr/tree/master/Cmdr/CmdrClient/Shared/BuiltInGuards"
click node_server "https://github.com/evaera/cmdr/blob/master/Cmdr/init.luau"
click node_server_commands "https://github.com/evaera/cmdr/tree/master/Cmdr/BuiltInCommands"
click node_admin "https://github.com/evaera/cmdr/tree/master/Cmdr/BuiltInCommands/Admin"
click node_utility "https://github.com/evaera/cmdr/tree/master/Cmdr/BuiltInCommands/Utility"
click node_debug "https://github.com/evaera/cmdr/tree/master/Cmdr/BuiltInCommands/Debug"
click node_custom "https://github.com/evaera/cmdr/tree/master/Cmdr/BuiltInCommands"

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_console,node_autocomplete,node_bindings,node_client_dispatch toneBlue
class node_registry,node_argument,node_types,node_guards toneAmber
class node_server,node_server_commands toneMint
class node_admin,node_utility,node_debug,node_custom toneRose
class node_user,node_game_systems toneIndigo
```

## Components

### Client experience

- [Command interface](https://github.com/evaera/cmdr/tree/master/Cmdr/CmdrClient/CmdrInterface): `Cmdr/CmdrClient/CmdrInterface`
- [Autocomplete](https://github.com/evaera/cmdr/blob/master/Cmdr/CmdrClient/CmdrInterface/AutoComplete.luau): `Cmdr/CmdrClient/CmdrInterface/AutoComplete.luau`
- [Input bindings](https://github.com/evaera/cmdr/blob/master/Cmdr/BuiltInCommands/Utility/bind.luau): `Cmdr/BuiltInCommands/Utility/bind.luau`
- [Client dispatcher](https://github.com/evaera/cmdr/blob/master/Cmdr/CmdrClient/Shared/Dispatcher.luau): `Cmdr/CmdrClient/Shared/Dispatcher.luau`

### Command framework

- [Command registry](https://github.com/evaera/cmdr/blob/master/Cmdr/CmdrClient/Shared/Registry.luau): `Cmdr/CmdrClient/Shared/Registry.luau`
- [Argument validation](https://github.com/evaera/cmdr/blob/master/Cmdr/CmdrClient/Shared/Argument.luau): `Cmdr/CmdrClient/Shared/Argument.luau`
- [Built-in types](https://github.com/evaera/cmdr/tree/master/Cmdr/BuiltInTypes): `Cmdr/BuiltInTypes`
- [Input guards](https://github.com/evaera/cmdr/tree/master/Cmdr/CmdrClient/Shared/BuiltInGuards): `Cmdr/CmdrClient/Shared/BuiltInGuards`

### Server execution

- [Server authority](https://github.com/evaera/cmdr/blob/master/Cmdr/init.luau): `Cmdr/init.luau`
- [Server commands](https://github.com/evaera/cmdr/tree/master/Cmdr/BuiltInCommands): `Cmdr/BuiltInCommands`

### Commands and extensions

- [Admin commands](https://github.com/evaera/cmdr/tree/master/Cmdr/BuiltInCommands/Admin): `Cmdr/BuiltInCommands/Admin`
- [Utility commands](https://github.com/evaera/cmdr/tree/master/Cmdr/BuiltInCommands/Utility): `Cmdr/BuiltInCommands/Utility`
- [Debug commands](https://github.com/evaera/cmdr/tree/master/Cmdr/BuiltInCommands/Debug): `Cmdr/BuiltInCommands/Debug`
- [Game integrations](https://github.com/evaera/cmdr/tree/master/Cmdr/BuiltInCommands): `Cmdr/BuiltInCommands`

### Other components

- **Player or developer**
- **Game systems**

## Connections

- Player or developer → Command interface: enters commands (evidence: `README.md`)
- Command interface → Autocomplete: suggests inputs (evidence: `README.md`)
- Command interface → Client dispatcher: requests execution
- Input bindings → Client dispatcher: triggers commands (evidence: `README.md`)
- Client dispatcher → Argument validation: validates input (evidence: `README.md`)
- Argument validation → Built-in types: checks types (evidence: `README.md`)
- Argument validation → Input guards: applies validators (evidence: `README.md`)
- Client dispatcher → Server authority: submits for execution
- Server authority → Argument validation: validates independently (evidence: `README.md`)
- Server authority → Server commands: dispatches commands
- Server commands → Admin commands: includes (evidence: `README.md`)
- Server commands → Utility commands: includes (evidence: `README.md`)
- Server commands → Debug commands: includes (evidence: `README.md`)
- Player or developer → Game integrations: invokes commands (evidence: `README.md`)
- Game integrations → Game systems: integrates with (evidence: `README.md`)
- Utility commands → Client dispatcher: composes commands (evidence: `README.md`)
- Command registry → Autocomplete: provides suggestions
- Player or developer → Client dispatcher: runs commands programmatically (evidence: `README.md`)
