Skip to content

Config reference

general

botToken

  • Type: string
  • Required

chatId

  • Type: number
  • Required

topicId

  • Type: number | null

messages

requirePrefixInMinecraft

  • Type: string | null
  • Default: null (disabled)
  • Example: "!" (quotes are required)

WARNING

Don't enable this if you have a chat plugin installed. See Compatibility for more info

If this value is set, messages without specified prefix won't be forwarded to Telegram.

keepPrefix

  • Type: boolean
  • Default: false

Set to true to keep the prefix specified in the above setting in the message

mergeWindow

  • Type: number
  • Default: 0 (disabled)

Chat messages sent within the specified interval will be merged in one. The value is specified in seconds

useRealUsername

  • Type: boolean
  • Default: false

Set to true to use real player username instead of display name in all Telegram messages

integrations

bluemapUrl

  • Type: string | null
  • Default: null (disabled)
  • Example: https://map.example.com

If this value is set, waypoints shared from Xaero's Minimap/World Map will be rendered as links to a specified BlueMap instance.

globalChatName

  • Type: string
  • Default: "global"

The chat name to forward messages from. Only has an effect when a compatible chat plugin with support for named chats, such as Chatty, is installed. (see Compatibility)

incompatiblePluginChatPrefix

  • Type: string | null
  • Default: null (disabled)
  • Example: "!" (quotes are required)

See also: Compatibility

Use this if you have an incompatible plugin, such as CMI or AdvancedChat installed. Will register a legacy chat listener with LOWEST priority (HIGHEST on Forge/NeoForge) and only forward messages that start with the specified string. Currently this only has an effect on Paper and Forge/NeoForge.

events

advancementMessages

enable

  • Type: boolean

enableTask

  • Type: boolean

Configure forwarding of each advancement type

enableGoal

  • Type: boolean

Configure forwarding of each advancement type

enableChallenge

  • Type: boolean

Configure forwarding of each advancement type

showDescription

  • Type: boolean

Include advancement descriptions in Telegram messages

enableDeathMessages

  • Type: boolean

enableJoinMessages

  • Type: boolean

enableLeaveMessages

  • Type: boolean

leaveJoinMergeWindow

  • Type: number
  • Default: 0 (disabled)

If a player leaves and then joins within the specified time interval, the leave and join messages will be deleted. This is useful when players frequently re-join, for example because of connection problems. Only has effect when both enableJoinMessages and enableLeaveMessages are set to true. The value is specified in seconds

enableStartMessages

  • Type: boolean

Whether to send a Telegram message when the server starts

enableStopMessages

  • Type: boolean

Whether to send a Telegram message when the server stops

advanced

botApiUrl

  • Type: string
  • Default: "https://api.telegram.org"

connectionRetry

maxAttempts

  • Type: number
  • Default: 10

Max amount of connection retries. If the value is less than 1 the number of attempts is infinite

initialDelay

  • Type: number
  • Default: 1000

Delay before first reconnect attempt in milliseconds

maxDelay

  • Type: number
  • Default: 300000

Maximum delay between reconnection attempts in milliseconds

version

  • Type: number

Config file version. Don't change manually