RealMotd is advanced MOTD plugin. It offers you big amount of variables to use in MOTD, different MOTD every day, permission checking in motd and colors in MOTD.

motd example image


  • Many many variables to use in MOTD
  • Colorful MOTD
  • Also /motd
  • Group-specific MOTD
  • World-specific MOTD
  • 3 Modes: Single(only one MOTD within selected context), Daily(some days have special messages), Random(everytime player logs in choose something else)
  • Checking whether player has permission in MOTD.
  • Itallics,Bold,Underline, Strike & Rainbow!


This plugin offers you big amount of variables, so here you go!(please let me know if I forgot something)

  • %player% - Name of player who has joined
  • %nick% - Name of player who has joined. This may be colorful, contain prefix & suffix. Also, it's changeable.
  • %world% - Name of world player has joined to
  • %time% - Time in player's world.(0-24000)
  • %weather% - Weather in world (rain or clear)
  • %ip% - Player's IP
  • %playerlist% - Online players
  • %d% - Day of month in real life
  • %mo% - Month
  • %yr% - Year
  • %h% - Hour
  • %mi% - Minute
  • %s% - Second
  • %exp% - Experience
  • %lev% - Level
  • %totalexp% - Total experience
  • %food% - Player's food level
  • %x% - Player's X coordinate
  • %y% - Player's Y coordinate
  • %z% - Player's Z coordinate
  • %op% - Whether the player is an OP
  • %mode% - Game mode of the player
  • ^example.example - Checks whether the player has permission example.example . The character ^ can be changed to something else.
  • /n - New line in MOTD.
  • %whitelist% - Whitelisted players
  • %banlist% - Banned players
  • %timestat% - Status of time (day | night)
  • %allowednether% - Whether there is a nether enabled on this server (true | false)
  • %allowflight% - Whether there is flight allowed (true | false)
  • %serverip% - IP address of the server
  • %serverport% - Port the server is listening on
  • %serverid% - ID of the server (random number used for authentification)
  • %env% - Environment type of the world where player is
  • %nplayersonline% - Online players count
  • %nmaxplayers% - Maximal count of players on the server
  • %ptime% - Player's time (may be different from world's time)
  • %ptimestat% - Same as timestat, but with player's time
  • %worlds% - Worlds which this server is currently running
  • %plugins% - Plugins running on this server
  • %day% - Minecraft day


Commands can be used to set MOTD in-game. It's good for quick changing, but you're limited to 80 chars. Use /motd set <motd> to set default motd and /motd set <month> <day> <motd> to set a day-specific motd. While setting motd in-game, use /n for newline and colors stay the same.


This plugin generates configuration file after its first run.

Configuration Nodes - Translation for weather clear - Translation for raining
transl.mode.creative - Translation for creative mode
transl.mode.survival - Translation for survival mode - Translation for OP
transl.op.isnt - Translation for regular player
transl.permission.has - Translation for has permission
transl.permission.hasnt - Translation for hasn't permission - Translation for day
transl.time.night - Translation for night
transl.env.nether - Translation for nether - Translation for skylands
transl.env.normal - Translation for regular world
transl.flight.allowed - Translation for flight allowed
transl.flight.denied - Translation for flight denied
permission - The character which identifies, that the text next to it is permission verification
motd.mode - Mode of motd. Must be one of these: Daily, Random, Single

Setting up MOTD

Setting up motd is very easy. Go to <your server's folder>/plugins/RealMotd where you find folder "messages".

  • Daily mode - Different MOTD for special days. You need to create a new text file called: motd_[month]_[day].txt ,where you write your motd. For example, for 26th September, it'd be "motd_9_26.txt". You don't need to create MOTD files for every day. Only for those special ones. If RealMotd can't find such-named file, it displays the default file.
  • Random mode - Random mode each time user logs in You need to create how much of txt files you like. Files don't even have to end with .TXT. This mode chooses random file from messages directory as MOTD.
  • Single mode - One MOTD forever. Always chooses motd.txt from folder messages.

If you're confused, look at the example configuration file below

Example configuration file Clear Raining
transl.mode.creative: Creative
transl.mode.survival: Survival Operator
transl.op.isnt: Player
transl.permission.has: can
transl.permission.hasnt: can't
permission: ^ Day
transl.time.night: Night
transl.env.nether: Nether Skylands
transl.env.normal: Overworld
transl.flight.allowed: can
transl.flight.denied: can't
mode: single

How do I use the configuration file like that???

There are lots of options how to make MOTD as you wish. This example configuration file can be used as following: [plugins/RealMotd/messages/motd.txt]

Hello %op% %player%!
You ^can.mine mine blocks and ^ build.
You ^ fly.
Time of server is %time%. That's %timestat%.
It's %weather%.

Look at the result MOTD. I've attached two of them, so you can see which parts of MOTD are changing. The result MOTD for code like that would look like this:

Hello Player Tomsik68!
You can't mine blocks and can't build.
You can't fly.
Time of server is 13536. That's night.
It's Clear.

or this:

Hello Operator Tomsik68!
You can mine blocks and can build.
You can fly.
Time of server is 1353. That's day.
It's Raining.


There are more ways of using colors in RealMotd. You can choose which one you want to use using configuration file. For more information about colors, please look here.

If you need more complex MOTD example even with formatting and colors, go here


So you don't have enough? RealMotd API is big, so there are some plugins that are using it. Here's a list of such plugins:

  • RealMotd-Messages - Implementation of Join & Leave message using RealMotd variables, colors & formatting!
  • RealMotd-ServerList - Server list message(a.k.a. MOTD) using RealMotd power!


  • Import groups from permission plugins

Developers' API

It's available at

This help is not complete

As this plugin is very customisable, you can try to figure out some trick with configuration, variables or colors. And if you don't know how to do something with this plugin, send me a PM, or email me at [email protected] . I like to help! Thanks and Enjoy!

Have a problem? Take a ticket!

If you wanna submit a bug, please take a ticket, so we avoid comments section mess ;)

Contact Author

If you wish to contact author somewhere else, you can do so on:

  • Blog:
  • Twitter:
  • E-Mail: [email protected]
  • GitHub: (also, sources of all plugins!)
  • Skype: Tomsik68

You must login to post a comment. Don't have an account? Register to get one!

  • Avatar of Kino876 Kino876 Jul 01, 2014 at 14:48 UTC - 0 likes

    @tomsik68: Go

    I didn't have anything in my config.yml of decorators, I just delete and reload the plugin to get the default config and now everything works fine.

    Thank you tomsik68.

  • Avatar of tomsik68 tomsik68 Jun 30, 2014 at 06:25 UTC - 0 likes

    @MuffMiff: Go

    So if I understood correctly, you want to have random MOTD each time user logs in, right? To achieve this, set your config file like this:

      mode: random

    Now go to plugins/RealMotd/messages and create several TXT files in that folder. These TXTs will be all MOTDs and plugin will choose a random MOTD each time.


  • Avatar of MuffMiff MuffMiff Jun 30, 2014 at 02:40 UTC - 0 likes

    I can't seem to make the random mode work. Please help :c

  • Avatar of tomsik68 tomsik68 Jun 29, 2014 at 11:49 UTC - 0 likes

    @Kino876: Go

    Open your config file(plugins/RealMotd/config.yml) and look for section "decorators". If it's there, replace it by this:

    - color_names
    - custom_formatting
    - rainbow

    If it's not there, add it to your config file(copy-paste from above).

  • Avatar of Kino876 Kino876 Jun 28, 2014 at 16:56 UTC - 0 likes

    From 0.9b to 0.9.1.

    Yes, a big jump but was working fine in months and in all previous versions of CB/Spigot and did not need to update, I've actually gone back to 0.9b and works fine again.

    The text show the color code, I mean, you write "Hello &greenPlayer" and you will see all the text in white including the color code, exactly as you wrote it in the motd.txt.

  • Avatar of tomsik68 tomsik68 Jun 27, 2014 at 21:16 UTC - 0 likes

    @Kino876: Go

    Which version did you update from? Which version did you update to? :)

  • Avatar of Kino876 Kino876 Jun 27, 2014 at 16:19 UTC - 0 likes

    Hi, after updating, the colors don't show well, maybe a bug?...

  • Avatar of tomsik68 tomsik68 Jun 26, 2014 at 07:19 UTC - 0 likes

    @EddieFriday: Go

    RealMotd currently only displays MOTD when player joins game, but I'll add this feature as it's really quick :)

    Configuration: 1. Set up your motd.mode in config file (plugins/RealMotd/config.yml) to Single 2. Set "" to true in config file. 3. Now create file plugins/RealMotd/messages/world1/motd.txt (this is MOTD for world1) 4. Create file plugins/RealMotd/messages/world2/motd.txt (this is MOTD for world2)

  • Avatar of EddieFriday EddieFriday Jun 24, 2014 at 13:59 UTC - 0 likes

    How can I make MOTD per world. The configuration is somewhat hard to understand.

    I want players to see MOTD for each specific Worlds like:

    World1 - has its own motd world2 - has its own motd

    So everytime the switch from world to world they see MOTD for that specific world.

  • Avatar of TruDan97 TruDan97 Mar 24, 2014 at 16:40 UTC - 0 likes

    @tomsik68: Go

    That's not impossible. I'll upload the latest one and see if its still there.

    Edit: Yep that fixed it, thanks. :)

    Last edited Mar 24, 2014 by TruDan97

    Like my plugins? Donate via PayPal!