How to use LRMSB

Please login to contribute to the conversation.
Ahoy-hoy good people of Donut Team, I wanted to type out this tutorial for people that seem to be confused how Lucas' RadMusic Script Builder works.
This tool can do the following two things:
  • Convert (.rms) files to XML format
  • Convert (.xml) files back to RMS
This tutorial will tell you how to do both, so let's begin!

Converting RMS to XML:
This is pretty simple. All you need is to put LRMSB.exe & your (.rms) file in the same directory then drag it into the executable. This should output an editable XML file with the same name.

Converting XML to RMS:
This part is a bit tricky. You need to make a batch script (.bat) file & run the command below or download this script & put it in the same file.
start "" "%~dp0\LRMSB.exe" -inputxml "%~dp0\MyFile.xml" -outputrms "%~dp0\MyFile.rms" -rsdpath "%~dp0\"
Make sure to change "MyFile" to whatever the name of your file(s) is.

Upon running, you might run into some errors:
  • Redundant {Attribute} attribute specificed on RSDFile found in "file.rsd" on line n of "PATH TO XML FILE".
    • This means some attribute is wrong with your RSDFile element in the xml file.
    • n represents a number.
  • Could not find attribute {Attribute} for RSDFile "file.rsd" that isn't present in any specified RSD path on line n of "PATH TO XML FILE".
    • This means the attribute mentioned above is invalid or not present in your RSDFile OR your file does not exist.
    • n represents a number.
  • Could not find RSDFile with name "{Name}" referenced on line n of "PATH TO XML FILE".
    • This means the rsd file mentioned above is invalid or not present in your directory.
    • n represents a number.
  • Could not find {Element} with name "{Name}" referenced on line n of "PATH TO XML FILE".
    • This means the element mentioned above is not an element of your file.
    • n represents a number.
  • Invalid floating point value "{Value}" for attribute {Attribute} on line n of "PATH TO XML FILE".
    • This means the attribute mentioned above has an invalid float (number) value or the value is not a number.
    • n represents a number.
  • Invalid boolean value "{Value}" for attribute {Attribute} on line n of "PATH TO XML FILE".
    • This means the attribute mentioned above is neither true or false.
    • n represents a number..
  • Invalid unsigned 32-bit integer value "{Value}" for attribute {Attribute} on line n of "PATH TO XML FILE".
    • This means the attribute mentioned above has an invalid integer value or the value is not an integer.
    • n represents a number.
    • A 32-bit integer ranges from -2147483648 to 2147483647 (inclusive). Anything outside is invalid.
  • Invalid region resume type value "{Value}" for attribute {Attribute} on line n of "PATH TO XML FILE".
    • This means the attribute mentioned above has an invalid region resume type.
    • n represents a number.
    • The following list contains the only valid values for this attribute:
      • Resume
      • Restart
  • The '{Element1}' start tag on line i position j does not match the end tag of '{Element2}'. Line n, position m. "PATH TO XML FILE".
    • You probably added a closing tag to an element that does not exist.
    • i, j, n and m represent numbers.
  • Unexpected end of file has occured. The following elements are not closed: {Elements1, Element2, ..., Elementi}. Line n, position m. "PATH TO XML FILE".
    • You probably forgot to close one of the elements mentioned above. Go back & check your file and close them.
    • {Elements1, Element2, ..., Elementi} represents an inductive sequence, depending on how many elements you have.
    • n and m represent numbers.
  • System does not support 'i' encoding. Line n, position m. "PATH TO XML FILE".
    • You probably changed the encoding. You shouldn't do that.
    • i is any invalid encoding, use "utf-8".
    • n and m represent numbers.
If you have any concerns, questions or there are any errors I might've missed, please let me know in the replies!
I suggest you check out @Colou 's tutorial on adding custom music if you have any technical problems with your sounds or don't understand what you're doing with them.