# skyblock-nerds/nerdbot architecture

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

- Interactive diagram: https://gitdiagram.com/skyblock-nerds/nerdbot
- Repository: https://github.com/skyblock-nerds/nerdbot

## Overview

Nerd Bot is a Discord bot for the SkyBlock Nerds server. Users interact through Discord commands and events; scheduled features and listeners also perform moderation, curation, tracking, and integrations. A documented end-to-end workflow is Google Drive access sync: a member links an email, role mappings determine folder permissions, and role events or reconciliation keep grants current. The graph preserves other README capabilities. Some implementations were not sampled, so those links are documented or marked unverified rather than inferred from module names.

Main entry points: [`app/src/main/java/net/hypixel/nerdbot/app/drive/DrivePermissionService.java`](https://github.com/skyblock-nerds/nerdbot/blob/master/app/src/main/java/net/hypixel/nerdbot/app/drive/DrivePermissionService.java) (Drive permission sync), [`app/src/main/java/net/hypixel/nerdbot/app/command`](https://github.com/skyblock-nerds/nerdbot/tree/master/app/src/main/java/net/hypixel/nerdbot/app/command) (Slash commands), [`app/src/main/java/net/hypixel/nerdbot/app/Main.java`](https://github.com/skyblock-nerds/nerdbot/blob/master/app/src/main/java/net/hypixel/nerdbot/app/Main.java) (Bot startup), [`app/src/main/java/net/hypixel/nerdbot/app/generation/pack/update/PackUpdater.java`](https://github.com/skyblock-nerds/nerdbot/blob/master/app/src/main/java/net/hypixel/nerdbot/app/generation/pack/update/PackUpdater.java) (Pack updates)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Bot Runtime"]
  node_startup["Bot startup<br/>[Main.java]"]
  node_bot["Bot orchestration"]
  node_framework["Discord framework"]
  node_commands["Slash commands"]
end

subgraph group_community["Community Features"]
  node_activity["Activity tracking"]
  node_reminders["Reminders"]
  node_curation["Suggestion curation<br/>[CurateFeature.java]"]
  node_moderation["Moderation logs"]
  node_metrics["Prometheus metrics"]
end

subgraph group_generation["Content Generation"]
  node_generation["Image generation"]
  node_packupdates["Pack updates<br/>[PackUpdater.java]"]
end

subgraph group_integrations["External Integrations"]
  node_driveworkflow["Drive link workflow"]
  node_drivesync["Drive permission sync"]
  node_drivesweep["Drive reconcile sweep"]
end

node_member(("Discord member"))
node_discord(("Discord"))
node_drive(("Google Drive"))
node_hypixel(("Hypixel services"))
node_activitydata[("Activity database")]

node_startup -->|"starts"| node_bot
node_startup -->|"creates"| node_framework
node_member -.->|"invokes"| node_commands
node_commands -.->|"replies through"| node_discord
node_discord -.->|"sends events"| node_activity
node_activity -->|"saves activity"| node_activitydata
node_commands -.->|"sets reminders"| node_reminders
node_reminders -->|"sends DMs"| node_discord
node_discord -.->|"provides suggestions"| node_curation
node_curation -->|"tags suggestions"| node_discord
node_discord -.->|"sends events"| node_moderation
node_moderation -->|"logs events"| node_discord
node_discord -.->|"provides metrics"| node_metrics
node_member -.->|"requests images"| node_generation
node_generation -->|"returns images"| node_member
node_packupdates -.->|"polls updates"| node_hypixel
node_packupdates -.->|"announces updates"| node_discord
node_member -->|"links account"| node_driveworkflow
node_driveworkflow -.->|"requests access sync"| node_drivesync
node_discord -->|"role events trigger"| node_drivesync
node_drivesweep -->|"reconciles grants"| node_drivesync
node_drivesync -->|"grants and revokes"| node_drive

click node_startup "https://github.com/skyblock-nerds/nerdbot/blob/master/app/src/main/java/net/hypixel/nerdbot/app/Main.java"
click node_bot "https://github.com/skyblock-nerds/nerdbot/blob/master/app/src/main/java/net/hypixel/nerdbot/app/SkyBlockNerdsBot.java"
click node_framework "https://github.com/skyblock-nerds/nerdbot/blob/master/discord-framework/src/main/java/net/hypixel/nerdbot/discord/AbstractDiscordBot.java"
click node_commands "https://github.com/skyblock-nerds/nerdbot/tree/master/app/src/main/java/net/hypixel/nerdbot/app/command"
click node_activity "https://github.com/skyblock-nerds/nerdbot/blob/master/app/src/main/java/net/hypixel/nerdbot/app/activity/ActivityListener.java"
click node_reminders "https://github.com/skyblock-nerds/nerdbot/blob/master/app/src/main/java/net/hypixel/nerdbot/app/reminder/ReminderDispatcher.java"
click node_curation "https://github.com/skyblock-nerds/nerdbot/blob/master/app/src/main/java/net/hypixel/nerdbot/app/feature/CurateFeature.java"
click node_moderation "https://github.com/skyblock-nerds/nerdbot/blob/master/app/src/main/java/net/hypixel/nerdbot/app/listener/ModLogListener.java"
click node_metrics "https://github.com/skyblock-nerds/nerdbot/blob/master/app/src/main/java/net/hypixel/nerdbot/app/metrics/PrometheusMetrics.java"
click node_generation "https://github.com/skyblock-nerds/nerdbot/tree/master/app/src/main/java/net/hypixel/nerdbot/app/generation"
click node_packupdates "https://github.com/skyblock-nerds/nerdbot/blob/master/app/src/main/java/net/hypixel/nerdbot/app/generation/pack/update/PackUpdater.java"
click node_driveworkflow "https://github.com/skyblock-nerds/nerdbot/blob/master/app/src/main/java/net/hypixel/nerdbot/app/drive/DriveLinkWorkflow.java"
click node_drivesync "https://github.com/skyblock-nerds/nerdbot/blob/master/app/src/main/java/net/hypixel/nerdbot/app/drive/DrivePermissionService.java"
click node_drivesweep "https://github.com/skyblock-nerds/nerdbot/blob/master/app/src/main/java/net/hypixel/nerdbot/app/drive/DriveSyncSweep.java"

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_startup,node_bot,node_framework,node_commands toneBlue
class node_activity,node_reminders,node_curation,node_moderation,node_metrics,node_activitydata toneAmber
class node_generation,node_packupdates toneMint
class node_driveworkflow,node_drivesync,node_drivesweep toneRose
class node_member,node_discord,node_drive,node_hypixel toneIndigo
```

## Components

### Bot Runtime

- [Bot startup](https://github.com/skyblock-nerds/nerdbot/blob/master/app/src/main/java/net/hypixel/nerdbot/app/Main.java): `app/src/main/java/net/hypixel/nerdbot/app/Main.java`
- [Bot orchestration](https://github.com/skyblock-nerds/nerdbot/blob/master/app/src/main/java/net/hypixel/nerdbot/app/SkyBlockNerdsBot.java): `app/src/main/java/net/hypixel/nerdbot/app/SkyBlockNerdsBot.java`
- [Discord framework](https://github.com/skyblock-nerds/nerdbot/blob/master/discord-framework/src/main/java/net/hypixel/nerdbot/discord/AbstractDiscordBot.java): `discord-framework/src/main/java/net/hypixel/nerdbot/discord/AbstractDiscordBot.java`
- [Slash commands](https://github.com/skyblock-nerds/nerdbot/tree/master/app/src/main/java/net/hypixel/nerdbot/app/command): `app/src/main/java/net/hypixel/nerdbot/app/command`

### Community Features

- [Activity tracking](https://github.com/skyblock-nerds/nerdbot/blob/master/app/src/main/java/net/hypixel/nerdbot/app/activity/ActivityListener.java): `app/src/main/java/net/hypixel/nerdbot/app/activity/ActivityListener.java`
- [Reminders](https://github.com/skyblock-nerds/nerdbot/blob/master/app/src/main/java/net/hypixel/nerdbot/app/reminder/ReminderDispatcher.java): `app/src/main/java/net/hypixel/nerdbot/app/reminder/ReminderDispatcher.java`
- [Suggestion curation](https://github.com/skyblock-nerds/nerdbot/blob/master/app/src/main/java/net/hypixel/nerdbot/app/feature/CurateFeature.java): `app/src/main/java/net/hypixel/nerdbot/app/feature/CurateFeature.java`
- [Moderation logs](https://github.com/skyblock-nerds/nerdbot/blob/master/app/src/main/java/net/hypixel/nerdbot/app/listener/ModLogListener.java): `app/src/main/java/net/hypixel/nerdbot/app/listener/ModLogListener.java`
- [Prometheus metrics](https://github.com/skyblock-nerds/nerdbot/blob/master/app/src/main/java/net/hypixel/nerdbot/app/metrics/PrometheusMetrics.java): `app/src/main/java/net/hypixel/nerdbot/app/metrics/PrometheusMetrics.java`

### Content Generation

- [Image generation](https://github.com/skyblock-nerds/nerdbot/tree/master/app/src/main/java/net/hypixel/nerdbot/app/generation): `app/src/main/java/net/hypixel/nerdbot/app/generation`
- [Pack updates](https://github.com/skyblock-nerds/nerdbot/blob/master/app/src/main/java/net/hypixel/nerdbot/app/generation/pack/update/PackUpdater.java): `app/src/main/java/net/hypixel/nerdbot/app/generation/pack/update/PackUpdater.java`

### External Integrations

- [Drive link workflow](https://github.com/skyblock-nerds/nerdbot/blob/master/app/src/main/java/net/hypixel/nerdbot/app/drive/DriveLinkWorkflow.java): `app/src/main/java/net/hypixel/nerdbot/app/drive/DriveLinkWorkflow.java`
- [Drive permission sync](https://github.com/skyblock-nerds/nerdbot/blob/master/app/src/main/java/net/hypixel/nerdbot/app/drive/DrivePermissionService.java): `app/src/main/java/net/hypixel/nerdbot/app/drive/DrivePermissionService.java`
- [Drive reconcile sweep](https://github.com/skyblock-nerds/nerdbot/blob/master/app/src/main/java/net/hypixel/nerdbot/app/drive/DriveSyncSweep.java): `app/src/main/java/net/hypixel/nerdbot/app/drive/DriveSyncSweep.java`

### Other components

- **Discord member**
- **Discord**
- **Google Drive**
- **Hypixel services**
- **Activity database**

## Connections

- Bot startup → Bot orchestration: starts (evidence: `app/src/main/java/net/hypixel/nerdbot/app/Main.java`)
- Bot startup → Discord framework: creates (evidence: `app/src/main/java/net/hypixel/nerdbot/app/Main.java`)
- Discord member → Slash commands: invokes
- Slash commands → Discord: replies through
- Discord → Activity tracking: sends events (evidence: `README.md`)
- Activity tracking → Activity database: saves activity (evidence: `README.md`)
- Slash commands → Reminders: sets reminders (evidence: `README.md`)
- Reminders → Discord: sends DMs (evidence: `README.md`)
- Discord → Suggestion curation: provides suggestions (evidence: `README.md`)
- Suggestion curation → Discord: tags suggestions (evidence: `README.md`)
- Discord → Moderation logs: sends events (evidence: `README.md`)
- Moderation logs → Discord: logs events (evidence: `README.md`)
- Discord → Prometheus metrics: provides metrics (evidence: `README.md`)
- Discord member → Image generation: requests images (evidence: `README.md`)
- Image generation → Discord member: returns images (evidence: `README.md`)
- Pack updates → Hypixel services: polls updates (evidence: `README.md`)
- Pack updates → Discord: announces updates (evidence: `README.md`)
- Discord member → Drive link workflow: links account (evidence: `README.md`)
- Drive link workflow → Drive permission sync: requests access sync
- Discord → Drive permission sync: role events trigger (evidence: `README.md`)
- Drive reconcile sweep → Drive permission sync: reconciles grants (evidence: `README.md`)
- Drive permission sync → Google Drive: grants and revokes (evidence: `README.md`)
