Music Box: Difference between revisions

From GMN Wiki
Jump to navigation Jump to search
No edit summary
Line 1: Line 1:
https://game-master.net/images/wiki/musicbox/musicbox1.png
https://game-master.net/images/wiki/musicbox/musicbox1.png


The Angel Island Music Box is a revolutionary new feature that has been hand crafted by Adam Ant for the enjoyment of AI players. With it, your character can listen to a variety of available music simply by issuing voice commands.  
The '''Music Box''' plays music in your home on voice command. It holds the shard's library of player compositions: free songs, songs you have bought, and your own. Composers publish their songs to it and are paid when players buy them.


Composers are also able to publish their works quickly and easily for other players to either listen to, sample or purchase.
__TOC__
 
<span style="color:#0096FF"> Players will find the music box easy to use as it includes all the features you would expect of a modern day, digital assistant controlled music player.


==General Usage==
==General Usage==
Buy a music box from any Bard NPC, lock it down in your home, and double-click it. It plays your whole playlist from start to finish, then stops. Double-click it again to stop it sooner.


To begin, you must purchase a music box from any Bard NPC vendor. After locking it down inside your home, double-click it.
Give your music box a name: single-click it and choose the rename option. You then speak to it by name, as you would to a smart speaker (its designer named his "Alexa"):
 
The music box will autoplay your entire playlist from start to finish before shutting down. You can double click the Music Box again to shut it off manually.
 
Start by naming your music box. Adam Ant named his Music Box "Alexa." (The similarity is is no accident by the way; the designer absolutely loves his Amazon Echo device and has patterned music box interactions after it.)
 
You can rename your music box by single clicking it and selecting the option from the context menu.
 
Afterwards, you can issue commands such as:
 
·       Alexa, play Douce Dame Jolie
 
·       Alex, next
 
·       Alexa, previous
 
·       Alexa, repeat


·       Alexa shuffle  
Alexa, play Douce Dame Jolie
Alexa, next
Alexa, previous
Alexa, repeat
Alexa, shuffle
Alexa, loop


·       Alexa loop
You never need a song's whole name: a few words of it are enough, and the music box works out which song you mean, using Angel Island's [[Intelligent Dialogue System]]. ''Alexa, help'' lists every command.


Etc.
To see what music is available, say ''list'':


To learn what music is available on your music box, you issue the list command:
Alexa, list
<br>
''Alexa list


https://game-master.net/images/wiki/musicbox/musicbox2.png
https://game-master.net/images/wiki/musicbox/musicbox2.png


The list of yellow titles are either free titles, titles you’ve purchased, or if you’re a composer, the titles you’ve contributed to the system.
Yellow titles are yours to play: free songs, songs you have bought, and songs you composed. Red titles are premium songs, which cost gold.


The red titles are premium titles, meaning they cost gold. (Good news for composers!)
To hear a premium song before buying it, ask the music box to play it:


To find out if you want to buy a premium track, you can issue the command:
Alexa, play strut
<br>
''Alexa, play strut


https://game-master.net/images/wiki/musicbox/musicbox3.png
https://game-master.net/images/wiki/musicbox/musicbox3.png


Your music box will then play a 10 second sample clip of the song. If you decide you would like to purchase it, you would issue the command:
It plays a 10-second sample. To buy the song:
<br>
 
''Alexa, buy strut
Alexa, buy strut


Your music box will walk you through the purchase process:
The music box walks you through the purchase:


https://game-master.net/images/wiki/musicbox/musicbox4.png
https://game-master.net/images/wiki/musicbox/musicbox4.png


If you assent to the purchase, the funds will be taken from your bank account (or shared account) and placed into the bank account of the composer, (in this case Pastor Wydstrin.)
When you agree, the price is taken from your bank (or your shared bank accounts) and paid into the composer's bank, here Pastor Wydstrin's. In this screenshot the player has named the music box ''Bach'', and asked for the song by part of its name.
 
You’ll notice a couple of interesting things here.
First, that Jack has named his music box Bach. Secondly, you never need to use the complete names of songs. The music box uses Angel Island's powerful [[Intelligent Dialogue System]] and can figure out what you mean even if you only use a partial "string" to match the song name.


https://game-master.net/images/wiki/musicbox/musicbox5.png
https://game-master.net/images/wiki/musicbox/musicbox5.png


After completing your purchase, the track is added to your music library (and playlist) and becomes available for immediate playback.
The song is now in your '''library''' and your '''playlist''', ready to play:
 
* Your library is every song you have access to.
Now you may be wondering, what is the difference between a music library and a playlist?
* Your playlist is the songs from your library that the music box plays. You might take the Christmas songs out of it in July. ''Remove'' takes a song out; ''add'' puts it back.
 
·       A music library is all of the songs you have access to.
 
·       The playlist is some subset of the songs from your music library. (I.e., you may want to exclude Christmas songs from your playlist it’s it’s the middle of July!)
 
If you now issue the command list again,


https://game-master.net/images/wiki/musicbox/musicbox6.png
https://game-master.net/images/wiki/musicbox/musicbox6.png


You’ll notice Dungeon Strut has been added to your library (and by default your playlist.)
==List of Commands==
Say the music box's name, then the command. Several commands have a second word that does the same thing.


There is more you can do as a player, but these are the basics.
{| class="wikitable"
! Say !! What it does
|-
| play ''song'' || Plays a song from your library, or a 10-second sample of one you don't own.
|-
| stop (or cancel) || Stops playing.
|-
| pause || Pauses.
|-
| resume (or continue) || Resumes after a pause.
|-
| what (or who) || Says the song and its composer.
|-
| next, previous || The next or previous song in your playlist.
|-
| repeat || Plays the last song again.
|-
| loop || Plays your playlist over and over.
|-
| shuffle || Shuffles your playlist.
|-
| list || Lists the songs.
|-
| new || Lists recently approved songs.
|-
| buy ''song'' || Buys a premium song.
|-
| remove ''song'' (or ignore) || Takes a song out of your playlist.
|-
| add ''song'' || Puts a removed song back.
|-
| refresh || Adds new free songs to your library. This also happens on its own.
|-
| purchases || The songs you have bought.
|-
| sales || Your sales as a composer (see [[#Getting Paid|Getting Paid]]).
|-
| submit || Publishes a song (see [[#Instructions for Composers|Instructions for Composers]]).
|-
| remaster || Asks to replace one of your approved songs with a new version.
|-
| rename || Renames the music box.
|-
| help || Lists the commands.
|}


==Instructions for Composers==
==Instructions for Composers==
The Music Box is how composers share and sell their work across the shard.


<span style="color:#0096FF"> Composers will find the music box an excellent way to both distribute and monetize their works.
# Write your song in a composition book and transcribe it into [[Sheet Music]]. Set its name and price at the top of the composition with # Song: and # Price: (a price of 0 makes it free). See [[Sheet Music#Settings|Settings]] for every setting.
 
# Single-click your music box and choose '''Add''', or say ''submit''. Target your sheet music.
Composers will author a text file (often a Razor script) that looks something like this:
 
https://game-master.net/images/wiki/musicbox/musicbox7.png
 
The first line is informational and ignored by the system. This is where you can attribute the work to the true author/composer.
 
The 2nd , 3rd, 4th, and 5th, lines are important as the instruct the music composition system during the creation of the output Rolled Up Sheet Music.
 
2nd Who is the author of this track. This is really informational. The payment system does not depend on this ‘name’, since it could be forged.
 
3rd Song name. Should be obvious.
 
4th Important. The music box can play any instrument (Harp, Lap harp, or Lute.) If you leave this blank, the music box will default to Harp.
 
5th Important. If you want to get paid, you need to set the price. A price of 0 (zero) means it’s a free track. Special note: If you delete the character that composed the track, i.e., the Owner/Author, then the price will automatically be set to (free).
 
Underneath the price line is finally the music itself. For specific information about entering this portion, see [[Music Composition]]. Once you understand how to compose music, you can transcribe it into [[Sheet Music]] which can then be added to the system.
 
You will need to single click the Music Box and select the Add context menu option. You will then be prompted to target the rolled-up sheet music.  
 
That’s it. Your composition is now entered into the system!


https://game-master.net/images/wiki/musicbox/musicbox8.png
https://game-master.net/images/wiki/musicbox/musicbox8.png
Line 111: Line 110:
https://game-master.net/images/wiki/musicbox/musicbox9.png
https://game-master.net/images/wiki/musicbox/musicbox9.png


After adding your song to the global repository, (at this point it has entered the shard-wide music system and not just your music box,) it will immediately be placed into a review queue.  
Your song is now in the shard-wide library, not just your own music box, and goes into a review queue. Staff review songs to keep out offensive content, not to judge their quality (songs can have lyrics). Once approved, it appears for every player: free songs in their libraries, premium songs as red titles they can sample and buy.


The review doesn’t so much judge the quality of the work, but is merely in place to protect players from nasty, defaming, and otherwise obnoxious works. (Remember our songs can have Lyrics!)
Each approved song earns you [[Music Composition#Music Karma|Music Karma]], and so does every sale and every play.


==List of Commands==
To publish a new version of an approved song, say ''remaster''.


<span style="color:#0096FF"> Command summary:  
The library is permanent and not tied to your account: once a song is in, it stays available to other players. If the character who composed a song is deleted, the song becomes free.


            Play,         <span style="color:#00FF00">  // request to play
===Napster Tracks===
A song transcribed with ''# Napster: True'' is passed hand to hand instead of sold. Anyone who has a copy of its sheet music can add it to their own music box, which gives them the song (the sheet is used up). Other players hear only a sample, and are told to get a copy from the composer.


            Stop,
===Getting Paid===
When a player buys your song, the price goes straight into your bank. Say ''sales'' to see your totals:


            Cancel = Stop, <span style="color:#00FF00"> // stops playback (RazorInstrument stops)
Alexa, sales


            Pause,         <span style="color:#00FF00"> // pauses playback (RazorInstrument still looping/waiting)
https://game-master.net/images/wiki/musicbox/musicbox10.png


            Resume,       <span style="color:#00FF00"> // resume playback
If your bank box can't take the gold, the sale is recorded as a credit to you instead, shown in your sales. Credits record unpaid song sales but cannot currently be collected. They are not available as withdrawable gold. Each new sale is paid in gold whenever your bank box has room for it.


            Continue = Resume,
Say ''purchases'' to see the songs you have bought:


            What,
Alexa, purchases
 
            Who = What,    <span style="color:#00FF00"> // who is the composer
 
            Previous,     <span style="color:#00FF00"> // previous song
 
            Next,         <span style="color:#00FF00"> // next song
 
            Repeat,       <span style="color:#00FF00"> // repeat last song
 
            Loop,         <span style="color:#00FF00"> // loop playlist
 
            List,          <span style="color:#00FF00"> // list all tracks
 
            Add,          <span style="color:#00FF00"> // add track (previously removed)
 
            Remove,        <span style="color:#00FF00"> // add a global track to your private ignore list
 
            Refresh,     <span style="color:#00FF00">  // adds any new global (free) tracks to your library (also happens automatically)
 
            Buy,        <span style="color:#00FF00">   // user wishes to buy a track
 
            Shuffle,     <span style="color:#00FF00">  // shuffle users playlist
 
            Sales,       <span style="color:#00FF00">  // total composers sales
 
            Purchases,    <span style="color:#00FF00"> // player purchases
 
            New music,    <span style="color:#00FF00"> // list recently approved tracks
 
            Help,    <span style="color:#00FF00"> // get help on the commands
 
            Remaster,    <span style="color:#00FF00"> // request approval to remaster a track
 
            Submit,    <span style="color:#00FF00"> // submit a song for approval
 
            Rename,    <span style="color:#00FF00"> // rename the music box
 
 
          <span style="color:#00FF00"> // staff only
 
            FlushAll = 100,      <span style="color:#00FF00">  // flush all tracks – everywhere (TC Only)
 
            Review,            <span style="color:#00FF00">    // review submitted tracks
 
            Approve,            <span style="color:#00FF00">   // approve a track
 
            Deny,            <span style="color:#00FF00">      // deny (reject) a track
 
All of the above commands should be pretty straightforward. However, two interesting commands are Sales and Purchases:
<br>
Alexa, sales
 
https://game-master.net/images/wiki/musicbox/musicbox10.png
 
The line about credit is if by some chance the system can’t deposit any more into your bank (it’s full,) the music system keeps it as a credit on its own private ledger and will pay it at a future date.
<br>
Alexa, purchases


https://game-master.net/images/wiki/musicbox/musicbox11.png
https://game-master.net/images/wiki/musicbox/musicbox11.png


Note that the global music repository is a persistent store and not tied to any account. So once you enter your work into the system, it’s there and available to other players forever.
==Leaderboard==
The Music Box records each composer's sales and the gold they have earned. The leaderboard at your local bank shows them.


==Leaderboard==
https://game-master.net/images/wiki/musicbox/musicbox12.png


The Angel Island Music Box tracks both the total number of sales and the total amount of gold accrued from sales through the system. These statistics are then made available for viewing on the leaderboard, located at your local bank.
==Staff Reference==
Staff use these commands to run the library. Players can't use them.


https://game-master.net/images/wiki/musicbox/musicbox12.png
{| class="wikitable"
! Say !! What it does !! Access
|-
| review || Lists the songs waiting for review. || Owner
|-
| approve ''song'' || Approves a song: it becomes available to every player. || Owner
|-
| deny ''song'' || Rejects a song. || Owner
|-
| delete ''song'' || Removes a song from the library. || Owner
|-
| find ''song'' || Shows a song's serial number, owner, and name. || Owner
|-
| dupe ''song'' || Puts a copy of a song's sheet music in your backpack. || Seer
|-
| flushall || Removes every song, everywhere. || Owner, Test Center only
|}
==History==
The Music Box was designed and built by Adam Ant in 2022, inspired by his Amazon Echo: hence "Alexa". See [[Music Composition#History and Credits|History and Credits]].

Revision as of 08:50, 4 November 2026

musicbox1.png

The Music Box plays music in your home on voice command. It holds the shard's library of player compositions: free songs, songs you have bought, and your own. Composers publish their songs to it and are paid when players buy them.

General Usage

Buy a music box from any Bard NPC, lock it down in your home, and double-click it. It plays your whole playlist from start to finish, then stops. Double-click it again to stop it sooner.

Give your music box a name: single-click it and choose the rename option. You then speak to it by name, as you would to a smart speaker (its designer named his "Alexa"):

Alexa, play Douce Dame Jolie
Alexa, next
Alexa, previous
Alexa, repeat
Alexa, shuffle
Alexa, loop

You never need a song's whole name: a few words of it are enough, and the music box works out which song you mean, using Angel Island's Intelligent Dialogue System. Alexa, help lists every command.

To see what music is available, say list:

Alexa, list

musicbox2.png

Yellow titles are yours to play: free songs, songs you have bought, and songs you composed. Red titles are premium songs, which cost gold.

To hear a premium song before buying it, ask the music box to play it:

Alexa, play strut

musicbox3.png

It plays a 10-second sample. To buy the song:

Alexa, buy strut

The music box walks you through the purchase:

musicbox4.png

When you agree, the price is taken from your bank (or your shared bank accounts) and paid into the composer's bank, here Pastor Wydstrin's. In this screenshot the player has named the music box Bach, and asked for the song by part of its name.

musicbox5.png

The song is now in your library and your playlist, ready to play:

  • Your library is every song you have access to.
  • Your playlist is the songs from your library that the music box plays. You might take the Christmas songs out of it in July. Remove takes a song out; add puts it back.

musicbox6.png

List of Commands

Say the music box's name, then the command. Several commands have a second word that does the same thing.

Say What it does
play song Plays a song from your library, or a 10-second sample of one you don't own.
stop (or cancel) Stops playing.
pause Pauses.
resume (or continue) Resumes after a pause.
what (or who) Says the song and its composer.
next, previous The next or previous song in your playlist.
repeat Plays the last song again.
loop Plays your playlist over and over.
shuffle Shuffles your playlist.
list Lists the songs.
new Lists recently approved songs.
buy song Buys a premium song.
remove song (or ignore) Takes a song out of your playlist.
add song Puts a removed song back.
refresh Adds new free songs to your library. This also happens on its own.
purchases The songs you have bought.
sales Your sales as a composer (see Getting Paid).
submit Publishes a song (see Instructions for Composers).
remaster Asks to replace one of your approved songs with a new version.
rename Renames the music box.
help Lists the commands.

Instructions for Composers

The Music Box is how composers share and sell their work across the shard.

  1. Write your song in a composition book and transcribe it into Sheet Music. Set its name and price at the top of the composition with # Song: and # Price: (a price of 0 makes it free). See Settings for every setting.
  2. Single-click your music box and choose Add, or say submit. Target your sheet music.

musicbox8.png

musicbox9.png

Your song is now in the shard-wide library, not just your own music box, and goes into a review queue. Staff review songs to keep out offensive content, not to judge their quality (songs can have lyrics). Once approved, it appears for every player: free songs in their libraries, premium songs as red titles they can sample and buy.

Each approved song earns you Music Karma, and so does every sale and every play.

To publish a new version of an approved song, say remaster.

The library is permanent and not tied to your account: once a song is in, it stays available to other players. If the character who composed a song is deleted, the song becomes free.

Napster Tracks

A song transcribed with # Napster: True is passed hand to hand instead of sold. Anyone who has a copy of its sheet music can add it to their own music box, which gives them the song (the sheet is used up). Other players hear only a sample, and are told to get a copy from the composer.

Getting Paid

When a player buys your song, the price goes straight into your bank. Say sales to see your totals:

Alexa, sales

musicbox10.png

If your bank box can't take the gold, the sale is recorded as a credit to you instead, shown in your sales. Credits record unpaid song sales but cannot currently be collected. They are not available as withdrawable gold. Each new sale is paid in gold whenever your bank box has room for it.

Say purchases to see the songs you have bought:

Alexa, purchases

musicbox11.png

Leaderboard

The Music Box records each composer's sales and the gold they have earned. The leaderboard at your local bank shows them.

musicbox12.png

Staff Reference

Staff use these commands to run the library. Players can't use them.

Say What it does Access
review Lists the songs waiting for review. Owner
approve song Approves a song: it becomes available to every player. Owner
deny song Rejects a song. Owner
delete song Removes a song from the library. Owner
find song Shows a song's serial number, owner, and name. Owner
dupe song Puts a copy of a song's sheet music in your backpack. Seer
flushall Removes every song, everywhere. Owner, Test Center only

History

The Music Box was designed and built by Adam Ant in 2022, inspired by his Amazon Echo: hence "Alexa". See History and Credits.