5.2.0

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

5.1.1

• 新增在受限空间中自动切换到临时第一人称的选项
  • 新增配置选项，决定是否在受限空间中切换到临时第一人称
  • 新增配置选项，可为每个轴设置偏移阈值
  • 新增配置选项，设置再次进入临时第一人称前的冷却时间
  • 新增配置选项，设置临时第一人称的额外停留时间
  • 新增配置选项，设置临时第一人称的最小停留时间
• 新增选项：当玩家面向摄像机时，使其X轴旋转朝向摄像机
• 新增配置选项，定义与摄像机不发生碰撞的方块
  • 玻璃装饰方块现在默认与摄像机碰撞
• 在模组元数据中添加了问题反馈链接
• 修复了可取消事件处理程序无法正常工作的问题
• 修复了游戏暂停时摄像机随玩家转动出现的抖动问题
• API：新增 ComputeCameraDrag 事件
• API：新增 ComputeCameraSway 事件
• API：新增 PerspectiveChanged 事件

5.0.11

• 修复了向后移植版本中的一个问题，该问题导致“摄像机随玩家转动”选项无法正常工作。

5.0.10

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

5.0.7

• 修复了切换视角后动态准星仍然显示的问题

5.0.6

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

5.0.5

• 修复了切换视角后拦截指示器仍然显示的问题

5.0.4

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

5.0.3

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

5.0.2

• 改进了模组兼容性
• 修复了拦截准星的渲染问题

5.0.1

• 更新了俄语翻译（感谢 mpustovoi）
• 修复了与实体模型特性（EMF）的兼容性

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 结构经过重构，部分内容已重命名。迁移指南见 wiki：https://github.com/Exopandora/ShoulderSurfing/wiki/API-Documentation-v5-Migration