summaryrefslogtreecommitdiff
path: root/docs/src/guide/admin/management-data.md
blob: 5527ffa0b25d946fa9a0e091801694b6ce1f0c4b (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
# データ・ログ

::: danger 編集厳禁

これらのデータファイルは LunaticChat の動作に不可欠です.直接編集すると,データの破損や予期せぬ動作を引き起こす可能性があります.データのバックアップを取る場合を除き,これらのファイルを直接編集しないでください.

:::

## データの保存場所

LunaticChat は、チャンネルデータや設定情報をローカルディスクに保存します.

- `channels.json`: チャンネル情報を保存するファイルです.
- `chatmodes.json`: プレイヤーのチャットモード設定を保存するファイルです.
- `conversion_cache.json`: チャンネル変換のキャッシュを保存するファイルです.
- `player-settings.yaml`: プレイヤーごとの設定情報を保存するファイルです.

::: tip 定期的なバックアップ

LunaticChat のデータの安全性を確保するために,定期的にバックアップを作成することをお勧めします.

:::

### `channels.json`

`channels.json` ファイルは、LunaticChat が管理するチャンネルの情報を保存します.このファイルには,チャンネル名、参加者リスト、チャットモードなどの情報が含まれます.

```json
{
    "channels": {
        "general-channel": {
            "id": "general-channel",
            "name": "一般チャンネル",
            "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`

`chatmodes.json` ファイルは、プレイヤーのチャットモード設定を保存します.このファイルには,プレイヤーごとのチャットモード情報が含まれます.

```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`

`conversion_cache.json` ファイルは、チャンネル変換のキャッシュを保存します.このファイルには,プレイヤーごとのチャンネル変換情報が含まれます.

キャッシュシステムに関する詳細は [こちら](./cache.md) をご覧ください.


```json
{"version":"1","entries":{"hi":"日"}}
```

### `player-settings.yaml`

`player-settings.yaml` ファイルは、プレイヤーごとの設定情報を保存します.このファイルには,プレイヤーの個別設定が含まれます.

```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
```

## キャッシュバージョン

ディスクキャッシュに使用されるファイルには `version` フィールドが含まれており,LunaticChat のバージョンアップに伴うキャッシュフォーマットの変更に対応しています.

バージョンが不一致の場合,LunaticChat はキャッシュファイルを **古い形式のキャッシュ** として認識し,内容を無視して新しい形式で再作成します.

```json
{"version":"1","entries":{}}
```