一个为《星露谷物语》设计的轻量级 SMAPI 模组,在玩家处于矿井或骷髅洞穴时,从玩家位置绘制彩色线条指向所有已生成的楼梯和洞穴入口,方便快速定位。
- 自动扫描:每 30 帧(约 0.5 秒)检测当前地图
Buildings图层中的楼梯(瓦片索引 173)和洞(瓦片索引 174)。 - 可视化指引:在 HUD 上绘制彩色线条,从玩家脚下直达每个目标。
- 高度可配置:支持通过 Generic Mod Config Menu (GMCM) 调整线条颜色、透明度、粗细以及是否仅在矿井生效。
- 多语言支持:内置 i18n 翻译文件,目前支持中文和英文(可扩展其他语言)。
- 极低性能消耗:仅在洞穴场景工作,扫描频率低,绘图采用 GPU 加速,对帧率影响可忽略不计。
- SMAPI 4.0.0 或更高版本
- Stardew Valley 1.6+
- (可选)Generic Mod Config Menu —— 便于在游戏内修改配置
- 将下载的
LadderGuide文件夹放入游戏的Mods文件夹中。 - 启动游戏,SMAPI 会自动加载模组。
如果你是通过源码编译的,请将整个文件夹(含
manifest.json、i18n和LadderGuide.dll)放入Mods。
- 进入矿井或骷髅洞穴后,线条会自动出现。
- 线条从玩家脚底延伸到每个楼梯或洞的中心位置。
- 默认:楼梯线为橙色,洞线为红色,粗细 2px,不透明度 100%。
- 若安装了 GMCM,可在主菜单或游戏内按
ESC→ “模组配置” → “Ladder Guide” 调整各项参数。
| 选项 | 说明 | 可选值 |
|---|---|---|
| 楼梯线条颜色 | 指向楼梯的线条颜色 | 红/橙/黄/绿/蓝/紫/白/青 |
| 洞线条颜色 | 指向洞的线条颜色 | 同上 |
| 线条透明度 | 线条不透明度(0~1) | 滑块,步进 0.05 |
| 线条粗细 | 线条像素宽度 | 滑块,0.5~10,步进 0.5 |
| 仅在洞穴生效 | 勾选后,仅矿井/骷髅洞穴中绘制;取消则所有地图都尝试绘制 | 开关 |
未安装 GMCM 时,模组使用默认配置,可通过手动编辑
config.json文件(生成在 Mod 文件夹内)进行调整。
模组内置 i18n 文件夹,目前包含:
default.json—— 英语(后备语言)zh.json—— 简体中文
如需添加其他语言,请在 i18n 文件夹中新建 {语言代码}.json(如 ja.json 为日语),并参照已有文件翻译所有键值。