# Setup

### Config File

```yaml
# MultiMOTD - Allow MOTD per version.
# Created by Luxry Club @ 2025
# Find protocol numbers here: https://minecraft.wiki/w/Protocol_version
# Request a license key: https://luxry.club/discord

# Countdown format: %server_countdown_<SimpleDateFormat>_<time>%
# Example: %server_countdown_dd.MM.yyyy_01.01.2025% will show time remaining until January 1st, 2025
# You can also use different date formats like: %server_countdown_dd.MM.yyyy HH:mm_01.12.2025 12:00%
# Find more about the simple date format here: https://docs.oracle.com/javase/8/docs/api/java/text/SimpleDateFormat.html

LicenseKey: "none"
debug: false
motd:

  # 'minProtocol-maxProtocol': <FORMAT REQUIRED>
  #   first-line: 'first motd line' <REQUIRED>
  #   second-line: 'second motd line' <REQUIRED>
  #   favicon: 'favicon file in plugin path' [OPTIONAL]

  normal:
    '47-578': # From 1.8 to 1.15.2
      first-line: '&e&lSERVERNAME - LEGACY | {version}'
      second-line: '&ePvP Event starts in: &f%server_countdown_YY.MM.DD.hh.mm.ss_01.12.2025%'
      favicon: 'luxry.png'

    '735-769': # From 1.16 to 1.21.4
      first-line: '<b><gradient:#EF56B3:#FDADAD>ꜱᴇʀᴠᴇʀɴᴀᴍᴇ - ᴍᴏᴅᴇʀɴ | {version}</gradient></b>'
      second-line: '<gradient:#EF56B3:#FDADAD>ᴘᴠᴘ ᴇᴠᴇɴᴛ ꜱᴛᴀʀᴛꜱ ɪɴ: %server_countdown_YY.MM.DD.hh.mm.ss_01.12.2025.14.30%</gradient>'
      favicon: 'luxry.png'

    default: # Anything rather than registered above, DO NOT REMOVE IT
      first-line: '&c&lSERVERNAME'
      second-line: '&cRunning unsupported version!'

# Language section
messages:
  no-permission: '&cYou do not have permission to perform this command!'
  reloaded-plugin: '&eSuccessfully reloaded the plugin in {time}ms.'
  reload-failure: '&cFailed to reload config, please check console for details.'
  units:
    seconds: "s"
    minutes: "m"
    hours: "h"
    days: "d"
    months: "M"
    years: "y"
```

### How to Configure this plugin

To configure this plugin and add per-version MOTDs to your server, visit [this website](https://minecraft.wiki/w/Protocol_version) to find protocol numbers. After finding your protocol numbers, copy and paste the old MOTD examples or edit the current one. Set the minProtocol-maxProtocol and configure the first line, second line, and favicon. To add favicons, simply drag and drop your image into the plugin's folder.

### Formatting

You can use legacy color codes and MiniMessage format. You can create gradient colors, hex colors, and more! Please note: MiniMessage format will NOT work for legacy versions (1.8-1.13).

### Maintenance

How does this work? Simply turn on maintenance using the [Maintenance](https://hangar.papermc.io/kennytv/Maintenance) plugin by [kennytv](https://hangar.papermc.io/kennytv), and our plugin will prioritize displaying the MOTD.

### Countdown

To use this system is very simple: use our built-in placeholder, which can be customized according to your needs: `%server_countdown_YY.MM.DD.hh.mm.ss_01.12.2025%`. The format will be displayed as `0y, 10m, 2d, 4h, 59m, 25s`.

* `YY` represents years,
* `MM` represents months,
* `DD` represents days,
* `hh` represents hours,
* `mm` represents minutes,
* and `ss` represents seconds.

After the format, add a dash (`-`) and follow it with the date you want it to count down to. If you want to specify the exact time on that day, simply add the hour and minute after the year and date. For example: `%server_countdown_YY.MM.DD.hh.mm.ss_01.12.2025.19.00%`. Here, `19.00` corresponds to 7 PM. For more information, visit [this](https://docs.oracle.com/javase/8/docs/api/java/text/SimpleDateFormat.html) website or ask for assistance in our [Discord ](https://luxry.club/discord)server.

<figure><img src="/files/gLonkhD3KP0vzzDkNWgg" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.luxry.club/resources/multimotd/setup.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.