CourierNew is a physical mail system for Spigot Minecraft servers that allows users to send letters in the form of books and receive them through couriers. Admins can use this to send letters to all players at once as a way of sending a message that people will be sure to see.
CourierNew is a built-from-scratch partial remake of an abandoned Bukkit plugin called Courier. This was written as a means to bring similar functionality of the original plugin to more modern versions of Minecraft, as well as improve on the logic behind it.
/letter <message>- Compose a new letter with the specified message. Minecraft color codes and \n linebreaks are allowed in the message. If holding a not-sent letter written by you, this command will append the specified message to the letter./post <player>- Send a letter to a specified player. You can list multiple players by separating their usernames with a comma. Use the command with only*to send to all online players, or**to send to all players who have ever joined the server./unread- Retrieve unread mail, if any./shred- Delete the letter in your hand./shredall- Delete all letters in your inventory./couriernew help- Show the help message./couriernew reload- Reload all configuration files.
- Spigot or Paper 1.14 - 1.18
- Java 8 or higher
- Download the latest release.
- Put the jar in your plugins folder.
- Start or restart your server.
After running for the first time, the default configs will be generated. The main configuration will look like this:
receive-delay: 100
resend-delay: 2400
remove-delay: 200
spawn-distance: 5
protected-courier: true
courier-entity-type: VILLAGER
blocked-gamemodes: []
blocked-worlds: []receive-delay- This is the delay, in ticks, for when a letter should be received. This is used on join, after sending, and after leaving a blocked world or gamemode.resend-delay- How long to wait, in ticks, before trying to resend a letter when the mail was not takenremove-delay- How long to wait, in ticks, after the courier spawns before removing itspawn-distance- How far away to spawn the courier from the player in blocksprotected-courier- This will determine whether other players can grab their mail from a courier that isn't theirs.blocked-gamemodes- Gamemodes that receiving mail isn't allowed in. (SURVIVAL, CREATIVE, ADVENTURE, SPECTATOR)blocked-worlds- Names of worlds that receiving is blocked in
For the message configuration, you can use color codes. You can also use the placeholder $PLAYER$ in messages that have it by default to replace it with player name(s). The messages and their names should explain what they are used for.
The third configuration file is actually used to store outgoing mail. Don't modify this file unless you know exactly what you are doing!
couriernew.letter- Allows players to write/edit letterscouriernew.post.one- Allows players to send letters to one player at a timecouriernew.post.multiple- Allows players to send letters to multiple players at a timecouriernew.post.allonline- Allows players to send letters to all online playerscouriernew.post.all- Allows players to send letters to all players who ever joined the servercouriernew.unread- Allows players to retrieve unread mailcouriernew.shred- Allows players to shred a lettercouriernew.shredall- Allows players to shred all in their inventorycouriernew.help- Allows players to use the help commandcouriernew.reload- Allows for reloading of configs
- Clone or download this repository.
- Run
./gradlew shadowJarin the directory of the project. /build/libs/CourierNew.jarshould have been generated.
You can also grab CourierNew.jar from the latest releases.
Courier not spawning?
- In the WorldGuard config, set
block-plugin-spawningto false. - Set
allow-npcsto true inserver.properties. - If you are using EssentialsProtect, make sure to not block villager spawning.
- Also check to make sure that no other plugins block mob spawning.
This project is no longer in development.