PhysicClaw-VEA
Overview
PhysicClaw-VEA is an advanced interactive 3D experience built with React Three Fiber and Three.js. The core of the application is an "Augmented Entity" that dynamically reacts to simulated internal states such as "thinking", emotions, and intensity levels through custom shaders and animations.
Key Features
🎨 Advanced 3D Visualization
- Immersive scene rendering using React Three Fiber.
- Support for loaded 3D models (GLB/FBX) with animation playback.
- Fallback to procedural geometry when models are loading or unavailable.
⚡ Reactive Shaders (EnergyShader)
- Custom GLSL shaders that visually modify the entity in real-time.
- Visual parameters include:
- Intensity: Fluctuating energy levels.
- Thinking State: Visual pulses indicating processing.
- Mood: Color shifts based on the entity's emotional state.
🧠 "Soul" System (State Management)
- Powered by Zustand for global state management (
soulStore).
- Simulates the entity's internal "soul" or consciousness, driving the visual changes and behaviors.
💬 Chat Interface
- An overlay interface allowing users to interact with the entity via text.
- Connects directly to the entity's state to trigger responses or visual changes.
Tech Stack
- Frontend: React (v19), TypeScript, Vite
- 3D Graphics: Three.js, React Three Fiber, Dre
- State: Zustand
- Styling: Tailwind CSS (configured)
Installation & Usage
- Install dependencies:
```bash
npm install
```
- Run locally:
```bash
npm run dev
```
- Build:
```bash
npm run build
```