Skip to content

About

A vibe-coded world simulator for recreating and exploring physics-based animation.

Topics

Resources

Stars

27 stars

Watchers

0 watching

Forks

Latest commit

 

History

29 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation


A growing collection of physics-based animation projects, from solvers to rendered demos. Explore the code and run guides, or click an animated preview to watch the full video.

ThunderGS

Thunderstruck: Visually Simulating Electrical Storms brings electric-field-driven lightning branches, ground attachment, and flash illumination to Gaussian scenes.

Firewoods lightning demo
Firewoods
Zohar lightning demo
Zohar
Train lightning demo
Train

Code & run guide →

StormGS

Cyclogenesis: Simulating Hurricanes and Tornadoes brings rotating clouds, rain, sea spray, and terrain-driven dust to Gaussian scenes.

Playground tornado demo
Playground
Land's End waterspout demo
Land's End
Calico dust devil demo
Calico

Code & run guide →

LavaGS

LavaGS combines Augmented MPM for Phase-Change and Varied Materials with Gaussian scenes for lava flow, crust formation, rock contact, and thermal emission.

Zohar canyon demo
Zohar canyon
Land's End cliff demo
Land's End cliff
Calico demo
Calico

Code & run guide →

SnowyGS

SnowyGS combines A Material Point Method for Snow Simulation with Gaussian scenes for wind-driven snowfall and accumulated snow.

Playground moving-camera demo
Playground
Firewoods moving-camera demo
Firewoods
Train moving-camera demo
Train

Code & run guide →

RainyGS

RainyGS synthesizes rain, splashes, and water effects in Gaussian scenes.

Playground moving-camera demo
Playground
Firewoods moving-camera demo
Firewoods
Train moving-camera demo
Train

Code & run guide →

DiffWind

DiffWind models wind-driven Gaussian object dynamics through differentiable fluid-solid coupling with LBM and MPM.

DiffWind Potted Plant demo
Potted Plant
DiffWind Sweater demo
Sweater
DiffWind Flag demo
Flag

Code & run guide →

Plant Wilting

A Physically-inspired Approach to the Simulation of Plant Wilting couples water transport and material softening to animate drying plants, rendered here with 3D Gaussians.

Potted Plant wilting and water-content changes
Potted Plant
Ficus wilting and water-content changes
Ficus
Alocasia wilting and water-content changes
Alocasia

Code & run guide →

PhysSkin

PhysSkin learns continuous neural skinning fields for real-time, generalizable physics-based animation across diverse 3D shapes.

PhysSkin++ teaser: interactive physics-based animation
▶ Watch the PhysSkin++ teaser

Code & run guide →

MeGAS

MeGAS incorporates thermomechanical phase-change dynamics with temperature fields and thermomechanical phase transitions to Gaussian scenes for melting and solidification.

Bidirectional Phase-Change Editing
MeGAS Bidirectional Phase-Change Editing: looping official video

Code & run guide →

Gaussian Splashing

Gaussian Splashing unifies particles for fluid and solid motion synthesis and Gaussian rendering.

Liquefy moving-camera demo
Liquefy
Wave moving-camera demo
Wave
Plunge moving-camera demo
Plunge

Code & run guide →

Water + Sand

Water + Sand combines Volume-Preserving LBM-MPM Coupling for Air-Water-Sand Mixtures with Gaussian rendering for 3D sandcastle erosion, sedimentation, and dam overtopping.

Sand dam overtopping demo
Sand dam
Colored sand sedimentation demo
Sedimentation
Sandcastle erosion demo
Sandcastle

Code & run guide →

EnliveningGS

EnliveningGS gives 3D Gaussian objects active locomotion through muscle-driven deformation and contact.

Hopping bread moving-camera demo
Hopping bread
Turning wolf moving-camera demo
Turning wolf
Dancing vase moving-camera demo
Dancing vase

Code & run guide →

Magnetic MPM

A Material Point Method for Nonlinearly Magnetized Materials couples nonlinear magnetic fields with deformable solids and viscous fluids.

Ferrofluid moving-camera demo
Ferrofluid
Magnetic bread moving-camera demo
Magnetic bread
Magnetic wolf moving-camera demo
Magnetic wolf

Code & run guide →

Capillary Contact

Solid-Fluid Interaction with Surface-Tension-Dominant Contact couples surface tension and solid contact to support floating objects and produce capillary clustering.

Miniature scanned apples on a liquid surface
Miniature orchard
A moving stirrer interacts with a cluster of floating colored pins
Capillary cluster
A steel stirrer moves floating paperclips through capillary waves
Paperclips

Code & run guide →

Ice Melting

Fast Particle-based Visual Simulation of Ice Melting and Ice Melting Simulation with Water Flow Handling explore particle heat transfer, melting ice, and flowing water.

Ice cubes drifting and melting in warm water
Ice cubes
An ice arch melting under local heating
Thawing arch
An ice bunny melting into a continuous pool
Bunny

Code & run guide →

Fire-X GS

Fire-X: Extinguishing Fire with Stoichiometric Heat Release and FieryGS bring fire, water-driven cooling, and persistent carbonization to Gaussian scenes.

Firewoods burning and cooling under an overhead spray
Firewoods
Water suppressing a fire in wooden playground towers
Playground
A diagonal spray cooling the burning Bonsai ornament
Bonsai

Code & run guide →

Multi-fluid

An Implicitly Stable Mixture Model for Dynamic Multi-fluid Simulations couples phase motion, diffusion, and incompressibility for tea brewing, density inversion, and colliding liquids.

Tea brewing multi-fluid demo
Tea brewing
Density inversion multi-fluid demo
Density inversion
Chromatic collision multi-fluid demo
Chromatic collision

Code & run guide →

Ice Solidification

Solidification using smoothed particle hydrodynamics models heat transfer and latent heat for growing ice and coupled liquid motion.

A continuous freezing front growing in a transparent star mold
Frozen star
Water flowing down chilled steps and gradually freezing
Frozen cascade
Ice growing around a cooled copper rod
Cryogenic bloom

Code & run guide →

Tree & Root Growth

Rhizomorph: The Coordinated Function of Shoots and Roots couples soil resources and plant signals to grow branching roots and leafy crowns together.

Oak crown and roots growing in a soil cutaway
Oak
Maple crown and roots growing in a soil cutaway
Maple
Birch crown and roots growing in a soil cutaway
Birch

Code & run guide →

Windy Trees

Windy Trees: Computing Stress Response for Developmental Tree Models couples turbulent wind and elastic tree motion, with fine air-particle paths revealing the flow around each crown.

Oak branches bending in passing gusts with visible wind trajectories
Oak
Turning wind flowing around a dense maple crown
Maple
Birch branches and leaves responding to turbulent wind
Birch

Code & run guide →


Magnetic Rigid Bodies

Strongly Coupled Simulation of Magnetic Rigid Bodies couples magnetic forces, induced magnetization, and rigid contact for compass alignment, electromagnetic transport, and magnetic assembly.

Field of Needles
Field of Needles
Magnetic Cabinet
Magnetic Cabinet
Electromagnetic Foundry
Electromagnetic Foundry

Code & run guide →


Thin-Film Bubbles

A Moving Eulerian-Lagrangian Particle Method for Thin Film and Foam Simulation separates surface geometry from material flow to animate capillary recoil, pressure-driven deformation, and bubble collisions with thin-film iridescence.

Giant Bubble Recoil
Giant Bubble Recoil
Breathing Bubble
Breathing Bubble
Bubble Collision
Bubble Collision

Code & run guide →


Run a demo

See installation for the CUDA environment, then:

python -m physstudio fetch bread
python -m physstudio run enlivening bread --gpu 0

Use --frames 12 --width 640 for a quick preview and --output for a custom run directory. Use --dry-run to print the launcher's exact commands. Pretrained models are downloaded separately; asset links and project credits are collected in the repository.

Repository map
thunder_gs/           Electric discharge, grounded terrain, and flash lighting
storm_gs/             Moist vortices, rain, sea spray, and transported dust
lava_gs/              Thermoviscoplastic lava, rock contact, and thermal emission
snowy_gs/             Elastoplastic snow, airborne flakes, and accumulation
rainy_gs/             Rain, shallow water, ripples, and reflections
plant_wilting/        Water transport, Newton rods, and Gaussian plant motion
gaussian_splashing/   Position-based fluids and Gaussian liquid rendering
water_sand/           Air–water LBM, granular MPM, and Gaussian grains
enlivening_gs/        Muscle-driven FEM and Gaussian deformation
magnetic_mpm/        Nonlinear magnetic fields coupled to MLS-MPM
surface_tension/      Capillary contact, stirring, surface currents, and Cycles rendering
ice_melting/          Heat transport, phase change, rigid ice, and meltwater
firex_gs/             Thermochemical fire, water suppression, and Gaussian carbonization
implicit_mixture/     Implicit multi-fluid SPH, phase transport, and liquid surfaces
ice_solidification/   Implicit heat transfer, growing ice, and liquid motion
rhizomorph/           Coupled soil resources, root growth, and branching crowns
windy_trees/          Two-way SPH wind, elastic branches, and air-particle paths
magnetic_rigid/       Coupled rigid contact, dipole fields, and induced magnetization
melp_thin_film/       Moving thin films, capillary recoil, and bubble contact
physstudio/           Shared launcher, paths, and download utilities
media/                Demo videos, animated previews, and an HTML gallery

Contributors ✨

🤝 Thanks go to these wonderful people:

Yuanhang Lei · Zesong Yang · Baofei Liu · Zixuan Wang · Minghao Feng · Tao Cheng · Xingxuan Li · Weiran Shi

We are grateful to our advisors, Prof. Hujun Bao, Prof. Zhaopeng Cui, Dr. Siyuan Huang, Prof. Peter Yichen Chen, and Prof. Ruizhen Hu, for their guidance and support.

This project follows the all-contributors specification. Contributions of any kind are welcome!

License

Original PhysStudio code is licensed under Apache 2.0. Third-party components and their derived code retain their respective licenses; see THIRD_PARTY.md. External assets and official showcase media retain their upstream terms; see ASSETS.md and the credits.

Acknowledgements

We thank the authors of the research papers that inspired PhysStudio for their contributions to physics-based animation and simulation. Their ideas and methods provide the foundation for the implementations explored in this project. We also thank the developers and maintainers of the open-source libraries, tools, and resources that make this work possible.

About

A vibe-coded world simulator for recreating and exploring physics-based animation.

Topics

Resources

Stars

27 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages