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
β
telegram:
for-minecraft: "<fcolor:2><name> <fcolor:1>Β» <fcolor:4><message>"
message-channel:
CHAT: "<final_message>"
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:
- Take the name from the list of
message types
. - 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:
- 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.
- 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 _
.
- The ID of my main channel (it always ends with
_1
) is-1002341720267_1
. - 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
Not recommended for global messages
π 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 for any player |
FALSE | Available if granted separately (e.g., via LuckPerms) |
OP | Available for server operators |
NOT_OP | Available if granted separately (e.g., via LuckPerms) |