# 那是什么眼神模组（SC）

**Repository Path**: RegulusSource/SC-nNsNm

## Basic Information

- **Project Name**: 那是什么眼神模组（SC）
- **Description**: 一个《生存战争》联机插件版模组：当玩家被其他玩家注视（瞄准）超过一定时间后，获得移动速度加成。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-28
- **Last Updated**: 2026-07-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 那是什么眼神 (nNsNm)

一个《生存战争》联机版模组：当玩家被其他玩家注视（瞄准）超过一定时间后，获得移动速度加成。

---

## 功能

- 当其他玩家注视你累计达到 `GazeThresholdSeconds` 秒（默认 2 秒）后，你的移动速度开始提升。
- 每个注视者提供 `PerWatcherBonus` 的额外速度（默认 0.2），最多叠加 `MaxWatchers` 人（默认 5）。
- 速度加成上限为 `MaxSpeedMultiplier`（默认 2.0）。
- 不再被任何人注视累计 `RecoverySeconds` 秒（默认 3 秒）后，速度恢复正常。
- 首次获得速度加成时，会播放钢琴音效 `3-2-1-2-3`。
- 速度加成通过游戏原生的 **速度因子系统** 注入，会在角色属性面板显示为"注视加成"。

---

## 运行端

双端模组（`Side = Both`）：

- **服务端**：负责注视检测、倍率计算、网络同步，并读取配置文件。
- **客户端**：接收服务端下发的倍率，注入到角色属性面板和实际移动速度中。

客户端不读取配置文件，所有参数由服务端决定。

---

## 配置文件

仅服务端生效。配置存储在游戏自身的 `ModSettings.xml` 中，首次启用模组并退出游戏后会自动生成如下节点：

```xml
<ModSettings>
  <Mod PackageName="ll.nNsNm.THPRC">
    <WhatLook>
      <GazeThresholdSeconds>2</GazeThresholdSeconds>
      <RecoverySeconds>3</RecoverySeconds>
      <PerWatcherBonus>0.2</PerWatcherBonus>
      <MaxSpeedMultiplier>2</MaxSpeedMultiplier>
      <MaxWatchers>5</MaxWatchers>
      <MaxDetectionDistance>50</MaxDetectionDistance>
      <CheckIntervalSeconds>0.2</CheckIntervalSeconds>
      <BodyInflateAmount>0.5</BodyInflateAmount>
      <PlaySoundEveryTime>true</PlaySoundEveryTime>
      <IncludeAnimals>false</IncludeAnimals>
    </WhatLook>
  </Mod>
</ModSettings>
```

| 参数 | 说明 |
|------|------|
| `GazeThresholdSeconds` | 被注视多久后激活速度加成 |
| `RecoverySeconds` | 不被注视多久后恢复 |
| `PerWatcherBonus` | 每个注视者提供的速度增量 |
| `MaxSpeedMultiplier` | 速度倍率上限 |
| `MaxWatchers` | 参与叠加的最大注视人数 |
| `MaxDetectionDistance` | 最大检测距离（方块） |
| `CheckIntervalSeconds` | 检测间隔 |
| `BodyInflateAmount` | 目标身体碰撞箱膨胀量，降低误判 |
| `PlaySoundEveryTime` | 每次倍率变化且大于 1 时都播放钢琴音效（`false` 则只在首次激活时播放） |
| `IncludeAnimals` | 动物注视玩家也算入注视者计数 |

---

## 安装

1. 将 `SurvivalcraftWhatLookMod.scmod` 放入游戏的 `Mods` 文件夹。
2. 主机和加入的玩家都需要安装本模组。
3. 游戏内模组管理器中启用本模组。
4. 重启游戏后生效。

---

## 作弊隐患说明

由于《生存战争》的联机模型是**客户端移动权威**（客户端自行计算位置并上报服务端），恶意客户端总能通过修改本地移动速度来作弊。本模组没有引入比游戏本身更大的攻击面：

- 客户端可以忽略服务端下发的倍率，自行设定任意倍率。
- 客户端可以修改本地配置文件（但客户端本就不读取配置）。
- 上述作弊仅影响**该玩家自己**的移动速度，不影响其他玩家。

若需严格反作弊，需要在服务端验证客户端上报的位置合理性，这属于游戏引擎层面的改动，不在本模组范围内。

---

## 技术信息

- 包名：`ll.nNsNm.THPRC`
- 网络包 ID：`120`
- 依赖：[SurvivalcraftAPI](https://github.com/your-org/SurvivalcraftAPI)（本地 ProjectReference，等待 NuGet 包更新）
- 使用 Harmony 补丁：`ComponentLevel.GenerateSpeedFactors`（速度因子注入）、`SubsystemPlayers.Update`（服务端检测驱动）