Please update the documentation

The current version of Netcode is quite capable however it is really lacking in the documentation area.
It really is just a collection of notes from the devs.
I’ve read the manual probably 20 times but still don’t quite understand “How to use” netcode.

As an example:
The section on “Value Types” is trying to say:
WARNING!!!
“Even with a [GhostField] attribute, only primitives and some built in Unity types will be replicated, i.e. (insert list of types). To support replication of user defined types you must blah blah IGhostDefaultOverridesModifier etc.”

This point is so very very important to note and yet its basically a footnote in the docs.
Note that the codegen doesn’t give an error either, it just “doesn’t work”.

Similarly I saw mentioned on the forum that runtime added/removed components are not supported by Netcode, which makes sense if you think about it for a bit but really this is a super important piece of information that helps the user understand how Netcode works. It needs a big ol “IMPORTANT” note.

I know documentation is hard to keep up to date but I hope that some more effort can be put towards updating the docs because honestly they add so much value. Netcode has so much potential but the learning curve is super steep only (I believe) for the lack of time spent on the docs.

2 Likes

Thanks for the feedback krooq! We 100% agree. I joined Unity recently, and one of my priorities is to ensure documentation is fit for purpose. Wish I could be more specific than “we’re working on it”, but we absolutely are.

6 Likes

Thanks Niki. I wish you luck, its not easy to convince senior developers to spend time writing documentation but it makes all the difference!

1 Like