Skip to content

Latest commit

 

History

2 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 

Repository files navigation

🧭 楼梯探测 (Ladder Guide)

一个为《星露谷物语》设计的轻量级 SMAPI 模组,在玩家处于矿井或骷髅洞穴时,从玩家位置绘制彩色线条指向所有已生成的楼梯和洞穴入口,方便快速定位。


✨ 功能特性

  • 自动扫描:每 30 帧(约 0.5 秒)检测当前地图 Buildings 图层中的楼梯(瓦片索引 173)和洞(瓦片索引 174)。
  • 可视化指引:在 HUD 上绘制彩色线条,从玩家脚下直达每个目标。
  • 高度可配置:支持通过 Generic Mod Config Menu (GMCM) 调整线条颜色、透明度、粗细以及是否仅在矿井生效。
  • 多语言支持:内置 i18n 翻译文件,目前支持中文和英文(可扩展其他语言)。
  • 极低性能消耗:仅在洞穴场景工作,扫描频率低,绘图采用 GPU 加速,对帧率影响可忽略不计。

📦 安装要求


📥 安装步骤

  1. 将下载的 LadderGuide 文件夹放入游戏的 Mods 文件夹中。
  2. 启动游戏,SMAPI 会自动加载模组。

如果你是通过源码编译的,请将整个文件夹(含 manifest.json、i18n 和 LadderGuide.dll)放入 Mods。


🎮 使用方法

  • 进入矿井或骷髅洞穴后,线条会自动出现。
  • 线条从玩家脚底延伸到每个楼梯或洞的中心位置。
  • 默认:楼梯线为橙色,洞线为红色,粗细 2px,不透明度 100%。
  • 若安装了 GMCM,可在主菜单或游戏内按 ESC → “模组配置” → “Ladder Guide” 调整各项参数。

⚙️ 配置选项(GMCM)

选项 说明 可选值
楼梯线条颜色 指向楼梯的线条颜色 红/橙/黄/绿/蓝/紫/白/青
洞线条颜色 指向洞的线条颜色 同上
线条透明度 线条不透明度(0~1) 滑块,步进 0.05
线条粗细 线条像素宽度 滑块,0.5~10,步进 0.5
仅在洞穴生效 勾选后,仅矿井/骷髅洞穴中绘制;取消则所有地图都尝试绘制 开关

未安装 GMCM 时,模组使用默认配置,可通过手动编辑 config.json 文件(生成在 Mod 文件夹内)进行调整。


🌐 多语言支持

模组内置 i18n 文件夹,目前包含:

  • default.json —— 英语(后备语言)
  • zh.json —— 简体中文

如需添加其他语言,请在 i18n 文件夹中新建 {语言代码}.json(如 ja.json 为日语),并参照已有文件翻译所有键值。

About

星露谷mod: 探测洞穴楼梯

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages