梯子轮廓

LadderOutline 是一个受 Ladder Light 和 Ladder Locator 启发的便利性模组。除了在梯子和竖井周围绘制高可见度轮廓外，它还提供智能方向指示器（箭头），直接指向你所在楼层上所有已揭示的梯子和竖井——即使它们远在屏幕之外！

再也不会在黑暗中盲目徘徊，或是在炸弹爆炸后忘记梯子或洞出现的位置了！

---

🌟 功能特性

• 🎯 方向指示器（箭头）：
  • 智能箭头指示器，指向活跃的梯子和竖井。
  • 屏幕边缘模式： 当目标在屏幕外时，指示器固定在屏幕边缘，并附带距离显示（例如 15m）。
  • 屏幕标记： 当梯子/洞进入你的视野时，上方会出现浮动、弹跳的箭头。
  • 玩家环绕模式： 可选箭头环绕你的农夫，指向每个出口。
  • 多目标支持： 如果出现多个梯子或洞，可同时显示多个指示器。
• 🕳️ 完整支持竖井（洞）： 对梯子（绿色）和竖井（青色）进行独立检测，并可自定义不同颜色。
• 🎨 可自定义轮廓： 以可自定义的颜色、不透明度和粗细高亮梯子和竖井格子。
• 🌐 完整翻译支持（i18n）： 开箱即包含英语（default.json）和越南语（vi.json）。欢迎社区翻译！
• ⚙️ 游戏内配置： 完全集成 Generic Mod Config Menu (GMCM)。

---

🛠️ 安装指南

1. 确保已安装 Stardew Valley 1.6+。
2. 安装最新版本的 SMAPI（3.18.6+ / 4.0+）。
3. 下载此模组，将 LadderOutline 文件夹解压到你的 Stardew Valley\Mods 文件夹中。
4. （可选但推荐） 安装 Generic Mod Config Menu 以便在游戏内轻松设置。

---

⚙️ 配置（config.json）

你可以通过 GMCM 在游戏内配置所有内容，或编辑 config.json：

{
  "EnableMod": true,
  "ToggleKey": "None",
  "DebugMode": false,

  "EnableOutline": true,
  "OutlineColor": "Green",
  "ShaftOutlineColor": "Cyan",
  "OutlineOpacity": 0.6,
  "OutlineThickness": 3,

  "EnablePointer": true,
  "PointerStyle": "ScreenEdge",
  "ShowOffscreenOnly": true,
  "ShowOnscreenMarker": true,
  "ShowDistance": true,
  "ShowTargetType": true,
  "LadderPointerColor": "Green",
  "ShaftPointerColor": "Cyan",
  "PointerScale": 4.0,
  "PulseAnimation": true
}

• EnableMod： 模组总开关，用于开启或关闭模组。
• ToggleKey： 游戏过程中切换模组的热键（例如 "F6" 或 "None"）。
• PointerStyle： "ScreenEdge"（屏幕边缘）、"PlayerOrbit"（环绕农夫）或 "Both"（两者）。
• ShowOffscreenOnly： 若为 true，屏幕边缘箭头仅在梯子/竖井位于屏幕外时出现。
• ShowOnscreenMarker： 当梯子/洞可见时，在其上方显示浮动弹跳箭头。
• ShowDistance： 在箭头旁显示以米/格为单位的距离。
• ShowTargetType： 在箭头旁显示 "Ladder"（梯子）或 "Hole"（洞）标签。
• LadderPointerColor / ShaftPointerColor： 可用颜色：Green、Cyan、Yellow、Red、Blue、Purple、Orange、White、Pink。
• PulseAnimation： 箭头的平滑浮动/呼吸效果。

---

🔗 查看我的其他作品

• ✨ ogahalo00 在 Nexus Mods 上的更多模组
• 💻 GitHub 上的源代码

欢迎反馈和建议！感谢你的支持！