Skip to content

A fast 2D and 3D game engine — TypeScript SDK, C++/WebAssembly core, visual editor. Ship one project to web, desktop, WeChat MiniGames, playable ads, and native Android / iOS.

fix: tune physics contact solver defaults for stability

esengine1b81197f8610
diff --git a/editor/src/PreviewManager.ts b/editor/src/PreviewManager.ts
index 27ab32113..8c0f46fad 100644
--- a/editor/src/PreviewManager.ts
+++ b/editor/src/PreviewManager.ts
@@ -93,9 +93,9 @@ export class PreviewManager {
gravityY: getSettingsValue<number>('physics.gravityY') ?? -9.81,
fixedTimestep: getSettingsValue<number>('physics.fixedTimestep') ?? 1 / 60,
subStepCount: getSettingsValue<number>('physics.subStepCount') ?? 4,
- contactHertz: getSettingsValue<number>('physics.contactHertz') ?? 120,
+ contactHertz: getSettingsValue<number>('physics.contactHertz') ?? 30,
contactDampingRatio: getSettingsValue<number>('physics.contactDampingRatio') ?? 10,
- contactSpeed: getSettingsValue<number>('physics.contactSpeed') ?? 10,
+ contactSpeed: getSettingsValue<number>('physics.contactSpeed') ?? 3,
collisionLayerMasks,
} : undefined;
const previewSpineVersion = spineVersion === 'none' ? undefined : spineVersion;
diff --git a/editor/src/preview/PreviewService.ts b/editor/src/preview/PreviewService.ts
index a78580e9a..fc2ddb9a6 100644
--- a/editor/src/preview/PreviewService.ts
+++ b/editor/src/preview/PreviewService.ts
@@ -150,9 +150,9 @@ export class PreviewService {
physicsGravityY: physicsConfig?.gravityY ?? -9.81,
physicsFixedTimestep: physicsConfig?.fixedTimestep ?? 1 / 60,
physicsSubStepCount: physicsConfig?.subStepCount ?? 4,
- physicsContactHertz: physicsConfig?.contactHertz ?? 120,
+ physicsContactHertz: physicsConfig?.contactHertz ?? 30,
physicsContactDampingRatio: physicsConfig?.contactDampingRatio ?? 10,
- physicsContactSpeed: physicsConfig?.contactSpeed ?? 10,
+ physicsContactSpeed: physicsConfig?.contactSpeed ?? 3,
collisionLayerMasks: physicsConfig?.collisionLayerMasks,
...runtimeConfig,
}));
diff --git a/editor/src/settings/ProjectSettingsSync.ts b/editor/src/settings/ProjectSettingsSync.ts
index c0c14dd88..fae296c9c 100644
--- a/editor/src/settings/ProjectSettingsSync.ts
+++ b/editor/src/settings/ProjectSettingsSync.ts
@@ -59,7 +59,7 @@ const SETTINGS_TO_PROJECT_MAP: SettingMapping[] = [
},
{
settingId: 'physics.contactHertz',
- read: c => c.physicsContactHertz ?? 120,
+ read: c => c.physicsContactHertz ?? 30,
write: (c, v) => { c.physicsContactHertz = v as number; },
},
{
@@ -69,7 +69,7 @@ const SETTINGS_TO_PROJECT_MAP: SettingMapping[] = [
},
{
settingId: 'physics.contactSpeed',
- read: c => c.physicsContactSpeed ?? 10,
+ read: c => c.physicsContactSpeed ?? 3,
write: (c, v) => { c.physicsContactSpeed = v as number; },
},
{
diff --git a/editor/src/settings/builtinSettings.ts b/editor/src/settings/builtinSettings.ts
index 748cffe69..5ec6c0b68 100644
--- a/editor/src/settings/builtinSettings.ts
+++ b/editor/src/settings/builtinSettings.ts
@@ -575,7 +575,7 @@ export function registerBuiltinSettings(): void {
label: 'Contact Hertz',
description: 'Contact stiffness (cycles/sec). Higher = less overlap but more jitter',
type: 'number',
- defaultValue: 120,
+ defaultValue: 30,
step: 10,
min: 1,
max: 500,
@@ -603,7 +603,7 @@ export function registerBuiltinSettings(): void {
label: 'Contact Speed',
description: 'Max overlap resolution speed (m/s)',
type: 'number',
- defaultValue: 10,
+ defaultValue: 3,
step: 1,
min: 1,
max: 100,