更新日志

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

格式遵循 Keep a Changelog，且本项目遵守 语义化版本控制。

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

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

[1.5.14] - 2026年7月18日（Fabric、NeoForge）

可用版本：

• Fabric：26.2
• NeoForge：26.2

变更

• 迁移至 26.2 版本

[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

变更

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

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

可用版本：

• Fabric：1.21.11
• NeoForge：1.21.11

变更

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

[1.5.12] - 2025年11月2日（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 以支持新版饰物（Trinket）模组
• 修复配件（Accessories）模组兼容性问题

[1.5.8] - 2025年3月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/Trinket）支持问题；单筒望远镜将不再在玩家腰部位置渲染

[1.5.7] - 2024年8月16日（Fabric、NeoForge）

可用版本：

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

已修复

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

[1.5.6] - 2024年8月12日（Fabric、NeoForge）

可用版本：

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

变更

• 新增俄语（RU_RU）翻译，感谢 Hadeslnc
• 改进跨模组兼容性，因采用侵入性更低的 Mixin 注入方式

[1.5.5] - 2024年8月6日（Fabric、NeoForge）

可用版本：

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

变更

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

[1.5.5-forge] - 2024年8月6日（Forge）

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

近期 Forge 平台极不稳定（尤其对模组开发者而言），因此后续版本可能进一步延迟。

可用版本：

• Forge：1.21

变更

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

[1.5.4] - 2024年6月16日（Fabric、NeoForge）

可用版本：

• Fabric：1.21
• NeoForge：1.21

已修复

• 修复饰物（Curios）与缀品（Trinket）兼容性问题 问题 #53

变更

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

[1.5.3] - 2024年6月16日（Fabric、NeoForge）

可用版本：

• Fabric：1.20.6
• NeoForge：1.20.6

变更

• 重构代码库，引入 Architectury 以简化不同加载器平台的模组开发
• 新增 NeoForge 支持！
• 因稳定性问题及无法构建 1.20.6 及更高版本，Forge 支持已暂时暂停（希望仅为临时）

[1.5.2] - 2024年6月1日（Fabric）

可用版本：

• Fabric：1.20.5、1.20.6

已修复

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

[1.5.1] - 2024年4月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 space）时无法切换
      • 注意：在多人游戏中使用饰物（Trinkets）模组时，服务器端也需安装“望远镜改进”模组

[1.5] - 2024年1月31日（Forge） - 2024年3月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：
  • 饰物 API（Curios API） 支持 —— 单筒望远镜现可装备于饰物（Curios）腰带栏位，并可通过快捷键调用（感谢 Kimchiloof）
• Fabric：
  • 缀品（Trinkets） 支持 —— 单筒望远镜现可装备于缀品（Trinket）腰带栏位，并可通过快捷键调用

变更

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

已修复

• Forge：
  • 修复瞄准状态下打开物品栏后玩家当前物品栏/快捷栏槽位不同步的 Bug
    • 玩家无需再重新正常使用单筒望远镜以重置槽位，单筒望远镜将保持在上次使用的槽位

[1.4] - 2022年9月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月8日）更新至 1.19.3
  • （2023年3月19日）更新至 1.19.4
  • （2023年6月7日）更新至 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年6月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年7月28日

可用版本：

• Forge：1.19、1.19.1、1.19.2

新增

• Forge：
  • 更新至 1.19、1.19.1 和 1.19.2

已修复

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

[1.3] - 2022年6月8日

可用版本：

• 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年4月24日

可用版本：

• Fabric：1.18.2
• Forge：1.18.1、1.18.2

新增

• Fabric、Forge：
  • 新增瞄准时隐藏准星的选项
  • 新增瞄准时启用平滑（电影级）摄像机的选项

[1.1.1] - 2022年2月19日

可用版本：

• Forge：1.18.1、1.18.2

已修复

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

[1.1] - 2022年2月11日

可用版本：

• Fabric：1.18.1、1.18.2
• Forge：1.18.1

新增

• Fabric：
  • 重新发布，JAR 文件添加 Fabric 标签以便区分
  • （2022年2月28日）更新至 1.18.2
• Forge：
  • Forge 首次发布

[1.0] - 2022年1月22日

可用版本：

• Fabric：1.18.1

新增

• Fabric：
  • 初始发布