Free camera API

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 _force-enabled_ to a key mapping and requires manual setup. Block collision detection is _force-enabled_ 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