Can anyone give me an example of adding a capability to players, please. I have some example code from a 1.12.2 mod, but things have clearly changed since then. I don't understand the documentation. It is fragmented and unclear. Obviously whoever wrote it understands what the hell they are talking about, but I don't. All the snippets and description is about an item handler for inventory related stuff on a block entity, which really does not help me.

For example, when do you use an existing capability (apparently through a new key, so how are you using an existing capability?) and when do you need to expose a capability, or do you have do both? It appears I would have to subclass the Minecraft Player class to expose a capability.

The initial text talks about exposing an event or "overriding the capability methods in your own implementations of the objects", but the section on exposing the capabilities has implementations of overriding the capability methods.

 

I am so confused. I just want to be able to add, for example, a "dizziness" value to a player that I can increment or decrement depending on certain things happening, and reference from other parts of the code.

 

There is a whole worked example for adding a serializable capability to an entity at the bottom of here:

https://forge.gemwire.uk/wiki/Capabilities#Code_Examples

And a separate section on the same wiki about attaching capabilities

https://forge.gemwire.uk/wiki/Capabilities/Attaching

That wiki is SO SO SO much better than the official forge documentation. Thank you so much.