更新日志

本项目的所有重要变更均记录在此文件中。

格式遵循 保持更新日志 规范，且本项目遵守 语义化版本控制。

请通过查找对应模组加载器的文件来确认您的版本：

• spyglass_improvements-<mod-version>+mc<mc-version>+forge.jar
• spyglass-improvements-<mod-version>+mc<mc-version>+fabric.jar

[1.5.13] - 2026-5-23（Fabric、NeoForge）

可用版本：

• Fabric：26.1、26.1.1、26.1.2
• NeoForge：26.1、26.1.1、26.1.2

变更内容

• 迁移至 Minecraft 26.1+ 版本
• 配件（Accessories）模组已暂时禁用，待其更新后恢复支持

[1.5.12-beta for 1.21.11] - 2025-12-24（Fabric、NeoForge）

可用版本：

• Fabric：1.21.11
• NeoForge：1.21.11

变更内容

• 迁移至 Minecraft 1.21.11 版本
• 配件（Accessories）模组已暂时禁用，待其更新后恢复支持

[1.5.12] - 2025-11-02（Fabric、NeoForge、Forge）

可用版本：

• Fabric：1.20、1.20.1、1.21.9、1.21.10
• Forge：1.20、1.20.1
• NeoForge：1.21.9、1.21.10

变更内容

• 新增“切换额外缩放”选项
• 新增“强制启用单筒望远镜”选项（即使物品栏中未持有单筒望远镜也可启用）
• 重做了设置界面

[1.5.11] - 2025-10-28（Fabric、Forge）

可用版本：

• Fabric：1.20、1.20.1
• Forge：1.20、1.20.1

变更内容

• 修复设置按钮位置错误问题
• 修复 Forge 加载器下快捷键失效问题

[1.5.10] - 2025-10-27（Fabric、NeoForge、Forge）

可用版本：

• Fabric：1.20、1.20.1、1.21.9、1.21.10
• Forge：1.20、1.20.1
• NeoForge：1.21.9、1.21.10

变更内容

• 提高最大缩放倍数

[1.5.9] - 2025-10-25（Fabric、NeoForge）

可用版本：

• Fabric：1.21.5、1.21.6、1.21.7、1.21.8、1.21.9、1.21.10
• NeoForge：1.21.5、1.21.6、1.21.7、1.21.8、1.21.9、1.21.10

变更内容

• 改用 Trinkets Canary 实现对新版饰物模组的兼容性支持
• 修复配件（Accessories）模组兼容性问题

[1.5.8] - 2025-03-24（Fabric、NeoForge）

可用版本：

• Fabric：1.21.2、1.21.3、1.21.4
• NeoForge：1.21.2、1.21.3、1.21.4

变更内容

• 新增 Fabric 与 NeoForge 下的配件（Accessories）模组支持；推荐优先使用配件（Accessories）模组
• 修复 Curios/Trinkets 模组兼容性问题；单筒望远镜将不再在玩家腰部渲染

[1.5.7] - 2024-08-16（Fabric、NeoForge）

可用版本：

• Fabric：1.21、1.21.1
• NeoForge：1.21、1.21.1

已修复

• 修复使用鼠标滚轮时缩放倍数无法改变的问题

[1.5.6] - 2024-08-12（Fabric、NeoForge）

可用版本：

• Fabric：1.21、1.21.1
• NeoForge：1.21、1.21.1

变更内容

• 新增俄语（RU_RU）翻译（感谢 Hadeslnc）
• 通过减少侵入式 Mixin 的使用，提升了跨模组兼容性

[1.5.5] - 2024-08-06（Fabric、NeoForge）

可用版本：

• Fabric：1.21、1.21.1
• NeoForge：1.21、1.21.1

变更内容

• 新增繁体中文（ZH_TW）翻译（感谢 yichifauzi）

[1.5.5-forge] - 2024-08-06（Forge）

重要提示：此为从 Forge 版本 1.5(.0) 分支出的特殊版本，因 Architectury 当前尚不支持 Forge。
尽管功能上与 Fabric/NeoForge 的 1.5.4 版本一致，但底层代码差异显著，故需明确区分。

近期 Forge 极不稳定（尤其对模组开发者而言），后续版本发布或将延迟。

可用版本：

• Forge：1.21

变更内容

• 迁移至 Minecraft 1.21 版本
• 新增繁体中文（ZH_TW）翻译（感谢 yichifauzi）
• 新增日语（JP_jp）翻译（感谢 EndilCrafter，同 1.5.4 版本）

[1.5.4] - 2024-06-16（Fabric、NeoForge）

可用版本：

• Fabric：1.21
• NeoForge：1.21

已修复

• 修复 Curios 与饰物（Trinkets）模组兼容性问题 问题 #53

变更内容

• 新增日语（JP_jp）翻译（感谢 EndilCrafter）
• 更新 NeoForge 版本

[1.5.3] - 2024-06-16（Fabric、NeoForge）

可用版本：

• Fabric：1.20.6
• NeoForge：1.20.6

变更内容

• 代码库已重写，采用 Architectury 框架以简化多加载器适配开发
• 新增 NeoForge 支持！
• 因稳定性问题及无法构建 1.20.6 及以上版本，Forge 支持已暂时暂停（希望是暂时的）

[1.5.2] - 2024-06-01（Fabric）

可用版本：

• Fabric：1.20.5、1.20.6

已修复

• Fabric：
  • 修复单筒望远镜设置按钮位置错误问题

[1.5.1] - 2024-04-27（Fabric）

可用版本：

• Fabric：1.18.2、1.19.4、1.20、1.20.1、1.20.2、1.20.3、1.20.4、1.20.5、1.20.6

已修复

• Fabric：
  • 修复多人服务器中单筒望远镜无法切换的问题，具体包括以下情形：
    • 创造模式下单筒望远镜无法切换
    • 单筒望远镜放置于饰物（Trinkets）槽位时无法切换
      • 注意：在多人服务器中使用饰物（Trinkets）模组时，服务器端也需安装《望远镜改进》模组

[1.5] - 2024-01-31（Forge） - 2024-03-27（Fabric）

可用版本：

• Fabric、Quilt：1.18.2、1.19、1.19.1、1.19.2、1.19.3、1.19.4、1.20、1.20.1、1.20.2、1.20.3、1.20.4
• Forge：1.18.2、1.19、1.19.1、1.19.2、1.19.3、1.19.4、1.20、1.20.1、1.20.2、1.20.3、1.20.4

新增内容

• Forge：
  • Curios API 支持 —— 单筒望远镜现可装备于腰带 Curios 槽位，并通过快捷键调用（感谢 Kimchiloof）
• Fabric：
  • Trinkets 支持 —— 单筒望远镜现可装备于腰带饰物（Trinkets）槽位，并通过快捷键调用

变更内容

• Forge：
  • 模组现对 Curios API 具有软依赖（客户端与服务端均需）
    • 若未安装 Curios API，模组在客户端仍可如常运行
  • 调整部分后端代码，便于未来版本更新
• Fabric：
  • 模组现对饰物（Trinkets）模组具有软依赖（客户端与服务端均需）
    • 若未安装饰物（Trinkets）模组，模组在客户端仍可如常运行

已修复

• Forge：
  • 修复瞄准状态下打开物品栏后，玩家当前手持物品栏/快捷栏槽位发生不同步的问题
    • 此前需重新正常使用单筒望远镜以重置槽位；现已修复为单筒望远镜始终保留在上次使用的位置

[1.4] - 2022-09-13

可用版本：

• Fabric、Quilt：1.19、1.19.1、1.19.2、1.19.3、1.19.4、1.20、1.20.1、1.20.2、1.20.3、1.20.4
• Forge：1.19、1.19.1、1.19.2、1.19.3、1.19.4、1.20、1.20.1、1.20.2、1.20.3、1.20.4
• NeoForge：1.20.2、1.20.3、1.20.4

新增内容

• Fabric、Quilt：
  • 现可在第三人称视角下使用单筒望远镜并进行缩放
  • （2022-12-08）更新至 Minecraft 1.19.3
  • （2023-03-19）更新至 Minecraft 1.19.4
  • （2023-06-07）更新至 Minecraft 1.20 与 1.20.1
  • （2023-10-20）更新至 Minecraft 1.20.2、1.20.3 与 1.20.4，并新增韩语与葡萄牙语（巴西）翻译（感谢 Yusi0 与 FITFC）
• Forge：
  • 现可在第三人称视角下使用单筒望远镜并进行缩放
  • 更新至 Minecraft 1.19.3 与 1.19.4
  • （2023-06-18）更新至 Minecraft 1.20 与 1.20.1
  • （2023-10-20）更新至 Minecraft 1.20.2、1.20.3 与 1.20.4，并新增韩语翻译（感谢 Yusi0）
• NeoForge：
  • 现可在第三人称视角下使用单筒望远镜并进行缩放
  • （2023-10-20）更新至 Minecraft 1.20.2、1.20.3 与 1.20.4，并新增韩语翻译（感谢 Yusi0）

已修复

• Fabric、Quilt：
  • 修复重命名后的单筒望远镜无法响应快捷键的问题
• Forge、NeoForge：
  • 修复重命名后的单筒望远镜无法响应快捷键的问题
  • 修复快捷键未显示在控制设置界面中的问题

[1.3.1] - 2022-07-28

可用版本：

• Forge：1.19、1.19.1、1.19.2

新增内容

• Forge：
  • 更新至 Minecraft 1.19、1.19.1 与 1.19.2

已修复

• Forge：
  • 修复与较新 Forge 版本的不兼容问题

[1.3] - 2022-06-08

可用版本：

• Fabric：1.19、1.19.1、1.19.2
• Forge：1.19

新增内容

• Fabric：
  • 更新至 Minecraft 1.19、1.19.1 与 1.19.2
• Forge：
  • 更新至 Minecraft 1.19

已修复

• Fabric、Forge：
  • 修复创造模式下操作单筒望远镜时不播放音效的问题

[1.2] - 2022-04-24

可用版本：

• Fabric：1.18.2
• Forge：1.18.1、1.18.2

新增内容

• Fabric、Forge：
  • 新增“瞄准时隐藏准星”选项
  • 新增“启用平滑（电影级）镜头”选项（仅限瞄准时启用）

[1.1.1] - 2022-02-19

可用版本：

• Forge：1.18.1、1.18.2

已修复

• Forge：
  • 修复服务端与客户端逻辑错误

[1.1] - 2022-02-11

可用版本：

• Fabric：1.18.1、1.18.2
• Forge：1.18.1

新增内容

• Fabric：
  • 重新发布，JAR 文件中添加 Fabric 标签以便区分
  • （2022-02-28）更新至 Minecraft 1.18.2
• Forge：
  • Forge 首次发布

[1.0] - 2022-01-22

可用版本：

• Fabric：1.18.1

新增内容

• Fabric：
  • 初始发布