Brodie’s Camera Zoom

BRODIE’S ZOOM
完整项目规格说明

1. 项目概述

Brodie’s Zoom 是一款 Minecraft Fabric 客户端模组，提供可自定义的镜头缩放功能。

本模组旨在提供流畅、自然的缩放体验，同时保留 Minecraft 经典的视觉风格。

名称：Brodie’s Zoom
模组 ID：brodieszoom
当前版本：1.0.0
Minecraft 版本：26.3（发布前应验证兼容性）
模组加载器：Fabric
模组类型：客户端实用工具
默认缩放按键：C
默认缩放模式：Smooth Cinematic

1. 主要功能

Brodie’s Zoom 目前包含以下功能：

• Smooth Cinematic 平滑电影式缩放。

• Instant Snap 即时缩放。

• 滚轮缩放调节。

• 可自定义缩放按键。

• 可自定义缩放模式按键。

• 自定义设置界面。

• 错误报告界面。

本模组旨在像 Minecraft 的自然延伸，而不是一套完全独立的界面。

1. 缩放模式

SMOOTH CINEMATIC

默认：启用

Smooth Cinematic 会逐渐放大和缩小，而不是瞬间改变镜头。

功能：

• 按住缩放键时逐渐放大。

• 松开按键时逐渐缩小。

• 过渡时长为 300 毫秒。

• 使用 Ease In/Out Sine 缓动动画。

• 支持滚轮调节缩放。

该动画旨在提供流畅、可控的过渡效果，类似 Zoomify。

INSTANT SNAP

Instant Snap 可立即缩放，不会产生渐进式镜头过渡。

功能：

• 按住缩放键时立即放大。

• 松开按键时立即恢复正常视野范围（FOV）。

• 没有渐进式缩放动画。

• 仍可使用滚轮调节缩放。

默认：禁用。

1. 滚轮缩放

按住缩放键时，可通过滚轮调整缩放级别。

功能：

• 滚动滚轮即可调整缩放级别。

• 缩放时滚动滚轮不会切换快捷栏选中的物品栏位。

• 启用 Smooth Cinematic 时，缩放会平滑调整。

• 启用 Instant Snap 时，缩放会立即调整。

默认值：

默认缩放倍率：0.25
最小缩放倍率：0.05
最大缩放倍率：0.25
每格滚轮的调整幅度：0.025
滚轮动画时长：180 毫秒

缩放倍率越小，放大效果越强。

滚轮动画使用 Smoothstep 过渡，与主 Smooth Cinematic 动画相互独立。

1. 默认按键绑定

缩放：
默认按键：C
说明：按住即可放大。

切换缩放模式：
默认按键：未绑定
说明：在 Smooth Cinematic 和 Instant Snap 之间切换。

打开设置：
默认按键：未绑定
说明：打开 Brodie’s Zoom 设置。

以上三个按键绑定均可通过 Minecraft 的按键绑定系统自定义。

重新绑定界面支持：

• 键盘按键。

• 鼠标按键。

• 按 Escape 取消重新绑定。

默认的 C 键是主要缩放控制键。

1. 默认设置

缩放模式：Smooth Cinematic
平滑缩放：启用
Instant Snap：禁用
缩放倍率：0.25
最小缩放倍率：0.05
最大缩放倍率：0.25
主缩放过渡时长：300 毫秒
滚轮过渡时长：180 毫秒
滚轮调整幅度：0.025
缩放键：C
切换缩放模式键：未绑定
打开设置键：未绑定

1. 设置持久化

按键绑定通过 Minecraft 的常规选项系统保存。

以下设置是否能够持久保存，目前尚未确认：

• Smooth Cinematic / Instant Snap 模式偏好。

• 滚轮缩放级别。

在经过测试确认之前，不应宣称这些设置会在不同游戏会话之间持久保存。

1. 设置界面

主设置界面包含：

1. Brodie’s Zoom 标题。

2. ZOOM SETTINGS 副标题。

3. 按键绑定标题。

4. 缩放键重新绑定按钮。

5. 缩放模式键重新绑定按钮。

6. 缩放行为标题。

7. 缩放类型选择按钮。

8. 当前所选缩放模式的说明。

9. 错误报告按钮。

10. 完成按钮。

界面沿用 Minecraft 的经典视觉风格，采用熟悉的按钮、文字和分隔线。

当前布局包括：

• 错误报告按钮位于 centerY + 75。

• 完成按钮位于 centerY + 103。

调整这些位置是为了避免界面元素相互重叠。

1. 错误报告

Brodie’s Zoom 内置专用的错误报告界面。

目前提供以下功能：

• 用于描述问题的文本框。

• 提交报告按钮。

• 返回按钮。

• 提交后显示确认消息。

当前限制：报告不会实际发送到在线服务，也不会保存到远程错误追踪系统。目前提交后只会显示本地确认消息。

未来更新可能会考虑加入在线报告系统。

1. 视觉设计与品牌形象

Brodie’s Zoom 以 Minecraft 的经典视觉风格作为主要设计方向。

品牌形象希望借鉴 Minecraft 现代标题界面的字体设计。

Logo 设计方向：

• 粗壮醒目的 Minecraft 风格字形。

• 白色或石灰色文字。

• 深色描边和细微的 3D 立体效果。

• 绿色点缀。

• 设计简洁、易于识别。

• 缩小后仍清晰易读。

建议的文字布局：

BRODIE’S
ZOOM

Logo 应体现出正宗 Minecraft 实用工具模组的风格，而不是电竞战队的 Logo。

最终版 Logo 仍在制作中。

1. 兼容性与分发

游戏：Minecraft Java Edition
模组加载器：Fabric
模组分类：实用工具
运行端：客户端
当前版本：1.0.0
计划发布平台：CurseForge

待分发的模组文件名为：

brodies-zoom-1.0.0.jar

在宣传兼容性之前，必须验证其对更多 Minecraft 版本及加载器版本的兼容情况。

1. 发布信息

计划中的 CurseForge 项目信息如下：

项目名称：Brodie’s Zoom

简介：

一款可自定义的 Minecraft 缩放模组，支持平滑过渡、Instant Snap 模式、滚轮缩放调节和自定义按键绑定。

分类：模组
游戏：Minecraft
加载器：Fabric
模组类型：客户端实用工具
当前版本：1.0.0
项目 Logo：仍在最终制作中。

尚未确认是否发布。

1. 计划改进

未来可能加入以下改进：

• 持久保存缩放模式偏好。

• 持久保存滚轮缩放级别。

• 集成在线错误报告。

• 增加更多自定义选项。

• 进一步打磨界面。

• 进行更多兼容性测试。

• 支持更多 Minecraft 版本。

以上均为潜在改进，并非已确认实现的功能。

1. 当前项目状态

目前已实现：

• Smooth Cinematic 缩放。

• Instant Snap 缩放。

• 滚轮缩放。

• 可自定义按键绑定。

• 主设置界面。

• 错误报告界面。

• 已成功构建 1.0.0 版本。

仍在开发中：

• 最终版 Logo 与品牌形象。

• 设置持久化。

• 错误报告功能。

• 兼容性验证。

• 发布到 CurseForge。

1. 项目身份

名称：Brodie’s Zoom
模组 ID：brodieszoom
版本：1.0.0
平台：Minecraft Java Edition
加载器：Fabric
用途：提供可自定义的镜头缩放，支持平滑过渡和滚轮调节。

设计理念：保持体验简洁、可自定义，并与 Minecraft 的经典界面风格一致。

总体目标：打造一款精致、可靠且融入游戏体验的 Minecraft 缩放模组。