Skip to content

About

Join, quit and first-join messages with your skin face in chat. Titles, boss bars, action bars and chat announcements, each with its own sound. Clickable and hoverable text, quick broadcasts and everything editable in game.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

7 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

FlareMessages

Welcome, join / quit and announcements for Minecraft servers: hex colors, boss bars, titles and the player's skin face in chat.

Minecraft Platforms Java License


How it works

Everything is set up in the files, no in-game menus. Players get no commands: they just see the messages you prepared.

  • a player joins for the first time: he gets a welcome with his skin face, a title and a boss bar, and everyone else sees "New player, say hi!"
  • every next join: a welcome back message, only for him
  • join / quit lines in chat with your own format (one for VIPs, one for staff, none at all...)
  • every few minutes an announcement: Discord, vote, store, tips... in chat, title, action bar or boss bar, and at fixed times (the PvP night every Friday at 21:00)
  • at Christmas, Halloween or your own event: another welcome and other announcements, only between two dates
  • a title when someone enters the Nether for the first time, and joins / leaves in your Discord channel

Features

  • Skin face in chat: the 8x8 face of the player (with the hat layer) next to the welcome lines. Works on premium, SkinsRestorer and offline-mode servers. Skins are downloaded in the background and cached
  • Every message can mix chat, title, action bar, boss bar, sound and commands
  • First join: message to the new player, announcement to the others, commands run once (starter kit, rank...)
  • Join milestones: a message to everyone when a new player is #100, #500, #1000... with a prize if you want
  • Holidays: other welcome, join / quit lines and announcements between two dates, every year or once
  • World change messages: enter / leave / first time in a world, per world
  • Discord: joins, leaves, first joins and milestones sent to a channel with a webhook, the player's head as picture
  • Join / quit formats by permission and priority, each with its own sound, or no join / quit message at all
  • Announcements: in order or random, at fixed times, minimum / maximum players online (also per announcement), permission and world filters, announcements sent only by hand (in-rotation: false) for events and restarts
  • Quick broadcast: /fmes broadcast <chat|actionbar|title|bossbar> <text>
  • Preview any message only to you, without running its commands
  • Hex colors, gradients, rainbow, click & hover in every text (MiniMessage and & codes), <center> for chat lines
  • Placeholders of the plugin and of PlaceholderAPI, for every player
  • Safe files: /fmes reload tells you the file and the line of a mistake; a broken file is never overwritten
  • Safe updates: new options and texts are added to your files, your edits are never touched
  • Staff only commands: players don't even see /fmessages

Compatibility

Server Spigot, Paper, Purpur and other forks
Versions 1.16.5 → 26.x (one jar for all)
Java 8 or newer
Optional PlaceholderAPI (downloaded automatically), SkinsRestorer

On Spigot join and quit messages can't be clicked or hovered (colors and hex work); everything else can. On Paper and its forks every message can be clicked.

Installation

  1. Put FlareMessages-<version>.jar in plugins/
  2. Start the server, all files are created automatically
  3. Edit welcome.yml and announcements.yml, then /fmes reload

If PlaceholderAPI is missing it is downloaded from its official pages (Hangar, Modrinth, GitHub) and started without a restart. Turn it off with config.yml > auto-install > enabled: false.

Files

File
config.yml modules on / off, server name, date and time, boss bars, quick broadcast, skin face
welcome.yml join / quit formats, welcome, first join
announcements.yml automatic and manual announcements
lang/en.yml answers of the commands

Commands

Main command /fmessages. Also /fmes, /fmessage, /messages and /message.

Command Description Permission
/fmes help Commands you can use flaremessages.admin
/fmes announce <id|next> Send an announcement to everyone now (next = the next one of the rotation, then its timer starts again) flaremessages.admin
/fmes broadcast <type> <text> Quick message: chat, actionbar, title (title | subtitle), bossbar flaremessages.admin
/fmes preview <message> [player] Show welcome, firstjoin, firstjoin-broadcast, join, quit, milestone or an announcement only to you (or a player) flaremessages.admin
/fmes list Every announcement, click one to preview it flaremessages.admin
/fmes face [player] Show a skin face and where it comes from flaremessages.admin
/fmes reload Reload every file, with the line of any mistake flaremessages.admin
/fmes about Plugin version (green = latest, red = outdated), server, Java, update notifier, plugin hooks, clickable permission list (about permissions). Also version / ver, also from the console flaremessages.command.version
Permission Default
flaremessages.admin op every command and the update message on join
flaremessages.command.version op /fmes about
flaremessages.staff op counted in {online_staff} (give it to helpers and mods)
flaremessages.silent nobody joins and leaves without a join / quit message
flaremessages.format.vip nobody uses the vip join / quit format of welcome.yml (add your own formats)

Placeholders

In the files: {player} {displayname} {uuid} {world} {ping} {level} {health} {gamemode} {x} {y} {z} {online} {max_online} {online_staff} {server_name} {date} {time} {prefix} {join_number} {first_join_date} {days_played} {face_1} ... {face_8}, plus every PlaceholderAPI placeholder.

PlaceholderAPI Value
%flaremessages_join_number% how many different players joined the server
%flaremessages_face_1% ... %flaremessages_face_8% one row of the player's skin face
%flaremessages_online_staff% staff online (flaremessages.staff), without the ones in vanish
%flaremessages_first_join_date% day of the player's first join
%flaremessages_days_played% full days since the player's first join
%flaremessages_holiday% id of the active holiday of holidays.yml (empty = none)

Anonymous statistics

This plugin sends anonymous usage statistics to TMDevelopment every 30 minutes: plugin version, Minecraft version, server software, Java version, CPU core count, online player count, online/offline mode and a random server id generated on your server. The country of the server is derived from its IP address (only the country code is kept). FlareMessages also sends a few anonymous settings of its own: the language of the messages, which modules are on, the number of announcements and join formats, whether PlaceholderAPI is installed, and whether the Discord messages and the world change messages are on. No player names or UUIDs, no IP addresses (they are never stored), no chat, world or config data. Data of a server is deleted 30 days after its last report; only anonymous totals are kept. We use it to know which versions to support. You can turn it off for this plugin with stats: false in config.yml, or for all TMDevelopment plugins in plugins/TMDStats/config.yml (enabled: false).

The update check only reads the latest release of FlareMessages from GitHub: it sends nothing. Turn it off with update-check: false in config.yml.

Discord messages are off by default. When you turn them on (discord in config.yml), joins, leaves, first joins and milestones (player name and the texts you write) are sent only to the Discord webhook you set.

Building

mvn package

The jar is in target/FlareMessages-<version>.jar.

Support

Discord: https://discord.tmstudio.dev

License

MIT, see LICENSE.

About

Join, quit and first-join messages with your skin face in chat. Titles, boss bars, action bars and chat announcements, each with its own sound. Clickable and hoverable text, quick broadcasts and everything editable in game.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages