Описание
# Hitbox API
**Adding more common collider for Minecraft**
- Oriented Bounding Box (OBB)
- Sphere
- Capsule
- Ray
- Compound
- Multiple collider can be combined into one.
- Composite collider can be nested.
### How to Use
In any place where collision detection is needed, create a collider object and use the methods in ColliderUtil to determine if a collider has occurred.
For entities (Entity), you can achieve collider box caching by attaching **HitboxDataAttachments#COLLISION**. The cached collider can be rendered by pressing **F3 + B**. Note that this Data does not have a persistence implementation.
### Performance
Testing Method
- JMH Benchmark
Testing Environment
- CPU: AMD R5 5600G
- Memory: 32GB
- JDK: Microsoft OpenJDK 21.0
Testing Settings
- Warm-up Rounds: 5
- Test Rounds: 5
Testing Items
- Collision detection of the same type of collider
| Collider | Score | Error | Unit |
|:-----------------------------:|:--------------:|:-------------:|:-----:|
| Axis-Aligned Bounding Box | 3561837865.930 | 157982649.213 | ops/s |
| Capsule | 22350681.198 | 238993.658 | ops/s |
| Rotated Capsule | 16842309.523 | 103959.918 | ops/s |
| Oriented Bounding Box | 5528493.224 | 64548.996 | ops/s |
| Rotated Oriented Bounding Box | 4648963.750 | 111369.535 | ops/s |
| Sphere | 119556589.705 | 1711146.560 | ops/s |
Note: Higher scores indicate better performance. **Rotated** means the collider is rotated and the relevant vectors are recalculated.
