Messenger Pigeons

<h1 data-path-to-node="1">Messenger Pigeons - Make Your Mail Immersive~</h1> <h2 data-path-to-node="1">Description</h2> <p data-path-to-node="1">Messenger Pigeons introduces a reliable and immersive mail system to Vintage Story. Players can construct Pigeon Boxes, register them to a global directory, and send written messages to friends across the world.<br><br>(NOTE: This mod was created in support of the World of New Horizon's Vintage Story server, though all are welcome to use it. Check out WoNH here: <a href="https://vsnh.online/">https://vsnh.online/</a>. Also, credit to GiggaMouse for all his help testing and generating ideas!)</p> <h2 data-path-to-node="2">How It Works</h2> <ul> <li><strong>Place a Mailbox: </strong>Place down a Messenger Pigeon Mailbox to become its primary owner. The mailbox will face what ever direction you are facing.</li> <li><strong>Register the Mailbox:</strong> USe the "Register" tab to register a unique name for your box. Once you register a global name, other players can find it in their directory.</li> <li><strong>Add Co-Owners:</strong> USe the "Owners" tab to add or remove co-owners who can also access the box. Co-owners may add or remove other co-owners, but the primary owner can never be removed.</li> <li><strong>Send a Message:</strong> Simply hold a written parchment or envelopes, select a destination from the GUI interface, and dispatch your pigeon. <em>You must have the parchment or envelope selected in your hotbar!</em></li> <li><strong>Leave a Message:</strong> A non-owner may leave drop a message off in a mailbox by right-clicking it while holding a parchment or envelope in your hotbar.</li> <li><strong>Check the Inbox:</strong> When a mailbox you are an owner of receives a delivery, you will be notified in-game. Received items can be taken from the inbox.</li> </ul> <h2 data-path-to-node="3">Key Features</h2> <ul data-path-to-node="4"> <li> <p data-path-to-node="4,0,0"><strong>Distance Based Delivery:</strong> Pigeons take actual in-game time to deliver letters. Flight speed and minimum travel times can be adjusted in the mod configuration file.</p> </li> <li> <p data-path-to-node="4,1,0"><strong>Secure Ownership:</strong> The player who places the box is the permanent, primary owner. You can add or remove co-owners to share a mailbox with others, while non-owners can only drop off mail.</p> </li> <li> <p data-path-to-node="4,2,0"><strong>Global Registry and Favorites: </strong>The interface includes a searchable directory of all registered boxes. You can save frequent contacts to a favorites list that is unique to each physical mailbox you own.</p> </li> <li> <p data-path-to-node="4,3,0"><strong>Item Restrictions: </strong>Pigeons can only carry parchment and envelopes. Parcels can be sent if allowed in the configuration file.</p> </li> <li> <p data-path-to-node="4,4,0"><strong>Automatic Mail Recovery: </strong>If a mailbox is full when a pigeon arrives, the mail will drop nearby. The box will automatically vacuum up the dropped letters as soon as inventory space is cleared.</p> </li> <li> <p data-path-to-node="4,5,0"><strong>Admin Protections: </strong>Server administrators in creative mode can bypass ownership restrictions to rename, manage, or remove abandoned boxes.</p> </li> </ul> <h2 data-path-to-node="3">Compatability</h2> <p>This mod is compatable with the Envelopes mod: <a href="https://mods.vintagestory.at/envelopes">https://mods.vintagestory.at/envelopes</a>. This includes wax-sealed envelopes as well! <em>However, parcels</em> <em>are <span style="color: #000000;">not</span> able to be sent</em>.</p> <h2 data-path-to-node="3">Configuration</h2> <p>This mod allows your to change the following in your configuration file:</p> <ul> <li><strong>Blocks Per Game Hour:</strong> Defaulted to 1000.0 (blocks), and corresponds to how many blocks a pigeon will travel per <em>one in-game hour</em>.</li> <li><strong>Minimum Tavel Hours:</strong> Defaulted to 0.1 (in-game hours), and corresponds to the minimum number of hours a pigeon will take to deliver a message to a box, no matter how close.</li> </ul> <ul> <li><strong>Enable Arrival Notifications:</strong> Defaulted to 'true', and lets you control whether box owners are notified of a mail delivery in-game or not.</li> <li><strong>Allow Sending Parcels:</strong> Defaulted to "false", and lets you control whether players can send Parcels (from the Envelopes mod) using the Pigeon Box or not.</li></ul>