BLUE引擎说明书
BLUE引擎说明书
NPC与界面

变更 NPC 名称

动态修改指定地图坐标处商人 NPC 的名称，并可把原名称写入变量，适用于活动称号、占领奖励和阶段性界面替换。

命令用途

ChangeMerchantName 用于动态修改指定 NPC 的名称。

它适合做活动占领、职业上榜、阶段奖励或特殊身份展示，让场景中的 NPC 名称随脚本流程即时变化。

命令名

ChangeMerchantName

调用格式

ChangeMerchantName <地图名> <X坐标> <Y坐标> <新名称> [变量名]

参数说明

参数必填说明
地图名是目标 NPC 所在地图名或地图编号。
X坐标是目标 NPC 的 X 坐标。
Y坐标是目标 NPC 的 Y 坐标。
新名称是要改成的新 NPC 名称。
变量名否可选变量名，用于接收修改前的原名称。

返回或影响

  • 这是执行型命令，会直接修改指定 NPC 的显示名称。
  • 当提供 变量名 时，可把原名称保存起来，方便后续广播、恢复或提示。
  • 如果地图、坐标写错，脚本通常不会命中正确 NPC。

示例

基础用法

#ACT
Mov AWarrior <$USERNAME>
ChangeMerchantName 3 340 328 <$STR(AWarrior)>\冠军战士

这段写法适合把指定 NPC 名称改成“玩家名 + 称号”的展示样式。

常见变体

#ACT
ChangeMerchantName 3 340 328 王者使者 SOldName
SendMsg 1 原名称：<$STR(SOldName)>，现已改为王者使者。

这类写法适合先保留原名称，再做公告、回滚或后续恢复处理。

注意事项

  • 这条命令靠地图和坐标精确定位 NPC，坐标写错就会改不到目标。
  • 如果同一地图上存在多个功能相近 NPC，最好先核对实际坐标，不要只靠名称猜位置。
  • 当你需要临时改名一段时间后自动失效，通常要继续配合 变更 NPC 存活时间。
相关资源

相关命令

配置对话框选项

在 QManage 中统一配置 NPC 对话框的行为、位置和背景图，适用于定制登录入口、功能大厅和专用界面样式。

变更 NPC 存活时间

调整指定地图坐标处商人 NPC 的存活时长，适用于临时活动 NPC、限时入口和阶段性场景功能。