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 _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.)

1. Initialization

    public ExamplePlugin(CameraModifier modifier) {
        modifier.disable()
                .enablePos()
                .enableFov()
                .enableGlobalMode();
    }

1. 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