Holidays
(1.1.0+) A holiday is a set of messages used only between two dates: Christmas, Halloween, the server's birthday, an event weekend... While it's active its messages replace the normal ones, and when it ends everything goes back by itself. Nothing to change by hand on the day.
Everything is in holidays.yml (on / off: config.yml > modules.holidays).
Example: Christmas
holidays:
christmas:
enabled: true
from: "12-20"
to: "01-06"
only-holiday-announcements: false
welcome:
chat:
face: true
face-gap: " "
lines:
- ""
- "<gradient:#EB5757:#FFFFFF><bold>MERRY CHRISTMAS!</bold></gradient>"
- "&7Welcome back, &f{player}&7!"
- "&7Happy holidays from"
- "&7the whole team of &f{server_name}&7."
- ""
title:
title: "<gradient:#EB5757:#FFFFFF><bold>MERRY CHRISTMAS</bold></gradient>"
subtitle: "&7from &f{server_name}"
sound: "block.note_block.bell"
join-quit:
default:
join: "&8[&a+&8] &c❄ &7{player}"
quit: "&8[&c-&8] &c❄ &7{player}"
From December 20th to January 6th (included) every player gets the Christmas welcome with its title and bell sound, and the join / quit line of the default format gets a red snowflake. On January 7th the normal welcome is back.
| Option | |
|---|---|
enabled | false = off, without deleting it |
from / to | first and last day (both included). "12-20" = month-day, every year; it can go over the new year ("12-20" to "01-06"). "2026-12-20" = only that year (a one-time event) |
welcome | replaces the welcome of welcome.yml. Same keys as every message. Missing = the normal welcome |
first-join | replaces the message to the new player (welcome.yml > first-join.player), commands included |
join-quit | join / quit line by format id of welcome.yml (default, vip...). A format not written here keeps its normal line. The format's sound stays the same |
only-holiday-announcements | true = while active only the announcements of this holiday rotate (see below) |
- Only one holiday is active at a time: the first one in the file whose dates include today.
- Dates use the
timezoneofconfig.yml(empty = the server's time zone). - A wrong date is written in the console when the plugin starts (e.g.
"12-32") and that holiday is skipped.
Holiday announcements
In announcements.yml, holiday: <id> makes an announcement rotate only while that holiday is active:
announcements:
christmas-sale:
holiday: christmas
chat:
lines:
- ""
- "<center><gradient:#EB5757:#FFFFFF><bold>CHRISTMAS SALE</bold></gradient>"
- "<center>&7Everything -20% in the store until January 6th!"
- ""
With only-holiday-announcements: true the normal announcements wait until the holiday ends, so players only see the Christmas ones. /fmes announce christmas-sale always works, also outside the dates.
Testing before the day
| Command | |
|---|---|
/fmes holiday | every holiday with its dates, and the one active now |
/fmes holiday force christmas | makes it active now (only for testing, until /fmes holiday auto or a restart). Then /fmes preview welcome and /fmes preview join show the Christmas messages |
/fmes holiday force none | no holiday now, whatever the date |
/fmes holiday auto | back to the dates |
All of them need flaremessages.admin.
Placeholder
{holiday} (and %flaremessages_holiday% for other plugins) = id of the active holiday, empty when there is none. E.g. a scoreboard line that shows christmas only during Christmas.
Updating from 1.0.x
holidays.yml is created on the first start with the Christmas and Halloween examples. On a server that already used FlareMessages they are created turned off (enabled: false), so nothing changes until you want it: write your texts, set enabled: true, then /fmes reload. On a new server they are on.
Ultimo aggiornamento: