Zoomrgy

Zoomrgy 🔍

一款功能完善、高性能且高度可配置的客户端缩放模组，适用于 Minecraft（Fabric）。

Zoomrgy 提供流畅、高级的缩放体验（“Smith Zoom”），其特色包括高度优化的缓动曲线、鼠标灵敏度调整、滚轮缩放，以及内置测距仪和目标高亮等遥测工具。

---

🌟 主要特性

• 极致流畅的缓动过渡（Smith Zoom）： 动态缓动视野变化，而非瞬间切换。支持多种缓动函数（二次、三次、圆形、正弦、弹性、弹跳、平滑步进等），并针对零帧率卡顿进行了优化。
• 滚轮缩放等级： 按住缩放键并上下滚动鼠标滚轮，可实时调整放大倍率，并可选配点击音效反馈。
• 动态鼠标灵敏度缩放： 根据当前视野比例缩放鼠标视角速度，防止高倍率下鼠标过于灵敏。
• 双缩放预设与望远镜集成： 为两种不同的缩放预设分配独立快捷键（例如，C 键为标准 4.5 倍缩放，V 键为 14 倍高倍缩放）。可选拦截并增强原版望远镜的使用体验。
• 智能遥测 HUD： 显示当前缩放倍率、方向罗盘方位、方块/实体测距仪距离，以及准星下方的实体类型标记。
• 高亮瞄准实体： 在高倍率下，自动以客户端发光轮廓效果高亮你所瞄准的实体。
• 电影感惯性： 模拟高惯性摄像机平移，实现如黄油般顺滑的电影追踪镜头（完全可自定义）。
• 减少雾效： 根据缩放倍率成比例地推远雾效距离，确保长距离视野清晰。

---

🛠 安装与依赖

要运行 Zoomrgy，请将编译好的 .jar 文件放入你的 Minecraft mods 文件夹。请确保已安装以下内容：

1. Fabric Loader（版本 >=0.19.2 或更新）
2. Fabric API（版本 >=0.150.0）
3. Cloth Config API（配置 UI 界面所需）
4. Mod Menu（强烈推荐；提供配置界面的入口）

---

🎮 控制与按键绑定

Zoomrgy 注册了一个自定义的控制类别。你可以在 Minecraft 默认的 选项 > 控制 > 按键绑定 菜单中重新绑定这些按键：

按键描述	默认按键	行为
缩放	C	激活主缩放倍率（默认按住保持，支持切换/双击锁定）。
缩放预设 2	V	激活次高倍预设缩放。
放大	未绑定	手动增加滚轮缩放步长。
缩小	未绑定	手动减少滚轮缩放步长。
切换缩放锁定	未绑定	手动锁定/解锁当前激活的缩放状态。

• 滚轮机制： 缩放时，使用 滚轮向上 进一步放大，滚轮向下 缩小。
• 双击锁定： 在 300 毫秒 内双击缩放键可锁定缩放状态。再次点击或按下任何缩放绑定键即可解除锁定。

---

⚙ 配置设置

在游戏内，通过 Mod Menu 点击模组列表上的齿轮图标即可直接配置 Zoomrgy。JSON 配置保存在 config/zoomrgy.json 中。

以下是所有可用设置的详细说明：

🎮 控制与行为

游戏内设置名称	JSON 字段键	默认值	描述
基础缩放倍率	zoomMultiplier	4.5	使用主缩放（C 键）时应用于基础视野的倍率。
预设 2 缩放倍率	zoomMultiplierPreset2	14.0	使用缩放预设 2（V 键）时应用的倍率。
最大滚轮等级	maxScrollLevel	10	滚轮缩放的最大步数限制。
松开后重置滚轮	resetScrollOnRelease	true	松开缩放键时将滚轮倍率重置为 1.0x。
缩放切换模式	zoomToggleMode	false	按下缩放键后永久切换状态，直至再次按下（无需按住）。
双击锁定	doubleTapToLock	true	允许双击按住-缩放键来锁定摄像机缩放。
受伤时自动退缩放	zoomOutOnDamage	true	受到伤害时自动退出缩放模式，防止战斗时方向错乱。
滚轮音频反馈	scrollAudioFeedback	true	更改缩放等级时播放微妙的机械咔嗒声。
望远镜自动缩放	spyglassAutoZoom	true	使用原版望远镜时自动集成模组的缓动过渡。
望远镜缩放倍率	spyglassZoomMultiplier	10.0	应用于原版望远镜的缩放倍率。
显示原版望远镜覆盖层	showVanillaSpyglassOverlay	false	保留或隐藏默认的黑色方形望远镜晕影边框。

📈 缓动与过渡

游戏内设置名称	JSON 字段键	默认值	描述
缩放速度	zoomSpeed	0.1 (10%)	过渡速率（插值因子）。0.05 为电影感效果；1.0 为瞬间切换。
过渡类型	transitionType	SMOOTHSTEP	用于插值视野过渡的数学缓动函数。
动态移动阻尼	movementFovDamping	0.8 (80%)	抑制因游戏内移动（冲刺、飞行）引起的视野突然偏移，以稳定视角。

🖱 鼠标与灵敏度

游戏内设置名称	JSON 字段键	默认值	描述
电影感缩放平滑度	cinematicSmoothness	0.0 (关闭)	平滑鼠标视角输入（摄像机惯性）。增加至 0.95 (95%) 可实现电影感平移。
降低灵敏度	reduceSensitivity	true	随着缩放倍率增加而成比例降低鼠标灵敏度，以实现像素级精确瞄准。
影响手持物品 FOV	affectHandFov	true	在缩放动画期间缩放第一人称手持物品渲染的视野。

🎨 视觉效果与覆盖层

游戏内设置名称	JSON 字段键	默认值	描述
显示缩放 HUD 覆盖层	showZoomHud	true	在屏幕底部中央渲染一个简洁的毛玻璃风格信息栏。
缩放 HUD 背景	zoomHudBackground	true	在 HUD 后方显示一个半透明深色底板，带有细微边框。
显示遥测 HUD	showTelemetryHud	true	在准星下方显示目标名称（方块/实体）和实时距离读数。
高亮瞄准实体	highlightTargetEntity	true	以客户端发光轮廓高亮准星下的实体。
缩放晕影不透明度	zoomVignetteOpacity	0.4 (40%)	在屏幕边缘添加电影感的暗色晕影。设为 0% 可禁用。
缩放时减少雾效	reduceFog	true	在激活缩放时动态推远环境雾效，以最大化视线距离。
缩放时隐藏准星	hideCrosshair	false	在激活缩放时隐藏准星光标。
望远镜瞄准镜模拟	spyglassScopeOverlay	false	在缩放时在屏幕上渲染一个圆形望远镜瞄准镜覆盖遮罩。

---

📈 缓动曲线类型

在 缓动与过渡 设置中可从多种过渡样式中选择：

• INSTANT：跳过过渡（瞬间切换）。
• LINEAR：恒定、稳定的动画速度。
• SINE / QUAD / CUBIC：缓动过渡（缓入、缓出或缓入缓出），实现柔和开始/结束。
• SMOOTHSTEP：经典的图形插值曲线，开始慢、加速、结束慢。
• CIRCULAR：使用基于圆形的根曲线进行激进缓动。
• BACK：在到达目标缩放前轻微过冲再拉回，产生类似弹簧的感觉。
• ELASTIC：波浪状、物理弹簧般的振荡过渡。
• BOUNCE：在到达目标缩放时轻微弹跳。

---

👨‍💻 面向开发者（从源码构建）

Zoomrgy 使用 Gradle 构建。如果你想自行构建或编译此模组：

1. 克隆或下载仓库。
2. 在根目录中打开终端。
3. 运行 Gradle 构建脚本：

# Windows PowerShell
.\gradlew.bat build

# Linux / macOS
./gradlew build

1. 编译好的 .jar 成品将位于：

build/libs/zoomrgy-[版本号].jar

---

📄 许可协议

本模组基于 MIT 许可协议 发布。欢迎 fork、修改或将其包含在自定义整合包中。