---
title: "调用 PluginBase / Call"
description: "Call / CallDyn / Method / VMT 选型与基址"
---
---
title: 调用 PluginBase / Call
description: Call / CallDyn / Method / VMT 选型与基址
---
`shared/PluginBase.h` · 命名空间 `plugin`
优先顺序：**已有 C++ 封装 → Command → Call → 最后才 patch**。
| 场景 | 选用 |
|---|---|
| 编译期已知地址、cdecl | `Call` / `CallAndReturn` |
| thiscall | `CallMethod` / `CallMethodAndReturn` |
| 运行时才有地址（Pattern / 重定位） | `CallDyn*` |
| 地址已是绝对、不要再加基址 | `*DynGlobal` |
| 虚表槽 | `CallVirtualMethod*` |
编译期地址 → `Call*`
运行时地址 → `CallDyn*`（多数配合 `GetGlobalAddress` / Pattern）
`*DynGlobal` **不做**重定位
静态构造 / `DllMain` / 对象池尚未建立 / 设备 Lost 之后继续画或调渲染相关逻辑。
## 无返回 cdecl
无返回的 cdecl 调用。`address` 按 `void(__cdecl*)(Args...)` 解释。调用约定错误会破坏栈。固定 RVA 换游戏版本通常要更新，或改用 Pattern + `CallDyn`。
```cpp
template
void Call(Args... args);
```
```cpp
#include "plugin.h"
plugin::Call<0x53BEE0>();
plugin::Call<0x123456>(1, 2.0f);
```
## 有返回 cdecl
`Ret` 写在模板参数最前。
```cpp
template
Ret CallAndReturn(Args... args);
```
```cpp
int value = plugin::CallAndReturn();
float f = plugin::CallAndReturn(10);
```
## stdcall
游戏内多数并不是 stdcall，确认约定后再用。
```cpp
template
void CallStd(Args... args);
template
Ret CallStdAndReturn(Args... args);
```
```cpp
plugin::CallStd<0x123456>(hwnd);
BOOL ok = plugin::CallStdAndReturn(hwnd);
```
## thiscall 方法
第一个参数是 `this`，必须有效。
```cpp
template
void CallMethod(C _this, Args... args);
template
Ret CallMethodAndReturn(C _this, Args... args);
```
```cpp
#include "plugin.h"
#include "common.h"
plugin::Events::processScriptsEvent += [] {
CPed* ped = FindPlayerPed();
if (!ped) {
return;
}
plugin::CallMethod<0x5E4280>(ped, WEAPONTYPE_M4, 999u, true);
bool alive = plugin::CallMethodAndReturn(ped);
(void)alive;
};
```
## 虚表方法
模板参数是虚表 **下标**，不是函数地址。下标错误几乎必崩。
```cpp
template
void CallVirtualMethod(C _this, Args... args);
template
Ret CallVirtualMethodAndReturn(C _this, Args... args);
```
```cpp
plugin::CallVirtualMethod<0>(entity);
int model = plugin::CallVirtualMethodAndReturn(entity);
```
## 运行时地址 cdecl
内部会做重定位。地址为 `0` 时不要调用。
```cpp
template
void CallDyn(uintptr_t address, Args... args);
template
Ret CallAndReturnDyn(uintptr_t address, Args... args);
```
```cpp
uintptr_t addr = plugin::pattern::Get("53 8B D9 83 EC 08", 0);
if (!addr) {
return;
}
plugin::CallDyn(addr);
int r = plugin::CallAndReturnDyn(addr, 1, 2);
```
## 运行时地址 stdcall
```cpp
template
void CallStdDyn(uintptr_t address, Args... args);
template
Ret CallStdAndReturnDyn(uintptr_t address, Args... args);
```
```cpp
plugin::CallStdDyn(addr, arg0);
auto r = plugin::CallStdAndReturnDyn(addr);
```
## 运行时地址 thiscall
```cpp
template
void CallMethodDyn(uintptr_t address, C _this, Args... args);
template
Ret CallMethodAndReturnDyn(uintptr_t address, C _this, Args... args);
```
```cpp
if (!ped || !addr) {
return;
}
plugin::CallMethodDyn(addr, ped, 1);
bool ok = plugin::CallMethodAndReturnDyn(addr, ped);
```
## 绝对地址 cdecl
```cpp
template
void CallDynGlobal(uintptr_t address, Args... args);
template
Ret CallAndReturnDynGlobal(uintptr_t address, Args... args);
```
```cpp
plugin::CallDynGlobal(0x401000);
int r = plugin::CallAndReturnDynGlobal(0x401000);
```
## 绝对地址 thiscall
```cpp
template
void CallMethodDynGlobal(uintptr_t address, C _this, Args... args);
template
Ret CallMethodAndReturnDynGlobal(uintptr_t address, C _this, Args... args);
```
```cpp
plugin::CallMethodDynGlobal(0x401000, ped);
bool ok = plugin::CallMethodAndReturnDynGlobal(0x401000, ped);
```
## 取虚表
取虚表指针，或某一槽位。
```cpp
inline void** GetVMT(const void* self);
inline void* GetVMT(const void* self, size_t index);
```
```cpp
void** vmt = plugin::GetVMT(ped);
void* fn = plugin::GetVMT(ped, 0);
```
## 基址与绝对地址
模块基址；RVA → 绝对地址。
```cpp
uintptr_t GetBaseAddress();
uintptr_t GetGlobalAddress(uintptr_t address);
```
```cpp
uintptr_t base = plugin::GetBaseAddress();
uintptr_t abs_addr = plugin::GetGlobalAddress(0x53BEE0);
```
## 分配与释放
等价于 new / delete，必须成对使用。
```cpp
template
ClassType* operator_new(ArgTypes... args);
template
ClassType* operator_new_array(size_t size);
template
void operator_delete(ClassType* data);
template
void operator_delete_array(ClassType* data);
```
```cpp
CVector* v = plugin::operator_new(1.0f, 2.0f, 3.0f);
plugin::operator_delete(v);
CVector* arr = plugin::operator_new_array(8);
plugin::operator_delete_array(arr);
```
## 栈上临时对象
```cpp
template
struct stack_object {
template
stack_object(ArgTypes... args);
T* operator->();
T& get_object();
};
```
```cpp
plugin::stack_object pos(0.0f, 0.0f, 0.0f);
pos->z = 10.0f;
```
## SDK 版本
```cpp
namespace Core {
PLUGIN_API unsigned int GetVersion();
}
```
```cpp
unsigned int ver = plugin::Core::GetVersion();
```
## 跨游戏取值
按当前工程宏取三端之一。
```cpp
BY_GAME(iii_val, vc_val, sa_val)
```
```cpp
uintptr_t addr = BY_GAME(0x48E000, 0x4A6000, 0x53BEE0);
plugin::CallDyn(addr);
```