CharacterController.isGrounded is way too inconsistent?

[TheProcessYet_64]

I had no idea I was having an issue with the standard isGrounded check from the standard Unity Character Controller until I broke down my project and code.

My project/code is showing isGrounded = true in this photo when my player is clearly very high up off the ground. It is making certain movements inconsistent and almost broken because my player gets stuck where they should not like on the edge of this cube object. Ground should only be detected if the very bottom of the capsule is touching it.

Is this just the limitation of the standard controller.isGrounded check or do I need to manually add code to adjust this to my preference? I have tested this using three different very simple scripts so I don’t believe it’s a code issue. All I use is isGrounded = controller.isGrounded;

[spiney199]

CharacterController.isGrounded just checks if the bottom part of the capsule was intersecting with any collider the last time .Move() was called on it.

It’s very literal in that sense.

So in that image I can see just a bit of the capsules bottom cap is against the cube, so isGrounded makes sense to be true.

You can always combine it with other methods to get more accurate or specific results. It is of course, very simple and generalised.

[Kurt-Dekker]

I’m guessing that you are using broken example code that calls controller.Move() in two separate places each frames.

I wrote about this before: the Unity example code in the API no longer jumps reliably.

If you call .Move() twice in one single frame, the grounded check may fail.

I reported it to Unity via their docs feedback in October 2020. Apparently it is still broken:

Unity - Scripting API: CharacterController.Move

Here is a work-around:

How to correctly setup 3d Character Movement in Unity?

Welcome! First, please use code tags: Using code tags properly when you post code. But secondly, what is weird is that this is the second time recently that I’ve seen this code reported broken. I went and investigated and what appears to have happened is that Unity’s example used to work back on earlier versions of Unity. BUT… on more recent Unity versions, I concur with you that it presently does NOT work reliably, at least for jumping. If I had to guess why, I believe it is their two sepa…

I recommend you also go to that same documentation page and ALSO report that the code is broken.

When you report it, you are welcome to link the above workaround. One day the docs might get fixed.

If you would prefer something more full-featured here is a super-basic starter prototype FPS based on Character Controller (BasicFPCC):

A Basic First Person Character Controller for prototyping

https://www.youtube.com/watch?v=t0oN-PFXZEM Gist Link After some interest in an old post here , I spent the weekend frankensteining snippets of code to make a single script FPCC that could be used like the FPCC from Unity 4~5, including the crouch and run from Aldo, and I also added farcry sliding. There is a Menu Item function to easily create and configure a new FPCC object. Otherwise very easy to set up, it only requires a layer to exclude itself from sphere/raycasts. There is a check to …

That one has run, walk, jump, slide, crouch… it’s crazy-nutty!!