Zoom-o-Matic

一个简单但可自定义的多按键缩放工具，适用于 Minecraft。

它支持最多 3 个按键绑定，可自定义缩放级别以及开启/关闭平滑相机。

此模组主要用于学习，随意使用，但其最大目的是学习和教授 Fabric 模组开发。

学习 Fabric 的文档

虽然我们并非 Fabric 方面的专家，但我们想分享我们的开发历程，希望能帮助其他人开始学习 Fabric 模组开发和 Java。

因此，我们目前正在（进行中）编写详细的代码注释。未来，我们可能会根据反馈制作书面或视频教程。

在此处查找代码注释。

使用方法

安装

在为相应版本安装 Fabric 模组加载器后，将最新版本的 Zoom-o-matic 及兼容依赖项放入 .minecraft/mods 文件夹中。

依赖项

Fabric Mod Loader（需安装才能使用） https://fabricmc.net/use/installer/

Fabric API（放入模组文件夹中） https://github.com/FabricMC/fabric

owo-lib（放入模组文件夹中） https://github.com/wisp-forest/owo-lib

使用模组

默认的 Zoom 1 按键绑定为“C”，但该按键已被占用，因此你需要取消绑定“保存快捷栏激活器”或将 zoom1 绑定到其他按键，才能使模组正常工作。

模组菜单

该模组已在模组菜单中注册，如果你愿意，可以通过该 GUI 调整设置，否则可使用命令。

按键绑定

可在 Minecraft 原始按键绑定菜单的 Zoom-o-Matic 部分中找到。

选项 -> 控制 -> 按键绑定

滚动缩放

缩放时，你可以使用鼠标滚轮向内或向外滚动来调整缩放程度。

缩放量

调整缩放幅度，使用以下命令：

/ZoomO ZoomAmount Zoom_X YY

• X = 缩放按键编号（1、2 或 3）
• YY = 缩放百分比（1 - 99）

平滑相机开关

切换缩放时是否启用 smooth_camera，该功能会减缓移动速度。

/ZoomO SmoothCamera Zoom_X YY

• X = 缩放按键编号（1、2 或 3）
• YY = true/false

滚动缩放文本开关

切换使用滚轮时是否在文本中显示缩放百分比。

/ZoomO ActionBarWriting XX

• XX = true/false

关于此模组及计划

此模组旨在为学习如何开发 Minecraft Fabric 模组提供平台。这是我们的第一个模组，所以我们知道它并非 100% 完美，但这并不是重点。

目标是优化它、改进它、完善其功能，以帮助我们更深入地了解模组开发。

以下是我们希望做出的改进清单，按优先级排序：

• 移除 owo 依赖——即创建一个独立于世界的数据保存系统。
• 添加滚动缩放（已完成）
• 添加自定义、可配置的平滑器
• 添加自定义 GUI
  • 添加更多按键绑定（包括通过 GUI 添加更多按键）
• 添加动画
  • 诸如缓动之类的预设
• 添加可自定义动画

鸣谢

@Fej1Dev 在开发过程中始终与我们携手合作，亲自编写了大部分代码，并在我们遇到困难时提供了帮助！

@LogcialGeekBoy 和 Logical Zoom —— 此模组中使用的部分代码（主要是 mixin）来自 Logical Zoom，但更重要的是，他的模组启发我们制作了自己的模组。