Japanese doc:
Japanese Documentation
Download (for those without a C++ build environment):
Github : https://github.com/pafuhana1213/KawaiiPhysics/releases/
Booth : https://pafuhana1213.booth.pm/items/5943534
- Update Information
- Requests & Ideas
- Questions & Q&A
- Share Your Work!
- General Discussion & Advice
- Feature and Sample Requests
Kawaii Physics is a pseudo-physics plugin for Unreal Engine 4 and 5. It allows you to create simple and cute animations for objects like hair, skirts, and breasts.
Character used: Gray-chan Gray-chan
YouTube Video
Character used: Mirai Komachi Mirai Komachi
- Respects the original shape while controlling physics based on the animation and movement/rotation of the SkeletalMeshComponent.
- Use the "KawaiiPhysics Node" included in the plugin in the AnimGraph of AnimationBP.
- You can make specified bones and their child bones move according to the character's motion.
- With only two types of physics control parameters, it is easier to set up compared to the engine's standard AnimDynamics.
- You can add sphere, capsule, and plane collisions.
- Adjust the position, orientation, and size of each collision in the animation editor's viewport.
- Maintains bone length, preventing bones from stretching or shrinking even if calculations fail.
- Uses a simple algorithm without PhysX, which should result in lower overhead compared to the engine's standard physics system.
Next Generation Idolmaster Graphics & Animation Programming Preview
- UE5.2 ~ 5.4
KawaiiPhysics Releases - UE4.27
KawaiiPhysics Release for UE4.27 - UE4.26 and earlier (Plugin only)
KawaiiPhysics Release for UE4.26 and earlier
When building for UE4.26 and earlier, you need to modify GetSkeleton() to Skeleton.
When building for UE4.21 and earlier, you need to modify GEngine->ConstraintLimitMaterialPrismatic->GetRenderProxy() to GEngine->ConstraintLimitMaterialPrismatic->GetRenderProxy(false) in KawaiiPhysicsEditMode.cpp.
When building for UE4.23 and earlier, you need to modify "Type": "UncookedOnly" to "Type": "DeveloperTool" in KawaiiPhysics.uplugin (probably).
-
Place the KawaiiPhysics folder in your project's Plugins folder.
-
About each parameter: Parameter Details
-
For BP projects, errors occur during packaging. Please either convert to a C++ project or try the method introduced in the following article.
How to Package UE5 KawaiiPhysics for Blueprint Projects - PaperSloth’s Diary
You can convert to a C++ project by adding C++ code from the "C++ Class Wizard".
C++ Class Wizard Documentation
However, you need to prepare an environment that can build C++, such as Visual Studio.
Setting Up Visual Studio Development Environment for C++ Projects
- Content/KawaiiPhysicsSample/KawaiiPhysicsSample
- Character used: Gray-chan Gray-chan
- Explanation of the Internal Implementation of Custom AnimNode "Kawaii Physics" Part 1
- Test of Using #ControlRig to Prevent Skirt Clipping and Combining with #KawaiiPhysics
- How a Complete Amateur in Jiggle Physics Used KawaiiPhysics to Make a Female Character Model More Kawaii Based on Intuition
- Jiggle Physics and Control Rig Examples from a Virtual Live Using UE
- Setting Jiggle Physics with Kawaii Physics in UE
- Note: You can adjust the influence per bone to some extent with the "◯◯◯ by bone length rate" property.
- Kawaii Physics Tutorial #1
- How to Set Up Kawaii Physics in Unreal Engine 5
MIT
- 2024/8/16 v1.17.0 Details Here
- Additional RootBones
- Box Limit
- PhysicsAsset for Limits
- AnimNotify / AnimNotifyState for NewExternalForce
- BP nodes for NewExternalForce
- NewExternalForce Wind
- Export BoneConstraint DataAsset
- 2024/7/19 v1.16.0 Details Here
- New External Force
- Organized and added functions to the Details Panel
- Added console variables for debugging at the level
- DataAsset Update
- 2024/2/8 v1.15.0 Details Here
- Added support for UE5.4
- 2024/2/8 v1.14.0
- Experimental addition of BoneConstraint function to constrain distances between bones
- Maintains the distance between specified bones (BoneConstraints/Bone1, 2) using XPBD. Note that the specified bones must be controlled by KawaiiPhysics.
- You can specify the number of iterations for constraint processing with Bone Constrain Iteration Count Before(After) Collision.
- Now configurable in DataAsset. Added experimental feature to set bone sets for constraints using regular expressions.
- Exposed the DataAsset held by KawaiiPhysics AnimNode to the pin
- Fixed inefficiencies in Planar Limit processing PR 108
- Refactored the code of the physics processing part to accommodate BoneConstraint
- Experimental addition of BoneConstraint function to constrain distances between bones
- 2023/9/15 v1.13.0
- Added warm-up function and sample for initial physical calculations
- Warm Up Video
- Warm Up is enabled when Need Warm Up is true and Warm Up Frame (number of frames for warm-up) is 1 or more.
- Need Warm Up becomes false after execution.
- Larger Warm Up Frame results in more stability, but increases the load due to more physical calculations.
Warm Up can also be enabled from the AnimNode function since v1.12.0.
- Added warm-up function and sample for initial physical calculations
- 2023/9/8 v1.12.0
- Support for UE5.3
- Nothing specific was done.
- Parameters can now be changed and retrieved from AnimNode functions.
- Added sample (AnimBP_GrayChanKawaiiPhysicsAnimNodeFunction).
- Ended support for UE4.27 due to support for AnimNode functions.
- Support for UE5.3
- 2023/8/30 v1.11.1
- 2023/5/28 v1.11.0
- Support for UE5.2
- Nothing specific was done.
- Added sample combining KawaiiPhysics and Sequencer.
- Check if the SkeletalMeshComponent's AnimClass is set to AnimBlueprint and if there is a Slot node in the AnimGraph.
- Made property changes reflect in behavior without compilation.
- Added support for CopyNodeDataToPreviewNode which was missing.
- Fixed issue where collider (Limits) preview did not work properly in UE5.1 (second and subsequent colliders did not appear without compilation) Issue 84
- Fixed crash when editing rotation of collider (Limits) Issue 86
- Fixed crash when deleting Limits from DataAsset Issue 72
- Fixed crash when DrivingBone of collider (Limits) is removed by LOD Issue 87
- (Probably) fixed crash when used with Control Rig and AnimationLayer Issue 56
- Added LOD1 and 2 to sample model for operation check.
- Support for UE5.2
- 2022/12/03 v1.10.0
- Support for UE5.1
- Fixed crash when bones are removed by LOD.
- Some code refactored by Rider.
- 2022/4/11 v1.9.0
- Parameters can now be edited with curves without creating a curve asset PR 32
- Added world collision feature and sample PR 26
- Fixed issue where DummyBone is not generated when the terminal bone does not function due to LOD settings PR 26
- Fixed issue where physics settings are reset during ResetPhysics Issue 38
- Added process to suppress erratic behavior during LOD switching. ResetBoneTransformWhenBoneNotFound can be enabled to revert to the previous process Issue 44
- 2022/4/11 v1.8.0
- Support for UE5 official release.
- Temporarily dropped support for UE4.26 and earlier.
- 2020/12/2 v1.7.0
- 2020/11/17 v.1.6.2
- Fixed issue where FKawaiiPhysicsEditMode::DrawHUD was not functioning correctly.
- 2020/9/4 v1.6.1
- Fixed error in package creation due to missing property category specification.
- 2020/8/29 v1.6.0
- Added functionality to manage and reuse collision settings with a dedicated DataAsset (KawaiiPhysicsLimitsDataAsset).
- Usage: Video
- Not much operational experience, so consider it experimental.
- Set UE4.25.3 as default.
- Added functionality to manage and reuse collision settings with a dedicated DataAsset (KawaiiPhysicsLimitsDataAsset).
- 2020/7/28 v1.5.3
- Fixed issue where correct length could not be obtained and parameters with curves did not work properly when BoneIndex of Mesh and Skeleton differ PR 21
- Thanks to nkinta!
- Fixed issue where correct length could not be obtained and parameters with curves did not work properly when BoneIndex of Mesh and Skeleton differ PR 21
- 2020/5/29 v1.5.2
- Fixed issue where response in v1.5.1 did not consider DummyBone.
- 2020/5/29 v1.5.1
- Fixed issue where debug display by bEnableDebugBoneLengthRate was misaligned.
- Unified text format of debug display with engine standard bone name display Twitter
- 2020/5/29 v1.5.0
- Added BoneForwardAxis property to set bone orientation, affecting DummyBone behavior only.
(Thanks to SAM-tak!)
- Added BoneForwardAxis property to set bone orientation, affecting DummyBone behavior only.
- 2020/5/15 v1.4.6
- Fixed crash when the same bone as Root is specified in ExcludeBone.
- Added process to display node as Warning or Error in case of invalid settings.
- Technical explanation: Blog
- 2020/5/15 v1.4.5
- Changed Gravity to operate in ComponentSpace.
(Thanks to dxd39!)
- Changed Gravity to operate in ComponentSpace.
- 2020/3/13 v1.4.4
- Fixed build failure on MacOS.
(Thanks to melMass!)
- Fixed build failure on MacOS.
- 2020/3/13 v1.4.3
- Fixed issue with package creation failure.
- 2020/2/16 v1.4.2
- Fixed issue where it did not function properly during standalone execution.
- 2020/1/31 v1.4.1
- Fixed issue where Radius setting of bone was not considered when LimitType of SphereLimit was Inner. Set CVarEnableOldPhysicsMethodSphereLimit to 1 to revert to behavior before v1.3.1.
- 2020/1/31 v1.4.0
- Fixed calculation of position update of gravity variable to gt instead of gt^2. Set p.KawaiiPhysics.EnableOldPhysicsMethodGravity to 1 to use gravity calculation before v1.3.1.
- 2020/1/31 v1.3.1
- Fixed issue where radian and degree were mixed in the calculation of TeleportRotationThreshold, causing almost no function of WorldRotation teleport support. (Thanks to monguri!)
- 2020/1/31 v1.3.0
- Support for UE4.24.2.
(Thanks to TheHoodieGuy02!)
- Support for UE4.24.2.
- 2019/10/29 v1.2.1
- Reverted World Damping to previous processing, making behavior more stable at 30fps.
(Thanks to @seiko_dev!)
- Reverted World Damping to previous processing, making behavior more stable at 30fps.
- 2019/10/26 v1.2.0
- Added simple variable frame rate support. Behavior should be slightly more stable during frame rate drops.
(Thanks to @seiko_dev!) - You can now set the reference frame rate (default: 60). (Honestly, this is under-tested. If there are any issues, please report them to the issue tracker.)
- Added debug display of the percentage of length from the starting point of each bone for curve adjustment.
- Added simple variable frame rate support. Behavior should be slightly more stable during frame rate drops.
- 2019/10/19 v1.1.2
- Fixed issue where Bone.Scale was not supported for scales other than (1,1,1).
(Thanks to shop-0761!)
- Fixed issue where Bone.Scale was not supported for scales other than (1,1,1).
- 2019/9/11 v1.1.1
- Fixed incorrect calculation of Bone.LengthFromRoot.
(Thanks to KazumasaOhashi!)
- Fixed incorrect calculation of Bone.LengthFromRoot.
- 2019/8/26 v1.1
- Added support for WindDirectionalSource (Note: destructive changes to existing Wind settings).
- 2019/7/20 v1.0.1
- Fixed issue where Collision's OffsetLocation did not consider bone rotation.
(Behavior of OffsetLocation changes significantly from v1.0.)
- Fixed issue where Collision's OffsetLocation did not consider bone rotation.
- 2019/7/2 v1.0 Initial release.