HakoniwaChat 鯖民向け説明書 (Alpha-0.2.1)
WARNING
本書の記載内容には、当サーバーの現在の設定・運用状況に適用されていないものが一部含まれる可能性があります。実際にお使いになる際は、コマンド等をご自身で実行し、動作をご確認いただくようお願いいたします。 なお、実行するとどうなるかについては本書内でしっかりと説明していますので、それをご確認・ご理解いただいたうえでの実行によって生じた被害等について、運営チームは責任を負いません。
/hakoniwachatは/hchatの短縮形です。どちらを使っても同じ結果になります。以降のコマンド例では 読みやすさのため正式名称(/hakoniwachat)で統一して表記します。
v0.1.1をお使いだった方へ: channel kick/ban/pardon/mute/unmuteの引数順や、 channel remove/format/invite/moderator/optionのチャンネル名指定の要否が変わっています。 本書は最新の使い方に更新済みです。
1. できること
- 自分でチャンネルを作って仲間内だけでチャットできる(公開/非公開、パスワード制、別名にも対応)
- チャンネルを「ブロードキャストチャンネル」にして、参加者以外にも(距離やワールド単位で)発言を届けられる
- 招待されたチャンネルへの参加・辞退をコマンドで返答できる
- 特定のプレイヤーとこっそり個人チャットができる(
/tell・/reply) - 見たくないチャンネル・プレイヤーの発言をまとめて非表示にできる
- よく使うメッセージを番号登録して、コマンド一発で送信できる(定型文)
- 自分のチャンネルにモデレーターを任命し、追放・BAN・ミュートなどの管理を任せられる
- チャンネルの過去の発言ログを条件付きで検索できる
- ローマ字で入力したチャットを簡易的にひらがなへ変換して併記できる
2. 誰でも使えるコマンド
| コマンド | 説明 |
|---|---|
/hakoniwachat channel create <名前> [public|private] [説明文...] | チャンネルを新規作成する(自分がオーナーになる) |
/hakoniwachat channel join <名前|!> [パスワード] | チャンネルに参加(!で全体チャンネルに戻る)。別名でも参加可能 |
/hakoniwachat channel leave [名前] | チャンネルから抜ける(省略時は現在のチャンネル) |
/hakoniwachat channel list | 全チャンネルの一覧を表示(発言先=赤、参加中=白、非表示=青、未参加=グレー) |
/hakoniwachat channel info [名前] | チャンネルの詳細・メンバー一覧を表示(モデレーターには@が付く) |
/hakoniwachat channel default | 発言先を全体チャンネルに戻す |
/hakoniwachat channel accept [名前] | チャンネルへの招待を承諾(招待が1件だけなら名前省略可) |
/hakoniwachat channel deny [名前] | チャンネルへの招待を辞退 |
/hakoniwachat channel log [名前] [d=日付][p=プレイヤー][f=キーワード] | 参加中チャンネルの発言ログを表示(直近15件、省略時は現在のチャンネル) |
/hakoniwachat channel invite <プレイヤー> | 現在のチャンネル(自分がオーナー/モデレーター)にプレイヤーを招待 |
/hakoniwachat channel kick <プレイヤー> [チャンネル名] | プレイヤーを追放(省略時は現在のチャンネル) |
/hakoniwachat channel ban <プレイヤー> [チャンネル名|分] | BAN(数字は分数指定、それ以外はチャンネル名として解釈) |
/hakoniwachat channel pardon <プレイヤー> [チャンネル名] | チャンネルBANを解除 |
/hakoniwachat channel mute <プレイヤー> [チャンネル名|分] | そのチャンネルのみ発言をミュート |
/hakoniwachat channel unmute <プレイヤー> [チャンネル名] | チャンネルミュートを解除 |
/hakoniwachat channel format <書式> | 現在のチャンネルの発言フォーマットを変更(オーナー/モデレーター) |
/hakoniwachat channel option <key=value...> | 現在のチャンネルの設定を変更(オーナー/モデレーター、一部は管理者) |
/hakoniwachat channel moderator <プレイヤー...|list> | 現在のチャンネルのモデレーターを追加(-名前で解除)・一覧表示 |
/hakoniwachat channel remove [名前] | チャンネルを削除(省略時は現在のチャンネル) |
/hakoniwachat template add|remove|list|use <番号> [メッセージ] | 自分専用の発言マクロを管理 |
/hakoniwachat ignore add|remove|list [プレイヤー] | 無視リストを管理 |
/hakoniwachat hide [channel|player] <名前> | チャンネル/プレイヤーの発言を非表示にする |
/hakoniwachat unhide [channel|player] <名前> | 非表示を解除する |
/hakoniwachat hide list | 非表示中のチャンネル・プレイヤーを一覧表示 |
/hakoniwachat jp on|off | ローマ字からの日本語変換をオン/オフ |
/tell <プレイヤー> <メッセージ> | 個人チャットを送信(エイリアス: /msg, /m, /t, /w, /whisper) |
/reply <メッセージ> | 直前に個人チャットをやり取りした相手に返信(エイリアス: /r) |
3. 主要コマンドの使い方の例
チャンネルを作って会話する
/hakoniwachat channel create 建築部と入力すると、「建築部」チャンネルが作成され、 自分の発言先が自動的にそのチャンネルに切り替わります。- この状態で通常のチャット欄にメッセージを打つと、「建築部」チャンネルに参加している プレイヤーにだけ届きます。
- 非公開チャンネルにした場合(
create 建築部 private)、オーナー(またはモデレーター)がそのチャンネルに いる状態で/hakoniwachat channel invite <プレイヤー名>を実行すると招待できます。 - 招待されたプレイヤーは
/hakoniwachat channel accept 建築部で参加、/hakoniwachat channel deny 建築部で辞退できます(招待が1件だけならチャンネル名は省略可能)。 - 全体チャットに戻りたくなったら
/hakoniwachat channel default、または/hakoniwachat channel join !を実行します。
パスワード付き・別名付きのチャンネルを作る
- 自分がオーナーのチャンネルで
/hakoniwachat channel option password=himitsu alias=kenchikuの ように設定すると、合言葉と別名を設定できます。 - 他のプレイヤーは
/hakoniwachat channel join kenchiku himitsuのように、別名と合言葉を 指定して参加できます(公開チャンネルであれば招待不要)。
チャンネルの管理を仲間に任せる
- 自分がオーナーのチャンネルにいる状態で
/hakoniwachat channel moderator Bobと入力すると、 Bobがそのチャンネルのモデレーターになります。複数人を一度に指定することもできます (moderator Bob Carol)。解除したい場合はmoderator -Bobのように先頭に-を付けます。 - モデレーターは、オーナーと同じように招待・追放・BAN・ミュート・書式変更・チャンネル削除・ オプション変更ができます(ただしモデレーターの任命・解任自体はオーナー本人か管理者のみ)。
発言ログを見る
- 参加中のチャンネルにいる状態で
/hakoniwachat channel logと入力すると、直近の発言が 最大15件表示されます。 /hakoniwachat channel log 建築部 p=Bobのようにすると、Bobの発言だけに絞り込めます。d=2026-09-06で日付、f=キーワードで本文の部分一致検索もでき、組み合わせて使えます。
個人チャットを送る
/tell Alice こんにちはと入力すると、Aliceにだけ「こんにちは」というメッセージが届きます。- Alice側の画面にも同様にメッセージが表示され、Aliceが
/reply ありがとう!と入力すると、 自動的にあなた宛の返信として届きます(相手を指定し直す必要はありません)。
定型文を使う
/hakoniwachat template add 1 いらっしゃいませ!ゆっくりしていってねのように登録します。- 以降は
/hakoniwachat template use 1と打つだけで、現在の発言先にそのメッセージが送信されます。
ローマ字入力を日本語に変換して併記する
/hakoniwachat jp onと入力すると、以降の発言でローマ字部分がひらがなに変換され、 発言の末尾に(変換結果)として併記されるようになります。- 例えば
konnichiwaと発言すると、konnichiwa (こんにちは)のように表示されます。 簡易的な変換のため、複雑な単語や固有名詞は正しく変換されないことがあります。 - 不要になったら
/hakoniwachat jp offでオフにできます。チャンネルによっては管理者が 変換を強制オン/オフにしている場合があり、その場合は個人設定より優先されます。
4. よくある質問
Q. チャンネルに参加しているのに、発言が全体チャットに表示されてしまいます。 A. チャンネルへの「参加」と「発言先への切り替え」は別々に行われます。/hakoniwachat channel join を使えば両方同時に行われますが、/hakoniwachat channel listで現在の発言先を確認してみてください。
Q. チャンネルの発言だけ非表示にしたいのですが、脱退はしたくありません。 A. /hakoniwachat hide channel <チャンネル名> を使ってください。参加したままそのチャンネルの発言が 非表示になります。特定のプレイヤーだけを非表示にしたい場合は /hakoniwachat hide player <プレイヤー名>(または/hakoniwachat ignore add)を使ってください。 /hakoniwachat hide <名前>のように種類を省略した場合、同名のチャンネルが優先的に判定されます。
Q. 無視(非表示)にした相手からの個人チャットも届きませんか? A. はい。プレイヤーを非表示(無視)にすると、そのプレイヤーのチャンネル発言・個人チャットの両方が あなたの画面に表示されなくなります。
Q. 個人チャットをブロックされているか分かりますか? A. 相手があなたを非表示(無視)にしている場合、/tellは失敗し、あなたにだけ 「そのプレイヤーはあなたのメッセージを受け取りません。」と表示されます(相手には何も届きません)。
Q. チャンネルは何個でも作れますか? A. 現時点(Alpha-0.2.1)では作成数の上限は設けていません。
Q. 日本語変換はどのくらい正確ですか? A. Google日本語入力のような高精度な変換ではなく、ローマ字の並びを機械的にひらがなへ置き換える 簡易的なものです。分かりやすい語句はサーバー管理者が辞書に登録することで正しく変換されるように なる場合があります。
5. 注意点
- チャンネルへの招待は、サーバーが再起動すると失われます。再起動後に参加してほしい場合は 改めて招待してください。
- ミュートされている間は、チャンネルへの発言だけが禁止されます。
/tell・/replyによる 個人チャットは制限されません。 - チャンネルBANされている間は、
/hakoniwachat channel join・acceptのどちらでも参加できません。 - 全体チャンネルの発言はログ機能の対象外です。
- サーバー管理者がチャンネルを「ブロードキャストチャンネル」に設定している場合、参加していなくても 近く(または同じワールド)にいると発言が聞こえることがあります。
- サーバー設定によっては連続発言にクールダウン(待機時間)が設定されている場合があります。
6. 管理者権限などが必要なコマンド
| コマンド | 必要な権限 | 説明 |
|---|---|---|
/hakoniwachat mute <プレイヤー> [分] | hakoniwachat.mute | 対象プレイヤーを全チャンネル共通でミュート |
/hakoniwachat unmute <プレイヤー> | hakoniwachat.mute | ミュートを解除 |
/hakoniwachat channel forcejoin <名前> <プレイヤー> | hakoniwachat.admin | 招待なしで強制参加させる |
/hakoniwachat jp <プレイヤー> on|off | hakoniwachat.admin | 他プレイヤーの日本語変換を切替 |
/hakoniwachat dictionary add|remove|list | hakoniwachat.dictionary | 日本語変換辞書を管理 |
/hakoniwachat formattemplate add|remove|list | hakoniwachat.formattemplate | 書式内%0%~%9%の定型文を管理 |
/hakoniwachat set default <プレイヤー> <チャンネル名|全体> | hakoniwachat.set | 他プレイヤーの発言先を設定 |
/hakoniwachat broadcast <メッセージ> | hakoniwachat.broadcast | 全プレイヤーにお知らせを送信 |
/hakoniwachat reload | hakoniwachat.admin | 設定を再読込 |
/hakoniwachat channel option <broadcast|range>=... | hakoniwachat.admin(既定) | ブロードキャスト/距離設定の変更 |
/hakoniwachat channel remove/format/invite/kick/ban/pardon/mute/unmute/moderator/option ... | hakoniwachat.admin(他人のチャンネル対象時) | 自分がオーナー/モデレーターでないチャンネルも管理できる |
/hakoniwachat migrate lunachat | hakoniwachat.admin | LunaChatの設定(チャンネル/発言先/辞書/日本語変換設定/書式テンプレート)を取り込む |
7. 備考
- 2026年9月6日 v0.2.1-Alpha公開。LunaChatからの設定移行コマンド(
/hakoniwachat migrate lunachat)を追加 （Alpha-0.2.0版はこちら）。 - 2026年9月6日 v0.2.0-Alpha公開。既存チャットプラグイン(LunaChat)のコマンド一覧を参考に機能を 網羅的に拡張(コードは流用せず独自実装)。チャンネル名省略、kick/ban/mute等の引数順変更、 チャンネルオプション拡充(password/alias/visible/color/broadcast/range等)、フォーマット変数拡充 (16進数カラー・Vault連携含む)、動的権限ノード、hide/unhide統合、formattemplateを追加 （Alpha-0.1.1版はこちら）。
- 2026年9月6日 v0.1.1-Alpha公開。モデレーター・BAN・チャンネル別ミュート・招待応答 (accept/deny)・発言ログ・チャンネルオプション・簡易日本語変換・辞書・管理者による発言先設定を 追加（Alpha-0.1.0版はこちら）。
- 2026年9月6日 初版公開（Alpha-0.1.0）