更新日志

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

格式基于 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-16 (fabric, neoforge, forge)

可用版本：

• Fabric: 1.18.2, 1.19, 1.19.1, 1.19.2, 1.20, 1.20.1, 1.21.9, 1.21.10,
• Forge: 1.18.2, 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）支持。建议尽可能使用 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 支持 —— 现在可将望远镜装备在“腰带”饰品槽位，并通过快捷键使用（感谢 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:
  • 修复逻辑服务器端和客户端的 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:
  • 首次发布