FomoTelegram

FomoTelegram

A Fomo add-on for On Together that relays in-game chat messages to a Telegram group or channel via a Telegram Bot.

Requirements

• Fomo (hard dependency)

Features

• Forwards global chat, local chat, and system notifications to any Telegram chat or group
• Respects the Fomo ChatSinkLocalRange setting — local messages from players outside your range are filtered before reaching Telegram
• Rate-limited background send queue — won't hammer the Telegram API during busy chat sessions
• Bidirectional relay — messages sent from Telegram back to the bot are injected into the in-game chat
• Configurable format strings for chat messages and notifications
• Per-category toggles (global / local / notifications) and a master on/off switch

Setup

• Create a Telegram Bot

• Open Telegram and message @BotFather
• Send /newbot and follow the prompts
• Copy the API token (looks like 123456789:ABCdefGHI…) to somewhere safe
• Say hello to your own bot so it gains the rights to talk to you.
• Find your Chat ID

• Say hello to user @userinfobot.
• It will reply with your chat ID.
• User chat IDs are positive e.g. 123456789
• Configure the mod

After the first run a config file is generated at:

BepInEx/config/com.andrewlin.ontogether.fomotelegram.cfg

Fill in TelegramBotApiKey and TelegramChatId:

[Telegram]

TelegramBotApiKey = 123456789:ABCdefGHI…

TelegramChatId = 234567890

[Filters]

RelayGlobalChat = true

RelayLocalChat = true

RelayNotifications = true

[Formatting]

MessageFormat = [{channel:short}] {username}: {message}

NotificationFormat = {message}

• Connect without restarting

With the config saved, run /ftr in the in-game chat to reload the config and start the Telegram connection immediately. No game restart required.

To verify what credentials are loaded at any time, run /ftrc.

In-Game Commands

Type any command into the in-game chat. Commands start with / and are not sent to other players.

| Command | Short | Description |

|---------|-------|-------------|

| /fomotelegramtoggle | /ftt | Toggle Telegram forwarding on/off |

| /fomotelegramrestart | /ftr | Reload config from disk and restart the Telegram connection |

| /fomotelegramreloadconfig | /ftrc | Reload config from disk and show the current API key (masked) and chat ID |

| /fomotelegramsetupinfo | /ftsinfo | Print setup instructions |

| /fomotelegrammessageformat [format] | /ftmf | Get or set the chat message format string |

| /fomotelegramnotificationformat [format] | /ftnf | Get or set the notification format string |

Examples

/fomotelegramtoggle

/ftr

/fomotelegrammessageformat [{timestamp:HH:mm}] [{channel:short}] {username}: {message}

Configuration

Located in BepInEx/config/com.andrewlin.ontogether.fomotelegram.cfg

• General
• EnableFeature (default: true) — Master switch; disable to pause all Telegram forwarding without removing the plugin
• Telegram
• TelegramBotApiKey — Your bot token from @BotFather (e.g. 123456:ABC-DEF…)
• TelegramChatId — Target chat / group / channel ID (group IDs are negative)
• Filters
• RelayGlobalChat (default: true) — Forward global chat messages to Telegram
• RelayLocalChat (default: true) — Forward local chat messages to Telegram
• RelayNotifications (default: true) — Forward system notifications (joins, leaves, etc.) to Telegram
• Formatting
• MessageFormat (default: [{channel:short}] {username}: {message}) — Format string for chat messages sent to Telegram
• NotificationFormat (default: {message}) — Format string for system notifications sent to Telegram

Format Placeholders

The MessageFormat and NotificationFormat settings accept the following placeholders:

• {timestamp} — message time; accepts a C# DateTime format specifier (e.g. {timestamp:HH:mm})
• {channel} — full channel label use {channel:short} for just the first character (G / L)
• {username} — display name of the sender
• {message} — message body
• {distance} — distance in metres for local messages, empty for global/notifications
• {source} — intern