角色与英雄
修改人物名字
修改当前人物名称。
命令名
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
新角色名已被使用。
这段写法把改名调用和回调标签放在同一个脚本流程里,成功或常见失败时会跳到对应标签。
注意事项
- 改名前要确认目标名称未被占用,并与现有名单、日志和外部系统保持一致。
- 如果脚本后续还会按旧名字查找数据,改名后要一并更新关联文件。
- 改名会改动角色数据,权限和地图条件必须收紧,建议仔细查看下方的《在线改名脚本》案例。
