CodeCreature的ARPG等距自定义相机演示扩展

CustomCameraDemo 命令

此模组仅扩展了 CameraDemo 命令，使您可以自定义俯仰角和偏航角。

一个自定义的相机演示命令，允许您设置相机的俯仰角和偏航角旋转，以获得类似《暗黑破坏神》或《流放之路》的等距/俯视视角。

命令语法

/CustomCameraDemo --pitch <度数> --yaw <度数>

参数

参数	类型	范围	默认值	描述
pitch	双精度浮点数	-90° 到 90°	-45°	相机俯仰角度（垂直倾斜）。负值表示从上方向下看。
yaw	双精度浮点数	-180° 到 180°	0°	相机偏航角度（水平旋转）。

两个参数都是可选的。

使用示例

基本用法

/CustomCameraDemo

使用默认设置（俯仰角：-45°，偏航角：0°）激活相机演示 - 一种《暗黑破坏神》/《流放之路》风格的等距视图。

自定义俯仰角

/CustomCameraDemo pitch:-30

以 -30° 俯仰角（角度较缓）和默认偏航角激活。

自定义偏航角

/CustomCameraDemo yaw:45

以默认俯仰角和 45° 水平旋转激活。

两个参数

/CustomCameraDemo pitch:-60 yaw:90

以 -60° 俯仰角（更陡的俯视视角）和 90° 偏航角（向东旋转）激活。

相机行为

激活后，相机演示将：

• 设置具有指定俯仰角和偏航角旋转的自定义相机视图
• 与玩家保持 20 个单位的距离
• 启用光标显示以进行鼠标交互
• 允许基于鼠标的方块放置和移除
• 取消玩家交互事件以防止冲突

默认相机角度

默认的 -45° 俯仰角提供了类似于以下游戏的等距相机角度：

• 《暗黑破坏神》系列 - 经典动作角色扮演游戏相机
• 《流放之路》 - 俯视动作角色扮演游戏视角
• 《星际争霸》 - 即时战略游戏风格视图

此角度在保持深度感知的同时，提供了周围区域的良好可见性。

技术细节

旋转系统

• 俯仰角：绕 X 轴旋转（垂直倾斜）
  • 负值 = 从上方向下看
  • 正值 = 从下方向上看
• 偏航角：绕 Y 轴旋转（水平旋转）
  • 0° = 北
  • 90° = 东
  • 180° = 南
  • -90° = 西

实现

• 扩展了 AbstractPlayerCommand
• 使用 CustomCameraDemo 辅助类
• 内部将度数转换为弧度
• 验证输入范围以防止无效的相机角度

鼠标控制（激活时）

• 左键单击：在目标位置上方放置方块
• 中键单击：在目标位置放置方块
• 右键单击：移除目标位置的方块

停用

可以通过以下方式停用相机演示：

• 使用基础相机系统的停用方法
• 断开服务器连接（自动清理）

备注

• 相机设置为第三人称模式（非第一人称）
• 启用了眼部偏移以实现更自然的定位
• 鼠标输入使用基于平面的定位进行精确的方块选择