更新日志

该项目所有显著变更将记录于此文件。

格式基于 Keep a Changelog，项目遵循 语义化版本规范。

通过查看适用于你所用模组加载器的文件来确定你的版本：

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

[1.5.12] - 2025-11-15 (fabric, neoforge, forge)

可用版本：

• Fabric: 1.19, 1.19.1, 1.19.2, 1.20, 1.20.1, 1.21.9, 1.21.10,
• Forge: 1.19, 1.19.1, 1.19.2, 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 以兼容新版 Trinkets。
• 修复饰品（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 正常协作。尽管功能上与 1.5.4 的 Fabric/Neo 版本一致，但代码库差异较大，因此明确区分。

近期 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 支持！
• 由于不稳定性以及无法构建 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）槽位时无法切换。
      • 注意：多人游戏中使用缀品时，服务器端也应安装 Spyglass-Improvements。

[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 API，模组仍可在客户端正常运行。

修复

• 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:
  • 重新发布，包含 fabric 标签以作区分。
  • (2022-02-28) 更新至 1.18.2
• Forge:
  • 首次 Forge 发布

[1.0] - 2022-01-22

可用版本：

• Fabric: 1.18.1

新增

• Fabric:
  • 首次发布