Free camera API - 自由视角API

自由视角 API V4

自由视角模式

自 3.2.0 版本起，本模组已内置自由视角功能，因为许多玩家被模组名称吸引，却发现实际上并未包含此功能。

默认情况下，此功能 未绑定 按键映射，需要手动设置。方块碰撞检测 默认启用，可通过配置界面禁用。如果服务器未安装此模组，该功能将被 强制启用；否则，将遵循服务器的设置。

有哪些优势？

• 与相机内部逻辑解耦，降低复杂度。
• 使用简单灵活。
• 支持加载超出玩家视野范围的区块（需扩展功能）。​

如何注册和使用插件

• 创建插件类

    @CameraPlugin(value = "example", priority = ModifierPriority.LOWEST)
    public class ExamplePlugin implements ICameraPlugin {
        // ...
    }

value: 插件唯一标识符（字符串）

priority: 优先级设置（ModifierPriority.HIGH/LOWEST 等）

• 初始化

    @Override
    public void initialize(ICameraModifier modifier) {
        this.modifier = modifier;
        modifier.enable();
    }

• 每帧更新相机数据

    modifier
                .enablePos() // 启用位置修改
                .enableRotation() // 启用旋转修改
                .enableFov() // 启用视场角修改
                .setPos(1, 2, 3) // 将相机位置设置为 (1,2,3)，默认为以玩家为中心的局部坐标
                .addPos(1, 2, 3)
                .setRotationYXZ(90f, 15f, 25f) // 将相机旋转设置为 (90f, 15f, 25f)
                .move(0, 0, -5) // 基于当前旋转移动相机
                .enableGlobalMode() // 启用全局模式，所有坐标和旋转将根据世界坐标进行修改
                .enableChunkLoader() // 启用区块加载器，加载相机周围的区块。需要额外安装 Free Camera API Addition 模组才能启用此功能，否则无效
                .enableObstacle() // 启用碰撞检测

图库