Courier: Minecraft Mail Plugin with Postmen and Letters

Bringing Postal Service to Your Minecraft Server with Courier Minecraft thrives on community interaction, but what happens when your friend logs off just as you need to send an important message? Vanilla Minecraft offers no built-in mail system, leaving players to scribble signs or rely on third-...

Download Courier.v0.9.0

Original name: Courier.v0.9.0

FileVersionLoaderSize
Courier.v0.9.0.zip——25 КБDownload
Courier.jar——28 КБDownload
Courier.jar——28 КБDownload

Bringing Postal Service to Your Minecraft Server with Courier

Minecraft thrives on community interaction, but what happens when your friend logs off just as you need to send an important message? Vanilla Minecraft offers no built-in mail system, leaving players to scribble signs or rely on third-party chat. That’s where Courier steps in — a brilliant Bukkit plugin that introduces a fully immersive, player-to-player mail service. Instead of a sterile chat command, Courier creates physical letters you can hold, store in chests, frame on walls, and have delivered by an actual postman mob. It feels like a natural part of the Minecraft world, not an add-on.

How Courier Delivers the Mail

Courier’s core loop is simple: you write a letter, address it, and a postman eventually tracks down the recipient. The plugin uses Minecraft’s map item to render text, so letters are readable in-game without any external interface. Here’s the basic workflow:

  • Create a letter with /letter [text]. Hold the letter and repeat the command to add more text. Use &nl or \n for line breaks. Multiple pages are supported — right-click and left-click turn the page.
  • Send it using /post [playername]. The recipient’s name is verified against the server player list. If privacy is enabled (default), the letter becomes sealed and only the intended player can read it — unless someone overrides that permission.
  • Receive mail when a postman appears. Poke or right-click the friendly courier to grab the letter directly into your hands or inventory. The postman despawns after a configurable time or after delivering the mail.

Letters are real items. You can drop them, store them in chests, put them in item frames to create public posters, or even lose them. Courier remembers whether a letter has been delivered and whether it has been read, so if you misplace an unread letter, /courier unread requests a fresh delivery.

Commands and Permissions at a Glance

Getting Courier running on your server requires setting up permissions for your player groups. The plugin uses Superperms, so any compatible permissions plugin will work. Here’s a breakdown of the essential commands and their associated permissions:

Player Commands

  • /letter [text] — creates or appends text to a letter (permission: courier.write)
  • /post [playername] — sends the held letter (permission: courier.send)
  • /courier fees — shows postal fees if economy is enabled (permission: courier.info)
  • /courier unread — requests re-delivery of unread mail (permission: courier.info)

Admin & Special Commands

  • /postman — forces a postman to appear (intended for OPs, not regular gameplay)

Permissions Overview

  • courier.write — create letters (default: op)
  • courier.send — send letters (default: op)
  • courier.list — see name suggestions when sending (default: op)
  • courier.info — view command help, fees, and re-delivery (default: true)
  • courier.theonepercent — bypass fees when economy is active (default: false)
  • courier.privacyoverride — read privacy-locked letters (default: false)
  • courier.useitemframes — put letters into item frames (default: true)

Setting these up correctly lets you tailor the mail system to your server’s style — from a completely open public bulletin board to a secure, fee-based private courier network.

Deep Configuration: Making Courier Your Own

Courier’s config.yml is packed with options that let you tweak everything from delivery timing to the postman’s appearance. Here are some of the most impactful settings:

  • Privacy.SealedEnvelope — determines if posted letters are locked to the recipient (default: true). Turning this off makes all mail readable by anyone who picks it up.
  • UseFees & Fee.Send — enable economy support via Vault and set the cost per letter. Fees are deposited into a bank or player account you specify.
  • Route.NextRoute — maximum time between delivery rounds (default: 60 seconds). A lower value means faster delivery but more frequent postman spawns.
  • Postman.Type — choose between Enderman or Villager. Endermen ignore the WalkToPlayer setting and simply appear, while villagers can stroll up to the player if Route.WalkToPlayer is true (note: this feature is currently non-functional due to Minecraft changes).
  • Letter.Resources — if Letter.FreeLetter is false, you can require crafting materials (default: [Coal, Paper]). Letter.RequiresCrafting forces players to manually craft letters instead of just deducting resources.
  • Letter.Frameable — allows letters to be placed in item frames, turning them into posters or flyers visible to anyone passing by.

Many user-facing strings are also editable, and translated configs exist in the plugin’s data folder. Simply move and rename them to config.yml to switch languages. While Courier is a server-side plugin, managing your server’s mods and configurations is a breeze with the foxygame.net launcher, which lets you download and install plugins directly from its intuitive menu — perfect for keeping everything up to date without digging through file systems.

Economy Integration and Item Frames

If your server runs an economy plugin like EssentialsX, Courier’s Vault support lets you charge players for sending mail. The Fee.Send amount is withdrawn from the sender, and you can even designate a bank account to collect the fees. Players with courier.theonepercent permission can send mail for free, which is handy for donors or staff.

Item frame support is a standout feature. When a letter is placed in a frame, it acts like a public notice. Anyone can read it by right-clicking the frame, and the text renders beautifully on the map surface. This turns your spawn area into a living message board without any extra plugins. The permission courier.useitemframes controls who can place letters in frames.

Technical Trivia and Known Quirks

Courier uses a clever trick to render text on maps: the map’s X coordinate is always set to 2147087904 (or INT_MAX - 395743), and the item stack is enchanted with DURABILITY where the enchantment level serves as a database key. This means other plugins can safely identify Courier letters and avoid conflicts. However, there are a few known issues to keep in mind:

  • Moving letters between slots in creative mode may cause them to become empty after relogging — a Bukkit limitation.
  • Extended character sets are not supported because Bukkit maps only use the standard Minecraft font. Courier will skip such input when writing letters.
  • The Route.WalkToPlayer feature is currently broken due to Minecraft changes; postmen will simply appear rather than walk.

The plugin is looking for a new maintainer, as the original author no longer plays Minecraft. The update to Minecraft 1.8 was made possible by a community pull request, so while the core functionality remains solid, don’t expect rapid new features unless a maintainer steps up.

Why Courier Belongs on Your Server

Courier transforms communication from a dry chat command into a tangible, immersive experience. Letters become keepsakes, postmen add life to your world, and the whole system feels like it belongs in Minecraft. Whether you run a roleplay server, a survival community, or just want a fun way to leave messages for offline friends, Courier delivers — literally. The configurable privacy, fees, and crafting requirements give you full control over how mail works, while item frame posters open up creative possibilities. If you’ve ever wished Minecraft had a built-in postal service, Courier is the plugin that makes it happen.