A player to player mail system for Bukkit Minecraft servers

by defxor

Allows creation of text note items and sending of letters to players no matter if they're online or offline. The letters are delivered by postmen at intervals specified in the config file, and letters can be stored and handled as any other item for later reading. We wanted something that not only allowed us to pass notes to each other, but also felt like it was part of the regular Minecraft environment.

We believe we succeeded.

- - -=< Latest version >=-=< Videos >=-=< Tickets >=-=< Forum >=-=< Source >=- - -

Courier in-game screenshot Framed Letter


/letter [text]
Creates a Courier Letter with the supplied text. Hold the Letter in your hands and write /letter [text] again to add more text to the Letter. Use &nl or \n to insert newlines. Multiple page Letters are supported, use right-click and left-click to turn the page.
/post [playername]
Sends the Letter held in your hands to another player, name verified to be a player on the server. Depending on the config, the received Letter will be privacy-locked to that player (can be unlocked by simply adding text to it with /letter).
/courier fees
Lists the fees, if any, that apply for sending mail or creating letters
/courier unread
Requests re-delivery of all unread mail, even if they have been delivered to you before. Courier knows the difference between a mail having been delivered and actually read, and this is meant to be used in the cases where you've managed to misplace the Letter without having read it first.
Intended for OPs only, if postman delivery happens seldom and you want to force one to appear. NOT NEEDED in actual gameplay.

To receive messages, simply poke the friendly postman when he appears or right-click him to receive the message directly into your hands or inventory.

The strings "%loc" and "%pos" will be replaced with the current X,Y,Z position in any Letters written, if surrounded by spaces.


Quick version: Give your players courier.write, courier.send and courier.list

Long version:

Allows players to create Letters (default: op)
Allows players to send Letters to other players (default: op)
Allow players to see name suggestions if there's more than one match when sending (default: op)
Allows seeing command help, fee structure and requesting of re-delivery (default: true)
Allows posting of mail even if you have no credits and Economy support has been activated (default: false)
Allows the player to read privacy locked Letters (default: false)
Allows the player to put Letters into ItemFrames (default: true)

(For anything but the defaults a Superperms compatible permissions plugin needs to be installed)

Configuration options

Whether Letters that have been Posted to another player should only be possible to read by that player. If you want to change this option, please read this forum thread. (default: true)
Whether Courier should activate and require Economy support through Vault. (default: false)
The postal fee withdrawn from the player if UseFees is set to true (default: 10)
The Bank or Player account fees will be deposited into (default: none)
The interval between checks towards to see if there's a new version of Courier available. A value of 0 disables. (default: 18000 seconds)
How long will Courier wait until sending out the first postman after players have started joining the server (default: 10 seconds)
How long between rounds. This is the maximum amount of time a delivery can take between two online players (default: 60 seconds)
Currently not functioning due to changes in Minecraft. If friendly postmen (Villager) should walk up to players or not. Unfriendly mobs (Enderman) ignore this setting and never do. (default: true)
Which Minecraft Creature to use as Postman. Courier will accept all valid Creatures but only 'Enderman' and 'Villager' are supported. (default: 'Enderman'). Note: This setting is case sensitive! 'villager' does not work, 'Villager' does.
How quickly will a postman despawn after having taken damage or delivered the mail (default: 3 seconds)
For how long will a postman stay around each round waiting for the player to take his mail (default: 20 seconds)
What's the maximum line of sight distance a postman will spawn in front of a player (default: 10 blocks)
Whether Courier should try to override mobspawn protection in order to spawn its Postman (default: true)
The distance a Postman will check to see if a vanished player would be betrayed by appearing within (default: 20 blocks square)
Whether Postmen should deliver mail to Players who are in Creative mode (default: true)
Whether to display the date a Letter was sent or not (default: true)
If players should receive free Letters or if they need to have the necessary resources (default: true)
List of resources needed if FreeLetter is set to false. Example: [CobbleStone, Paper, CobbleStone] (default: [Coal, Paper])
Whether Courier should just deduct the resources or if players need to manually craft letters (default: false)
Should it be possible to put Courier Letters into ItemFrames - in effect creating posters/flyers (default: true)

In addition to the above all user visible strings can be edited. Some translated configs are available in the translations folder as well in the plugin data folder. Move and rename them to 'config.yml' to use.


As you've understood (and seen if you've looked at the in-game images) I use Maps to render Courier Letters. If you're a plugin developer and your plugin handles maps and you either want to make sure your map system isn't screwed up by Courier Letters, or maybe if you want to handle Courier Letters in a special way, you can easily identify them:

The actual Maps used by Courier to render Letters ALWAYS have their X coordinate set to 2147087904 (or INT_MAX - 395743, if you want).

The ItemStacks(Material.MAP) that point to those Maps are Enchanted with DURABILITY and the enchantment level is used as a database key to find the matching text.

Release history

(see the Changelog for detailed information)

Known issues

  • Moving Letters between slots in creative mode (/gamemode 1) causes them to become empty later (eg. after logout/login)
    • This seems to be a Bukkit issue, please do not handle Courier Letters in creative mode until this is better understood.
  • Courier does not support extended character sets, it will skip such input when writing Letters.
    • This is due to Bukkit Maps only supporting the 'old' standard Minecraft Font. If support is extended in Bukkit I will implement it into Courier as well.
  • ... and all open tickets and issues, of course.

Future development

(Not to be taken as promises!)

  • Usually the roadmap for the next version is available on the forum.
  • Allow items to be attached to mails
  • /courier list (will list offline players as well as online)
  • ... and all accepted enhancements.


I made this plugin for our own use at a private server. If you like it, and feel you want to show appreciation other than just posting a message, you can throw some bitcoins at this address: 1GA8XDDwxeSvHAbuySY9TnnBXNMqriEYcP

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

  • Avatar of chsedv chsedv Apr 19, 2014 at 21:32 UTC - 0 likes

    Pls update to bukkit 1.7.9

  • Avatar of PackerbackrGJ85 PackerbackrGJ85 Apr 09, 2014 at 15:13 UTC - 1 like

    @defxor: Go

    I'd like to test the beta version too. We've used your plugin on our server a long time and don't want to see it go away.

  • Avatar of defxor defxor Apr 05, 2014 at 21:10 UTC - 0 likes

    @MGbeenieboy: Go

    That error has been reported before - also on Spigot I believe. I _think_ it's a Spigot issue, but the beta test version I'm still waiting for input on has a workaround implemented. I'll send you a link to it in PM.

    thanks, defxor

  • Avatar of MGbeenieboy MGbeenieboy Apr 05, 2014 at 13:16 UTC - 0 likes

    Should I be worried?

  • Avatar of defxor defxor Mar 23, 2014 at 10:09 UTC - 0 likes

    @chsedv: Go

    I just tested both the released Courier v1.1.9 as well as the beta with changed ItemFrame graphics (I still haven't gotten beta test feedback) and both seem to work fine during the brief test I did the the latest development build of Bukkit 1.7.5.

    If you still have issues, please make a bug report including logs etc in the Tickets-section above.

    thanks, defxor

  • Avatar of defxor defxor Mar 23, 2014 at 09:47 UTC - 0 likes

    @chsedv: Go

    Thanks for the heads up :) 1.7.5 is an early development build and I will keep track of any changes that might be needed when it migrates to beta (where the latest is 1.7.2) and then release (currently 1.6.4).

    As I've stated before - as long as there aren't any major changes I will keep Courier updated. I fully support anyone who wishes to fork it and continue development - the code is open, well documented and architectured.

  • Avatar of chsedv chsedv Mar 23, 2014 at 06:58 UTC - 0 likes

    dont work with Bukkit 1.7.5 ..... pls update

  • Avatar of chsedv chsedv Feb 25, 2014 at 06:23 UTC - 0 likes

    pls update to Spigot 1.7.4R04

  • Avatar of wslauson wslauson Feb 22, 2014 at 18:37 UTC - 0 likes

    I PMed the developer and he said there will no longer be any more updates to Courier unless it breaks with an update. If someone would like to continue the project by forking the source code and adding the feature requests (package sending, more formatting code support, etc.), it would be appreciated. Thanks.

  • Avatar of AesirOnline AesirOnline Jan 31, 2014 at 18:18 UTC - 0 likes

    @defxor: Go

    Hi there defxor good job with your work on Courier Plugin ! I'm actually facing the framed letters issue and i would like to BETA test the newest version to give you an insight.

    Hoping that you're doing alright. Take care. Isa.


Date created
Dec 23, 2011
Last update
Jan 16, 2013
Development stage
  • enUS
GNU General Public License version 2 (GPLv2)
Curse link
Recent files



Optional dependency