From 67cca771bd61ba0951c8948f3a931f60ef99fcbd Mon Sep 17 00:00:00 2001 From: daniele-dcl Date: Mon, 24 Nov 2025 10:59:17 +0100 Subject: [PATCH 1/2] feat: locomotion settings (#320) new avatar locomotion settings component --- .../avatar_locomotion_settings.proto | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) create mode 100644 proto/decentraland/sdk/components/avatar_locomotion_settings.proto diff --git a/proto/decentraland/sdk/components/avatar_locomotion_settings.proto b/proto/decentraland/sdk/components/avatar_locomotion_settings.proto new file mode 100644 index 00000000..a16f2169 --- /dev/null +++ b/proto/decentraland/sdk/components/avatar_locomotion_settings.proto @@ -0,0 +1,18 @@ +syntax = "proto3"; + +package decentraland.sdk.components; + +import "decentraland/sdk/components/common/id.proto"; + +option (common.ecs_component_id) = 1211; + +// The PBAvatarLocomotionSettings component allows scenes to modify locomotion settings defining things such +// as the avatar movement speed, jump height etc. +message PBAvatarLocomotionSettings { + optional float walk_speed = 1; // Maximum speed when walking (in meters per second) + optional float jog_speed = 2; // Maximum speed when jogging (in meters per second) + optional float run_speed = 3; // Maximum speed when running (in meters per second) + optional float jump_height = 4; // Height of a regular jump (in meters) + optional float run_jump_height = 5; // Height of a jump while running (in meters) + optional float hard_landing_cooldown = 6; // Cooldown time after a hard landing before the avatar can move again (in seconds) +} From 8ae283bf832ebc753c9ec45f5c18fe16e7824e1d Mon Sep 17 00:00:00 2001 From: Daniele Marotta Date: Mon, 12 Jan 2026 14:28:32 +0100 Subject: [PATCH 2/2] added default values to documentation --- .../sdk/components/avatar_locomotion_settings.proto | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/proto/decentraland/sdk/components/avatar_locomotion_settings.proto b/proto/decentraland/sdk/components/avatar_locomotion_settings.proto index a16f2169..355762cc 100644 --- a/proto/decentraland/sdk/components/avatar_locomotion_settings.proto +++ b/proto/decentraland/sdk/components/avatar_locomotion_settings.proto @@ -9,10 +9,10 @@ option (common.ecs_component_id) = 1211; // The PBAvatarLocomotionSettings component allows scenes to modify locomotion settings defining things such // as the avatar movement speed, jump height etc. message PBAvatarLocomotionSettings { - optional float walk_speed = 1; // Maximum speed when walking (in meters per second) - optional float jog_speed = 2; // Maximum speed when jogging (in meters per second) - optional float run_speed = 3; // Maximum speed when running (in meters per second) - optional float jump_height = 4; // Height of a regular jump (in meters) - optional float run_jump_height = 5; // Height of a jump while running (in meters) - optional float hard_landing_cooldown = 6; // Cooldown time after a hard landing before the avatar can move again (in seconds) + optional float walk_speed = 1; // Maximum speed when walking (in meters per second), default value is 1.5 m/s + optional float jog_speed = 2; // Maximum speed when jogging (in meters per second), default value is 8 m/s + optional float run_speed = 3; // Maximum speed when running (in meters per second), default value is 10 m/s + optional float jump_height = 4; // Height of a regular jump (in meters), default value is 1 m + optional float run_jump_height = 5; // Height of a jump while running (in meters), default value is 1.5 m + optional float hard_landing_cooldown = 6; // Cooldown time after a hard landing before the avatar can move again (in seconds), default value is 0.75 s }