Discord

Integration with Discord allows sending messages:

From Minecraft to Discord
From Discord to Minecraft

discord message minecraft message

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 → язык.yml → integration.discord

⚖️ `Default`

ru_ru.ymlen_us.yml

yml

discord:
  for-minecraft: "<fcolor:2><name> <fcolor:1>» <fcolor:4><message>"
  info-channel:
    айди: "ТПС <tps>"
  message-channel:
    CHAT:
      content: "<final_message>"
      webhook:
        enable: false
        avatar: "https://mc-heads.net/avatar/<skin>/32.png"
        content: ""
      embed:
        enable: false
        color: ""
        title: ""
        url: ""
        author:
          name: ""
          url: ""
          icon-url: "https://mc-heads.net/avatar/<skin>/16.png"
        description: ""
        thumbnail: ""
        image: ""
        timestamp: true
        footer:
          text: ""
          icon-url: "https://mc-heads.net/avatar/<skin>/16.png"

yml

discord:
  for-minecraft: "<fcolor:2><name> <fcolor:1>» <fcolor:4><message>"
  info-channel:
    id: "TPS <tps>"
  message-channel:
    CHAT:
      content: "<final_message>"
      webhook:
        enable: false
        avatar: "https://mc-heads.net/avatar/<skin>/32.png"
        content: ""
      embed:
        enable: false
        color: ""
        title: ""
        url: ""
        author:
          name: ""
          url: ""
          icon-url: "https://mc-heads.net/avatar/<skin>/16.png"
        description: ""
        thumbnail: ""
        image: ""
        timestamp: true
        footer:
          text: ""
          icon-url: "https://mc-heads.net/avatar/<skin>/16.png"

`Placeholders`

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

FOR EXAMPLE, FOR A BAN MESSAGE

If there’s a placeholder <reason>, you can use <reason> in Discord messages as well

There are also placeholders that will ALWAYS 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`

Message format that will be sent from Discord to Minecraft.

`info-channel`

List of channel IDs and their names.

`message-channel`

List of messages and their configurations.

Message Configuration

discord

If the parameter is empty, it will not be used in the final message.

`content`

Content of a regular message from the Discord bot. discord content

`webhook`

Discord webhook configuration.

`enable`

If enabled, the message will be a webhook.

`avatar`

Link to create the player’s avatar. If you change it, the link should contain <skin>.

`content`

Content of the webhook message.

`embed`

Discord embed message configuration.

`enable`

If enabled, the message will include an embed.

`color`

Color of the embed message.

`title`

Title of the embed message.

`url`

URL for the embed message.

`author`

Author of the embed message.

`name`

Name of the embed message author.

`url`

URL of the embed message author.

`icon-url`

Link to the avatar of the embed message author. If you change it, the link should contain <skin>.

`description`

Description of the embed message.

`thumbnail`

Small image inside the embed message.

`name`

Field name inside the embed message.

`value`

Field value inside the embed message.

`inline`

If enabled, the field will be arranged vertically with other fields.

`image`

Main image inside the embed message.

`timestamp`

If enabled, the embed message will include the timestamp.

`footer`

Footer of the embed message.

`text`

Text in the footer of the embed message.

`icon-url`

Image in the footer of the embed message.

IF YOU WANT TO ADD ANOTHER MESSAGE:

Take the name from the "Message Types" list.
Add it to message-channel.

yaml

message_name:
  content: ""
  webhook:
    enable: false
    avatar: "https://mc-heads.net/avatar/<skin>/32.png"
    content: ""
  embed:
    enable: false
    color: ""
    title: ""
    url: ""
    author:
      name: ""
      url: ""
      icon-url: "https://mc-heads.net/avatar/<skin>/16.png"
    description: ""
    thumbnail: ""
    fields:
      - name: ""
        value: ""
        inline: false
    image: ""
    timestamp: true
    footer:
      text: ""
      icon-url: "https://mc-heads.net/avatar/<skin>/16.png"

⚙️ Setting

📂 Path integration.yml → discord

⚖️ `Default`

yml

discord:
  enable: false
  token: ""
  presence:
    enable: true
    status: "ONLINE"
    activity:
      enable: true
      type: "PLAYING"
      name: "FlectonePulse"
      url: "https://flectone.net/pulse/"
  channel-info:
    enable: false
    ticker:
      enable: true
      period: 1200
  message-channel:
    FROM_DISCORD_TO_MINECRAFT: ""
    CHAT: ""
  destination:
    type: CHAT

`enable`

Enables or disables the functionality of the module

WARNING

Before enabling, insert the Discord bot token.
After enabling, IT IS RECOMMENDED to restart the server to avoid potential plugin issues.

`token`

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

`presence`

discord presence

Bot Status Configuration

`enable`

Enables or disables the custom bot status.

`status`

Mode	Explanation
`UNKNOWN`	-
`ONLINE`	Online
`DO_NOT_DISTURB`	Do not disturb (Online)
`IDLE`	Online but idle
`INVISIBLE`	Invisible
`OFFLINE`	Offline

`activity`

Bot activity in Discord.

`enable`

Enables or disables activity.

`type`

Type	Explanation
`UNKNOWN`	-
`STREAMING`	Streaming
`LISTENING`	Listening
`WATCHING`	Watching
`CUSTOM`	-
`COMPETING`	Competing

`name`

Name of the activity.

`url`

Link for the activity.

`channel-info`

discord channel info

Channel Information Configuration

`enable`

Whether channel information is needed.

`ticker`

Updates every certain interval of time

enable

Whether to update or not

period

How often in ticks it should update

`message-channel`

List of message types and channel IDs in Discord.

For example, if I want a /ban command message from Minecraft to be sent to Discord:

Copy the channel ID in Discord 1286666844358316083.
Add CHAT: "1286666844358316083".

yaml

message-channel:
  COMMAND_BAN: "1286666844358316083"

`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

yaml

destination:
  type: ACTION_BAR
  times:
    stay: 60

`times`

Field	Explanation
`stay`	Time 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`

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)

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`

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

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.discord

⚖️ `Default`

yml

discord:
  name: "flectonepulse.module.integration.discord"
  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)

Moderation

Discord ​

Message Types ​

🌍 Localization ​

⚖️ Default ​

Placeholders ​

for-minecraft ​

info-channel ​

message-channel ​

content ​

webhook ​

enable ​

avatar ​

content ​

embed ​

enable ​

color ​

title ​

url ​

author ​

name ​

url ​

icon-url ​

description ​

thumbnail ​

name ​

value ​

inline ​

image ​

timestamp ​

footer ​

text ​

icon-url ​

⚙️ Setting ​

⚖️ Default ​

enable ​

token ​

presence ​

enable ​

status ​

activity ​

enable ​

type ​

name ​

url ​

channel-info ​

enable ​

ticker ​

enable ​

period ​

message-channel ​

destination ​

times ​

duration ​

health ​

overlay ​

color ​

play-boos-music ​

create-world-fog ​

darken-screen ​

subtext ​

times ​

icon ​

style ​

🔐 Permissions ​

⚖️ Default ​

name ​

type ​

Discord

Message Types

🌍 Localization

⚖️ `Default`

`Placeholders`

`for-minecraft`

`info-channel`

`message-channel`

`content`

`webhook`

`enable`

`avatar`

`content`

`embed`

`enable`

`color`

`title`

`url`

`author`

`name`

`url`

`icon-url`

`description`

`thumbnail`

`name`

`value`

`inline`

`image`

`timestamp`

`footer`

`text`

`icon-url`

⚙️ Setting

⚖️ `Default`

`enable`

`token`

`presence`

`enable`

`status`

`activity`

`enable`

`type`

`name`

`url`

`channel-info`

`enable`

`ticker`

`enable`

`period`

`message-channel`

`destination`

`times`

`duration`

`health`

`overlay`

`color`

`play-boos-music`

`create-world-fog`

`darken-screen`

`subtext`

`times`

`icon`

`style`

🔐 Permissions

⚖️ `Default`

`name`

`type`