Lostarch: Created page with "{{HotlineNav}} == 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 Dependenc..."

2026-03-03T21:56:38Z

Created page with "{{HotlineNav}} == 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 Dependenc..."

New page

{{HotlineNav}}
== Setting Up the Discord-Hotline Bridge ==

This guide explains how to deploy the [[HL_Protocol:BridgeScript|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: <code>discord.py</code> for the bot interface and <code>aiohttp</code> 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.
# Go to your Discord Server Settings > Integrations > Webhooks.
# Click "New Webhook."
# Copy the '''Webhook URL'''. You will need this for the config file.

=== Step 3: Configure the Bot ===
Create a file named <code>config.json</code> 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 <code>✅ Hotline Connected (Guest Mode)</code> in your console.

=== Troubleshooting ===
* '''Connection Refused''': Ensure the Hotline server allows Guest connections (0x6b).
* '''No Messages in Discord''': Verify the <code>discord_channel_id</code> is correct and the bot has "View Channel" and "Send Messages" permissions.

[[Category:Development]]

DiscordBridgeSetup - Revision history