misleading AI docs

regarding behaviour trees:

either something is terribly wrong with the descriptions for selectors/sequences or i horribly fail in understanding it :slight_smile:
https://docs.unrealengine.com/latest/INT/Engine/AI/BehaviorTrees/NodeReference/index.html#composites

for the selector it states:

now what? to me those two sentences contradict each other…?

same for the sequence description:

huh? when it completes its successfully and when it fails its successfully as well?? so it would never actually fail?

according to some other docs, selectors and sequences should behave differently (more intuitive for me):
http://aigamedev.com/open/article/selector/
http://aigamedev.com/open/article/sequence/

now is this a speciality in unreal or just broken in the documentation?

i wasnt able to find out by trying due to the confusion in my head right now…maybe some AI guru would be so kind to enlighten me :smiley:

cheers!

Yea that last sentence of second note is weird. I see no problem with the first one though. If a child node succeds it must force parent to succed to be effective.

The problem is the use of “fails out”, which seems to be here used to mean “stops trying the next child” instead of “reports failure to its parent node”.

Epic should just use the explanations in the forum thread that first introduced BTs:

"a Sequence Node will only go on to the next child if the previous one returned a success. The sequence node itself will only return a success if all of it’s children return a success.

The Selector node is similiar in that it evaluates it’s children from left to right, but it will only try the next one if the previous failed. It will try each chlid in turn seeing if it returns a success. On the first success it finds, it stops evaluating the children and returns a success."

Hey all, thanks for pointing this out! I’ve corrected the phrasing in our source files and it will be pushed to the live docs in the near future.

The one bit missing from the definitions Mieszko provided is that a Selector will fail if all of its children fail.

yeah rythm, that makes a lot more sense now, thx!

cheers, :slight_smile: