Music

Using the Music System

The Music System is designed for players to be able to play music compositions found in the game, create their own, or play their instrument freely.

1. Playing Notes:

  - Equip a musical instrument or stand near one (e.g., a piano).
  - Use the [Play command to play individual notes or sequences.
  - Example: [Play c4 0.5 d4 e4 plays notes c4, d4, and e4 with a 0.5-second pause after the first note.

2. Saving Melodies:

  - Use the [SaveMelody command to save a sequence of notes as a named melody.
  - Example: [SaveMelody happybirthday c4 0.5 d4 0.5 e4.
  - The melody must be bracketed by % (percent symbol) when called.

3. Composing Songs:

  - Combine multiple saved melodies and new notes into a song using [ComposeSong.
  - Requirement: Minimum 30 MusicTheory skill.
  - Example: [ComposeSong mysong c4 0.5 %happybirthday%.

4. Stopping Music:

  - Use [StopMusic to interrupt any ongoing playback.

5. Sharing Sheet Music:

  - After composing a song, target a piece of paper to write it into a SheetMusic item that can be shared or traded.

6. Managing Playlists:

  - Your playlist (the queue of notes to be played) is cleared automatically when new melodies or songs are played.
  - Manually clear the playlist using [StopMusic if needed.

---

Commands

[Play

- Usage: [Play note|pause note|pause - Description: Plays a note or series of notes and pauses. - Example: `[Play c4 0.5 d4 e4`.

[StopMusic

- Usage: [StopMusic - Description: Stops any currently playing melody or notes. - Example: [StopMusic

[SaveMelody

- Usage: [SaveMelody melodyname note pause note pause - Description: Saves a sequence of notes and pauses as a melody. - Example: [SaveMelody happybirthday c4 0.5 c4 0.5 d4]

[GetMelody

- Usage: [GetMelody - Description: Lists all saved melodies for the player. - Example: [GetMelody

[ComposeSong

- Usage: [ComposeSong songname note pause melody - Description: Combines notes and melodies into a song. - Requirement: Minimum 30 MusicTheory skill. - Example: [ComposeSong mysong c4 0.5 %happybirthday%

[DeleteMelody

- Usage: [DeleteMelody %melodyname% - Description: Deletes a saved melody by name. - Example: [DeleteMelody %happybirthday%

[ShowNotes

- Usage: `[ShowNotes - Description: Toggles the visibility of notes being played. - Example: [ShowNotes

[MusicHelp

- Usage: [MusicHelp - Description: Provides a summary of all music-related commands and notes available for your instrument. - Example: [MusicHelp