docs: Add channel moderation guide

7 files changed, 200 insertions, 17 deletions

diff --git a/docs/.vitepress/config/ja.ts b/docs/.vitepress/config/ja.ts
index 013b0d3..d3a8e97 100644
--- a/docs/.vitepress/config/ja.ts
+++ b/docs/.vitepress/config/ja.ts
@@ -42,7 +42,15 @@ export const ja: DefaultTheme.Config = {
                 {
                     text: 'チャットモード',
                     link: '/guide/player/channel-chat/chatmode',
-                }
+                },
+                {
+                    text: 'プライベートチャンネル',
+                    link: '/guide/player/channel-chat/private-channel',
+                },
+                {
+                    text: 'モデレーション',
+                    link: '/guide/player/channel-chat/moderation',
+                },
             ]
           },
           {
diff --git a/docs/src/guide/admin/velocity.md b/docs/src/guide/admin/velocity.md
index bc7f8d5..bbf5db6 100644
--- a/docs/src/guide/admin/velocity.md
+++ b/docs/src/guide/admin/velocity.md
@@ -4,10 +4,6 @@ Velocity を使用して，プロキシサーバーを繋いだ Paper サーバ�
 
 ::: warning 試験的機能
 
-この機能は現在，試験的に実装されており，今後のアップデートで仕様が変更される可能性があります．
-
-規模が大きい機能なので，一気に実装はせず段階的な展開を予定しています．
-
-詳しい実装計画は [ロードマップ (m1sk9/LunaticChat #54)](https://github.com/m1sk9/LunaticChat/issues/54) をご覧ください．
+この機能は現在試験的な機能として提供されています．今後のアップデートで仕様が変更される可能性があります．
 
 :::
diff --git a/docs/src/guide/player/channel-chat/about.md b/docs/src/guide/player/channel-chat/about.md
index 67aa170..9d1ae33 100644
--- a/docs/src/guide/player/channel-chat/about.md
+++ b/docs/src/guide/player/channel-chat/about.md
@@ -4,11 +4,7 @@
 
 ::: warning 試験的機能
 
-この機能は現在，試験的に実装されており，今後のアップデートで仕様が変更される可能性があります．
-
-規模が大きい機能なので，一気に実装はせず段階的な展開を予定しています．
-
-詳しい実装計画は [ロードマップ (m1sk9/LunaticChat #54)](https://github.com/m1sk9/LunaticChat/issues/54) をご覧ください．
+この機能は現在試験的な機能として提供されています．今後のアップデートで仕様が変更される可能性があります．
 
 :::
 
@@ -65,22 +61,22 @@
 
 作成されたチャンネルに参加するには，[`/lc channel join`](../../../reference/commands/lc/channel.md#lc-channel-join-チャンネルid) コマンドを使用します．
 
+チャンネルに参加すると，チャットモードが全体チャットからチャンネルチャットに切り替わります．
+
 ```
 /lc channel join <チャンネルID>
 ```
 
-チャンネルに参加すると，チャットモードが全体チャットからチャンネルチャットに切り替わります．
-
 ## チャンネル一覧を表示する
 
 参加可能なチャンネル一覧を表示するには，[`/lc channel list`](../../../reference/commands/lc/channel.md#lc-channel-list) コマンドを使用します．
 
+チャット欄に参加可能なチャンネルの一覧が表示されます．クリックするか [`/lc channel join`](#チャンネルに参加する) コマンドを使用して，チャンネルに参加できます．
+
 ```
 /lc channel list
 ```
 
-チャット欄に参加可能なチャンネルの一覧が表示されます．クリックするか [`/lc channel join`](#チャンネルに参加する) コマンドを使用して，チャンネルに参加できます．
-
 ## チャットモード
 
 LunaticChat では，プレイヤーがチャットを送信する際のモードとして，以下の2種類のチャットモードが存在します:
diff --git a/docs/src/guide/player/channel-chat/moderation.md b/docs/src/guide/player/channel-chat/moderation.md
new file mode 100644
index 0000000..821c635
--- /dev/null
+++ b/docs/src/guide/player/channel-chat/moderation.md
@@ -0,0 +1,95 @@
+# チャンネルの管理
+
+チャンネルチャットのモデレート機能を使用して，チャンネル内のメンバー行動を管理できます．
+
+::: danger 注意
+
+これらのモデレート機能はあくまで LunaticChat のチャンネルチャットに対して使用できるものです．
+
+実際にルール違反者に対して処罰が必要な場合は，サーバー管理者に通報することをお勧めします．
+
+:::
+
+## モデレート機能の仕様
+
+モデレート機能にはいくつかの仕様があります．
+
+- Bypass 権限を持つプレイヤーは，モデレート機能の影響を受けません．
+  - つまり，サーバー管理者に対してはこれらの機能を使用できません．
+- モデレート機能を使用するには，それぞれのチャンネルのロールとサーバー自体の権限が必要です．
+- モデレート機能の効果はチャンネルごとに独立しています．
+  - 例えば，あるチャンネルで永久追放(BAN)されたプレイヤーは，他のチャンネルでは通常通りチャットできます．
+
+## ロール
+
+チャンネルには以下のロールが存在しています．
+
+- メンバー (Member): チャンネルに参加している通常のプレイヤー
+- モデレーター (Moderator): チャンネルのモデレート機能を使用できるプレイヤー
+- オーナー (Owner): チャンネルの作成者であり，すべてのモデレート機能を使用できるプレイヤー
+
+::: tip サーバー管理者によるモデレート
+
+サーバー管理者は一律で全てのチャンネルにおいてオーナー権限と同じ権限を持ちます．
+
+:::
+
+## メンバーを一時的に追放する (Kick)
+
+メンバーを一時的にチャンネルから追放するには，[`/lc channel kick`](../../../reference/commands/lc/channel.md#lc-channel-kick-プレイヤーid) コマンドを使用します．
+
+```
+/lc channel kick <プレイヤーID>
+```
+
+このコマンドを実行すると，指定したプレイヤーがチャンネルから即座に退出されます．
+
+ただし，追放されたプレイヤーは再参加が可能です．
+
+## メンバーを永久に追放する (Ban)
+ 
+メンバーを永久にチャンネルから追放するには，[`/lc channel ban`](../../../reference/commands/lc/channel.md#lc-channel-ban-プレイヤーid) コマンドを使用します．
+
+```
+/lc channel ban <プレイヤーID>
+```
+
+このコマンドを実行すると，指定したプレイヤーがチャンネルから即座に退出され，さらに再参加も禁止されます．
+
+## 永久追放を解除する
+
+永久追放されたメンバーの追放を解除するには，[`/lc channel unban`](../../../reference/commands/lc/channel.md#lc-channel-unban-プレイヤーid) コマンドを使用します．
+
+```
+/lc channel unban <プレイヤーID>
+```
+
+## モデレーターを任命・解任する
+
+チャンネルのメンバーをモデレーターに任命/解任するには，[`/lc channel mod`](../../../reference/commands/lc/channel.md#lc-channel-mod-プレイヤーid) コマンドを使用します．
+
+```
+/lc channel mod <プレイヤーID>
+```
+
+このコマンドを実行すると，指定したプレイヤーがモデレーターに任命されます．また任命状態のプレイヤーに対して再度このコマンドを実行すると，モデレーターから解任されます．
+
+## オーナー権限を譲渡する
+
+チャンネルのオーナー権限を他のメンバーに譲渡するには，[`/lc channel ownership`](../../../reference/commands/lc/channel.md#lc-channel-ownership-プレイヤーid) コマンドを使用します．
+
+```
+/lc channel ownership <プレイヤーID>
+```
+
+このコマンドを実行すると，指定したプレイヤーに全てのオーナー権限が譲渡されます．元のオーナーはモデレーターになります．
+
+::: danger 実行時の注意点
+
+- オーナー権限の譲渡は不可逆的な操作です．
+    - つまり，一度譲渡してしまうとオーナー権限を持つプレイヤーが再度譲渡しない限り，元のオーナーがオーナー権限を取り戻すことはできません．
+    - これはサーバー管理者であってもです．
+- オーナー権限を譲渡する相手は，必ずチャンネルのメンバーである必要があります．
+- オーナー権限は全てのモデレート機能を使用でき，かつチャンネルを削除できる強力な権限です．譲渡する相手を慎重に選んでください．
+
+:::
diff --git a/docs/src/guide/player/channel-chat/private-channel.md b/docs/src/guide/player/channel-chat/private-channel.md
new file mode 100644
index 0000000..6123310
--- /dev/null
+++ b/docs/src/guide/player/channel-chat/private-channel.md
@@ -0,0 +1,25 @@
+# プライベートチャンネル
+
+プライベートチャンネルは，特定のユーザーのみが参加できるチャットチャンネルです．
+
+## プライベートチャンネルの作成
+
+プライベートを作成する場合は [`/lc channel create`](../../../reference/commands/lc/channel.md) コマンドで，プライベート設定引数に `true` を指定します．
+
+```
+/lc channel create <チャンネルID> <チャンネル名> [チャンネルの説明] [プライベート設定]
+```
+
+## チャンネルへの招待
+
+プライベートチャンネルは `/lc channel list` コマンドでは一覧表示されず， `/lc channel join` コマンドで参加することもできません．
+
+参加するにはオーナーもしくはモデレーターから招待を受ける必要があります．
+
+招待するには，[`/lc channel invite`](../../../reference/commands/lc/channel.md#lc-channel-invite-プレイヤーid) コマンドを使用します．
+
+```
+/lc channel invite <プレイヤーID>
+```
+
+招待を受けたプレイヤーは自動でチャンネルに参加します．
diff --git a/docs/src/index.md b/docs/src/index.md
index 2d06bdd..430077f 100644
--- a/docs/src/index.md
+++ b/docs/src/index.md
@@ -35,7 +35,7 @@ features:
   - title: CoreProtect への対応
     details: LunaticChat のチャットログは CoreProtect と互換性があります
     icon: 🗒️
-  - title: チャンネルチャット機能 (実装予定)
+  - title: チャンネルチャット機能
     details: チャットチャンネルを作成・管理し，特定のプレイヤー間でのプライベートメッセージを送信可能
     icon: ☎️
   - title: マルチプラットフォーム対応 (実装予定)
diff --git a/docs/src/reference/commands/lc/channel.md b/docs/src/reference/commands/lc/channel.md
index 9cc96e2..07381a6 100644
--- a/docs/src/reference/commands/lc/channel.md
+++ b/docs/src/reference/commands/lc/channel.md
@@ -74,5 +74,68 @@
 |-----------------------------------------|
 | `lunaticchat.command.lc.channel.delete` |
 
-指定したチャンネルを削除します．チャンネルの作成者(オーナー)である必要があります．
+指定したチャンネルを削除します．チャンネルの作成者(オーナー) である必要があります．
 
+### `/lc channel info [<チャンネルID>]`
+
+| パーミッション                               |
+|---------------------------------------|
+| `lunaticchat.command.lc.channel.info` |
+
+指定したチャンネルの情報を表示します．
+
+引数を指定した場合は現在アクティブ状態のチャンネルの情報を表示します．
+
+### `/lc channel invite <プレイヤーID>`
+
+| パーミッション                                 |
+|-----------------------------------------|
+| `lunaticchat.command.lc.channel.invite` |
+
+指定したプレイヤーを現在アクティブ状態のチャンネルに招待します．
+
+### `/lc channel kick <プレイヤーID>`
+
+| パーミッション                               |
+|---------------------------------------|
+| `lunaticchat.command.lc.channel.kick` |
+
+指定したプレイヤーを現在アクティブ状態のチャンネルから一時的に追放します．
+
+追放されたプレイヤーはそのチャンネルから即時退出されますが，再参加できます．
+
+### `/lc channel ban <プレイヤーID>`
+
+| パーミッション                                 |
+|-----------------------------------------|
+| `lunaticchat.command.lc.channel.ban` |
+
+指定したプレイヤーを現在アクティブ状態のチャンネルから永久追放します．
+
+永久追放されたプレイヤーはそのチャンネルから即時退出され，再参加できません．
+
+### `/lc channel unban <プレイヤーID>`
+
+| パーミッション                                |
+|----------------------------------------|
+| `lunaticchat.command.lc.channel.unban` |
+
+指定したプレイヤーの永久追放の解除を行います．
+
+### `/lc channel mod <プレイヤーID>`
+
+| パーミッション                              |
+|--------------------------------------|
+| `lunaticchat.command.lc.channel.mod` |
+
+指定したプレイヤーを現在アクティブ状態のチャンネルのモデレーターに昇格/降格させます．
+
+### `/lc channel ownership <プレイヤーID>`
+
+| パーミッション                                    |
+|--------------------------------------------|
+| `lunaticchat.command.lc.channel.ownership` |
+
+指定したプレイヤーに現在アクティブ状態のチャンネルのオーナー権を譲渡します．
+
+譲渡後，元のオーナーにはモデレーター権が付与されます．