更新日志

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

格式基于 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 以兼容更新版本的饰品模组。
• 修复配件（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）支持。建议尽可能使用配件模组。
• 修复 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

变更

• 感谢 Hadeslnc，新增俄语（RU_RU）翻译。
• 改进模组间兼容性，因使用了侵入性更低的 Mixin。

[1.5.5] - 2024-08-06 (fabric, neoforge)

可用版本：

• Fabric: 1.21, 1.21.1
• NeoForge: 1.21, 1.21.1

变更

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

[1.5.5-forge] - 2024-08-06 (forge)

重要提示：此为从 Forge 1.5(.0) 版本分支出的特殊版本，因为目前 Architectury 无法与 Forge 正常协作。
尽管功能上与 Fabric/Neo 的 1.5.4 版本一致，但代码库差异较大，因此进行了明确区分。

Forge 近期非常不稳定，至少对模组开发者而言如此，因此未来版本可能会有进一步延迟。

可用版本：

• Forge: 1.21

变更

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

[1.5.4] - 2024-06-16 (fabric, neoforge)

可用版本：

• Fabric: 1.21
• Neoforge: 1.21

修复

• 修复 Curios 和饰品（trinkets）相关问题 Issue #53

变更

• 感谢 EndilCrafter，新增日语（JP_jp）翻译。
• 更新 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:
  • 修复在服务器上以下情况下单筒望远镜无法切换的问题：
    • 创造模式下无法切换望远镜。
    • 当物品位于饰品槽位时无法切换望远镜。
      • 注意：多人游戏中使用饰品时，服务器端也应安装 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:
  • 修复在瞄准状态下打开物品栏后，玩家当前物品栏/快捷栏槽位不同步的 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:
  • 首次发布