HakoniwaMusic 鯖民向け説明書 (Alpha-0.4.1)
音符ブロックの演奏を録音して保存し、GUIメニューやコマンドでいつでも聴き返せる機能です。いいねや レコード購入もできます。特別な権限が無くても使えるものと、管理者(op)や個別に権限を付与された人しか 使えないものを分けて記載しています。念のため、権限がないと使えないコマンドも「こういうことができる」 という参考として載せています。
WARNING
本書の記載内容には、当サーバーの現在の設定・運用状況に適用されていないものが一部含まれる可能性があります。実際にお使いになる際は、コマンド等をご自身で実行し、動作をご確認いただくようお願いいたします。 なお、実行するとどうなるかについては本書内でしっかりと説明していますので、それをご確認・ご理解いただいたうえでの実行によって生じた被害等について、運営チームは責任を負いません。
できること
- ノートブロックで演奏した曲を録音して保存できる(録音・打ち込みは権限を持つ人のみ、下記2章参照)
- 保存された曲を自分だけ、または公開されていれば誰でも聴ける
- 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+左クリックで楽曲詳細画面を開くと、再生・いいね・お気に入り・購入のボタンがまとまっている。
2. 権限がないと使えないコマンド(参考)
以下は管理者(op)や、個別に権限を付与された人専用のコマンドです。通常の鯖民は使えませんが、 「こういうことができる」という参考として一覧にしています。
| コマンド | できること |
|---|---|
/hmusic rec start/stop <題名>/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> | 自分の曲を審査に出す |
/hmusic review judge <ID> <approve|reject|reset> | 審査結果を判定する(管理者専用) |
/hmusic reload | 設定・データベースを再読込する(管理者専用) |
/hmusic composeで使う音符の書式は次の通りです(参考):
- 基本形は
音階(0〜24の数字、ノートブロックの音階そのまま)。 - 休符(音を鳴らさず1拍分の間を空ける)は
.または-と書きます。 - 楽器を変える場合は
楽器名:音階(例:BASS_DRUM:0)。指定しない間は直前の楽器が続きます。 - 音の長さを変える場合は
音階x長さ(例:12x2で2拍分伸ばす)。省略時は1拍。
例: 12 14 16 . BASS_DRUM:0 12x2 14 16 → 12,14,16を1拍ずつ→休符1拍→ドラムの音を2拍→14,16。
また、購入したレコードをジュークボックスに設置してBGMとして流すには、別途「BGM再生範囲」の権限 (hakoniwamusic.range.*)が必要です。この権限を持つ人がレコードを持ってジュークボックスを右クリック すると設置され、再生範囲(半径16/64/256ブロックまたはワールド全体)は持っている権限によって決まります。 権限を持たない人は、レコードを購入・所持することはできますが、ジュークボックスに設置することはできません。
3. 注意点
- 保存した曲は最初は作者だけしか聴けません（非公開）。公開すると誰でも一覧・再生できるようになります。
- 一度公開した曲を非公開に戻すコマンドは現時点ではありません（削除は可能です）。
- 近くで複数人が同時に録音していると、演奏の音が別の人の録音に混ざってしまうことがあります。
- ゾンビ・スケルトンなど「頭」を乗せたノートブロックの音は、再生時にピアノの音に変わります。
- ジュークボックスBGMは「設置すると流れ始め、取り出すと止まる」だけの仕組みです。レバー等の信号や 近づいたら流れる、といった仕掛けは現時点ではありません（今後の実装予定）。
- いいね・視聴・レコード購入による報酬はサーバーの経済(Vault)が導入されている場合のみ発生します。
4. よくある質問
- Q. 自分でも曲を録音・作曲したい → 録音(
/hmusic rec)・打ち込み(/hmusic compose)は権限を 持つ人専用です(上記2章参照)。必要であれば運営に相談してください。 - Q. レコードを買ったのにジュークボックスに置けない/BGMが流れない → BGM再生範囲の権限 (
hakoniwamusic.range.*)が必要です。権限を持たない場合は設置できません。 - Q. 「権限がありません」と表示された → そのコマンドは上記2章に該当する専用コマンドです。
備考
- 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）