更新日志

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

格式遵循 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-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 以支持新版饰物（Trinket）模组
• 修复与配件（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

变更内容

• 迁移至 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）兼容性问题 Issue #53

变更内容

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

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

可用版本：

• Fabric：1.20.6
• NeoForge：1.20.6

变更内容

• 代码库已重写，采用 Architectury 框架，便于适配不同模组加载器
• 新增 NeoForge 支持！
• Forge 支持因平台不稳定及无法构建 1.20.6 及更高版本，暂被暂停（希望仅为暂时）

[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：
  • 修复瞄准时打开物品栏导致玩家当前物品栏/快捷栏槽位不同步的 Bug
    • 此前需重新正常使用单筒望远镜以重置槽位；现单筒望远镜将保持在上次使用的位置

[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：
  • 修复服务端与客户端逻辑相关 Bug

[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：
  • 初始发布版本