Prototype E.R.O.S. (Emotion Reproduction Operating System)

Prototype E.R.O.S. is an experimental Minecraft Forge mod that connects Minecraft to a local llama.cpp server, powered by a custom 3D Neural Network Emotion Engine.

Instead of relying on external cloud APIs or generic robotic responses, E.R.O.S. runs entirely on your local PC and features an internal emotional state that dynamically shifts based on in-game survival situations.

🌟 Key Features

• 100% Local & Offline LLM Integration (llama.cpp / HTTP) Communicates with a locally hosted llama-server over localhost. Zero external API keys, zero cloud subscriptions, and zero privacy concerns. Asynchronous processing ensures zero main-thread lag or crash risks.
• 3D Neural Network Emotion Engine (ERD System) Processes player biological and environmental stress parameters ($\alpha$-waves, $\beta$-waves, Heart Rate) through a neural network to calculate 27 distinct emotional states (e.g., Alert, Melancholic, Joyful, Cautious).
• Dynamic Contextual Prompting The AI's responses adapt in real-time to your current situation—whether you are peacefully resting in bed, fighting for survival at low HP, or exploring dark caves.
• Highly Configurable Tweak thread count, context size, max token length, and system prompts easily via the mod config file.

🛠️ How to Use

1. Download and install Prototype E.R.O.S. for Minecraft 1.20.1 (Forge).
2. Download llama.cpp (with llama-server), extract the Zip archive, rename the extracted folder to llama, and place it inside your .minecraft/config/ directory.
3. Prepare a compatible .gguf model file (e.g., lightweight models like SmolLM, Gemma, or Phi-2).
4. Rename your model file to llm_model.gguf and place it directly inside .minecraft/config/.
5. Launch the game—the mod will automatically manage the local server!
6. Type !ai <your message> in the in-game chat to talk to the AI!

Note: Since LLM inference runs locally on CPU/GPU via your local machine, performance depends on your PC specs. Adjust settings in config/llmmod-common.toml for optimal performance.

📖 Technical Background

Developed as part of the A Pastoral Urban Fantasy universe project, E.R.O.S. bridges the gap between raw AI processing and human-like emotional nuance within a blocky world.

Prototype E.R.O.S. (Emotion Reproduction Operating System)

Prototype E.R.O.S. は、ローカル環境のllama.cppサーバー と独自開発の 「3次元ニューラルネットワーク感情再現装置（ERDSystem）」 を連携させた実験的Minecraft Forge Modです。

外部のクラウドAPIに依存する単なるロボット的AIアシスタントではなく、PCローカル完結の安全な環境で、ゲーム内のサバイバル状況に応じてリアルタイムに内面（感情）を変化させる独自のAI体験を提供します。

🌟 主な特徴

• 完全ローカル・オフラインLLM連携 (llama.cpp / HTTP) PC内部（localhost）で立ち上がる llama-server とローカル通信を行います。外部APIキーや月額課金、個人情報の送信は一切不要です。非同期処理によりメインスレッド（Tick）を止めず、クラッシュリスクも抑えた安全設計です。
• 3次元感情再現エンジン (ERDSystem) プレイヤーのステータス（体力、被ダメージ、睡眠状態など）を擬似的な脳波（$\alpha$波・$\beta$波）や心拍数パラメータに変換。ニューラルネットワーク層を通じて27通りの感情状態（警戒、憂鬱、歓喜、達観 など）をリアルタイムに算出します。
• 動的コンテキスト・プロンプト ベッドで休んでいる穏やかな時、体力が削られて窮地に陥っている時など、プレイヤーの置かれた状況によってAIの情緒や返答のトーンが変化します。
• 柔軟な設定 Configファイルから、スレッド数、コンテキストサイズ、最大生成トークン数、システムプロンプトをPCスペックに合わせて自由に調整可能です。

🛠️ 使い方・導入方法

1. Minecraft 1.20.1 (Forge) 環境に Mod ファイルを導入します。
2. llama-server を含む llama.cpp のZipファイルをダウンロードして解凍し、フォルダ名を llama に変更します。
3. 名前を変更した llama フォルダを .minecraft/config/ フォルダ内に配置します。
4. お好みの .gguf 形式の軽量モデル（SmolLM, Gemma, Phi-2 など）を用意します。
5. モデルのファイル名を llm_model.gguf に変更し、.minecraft/config/ フォルダ直下に配置します。
6. ゲームを起動し、チャット欄で !ai <話しかけたい内容> と入力するとAIが思考・返答します。

注意: 推論処理はご使用のPC環境（CPU/GPU）に依存します。重く感じられる場合は config/llmmod-common.toml 内の threadCount や maxTokens の値を調整してください。

📖 開発背景

本Modは『A Pastoral Urban Fantasy』プロジェクトの一環として、無機質なAI技術と温かみのある人間的情緒の融合を目指して開発されたプロトタイプです。