5.2.0

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

5.1.1

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

• 修复了 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）

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