火焰扩散（SKSE）

一个SKSE插件，为弓箭和弩的射击添加真实散布效果，并为玩家和NPC提供独立配置。

1. 面向用户
安装

• 请确保您已具备 SKSE64 已安装适配您的游戏版本（支持Skyrim SE/AE 1.5.97及更高版本）。
• 通过Mod Organizer 2安装插件，或手动放置 BowSpread.dll 并且 BowSpread.ini 进入 Data/SKSE/Plugins/.
  

配置（BowSpread.ini）
设置文件分为三个部分：

[一般]
bEnableBows=true  ; 为弓启用散射
bEnableCrossbows=true; 为弩启用散射

[玩家]
bEnable=true
fBaseSpreadDegrees=0.5
fMaxSpreadDegrees=2.0
fSpreadMult=1.0
fSkillMult=0.1 ; 新参数：箭术技能影响

[NPC]
bEnable=true
fBaseSpreadDegrees=0.5
fMaxSpreadDegrees=2.0
fSpreadMult=1.0
fSkillMult=0.1 ; 新参数：弓术技能影响

游戏内测试
你可以在控制台（~)：

• 每发子弹都会记录信息：射击者、抛射物类型及最终散布角度。
  

2. 面向开发人员（Papyrus API）
完整API函数列表（BowSpreadAPI.psc）

玩家设置

GetPlayerBaseSpread() / SetPlayerBaseSpread(float)
获取玩家最大散布() / 设置玩家最大散布(浮点数)
获取玩家散布倍率() / 设置玩家散布倍率(浮点数)
GetPlayerSkillMult() / SetPlayerSkillMult(float)
IsPlayerEnabled() / SetPlayerEnabled(bool)

NPC设置

获取NPC基础散布() / 设置NPC基础散布(浮点)
GetNPCMaxSpread() / SetNPCMaxSpread(浮点数)
获取NPC散布倍率() / 设置NPC散布倍率(浮点型)
获取NPC技能倍率() / 设置NPC技能倍率(浮点数)
IsNPCEnabled() / SetNPCEnabled(bool)

常规设置

IsBowsEnabled() / SetBowsEnabled(bool)
IsCrossbowsEnabled() / SetCrossbowsEnabled(bool)

系统

保存设置(); 将当前值写入 BowSpread.ini
LoadSettings(); 将数值重置为.ini中的值

技能倍率说明
新 技能倍率 参数允许扩散效果随箭术技能等级提升而缩放。
公式：`(100 - 技能) * 技能倍率`。
例如，当`SkillMult=0.1`时，箭术=1的角色会额外获得+10°散布，而箭术=100时，该加成则为0°。

纸莎草纸使用示例

; 如果玩家已使用神射手药水，将其散布范围减半
if (HasPotionEffect)
 BowSpreadAPI.SetPlayerSpreadMult(0.5)
否则
 BowSpreadAPI.SetPlayerSpreadMult(1.0)
endif

; 调整技能影响
BowSpreadAPI.SetPlayerSkillMult(0.1)

; 永久保存设置
BowSpreadAPI.SaveSettings()

3. 技术实现（C++）
建筑学

• 钩子： VTable挂钩的 更新实现 (index 0xAB) 为了 导弹投射物 以及 箭矢投射物. 此方法拦截投射物的初始化过程。
• 数学： 散布的计算方式为 Hooks.h 通过 计算扩散角度. 弹丸的方向向量（射击角度）在应用物理效果之前已被修改。
  

正在构建项目
该项目使用 CMake 和 vcpkg.

git clone <repository>
cmake -B build
cmake --build build --config Release