Weave 3.3w: 2/10/2025
After some working-through of the different options, it seems to me the following additions made Weave development easier and faster without making learning Weave materially more complicated. They are as follows:

• New Command: #FGPLAY (special case of #PLAY)
  • The #PLAY command will add notes to the sound queue until the queue reaches 255 notes in length, but will not feed back that it has reached the limit in any meaningful way.
    • This leads to confusion and the need to add many /i movement commands to get songs longer than 255 notes to play correctly.
  • The #FGPLAY command will instead add notes to the sound queue only if the sound queue will be empty before the object executes its next tick. Otherwise, it will wait and attempt the operation again, similar to what /n does when an object is blocked to the north.
    • In this way, long songs can be played without the need for brittle and frustrating workarounds.
      
• New Command: #SOUT (alternative to #XOUT)
  • The #XOUT command adds board data to the object buffer in the form of #PUT commands. These can then be written to file with #OUT <filename>.
  • The #SOUT command adds counter data to the object buffer in the form of #SET commands. These can then be written to file with #OUT <filename>.
  • #XOUT and #SOUT commands can be combined in the same file.
    
• Clarified Functionality: sidebar.#.counter = [Element,"Display:"]
  • Counter displays in the sidebar are a maximum of 8 characters long to accommodate displaying the number to its right and the element to its left.
  • Before, if the counter was longer than 8 characters, sidebar.#.counter would display nothing and give no explanation.
  • Instead, now Weave will attempt to display the sidebar element up to a length of 20 characters, though it will not display the element and number if there is no room.

The Weave Manual and WEAVEDMO have been updated to incorporate these additions. Hope you find them useful.