From da34f05ea0c32d2cd995aa07eebec75eb431857c Mon Sep 17 00:00:00 2001 From: Ryan Barlow <7389646+ryanbarlow97@users.noreply.github.com> Date: Sat, 17 Oct 2026 11:20:10 +0000 Subject: [PATCH 1/2] docs: explain pending mail for full inventories --- projects/BirdMessenger/overview.md | 11 +++++++++-- 1 file changed, 9 insertions(+), 2 deletions(-) diff --git a/projects/BirdMessenger/overview.md b/projects/BirdMessenger/overview.md index a0daa9f..62a3301 100644 --- a/projects/BirdMessenger/overview.md +++ b/projects/BirdMessenger/overview.md @@ -55,8 +55,11 @@ tick between the edit and the save. In-flight mail belongs to the recipient character and survives character changes. Delivery needs the stored owner to be playing the stored character. Pending -letters are handed over one at a time, checking the character before each; a -switch part-way leaves the rest queued, and the file is saved once afterwards. +letters also need an empty inventory slot. A letter arriving at a full inventory +waits in saved pending mail, and BirdMessenger retries online recipients every +second. Pending letters, including unsent and estate returns, are handed over one +at a time, checking the character and space before each; filling the last slot or +switching characters leaves the rest queued, and the file is saved once afterwards. Character IDs match regardless of letter case and are kept as written. Malformed IDs and mail for another owner stay in the file and are not delivered to the current character. @@ -148,5 +151,9 @@ Before deployment, verify on a test server with ItemsAdder: the `unsent-returned` message when that character is next played. - Receive several pending letters, switching during delivery: remaining letters wait until their stored owner plays their stored character. +- Receive a letter with a full inventory: it stays in pending mail without a + ground drop. Free a slot: it arrives once within a second. With several waiting + letters and one free slot, the rest keep waiting. Repeat across a restart and + with unsent and estate-returned letters. - Restart with pending and in-flight mail: delivery resumes without changing recipient opt-out behaviour or stored character IDs. From df33eaed75c43f037a8f4c4adc9bbaed1637b849 Mon Sep 17 00:00:00 2001 From: Ryan Barlow <7389646+ryanbarlow97@users.noreply.github.com> Date: Sat, 17 Oct 2026 11:37:58 +0000 Subject: [PATCH 2/2] docs: clarify complete letter stack capacity checks --- projects/BirdMessenger/overview.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/projects/BirdMessenger/overview.md b/projects/BirdMessenger/overview.md index 62a3301..ca60e0b 100644 --- a/projects/BirdMessenger/overview.md +++ b/projects/BirdMessenger/overview.md @@ -55,11 +55,11 @@ tick between the edit and the save. In-flight mail belongs to the recipient character and survives character changes. Delivery needs the stored owner to be playing the stored character. Pending -letters also need an empty inventory slot. A letter arriving at a full inventory -waits in saved pending mail, and BirdMessenger retries online recipients every +letters also need enough storage space for their complete item stack. A letter +arriving at a full inventory waits in saved pending mail, and BirdMessenger retries online recipients every second. Pending letters, including unsent and estate returns, are handed over one -at a time, checking the character and space before each; filling the last slot or -switching characters leaves the rest queued, and the file is saved once afterwards. +at a time, checking the character and space before each; filling the available +space or switching characters leaves the rest queued, and the file is saved once afterwards. Character IDs match regardless of letter case and are kept as written. Malformed IDs and mail for another owner stay in the file and are not delivered to the current character.