Документация Docs/ru/reference/model-format/tokens.md

Токены описания моделей

Сгенерированный справочник. Не редактируйте напрямую. Обновите BuildTools/ModelFormatInterface.json, затем запустите python BuildTools/docs_model_format.py --write.

Индекс

Синтаксис

Каноническая JSON-модель

Руководство

Набор токенов манифеста напрямую сравнивается с ModelDescriptionParser::ParseToken. Добавление или удаление parser spelling останавливает генерацию, пока таблица не будет согласована.

Stable ID	Token написаний	Category	Syntax	Context	Стабильность	Authoring contract	Runtime effect
`model-format.token.model`	`Model`	`structure`	`Model <mesh.fbx\|mesh.obj>`	description	`experimental`	Выбирает primary baked mesh hierarchy и base source skeleton. Path разрешается относительно файла с directive; побеждает последнее assignment.	Выбранный mesh предоставляет physical bones, drawables, skinning и default materials; ModelInfoBaker отдельно преобразует выбранные source clips и совместимые contributed joints в immutable runtime rig.
`model-format.token.include`	`Include`	`structure`	`Include <file.fo3d> [<name> <value> ...]`	description	`experimental`	Разбирает другое description inline с optional replacements %name%. Include paths относительны, arguments идут парами, state общий, recursion запрещена.	Included directives становятся частью concrete description до validation и baking.
`model-format.token.mesh`	`Mesh`	`selector`	`Mesh <draw-bone-name\|All>`	current link	`experimental`	Выбирает drawable mesh для следующих Texture и Effect. All очищает selector и выбирает все drawable meshes.	Material overrides применяются только к выбранному mesh либо ко всем при пустом selector.
`model-format.token.subset`	`Subset`	`selector`	`Subset <ignored>`	description	`deprecated`	Устаревшее compatibility spelling. Parser забирает один argument, пишет warning и не выбирает mesh.	Эффекта нет. Замените на Mesh; не используйте в новом контенте.
`model-format.token.layer`	`Layer`	`selector`	`Layer <index-or-enum>`	description	`experimental`	Выбирает compile-time layer slot. Очищает mesh selector и переводит modifiers на dummy link, пока Root или Attach не создаст active link.	Layer участвует только при ненулевом model-layer value проекта.
`model-format.token.value`	`Value`	`selector`	`Value <integer-or-enum>`	selected Layer	`experimental`	Выбирает точное ненулевое значение, активирующее следующую entry Root или Attach; также очищает mesh selector и current link.	Link активен, только когда runtime layer array содержит это значение по выбранному index.
`model-format.token.root`	`Root`	`composition`	`Root`	description or selected Layer/Value	`experimental`	Без Layer выбирает default root modifier; при active Layer и ненулевом Value создаёт modifier пары.	Может преобразовать model, изменить speed/materials/effects, отключить meshes/layers и применить cuts без child.
`model-format.token.attach`	`Attach`	`composition`	`Attach <child.fo3d\|child.fbx\|child.obj>`	selected Layer/Value	`experimental`	Создаёт layer-selected child-model link. Path относителен к файлу с directive.	С Link child присоединяется к одной parent bone; без него одноимённые child/parent bones образуют shared-skeleton attachment. У direct FBX/OBJ child нет description-level коррекции scale, поэтому static extent должен находиться между Baking.ModelAttachmentMinExtent и Baking.ModelAttachmentMaxExtent.
`model-format.token.attach-particles`	`AttachParticles`	`composition`	`AttachParticles <particle.spk\|particle.efk>`	selected Layer/Value	`experimental`	Создаёт layer-selected baked-particle link. Resource path хранится буквально, не относительно description.	Client создаёт particle на Link bone и удаляет её, когда активирующий layer value больше не выбран.
`model-format.token.link`	`Link`	`composition`	`Link <parent-bone>`	current layer link	`experimental`	Задаёт parent bone текущего non-default link; игнорируется на default или dummy link.	Child целиком присоединяется к bone; particle требует bone. Пустой child-model link не использует её в runtime.
`model-format.token.cut`	`Cut`	`geometry`	`Cut <volume.fbx\|volume.obj> <layer-list\|All> <shape-list\|All> <unskin-bone-1\|-> <unskin-bone-2\|-> <unskin-shape\|~shape\|->`	current link	`experimental`	Добавляет baked cut volumes в выбранные composed-mesh layers. Дефис разделяет lists, - пропускает unskin fields, ~ обращает unskin shape.	Combined geometry внутри или снаружи shapes удаляется; optional paired bones управляют unskin.
`model-format.token.transform-set`	`RotX`, `RotY`, `RotZ`, `MoveX`, `MoveY`, `MoveZ`, `ScaleX`, `ScaleY`, `ScaleZ`, `Speed`	`transform`	`<token> <finite-float>`	current link	`experimental`	Задаёт transform axis или playback-speed multiplier. Rotation задаётся в градусах.	Ненулевые values умножают model transform или speed chain; ноль не даёт вклада.
`model-format.token.scale-set`	`Scale`	`transform`	`Scale <finite-float>`	current link	`experimental`	Задаёт одинаковые ScaleX, ScaleY, ScaleZ.	Ненулевое value создаёт uniform scale transform.
`model-format.token.transform-add`	`RotX+`, `RotY+`, `RotZ+`, `MoveX+`, `MoveY+`, `MoveZ+`, `ScaleX+`, `ScaleY+`, `ScaleZ+`, `Speed+`	`transform`	`<token> <finite-float>`	current link	`experimental`	Прибавляет к transform/speed field; при нуле operand становится initial value.	Include может накладывать additive adjustments без base assignment.
`model-format.token.scale-add`	`Scale+`	`transform`	`Scale+ <finite-float>`	current link	`experimental`	Применяет additive rule ко всем scale axes.	Даёт uniform additive adjustment для templates и selected links.
`model-format.token.transform-multiply`	`RotX`, `RotY`, `RotZ`, `MoveX`, `MoveY`, `MoveZ`, `ScaleX`, `ScaleY`, `ScaleZ`, `Speed`	`transform`	`<token> <finite-float>`	current link	`experimental`	Умножает transform/speed field; при нуле operand становится initial value.	Include применяет proportional adjustments, сохраняя ноль как runtime identity sentinel.
`model-format.token.scale-multiply`	`Scale*`	`transform`	`Scale* <finite-float>`	current link	`experimental`	Применяет multiplicative rule ко всем scale axes.	Даёт uniform proportional scale adjustment.
`model-format.token.disable-layer`	`DisableLayer`	`composition`	`DisableLayer <layer[-layer...]>`	current link	`experimental`	Добавляет indices в disabled-layer set; каждое значение проверяется по range.	При active link совпавшие layer slots пропускаются в model instance.
`model-format.token.disable-mesh`	`DisableMesh`	`composition`	`DisableMesh <mesh[-mesh...]\|All>`	current link	`experimental`	Добавляет drawable mesh names в disabled set; All хранит empty wildcard.	При active link совпавшие meshes исключаются из combined geometry.
`model-format.token.texture`	`Texture`	`material`	`Texture <slot> <texture-name\|Parent[_mesh]>`	current link and Mesh selector	`experimental`	Переопределяет texture slot выбранного mesh или всех. Не-Parent names относительны к current model mesh; Parent копирует active parent texture в attached-model context.	Override участвует в mesh batching и adjustment texture-atlas coordinates.
`model-format.token.effect`	`Effect`	`material`	`Effect <effect.fofx\|Parent[_mesh]>`	current link and Mesh selector	`experimental`	Переопределяет draw effect выбранного mesh или всех; Parent копирует active parent effect.	Meshes с разными effects не могут делить combined draw batch.
`model-format.token.anim`	`Anim`	`animation`	`Anim <state> <action> <ModelFile\|animation-mesh> <clip\|~clip\|Base>`	description	`experimental`	Сопоставляет state/action pair с source clip. ModelFile выбирает primary source, ~ обращает playback, Base выбирает первый clip до runtime-rig conversion.	Регистрируется первая declaration пары; model-specific lookup и substitutions описаны в ModelAnimation.md.
`model-format.token.anim-speed`	`AnimSpeed`	`animation`	`AnimSpeed <state> <action> <positive-float>`	description	`experimental`	Задаёт authored playback speed mapped pair.	Speed умножает runtime playback и делит common effective duration.
`model-format.token.allow-animation-geometry`	`AllowAnimationGeometry`	`animation`	`AllowAnimationGeometry <external-animation-file>`	description	`experimental`	Временно разрешает drawable geometry в точном внешнем source Anim, пока source исправляется. Path разрешается от final concrete description.	Только validation, без serialization. Duplicate, unselected, duplicate-resolved и stale exceptions останавливают bake; удалите строку с исправлением export.
`model-format.token.anim-layer-value`	`AnimLayerValue`	`animation`	`AnimLayerValue <state> <action> <layer> <value>`	description	`experimental`	Переопределяет layer value при запросе точной authored state/action pair.	Override применяется до redundant-call detection и model composition.
`model-format.token.fast-transition-bone`	`FastTransitionBone`	`animation`	`FastTransitionBone <bone>`	description	`experimental`	Помечает base-model bone для immediate transition reset, когда новый child использует её как Link.	Следующий body-animation track сбрасывает transition state attachment bone.
`model-format.token.state-alias`	`StateAnimEqual`	`animation`	`StateAnimEqual <from-state> <to-state>`	description	`experimental`	Определяет одношаговый state-animation alias.	Alias применяется один раз до exact lookup и имеет приоритет над exact source-key entry.
`model-format.token.action-alias`	`ActionAnimEqual`	`animation`	`ActionAnimEqual <from-action> <to-action>`	description	`experimental`	Определяет одношаговый action-animation alias.	Alias применяется один раз до exact lookup и имеет приоритет над exact source-key entry.
`model-format.token.disable-shadow`	`DisableShadow`	`rendering`	`DisableShadow`	description	`experimental`	Отключает shadow rendering всех instances description.	Model-level flag объединяется с per-instance shadow toggle.
`model-format.token.disable-interpolation`	`DisableAnimationInterpolation`	`animation`	`DisableAnimationInterpolation`	description	`experimental`	Отключает keyframe interpolation model animation controller.	Registered controller выполняет sampling без interpolation.
`model-format.token.disable-backward`	`DisableBackwardAnim`	`animation`	`DisableBackwardAnim`	description	`experimental`	Отключает выбор WalkBack и RunBack для movement-pose animation.	Movement всегда использует forward walk/run, а SetMoveDir выравнивает look direction.
`model-format.token.rotation-bone`	`RotationBone`	`animation`	`RotationBone <bone>`	description	`experimental`	Выбирает проверенную torso/body rotation bone и включает movement overlay controller.	Look/move directions могут различаться; body и настроенные head bones получают directional rotation, пока movement/turn animations идут на overlay controller.