MusicStudio

Minecraft 版本： 26.1

平台： bukkit paper purpur

标签： adventure minigame utility

MusicStudio

In-game music composition studio — compose songs in a tracker-style GUI, press them to music discs, and play them anywhere.

Features

• Tracker-style editor inside a 54-slot inventory GUI — a layers × ticks grid where you place, move, and delete notes
• 16 vanilla note block instruments, 25 pitches (F#3–F#5, two octaves)
• Per-layer instrument, volume, and mute control
• Adjustable tempo (ticks per cell)
• Copy / paste and in-editor preview playback (only you hear it)
• Press songs to music discs — right-click to play; the music follows the holder like a portable radio
• Optional extraction cost, ItemsAdder custom item support, and vanilla glint / unbreakable / custom-model-data
• Import Note Block Studio .nbs files
• Per-player song ownership — you only see and edit your own songs (admins see all)
• Full i18n (ko_kr / en_us); every string is configurable with MiniMessage
• Update notifications — console and admins are notified when a newer GitHub release exists
• Wide version support — Paper / Purpur 1.20.x – 1.21.x and 26.x

Supported Versions

One jar is provided per version series under build/libs/Upload/<series>/. Each jar runs on both Paper and Purpur.

The Java requirement follows the server: 1.20–1.20.4 need Java 17, 1.20.5+ need Java 21, 26.x needs Java 25.

Permissions

Commands

Base command: /음악스튜디오  (aliases: /음스, /ms, /musicstudio). Both Korean and English subcommands work.

Song Management

Admin

Names may contain spaces (joined with _) and are limited to 32 characters.

Editor Controls

The editor is an inventory GUI. Rows are layers, columns are ticks; the bottom rows hold the ruler and control bar.

On a layer header, press F to select that complete logical layer for movement, then press F on another header to move it to that exact position. Press F on the selected source again to cancel. Q continues to delete a layer.

Instruments (16): Harp, Bass, Bass Drum, Snare, Hat, Guitar, Flute, Bell, Chime, Xylophone, Iron Xylophone, Cow Bell, Didgeridoo, Bit, Banjo, Pling.

Configuration

plugins/MusicStudio/config.yml:

language: ko_kr          # ko_kr (Korean) or en_us (English); untranslated strings fall back to ko_kr

update-check:
  enabled: true          # notify console + admins when a newer GitHub release exists

limits:
  max-ticks: 4096        # maximum song length in cells
  max-songs-per-player: 30   # per-player song cap (musicstudio.admin is exempt)
  max-layers: 9          # layers per song (1–256)

disc:
  material: MUSIC_DISC_5 # base vanilla music disc item
  itemsadder-id: ""      # ItemsAdder custom item id (e.g. "myitems:music_disc"); falls back to material
  glint: false           # enchantment glint
  unbreakable: false
  custom-model-data: 0   # resource-pack model id; 0 = none
  cost:
    enabled: false       # charge an item to extract a disc
    item: EMERALD
    amount: 5

Display text lives in messages_<lang>.yml and gui_<lang>.yml (MiniMessage syntax) — edit them to fully reskin the plugin.

Examples

Create a song called mysong, open the editor, then press it to a disc:

/ms create mysong
/ms open mysong
/ms disc mysong

Import a Note Block Studio file (plugins/MusicStudio/import/song.nbs):

/ms admin import song

Switch the server to English: set language: en_us in config.yml, then:

/ms admin reload

Installation

1. Pick the jar matching your Minecraft version series from build/libs/Upload/<series>/.
2. Drop it into your server's plugins/ folder.
3. Restart the server (Paper or Purpur).

Requires JDK 21 and JDK 25 (the latter only for the 26.x target).