TMDevelopmentTinulica & Maiky

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
enabledfalse = off, without deleting it
from / tofirst 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)
welcomereplaces the welcome of welcome.yml. Same keys as every message. Missing = the normal welcome
first-joinreplaces the message to the new player (welcome.yml > first-join.player), commands included
join-quitjoin / 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-announcementstrue = 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 timezone of config.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 holidayevery holiday with its dates, and the one active now
/fmes holiday force christmasmakes 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 noneno holiday now, whatever the date
/fmes holiday autoback 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.

Last updated

Sign in

New here? Just enter your email: the account is created when you click the link. No password needed.

or

We send you a link that signs you in with one click. It works for new and existing accounts.

Sign in with a password instead

By continuing you accept the Terms & Conditions and the Privacy policy.

Staff: open “Sign in with a password instead” and type your username instead of the email. After the password we ask for your 2FA code.