Telegram

Integration with Telegram allows sending messages:

• From Minecraft to Telegram
• From Telegram to Minecraft

Message Types

Type	Explanation
CHAT	Global chat message
AFK	Global message from the afk action
ADVANCEMENT	Achievement message
DEATH	Death message
JOIN	Message when a player joins the server
QUIT	Message when a player leaves the server
FROM_DISCORD_TO_MINECRAFT	Message from Discord to Minecraft
FROM_TWITCH_TO_MINECRAFT	Message from Twitch to Minecraft
FROM_TELEGRAM_TO_MINECRAFT	Message from Telegram to Minecraft
COMMAND_ME	Global message from the /me command
COMMAND_BALL	Global message from the /ball command
COMMAND_BAN	Global message from the /ban command
COMMAND_BROADCAST	Global message from the /broadcast command
COMMAND_COIN	Global message from the /coin command
COMMAND_DICE	Global message from the /dice command
COMMAND_DO	Global message from the /do command
COMMAND_HELPER	Global message from the /helper command
COMMAND_MUTE	Global message from the /mute command
COMMAND_POLL_CREATE_MESSAGE	Global message from the /poll command
COMMAND_SPY	Player tracking for the /spy command
COMMAND_STREAM	Global message from the /stream command
COMMAND_TRANSLATETO	Global message from the /translateto command
COMMAND_TRY	Global message from the /try command
COMMAND_WARN	Global message from the /warn command
COMMAND_KICK	Global message from the /kick command

🌍 Localization

📂 Path localizations → language.yml → integration.telegram

⚖️ Default

ru_ru.yml

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

en_us.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:

message_name: "<final_message>"

⚙️ Setting

📂 Path integration.yml → telegram

⚖️ Default

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.

2. Write:

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.

Type	Explanation	Requires additional configuration?
ACTION_BAR	Message above the player's inventory	Yes
BOSS_BAR	Message at the top of the screen	Yes
BRAND	Message in F3	No
CHAT	Message in the chat	No
TITLE	Full-screen message	Yes
SUBTITLE	Full-screen message (bottom line)	Yes
TAB_HEADER	Message in TAB (top)	No
TAB_FOOTER	Message in TAB (bottom)	No
TOAST	Message in the top-right corner (achievement)	Yes

Configuration for ACTION_BAR

destination:
  type: ACTION_BAR
  times:
    stay: 60

times

Field	Explanation
stay	Time in ticks to hold the message

Configuration for BOSS_BAR

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

Type	Explanation
PROGRESS	Single line
NOTCHED_6	Divided into 6 parts
NOTCHED_10	Divided into 10 parts
NOTCHED_12	Divided into 12 parts
NOTCHED_20	Divided 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)

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

Field	Explanation
fade-in	Time in ticks for the message to appear
stay	Time in ticks to hold the message
fade-out	Time in ticks for the message to disappear

Configuration for TOAST

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

May cause delays, so not recommended for use

🔐 Permissions

📂 Path permission.yml → integration.telegram

⚖️ Default

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

name

Permission name

type

Permission type

Type	Explanation
TRUE	Available to any player
FALSE	Not available to anyone, must be granted separately (e.g., using LuckPerms)
OP	Available to server operators
NOT_OP	Available to not server operators