路线建议

路线推荐 - 《杀戮尖塔2》MOD

（未检测到可翻译的文本内容，请提供需要翻译的游戏文本。）

《杀戮尖塔2》的模组，可推荐最优路线，并在地图界面以金色/红色高亮显示。

**支持的游戏版本：** v0.99.1 和 v0.102.0（公开测试版）

## 功能特点

- **双路线建议**：显示两条最优路线——一条安全路线，一条激进路线
- **视觉高亮**
  - **黄金之道**：安全路径（风险最小化）
  - **红色**：激进路线（优先通过战斗获取奖励）
- **智能计分**：安全与激进玩法分别赋予不同权重
- **专家评分**：可选相邻加成，奖励特定站位模式（例如，精英前适当休息）
- **GUI 设置**：通过 [ModConfig](https://github.com/xhyrzldf/ModConfig-STS2) 实现完整游戏内配置（可选）
- **手动配置**：供高级用户直接编辑JSON配置文件

## 安装

1. 从 [GitHub releases](https://github.com/jiegec/STS2RouteSuggest/releases) 或 [Nexus mods](https://www.nexusmods.com/slaythespire2/mods/54) 下载最新版本
2. 将模组文件解压至《杀戮尖塔2》的模组文件夹（`mods` 文件夹应与游戏执行文件位于同一目录下）。
   - **Windows**：`C:\Program Files (x86)\Steam\steamapps\common\Slay the Spire 2\mods\`
   **macOS**：`~/Library/Application\ Support/Steam/steamapps/common/Slay\ the\ Spire\ 2/SlayTheSpire2.app/Contents/MacOS/mods/`
   **Linux**：`~/.steam/steam/steamapps/common/Slay the Spire 2/mods`
3. 启动《杀戮尖塔2》——模组将自动加载

## 从源码构建

### 前置条件

.NET 9.0 SDK 或更高版本
Godot 4.5.1 附带 Mono 支持
杀戮尖塔2（用于sts2.dll引用）

### 建造步骤

```bash 确保物品完整无缺，才能顺利交易。 ```
克隆仓库
git clone https://github.com/jiegec/STS2RouteSuggest
RouteSuggest

# 构建模组
./build.sh

# 安装模组
安装中...
请提供需要翻译的文本内容。

## 玩法说明

模组使用了两种不同的评分系统来计算最优路径：

### 安全路径（金）

最小化遭遇战，优先保障安全

| 房间类型 | 分数 | 原因 |
由于您未提供具体文本内容，请将需要翻译的游戏原文粘贴在输入框中。我将根据您的要求自动识别源语言并翻译为符合游戏语境的中文。
| **休憩点** | +1 | 回复生命并升级卡牌
| **宝藏** | +1 | 免费遗物 |
| **商店** | +1 | 购买卡牌、遗物与药水 |
| **怪物** | -1 | 回避战斗 |
| **精英** | -3 | 避开高难度战斗 |
| **Boss** | 0 | 最终决战之地 |

### 激进路线（红色）

优先获取战斗奖励与未知遭遇：

| 房间类型 | 分数 | 原因 |
您好！请提供需要翻译的游戏文本内容，我会根据您的要求进行专业本地化处理。
| **休憩点** | +1 | 恢复生命并升级卡牌 |
| **宝藏** | +1 | 免费圣物 |
| **商店** | +1 | 购买卡牌、遗物与药水 |
| **怪物** | +2 | 金币与卡牌奖励 |
| **精英** | +3 | 遗物与更高品质奖励 |
| **未知** | +2 | 战斗潜能
| **Boss** | 0 | 最终决战之地 |

两条路径共用边时，该边将以金色显示。

### 专家评分（相邻加成）

每条路径均可选择开启**专家模式**，在基础权重之上应用位置加成。专家模式为全局开关，影响所有路径。以下节点序列将获得特定奖励：

| 图案 | 说明 | 默认值 |
|---------|-------------|---------|
| **休憩点 -> 精英战** | 精英战前的直接休整点 | 0 |
| **精英 -> 休息** | 休息点前遭遇精英敌人 | 0 |
| **宝库 → 精英** | 精英战前的宝库房间 | 0 |
| **休整 -> 任意 -> 精英** | 精英怪前两步的休整点（中间相隔一个节点） | 0 |
| **精英 → 任意 → 休息** | 精英战斗发生在休息点前两步 | 0 |

所有加成默认设为0（关闭）。关闭专家模式时，计分方式与原版相同。该开关及加成项可通过ModConfig界面或JSON文件进行配置。

## 配置

### GUI 设置（推荐）

路线建议功能可与[**ModConfig**](https://github.com/xhyrzldf/ModConfig-STS2)进行可选集成。安装ModConfig后，路线建议将出现在游戏**设置 > Mod**菜单中。未安装ModConfig时，模组仍可正常运行，但需手动编辑JSON配置文件（详见下文）。

使用 ModConfig GUI，你可以：

- **通用设置**:
  - **高亮类型**：选择高亮一条最优路径，或高亮所有得分最优的路径
    - **一**: 从最佳路径中选择一条
    - **全部**: 高亮显示所有并列最高分的路径
  - **启用专家计分**：全局开关，开启相邻加成（影响所有路径）
- **配置每个路径**：
  - **启用**: 开关以启用/禁用该路径（禁用的路径将不会计算或显示）
  - **名称**：路径标识符
  **颜色**：输入十六进制色值（如金色 `#FFD700`，红色 `#FF0000`）
  - **渲染优先级**：滑动条设置渲染层级（数值越高，路径重叠时越优先显示）
  - **评分权重**：各房间类型的滑块调节项
    - 正面 = 偏好此房间类型
    - 负面 = 避开该房间类型
    - 零 = 中立
  - **专家计分**：5个位置模式加成滑块（如“休整”→“精英”等）
- **添加新路径**：滑动滑块以新增一条路径（滑至1）
- **移除路径**：每条路径对应一个滑块，用于执行移除操作（0=保留，1=移除）
- **重置为默认**：滑动条可将所有路径恢复至默认配置
**更改会自动保存**至配置文件位置（详见下文）。

### 手动JSON配置

或者，你也可以通过手动编辑 `RouteSuggestConfig.json` 文件来自定义路径类型：

- **现有用户**：若已在 `mods/RouteSuggestConfig.json` 路径下存在配置文件，将继续沿用该文件（无需迁移）
- **新用户**：配置文件将保存在`RouteSuggest.dll`同级目录下（在mods文件夹中递归查找）。若未找到该DLL，则回退使用`mods/RouteSuggestConfig.json`。
- **提示**：配置将保存至原读取位置，模组不会自动将配置文件迁移至其他路径。

```json { "RENEW_ANDROID_ACCOUNT": "续订安卓账户", "account_long_period_notice": "续订后，有效期限将自动延长与更新后的有效期限相同的时间。", "account_preferential_price": "账户特惠价格", "account_price_detail": "含税1,800日元（下回通常价格1,500日元）", "active_modal_title": "激活模式标题", "already_reserved": "已预约", "Android": "安卓", "annual_subscription": "年费订阅", "apply_for_account_deletion_title": "申请删除账户标题", "can_buy_multi": "可多次购买", "cancel_restore_purchases": "取消恢复购买", "Caution": "注意", "change_email": "更换邮箱", "change_password": "修改密码", "channel_notification_setting": "频道通知设置", "coin": "金币", "coin_payment": "金币支付", "complete_restore_data_successfully": "数据恢复成功完成", "confirm": "确认", "consume_coin": "消耗金币", "continue_restore": "继续恢复", "contract_screen": "合约界面", "create_account": "创建账户", "data_link": "数据关联", "data_link_and_restore": "数据关联与恢复", "days_ago": "天前", "delete_account_alert": "删除账户警告", "delete_my_account": "删除我的账户", "do_not_display_again": "不再显示", "etc": "等", "FAQ": "常见问题", "free": "免费", "i_will_register_again": "我将重新注册", "Ios": "iOS", "language": "语言", "later": "稍后", "login_session_timeout": "登录会话超时", "login_without_setting": "未设置登录", "main": "主界面", "menu": "菜单", "monthly_pass": "月卡", "network_connection_error": "网络连接错误", "new_player": "新玩家", "no_charge": "免费", "not_release": "未发布", "notification": "通知", "ok": "确定", "other": "其他", "page_not_fount": "页面未找到", "password": "密码", "password_confirmation": "确认密码", "payment_pending": "支付处理中", "point": "积分", "price": "价格", "privacy_policy": "隐私政策", "purchase": "购买", "receipt_confirmation": "收据确认", "recover_purchase_title": "恢复购买标题", "register": "注册", "remaining_days_": "剩余天数", "restore": "恢复", "restore_data": "恢复数据", "restore_data_detail": "恢复数据详情", "restore_purchase": "恢复购买", "restore_purchase_complete": "恢复购买完成", "restore_purchase_detail": "恢复购买详情", "restore_purchase_title": "恢复购买标题", "restore_purchases": "恢复购买项目", "return_login": "返回登录", "save": "保存", "save_data": "保存数据", "search": "搜索", "setting": "设置", "sign_in": "登录", "sign_out": "退出登录", "sign_up": "注册", "skip": "跳过", "start_restore": "开始恢复", "subscription": "订阅", "subscription_cancel_confirm_dialog": "订阅取消确认对话框", "subscription_cancel_processing": "订阅取消处理中", "subscription_detail": "订阅详情", "subscription_notification": "订阅通知", "subscription_restore": "订阅恢复", "subscription_restore_complete": "订阅恢复完成", "subscription_restore_detail": "订阅恢复详情", "subscription_restore_title": "订阅恢复标题", "subscription_status": "订阅状态", "support": "支持", "system": "系统", "terms": "条款", "terms_of_service": "服务条款", "trial": "试用", "trial_period": "试用期", "trouble_shooting": "故障排除", "unsubscribe": "取消订阅", "update": "更新", "version": "版本", "video": "视频", "year": "年" } ```
{
  "schema_version": 4
  "highlight_type": "单一"
  "专家模式"：否
  "path_configs": [ "路径配置" ]
    {
      "name": "保险箱"
      "color": "#FFD700"
      优先级：100
      "enabled": true,
      "rest_before_elite_bonus": 0,
      "elite_before_rest_bonus": 0,
      "treasure_before_elite_bonus": 0,
      "rest_two_before_elite_bonus": 0,
      "elite_two_before_rest_bonus": 0,
      "scoring_weights": { "分值权重"：{
        "休憩点"：1
        "宝藏": 1
        "商店"：1
        “怪物”：-1
        "精英"：-2
      }
    }
    {
      "name": "激进"
      "color": "#FF0000"
      优先度：50
      "enabled": true,
      "休息后精英怪额外奖励": 0
      "精英休息前奖励": 0
      "treasure_before_elite_bonus": 0
      "rest_two_before_elite_bonus": 0,
      "elite_two_before_rest_bonus": 0
      "scoring_weights": { “评分权重”：{
        "休息点"：1
        "宝藏"：1
        "商店"
        "怪物"：1
        “精英”：2
        "未知"：1
      }
    }
  ]
}
请提供需要翻译的文本内容。

- **schema_version**: 配置文件格式版本（当前版本为4）
- **highlight_type**: "单一"（仅高亮最优路线）或 "全部"（高亮所有达到最优评分的路线）
**expert_mode**：设为 `true` 以启用相邻加成（影响所有路径配置）
- **名称**：路径标识（如“安全”、“激进”）
- **启用**：设为 `false` 可禁用路径（禁用后该路径将不计入计算且不显示）
- **颜色**：十六进制颜色代码（例如：金色 `#FFD700`，红色 `#FF0000`）
- **优先级**：值越高，路径重叠时渲染越靠前
- **评分权重**：每种房间类型的整数值（正数表示偏好，负数表示回避）
- **rest_before_elite_bonus**: 休息后紧接精英战斗的加成
- **elite_before_rest_bonus**: 精英后直接休息加成
- **treasure_before_elite_bonus**: 宝箱后接精英怪时的加成
- **rest_two_before_elite_bonus**：休息节点后隔一格遇精英时的额外奖励
- **elite_two_before_rest_bonus**: 精英后隔一格休息的额外奖励

可用房间类型：休息处、宝箱房、商店、普通怪物、精英怪物、未知、首领

配置文件缺失或无效时，将使用默认路径配置。

社区配置

用户已在Nexus Mods帖子页分享了他们的自定义配置，不妨前去看看，既能获取灵感，也能找到契合你游玩风格的配置。

## 更新日志

### v1.9.0

已在游戏公测版 v0.99.1 和 v0.102.0 上测试过
- 新增专家评分模式，包含相邻加成（模式版本4）
  - 全局开关：启用专家评分（影响所有路径）
  - 5个相邻加成滑块：休息→精英、精英→休息、宝藏→精英、休息→任意→精英、精英→任意→休息
  - 关闭专家模式时，滑块将被隐藏
  可在ModConfig界面和JSON配置中使用
  - 所有加成默认归零，专家模式关闭时不生效
现在本模组已集成ModConfig v0.2.1新增的按钮/颜色选择控件。若环境支持，将优先使用新控件；旧版ModConfig则自动回退兼容。

### v1.8.0

- 优化Mod设置界面：将滑块改为开关，配置更便捷
- 新增每条路径配置的启用/禁用选项
  禁用路径将不会在地图上计算或显示。
  MOD配置界面与JSON配置文件均可用
已在游戏测试版v0.100.0上测试

### v1.7.0

将 `affects_gameplay` 设置为 false，因为此模组仅为视觉修改，不影响游戏玩法。

### v1.6.0

- 优化了配置文件的路径识别
  根据用户反馈：当文件夹内模组数量较多时，配置文件放在根目录下会显得杂乱。
  - 若 `mods/RouteSuggestConfig.json` 已存在，则继续使用（无需迁移）
  否则，请递归查找`RouteSuggest.dll`，并将配置文件保存在其同级目录下。
  若未找到DLL文件，则回退至 `mods/RouteSuggestConfig.json`
  - 配置文件将保存至读取时的同一位置（不会自动迁移）

### v1.5.0

- 新增高亮类型选项，可控制高亮路径的数量
  - **一**：从最佳路径中选择一条
  - **全部**：高亮显示所有最优评分路径
  - 可在 ModConfig 界面与 JSON 配置中使用

v1.4.0

- 新增GUI设置与ModConfig集成，支持游戏内路径配置
  通过图形界面配置名称、颜色（十六进制输入）、优先级及评分权重
  - 新增/移除自定义路径类型
  - 更改已自动保存至JSON
  暂时用滑块代替按钮。
  - 支持英文与简体中文的国际化
在游戏Beta v0.99.1版本中测试通过

### v1.3.0

- 调整了安全/激进路线的默认权重
- 新增可配置路径功能，路径文件位于 `mods/RouteSuggestConfig.json`
路径配置可自定义颜色、优先级及评分权重。
如果配置文件缺失或无效，则回退为默认设置。

### v1.2.0

- 修复了进入新章节时路径高亮显示的问题

### v1.1.0

- 新增双路径模式：安全路径（金色）与激进路径（红色）
安全路径可减少战斗遭遇
- 激进路线优先选择精英房（+2）、怪物房（+1）和未知房（+1）
- 重叠边缘以金色高亮显示

v1.0.0

- 首次发布
- 支持游戏版本 v0.98.3 与 v0.99