更新日志

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

格式基于 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-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 以兼容新版 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 正常工作。
尽管功能上与 Fabric/Neo 的 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 支持！
• 由于不稳定性以及无法构建 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 时，服务器端也应安装 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:
  • 修复逻辑服务器和客户端侧的 Bug。

[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:
  • 首次发布