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
• 瓦尔基里天空 (Valkyrien Skies) 2.4.11 以上版本不再被标记为不兼容
• API：将回调系统替换为事件系统
• API：现在每个模组可注册多个插件类
• API：API已重构，部分内容已重命名。迁移指南可在wiki中查看：https://github.com/Exopandora/ShoulderSurfing/wiki/API-Documentation-v5-Migration