更新日志

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

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

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

• 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：
  • 修复多人服务器中单筒望远镜无法切换的问题，包括以下情形：
    • 创造模式下单筒望远镜无法切换。
    • 单筒望远镜位于饰物（Trinket）槽位时无法切换。
      • 注意：若在多人游戏中使用饰物（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 支持——单筒望远镜现在可装备于腰带（Trinket）槽位，并通过快捷键调用。

功能调整

• 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）更新至 1.19.3 版本。
  • （2023-03-19）更新至 1.19.4 版本。
  • （2023-06-07）更新至 1.20 与 1.20.1 版本。
  • （2023-10-20）更新至 1.20.2、1.20.3 与 1.20.4 版本，并新增韩语与巴西葡萄牙语本地化（感谢 Yusi0 与 FITFC）。
• Forge：
  • 现在可在第三人称视角下使用单筒望远镜并进行缩放。
  • 更新至 1.19.3 与 1.19.4 版本。
  • （2023-06-18）更新至 1.20 与 1.20.1 版本。
  • （2023-10-20）更新至 1.20.2、1.20.3 与 1.20.4 版本，并新增韩语本地化（感谢 Yusi0）。
• NeoForge：
  • 现在可在第三人称视角下使用单筒望远镜并进行缩放。
  • （2023-10-20）更新至 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：
  • 更新至 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：
  • 更新至 1.19、1.19.1 与 1.19.2 版本。
• Forge：
  • 更新至 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）更新至 1.18.2 版本。
• Forge：
  • Forge 平台首发版本。

[1.0] - 2022-01-22

可用版本：

• Fabric：1.18.1

新增功能

• Fabric：
  • 首发版本。