設定
LunaticChat の設定は plugins/LunaticChat/config.yml で管理されます．サーバーの初回起動時にデフォルトの設定ファイルが生成されます．
設定の反映
/lc reload v1.4.0~ はサーバーの稼働中に config.yml を読み直します．反映されるのは messageFormat の設定のみです．
ほかの設定は，どのサービスを構築するか・どのコマンドとリスナーを登録するか・どのファイルを開くかといった，プラグインの起動時に一度だけ決まる事柄を左右します．反映されたように見せかけることはせず，変更したもののうち稼働中のサーバーが取り込めない設定を一覧で表示するので，再起動が必要かどうかが分かります．
[LC] config.yml を再読み込みしましたが，一部の変更の適用にはサーバーの再起動が必要です．応答は，編集した内容が反映されたかどうかだけを伝えます．どの設定が動いたかはサーバーログに記録されます．
/lc reload で反映 | 再起動が必要 | |
|---|---|---|
messageFormat.* | はい | — |
features.* | — | はい |
debug | はい | — |
checkForUpdates, language, userSettingsFilePath | — | はい |
このコマンドはプレイヤーのほかコンソール・RCON からも実行できます．lunaticchat.command.lc.reload (デフォルト: op) が必要です．
真偽値の設定は true / false のほか，Bukkit が従来受け付けていた yes / no / on / off の表記も使用できます．古いリリース向けに書かれたファイルもそのまま動作します．
不正なファイルからの復帰 v1.3.0~
config.yml が使用できない状態であっても，プラグインの起動が止まることはありません．
- 1つの値が読めない場合，その設定だけがデフォルトにフォールバックし，該当キーを示す警告がログに出力されます．ファイル内のほかの設定はそのまま反映されます
- ファイルが YAML として不正な場合やディスクから読み取れない場合は，すべての設定がデフォルトにフォールバックし，エラーがログに出力されます
- コメントのみのファイルは「デフォルトを使う」という有効な指定として扱われ，問題として報告されません
config.yml を編集したあとはサーバーログを確認してください．デフォルトに戻された設定があれば，そこに報告されています．
/lc reload はこれよりも厳格です．起動時にはない選択肢 — 稼働中の設定をそのまま使い続ける — を取れるためです．デフォルトへのフォールバックは行わずファイルごと拒否し，読み取れなかった設定をすべてまとめて表示します．サーバーは元の設定を保持したままです．設定を 1 つも含まないファイルも同じ理由で拒否されます．コメントのみのファイルと，書き込み途中のファイルを見分けられないためです．
キー名のタイポは，どちらの経路でも検出されません．新しいビルド向けに書かれた config.yml が古いビルドで壊れないよう，未知のキーは無視されるためです．リロードで反映対象が 1 つも見つからなかった場合は，成功としてではなく「変更なし」として報告されます．これがキー名を疑う手がかりになります．
グローバル設定
| キー | 型 | デフォルト | 説明 |
|---|---|---|---|
debug | Boolean またはブロック | false | デバッグログ．デバッグログ を参照 |
userSettingsFilePath | String | "player-settings.yaml" | プレイヤー設定ファイルのパス |
checkForUpdates | Boolean | true | 起動時にアップデートを確認する |
language | String | "en" | プラグインの言語 (en / ja) |
デバッグログ v1.4.0~
debug は，LunaticChat がサーバーログにどれだけ書き出すかをカテゴリ単位で決めます．カテゴリはプラグイン の領域を表すため，チャット経路の計装を入れてもハンドシェイクの問題が埋もれません．
| カテゴリ | 出力する内容 |
|---|---|
config | 起動時に読み込んだ設定と，リロードでの差分 |
chat | メッセージのルーティング判定，クロスサーバーの重複排除ヒット |
channel | 参加・離脱と，拒否された理由 |
conversion | ローマ字変換の判定とキャッシュヒット |
protocol | 送受信のサブチャネル・バイト長・メッセージ ID |
velocity | ハンドシェイク，接続状態，presence，リレー判定 |
storage | デバウンス保存，アトミック書き込みとそのサイズ |
command | 権限拒否とコマンド結果 |
書き方は 3 通りあります．
debug: false # 無効 (yes / no / on / off も使用可)
debug: true # 全カテゴリ
debug: velocity,protocol # 指定したカテゴリのみ
debug:
enabled: true
categories: [velocity, protocol] # 同じ内容をブロックで書く場合enabled: false は，隣に categories が書かれていてもそちらより優先されます．そのビルドが知らない カテゴリ名は警告として報告され，正しく書かれたカテゴリはそのまま適用されます．
デバッグ行は [LC/<カテゴリ>] を前置して INFO で出力します．Paper の既定の log4j 設定では INFO 未満が出力されないためです．
稼働中のカテゴリ切り替え
/lc debug # 現在出力しているカテゴリ
/lc debug <category> on|off
/lc debug all on|off変更されるのは稼働中のサーバーだけで，config.yml は書き換えません．再起動または /lc reload で ファイルの値に戻ります．lunaticchat.command.lc.debug (デフォルト: op) が必要です．
診断レポート
/lc dump は plugins/LunaticChat/debug/report-<タイムスタンプ>.txt を書き出し，プラグインフォルダーに出力した旨をチャットに返します．正確なパスはサーバーログにのみ残ります（このコマンドはファイルアクセスを持たない相手にも渡せるためです）． レポートにはプラグイン・プロトコル・サーバー・Java の版数，有効な機能，Velocity の接続状態，各ストアの 件数が含まれます．メッセージ本文・プレイヤー名・UUID は意図的に含めていないため，そのまま bug report に 貼れます．lunaticchat.command.lc.dump (デフォルト: op) が必要です．
Velocity プロキシには設定ファイルがないため，同じ記法をシステムプロパティまたは環境変数から読み取ります．
java -Dlunaticchat.debug=velocity,protocol -jar velocity.jar
LUNATICCHAT_DEBUG=velocity,protocolシステムプロパティが環境変数より優先されます．これをハンドシェイクで伝播させないのは意図的です．プロキシ は複数バックエンドの共有物であり，1 台の Paper サーバーが全体のログ量を決めてしまうためです．
機能設定 (features)
クイックリプライ (features.quickReplies)
| キー | 型 | デフォルト | 説明 |
|---|---|---|---|
enabled | Boolean | true | /reply コマンドを有効にする |
ローマ字変換 (features.japaneseConversion)
| キー | 型 | デフォルト | 説明 |
|---|---|---|---|
enabled | Boolean | false | ローマ字→ひらがな変換を有効にする |
cache.maxEntries | Int | 500 | 変換キャッシュの最大エントリ数 |
cache.saveIntervalSeconds | Int | 300 | キャッシュのディスク保存間隔(秒) |
cache.filePath | String | "conversion_cache.json" | キャッシュファイルのパス |
api.timeout | Long | 3000 | API リクエストのタイムアウト(ミリ秒) |
チャンネルチャット (features.channelChat)
| キー | 型 | デフォルト | 説明 |
|---|---|---|---|
enabled | Boolean | false | チャンネルチャット機能を有効にする |
maxChannelsPerServer | Int | 0 | サーバーあたりの最大チャンネル数(0 = 無制限) |
maxMembersPerChannel | Int | 0 | チャンネルあたりの最大メンバー数(0 = 無制限) |
maxMembershipPerPlayer | Int | 0 | プレイヤーあたりの最大参加チャンネル数(0 = 無制限) |
メッセージログ (features.channelChat.messageLogging)
| キー | 型 | デフォルト | 説明 |
|---|---|---|---|
enabled | Boolean | true | チャンネルメッセージを NDJSON ファイルに記録する |
retentionDays | Int | 30 | ログファイルの保持日数(0 = 無期限) |
maxFileSizeMB | Int | 100 | 単一ログファイルの最大サイズ(MB) |
Velocity 連携 (features.velocityIntegration)
| キー | 型 | デフォルト | 説明 |
|---|---|---|---|
enabled | Boolean | false | Velocity プロキシとの連携を有効にする |
crossServerGlobalChat | Boolean | false | サーバー間グローバルチャットを有効にする |
crossServerDirectMessage | Boolean | false | サーバー間ダイレクトメッセージを有効にする |
serverName | String | "Unknown" | クロスサーバーチャットで表示されるサーバー名 |
messageDeduplicationCacheSize | Int | 100 | メッセージ重複排除キャッシュのサイズ |
メッセージフォーマット (messageFormat)
| キー | デフォルト | 利用可能なプレースホルダー |
|---|---|---|
directMessageFormat | §7[§e{sender} §7>> §e{recipient}§7] §f{message} | {sender}, {recipient}, {message} |
channelMessageFormat | §7[§b#{channel}§7] §e{sender}: §f{message} | {sender}, {message}, {channel} |
crossServerGlobalChatFormat | §7[§6{server}§7] §e{sender}: §f{message} | {sender}, {message}, {server} |
データファイル
プラグインが書き込むファイルはすべて plugins/LunaticChat/ 配下に置かれます．
| ファイル | 書き込まれるタイミング | 備考 |
|---|---|---|
config.yml | 初回起動時に生成 | プラグインが書き換えることはない |
player-settings.yaml | プレイヤーが /lc settings で設定を変更したとき | パスは userSettingsFilePath で変更可能．起動時に読み取れなかった場合，全プレイヤーの設定がデフォルトに戻る |
channels.json | チャンネルまたはメンバーシップが変化したとき | チャンネルチャットが有効な場合のみ |
conversion_cache.json | cache.saveIntervalSeconds ごとに定期保存 | ローマ字変換が有効な場合のみ．パスは cache.filePath で変更可能 |
logs/channelchat/ | チャンネルメッセージごと | メッセージログが有効な場合のみ．メッセージログを参照 |
保存は変更ごとではなくまとめて行われ，またすべてのファイルはアトミックに書き込まれるため，書き込み途中のファイルが読まれることはありません．いずれもサーバー停止時にも書き出されます．