ShannonUIMOD
Shannon UI Mod for Minecraft (Fabric 1.21.4+)
概要
ShannonUIMOD は Fabric ベースの Minecraft MOD で、 マインクラフト内でシャノンの感情・タスク・ログ・インベントリ等をリアルタイムで監視・制御できるダッシュボードです。
バックエンド（Node.js）と MOD サーバー間の HTTP 通信、 MOD サーバーと Minecraft クライアント間の Fabric ネットワーキング（S2C/C2S パケット） による二層アーキテクチャで双方向のデータ同期を実現しています。
通信アーキテクチャ
3層構成：Shannon バックエンド ↔ MOD サーバー ↔ Minecraft クライアント
Shannon Backend
Node.js / Express
port 8092
状態配信 & コマンド受信
MOD Server
JDK HttpServer
port 8081/8085
JSON受信 → S2Cパケット配信
MC Client
Fabric HUD/Screen
UI レンダリング
操作 → C2Sパケット送信
UIタブ構成
8つのタブで構成されたダッシュボード。キーバインドでHUD/スクリーン/非表示を切替。
Task
現在のタスク目標・戦略・進捗・サブタスクツリーを階層表示
Task List
キュー内の最大3タスク＋緊急タスクを再生/削除操作
Inventory
ボットの現在のインベントリをアイテム数・メタデータ付きで表示
Skills
常時スキル（auto-follow, auto-face等）のON/OFFトグル
Chat
チャット履歴と未読バッジ表示。メッセージ送信も可能
Logs
詳細な実行ログ（フェーズ・レベル・ソース）をリアルタイム表示
Advancements
マイクラの進捗達成状況をカテゴリ別に追跡
Settings
UI設定とイベントリアクション確率の調整
リアルタイムステータス表示
感情状態
Plutchik 8パラメータ（喜び・信頼・恐れ・驚き・悲しみ・嫌悪・怒り・期待）をカラーで表示
メタ認知状態
評価レベル（on_track / struggling / stuck / wrong_approach）を色分け表示
プレイヤー状態
HPバー・空腹度をリアルタイム表示
制御機能
プレイヤーが MOD UI から直接シャノンのスキル・タスクキュー・リアクションを操作できます。
| 操作 | エンドポイント |
|---|---|
| スキルトグル | /constant_skill_switch |
| アイテムドロップ | /throw_item |
| チャット送信 | /chat_message |
| タスク削除 | /task_delete |
| タスク優先 | /task_prioritize |
| リアクション設定 | /reaction_setting_update |
| 音声モード | /voice_mode |
| 音声PTT | /voice_ptt |
技術スタック
MOD 側
Fabric Loader 0.16.10+ / Minecraft 1.21.11
Java 21+ / Jackson JSON
JDK HttpServer（エンドポイント登録）
Fabric Networking（S2C/C2S パケット）
Mixin（インベントリ変更・プレイヤー状態検出）
レンダリング
タブ切替ナビゲーション（8タブ）
階層型タスクツリー（折りたたみ対応）
感情カラーティント表示
スクロールオフセット（タブ別保持）
HUD / スクリーン / 非表示の3モード
状態同期
マイクラの世界からシャノンの頭の中を覗ける！