---
title: "生命周期 Events"
description: "挂游戏帧、绘制与实体构造析构回调（SA 为主）"
---
---
title: 生命周期 Events
description: 挂游戏帧、绘制与实体构造析构回调（SA 为主）
---
`shared/Events.h` · `plugin::Events`
把逻辑挂在游戏生命周期上。**不要在 `DllMain` 里碰游戏对象。** 文档以 SA 为主；III / VC 的同名事件以 `Events.h` 为准。
## 注册回调
`+=` / `before` / `after` / `-=` 的签名必须与事件一致。在 **静态全局对象的构造函数** 里 `+=`；全局实例必须存在，否则构造不会执行。
```cpp
event += callback;
event.before += callback;
event.after += callback;
event -= callback;
```
```cpp
#include "plugin.h"
class MyPlugin {
public:
MyPlugin() {
plugin::Events::processScriptsEvent += OnProcessScripts;
plugin::Events::drawingEvent += OnDraw;
plugin::Events::pedCtorEvent += OnPedCtor;
}
private:
static void OnProcessScripts() {}
static void OnDraw() {}
static void OnPedCtor(CPed* ped) { (void)ped; }
};
MyPlugin g_my_plugin;
```
## 阶段速查
| 阶段 | 适合 | 避免 |
|---|---|---|
| 静态构造 | `+=`、读自己的 ini | `FindPlayerPed`、刷车 |
| `initRwEvent` | 贴图、Pattern、配置 | 假定已有玩家 |
| `initPoolsEvent` | 按池分配 Extender | 遍历尚不存在的实体 |
| `processScriptsEvent` | 逻辑、Command、按键 | 重 IO |
| `drawing` / `drawHud` | 2D 绘制 | 创建 / 删除实体 |
| `*RenderEvent` | 矩阵、材质 | 删除实体 |
| `*DtorEvent` | 释放附属数据 | 之后继续用指针 |
| `d3dLost` / `Reset` | 释放 / 重建 GPU 资源 | Lost 后继续 Draw |
## 重开游戏
新开一局时清理插件自身状态。
```cpp
plugin::Events::restartGameEvent += [] {
// clear flags / caches
};
```
## RenderWare 初始化与关闭
RW 就绪后加载贴图与资源；关闭前释放。
```cpp
plugin::Events::initRwEvent += [] {
// load sprites / pattern / ini
};
plugin::Events::shutdownRwEvent += [] {
// clear sprites
};
```
## 对象池
池建好后分配 Extender；池销毁时释放。
```cpp
plugin::Events::initPoolsEvent += [] {};
plugin::Events::shutdownPoolsEvent += [] {};
```
## 进游戏与再初始化
进入游戏，以及读档后的再初始化。
```cpp
plugin::Events::initGameEvent += [] {};
plugin::Events::reInitGameEvent += [] {};
```
## 脚本系统就绪
脚本系统起来之后。
```cpp
plugin::Events::initScriptsEvent += [] {};
```
## 每帧逻辑
每帧逻辑的主入口：按键、Command、改实体状态。
```cpp
#include "common.h"
plugin::Events::processScriptsEvent += [] {
CPed* ped = FindPlayerPed();
if (!ped) {
return;
}
ped->m_fHealth = ped->m_fMaxHealth;
};
```
## 主循环钩子
主循环上的另一钩子。改脚本 / 实体状态时优先 `processScriptsEvent`。
```cpp
plugin::Events::gameProcessEvent += [] {};
```
## 2D 绘制
只做绘制，不要在这里创建或删除实体。
```cpp
plugin::Events::drawingEvent += [] {
// gamefont / sprite
};
plugin::Events::drawHudEvent += [] {};
plugin::Events::drawAfterFadeEvent += [] {};
plugin::Events::drawFontsEvent += [] {};
```
## 雷达绘制
```cpp
plugin::Events::drawRadarEvent += [] {};
plugin::Events::drawBlipsEvent += [] {};
// SA: void(bool)
plugin::Events::drawRadarOverlayEvent += [](bool flag) {
(void)flag;
};
```
## 暂停菜单绘制
参数类型以当前游戏头文件为准。
```cpp
plugin::Events::drawMenuBackgroundEvent += [](void*) {};
plugin::Events::menuDrawingEvent += [](CMenuManager* menu) {
(void)menu;
};
```
## 3D 场景与特效
可以改矩阵、材质；不要在这里删除实体。
```cpp
plugin::Events::renderSceneEvent += [] {};
plugin::Events::renderEffectsEvent += [] {};
```
## 镜子渲染（SA）
需要画进镜面内容时使用；不要在这里改游戏逻辑状态。
```cpp
plugin::Events::renderMirrorEvent += [] {
// mirror pass extras
};
```
## 行人构造与析构
构造后初始化附属数据；析构前释放。dtor 之后不要再使用该指针。
```cpp
plugin::Events::pedCtorEvent += [](CPed* ped) {
if (!ped) {
return;
}
};
plugin::Events::pedDtorEvent += [](CPed* ped) {
(void)ped;
};
```
## 载具构造与析构
```cpp
plugin::Events::vehicleCtorEvent += [](CVehicle* veh) {
(void)veh;
};
plugin::Events::vehicleDtorEvent += [](CVehicle* veh) {
(void)veh;
};
```
## 物体构造与析构
```cpp
plugin::Events::objectCtorEvent += [](CObject* obj) {
(void)obj;
};
plugin::Events::objectDtorEvent += [](CObject* obj) {
(void)obj;
};
```
## 实体渲染前
适合改骨骼矩阵；不要删除实体。
```cpp
plugin::Events::pedRenderEvent += [](CPed* ped) {
if (!ped || !ped->m_pRwClump) {
return;
}
};
plugin::Events::vehicleRenderEvent += [](CVehicle*) {};
plugin::Events::objectRenderEvent += [](CObject*) {};
```
## 换模型后
```cpp
// void(CPed*, int) / void(CVehicle*, int)
plugin::Events::pedSetModelEvent += [](CPed* ped, int model) {
(void)ped;
(void)model;
};
plugin::Events::vehicleSetModelEvent += [](CVehicle*, int) {};
```
## D3D 设备丢失与重置
设备丢失时释放 GPU 资源，重置后重建。
```cpp
plugin::Events::d3dLostEvent += [] {};
plugin::Events::d3dResetEvent += [] {};
```
## 全局静音与恢复
签名以头文件为准。
```cpp
plugin::Events::onPauseAllSounds += [](void* p) {
(void)p;
};
plugin::Events::onResumeAllSounds += [](void*) {};
```
## 挂 RenderWare 插件
```cpp
plugin::Events::attachRwPluginsEvent += [] {
return true;
};
```
## 组合示例
```cpp
#include "plugin.h"
#include "common.h"
#include "extensions/KeyCheck.h"
class Plugin {
public:
Plugin() {
plugin::Events::processScriptsEvent += [] {
KeyCheck::Update();
if (!KeyCheck::CheckJustDown(VK_F7)) {
return;
}
CPed* ped = FindPlayerPed();
if (!ped) {
return;
}
ped->m_fHealth = ped->m_fMaxHealth;
};
}
} g_plugin;
```