Aviary Guide
The Aviary plugin allows players to send letters of any kind to a companion of choice. The letters are represented as In-Game messages, and players can now no longer send valid character messages across other platforms/mediums. Excepts do occur, such as raid bells or lore-determined messaging systems.
How does it work?
To begin using the aviary plugin, you must write a letter, or in this case, a note. Taking a piece of paper in hand, type in the command “/notes,” which will bring up various options to make a message colorful, copy, erase or sign the note in the chatbox.
Writing a letter without fancy lettering, you may skip over all the commands except “/notes write [text]”, where you input the message.
If you wish to see the other options detailed, a spoiler below will describe the “/notes help” command, as with giving a link to Unicode symbols.
Once you have a note/letter prepared, find a setup aviary located around settlements, nations or other hubs designated by ‘postal’ or ‘aviary.’ If you’re within the aviary’s radius, you can start with the plugin. With the note/letter in hand, type in “/aviary”. Currently, two options exist, “/aviary mail” & “/aviary send”. The former allows you to receive any mail sent to you, whereas the latter will enable you to send notes/letters you prepared prior.
Sending your letter is easy; type in “/aviary send [MC name]” with your designated note. Hitting enter at this point will bring a text in chat to click on the persona to send the note/letter off.
You may, instead of clicking the persona, type in the number allocated to the persona from the persona card if the player has multiple for quick sending, “/aviary send [MC name] #” in the case above, typing the number “######” will work.
There is more below if you care to read on success and how to prevent a bird below!
And you’re off! A bird will spawn at the aviary location and fly to your destination! Or attempt to; if obstructed, the bird will return to you with the note for you to send again.
If you see this prompt, try again or seek out a different aviary with proper exits to send your letters!
There are short-minute cooldowns to sending letters, which will prompt you with a message if doing so too quickly, so wait it out before sending more!
!! A gif below showcases uses the plugin !!
The last topic I wanted to discuss with the aviary system is the bird; the bird will spawn with one heart/HP. If struck with any mechanical tool/weapon, the bird will die and drop the note before reaching the destination point. You can pick up the letter and read any secrets it may contain, be aware; however, if you do this, you must correctly roleplay after taking down the bird.
The player who sent the message will be notified with:
You/anyone within the area of the shot down bird will be notified with:
You have about 30 seconds to shoot down the bird before it reaches the ‘destination’ where the bird will despawn, and the message successfully sent, so be quick!
The last thing I wanted to address is the rules relating to sending the bird in combat; if doing so, you must successfully emote three times of preparing the note/letter, getting the bird, and sending it off before mechanically sending the bird. The emotes must correspond with those in the combat encounter.
Thank you for reading the guide, and hopefully, it helps.
Citations:
Big thank you to @Jistuma who wrote the plugin!