Project Settings
KawaiiPhysics exposes project-wide settings under Project Settings > Plugins > Kawaii Physics. Values set here apply to every KawaiiPhysics node in the project.
These project settings (KawaiiPhysicsDeveloperSettings) were added in v1.21.0.
Opening the settings
- Open Edit > Project Settings from the editor's top menu.
- In the category list on the left, select Plugins > Kawaii Physics.
These are a UDeveloperSettings class marked config = Engine. Changing them writes to your project's Config/DefaultEngine.ini under the following section, which is also how you version-control and share them with your team.
[/Script/KawaiiPhysics.KawaiiPhysicsDeveloperSettings]
bUseFixedSubstepping=True
MaxSubsteps=4
InterBoneDummyWarningThreshold=100
BridgeDummyWarningThreshold=200
Simulation
Settings for how the simulation integrates over time.
Use Fixed Substepping
Enable fixed substepping - Runs the whole simulation with fixed-timestep substepping (FixedDt = 1 / TargetFramerate) to remove frame-rate dependence. CPU cost rises at low fps as the substep count grows.
| Property | Value |
|---|---|
| Type | bool |
| Default | true |
| Category | Simulation |
| INI key | bUseFixedSubstepping |
See Fixed Substepping for how it works and notes on backward compatibility.
Max Substeps
Maximum substeps per frame - The maximum number of substeps per frame. This caps catch-up at low fps / hitches (prevents the spiral of death); time beyond this is dropped.
| Property | Value |
|---|---|
| Type | int32 |
| Default | 4 |
| Range | 1 - 16 |
| Edit condition | Editable only when Use Fixed Substepping is enabled |
| Category | Simulation |
| INI key | MaxSubsteps |
Performance Warnings
Thresholds that emit a warning to the output log when Bone Subdivision generates too many dummy bones. When the generated count exceeds a threshold, a single warning log is emitted to flag the potential performance impact.
These two are editor-only settings (under WITH_EDITORONLY_DATA). The warning logs are meant for checking in Editor / Development builds and have no effect on shipped builds.
Inter-Bone Dummy Warning Threshold
Inter-bone dummy warning threshold - Warning threshold for the number of inter-bone dummy bones generated by BoneSubdivisionCount (vertical subdivision). Set to 0 to disable the warning.
| Property | Value |
|---|---|
| Type | int32 |
| Default | 100 |
| Range | 0 or more (0 disables) |
| Category | Performance Warnings |
| INI key | InterBoneDummyWarningThreshold |
Bridge Dummy Warning Threshold
Bridge dummy warning threshold - Warning threshold for the number of bridge collision-proxy dummy bones generated by BoneConstraintSubdivisionCount (horizontal subdivision / Bridge). Set to 0 to disable the warning.
| Property | Value |
|---|---|
| Type | int32 |
| Default | 200 |
| Range | 0 or more (0 disables) |
| Category | Performance Warnings |
| INI key | BridgeDummyWarningThreshold |
If a warning appears, the first thing to try is lowering BoneSubdivisionCount / BoneConstraintSubdivisionCount to reduce the generated count. Only raise the threshold when you are intentionally using many dummies. See Bone Subdivision for details.
Source Code
KawaiiPhysicsDeveloperSettings.h— the settings class definition