decentraland / decentraland/docs
player-avatar: glideSpeed and doubleJump in defaults table are not settable properties
- Dominant language
- Wolfram Language
- Stars
- 0
- Forks
- 8
- Avg merge
- 1d 10h
- Merged PRs (30d)
- 21
Description
## Description
The [locomotion settings section](https://docs.decentraland.org/creator/scenes-sdk7/interactivity/player-avatar#locomotion-settings) includes a "default values for reference" table that lists `glideSpeed` and `doubleJump` alongside the actual settable properties. This is misleading — those two values are internal engine movement parameters and are **not** exposed in the `AvatarLocomotionSettings` SDK component.
The proto definition (`avatar_locomotion_settings.proto`, component ID 1211) only exposes 6 settable fields:
- `walkSpeed`
- `jogSpeed`
- `runSpeed`
- `jumpHeight`
- `runJumpHeight`
- `hardLandingCooldown`
Attempting to use `glideSpeed` or `doubleJump` in code causes an IDE type error.
## Suggested Fix
Remove `glideSpeed` and `doubleJump` from the defaults reference table (or add a clear note that they are internal engine values and cannot be set via the component).
## Affected Page
`creator/sdk7/interactivity/player-avatar.md` — locomotion settings section
Contributor guide
Research direction
Open creator/sdk7/interactivity/player-avatar.md and locate the locomotion settings section and its default-values reference table. Compare the table with the six fields exposed by avatar_locomotion_settings.proto. Done means glideSpeed and doubleJump are removed from the settable-properties table or clearly marked as internal and not configurable through AvatarLocomotionSettings.
Written by the indexing model from the issue text.
Assessment
- Domain
- documentation
- Issue type
- Documentation
- Difficulty
- 1/5
- Estimated time
- Under an hour
- Activity status
- Quiet
- Clarity
- Clearly specified
- Newbie friendliness
- 90/100