Skip to content

Telegram ​

Integration with Telegram allows sending messages:

  • From Minecraft to Telegram
  • From Telegram to Minecraft

telegram message 1telegram message 2minecraft message

Message Types ​

TypeExplanation
CHATGlobal chat message
AFKGlobal message from the afk action
ADVANCEMENTAchievement message
DEATHDeath message
JOINMessage when a player joins the server
QUITMessage when a player leaves the server
FROM_DISCORD_TO_MINECRAFTMessage from Discord to Minecraft
FROM_TWITCH_TO_MINECRAFTMessage from Twitch to Minecraft
FROM_TELEGRAM_TO_MINECRAFTMessage from Telegram to Minecraft
COMMAND_MEGlobal message from the /me command
COMMAND_BALLGlobal message from the /ball command
COMMAND_BANGlobal message from the /ban command
COMMAND_BROADCASTGlobal message from the /broadcast command
COMMAND_COINGlobal message from the /coin command
COMMAND_DICEGlobal message from the /dice command
COMMAND_DOGlobal message from the /do command
COMMAND_HELPERGlobal message from the /helper command
COMMAND_MUTEGlobal message from the /mute command
COMMAND_POLL_CREATE_MESSAGEGlobal message from the /poll command
COMMAND_SPYPlayer tracking for the /spy command
COMMAND_STREAMGlobal message from the /stream command
COMMAND_TRANSLATETOGlobal message from the /translateto command
COMMAND_TRYGlobal message from the /try command
COMMAND_WARNGlobal message from the /warn command
COMMAND_KICKGlobal message from the /kick command

🌍 Localization ​

πŸ“‚ Path localizations β†’ language.yml β†’ integration.telegram

βš–οΈ Default ​

yml
telegram:
  for-minecraft: "<fcolor:2><name> <fcolor:1>Β» <fcolor:4><message>"
  message-channel:
    CHAT: "<final_message>"
yml
telegram:
  for-minecraft: "<fcolor:2><name> <fcolor:1>Β» <fcolor:4><message>"
  message-channel:
    CHAT: "<final_message>"

Placeholders ​

You can use all placeholders that are used in the initial message for Minecraft

EXAMPLE FOR A BAN MESSAGE

There is a placeholder <reason>, so I can use <reason> inside Telegram messages

There are also placeholders that WILL DEFINITELY be replaced in any message:

  • <final_message>: The message sent to Minecraft
  • <final_clear_message>: The message sent to Minecraft without unicode emojis
  • <player>: The nickname of the player who sent the message

Obviously, all placeholders from PlaceholderAPI and FlectonePulse will also work.

for-minecraft ​

The format of the message that will be sent from Telegram to Minecraft.

message-channel ​

A list of messages with the format of the final message.

IF YOU WANT TO ADD ANOTHER MESSAGE:

  1. Take the name from the list of message types.
  2. Insert it into message-channel:
yaml
message_name: "<final_message>"

βš™οΈ Setting ​

πŸ“‚ Path integration.yml β†’ telegram

βš–οΈ Default ​

yml
telegram:
  enable: false
  token: ""
  message-channel:
    FROM_TELEGRAM_TO_MINECRAFT: []
    CHAT: []
  destination:
    type: CHAT

enable ​

Enables or disables the functionality of the module

WARNING

  • Before enabling, insert the token of the Telegram bot.
  • After enabling, it is HIGHLY RECOMMENDED to restart the server.

token ​

The token of the bot for connection. You can use environment variables, for example ${VALUE}.

message-channel ​

A list of message types and chat IDs in Telegram.

For example, I want messages from the /ban command in Minecraft to be sent to Telegram:

  1. Copy the chat ID where the message should be sent (-1002341720267_49).

If the bot is connected and added to the channel, you can use the /id command in Telegram to find out the channel ID.

  1. Write:
yaml
message-channel:
  COMMAND_BAN:
    - "-1002341720267_49"

There can be as many chats as you want, as long as the bot has access to them from secrets.

IMPORTANT

If your channel is a Forum (Topic), the ID of the MAIN channel should be specified without _.

  1. The ID of my main channel (it always ends with _1) is -1002341720267_1.
  2. Therefore, you need to enter ONLY -1002341720267.

For other chats in the forum, this rule does not apply, and you need to enter the FULL ID.

destination ​

Where the message will be sent

HOW TO CHANGE THE DESTINATION?

Replace the value type: here and restart FlectonePulse using the /flectonepulse reload command. Additional settings will appear automatically.

TypeExplanationRequires additional configuration?
ACTION_BARMessage above the player's inventoryYes
BOSS_BARMessage at the top of the screenYes
BRANDMessage in F3No
CHATMessage in the chatNo
TITLEFull-screen messageYes
SUBTITLEFull-screen message (bottom line)Yes
TAB_HEADERMessage in TAB (top)No
TAB_FOOTERMessage in TAB (bottom)No
TOASTMessage in the top-right corner (achievement)Yes
Configuration for ACTION_BAR
yaml
destination:
  type: ACTION_BAR
  times:
    stay: 60

times ​

FieldExplanation
stayTime in ticks to hold the message
Configuration for BOSS_BAR
yaml
destination:
  type: BOSS_BAR
  duration: 100
  health: 1.0
  overlay: PROGRESS
  color: BLUE
  play-boos-music: false
  create-world-fog: false
  darken-screen: false

duration ​

Duration of the message display

health ​

How full the boss bar will be

overlay ​

TypeExplanation
PROGRESSSingle line
NOTCHED_6Divided into 6 parts
NOTCHED_10Divided into 10 parts
NOTCHED_12Divided into 12 parts
NOTCHED_20Divided into 20 parts

color ​

Display color

Type
PINK
BLUE
RED
GREEN
YELLOW
PURPLE
WHITE

play-boos-music ​

Whether music will play with the message

create-world-fog ​

Whether fog will appear with the message

darken-screen ​

Whether the screen will darken with the message

Configuration for TITLE (or SUBTITLE)
yaml
destination:
  type: TITLE (or SUBTITLE)
  subtext: ""
  times:
    fade-in: 20
    stay: 60
    fade-out: 20

subtext ​

Message for the second part of the display. For example, if TITLE is selected, subtext will be displayed below it, and vice versa.

times ​

FieldExplanation
fade-inTime in ticks for the message to appear
stayTime in ticks to hold the message
fade-outTime in ticks for the message to disappear
Configuration for TOAST
yaml
destination:
  type: TOAST
  icon: "minecraft:diamond"
  style: TASK

icon ​

Achievement icon, which can be any Minecraft item (must specify the full path)

style ​

Achievement type (TASK regular, GOAL goal, CHALLENGE challenge)

WARNING

Not recommended for global messages

πŸ” Permissions ​

πŸ“‚ Path permission.yml β†’ integration.telegram

βš–οΈ Default ​

yml
telegram:
  name: "flectonepulse.module.integration.telegram"
  type: TRUE

name ​

Permission name

type ​

Permission type

TypeExplanation
TRUEAvailable for any player
FALSEAvailable if granted separately (e.g., via LuckPerms)
OPAvailable for server operators
NOT_OPAvailable if granted separately (e.g., via LuckPerms)