更新日志

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

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

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

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

[1.5.12b] - 2025-11-15 (forge)

可用版本：

• Forge: 1.20, 1.20.1

变更

• 修复了服务器上无法加载模组的问题。

[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以兼容更新版本的缀品系统。
• 修复配件（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

变更

• 添加俄语（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:
  • 修复在服务器上以下情况下单筒望远镜无法切换的问题：
    • 创造模式下无法切换单筒望远镜。
    • 物品位于缀品槽位时无法切换单筒望远镜。
      • 注意：多人游戏中使用缀品时，服务器端也应安装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 支持 — 单筒望远镜现在可装备在腰带类饰品槽并可通过按键绑定使用（感谢 Kimchiloof）。
• Fabric:
  • Trinkets 支持 — 单筒望远镜现在可装备在腰带类缀品槽并可通过按键绑定使用。

变更

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

[1.0] - 2022-01-22

可用版本：

• Fabric: 1.18.1

新增

• Fabric:
  • 首次发布