传奇坐骑系统配置教程 马牌数据库参数全套脚本骑乘规则
本文全面解析传奇游戏坐骑系统核心配置逻辑，涵盖马牌数据库参数、QF脚本触发指令、单双人骑乘操作规则、地图权限控制、客户端界面配置等全维度内容。精简冗余配置说明，规范脚本格式与参数释义，适合传奇GM、版本开发者快速配置坐骑功能，解决坐骑外观特效、双人骑乘权限、触发命令等常见搭建问题。一、坐骑系统基础定…
本文全面解析传奇游戏坐骑系统核心配置逻辑，涵盖马牌数据库参数、QF脚本触发指令、单双人骑乘操作规则、地图权限控制、客户端界面配置等全维度内容。精简冗余配置说明，规范脚本格式与参数释义，适合传奇GM、版本开发者快速配置坐骑功能，解决坐骑外观特效、双人骑乘权限、触发命令等常见搭建问题。
一、坐骑系统基础定义与马牌基础变量
传奇坐骑系统核心载体为马牌道具，系统基础全局变量定义如下，是所有参数配置与脚本生效的前提：
基础变量：<$HORSE>
装备位置：15（固定装备栏位，不可随意修改）
二、DB段马牌核心参数详情
马牌道具的数据库参数存储于道具数据库及cfg_item.xls配置表，核心控制坐骑属性、外观、特效、人物穿戴联动效果，具体参数释义如下：
2.1 数据库基础参数
stdmod：固定赋值28，代表道具类型为马牌，系统通过该参数识别坐骑道具
source：双人骑乘权限参数，仅stdmod=28且Anicount数值大于0时生效；1=支持双人骑乘，0=禁止双人骑乘
2.2 cfg_item.xls扩展参数（V21列Expend1）
原V21列Expend1参数默认绑定首饰盒功能，现已扩展6组马牌专属参数，格式示例：0#1#0#1，各组参数功能拆分如下：
参数1：基础预留参数，固定赋值0，无额外拓展功能
参数2：坐骑外观编号，控制马匹模型素材
坐骑外观编号对应说明：1代表主宰者战马，2代表主宰者灵虎；3至5读取Horse2.wzl单人马匹素材，单性别320张贴图，整组640张，系统自动区分角色性别；20至99为自定义扩展马匹素材，分段读取专属wil文件，20-28对应L-Horse.wil、29-49对应L-Horse1.wil、50-99对应L-Horse2.wil。
参数3：坐骑外观特效编号，1-6调用horse2.wzl文件内1920-38399号贴图的6组专属特效，0=关闭坐骑特效
参数4：骑乘状态人物翅膀特效，仅对主宰者灵虎（参数2=2）生效；0=隐藏翅膀特效，1=显示翅膀特效
参数5：骑乘状态人物衣服外观控制
骑乘状态人物衣服外观控制规则：参数为0或空时，默认显示马牌自带衣服外观；参数为1时，跟随参数2对应的坐骑套装外观；参数为2时，读取角色自身Shape值显示衣服外观。
参数6：扩展骑乘人物衣服素材，专属文件读取规则：L-HumHorse.wil（0-49）、L-HumHorse1.wil（50-99）、L-HumHorse2.wil（100-149）...L-HumHorse6.wil（300-349）
参数7：扩展骑乘人物发型素材，L-HairHorse.wil文件0-14号贴图，共15种自定义发型
重点规则：仅当参数2取值20-99（自定义扩展坐骑）时，参数6、参数7的人物外观素材配置才会生效
三、QF段坐骑触发脚本与内置命令
QF脚本段控制坐骑召唤、收回、状态切换等动态触发逻辑，包含专属跳转标签、全局命令及自定义触发事件，所有脚本可直接复制导入版本使用。
3.1 基础上下马触发标签
① 上马触发 @UPHORSE
[@UPHORSE]
#if
#act
Sendmsg 7 您的坐骑成功被召唤！
break
② 下马触发 @DOWNHORSE
[@DOWNHORSE]
#if
#act
Sendmsg 7 您的坐骑成功被收回！
break
3.2 一键上下马整合命令
封装单一标签实现点击切换骑乘状态，简化版本操作逻辑：
[@UpOrDownHorse]
#if
#act
UpOrDownHorse
Sendmsg 7 OK！
break
3.3 骑乘状态检测命令
CheckOnHorse 为内置状态检测指令，用于判断角色当前是否处于骑乘状态，可嵌套至各类功能脚本中：
#IF
CheckOnHorse
#SAY
你正在骑马中....
3.4 上马时长自定义命令
SETUPHORSETIME 控制上马动画延迟时长，默认3秒，赋值0为立即上马，支持自定义秒数配置：
[@main]
#IF
#ACT
SETUPHORSETIME 2
SENDMSG 7 您的上马时间已修改为2秒
3.5 骑马跑步专属触发
角色骑乘状态下跑步时自动触发该标签，可拓展特效、属性加成等逻辑：
[@HorseRun]
#IF
#ACT
SENDMSG 7 骑马跑步触发
四、单双人骑乘操作全规则
4.1 通用操作快捷键
双人骑乘邀请：CTRL+L（固定快捷键，不可修改）
通用下马指令：CTRL+G（邀请人、被邀请人共用）
4.2 单人骑乘配置规则
4.2.1 上马方法
1、将马牌正确装备至15号专属装备位；2、F12键位设置中自定义骑乘快捷键，未设置则默认CTRL+G；3、使用设置快捷键召唤坐骑。
4.2.2 下马方式
主动下马：大退游戏、小退角色、按下骑乘快捷键；被动下马：角色死亡、将马牌移出装备栏放入包裹。
4.2.3 骑乘可执行操作
左键行走（1格/步）、右键跑步（3格/步）、使用药品、自动开启护盾、面对面交易/丢弃物品、交互NPC、释放全类型烟花。
4.2.4 骑乘禁止操作
攻击其他目标、接取圣水、拾取物品、挖宝、挑战副本/BOSS、执行所有带有起手动作的技能及交互行为。
4.3 双人骑乘配置规则
4.3.1 邀请条件
邀请人与目标玩家距离≤3格，目标玩家未处于任何坐骑状态，按下CTRL+L发送邀请。
4.3.2 基础移动设定
行走（左键）1格/步，跑步（右键）3格/步，双人共用同一坐标格子。
4.3.3 权限与操作限制
全场景禁止：攻击、接水、拾取、挖宝、释放烟花外的所有带起手动作功能；被邀请人仅可执行吃药、大小退、下马、聊天五项操作，其余操作由邀请人全权控制。
4.3.4 伤害与状态判定
所有外部伤害全部结算至邀请人，被邀请人处于无敌保护状态；心法、中毒、buff/debuff等所有状态，均以邀请人角色数据为准。
4.3.5 界面与外显展示
1、被邀请人界面显示马形下马按钮，悬浮提示「点击按钮可直接下马」；2、站位：邀请人位于坐骑后方，被邀请人位于前方；3、名称：仅显示角色本名，邀请人名称后置，被邀请人名称前置，隐藏所有称号；4、血条：仅展示邀请人血条、内功条，隐藏被邀请人状态条。
4.3.6 强制禁止功能
双人骑乘状态下，所有传送按钮、传送石道具无效果；双方均无法创建/加入组队。
4.4 双人骑乘下马触发条件
被邀请人单独下马：CTRL+G快捷键、界面下马按钮、角色小退/大退、角色死亡
全员共同下马：邀请人按下CTRL+G、邀请人小退/大退、邀请人死亡
五、地图与权限控制配置
5.1 地图骑马限制参数
地图配置文件添加参数：NOHORSE，添加后该地图全域禁止所有单人/双人骑乘，常用于安全区、副本、竞技地图。
5.2 管理员权限命令
Command.ini配置文件内置控制命令：@DisableHorseInvite，默认全局禁止双人骑乘邀请，管理员可通过该命令切换开启/关闭邀请权限。
六、客户端界面配置
登录M2服务端客户端控制面板，进入页面显示设置，勾选新增复选框「显示上马/下马按钮」，开启后客户端界面将展示可视化骑乘操作按钮，无需记忆快捷键即可操作。
七、补充说明
坐骑骑乘音效文件存放于程序包第三方补丁目录，可直接替换对应音频文件修改骑马移动、上马、下马音效，无需修改脚本与数据库参数。
