HakoniwaMusic 鯖民向け説明書 (Alpha-0.4.2)
音符ブロックの演奏を録音・作曲して保存し、GUIメニューやコマンドでいつでも聴き返せる機能です。 いいねやレコード購入もできます。録音・作曲・自分の曲の管理は、権限を持っていなくても誰でも 使えます(既定設定)。他人の曲を管理する操作や設定リロードだけが管理者専用です。
WARNING
本書の記載内容には、当サーバーの現在の設定・運用状況に適用されていないものが一部含まれる可能性があります。実際にお使いになる際は、コマンド等をご自身で実行し、動作をご確認いただくようお願いいたします。 なお、実行するとどうなるかについては本書内でしっかりと説明していますので、それをご確認・ご理解いただいたうえでの実行によって生じた被害等について、運営チームは責任を負いません。
できること
- ノートブロックの生演奏、またはコマンドの打ち込みで曲を作れる(誰でも)
- 保存した曲は自分だけ、または公開されていれば誰でも聴ける
- GUIメニューから、検索・ランキング・お気に入り・楽曲詳細画面を使える
- GUIメニューまたはコマンドから、いいね・レコード購入ができる
- 購入したレコードをジュークボックスに設置してBGMとして流せる場合がある(下記2章参照)
- 試聴用に、パブリックドメインの著名曲(きらきら星・エリーゼのために等)が無料の公開曲として 最初から入っています
/hmは/hmusicの短縮形です。どちらを使っても同じ結果になります。
1. 誰でも使えるコマンド
聴く・探す
| コマンド | できること |
|---|---|
/hmusic menu | GUIメニューを開く |
/hmusic search <キーワード> | タイトル・作者名で検索する |
/hmusic favorites | お気に入り一覧をGUIで開く |
/hmusic favorite <ID> | お気に入りの追加/解除を切り替える |
/hmusic ranking [likes|plays] | いいね数/再生数ランキングをGUIで開く |
/hmusic list | 公開されている曲＋自分の曲の一覧を見る |
/hmusic list mine | 自分の曲だけ一覧を見る |
/hmusic play <ID> | 一覧に出ているIDの曲を再生する |
/hmusic stop | 自分の再生を止める |
/hmusic like <ID> | 公開曲にいいねする(同じ曲に重複してはいいねできない) |
/hmusic buy <ID> | 曲のレコードアイテムを購入する(価格が付いている場合はお金がかかる) |
GUIメニューでのクリック操作:
| 操作 | 動作 |
|---|---|
| 左クリック | 再生 |
| Shift+左クリック | 楽曲詳細画面を開く |
| 右クリック | いいね |
| Shift+右クリック | お気に入りの追加/解除 |
メニュー下段のボタンから「お気に入り」「いいね数ランキング」「再生数ランキング」「一覧」に切り替え られます。検索はGUI内では入力できないので、チャットで/hmusic search <キーワード>と入力してください。
使い方の例:
/hmusic menuと入力してGUIを開く。- 聴きたい曲のアイコンを左クリックすると再生される。右クリックするといいねできる。
- 気に入った曲は
/hmusic buy <ID>でレコードを購入できる（無料の曲もある）。 - Shift+左クリックで楽曲詳細画面を開くと、再生・いいね・お気に入り・購入のボタンがまとまっている。
曲を作る・自分の曲を管理する
録音・作曲・自分の曲の公開・削除・価格設定・審査申請は、誰でも使えます。
| コマンド | できること |
|---|---|
/hmusic rec start | 生演奏の録音を開始する |
/hmusic rec stop <題名> | 録音を止めて曲として保存する |
/hmusic rec cancel | 録音を中止する（保存しない） |
/hmusic compose <BPM> <題名> <音符...> | コマンドで音符を打ち込んで曲を作る(1行) |
/hmusic compose session start|add|undo|finish|cancel | コマンドで音符を打ち込んで曲を作る(複数行) |
/hmusic publish <ID> | 自分の曲を公開する |
/hmusic delete <ID> | 自分の曲を削除する |
/hmusic setprice <ID> <価格> | 自分の曲のレコード価格を設定する |
/hmusic review submit <ID> | 自分の曲を審査に出す(すぐ「仮OK」になる) |
録音の流れ:
/hmusic rec startと入力する。- ノートブロックを叩いて演奏する（自分の近く、半径48ブロック以内で鳴った音が録音される）。
- 演奏が終わったら
/hmusic rec stop 夜の森のように題名をつけて保存する。 /hmusic publish <ID>で公開すると、誰でも一覧・再生できるようになる。
作曲(compose)の詳しい書き方:
ノートブロックを設置せずコマンドで直接曲を作れます。曲は「音符トークン」を並べて書き、 1トークン=基本1拍(BPMで決まる長さ)です。
| 要素 | 書き方 | 説明 |
|---|---|---|
| 音階 | 0〜24 | 下表を参照。省略不可(必ず音階か休符を書く) |
| 休符 | . または - | その拍は音を鳴らさず間を空ける |
| 楽器変更 | 楽器名:音階 (例 BASS_DRUM:12) | 指定するとその楽器に切り替わり、次に変更するまで続く。省略時はピアノ(PIANO) |
| 音の長さ | 音階x長さ (例 12x2) | その音を「長さ」拍分伸ばす。x0.5のような小数も可。省略時は1拍 |
音階↔音名の対応(ノートブロックの音階そのまま、2オクターブ分):
| 音階 | 音名 | 音階 | 音名 | 音階 | 音名 |
|---|---|---|---|---|---|
| 0 | F#3 | 9 | D#4 | 18 | C5 |
| 1 | G3 | 10 | E4 | 19 | C#5 |
| 2 | G#3 | 11 | F4 | 20 | D5 |
| 3 | A3 | 12 | F#4 | 21 | D#5 |
| 4 | A#3 | 13 | G4 | 22 | E5 |
| 5 | B3 | 14 | G#4 | 23 | F5 |
| 6 | C4 | 15 | A4 | 24 | F#5 |
| 7 | C#4 | 16 | A#4 | ||
| 8 | D4 | 17 | B4 |
使える楽器名(大文字小文字は区別しない): PIANO(既定) / BASS_DRUM / SNARE_DRUM / STICKS / BASS_GUITAR / FLUTE / BELL / GUITAR / CHIME / XYLOPHONE / IRON_XYLOPHONE / COW_BELL / DIDGERIDOO / BIT / BANJO / PLING。
段階的な例:
- まず単純に音階だけ並べる:
6 8 10→ C4,D4,E4を1拍ずつ。 - 休符を入れる:
6 8 10 .→ 上記のあとに1拍の無音。 - 音の長さを変える:
6 8 10x2→ 最後のE4だけ2拍分伸ばす。 - 楽器を切り替える:
6 8 10 BASS_DRUM:0 12→ 途中からドラムに切り替わる。
1行で曲を作る場合:
/hmusic compose 120 森のワルツ 12 14 16 . BASS_DRUM:0 12x2 14 16(BPM=120、題名「森のワルツ」。題名にスペースは使えないので_を使うと保存時にスペースへ変換される)
複数コマンドに分けて作る場合(長い曲向け):
/hmusic compose session start 120 森のワルツ
/hmusic compose session add 12 14 16 .
/hmusic compose session add BASS_DRUM:0 12x2 14 16
/hmusic compose session finish/hmusic compose session undo で直前のaddを1回だけ取り消せます(2回連続では戻せません)。 /hmusic compose session cancel で打ち込みを破棄できます。
2. 管理者権限(hakoniwamusic.admin)が必要なコマンド(参考)
以下は他人の曲やサーバー全体に影響するため、管理者(op)や個別にhakoniwamusic.admin権限を 付与された人専用です。通常の鯖民は使えませんが、「こういうことができる」という参考として 一覧にしています。
| コマンド | できること |
|---|---|
/hmusic publish <ID> / delete <ID> (他人の曲) | 他人の曲を公開・削除する |
/hmusic review judge <ID> <approve|reject|reset> | 審査結果を判定する |
/hmusic reload | 設定・データベースを再読込する |
また、購入したレコードをジュークボックスに設置してBGMとして流すには、別途「BGM再生範囲」の権限 (hakoniwamusic.range.*、既定はOP)が必要です。この権限を持つ人がレコードを持ってジュークボックス を右クリックすると設置され、再生範囲(半径16/64/256ブロックまたはワールド全体)は持っている権限 によって決まります。権限を持たない人は、レコードを購入・所持することはできますが、ジュークボックス に設置することはできません。
3. 注意点
- 保存した曲は最初は作者だけしか聴けません（非公開）。公開すると誰でも一覧・再生できるようになります。
- 一度公開した曲を非公開に戻すコマンドは現時点ではありません（削除は可能です）。
- 近くで複数人が同時に録音していると、演奏の音が別の人の録音に混ざってしまうことがあります。
- ゾンビ・スケルトンなど「頭」を乗せたノートブロックの音は、再生時にピアノの音に変わります。
- ジュークボックスBGMは「設置すると流れ始め、取り出すと止まる」だけの仕組みです。レバー等の信号や 近づいたら流れる、といった仕掛けは現時点ではありません（今後の実装予定）。
- いいね・視聴・レコード購入による報酬はサーバーの経済(Vault)が導入されている場合のみ発生します。
4. よくある質問
- Q. 録音・作曲に権限は必要? → いいえ、既定では誰でも使えます。運営が特定の人だけ使えなく することもできますが、その場合は運営から案内があるはずです。
- Q. レコードを買ったのにジュークボックスに置けない/BGMが流れない → BGM再生範囲の権限 (
hakoniwamusic.range.*)が必要です。権限を持たない場合は設置できません。 - Q. 「権限がありません」と表示された → そのコマンドは上記2章に該当する管理者専用コマンドです。
備考
- 2026年8月8日 録音・作曲・自分の曲の管理(
hakoniwamusic.rec)を既定で誰でも使えるように変更、 compose記法(音階↔音名対応表・楽器名一覧を含む)を詳しく説明するよう改訂（Alpha-0.4.2） （Alpha-0.4.1版はこちら） - 2026年8月8日
/hmusic reload(管理者専用)を追加、Tab補完が入力途中の文字列で絞り込まれるように 改善（Alpha-0.4.1） （Alpha-0.4.0版はこちら） - 2026年8月7日 GUIメニューに検索・ランキング(いいね数/再生数)・お気に入り・楽曲詳細画面を追加、 試聴用のサンプル楽曲(パブリックドメインの著名曲)を登録（Alpha-0.4.0） （Alpha-0.3.1版はこちら）
- 2026年8月7日 内部的な不具合修正のみ、操作方法に変更なし（Alpha-0.3.1） （Alpha-0.3.0版はこちら）
- 2026年8月5日 v0.3.0公開（Alpha-0.3.0）。レコード/ジュークボックスBGM・いいね・簡易収益化・ 簡易審査ワークフロー・GUIメニュー・打ち込み作曲(compose)を追加 （Alpha-0.1.0版はこちら）
- 2026年8月5日 初版公開（Alpha-0.1.0）