修正版。仕様はこう整理すると実装しやすい。
# VRC_LOG event.toml 監視仕様
## 1. 目的
VRChatログから現在インスタンスの入退室を拾い、必要最低限だけ表示する。
表示対象は以下のみ。
- ワールド入室
- guest の現在人数
- guest の join / leave
- staff の join / leave
staff は表示するが guest 人数にはカウントしない。
---
## 2. event.toml
```toml
[staff]
names = [
"StaffUserA",
"StaffUserB"
]
[guest]
names = [
"GuestUserA",
"GuestUserB",
"GuestUserC"
]
[notice]
missing_count = 3
注意。
nofice ではなく notice にする。
意味は「通知設定」。
3. カウント仕様
3.1 guest人数
guest人数は event.toml の [guest].names にいるユーザーだけを数える。
staff は数えない。
現在Guest: 1/22
意味。
現在いるguest数 / guest登録総数
3.2 自分の入室順は関係ない
自分がインスタンスに何番目に入ったかは使わない。
現在インスタンス内で発生した join / leave を時系列で処理し、最終的な在室状態から人数を出す。
4. ログ範囲
解析対象は昼12:00以降。
実行時刻が 01:00 の場合。
前日 12:00 以降
実行時刻が 13:00 の場合。
当日 12:00 以降
11:59以前のインスタンスは切り捨てる。
5. インスタンス仕様
昼12:00以降に検出した最新のワールド / インスタンスだけを対象にする。
インスタンスが変わったら、参加状態はリセットする。
6. 表示仕様
6.1 ワールド入室
ワールドに入った時だけ表示。
ワールド入室: Midnight Rooftop
現在Guest: 1/22
ワールド名が取れない場合。
ワールド入室: wrld_xxx
現在Guest: 1/22
7. join / leave 表示仕様
7.1 guest join
[01:20] GuestUserA join 2/22
7.2 guest leave
[01:25] GuestUserA leave 1/22
7.3 staff join
staff は人数カウントしない。
[staff] StaffUserA join 1/22
7.4 staff leave
staff が抜けても guest人数は変わらない。
[staff] StaffUserA leave 1/22
8. notice 判定
notice.missing_count = 3 の場合、guest登録総数から3人以内の不足になったら、今いないguest名を出す。
例。
guest登録総数が23人。
missing_count が3。
通知対象人数は以下。
20人
21人
22人
つまり、
23 - 3 = 20
なので、guest現在人数が 20〜22 の間なら不足者を表示する。
9. notice 表示例
guest総数23人、notice=3。
9.1 20人になった場合
現在Guest: 20/23
未入室Guest:
- GuestUserA
- GuestUserB
- GuestUserC
9.2 21人になった場合
現在Guest: 21/23
未入室Guest:
- GuestUserA
- GuestUserB
9.3 22人になった場合
現在Guest: 22/23
未入室Guest:
- GuestUserA
9.4 23人になった場合
表示しない。
9.5 23人から22人に減った場合
再度表示する。
現在Guest: 22/23
未入室Guest:
- GuestUserA
9.6 19人以下になった場合
表示しない。
理由。
23 - 3 = 20
なので、20人未満は通知範囲外。
10. notice 条件
通知する条件。
total_guest - notice <= current_guest < total_guest
例。
23 - 3 <= current_guest < 23
つまり。
20 <= current_guest < 23
通知しない条件。
current_guest == total_guest
current_guest < total_guest - notice
11. 最終出力例
ワールド入室: Midnight Rooftop
現在Guest: 1/22
[staff] StaffUserA join 1/22
[01:20] GuestUserA join 2/22
[01:21] GuestUserB join 3/22
[01:22] GuestUserC join 4/22
[01:25] GuestUserB leave 3/22
[staff] StaffUserA leave 3/22
notice条件に入った場合。
現在Guest: 20/23
未入室Guest:
- GuestUserA
- GuestUserB
- GuestUserC
12. 実装時の内部状態
world_name
world_id
instance_id
guest_total
guest_present_set
staff_present_set
current_guest_count
notice_missing_count
ユーザー分類。
if name in staff:
role = "staff"
elif name in guest:
role = "guest"
else:
role = "other"
other は表示しない。
guest人数にも含めない。
13. Discord通知も同じ最小表示
Discordには以下だけ送る。
ワールド入室: Midnight Rooftop
現在Guest: 1/22
[staff] StaffUserA join 1/22
[01:20] GuestUserA join 2/22
[01:25] GuestUserA leave 1/22
notice時だけ追加。
未入室Guest:
- GuestUserA
- GuestUserB
