Explosion is not networked properly

[crabmusket]

This issue has persisted for a long time. Creating an Explosion on the server, using this function for example, will not create the explosion for any clients.

Solution: either make Explosion work as expected, provide a utility function to do so easily, or at the very least remove that example in explosion.cpp.

EDIT: Decided that this is a documentation issue. Will be resolved for 3.6.

[andr3wmac]

I ran into this issue. If you look at it again createExplosion doesn't actually exist, it's just an example of a function that shows how to create an explosion. It also makes no mention of automatically ghosting or being sent to other clients.

It's for this reason, and from reading through the code, that I concluded it's only intended to be spawned client side, like playing a sound. This doesn't mean the issue doesn't still exist though. I decided to solve it the same way sounds were handled:
https://gist.github.com/andr3wmac/11208941

So if you want to play an explosion, like a sound, you use ServerPlayExplosion();

[Areloch]

If you look at the Explosion class, it declares IsGhost. It's designed around being on the clients.

I'd say Andrew's solution looks like it would work well enough.

[dottools]

Definitely not a bug. Reviewing the source code it shows that it was designed to be used on client-side only as only its datablock ExplosionData is networked and ghosted, while the explosion is suppose to be used by particle effects and what not. It isn't suppose to be used independently server side.

[crabmusket]

Ok, good answers. It still seems to me that the documentation implies it can be used as a regular object and ghosted. IMO we should fix that doc string to contain Andrew's example.

[crabmusket]

Added @andr3wmac's code to the docs. Incidentally, writing TS examples in the source is shite.