# kema99/discord-bot architecture

> Architecture diagram of the GitHub repository kema99/discord-bot, 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/kema99/discord-bot
- Repository: https://github.com/kema99/discord-bot

## Overview

This repository contains several Discord bots: a community/game bot, an alliance and server-operations bot, and a smaller welcome/moderation bot. Their main workflow is Discord users issuing commands or using interactive panels; the bots validate requests, perform server actions, and send responses. The sampled code also shows alliance editing, identity and withdrawal verification, plans, pricing, delivery tracking, and giveaways. Feature coverage follows the excerpts; unsampled implementations and data wiring are not inferred.

Main entry points: [`italiano.py`](https://github.com/kema99/discord-bot/blob/main/italiano.py) (Alliance bot), [`bot.py`](https://github.com/kema99/discord-bot/blob/main/bot.py) (Community bot), [`discord-bot/bot.py`](https://github.com/kema99/discord-bot/blob/main/discord-bot/bot.py) (Welcome bot), [`alianzas database`](https://github.com/kema99/discord-bot/blob/main/alianzas%20database) (Alliance data)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_community["Community bot"]
  node_community_bot["Community bot<br/>[bot.py]"]
  node_game_channels["Game channels<br/>[bot.py]"]
  node_role_picker["Role selection<br/>[bot.py]"]
  node_embed_builder["Embed builder<br/>[bot.py]"]
  node_bug_reports["Bug reports<br/>[bot.py]"]
end

subgraph group_operations["Server operations"]
  node_alliance_bot["Alliance bot<br/>[italiano.py]"]
  node_alliance_editor["Alliance editor<br/>[italiano.py]"]
  node_alliance_data[("Alliance data")]
  node_plans["Raid plans<br/>[italiano.py]"]
  node_weapon_prices["Weapon prices<br/>[italiano.py]"]
  node_identity_check["Identity checks<br/>[italiano.py]"]
  node_withdrawal_check["Withdrawal checks<br/>[italiano.py]"]
  node_delivery_tracking["Delivery tracking<br/>[italiano.py]"]
  node_giveaways["Giveaways<br/>[italiano.py]"]
end

subgraph group_moderation["Welcome moderation"]
  node_welcome_bot["Welcome bot<br/>[bot.py]"]
  node_moderation_cmds["Moderation commands<br/>[bot.py]"]
end

node_users(("Discord users"))
node_discord["Discord platform"]

node_users -->|"issue commands"| node_community_bot
node_community_bot -->|"creates channels"| node_game_channels
node_community_bot -->|"opens selector"| node_role_picker
node_community_bot -->|"opens builder"| node_embed_builder
node_community_bot -->|"creates report channel"| node_bug_reports
node_users -->|"use panels"| node_alliance_bot
node_alliance_bot -->|"opens editor"| node_alliance_editor
node_alliance_editor -->|"saves alliance"| node_alliance_data
node_alliance_editor -->|"loads alliances"| node_alliance_data
node_alliance_bot -->|"creates plans"| node_plans
node_alliance_bot -->|"publishes menu"| node_weapon_prices
node_alliance_bot -->|"opens verification"| node_identity_check
node_alliance_bot -->|"opens verification"| node_withdrawal_check
node_alliance_bot -->|"opens forms"| node_delivery_tracking
node_alliance_bot -->|"selects winner"| node_giveaways
node_users -->|"join or command"| node_welcome_bot
node_welcome_bot -->|"sends welcome"| node_discord
node_moderation_cmds -->|"kicks or bans"| node_discord
node_welcome_bot -->|"handles commands"| node_moderation_cmds
node_community_bot -->|"manages server"| node_discord
node_alliance_bot -->|"sends interactions"| node_discord

click node_community_bot "https://github.com/kema99/discord-bot/blob/main/bot.py"
click node_game_channels "https://github.com/kema99/discord-bot/blob/main/bot.py"
click node_role_picker "https://github.com/kema99/discord-bot/blob/main/bot.py"
click node_embed_builder "https://github.com/kema99/discord-bot/blob/main/bot.py"
click node_bug_reports "https://github.com/kema99/discord-bot/blob/main/bot.py"
click node_alliance_bot "https://github.com/kema99/discord-bot/blob/main/italiano.py"
click node_alliance_editor "https://github.com/kema99/discord-bot/blob/main/italiano.py"
click node_alliance_data "https://github.com/kema99/discord-bot/blob/main/alianzas%20database"
click node_plans "https://github.com/kema99/discord-bot/blob/main/italiano.py"
click node_weapon_prices "https://github.com/kema99/discord-bot/blob/main/italiano.py"
click node_identity_check "https://github.com/kema99/discord-bot/blob/main/italiano.py"
click node_withdrawal_check "https://github.com/kema99/discord-bot/blob/main/italiano.py"
click node_delivery_tracking "https://github.com/kema99/discord-bot/blob/main/italiano.py"
click node_giveaways "https://github.com/kema99/discord-bot/blob/main/italiano.py"
click node_welcome_bot "https://github.com/kema99/discord-bot/blob/main/discord-bot/bot.py"
click node_moderation_cmds "https://github.com/kema99/discord-bot/blob/main/discord-bot/bot.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_community_bot,node_game_channels,node_role_picker,node_embed_builder,node_bug_reports,node_users toneBlue
class node_alliance_bot,node_alliance_editor,node_alliance_data,node_plans,node_weapon_prices,node_identity_check,node_withdrawal_check,node_delivery_tracking,node_giveaways toneAmber
class node_welcome_bot,node_moderation_cmds toneMint
class node_discord toneIndigo
```

## Components

### Community bot

- [Community bot](https://github.com/kema99/discord-bot/blob/main/bot.py): `bot.py`
- [Game channels](https://github.com/kema99/discord-bot/blob/main/bot.py): `bot.py`
- [Role selection](https://github.com/kema99/discord-bot/blob/main/bot.py): `bot.py`
- [Embed builder](https://github.com/kema99/discord-bot/blob/main/bot.py): `bot.py`
- [Bug reports](https://github.com/kema99/discord-bot/blob/main/bot.py): `bot.py`

### Server operations

- [Alliance bot](https://github.com/kema99/discord-bot/blob/main/italiano.py): `italiano.py`
- [Alliance editor](https://github.com/kema99/discord-bot/blob/main/italiano.py): `italiano.py`
- [Alliance data](https://github.com/kema99/discord-bot/blob/main/alianzas%20database): `alianzas database`
- [Raid plans](https://github.com/kema99/discord-bot/blob/main/italiano.py): `italiano.py`
- [Weapon prices](https://github.com/kema99/discord-bot/blob/main/italiano.py): `italiano.py`
- [Identity checks](https://github.com/kema99/discord-bot/blob/main/italiano.py): `italiano.py`
- [Withdrawal checks](https://github.com/kema99/discord-bot/blob/main/italiano.py): `italiano.py`
- [Delivery tracking](https://github.com/kema99/discord-bot/blob/main/italiano.py): `italiano.py`
- [Giveaways](https://github.com/kema99/discord-bot/blob/main/italiano.py): `italiano.py`

### Welcome moderation

- [Welcome bot](https://github.com/kema99/discord-bot/blob/main/discord-bot/bot.py): `discord-bot/bot.py`
- [Moderation commands](https://github.com/kema99/discord-bot/blob/main/discord-bot/bot.py): `discord-bot/bot.py`

### Other components

- **Discord users**
- **Discord platform**

## Connections

- Discord users → Community bot: issue commands
- Community bot → Game channels: creates channels (evidence: `bot.py`)
- Community bot → Role selection: opens selector (evidence: `bot.py`)
- Community bot → Embed builder: opens builder (evidence: `bot.py`)
- Community bot → Bug reports: creates report channel (evidence: `bot.py`)
- Discord users → Alliance bot: use panels
- Alliance bot → Alliance editor: opens editor (evidence: `italiano.py`)
- Alliance editor → Alliance data: saves alliance (evidence: `italiano.py`)
- Alliance editor → Alliance data: loads alliances (evidence: `italiano.py`)
- Alliance bot → Raid plans: creates plans (evidence: `italiano.py`)
- Alliance bot → Weapon prices: publishes menu (evidence: `italiano.py`)
- Alliance bot → Identity checks: opens verification (evidence: `italiano.py`)
- Alliance bot → Withdrawal checks: opens verification (evidence: `italiano.py`)
- Alliance bot → Delivery tracking: opens forms (evidence: `italiano.py`)
- Alliance bot → Giveaways: selects winner (evidence: `italiano.py`)
- Discord users → Welcome bot: join or command
- Welcome bot → Discord platform: sends welcome (evidence: `discord-bot/bot.py`)
- Moderation commands → Discord platform: kicks or bans (evidence: `discord-bot/bot.py`)
- Welcome bot → Moderation commands: handles commands (evidence: `discord-bot/bot.py`)
- Community bot → Discord platform: manages server (evidence: `bot.py`)
- Alliance bot → Discord platform: sends interactions (evidence: `italiano.py`)
