API 参考

API 参考

English | 简体中文

ChaosCardGenerator 命名空间

• ComponentProfileRequest：用 ProfileId、平衡 Character 和 UnlockComponentRoles 标识一套生成配置。
• ComponentGenerationProfile：包含卡牌壳、组件、名称目录、出率策略工厂、数值策略和可选的原版关键字权限策略。
• ComponentPackageApi.Register：一次注册 profile、本地化、关键词升级、唯一性和自定义估值。
• ImmutableComponentCatalog：从审核过的 IroncladCardRecipe 建立所有结构索引；历史类型名不限制角色。
• ComponentApi.ComposeCatalog：合并完整源卡池且保留用于究极混沌加权的原始出现次数。
• IComponentOccurrencePolicy：分别控制家族先验、接受率反馈、家族内变体，并只观察最终成品。
• IComponentValuePolicy：控制数值是否缩放、采样、限制、奖励和触发频率折算。
• IComponentValuation：以百分之一点普通单体伤害为单位评价最终结构化效果。

负面价值可以在 ComponentValuationRegistration 中选择一种方式：

• NegativeLinearValuePerUnit > 0：每单位线性补偿；
• NegativeMultiplier > 1：整卡倍率补偿。

两者不能同时设置。

ComponentMultiplicity 有三类：Repeatable、同卡至多一次的 SinglePerCard、同卡池至多一次的 UniquePerPool。卡池 unique 只在卡牌成功通过全部校验后占用。

AutoAnthony 命名空间

• ComponentRuntimeApi：注册一个或一组运行时路由，提供 HasRoute 和 RegisteredRoutes 用于启动审计。
• ComponentPresentationApi：为自定义 opcode/variant 注册额外 HoverTip。
• ExternalComponentCharacterApi：注册外部角色，安装、读取或清除本局定义。
• IExternalAncientRelicAdapter：让古老牙齿和尘封魔典支持外部角色，无需本模组写死角色 ID。
• ExternalChaosCardModel：固定随机卡槽位的基类；外部模组只需覆盖 ProfileId、Slot 和 Pool。

冻结与错误

组件 profile、估值和 multiplicity 在第一次 Resolve 时冻结；执行路由在第一次执行时冻结；展示路由在第一次 渲染提示时冻结；外部角色注册在第一次安装或读取定义时冻结。

非 ASCII ID、重复路由、缺少 RuntimeSpec、重复 semantic ID、错误 trigger owner、空目录或与平衡原型不符 都会在初始化阶段直接抛错。应修复注册错误，不要带着半注册状态继续运行。

游戏的关键字枚举本身不可扩展。真正的新语义关键字应写成带 standalone_keyword 标志的组件，并注册运行时 与提示路由。外部模组仍负责保存/房主同步完整定义、自定义衍生物/充能球/状态解析和全新的卡牌生命周期钩子。