HytaleDocs
Misc

StateBindingConfig

AudioState

Id of the AudioState this binding subscribes to.

Type information: (Nullable) String

Deltas

Per-state-value deltas. Unlisted values default to zero (no effect).

Type information:

(Nullable) Array of the type:

StateDeltaConfig with the following properties:

KeyTypeDescription
Value(Nullable) String

State value name this delta applies to.

VolumeDb(Nullable) Either Number defaults to: 0.0 or String that matches the pattern: ^(-?Infinity|NaN)$

Signed dB offset applied to voice gain when this state value is active. Ignored when Mute is true.

MuteBoolean defaults to: false

When true, forces the subscriber silent for this state value. Fading is still applied.

PitchSemitones(Nullable) Either Number defaults to: 0.0 or String that matches the pattern: ^(-?Infinity|NaN)$

Signed semitone offset applied to the subscriber's playback pitch when this state value is active. 0 = no change. 12 = one octave up, -12 = one octave down, -6 = half octave down (tritone), -60 = perceptually frozen / time-stop effect.

Fade(Nullable)
StateFadeConfig

StateFadeConfig with the following properties:

KeyTypeDescription
Duration(Nullable) BarBeatDuration

How long this subscriber's ramp takes, as bars plus beats plus ms against its own tempo. A subscriber with no tempo takes the Ms component alone. Categories, ambient beds and sound events never have one, so author their fades in Ms. A music container needs a Tempo of its own, or one inherited from the Segment it is a direct layer of. Omit to take the length the axis resolved.

Curve(Nullable) FadeCurve

Interpolation curve shape. Read only when this fade supplies Duration. Alongside a Delay and no Duration it is ignored, and a Fade carrying nothing but a Curve is rejected.

Delay(Nullable) BarBeatDuration

How long this subscriber holds its old level past the boundary before its ramp starts. An audio category has no hold, so a delay lengthens its ramp instead. Non-negative: to begin before a boundary, move the boundary itself with SyncTo Offset.

This subscriber's own ramp onto this state value, overriding field by field what the axis resolved. A transition override sent with the state change still outranks it. Omit so every subscriber moves together. Where more than one binding covers this axis, later ones refine earlier ones field by field. A later binding can set a field but cannot clear one back to the axis. Music composes ancestors, then the Segment, then the LayerPlacement, then the leaf container. A sound event composes its own before the AmbienceFX that plays it.

Notes:

Types referenced by this type

FadeCurve

(Nullable) Any one of the following String (defaults to Linear):

NameDescription
"Linear"
"Logarithmic"
"Exponential"
"SCurve"
"EqualPowerSine"

On this page