diff options
| author | Sho Sakuma <me@m1sk9.dev> | 2026-08-30 20:55:48 +0900 |
|---|---|---|
| committer | Sho Sakuma <me@m1sk9.dev> | 2026-08-30 20:55:48 +0900 |
| commit | 6eadc66f4ac9bf626e3649da9a3402dec35c7ba6 (patch) | |
| tree | 8d40191f47604a0421043fb383256fe38356a001 /website/src/ja/docs/developers | |
| parent | 44132f3a73651fbd334a314fbc4ab47f5f1bbd5b (diff) | |
| download | LunaticChat-6eadc66f4ac9bf626e3649da9a3402dec35c7ba6.tar.gz LunaticChat-6eadc66f4ac9bf626e3649da9a3402dec35c7ba6.tar.bz2 LunaticChat-6eadc66f4ac9bf626e3649da9a3402dec35c7ba6.zip | |
docs: Add v1.4.0 doc
Diffstat (limited to 'website/src/ja/docs/developers')
| -rw-r--r-- | website/src/ja/docs/developers/engine.md | 11 |
1 files changed, 11 insertions, 0 deletions
diff --git a/website/src/ja/docs/developers/engine.md b/website/src/ja/docs/developers/engine.md index f798335..19071d4 100644 --- a/website/src/ja/docs/developers/engine.md +++ b/website/src/ja/docs/developers/engine.md @@ -81,6 +81,17 @@ UUID シリアライザが 2 つあるのは用途が違うためです. ドメインエラーを Paper / Velocity 双方で同じ型として扱えるよう,例外を engine に集約しています.共通の封印基底は持たず,`Exception` を直接継承するフラット構造です.存在/参照系・状態系・制限系・権限/BAN・KICK 系に分類でき,多くが `playerId` / `channelId` / `limit` をコンストラクタで受けてメッセージを自前生成します.基底を持たないため,呼び出し側は個別に catch する前提です. +## debug — 両プラットフォームが読む単一のスイッチ + +デバッグログは実装よりも先に契約です.`config.yml` とプロキシのシステムプロパティは `velocity,protocol` を同じ意味に解釈しなければならず,片側で増えたカテゴリはもう片側にも存在しなければなりません.そのため語彙を engine に置き,書き出しだけを platform 側に残しています. + +- `DebugCategory` — ログを出せる領域.運用者が書く綴りを `key` として持つ +- `DebugCategories.parse` / `resolve` — デバッグスイッチの唯一の解釈.Paper の `DebugConfigSerializer` と Velocity の `VelocityDebugSwitch` が共有する.未知の名前は例外にせず収集するため,タイポの影響はその名前だけに留まる +- `DebugLogger` — `log(category) { message }`.lambda であることが要点で,チャット経路は 1 通あたり 1 回計装されるが,無効時は文字列自体が組み立てられない +- `DebugState` — 現在有効なカテゴリ.`/lc reload` と `/lc debug` が稼働中に差し替える + +`JulDebugLogger` (Paper) と `Slf4jDebugLogger` (Velocity) はどちらも `INFO` で出力します.どちらのプラットフォームも,既定のログ設定では `INFO` 未満を出力しないためです. + ## permission / command — 中立抽象 Bukkit / Velocity どちらの API にも渡せる中立表現として,権限とコマンド結果を engine に置いています. |
