西风逍遥游
4377e062dd
Squashed onto current main. Adds src/engine/common/Assert.h (EV_PARAM_CHECK / EV_ASSERT backed by zeroerr), an EVENGINE_ENABLE_ASSERTS option (non-Debug builds strip ZEROERR_NO_ASSERT unless enabled), parameter checks at key entry points, Doxygen comments across headers, Doxyfile + make docs / CMake docs targets, and Windows setup + code conventions in AGENTS.md.
88 lines
3.4 KiB
C++
88 lines
3.4 KiB
C++
#pragma once
|
|
|
|
// 效果系统：数据驱动的 Effect "定义/模板"（类似 GAS 的 GameplayEffect）。
|
|
//
|
|
// 一个 EffectDefinition 描述"施加后会发生什么"，本身不含运行时状态；
|
|
// 施加到具体 actor 后由 StatusSystem 产生 StatusInstance（见 StatusTypes.h）。
|
|
//
|
|
// 灵活性/可定制点：
|
|
// - 完全数据驱动：C++ 侧 registerEffect() 或脚本侧 loadFromJson() 均可定义新效果，
|
|
// 无需修改引擎代码；effect id、属性名、tag、op 全部是字符串。
|
|
// - durationPolicy / stackPolicy 同样是字符串，方便未来扩展新策略而不破坏 ABI；
|
|
// 未知 stackPolicy 可走 StatusSystem::registerStackPolicy 注册的自定义策略。
|
|
// - period > 0 的周期效果不会自动改属性，而是产生 tick 事件交给上层处理，
|
|
// 从而可以让周期伤害/治疗完整走 Settlement 结算流水线（见 Settlement.h）。
|
|
// - extra 字段是任意 string→string 自定义数据（图标、VFX、脚本钩子名……），
|
|
// 无需为每个新效果特性修改引擎结构体。
|
|
|
|
#include <string>
|
|
#include <unordered_map>
|
|
#include <vector>
|
|
|
|
namespace eve::rpg {
|
|
|
|
/** @brief 效果里携带的一条属性修改规格（应用到 AttributeSystem::addModifier）。 */
|
|
struct EffectModifierSpec {
|
|
std::string attribute;
|
|
std::string op = "add";
|
|
double value = 0.0;
|
|
int priority = 0;
|
|
};
|
|
|
|
struct EffectDefinition {
|
|
std::string id;
|
|
|
|
/** @brief "instant" | "duration" | "infinite"（未知值按 "instant" 处理）。 */
|
|
std::string durationPolicy = "instant";
|
|
float duration = 0.f; ///< durationPolicy == "duration" 时使用（秒）
|
|
|
|
/** @brief > 0 时为周期效果：每隔 period 秒产生一次 StatusTickEvent。 */
|
|
float period = 0.f;
|
|
|
|
/**
|
|
* @brief "none" | "refresh" | "extend" | "stack"，或 StatusSystem::registerStackPolicy 注册的名字。
|
|
* 未知且未注册时按 "none" 处理。
|
|
*/
|
|
std::string stackPolicy = "none";
|
|
int maxStacks = 1;
|
|
|
|
/** @brief durationPolicy 为 duration/infinite 且 period<=0 时，apply 会直接写入这些修改器。 */
|
|
std::vector<EffectModifierSpec> modifiers;
|
|
|
|
std::vector<std::string> tags;
|
|
|
|
/** @brief 游戏自定义附加数据（图标路径、特效名、脚本钩子……）。 */
|
|
std::unordered_map<std::string, std::string> extra;
|
|
|
|
bool hasTag(const std::string &tag) const;
|
|
std::string getExtra(const std::string &key, const std::string &fallback = {}) const;
|
|
};
|
|
|
|
/** @brief 全局效果定义表：进程级单例，供任意模块 / 脚本按 id 引用。 */
|
|
class EffectRegistry {
|
|
public:
|
|
static void registerEffect(const EffectDefinition &def);
|
|
static const EffectDefinition *find(const std::string &id);
|
|
static bool remove(const std::string &id);
|
|
static void clear();
|
|
static int count();
|
|
|
|
/**
|
|
* @brief 从 JSON 数组批量注册效果定义，返回成功注册的数量。
|
|
* 每个元素形如：
|
|
* {
|
|
* "id": "poison", "durationPolicy": "duration", "duration": 5,
|
|
* "period": 1, "stackPolicy": "stack", "maxStacks": 5,
|
|
* "modifiers": [{"attribute":"health","op":"add","value":-5}],
|
|
* "tags": ["debuff", "poison"],
|
|
* "extra": {"icon": "ui/poison.png", "vfx": "fx.poison"}
|
|
* }
|
|
*/
|
|
static int loadFromJson(const std::string &json, std::string *error = nullptr);
|
|
|
|
private:
|
|
static std::unordered_map<std::string, EffectDefinition> &table();
|
|
};
|
|
|
|
} // namespace eve::rpg
|