docs: Add i18n docs

5 files changed, 312 insertions, 1 deletions

diff --git a/docs/.vitepress/config/en.ts b/docs/.vitepress/config/en.ts
index 6aec245..5718a4e 100644
--- a/docs/.vitepress/config/en.ts
+++ b/docs/.vitepress/config/en.ts
@@ -30,6 +30,14 @@ export const en: DefaultTheme.Config = {
             text: 'Velocity Integration',
             link: '/en/guide/admin/velocity',
           },
+          {
+            text: 'Channel Chat Deployment Guide',
+            link: '/en/guide/admin/introduction-channel-chat',
+          },
+          {
+            text: 'Data and Logs',
+            link: '/en/guide/admin/data-and-logs',
+          },
         ],
       },
       {
@@ -42,7 +50,15 @@ export const en: DefaultTheme.Config = {
               {
                 text: 'Chat Mode',
                 link: '/en/guide/player/channel-chat/chatmode',
-              }
+              },
+              {
+                text: 'Private Channel',
+                link: '/en/guide/player/channel-chat/private-channel',
+              },
+              {
+                text: 'Moderation',
+                link: '/en/guide/player/channel-chat/moderation',
+              },
             ]
           },
           {
diff --git a/docs/src/en/guide/admin/data-and-logs.md b/docs/src/en/guide/admin/data-and-logs.md
new file mode 100644
index 0000000..e869552
--- /dev/null
+++ b/docs/src/en/guide/admin/data-and-logs.md
@@ -0,0 +1,119 @@
+# Data and Logs
+
+::: danger Do Not Edit
+
+These data files are essential to the operation of LunaticChat. Direct editing may cause data corruption or unexpected behavior. Do not directly edit these files unless you are backing up data.
+
+:::
+
+## Data Storage Location
+
+LunaticChat saves channel data and configuration information to local disk.
+
+- `channels.json`: Stores channel information.
+- `chatmodes.json`: Stores player chat mode settings.
+- `conversion_cache.json`: Stores cache for channel conversion.
+- `player-settings.yaml`: Stores player-specific settings.
+
+::: tip Regular Backups
+
+To ensure the safety of your LunaticChat data, we recommend creating regular backups.
+
+:::
+
+### `channels.json`
+
+The `channels.json` file stores information about channels managed by LunaticChat. This file contains information such as channel names, participant lists, and chat modes.
+
+```json
+{
+    "channels": {
+        "general-channel": {
+            "id": "general-channel",
+            "name": "General Channel",
+            "ownerId": "a01e3843-e521-3998-958a-f459800e4d11",
+            "createdAt": 1769507213150,
+            "bannedPlayers": [
+                "ceaea267-39dd-3bac-931c-761ada671ebe"
+            ]
+        }
+    },
+    "members": {
+        "general-channel": [
+            {
+                "channelId": "test2",
+                "playerId": "a01e3843-e521-3998-958a-f459800e4d11",
+                "role": "OWNER",
+                "joinedAt": 1769507213150
+            }
+        ]
+    },
+    "activeChannels": {
+        "a01e3843-e521-3998-958a-f459800e4d11": "test2"
+    }
+}
+```
+
+### `chatmodes.json`
+
+The `chatmodes.json` file stores player chat mode settings. This file contains chat mode information for each player.
+
+```json
+{
+  "modes": {
+    "aed5efd4-551b-3965-bc28-ae21aa072a66": "CHANNEL",
+    "ceaea267-39dd-3bac-931c-761ada671ebe": "CHANNEL",
+    "a01e3843-e521-3998-958a-f459800e4d11": "CHANNEL",
+    "681f539b-8bb8-3f85-85e5-a2945f6c6539": "GLOBAL"
+  }
+}
+```
+
+### `conversion_cache.json`
+
+The `conversion_cache.json` file stores cache for channel conversion. This file contains channel conversion information for each player.
+
+For more information about the cache system, see [here](./cache.md).
+
+
+```json
+{"version":"1","entries":{"hi":"日"}}
+```
+
+### `player-settings.yaml`
+
+The `player-settings.yaml` file stores player-specific settings. This file contains individual player settings.
+
+```yaml
+version: 1
+japaneseConversion:
+  "aed5efd4-551b-3965-bc28-ae21aa072a66": false
+  "ceaea267-39dd-3bac-931c-761ada671ebe": false
+directMessageNotification:
+  "aed5efd4-551b-3965-bc28-ae21aa072a66": true
+  "ceaea267-39dd-3bac-931c-761ada671ebe": true
+channelMessageNotification:
+  "ceaea267-39dd-3bac-931c-761ada671ebe": true
+```
+
+## Cache Version
+
+Files used for disk caching include a `version` field to accommodate changes in cache format as LunaticChat is upgraded.
+
+If the version does not match, LunaticChat recognizes the cache file as **old format cache**, ignores the contents, and recreates it in the new format.
+
+```json
+{"version":"1","entries":{}}
+```
+
+## About CoreProtect
+
+Various chat logs in LunaticChat can also be recorded in CoreProtect without requiring an API.
+
+Logs for each feature can be checked with the following actions. When using the `/co lookup` command, specify the following actions:
+
+- Direct messages: `command`
+- Global chat and channel chat: `chat`
+  - Japanese and romanization conversion is saved according to the player's settings.
+
+
diff --git a/docs/src/en/guide/admin/introduction-channel-chat.md b/docs/src/en/guide/admin/introduction-channel-chat.md
new file mode 100644
index 0000000..2a81d63
--- /dev/null
+++ b/docs/src/en/guide/admin/introduction-channel-chat.md
@@ -0,0 +1,56 @@
+# Channel Chat Deployment Guide
+
+This guide explains how to deploy channel chat.
+
+## What is Channel Chat
+
+Channel chat is a feature that allows players to create channels and share chat among specific players.
+
+For detailed features, please refer to the [Player Guide](../player/channel-chat/about.md).
+
+## Preparing to Deploy Channel Chat
+
+To deploy channel chat, you need to enable the channel chat feature in the LunaticChat configuration file `config.yml`.
+
+1. Stop the server.
+2. Open `plugins/LunaticChat/config.yml`.
+3. Set `features.channelChat.enabled` to `true`.
+4. Restart the server.
+
+This will enable the channel chat feature and allow players to use channel chat.
+
+## Channel Chat Configuration
+
+The configuration items related to channel chat are as follows:
+
+- `features.channelChat.maxChannelsPerPlayer`: Specifies the maximum number of channels a single player can create.
+- `features.channelChat.maxMembersPerChannel`: Specifies the maximum number of members that can join a single channel.
+- `features.channelChat.maxMembershipPerPlayer`: Specifies the maximum number of channels a single player can join.
+
+The default is set to `0`, which means there is no limit.
+
+::: tip Recommended Settings
+
+If you want to actively use the channel chat feature, we recommend setting these values higher.
+
+However, as this may impact server performance, please set them appropriately according to your server's resource situation.
+
+Recommended settings are as follows:
+
+- `features.channelChat.maxChannelsPerPlayer`: `3` to `5`
+- `features.channelChat.maxMembersPerChannel`: `20` to `50`
+- `features.channelChat.maxMembershipPerPlayer`: `5` to `10`
+
+:::
+
+## Channel Management
+
+Basically, [players manage channels themselves](../player/channel-chat/moderation.md).
+
+However, as a server administrator, please note the following:
+
+- Server administrators have owner permissions for all channels. If operations are required, please respond appropriately.
+- To maintain server performance, set limits on the number of channels and members as needed.
+- If inappropriate channels or member behavior occurs, take appropriate action.
+
+If you want to avoid troubles related to channel management, consider restricting moderate commands such as `/lc channel ban`.
diff --git a/docs/src/en/guide/player/channel-chat/moderation.md b/docs/src/en/guide/player/channel-chat/moderation.md
new file mode 100644
index 0000000..3bf8609
--- /dev/null
+++ b/docs/src/en/guide/player/channel-chat/moderation.md
@@ -0,0 +1,95 @@
+# Channel Management
+
+You can manage member behavior within a channel using channel chat moderation features.
+
+::: danger Warning
+
+These moderation features are only available for LunaticChat channel chat.
+
+If you need to punish actual rule violators, we recommend reporting them to the server administrator.
+
+:::
+
+## Moderation Feature Specifications
+
+Moderation features have several specifications:
+
+- Players with Bypass permissions are not affected by moderation features.
+  - This means you cannot use these features against server administrators.
+- To use moderation features, you need the respective channel role and server permissions.
+- The effects of moderation features are independent for each channel.
+  - For example, a player permanently banned (BAN) from one channel can chat normally in other channels.
+
+## Roles
+
+Channels have the following roles:
+
+- Member: Regular players participating in the channel
+- Moderator: Players who can use channel moderation features
+- Owner: The channel creator who can use all moderation features
+
+::: tip Moderation by Server Administrators
+
+Server administrators uniformly have the same permissions as owner permissions in all channels.
+
+:::
+
+## Temporarily Expel a Member (Kick)
+
+To temporarily expel a member from a channel, use the [`/lc channel kick`](../../../reference/commands/lc/channel.md#lc-channel-kick-player-id) command.
+
+```
+/lc channel kick <player ID>
+```
+
+Executing this command will immediately expel the specified player from the channel.
+
+However, the expelled player can rejoin.
+
+## Permanently Ban a Member (Ban)
+
+To permanently ban a member from a channel, use the [`/lc channel ban`](../../../reference/commands/lc/channel.md#lc-channel-ban-player-id) command.
+
+```
+/lc channel ban <player ID>
+```
+
+Executing this command will immediately expel the specified player from the channel and also prohibit them from rejoining.
+
+## Unban a Permanently Banned Member
+
+To unban a permanently banned member, use the [`/lc channel unban`](../../../reference/commands/lc/channel.md#lc-channel-unban-player-id) command.
+
+```
+/lc channel unban <player ID>
+```
+
+## Appoint/Dismiss Moderators
+
+To appoint/dismiss a channel member as a moderator, use the [`/lc channel mod`](../../../reference/commands/lc/channel.md#lc-channel-mod-player-id) command.
+
+```
+/lc channel mod <player ID>
+```
+
+Executing this command will appoint the specified player as a moderator. Executing this command again on an appointed player will dismiss them from being a moderator.
+
+## Transfer Owner Permissions
+
+To transfer channel owner permissions to another member, use the [`/lc channel ownership`](../../../reference/commands/lc/channel.md#lc-channel-ownership-player-id) command.
+
+```
+/lc channel ownership <player ID>
+```
+
+Executing this command will transfer all owner permissions to the specified player. The original owner becomes a moderator.
+
+::: danger Important Notes on Execution
+
+- Owner permission transfer is an irreversible operation.
+    - Once transferred, the original owner cannot regain owner permissions unless the player with owner permissions transfers them again.
+    - This applies even to server administrators.
+- The recipient of owner permissions must be a member of the channel.
+- Owner permissions can use all moderation features and delete the channel, which is a powerful privilege. Choose carefully to whom you transfer permissions.
+
+:::
diff --git a/docs/src/en/guide/player/channel-chat/private-channel.md b/docs/src/en/guide/player/channel-chat/private-channel.md
new file mode 100644
index 0000000..3b33559
--- /dev/null
+++ b/docs/src/en/guide/player/channel-chat/private-channel.md
@@ -0,0 +1,25 @@
+# Private Channels
+
+Private channels are chat channels that only specific users can join.
+
+## Creating a Private Channel
+
+To create a private channel, use the [`/lc channel create`](../../../reference/commands/lc/channel.md) command and specify `true` for the private setting argument.
+
+```
+/lc channel create <channel ID> <channel name> [channel description] [private setting]
+```
+
+## Inviting to a Channel
+
+Private channels are not listed in the `/lc channel list` command and cannot be joined using the `/lc channel join` command.
+
+To join, you need to receive an invitation from the owner or moderator.
+
+To invite someone, use the [`/lc channel invite`](../../../reference/commands/lc/channel.md#lc-channel-invite-player-id) command.
+
+```
+/lc channel invite <player ID>
+```
+
+The invited player automatically joins the channel.