角色与英雄

修改人物名字

修改当前人物名称。

命令名

ChangeCharName 支持英雄 H.

命令用途

ChangeCharName 用于修改当前人物的名字。

调用格式

ChangeCharName <新名字>

参数说明

参数必填说明
新名字是修改后的角色名称。

返回或影响

  • 这是执行型命令,会直接修改当前人物名称。
  • 改名后,部分依赖角色名的名单、脚本判断和外部记录可能需要同步处理。

固定回调标签

ChangeCharName 执行后,会按结果跳转到对应标签。

标签说明
[@chgname_success]改名成功跳入此段。
[@chgname_fail_name_used_0]如果输入的角色名字与在线的人物或英雄同名则跳入此段。
[@chgname_fail_name_used]新角色名已被使用。
[@chgname_fail_no_character]查询不到角色。
[@chgname_fail_incomplete_data]数据错误。
[@chgname_fail_name_wrong_format]新角色名包含了过滤字符。
[@chgname_fail_unknow]未知错误。
[@chgname_fail_wrong_format]输入文字中包含了过滤字符。

示例

基础用法

#ACT
ChangeCharName 新名字

[@chgname_success]
#SAY
改名成功。

[@chgname_fail_name_used]
#SAY
新角色名已被使用。

这段写法把改名调用和回调标签放在同一个脚本流程里,成功或常见失败时会跳到对应标签。

注意事项

  • 改名前要确认目标名称未被占用,并与现有名单、日志和外部系统保持一致。
  • 如果脚本后续还会按旧名字查找数据,改名后要一并更新关联文件。
  • 改名会改动角色数据,权限和地图条件必须收紧,建议仔细查看下方的《在线改名脚本》案例。

相关命令