5.2.0

• 新增配置选项，用于定义不可被选取的隐形实体
• 新增配置选项，可在计算摄像机偏移时忽略柱状方块
• 更新了俄语翻译（感谢 mpustovoi）
• 修复了模组描述中的拼写错误

5.1.1

• 新增在受限空间内自动切换至临时第一人称的选项
  • 新增配置选项，用于设置是否在受限空间内切换至临时第一人称
  • 新增配置选项，可为每个轴设置偏移阈值
  • 新增配置选项，用于设置再次进入临时第一人称前的冷却时间
  • 新增配置选项，用于设置临时第一人称的额外停留时间
  • 新增配置选项，用于设置临时第一人称的最短停留时间
• 新增选项：面朝摄像机时将玩家X轴旋转朝向摄像机
• 新增选项：定义不与摄像机发生碰撞的方块
  • 玻璃方块现在默认与摄像机发生碰撞
• 在模组元数据中添加了问题反馈链接
• 修复了可取消事件处理器无法正常工作的问题
• 修复了骑乘方块宝可梦飞行时的摄像机旋转问题（方块宝可梦 1.7）
• API：新增 ComputeCameraDrag 事件
• API：新增 ComputeCameraSway 事件
• API：新增 PerspectiveChanged 事件

5.0.11

• 修复了移植版中“摄像机随玩家旋转”选项无法正常工作的回退问题。

5.0.10

• 修复了旧版 API 适配器在某些情况下调用错误 API 版本的问题，避免其他模组使用旧版 API 时可能发生的崩溃

5.0.9

• 修复了安装 Iris 时出现的崩溃

5.0.8

• 为 NeoForge 恢复了缺失的 Iris/Oculus 光影兼容代码

5.0.7

• 修复了切换视角后动态准星仍然保持激活的问题

5.0.6

• 修复了饰品兼容插件的加载问题
• 修复了在 (Neo)Forge 上加载/卸载世界时的崩溃问题

5.0.5

• 修复了切换视角后遮挡指示器仍然可见的问题

5.0.4

• 修复了 setXRot 和 setYRot API 方法行为不正确的问题

5.0.3

• 更新了繁体和简体中文翻译（感谢 Xinyang-Gao）
• 新增用于向后兼容的旧版 API 适配器

5.0.2

• 提升了模组兼容性
• 修复了遮挡准星的渲染问题

5.0.1

• 更新了俄语翻译（感谢 mpustovoi）

5.0.0

• 新增配置选项，用于控制攀爬时的玩家透明效果（默认关闭）
• 将切换肩部视角的默认按键由 'O' 改为 'U'
• 默认启用配置选项 "turn_player_x_rot_with_camera"
• 默认启用配置选项 "turn_player_y_rot_with_camera"
• 默认禁用配置选项 "turn_with_player"
• 启用 "turn_with_player" 后，玩家不再随摄像机旋转
• 当 'pick_vector' 为 'PLAYER' 且 'crosshair_type' 为 'DYNAMIC' 时，玩家现在会随摄像机旋转
• 修复了创造模式飞行时眼睛高度过低的问题
• 其他优化与稳定性修复
• 重新整理了部分配置选项。可使用以下映射进行迁移：
  • camera.fov_override_enabled → camera.fov.fov_override_enabled
  • camera.fov_override → camera.fov.fov_override
  • camera.dynamically_adjust_offsets → camera.offset.dynamic_offsets
  • camera.camera_step_size → camera.offset.step_size
  • camera.follow_player_rotations → camera.turn_with_player
  • camera.follow_player_rotations_delay → camera.turn_with_player_delay
  • crosshair.obstruction.show_obstruction_indicator → crosshair.obstruction.obstruction_indicator
  • player.adjust_player_transparency → player.transparency.adjust_transparency
  • player.player_x_rot_follows_camera → player.turning.turn_player_x_rot_with_camera
  • player.player_y_rot_follows_camera → player.turning.turn_player_y_rot_with_camera
  • player.player_y_rot_follow_angle_limit → player.turning.turn_player_y_rot_angle_limit
  • player.turn_player_transparent_when_aiming → player.transparency.when_aiming
• 瓦尔基里天空 2.4.11 以上版本不再被标记为不兼容
• API：将回调系统替换为事件系统
• API：现在可以为每个模组注册多个插件类
• API：API 已重构，部分内容已重命名。迁移指南见维基：https://github.com/Exopandora/ShoulderSurfing/wiki/API-Documentation-v5-Migration