# tacman1981/rust-plugins architecture

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

- Interactive diagram: https://gitdiagram.com/tacman1981/rust-plugins
- Repository: https://github.com/tacman1981/rust-plugins

## Overview

This repository is a collection of independent Oxide/Rust server plugins, not one application. The user-facing workflows range from team commands and item grants to crate relocation and server-event-driven world changes. Groups below reflect plugin domains; each plugin is shown as its own runtime component. Source excerpts are partial, so links between plugins or unsampled implementations are omitted unless the index or excerpts support them.

Main entry points: [`TeamHandler.cs`](https://github.com/tacman1981/rust-plugins/blob/main/TeamHandler.cs) (Team Handler), [`CommandToInvite.cs`](https://github.com/tacman1981/rust-plugins/blob/main/CommandToInvite.cs) (Invite Commands), [`TransformCrates.cs`](https://github.com/tacman1981/rust-plugins/blob/main/TransformCrates.cs) (Crate Relocation), [`TransformHeliCrates.cs`](https://github.com/tacman1981/rust-plugins/blob/main/TransformHeliCrates.cs) (Heli Crate Relocation)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_teams["Team management"]
  node_team_handler["Team Handler<br/>[TeamHandler.cs]"]
  node_team_invites["Invite Commands<br/>[CommandToInvite.cs]"]
end

subgraph group_crates["Crate behavior"]
  node_transform_crates["Crate Relocation<br/>[TransformCrates.cs]"]
  node_transform_heli["Heli Crate Relocation"]
  node_buoyant_crates["Buoyant Crates<br/>[BuoyantCrates.cs]"]
  node_bradley_move["Bradley Crate Move"]
end

subgraph group_automation["Game automation"]
  node_hopper_range["Hopper Range<br/>[HopperRange.cs]"]
  node_simple_hopper["Hopper Controller"]
  node_furnace["Furnace Control"]
  node_compost["Compost Stacks<br/>[CompostStacks.cs]"]
  node_conveyor["Conveyor Control"]
  node_gather_blackberry["Blackberry Gathering"]
  node_gather_blueberry["Blueberry Gathering"]
end

subgraph group_world["World changes"]
  node_mini_light["Minicopter Light<br/>[MiniLight.cs]"]
end

subgraph group_admin["Server administration"]
  node_item_giver["Sleeper Item Giver<br/>[BetterItemGiver.cs]"]
  node_purge["Purge Control<br/>[Purge.cs]"]
  node_connect_logger["Connection Logger<br/>[ConnectLogger.cs]"]
  node_cpu_info["CPU Info<br/>[CPUInfo.cs]"]
end

node_actor_player(("Player"))
node_actor_admin(("Server admin"))
node_actor_server(("Rust server events"))

node_actor_player -->|"uses commands"| node_team_handler
node_actor_player -->|"invites players"| node_team_invites
node_actor_admin -->|"grants items"| node_item_giver
node_actor_player -->|"moves crates"| node_transform_crates
node_actor_player -->|"moves crates"| node_transform_heli
node_actor_server -->|"updates hoppers"| node_hopper_range
node_actor_server -->|"spawns minicopters"| node_mini_light
node_actor_server -->|"handles oven events"| node_furnace
node_actor_server -->|"updates composters"| node_compost
node_actor_admin -->|"starts purge"| node_purge

click node_team_handler "https://github.com/tacman1981/rust-plugins/blob/main/TeamHandler.cs"
click node_team_invites "https://github.com/tacman1981/rust-plugins/blob/main/CommandToInvite.cs"
click node_transform_crates "https://github.com/tacman1981/rust-plugins/blob/main/TransformCrates.cs"
click node_transform_heli "https://github.com/tacman1981/rust-plugins/blob/main/TransformHeliCrates.cs"
click node_buoyant_crates "https://github.com/tacman1981/rust-plugins/blob/main/BuoyantCrates.cs"
click node_bradley_move "https://github.com/tacman1981/rust-plugins/blob/main/BradleyCrateMove.cs"
click node_hopper_range "https://github.com/tacman1981/rust-plugins/blob/main/HopperRange.cs"
click node_simple_hopper "https://github.com/tacman1981/rust-plugins/blob/main/SimpleHopperController.cs"
click node_furnace "https://github.com/tacman1981/rust-plugins/blob/main/FurnaceNoOreStop.cs"
click node_compost "https://github.com/tacman1981/rust-plugins/blob/main/CompostStacks.cs"
click node_conveyor "https://github.com/tacman1981/rust-plugins/blob/main/DisableIndustrialConveyor.cs"
click node_gather_blackberry "https://github.com/tacman1981/rust-plugins/blob/main/CustomBlackBerryGather.cs"
click node_gather_blueberry "https://github.com/tacman1981/rust-plugins/blob/main/CustomBlueBerryGather.cs"
click node_mini_light "https://github.com/tacman1981/rust-plugins/blob/main/MiniLight.cs"
click node_item_giver "https://github.com/tacman1981/rust-plugins/blob/main/BetterItemGiver.cs"
click node_purge "https://github.com/tacman1981/rust-plugins/blob/main/Purge.cs"
click node_connect_logger "https://github.com/tacman1981/rust-plugins/blob/main/ConnectLogger.cs"
click node_cpu_info "https://github.com/tacman1981/rust-plugins/blob/main/CPUInfo.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_team_handler,node_team_invites toneBlue
class node_transform_crates,node_transform_heli,node_buoyant_crates,node_bradley_move toneAmber
class node_hopper_range,node_simple_hopper,node_furnace,node_compost,node_conveyor,node_gather_blackberry,node_gather_blueberry,node_actor_admin,node_actor_server toneMint
class node_mini_light toneRose
class node_item_giver,node_purge,node_connect_logger,node_cpu_info,node_actor_player toneIndigo
```

## Components

### Team management

- [Team Handler](https://github.com/tacman1981/rust-plugins/blob/main/TeamHandler.cs): `TeamHandler.cs`
- [Invite Commands](https://github.com/tacman1981/rust-plugins/blob/main/CommandToInvite.cs): `CommandToInvite.cs`

### Crate behavior

- [Crate Relocation](https://github.com/tacman1981/rust-plugins/blob/main/TransformCrates.cs): `TransformCrates.cs`
- [Heli Crate Relocation](https://github.com/tacman1981/rust-plugins/blob/main/TransformHeliCrates.cs): `TransformHeliCrates.cs`
- [Buoyant Crates](https://github.com/tacman1981/rust-plugins/blob/main/BuoyantCrates.cs): `BuoyantCrates.cs`
- [Bradley Crate Move](https://github.com/tacman1981/rust-plugins/blob/main/BradleyCrateMove.cs): `BradleyCrateMove.cs`

### Game automation

- [Hopper Range](https://github.com/tacman1981/rust-plugins/blob/main/HopperRange.cs): `HopperRange.cs`
- [Hopper Controller](https://github.com/tacman1981/rust-plugins/blob/main/SimpleHopperController.cs): `SimpleHopperController.cs`
- [Furnace Control](https://github.com/tacman1981/rust-plugins/blob/main/FurnaceNoOreStop.cs): `FurnaceNoOreStop.cs`
- [Compost Stacks](https://github.com/tacman1981/rust-plugins/blob/main/CompostStacks.cs): `CompostStacks.cs`
- [Conveyor Control](https://github.com/tacman1981/rust-plugins/blob/main/DisableIndustrialConveyor.cs): `DisableIndustrialConveyor.cs`
- [Blackberry Gathering](https://github.com/tacman1981/rust-plugins/blob/main/CustomBlackBerryGather.cs): `CustomBlackBerryGather.cs`
- [Blueberry Gathering](https://github.com/tacman1981/rust-plugins/blob/main/CustomBlueBerryGather.cs): `CustomBlueBerryGather.cs`

### World changes

- [Minicopter Light](https://github.com/tacman1981/rust-plugins/blob/main/MiniLight.cs): `MiniLight.cs`

### Server administration

- [Sleeper Item Giver](https://github.com/tacman1981/rust-plugins/blob/main/BetterItemGiver.cs): `BetterItemGiver.cs`
- [Purge Control](https://github.com/tacman1981/rust-plugins/blob/main/Purge.cs): `Purge.cs`
- [Connection Logger](https://github.com/tacman1981/rust-plugins/blob/main/ConnectLogger.cs): `ConnectLogger.cs`
- [CPU Info](https://github.com/tacman1981/rust-plugins/blob/main/CPUInfo.cs): `CPUInfo.cs`

### Other components

- **Player**
- **Server admin**
- **Rust server events**

## Connections

- Player → Team Handler: uses commands (evidence: `TeamHandler.cs`)
- Player → Invite Commands: invites players (evidence: `CommandToInvite.cs`)
- Server admin → Sleeper Item Giver: grants items (evidence: `BetterItemGiver.cs`)
- Player → Crate Relocation: moves crates (evidence: `TransformCrates.cs`)
- Player → Heli Crate Relocation: moves crates (evidence: `TransformHeliCrates.cs`)
- Rust server events → Hopper Range: updates hoppers (evidence: `HopperRange.cs`)
- Rust server events → Minicopter Light: spawns minicopters (evidence: `MiniLight.cs`)
- Rust server events → Furnace Control: handles oven events (evidence: `FurnaceNoOreStop.cs`)
- Rust server events → Compost Stacks: updates composters (evidence: `CompostStacks.cs`)
- Server admin → Purge Control: starts purge (evidence: `Purge.cs`)
