API Reference

API Reference

English | 简体中文

Generator namespace: ChaosCardGenerator

ComponentProfileRequest

Identifies one generation profile with ProfileId, balance Character, and UnlockComponentRoles. Use stable ASCII profile IDs. The two-argument constructor is for built-in profiles.

ComponentGenerationProfile

Contains ShellCatalog, ComponentCatalog, NameCatalog, an occurrence-policy factory, and an IComponentValuePolicy. CreateOccurrencePolicy() must return fresh pool-scoped state.

ComponentPackageApi

Register(ComponentPackageRegistration) installs profile, localization, keyword-upgrade, multiplicity, and custom valuation metadata. Register before the first ComponentApi.Resolve. Duplicate package IDs are rejected.

ImmutableComponentCatalog

Builds all structural indexes from reviewed IroncladCardRecipe values. The historical type name is retained for binary/source compatibility; it is valid for any balance archetype.

IComponentOccurrencePolicy

• SourcePriorWeight: native/source family prior.
• SelectionWeight: closed-loop correction after accepted cards.
• VariantWeight: choice within a family.
• Observe: receives finalized cards only, never failed attempts.

Use ComponentApi.CreateNativeOccurrencePolicy(catalog) unless the character needs a custom distribution.

IComponentValuePolicy

Controls numeric scalability, native-value preservation, sampling, clamping, value bonuses, and trigger payoff scaling. Use ComponentApi.DefaultValuePolicy unless you need a fully custom numeric model.

IComponentValuation

Returns finalized effect value in hundredths of one point of single-target damage. Exact opcode/variant routes win over opcode-wide routes.

ComponentValuationRegistration also supports one downside mode:

• NegativeLinearValuePerUnit > 0: linear compensation per unit; or
• NegativeMultiplier > 1: whole-card multiplicative downside compensation.

Do not set both.

ComponentMultiplicity

• Repeatable: ordinary component.
• SinglePerCard: at most once on one generated card.
• UniquePerPool: at most once in the generated pool.

Register with ComponentMultiplicityRegistration. Pool uniqueness is consumed only by accepted finalized cards.

Runtime namespace: AutoAnthony

ComponentRuntimeApi

• Register(opcode, variant, handler) registers one route.
• RegisterPackage(packageId, routes) validates and commits a route set.
• HasRoute and RegisteredRoutes support startup audits.
• Registration freezes when the first generated operation executes.

ComponentPresentationApi

Registers optional IComponentHoverTipProvider routes. Registration freezes on first generated hover-tip render.

ExternalComponentCharacterApi

• Register declares profile identity, archetype, and energy-icon prefix.
• InstallDefinitions replaces one profile's complete run-scoped definition list.
• GetDefinitions returns the installed immutable list.
• ClearDefinitions removes run-scoped definitions.

Character registration freezes when definitions are first installed or read.

ExternalChaosCardModel

Base class for concrete fixed-slot card models. Override ComponentProfileId, Slot, and Pool; generated text, upgrades, trigger dispatch, and operation execution are inherited.

Validation and failure behavior

Registration throws immediately for non-ASCII IDs, duplicate routes, missing RuntimeSpecs, duplicate semantic IDs, invalid trigger owners, empty catalogs, or a catalog whose character differs from its profile archetype. Treat these as initialization errors and fail loudly rather than continuing with a partially registered package.