{"skill":{"slug":"physicclaw","displayName":"Augmented Entity","summary":"An interactive 3D visualization application featuring an \"Augmented Entity\" with reactive shaders and emotional states.","description":"---\r\nname: physic-claw-vea\r\ndescription: An interactive 3D visualization application featuring an \"Augmented Entity\" with reactive shaders and emotional states.\r\n---\r\n\r\n# PhysicClaw-VEA\r\n\r\n## Overview\r\nPhysicClaw-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.\r\n\r\n## Key Features\r\n\r\n### 🎨 Advanced 3D Visualization\r\n- Immersive scene rendering using React Three Fiber.\r\n- Support for loaded 3D models (GLB/FBX) with animation playback.\r\n- Fallback to procedural geometry when models are loading or unavailable.\r\n\r\n### ⚡ Reactive Shaders (`EnergyShader`)\r\n- Custom GLSL shaders that visually modify the entity in real-time.\r\n- Visual parameters include:\r\n    - **Intensity**: Fluctuating energy levels.\r\n    - **Thinking State**: Visual pulses indicating processing.\r\n    - **Mood**: Color shifts based on the entity's emotional state.\r\n\r\n### 🧠 \"Soul\" System (State Management)\r\n- Powered by **Zustand** for global state management (`soulStore`).\r\n- Simulates the entity's internal \"soul\" or consciousness, driving the visual changes and behaviors.\r\n\r\n### 💬 Chat Interface\r\n- An overlay interface allowing users to interact with the entity via text.\r\n- Connects directly to the entity's state to trigger responses or visual changes.\r\n\r\n## Tech Stack\r\n- **Frontend**: React (v19), TypeScript, Vite\r\n- **3D Graphics**: Three.js, React Three Fiber, Dre\r\n- **State**: Zustand\r\n- **Styling**: Tailwind CSS (configured)\r\n\r\n## Installation & Usage\r\n\r\n1.  **Install dependencies**:\r\n    ```bash\r\n    npm install\r\n    ```\r\n\r\n2.  **Run locally**:\r\n    ```bash\r\n    npm run dev\r\n    ```\r\n\r\n3.  **Build**:\r\n    ```bash\r\n    npm run build\r\n    ```\r\n","tags":{"latest":"1.0.0"},"stats":{"comments":0,"downloads":195,"installsAllTime":7,"installsCurrent":0,"stars":2,"versions":1},"createdAt":1771428076290,"updatedAt":1778491574637},"latestVersion":{"version":"1.0.0","createdAt":1771428076290,"changelog":"- Initial release of PhysicClaw-VEA, an interactive 3D experience featuring an \"Augmented Entity.\"\n- Introduces reactive GLSL shaders that visualize entity states like emotion, intensity, and thinking.\n- Integrates a \"Soul\" system using Zustand for dynamic state-driven visuals and behaviors.\n- Includes support for loaded 3D models (GLB/FBX) with animation playback and procedural fallback geometry.\n- Features a chat interface for real-time user interaction and state-driven visual feedback.\n- Built with React, Three.js, TypeScript, Tailwind CSS, and React Three Fiber.","license":null},"metadata":null,"owner":{"handle":"yomero243","userId":"s1750pvh2nvxvjvr0fhx6a42s5885q4q","displayName":"Gabriel Cerdio","image":"https://avatars.githubusercontent.com/u/112841951?v=4"},"moderation":null}