Описание
# Free camera API V5
## Free camera mode
Since version 3.2.0, the mod has included a built-in free camera feature, as many players were attracted by the mod's name only to discover that such functionality was not actually present.
By default, this feature is **_not bound_** to a key mapping and requires manual setup. Block collision detection is **_enabled by default_** and can be disabled via the configuration interface. If the mod is not installed on the server, it will be **_force-enabled_**; otherwise, it will follow the server's settings.
## What are the advantages?
- Decouples from camera internals, reducing complexity.
- Simple and flexible usage.
- Supports loading chunks beyond the player's view range (with expansion).
## How to Register and Use the Plugin
1. Create the plugin class
```
@Plugin(value = "example", priority = ModifierPriority.LOWEST)
public class ExamplePlugin implements CameraPlugin {
// ...
}
```
value: Plugin unique identifier (string)
priority: Priority setting (ModifierPriority.HIGH/LOWEST etc.)
2. Initialization
```
public ExamplePlugin(CameraModifier modifier) {
modifier.disable()
.enablePos()
.enableFov()
.enableGlobalMode();
}
```
3. Update camera data every frame
```
modifier
.enablePos() // Enable position modification
.enableRotation() // Enable rotation modification
.enableFov() // Enable FOV modification
.setPos(1, 2, 3) // Set camera position to (1,2,3), default is local coordinates centered on player
.addPos(1, 2, 3)
.setRotationYXZ(90f, 15f, 25f) // Set camera rotation to (90f, 15f, 25f)
.move(0, 0, -5) // Move camera based on current rotation
.enableGlobalMode() // Enable global mode, all coordinates and rotations will be modified according to world coordinates
.enableChunkLoader() // Enable chunk loader, load chunks around the camera. An additional Free Camera API Addition mod needs to be installed to enable this feature, otherwise it will have no effect
.enableObstacle() // Enable collision detection
```
## Gallery
