主题
MythicMobs Mechanics
48 个技能机制，覆盖模型生命周期的所有操作维度。
分类总览
模型管理
| Mechanic | 说明 | 关键参数 |
|---|---|---|
| model | 挂载/卸载模型 | modelId, remove, invisible, scale, hitbox, canDrive, canRide, stepHeight, save |
| remapModel | 运行时替换模型资产 | modelId, 目标 assetId |
| swapEntity | 迁移模型到另一个实体 | modelId, 目标实体 |
| rendererInit | 初始化渲染器配置 | modelId |
model 参数详解
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
modelId | String | 必填 | 模型资产 ID |
remove | Boolean | false | true 时卸载模型 |
hitbox | Boolean | true | 是否启用自定义碰撞箱 |
invisible | String | "true" | 隐藏原版实体 |
scale | Double | 1.0 | 模型缩放 |
hitboxScale | Double | 1.0 | 碰撞箱缩放 |
canDrive | Boolean | false | 允许驾驶 |
canRide | Boolean | false | 允许乘坐 |
lockPitch | Boolean | false | 锁定头部俯仰 |
lockYaw | Boolean | false | 锁定头部偏航 |
stepHeight | Double | 0.5 | 台阶高度 |
viewRadius | Int | -1 | 可视半径 |
damageTint | Boolean | true | 受伤红闪 |
useStateMachine | Boolean | false | 启用动画状态机 |
save | Boolean | false | 持久化保存 |
syncBodyYaw | Boolean | true | 同步身体朝向 |
renderFire | Boolean | true | 渲染火焰 |
rootBone | String | null | 根骨骼名 |
动画
| Mechanic | 说明 | 关键参数 |
|---|---|---|
| state | 播放/停止动画 | state, modelId, loop, lerpIn, lerpOut, speed, priority, force |
| stateToggle | 切换动画开关 | state, modelId |
| defaultState | 设置默认动画 | state, modelId |
| modifyState | 修改播放中动画参数 | state, modelId, speed |
| animateModel | 手动骨骼变换 | partId, position, rotation, scale, relative, override |
state 参数详解
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
state | String | 必填 | 动画名称 |
modelId | String | null | 目标模型（null = 所有） |
sourceId | String | null | 动画来源模型 |
remove | Boolean | false | 停止动画 |
loop | LoopMode | - | 循环模式 |
override | OverrideMode | - | 覆盖模式 |
lerpIn | Int | - | 淡入时长（tick） |
lerpOut | Int | - | 淡出时长（tick） |
speed | Double | 1.0 | 播放速度 |
priority | Int | 0 | 优先级 |
force | Boolean | false | 强制播放 |
merge | Boolean | false | 合并播放 |
视觉效果
| Mechanic | 说明 | 关键参数 |
|---|---|---|
| tint | 颜色着色 | modelId, 颜色值 |
| glow | 发光轮廓 | modelId, 颜色值 |
| brightness | 亮度覆盖 | modelId, 亮度值 |
| enchant | 附魔光效 | modelId |
| billboard | 公告板模式 | modelId, 模式 |
| scale | 缩放 | modelId, scale, hitbox |
| petrify | 石化效果 | modelId |
碰撞箱
| Mechanic | 说明 | 关键参数 |
|---|---|---|
| bindHitbox | 绑定碰撞箱到骨骼 | modelId, 骨骼名 |
| hitboxConfig | 配置碰撞箱属性 | modelId, 尺寸/偏移 |
骑乘
| Mechanic | 说明 | 关键参数 |
|---|---|---|
| mountModel | 骑乘模型 | driver, mode, modelId, passengerBone |
| dismountModel | 下马 | driver, modelId, passengerBone |
| dismountAllModel | 全部下马 | - |
| pairModel | 配对模型骑乘 | modelId |
mountModel 参数详解
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
driver | Boolean | true | 作为驾驶员（否则乘客） |
force | Boolean | false | 强制骑乘 |
mode | String | "walking" | 控制模式：walking/flying/force_walking/force_flying |
modelId | String | null | 目标模型 |
passengerBone | String | null | 座位骨骼 ID |
canDamageMount | Boolean | false | 允许攻击坐骑 |
canInteractMount | Boolean | false | 允许交互坐骑 |
移动
| Mechanic | 说明 | 关键参数 |
|---|---|---|
| move | 移动实体 | 方向/速度 |
| jump | 跳跃 | 力度 |
| noFall | 取消摔落伤害 | - |
| rootMotion | 根运动配置 | weight, baseWeight, override |
| bodyRotation | 身体旋转 | 角度 |
| syncYaw | 同步偏航角 | - |
部件
| Mechanic | 说明 | 关键参数 |
|---|---|---|
| changePart | 切换骨骼部件 | modelId, partId |
| cycleParts | 循环切换部件 | modelId, 部件列表 |
| partVisibility | 部件可见性 | modelId, partId, 可见性 |
| changeParent | 更改骨骼父级 | modelId, partId, 新父级 |
锁定
| Mechanic | 说明 | 关键参数 |
|---|---|---|
| lockModelHead | 锁定头部旋转 | modelId |
| lockModelRotation | 锁定模型旋转 | modelId |
伪装
| Mechanic | 说明 | 关键参数 |
|---|---|---|
| disguise | 伪装为其他实体 | 伪装类型 |
| undisguise | 取消伪装 | - |
标签与物品
| Mechanic | 说明 | 关键参数 |
|---|---|---|
| setModelTag | 设置模型标签 | 标签值 |
| setModelTagVisible | 标签可见性 | 可见性 |
| linkItemBone | 物品绑定骨骼 | 骨骼名, 物品 |
| setItemModel | 设置物品模型 | 物品配置 |
子模型与分段
| Mechanic | 说明 | 关键参数 |
|---|---|---|
| subModel | 挂载子模型 | 子模型 ID, 挂载点 |
| segment | 分段行为 | 分段配置 |
其他
| Mechanic | 说明 | 关键参数 |
|---|---|---|
| cullConfig | 剔除配置 | 剔除参数 |
| leash | 拴绳 | 目标 |
| leashSelf | 自身拴绳 | - |