hwihwalab/mujoco-physics-playengine

🍬 Jelly Bean PlayEngine: 10 Pop Physics Bricks & Robotics Sandbox

“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 | 🇰🇷 한국어 매뉴얼 | 🍬 Interactive 3D Arcade”
Developed by Hwihwa Lab · AI × Automation × Aesthetics ✨

---

🌐 English Documentation

⚡ 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.

+---------------------------------------------------------------------------------------------------+
| 🍬 JELLY BEAN PLAYENGINE                                                    [STATUS: ENGINE LIVE] |
| Physical AI Sandbox & Arcade | HWIHWA LAB                                                         |
+---------------------------------+---------------------------------+-------------------------------+
| 👈 10 CUTE PHYSICS BRICKS       | 🎮 3D INTERACTIVE VIEWPORT      | 👉 PARAMETER CONTROL DECK     |
| - 01 Jelly Bean Skydiving Party | - 60 FPS Three.js WebGL (WASM)  | - Human vs Smart AI Toggle    |
| - 02 Ball Pool Pinball Carnival | - 3-Way Camera (Front/45°/Top)  | - Gravity Accelerator Slider  |
| - 03 Domino Knockdown Strike    | - Victory Particle Confetti     | - Dynamic Cannon Power Tuning |
| - ... 10 Macaron Tower Cannon   | - Keyboard Input Visualizer     | - Standalone Python/XML Code  |
+---------------------------------+---------------------------------+-------------------------------+

---

⭐ 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.
   • 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, every mini-game features an intelligent autonomous AI controller:
     • 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 & Gameplay	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)

---

🚀 Run Locally (Standalone Desktop App Mode)

Clone and run in zero-install standalone desktop app mode (no browser address bar):

git clone https://huggingface.co/spaces/hwihwalab/mujoco-physics-playengine
cd mujoco-physics-playengine

# Install dependencies
pip install -r requirements.txt

# Launch Standalone Cockpit Window (No address bar)
python run.py

(Windows users can simply double-click PlayEngine.bat)

---

📂 Repository Contents

• README.md: Official Model Card overview & comprehensive English documentation.
• README_KR.md: Full Korean comprehensive manual (한국어 매뉴얼).
• mujoco_playengine_bundle.zip: Complete 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.

🔬 Core Research & Engineering Pillars

• Embodied AI & Physical Dynamics: Researching physics-based reinforcement learning (RL), multi-body kinematics, and autonomous robotics control brains (LQR, MPC, Pure Pursuit, Inverse Kinematics).
• Zero-Asset Procedural Engineering: Designing zero-cost web architectures synthesizing 3D geometry and audio purely via code and mathematical formulations without heavy texture downloads.
• Autonomous Decision OS: Engineering deterministic, prefrontal-cortex-style reasoning architectures and state machine governance for complex physical environments.
• Interactive Creative Aesthetics: Fusing functional automation with refined visual craft and modern design philosophy to build delightful tools.

🌐 Physical AI & Robotics Ecosystem (Cross-Links)

• Official Hub: 🤗 Hugging Face (@hwihwalab)
• 🚀 Related Robotics & Game AI Showcase:
  • 🍬 Physics Bricks & Web Arcade: mujoco-physics-playengine (Current Project) — 10 MuJoCo procedural physics bricks & autonomous robotics arcade.
  • 🕹️ Inverted Pendulum Control (PPO): cartpole-v1-ppo — Reinforcement learning benchmark directly paired with Brick #07 Cart Balancer.
  • 🤖 Bimanual Robotic Manipulation: act-aloha-sim-transfer-cube — Action Chunking Transformer simulation paired with Brick #09 Claw Machine kinematics.
  • 🦆 3D Bipedal Locomotion & Teleop: microduck-3d-bipedal-teleop — 3D interactive bipedal robotics simulator running live in browser.
  • 🍫 Indie Game Studio Decision Brain: CHOCO-BRAIN-v1 — Edge prefrontal reasoning cortex for solo indie game creators & studio operations.

---

📜 License

Distributed under the Apache 2.0 License. See the LICENSE file for complete details.

---

🇰🇷 한국어 요약 안내 (Click to expand Korean summary)

Jelly Bean PlayEngine은 학술 연구용 다체 동역학 엔진인 MuJoCo v3.3.0의 강력한 수치 해석 역량을 대중 친화적인 인터랙티브 3D 아케이드로 승화시킨 Physical AI & 로보틱스 시뮬레이션 플랫폼입니다.
10대 미니게임의 심층 물리 해석 수식, 로보틱스 제어 알고리즘 및 상세 플레이 가이드는 **📖 한국어 매뉴얼**에서 확인하실 수 있습니다.

🎮 필수 공통 단축키 요약 (Quick Shortcuts)

단축키	기능 명칭	상세 설명
Space	주요 액션 실행	물리 시작 / 젤리빈 투하 / 도미노 돌격 / 아크로바틱 킥 / 대포 발사 즉시 트리거
R	원위치 즉각 리셋	모든 오브젝트 위치, 타이머, 실시간 점수 HUD를 대기(Ready) 초기 상태로 원상 복구
C	3-Way 카메라 전환	정면 뷰(Front 🎥) ➔ 45도 쿼터 뷰(Quarter 📐) ➔ 탑다운 뷰(Top-Down 🚁) 순환 전환
M	스마트 AI / 수동 토글	인간 플레이어 직접 수동 조작 ↔ 똑똑한 스마트 AI 자율주행 모드 원클릭 전환
F	16:9 와이드 전체화면	군더더기 없는 아케이드 콕핏 전체화면 몰입 모드 토글

👉 📖 10대 미니게임별 상세 조작법 & 물리 이론 전체보기

---

Designed and engineered with Jelly Bean PlayEngine by HWIHWA LAB (@hwihwalab)