# funcfusion/antbot architecture

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

- Interactive diagram: https://gitdiagram.com/funcfusion/antbot
- Repository: https://github.com/funcfusion/antbot

## Overview

AntBot is a Discord community bot for Anthill, a Minecraft datapack/resource-pack server. Members use bot commands and interactive Discord messages to get help, discuss ideas, find creators, and use Minecraft-oriented tools; moderators also manage the community. `main.py` registers the cogs and persistent views that implement these capabilities. The graph highlights those product areas and shared utilities. Connections among unsampled cogs are limited to registration shown in `main.py`; implementation details for those cogs are not inferred.

Main entry points: [`main.py`](https://github.com/funcfusion/antbot/blob/main/main.py) (AntBot runtime), [`utils/pack_generator.py`](https://github.com/funcfusion/antbot/blob/main/utils/pack_generator.py) (Pack generator), [`cogs/fun/look_for.py`](https://github.com/funcfusion/antbot/blob/main/cogs/fun/look_for.py) (Creator search), [`cogs/general/gif.py`](https://github.com/funcfusion/antbot/blob/main/cogs/general/gif.py) (GIF conversion)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Bot runtime"]
  node_antbot["AntBot runtime<br/>[main.py]"]
  node_admin["Administration<br/>[change_status.py]"]
  node_mod["Moderation<br/>[punishments.py]"]
end

subgraph group_community["Community support"]
  node_help["Help and tickets<br/>[starter_message.py]"]
  node_faqs["FAQs<br/>[__init__.py]"]
  node_logs["Community logs<br/>[__init__.py]"]
  node_iven["IVEN requests<br/>[requests.py]"]
  node_voice["Voice channels<br/>[__init__.py]"]
end

subgraph group_engagement["Community features"]
  node_ideas["Ideas and voting<br/>[__init__.py]"]
  node_creator_search["Creator search<br/>[look_for.py]"]
  node_fun["Fun commands<br/>[enchants.py]"]
  node_memes["Meme tools<br/>[demotivator.py]"]
  node_general["Server utilities<br/>[remind.py]"]
  node_gif["GIF conversion<br/>[gif.py]"]
end

subgraph group_minecraft["Minecraft tools"]
  node_packformat["Pack formatting<br/>[packformat.py]"]
  node_minecraft_files["Minecraft files<br/>[file.py]"]
  node_snapshot["Snapshot scraper"]
  node_pack_generator["Pack generator<br/>[pack_generator.py]"]
  node_mcmeta["Pack metadata<br/>[packmcmeta.py]"]
end

subgraph group_shared["Shared utilities"]
  node_general_utils["Bot helpers<br/>[general.py]"]
  node_message_utils["Message helpers<br/>[msg_utils.py]"]
  node_validation["Input validation<br/>[validator.py]"]
  node_image_utils["Image processing<br/>[image_utils.py]"]
  node_user_db[("User database<br/>[users_db.py]")]
end

node_members(("Server members"))
node_moderators(("Moderators"))
node_discord["Discord platform"]

node_members -->|"use commands"| node_antbot
node_moderators -.->|"use commands"| node_antbot
node_antbot -->|"registers cog"| node_admin
node_antbot -->|"registers cog"| node_mod
node_antbot -->|"registers cog"| node_help
node_antbot -->|"registers cog"| node_faqs
node_antbot -->|"registers cog"| node_logs
node_antbot -->|"registers cog"| node_ideas
node_antbot -->|"registers cog"| node_creator_search
node_antbot -->|"registers cog"| node_fun
node_antbot -->|"registers cog"| node_memes
node_antbot -->|"registers cog"| node_general
node_antbot -->|"registers cog"| node_gif
node_antbot -->|"registers cog"| node_iven
node_antbot -->|"registers cog"| node_voice
node_antbot -->|"registers cog"| node_packformat
node_antbot -->|"registers cog"| node_minecraft_files
node_antbot -->|"registers cog"| node_snapshot
node_pack_generator -->|"validates with"| node_validation
node_pack_generator -->|"reads version"| node_mcmeta
node_pack_generator -->|"uses emojis"| node_message_utils
node_packformat -->|"uses metadata"| node_mcmeta
node_packformat -->|"uses helpers"| node_general_utils
node_creator_search -->|"validates input"| node_validation
node_creator_search -->|"uses helpers"| node_general_utils
node_help -->|"uses helpers"| node_general_utils
node_gif -->|"edits images"| node_image_utils
node_gif -->|"sends media"| node_discord
node_antbot -->|"starts updater"| node_mcmeta
node_antbot -->|"runs bot"| node_discord

click node_antbot "https://github.com/funcfusion/antbot/blob/main/main.py"
click node_admin "https://github.com/funcfusion/antbot/blob/main/cogs/admin/change_status.py"
click node_mod "https://github.com/funcfusion/antbot/blob/main/cogs/mod/punishments.py"
click node_help "https://github.com/funcfusion/antbot/blob/main/cogs/help/starter_message.py"
click node_faqs "https://github.com/funcfusion/antbot/blob/main/cogs/faqs/__init__.py"
click node_logs "https://github.com/funcfusion/antbot/blob/main/cogs/logs/__init__.py"
click node_ideas "https://github.com/funcfusion/antbot/blob/main/cogs/ideas/__init__.py"
click node_creator_search "https://github.com/funcfusion/antbot/blob/main/cogs/fun/look_for.py"
click node_fun "https://github.com/funcfusion/antbot/blob/main/cogs/fun/enchants.py"
click node_memes "https://github.com/funcfusion/antbot/blob/main/cogs/memes/demotivator.py"
click node_general "https://github.com/funcfusion/antbot/blob/main/cogs/general/remind.py"
click node_gif "https://github.com/funcfusion/antbot/blob/main/cogs/general/gif.py"
click node_iven "https://github.com/funcfusion/antbot/blob/main/cogs/iven/requests.py"
click node_voice "https://github.com/funcfusion/antbot/blob/main/cogs/voice_channels/__init__.py"
click node_packformat "https://github.com/funcfusion/antbot/blob/main/cogs/minecraft/packformat.py"
click node_minecraft_files "https://github.com/funcfusion/antbot/blob/main/cogs/minecraft/file.py"
click node_snapshot "https://github.com/funcfusion/antbot/blob/main/cogs/minecraft/snapshot_scraper.py"
click node_pack_generator "https://github.com/funcfusion/antbot/blob/main/utils/pack_generator.py"
click node_mcmeta "https://github.com/funcfusion/antbot/blob/main/utils/packmcmeta.py"
click node_general_utils "https://github.com/funcfusion/antbot/blob/main/utils/general.py"
click node_message_utils "https://github.com/funcfusion/antbot/blob/main/utils/msg_utils.py"
click node_validation "https://github.com/funcfusion/antbot/blob/main/utils/validator.py"
click node_image_utils "https://github.com/funcfusion/antbot/blob/main/utils/image_utils.py"
click node_user_db "https://github.com/funcfusion/antbot/blob/main/utils/users_db.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_antbot,node_admin,node_mod toneBlue
class node_help,node_faqs,node_logs,node_iven,node_voice toneAmber
class node_ideas,node_creator_search,node_fun,node_memes,node_general,node_gif,node_members toneMint
class node_packformat,node_minecraft_files,node_snapshot,node_pack_generator,node_mcmeta toneRose
class node_general_utils,node_message_utils,node_validation,node_image_utils,node_user_db,node_moderators,node_discord toneIndigo
```

## Components

### Bot runtime

- [AntBot runtime](https://github.com/funcfusion/antbot/blob/main/main.py): `main.py`
- [Administration](https://github.com/funcfusion/antbot/blob/main/cogs/admin/change_status.py): `cogs/admin/change_status.py`
- [Moderation](https://github.com/funcfusion/antbot/blob/main/cogs/mod/punishments.py): `cogs/mod/punishments.py`

### Community support

- [Help and tickets](https://github.com/funcfusion/antbot/blob/main/cogs/help/starter_message.py): `cogs/help/starter_message.py`
- [FAQs](https://github.com/funcfusion/antbot/blob/main/cogs/faqs/__init__.py): `cogs/faqs/__init__.py`
- [Community logs](https://github.com/funcfusion/antbot/blob/main/cogs/logs/__init__.py): `cogs/logs/__init__.py`
- [IVEN requests](https://github.com/funcfusion/antbot/blob/main/cogs/iven/requests.py): `cogs/iven/requests.py`
- [Voice channels](https://github.com/funcfusion/antbot/blob/main/cogs/voice_channels/__init__.py): `cogs/voice_channels/__init__.py`

### Community features

- [Ideas and voting](https://github.com/funcfusion/antbot/blob/main/cogs/ideas/__init__.py): `cogs/ideas/__init__.py`
- [Creator search](https://github.com/funcfusion/antbot/blob/main/cogs/fun/look_for.py): `cogs/fun/look_for.py`
- [Fun commands](https://github.com/funcfusion/antbot/blob/main/cogs/fun/enchants.py): `cogs/fun/enchants.py`
- [Meme tools](https://github.com/funcfusion/antbot/blob/main/cogs/memes/demotivator.py): `cogs/memes/demotivator.py`
- [Server utilities](https://github.com/funcfusion/antbot/blob/main/cogs/general/remind.py): `cogs/general/remind.py`
- [GIF conversion](https://github.com/funcfusion/antbot/blob/main/cogs/general/gif.py): `cogs/general/gif.py`

### Minecraft tools

- [Pack formatting](https://github.com/funcfusion/antbot/blob/main/cogs/minecraft/packformat.py): `cogs/minecraft/packformat.py`
- [Minecraft files](https://github.com/funcfusion/antbot/blob/main/cogs/minecraft/file.py): `cogs/minecraft/file.py`
- [Snapshot scraper](https://github.com/funcfusion/antbot/blob/main/cogs/minecraft/snapshot_scraper.py): `cogs/minecraft/snapshot_scraper.py`
- [Pack generator](https://github.com/funcfusion/antbot/blob/main/utils/pack_generator.py): `utils/pack_generator.py`
- [Pack metadata](https://github.com/funcfusion/antbot/blob/main/utils/packmcmeta.py): `utils/packmcmeta.py`

### Shared utilities

- [Bot helpers](https://github.com/funcfusion/antbot/blob/main/utils/general.py): `utils/general.py`
- [Message helpers](https://github.com/funcfusion/antbot/blob/main/utils/msg_utils.py): `utils/msg_utils.py`
- [Input validation](https://github.com/funcfusion/antbot/blob/main/utils/validator.py): `utils/validator.py`
- [Image processing](https://github.com/funcfusion/antbot/blob/main/utils/image_utils.py): `utils/image_utils.py`
- [User database](https://github.com/funcfusion/antbot/blob/main/utils/users_db.py): `utils/users_db.py`

### Other components

- **Server members**
- **Moderators**
- **Discord platform**

## Connections

- Server members → AntBot runtime: use commands
- Moderators → AntBot runtime: use commands
- AntBot runtime → Administration: registers cog (evidence: `main.py`)
- AntBot runtime → Moderation: registers cog (evidence: `main.py`)
- AntBot runtime → Help and tickets: registers cog (evidence: `main.py`)
- AntBot runtime → FAQs: registers cog (evidence: `main.py`)
- AntBot runtime → Community logs: registers cog (evidence: `main.py`)
- AntBot runtime → Ideas and voting: registers cog (evidence: `main.py`)
- AntBot runtime → Creator search: registers cog (evidence: `main.py`)
- AntBot runtime → Fun commands: registers cog (evidence: `main.py`)
- AntBot runtime → Meme tools: registers cog (evidence: `main.py`)
- AntBot runtime → Server utilities: registers cog (evidence: `main.py`)
- AntBot runtime → GIF conversion: registers cog (evidence: `main.py`)
- AntBot runtime → IVEN requests: registers cog (evidence: `main.py`)
- AntBot runtime → Voice channels: registers cog (evidence: `main.py`)
- AntBot runtime → Pack formatting: registers cog (evidence: `main.py`)
- AntBot runtime → Minecraft files: registers cog (evidence: `main.py`)
- AntBot runtime → Snapshot scraper: registers cog (evidence: `main.py`)
- Pack generator → Input validation: validates with (evidence: `utils/pack_generator.py`)
- Pack generator → Pack metadata: reads version (evidence: `utils/pack_generator.py`)
- Pack generator → Message helpers: uses emojis (evidence: `utils/pack_generator.py`)
- Pack formatting → Pack metadata: uses metadata (evidence: `cogs/minecraft/packformat.py`)
- Pack formatting → Bot helpers: uses helpers (evidence: `cogs/minecraft/packformat.py`)
- Creator search → Input validation: validates input (evidence: `cogs/fun/look_for.py`)
- Creator search → Bot helpers: uses helpers (evidence: `cogs/fun/look_for.py`)
- Help and tickets → Bot helpers: uses helpers (evidence: `cogs/help/starter_message.py`)
- GIF conversion → Image processing: edits images (evidence: `cogs/general/gif.py`)
- GIF conversion → Discord platform: sends media (evidence: `cogs/general/gif.py`)
- AntBot runtime → Pack metadata: starts updater (evidence: `main.py`)
- AntBot runtime → Discord platform: runs bot (evidence: `main.py`)
