传奇准星功能完整教程 数据库配置脚本指令端侧适配变量触发详解
本文详解传奇准星功能数据库配置、Collimator脚本指令、PC移动端适配规则，汇总全部全局常量，附带QF脚本实测案例，解决传奇服务端准星物品触发、参数调用、物品属性修改等开发问题。…
一、准星功能概述
传奇服务端准星功能是物品交互核心拓展功能，主要实现鼠标精准定位物品、定向触发脚本逻辑、物品属性联动修改等效果，广泛应用于道具赋能、物品改名、属性绑定、定向交互等游戏玩法开发。本文完整讲解准星功能的数据库配置、脚本指令、全局常量、触发标签及端侧适配规则，助力开发者快速落地功能开发。
二、数据库物品配置规则
准星功能依托数据库物品参数实现基础属性定义，核心通过StdMode、Shape、Anicount三个参数控制物品的准星触发逻辑，新增扩展物品专属参数配置如下：
2.1 基础扩展参数
StdMode=47：专属新增扩展物品分类，该分类下物品默认支持叠加属性，是准星功能物品的基础分类标识。
2.2 Shape形态功能区分
Shape参数决定准星物品的使用生命周期与触发方式，分为三种核心形态：
Shape=50：单次消耗型准星物品。鼠标准星对准目标物品点击后，当前准星物品立即消失，仅可完成一次交互触发。
Shape=51：永久常驻型准星物品。物品无使用次数限制，可持续触发准星功能，仅可通过后台手动删除终止功能。
Shape=52：右键循环触发型准星物品。右键激活物品后持续开启准星模式，每选中一次目标物品触发一次专属脚本段，再次右键点击即可取消准星功能。
2.3 触发标签关联参数
Anicount：用于关联QF脚本中的自定义触发标签，参数数值对应标签后缀数字，例：Anicount=1 对应触发标签 [@StdmodeShow1]。
三、脚本开启准星功能指令
通过自定义脚本指令可主动激活准星功能，无需依赖数据库物品被动触发，是玩法定制的核心指令，标准格式及参数说明如下：
指令格式：Collimator 触发ID 是否可以一直使用
参数说明：触发ID绑定对应的脚本触发段；第二个参数为0或空时，准星仅单次可用，参数为1时，准星持续生效直至右键手动结束。
四、PC端与移动端适配逻辑
准星功能针对不同终端做了差异化适配，保证全平台交互体验一致性，具体表现规则如下：
PC端：右键激活准星物品后，鼠标光标直接切换为准星模式，可精准点击背包、场景内任意物品完成交互触发。
移动端：点击使用准星物品后，物品界面生成专属准星图标，拖动图标至目标物品位置，即可完成准星选中与脚本触发。
五、准星功能全局常量汇总
系统内置专属全局常量，可在脚本中直接调用，用于读取当前准星关联物品的基础信息，精准传递参数数据，所有常量区分大小写，配置时需严格核对：
5.1 当前使用准星物品常量
<$UseItemName>：当前激活准星功能的物品名称
<$UseItemMakeIndex>：当前准星物品的唯一ID标识
<$UseItemMakeidx>：当前准星物品的IDX索引值
5.2 准星选中目标物品常量
<$BagItemName>：准星选中的背包目标物品名称
<$BagItemMakeIndex>：准星选中目标物品的唯一ID标识
<$BagItemstidx>：准星选中目标物品的IDX索引值
六、QF脚本触发实例详解
以下为[@StdModeShow1]标准触发脚本案例，适配Shape=52物品右键循环触发场景，实现参数弹窗展示、物品关联、颜色修改及背包刷新功能，可直接复制用于服务端配置：
[@StdModeShow1]
#if
#act
;弹窗输出准星物品与目标物品全量参数
SendMsg 6 人物当前使用的物品名:<$UseItemName>，唯一ID:<$UseItemMakeIndex>，当前使用物品IDX：<$UseItemMakeidx>,准星物品改名名字<$G_UseItemName>
SendMsg 6 使用物品目标名字:<$BagItemName>，唯一ID:<$BagItemMakeIndex>，准星选择的物品IDX：<$BagItemstidx>，准星选中物品的改名名字<$G_BagItemName>
;通过唯一ID关联准星物品与目标物品
LINKITEMBYMAKEINDEX <$BagItemMakeIndex>
;修改目标物品名称颜色为253
ChangeItemNameColor -1 253
;刷新背包物品数据，让颜色修改实时生效
UpDateBoxItem -1
;全服广播物品颜色变更提示
SENDMSG 0 你的物品颜色变成了253
七、开发配置注意要点
第一，Shape参数不可混用，单次交互玩法推荐配置Shape=50，循环交互玩法优先Shape=52，常驻道具使用Shape=51；第二，Anicount数值必须与触发标签后缀数字完全一致，否则脚本无法触发；第三，移动端准星图标需适配客户端UI尺寸，避免拖动交互失效；第四，全局常量拼写错误会导致参数读取为空，配置后建议在测试服核验弹窗数据。
