Remove redundant README_EN.md

Browse files

Files changed (1) hide show

README_EN.md +0 -152

README_EN.md DELETED Viewed

@@ -1,152 +0,0 @@
-# 🍬 Jelly Bean PlayEngine: 10 Pop Physics Bricks (English Documentation)
-[![MuJoCo](https://img.shields.io/badge/MuJoCo-WebAssembly%20(500Hz%20PGS)-E11D48?logo=google)](https://mujoco.org) [![Physics Core](https://img.shields.io/badge/Physics-10--in--1%20Procedural%20Bricks-9d4edd)](https://huggingface.co/spaces/hwihwalab/mujoco-physics-playengine) [![Engine](https://img.shields.io/badge/Engine-100%25%20Client--Side%20WASM%20(60%20FPS)-06B6D4)](https://huggingface.co/spaces/hwihwalab/mujoco-physics-playengine) [![Robotics](https://img.shields.io/badge/Robotics-LQR%20%C2%B7%20Pure%20Pursuit%20%C2%B7%20IK-10B981)](https://huggingface.co/spaces/hwihwalab/mujoco-physics-playengine) [![Audio](https://img.shields.io/badge/Audio-0%20KB%20Web%20Audio%20Synthesis-ff7b00)](https://huggingface.co/spaces/hwihwalab/mujoco-physics-playengine)
-> “**Jelly Bean PlayEngine: 10-in-1 Cute Playable Physics Arcade & Physical AI Sandbox | HWIHWA LAB**
-> A high-performance interactive physics playground and autonomous robotics sandbox built on Google DeepMind's MuJoCo WebAssembly engine (60 FPS Three.js WebGL client-side rendering) and 500Hz PGS numerical solver ($dt=0.002\text{s}$). Features 10 standalone procedural physics bricks, zero Docker/backend server dependency, autonomous robotics controllers (LQR inverted pendulum balancer, Pure Pursuit waypoint navigation, 3-stage Inverse Kinematics claw rescue, ballistic demolition sniper), 3-way camera perspective switching, and zero-asset procedural 8-bit chiptune audio synthesis.
->
-> 🌐 [English Documentation](https://huggingface.co/hwihwalab/mujoco-physics-playengine) | 🇰🇷 [한국어 매뉴얼](https://huggingface.co/hwihwalab/mujoco-physics-playengine/blob/main/README_KR.md) | 🍬 [Interactive 3D Arcade](https://huggingface.co/spaces/hwihwalab/mujoco-physics-playengine)”
-> *Developed by [Hwihwa Lab](https://github.com/Hwihwa-Lab) · AI × Automation × Aesthetics ✨*
-<div align="center">
-  <img src="assets/banner.png" alt="Jelly Bean PlayEngine 10 Physics Bricks" width="100%" style="border-radius: 16px; margin: 16px 0;">
-</div>
----
-## ⚡ Real-Time Physics & Robotics Architecture
-**Jelly Bean PlayEngine** transforms academic multi-body dynamics into a vibrant, high-performance 3D arcade. Built on **MuJoCo WebAssembly** with a 500Hz numerical solver (`dt=0.002s`) and 60 FPS Three.js WebGL client-side rendering, it delivers zero-latency interactive physics with 100% procedural geometric assets, autonomous robotics controllers (LQR, Pure Pursuit, Inverse Kinematics), zero Docker or server dependencies, and pure Web Audio API sound synthesis.
-* **500Hz PGS Solver**: Differential timestep $dt=0.002\text{s}$ with Projected Gauss-Seidel contact solver solves multi-body collisions, non-linear double pendulums, and friction cones accurately.
-* **100% Client-Side WebAssembly**: 60 FPS WebGL Three.js client-side execution eliminates server lag and runs seamlessly directly inside any modern web browser.
-* **0-Byte Procedural Assets**: Zero external textures or 3D meshes to download; everything is synthesized via MuJoCo XML and Web Audio API oscillators.
----
-## ⭐ The 4 Major System Upgrades
-1. **🏆 Game-Specific Victory Banners with Confetti & Fanfares**:
-   - Every mini-game features clear win conditions (e.g., `DOMINO CLEARED!`, `ALL COINS COLLECTED!`, `PINK BEAN WINS!`, `360° LOOP MASTER!`, `TOWER ANNIHILATED!`, `GOLDEN BALANCER!`).
-   - Celebrated with dynamic canvas particle confetti explosions and browser-synthesized brass fanfares.
-2. **🎥 3-Way Camera Perspective Switcher**:
-   - Seamlessly switch between **Front View (`cam_front`)**, **45° Quarter Isometric (`cam_quarter`)**, and **Top-Down Aerial (`cam_topdown`)** with a single click or by pressing the **[C]** key.
-3. **🎵 Kawaii 8-Bit Chiptune BGM (Pure Web Audio API)**:
-   - Zero-byte download footprint: 100% procedurally synthesized in JavaScript via Web Audio API oscillators.
-   - Upbeat pentatonic arpeggios with syncopated bouncy bassline. Toggle on/off anytime via the top header button `[🎵 BGM ON/OFF]`.
-4. **🤖 10-Game Smart AI Autonomous Controllers**:
-   - In addition to human manual keyboard control, press **[M]** or click **[🤖 SMART AI]** to engage autonomous robotics controllers:
-     - **Game 01**: 1.6s Optimal Rhythm Drop AI
-     - **Game 02**: Ball Pool Dual-Flipper Reaction Reflex AI
-     - **Game 03**: Ballistic Domino Impact Striker AI
-     - **Game 04**: Phase-Resonance 360° Swing Momentum Pumping AI
-     - **Game 05**: Double Pendulum Acrobat Kick AI
-     - **Game 06**: Hydrodynamic Slipstream Photo-Finish Boost AI
-     - **Game 07**: LQR Inverted Pendulum Lollipop Cart Balancer AI
-     - **Game 08**: Pure Pursuit Autonomous Navigation & 5-Coin Collector AI
-     - **Game 09**: 3-Stage Inverse Kinematics (IK) Plushie Claw Rescue AI
-     - **Game 10**: Center-of-Mass (CoM) Ballistic Demolition Sniper AI
----
-## 🧸 The 10 Pop Physics Mini-Games & Controls
-### 🎮 Universal Global Keyboard Shortcuts
-| Key | Function | Description |
-|:---:|:---|:---|
-| **`Space`** | **Primary Action Trigger** | Start simulation / Drop bean / Flap pinball rain / Strike domino / Acrobatic kick / Fire cannon |
-| **`R`** | **Instant Reset** | Rebuilds arena and resets all objects, timers, and HUD metrics to initial ready state |
-| **`C`** | **Cycle 3-Way Camera** | Switches perspective instantly: `Front 🎥` ➔ `45° Quarter 📐` ➔ `Top-Down 🚁` |
-| **`M`** | **Smart AI / Manual Mode** | Toggles between Human Manual Control and Autonomous Smart AI Auto-Pilot |
-| **`F`** | **16:9 Widescreen Fullscreen** | Toggles immersive full-screen arcade viewport |
-### 🕹️ 10 Mini-Games Dual Controls (WASD & Arrow Keys)
-| # | Game Title | MuJoCo Physics Core | Target Goal & Win Condition | Controls (Dual WASD & Arrow Keys) |
-|---|------------|---------------------|-----------------------------|-----------------------------------|
-| **01** | **Jelly Bean Skydiving Party** | Multi-Agent Gravity & Floor Impact | Drop beans from the sky to safely pile up on foam mat | `Space`: Drop Extra Bean, `R`: Reset |
-| **02** | **Ball Pool Pinball Carnival** | Multi-Body Elastic Collision & Contact | Flip bumpers to bounce gumballs and score 1,000 pts | `A`/`D` or `←`/`→`: Left/Right Flippers, `Space`: Rain |
-| **03** | **Domino Knockdown Strike** | Kinetic Chain Reaction & Momentum Transfer | Topple 7 dominoes to strike down the Gold Star target | `Space`: Strike 1st Domino, `R`: Reset |
-| **04** | **Giant Carnival Swing 360°** | Revolute Joint Kinematics & Resonance | Rhythm pumping to overcome gravity and execute a 360° loop | `W`/`↑` or `Space`: Momentum Pump, `R`: Reset |
-| **05** | **Jelly Bean Acrobatic Twin** | Double Pendulum Chaotic Dynamics | Direct joint torque & aerial 3x somersault combo in the sky | `W`/`S` or `↑`/`↓` (Joint 1), `A`/`D` or `←`/`→` (Joint 2), `Space`: Chaos Kick |
-| **06** | **Waterpark Candy Slide Race** | Incline Tribology & Coulomb Friction | Pink Bean vs Mint Bean! Slide down rainbow ramp to splash pool | `Space`: Start, `A`/`←`: Pink Boost, `D`/`→`: Mint Boost |
-| **07** | **Pudding Cart Balancer (⭐ Flagship)** | **CartPole / Inverted Pendulum (RL)** | Balance Pink Bean on cart for 15s to win Golden Balancer | `A`/`D` or `←`/`→`: Push Cart, `M`: AI Mode |
-| **08** | **Bumper Car Coin Collector** | **4-Wheel Chassis & Traction Dynamics** | Drive bumper car around arena to collect all 5 Star Coins | `W`/`S`/`A`/`D` or `↑`/`↓`/`←`/`→`: Drive & Steer (Compound Hold) |
-| **09** | **Toy Claw Machine & Plushie Bean** | **2-DOF Robotic Arm (Robotics)** | Position robotic arm and activate magnetic grip to rescue plushie | `W`/`S` or `↑`/`↓`: Shoulder, `A`/`D` or `←`/`→`: Elbow, `Space`: Magnet |
-| **10** | **Macaron Tower & Cannonball Bean** | Multi-Body Structural Collapse & Ballistics | Adjust cannon power and fire cannonball to crush 9-story tower | `Space`: Fire Cannon, `W`/`S` or `↑`/`↓`: Power (0.4x~2.5x) |
----
-### 🕹️ Analysis of Game Control Paradigms (5 Distinct Types)
-Each game utilizes a physical interaction paradigm tailored to its underlying dynamics:
-1. **Single-Shot Trigger**:
-   - **01 Skydiving** / **03 Domino** / **10 Cannon**: Press `Space` once to trigger ballistic trajectories and collapse.
-2. **Continuous Force Hold**:
-   - **02 Pinball**: Hold `A`/`D` or `←`/`→` to keep flippers energized; release to return via spring physics.
-   - **07 Cart Balancer**: Hold `A`/`D` or `←`/`→` to continuously apply lateral force to the cart.
-3. **Resonance Rhythm Pumping**:
-   - **04 Giant Swing**: Tap `W` / `↑` / `Space` in phase with angular velocity to pump resonance energy towards a 360° loop.
-4. **Multi-Joint Actuation**:
-   - **05 Acrobatic**: `W`/`S` controls shoulder joint torque, `A`/`D` controls elbow torque, and `Space` executes an aerial flip.
-   - **09 Claw Crane**: `W`/`S` adjusts shoulder angle, `A`/`D` adjusts elbow angle, and `Space` toggles magnetic suction.
-5. **Compound Multi-Key Steering**:
-   - **08 Bumper Car**: Simultaneous multi-key input (`W`+`D` or `↑`+`→`) allows drifting and turning simultaneously.
----
-## 💻 Run Locally (Standalone Desktop App Mode)
-Run in native desktop cockpit mode without web browser chrome or address bars:
-```bash
-# 1. Clone repository
-git clone https://huggingface.co/spaces/hwihwalab/mujoco-physics-playengine
-cd mujoco-physics-playengine
-# 2. Install dependencies (6 lightweight packages)
-pip install -r requirements.txt
-# 3. Launch Standalone Cockpit Window
-python run.py
-```
-*(Windows users can simply double-click `PlayEngine.bat` to launch instantly)*
----
-## 📦 Copy Standalone Physics Brick Code
-Click the **`[📋 COPY PYTHON / XML CODE]`** button in the bottom right corner of the cockpit to copy standalone snippets:
-1. **`Python Script` tab**: Self-contained script launching MuJoCo's official native 3D viewer window with real-time AI and physics (`pip install mujoco`).
-2. **`MuJoCo XML (Blueprint)` tab**: Pure declarative physics XML scene for C++, Rust, Unity, Unreal, or Gymnasium reinforcement learning environments.
----
-## 📂 Repository Contents
-* `README.md`: Official Model Card overview on Hugging Face Model Hub.
-* `README_EN.md`: Comprehensive English manual (this document).
-* `README_KR.md`: Comprehensive Korean manual ([한국어 매뉴얼](README_KR.md)).
-* `mujoco_playengine_bundle.zip`: Full production bundle containing all 10 MuJoCo procedural physics bricks, LQR/IK controllers, FastAPI server, and zero-asset Cybernetic Bento web cockpit.
-* `assets/banner.png`: Official 16:9 3D rendered showcase cover banner.
-* `LICENSE`: Official Apache 2.0 open-source license.
----
-## 👤 About HWIHWA LAB
-> *“AI × Automation × Aesthetics — Crafting tools you'll love ✨”*
-**HWIHWA LAB** is an independent AI research & engineering studio dedicated to blending **practical on-device intelligence, autonomous operations, and refined aesthetics**. We engineer resilient systems that free solopreneurs and indie creators from operational overhead—giving people their time and creative joy back.
-### 🌐 Physical AI & Robotics Ecosystem (Cross-Links)
-- **Official Hub**: [🤗 Hugging Face (@hwihwalab)](https://huggingface.co/hwihwalab)
-- 🍬 **Physics Bricks & Web Arcade**: [mujoco-physics-playengine](https://huggingface.co/spaces/hwihwalab/mujoco-physics-playengine) *(Current Project)*
-- 🕹️ **Inverted Pendulum Control (PPO)**: [cartpole-v1-ppo](https://huggingface.co/hwihwalab/cartpole-v1-ppo)
-- 🤖 **Bimanual Robotic Manipulation**: [act-aloha-sim-transfer-cube](https://huggingface.co/hwihwalab/act-aloha-sim-transfer-cube)
-- 🦆 **3D Bipedal Locomotion & Teleop**: [microduck-3d-bipedal-teleop](https://huggingface.co/spaces/hwihwalab/microduck-3d-bipedal-teleop)
-- 🍫 **Indie Game Studio Decision Brain**: [CHOCO-BRAIN-v1](https://huggingface.co/hwihwalab/connectailab-CHOCO-BRAIN-v1)
----
-## 📜 License
-Distributed under the Apache 2.0 License. See `LICENSE` for details.