NPC感知

创作者: xYZeroYx

已更新:2026-08-03 15:09:42

492KB

下载

前置 MOD

使用 NPC感知时将自动安装

动态表单生成器 - DFG

1.7MB

关于此 MOD

NPC感官作为NPC周围环境的监听器和调度器。它为NPC提供区域触发器（视觉和区域），并发送这些区域内发生的事件 :)

首先，我要感谢你们耶稣因为这简直是太疯狂了🫠，
也想要感谢所有的 QTR 团队 它们是蒂亚戈, Raven和量子是谁帮了我大量 ,
而所有其他的人 模组制作者 和朋友这一路上我遇见的人们！
但尤其是 le.butte （顺便说一句，那一枪是从海角射出的）而且 许多内容 NickaNak 为了NIF部件！
你可以投票为下一个模组/更新以及测试版做准备这里

NPC 感知
本模组本身不会做任何事情 🫠

如果你是模组作者，并希望你的NPC能在玩家或其他NPC靠近时做出动态反应，
当法术或投射物进入其视野或靠近他们时，这就是你寻找的东西🫠

上帝保佑 ❤️

调度员（监听事件）

插件使用标准的SKSE ModCallbackEvent系统发送事件。

活动结构

每当事件触发时，数据会按以下方式打包到ModEvent参数中：

剧透：

显示

eventName（字符串）： 事件的类型。

strArg（字符串）： 触发传感器的对象的FormID（施法者——例如玩家、箭矢或法术），格式化为十六进制字符串（例如"00000014"）。

numArg (浮点数): 触发器的深度等级（1、2或3）。用于区分近距离与远距离。

发件人 (TESForm):* 行为者谁拥有触发者（“看见”或“感知”到该对象的NPC）。

可用活动名称

剧透警告：

显示

NPC感官_视觉进入: 当物体进入视野半径且NPC拥有视线时触发。
NPC感知_视觉退出: ：当对象离开视野范围或失去视线（躲到墙后）时触发。
NPC感知_进入区域: 当物体进入光环范围时触发（忽略视线阻挡）。
NPC感知_区域出口: 当物体离开光环半径时触发。

如何在Papyrus中聆听

要在你的Papyrus脚本中监听这些事件，

只需使用SKSE的RegisterForModEvent函数注册该ModEvent即可。🫠

剧透：

显示

Scriptname MyCustomMod_SensesListener extends Quest

事件 OnInit()
; 注册你需要的活动事件
RegisterForModEvent("NPCSenses_VisionEnter", "OnNPCVisionEnter")
RegisterForModEvent("NPCSenses_AreaEnter", "OnNPCAreaEnter")
结束事件

事件 OnNPCVisionEnter（字符串 asEventName，字符串 asCasterHexID，浮点数 afDepthLevel，表单 akSender）
; 1. 谁拥有远见？（NPC正在注视）
Actor ObserverNPC = akSender as Actor

; 2. 他们看到了什么？(我们将十六进制字符串转换回表单)
; 注意：在Papyrus中将十六进制字符串转换为表单需要实用模组，如PapyrusUtil或po3_PapyrusExtender
; 使用 po3_PapyrusExtender 的示例：
Form SeenObject = PO3_SKSEFunctions.GetFormFromEditorID(asCasterHexID) ; *见下方注释

; 示例反应
如果观察NPC且已看见目标
Debug.Notification(ObserverNPC.GetDisplayName() + "刚刚在深度" + afDepthLevel + "处看到了什么")
endif
结束事件

事件 OnNPCAreaEnter(String asEventName, String asCasterHexID, Float afDepthLevel, Form akSender)
Actor SensorNPC = akSender as Actor
Debug.Notification("有东西进入了" + SensorNPC.GetDisplayName() + "的光环范围内")
结束事件

(注：由于SKSE ModEvents仅支持单个) 表单
按照本地参数传递时，CasterID以十六进制字符串形式传入。
在Papyrus中，你需要一个能够将十六进制字符串转换为FormID的库。
或者你也可以直接通过检测玩家来追踪。 asCasterHexID == "00000014")

如何在C++中监听（SKSE插件）
如果你正在构建SKSE插件，只需为SKSE::ModCallbackEvent创建一个BSTEventSink即可。🫠

剧透：

显示

#pragma once
#include <string>
class MySensesListener : public RE::BSTEventSink<SKSE::ModCallbackEvent> {
public:
static MySensesListener* GetSingleton() {
static MySensesListener singleton;
返回&singleton；
}
RE::BSEventNotifyControl ProcessEvent(const SKSE::ModCallbackEvent* a_event, RE::BSTEventSource<SKSE::ModCallbackEvent>*) override {
if (!a_event) return RE::BSEventNotifyControl::kContinue;
std::string_view eventName(a_event->eventName.c_str());
// 检查是否为Vision进入事件
if (eventName == "NPCSenses_VisionEnter"sv) {

// 1. 获取施法者的 FormID（将十六进制字符串转换为 uint32）
RE::FormID casterID = std::stoul(a_event->strArg.c_str(), nullptr, 16);

// 2. 获取深度等级
int depthLevel = static_cast<int>(a_event->numArg);

// 3. 获取所有者Actor
RE::Actor* ownerActor = a_event->sender ? a_event->sender->As<RE::Actor>() : nullptr;
if (ownerActor) {
// 在此处编写你的自定义逻辑！
// 示例：ownerActor->EvaluatePackage();
}
}
return RE::BSEventNotifyControl::kContinue;
}
};
// 别忘了在插件加载时注册你的水槽：
// auto modEventSource = SKSE::GetModCallbackEventSource();
// if (modEventSource) modEventSource->AddEventSink(MySensesListener::GetSingleton());