HackBridge Bot

Originally created for the Kyiv Hackerspace community Discord server and friends around the net.

Discord bridge bot for linking channels (and threads) across servers while keeping strict role-based access control.

Core Features

• Cross-server channel linking with named groups.
• Bridging for text channels, threads, and forum channels.
• Mirrored message lifecycle across linked destinations: new messages, replies, edits, deletes, and reactions.
• Role-based administration with SuperAdmin, Admin, and one-time Registrator access.
• Interactive slash-command flows for channel registration, linking, and group management.
• Per-user custom emoji avatars in bridged message headers.
• MongoDB-backed state and message mapping, without persisting message content.

Usage Flow

1. Install the bot on every server that should participate.
2. Set a SuperAdmin on each server (/set_superadmin from a Discord server admin).
3. Grant Admin and/or Registrator roles where needed using /set_admin and /set_registrator.
4. Register each channel that should be linked with /register_channel.
5. Ensure the same user registers every channel within a link group.
6. Link the channels together via /link_channel.
7. Optionally attach channels to an existing group with /link_channel_to_group.
8. Any group can hold an unlimited number of linked channels.
9. Registrator access is temporary and expires after performing a single channel link.

Commands are exposed via Discord slash commands, each gated by the required role. Slash-command autocompletions guide the linking process and help fill in the necessary IDs. Full command reference: docs/commands.md.

Local Setup

• Requirements: Python 3.8+, running MongoDB instance.
• Create .env with DISCORD_TOKEN, MONGO_URI, MONGO_DB, and AVATAR_COLLECTION_NAME.
• Legacy aliases token, mongodb_uri, and avatar_collection_name are still supported.
• Install deps with pip install -r requirements.txt and start the bot using python main.py.

Production Deploy

• GitHub Actions deploys on every push to master using .github/workflows/publish.yml.
• The workflow builds ghcr.io/denikryt/hackbridge-bot and deploys it through Docker Stack using docker-stack.yml.
• The production stack joins the external Docker network infra_mongo-rs-net, matching the Feed-bot deployment model.
• Required repository secrets: DEPLOY_USER, DEPLOY_HOST, DEPLOY_SSH_PRIVATE_KEY, MONGO_URI, MONGO_DB, DISCORD_TOKEN, AVATAR_COLLECTION_NAME, LOG_FILE.