> For the complete documentation index, see [llms.txt](https://docs.streamavatars.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.streamavatars.com/lua-scripting-api/api-reference-and-tips/classes/physics/grounded-get-set.md).

# grounded {get;set}

```lua
return function()
    local user = getUser('clonzeh');
    if user == nil then
        log('user does not exist!');
        return;
    end

    log(user.physics.grounded);
    --detects whether the avatar is on the ground or not.
    
    user.physics.grounded = true; --temporarily sets grounded to true
    --but it will update back to false if it's not actually grounded.
end
```