DiscordBridgeSetup

Hotline Protocol

---

Core Documentation

• Documentation Home
• Glossary / Terms
• Protocol History

Technical Specifications

• Transaction IDs
• Field Definitions
• Access Bits
• Error Codes

Binary & Data

• FILP/RFLT Specs
• News Headers
• Logic Sequences

External Networking

• Tracker (HTRK)
• HTTP Tunneling
• Global Server

Assets

• Icon Gallery

---

Setting Up the Discord-Hotline Bridge

This guide explains how to deploy the Python Bridge Script on a modern server (Linux, Windows, or macOS).

Prerequisites

• Python 3.8+: Ensure Python is installed on your system.
• Discord Bot Token: Required to authenticate with the Discord API.
• Hotline Server Access: The IP and Port of the Hotline server you wish to bridge.

Step 1: Install Dependencies

The bridge relies on two primary libraries: discord.py for the bot interface and aiohttp for the webhook relay. Open your terminal and run:

<syntaxhighlight lang="bash"> pip install discord.py aiohttp </syntaxhighlight>

Step 2: Create a Discord Webhook

To allow the bot to post messages with custom Hotline icons, you must use a Webhook.

1. Go to your Discord Server Settings > Integrations > Webhooks.
2. Click "New Webhook."
3. Copy the Webhook URL. You will need this for the config file.

Step 3: Configure the Bot

Create a file named config.json in the same directory as your script. Use the following template:

<syntaxhighlight lang="json"> {

   "discord_token": "YOUR_BOT_TOKEN_HERE",
   "discord_channel_id": 1234567890123456,
   "discord_webhook_url": "https://discord.com/api/webhooks/...",
   "hotline_host": "72.62.163.172",
   "hotline_port": 5500,
   "manual_admins": ["Tagban", "Knezzen"],
   "admin_prefix": "> **[ADMIN]** ",
   "user_prefix": "```fix\n",
   "user_suffix": "\n```"

} </syntaxhighlight>

Step 4: Launching the Bridge

Run the script using the following command: <syntaxhighlight lang="bash"> python bridge.py </syntaxhighlight> Once connected, you should see ✅ Hotline Connected (Guest Mode) in your console.

Troubleshooting

• Connection Refused: Ensure the Hotline server allows Guest connections (0x6b).
• No Messages in Discord: Verify the discord_channel_id is correct and the bot has "View Channel" and "Send Messages" permissions.