ControllerZoom

控制器缩放

将缩放控制带到手柄玩家触手可及的范围内。

---

向上或向下推动右摇杆即可随时缩放。 当你需要使用原版右摇杆鼠标光标时，按住光标修饰键（默认为左摇杆按下）。

• 使用右摇杆缩放 — 不再需要每次想查看地图更多（或更少）细节时都打开选项菜单。
• 为大地图而生 — 尤其适用于星露谷物语：扩展版，其地图远大于原版。
• 让鼠标不再碍事 — 在安装此模组之前，即使轻轻碰触右摇杆也会在游戏中唤醒鼠标光标并导致输入不同步。现在，只有当你故意按住 L3 + 右摇杆 时，鼠标才会出现。

---

工作原理

操作	按键
放大	向上推动右摇杆
缩小	向下推动右摇杆
右摇杆作为鼠标光标（原版）	按住 L3（左摇杆按下）+ 移动右摇杆
重置缩放至 100%	默认未绑定（在配置中绑定 ResetZoom）

默认情况下，右摇杆始终执行缩放，按住光标修饰键可切换至原版光标模式。如果你更倾向于按住修饰键来缩放，并让裸右摇杆作为鼠标光标，请在配置中启用 SwapModifierRole。

缩放经过精细调校：轻推摇杆时调整缓慢，持续推动则速度逐渐提升，响应曲线提供了精确的低端控制，并且在缩放时，光标下方的世界坐标点会保持锚定不动。

---

前置条件

• 星露谷物语 1.6.15+
• SMAPI 4.0+
• 一个启用了游戏手柄控制的手柄

安装方法

1. 如果你还没有安装 SMAPI，请先进行安装。
2. 将此模组解压到你的 Mods 文件夹中，使其位于 Stardew Valley/Mods/ControllerZoom 目录下。
3. 通过 SMAPI 启动游戏（首次运行时会生成 config.json 文件）。
4. 确保 选项 → 游戏手柄控制 已启用。

---

配置

所有设置均位于模组文件夹中的 config.json 文件内：

设置项	默认值	描述
Enabled	true	总开关。
CursorModifier	LeftStick	按住以使用右摇杆作为鼠标光标的按键。
SuppressModifierVanillaAction	true	阻止修饰键的原版功能。
SwapModifierRole	false	反转功能：按住修饰键缩放，裸摇杆移动光标。
MinZoom	0.5	最低缩放级别。
MaxZoom	2.0	最高缩放级别。
ZoomSpeed	0.7	持续按住摇杆时的基础缩放速度。
ResponseCurve	1.5	摇杆偏转指数（数值越高，精细控制越平缓）。
AccelerationFactor	2.5	按住时最大缩放速度倍率。
AccelerationTimeMs	600	加速到全速所需时间。
Deadzone	0.25	触发缩放所需的摇杆偏转量。
InvertZoomDirection	false	交换上/下缩放方向。
ApplyIntervalMs	40	应用缩放的频率。
ZoomIncrement	0.01	将缩放级别取整为均匀步长。
AnchorCursorWhileZooming	true	缩放时保持视图围绕光标旋转。
ZoomSound	drumkit6	缩放时的音效提示（设为 "" 以禁用）。
SoundEveryPercent	10	每次缩放经过该百分比的倍数时播放声音。
PersistZoom	true	记住会话之间的缩放级别。
ResetZoom	未绑定	用于立即将缩放重置为 100% 的按键。

---

兼容性

• 星露谷物语 1.6.15+ / SMAPI 4.0+。
• 支持单人游戏和分屏多人游戏（每个屏幕独立缩放）。
• 无存档修改 — 可随时安全安装和卸载。

鸣谢

使用 SMAPI 和 Harmony 构建。基于 MIT 许可证发布。