Hit system

[avaer]

We now have in place the prerequisites for correct damage tracking across the engine. We simply need to create the source of truth for character damage, and then hook it into the damage interaction points that are already in place.

There are many subsystems involved, but the integration between them is relatively light.

HP system

• [ ] A new module for tracking HP, damage, healing, and death of characters (local, remote, or npc type), should be made. This will provide the handling for and routing of hit events. It might provide convenience physics methods to determine hits. That code is currently sprinkled across the objects that perform hits.

A good inspiration for the structure of this module might be character-physics.js, an instance of which is owned by the player: https://github.com/webaverse/app/blob/bb1a433734386019575ce6fa7c092726f68e7e95/character-controller.js#L547

Character animations

• [x] #2751

Diorama system

• [x] When the character gets hit, the diorama of their face should slide in, indicating the damage.

Vocalization system

• [ ] We are constructing a set of voice packs which can be used for characters -- male and female. This mostly includes grunts and other vocalizations when the character performs totum based actions. Additionally, we have vocalization support for characters in engine (mouth flaps) when this happens. The hit system should coordinate these vocalizations.

Multiplayer

• [ ] This system should ultimately use the same state bindings as the players code, so that HP is a property that is replicated on the network.

Methods for hits can and should be exposed to metaversefile/totum apps.

UI system

• [ ] The HP system should be plugged into the character UI system which displays HP, with live updates using the standard react tooling like useEffect(/* ... add game listener; return () => { remove game listener } ... */)

[avaer]

Useful external apps work that would drive this project forward:

• add infinifruit healing capabilities
• add npc attack radius in front of them so that we can simulate hits

[avaer]

Re: animations, all of these currently suffer from foot blending problems, which is common to all items.

[0reo]

diorama system has been implemented. i'll still be going through the items in this ticket and looking for any existing tickets which are attempting to address these points