替换 HASH 键名

命令别名

Hash-ReplaceKey

命令用途

Hash-ReplaceKey 对应的实际命令写法是 HASH <标识> ReplaceKey，用于在保持键值内容不变的前提下，把旧键名替换为新键名。最常见的用途是角色改名后，把以「角色名.XX」或「角色名_XX」为键的数据迁移到新角色名。

调用格式

HASH <标识> ReplaceKey <原Key> <新Key>

参数说明

参数	必填	说明
`标识`	`是`	HASH 容器标识，例如 `H_角色`。
`ReplaceKey`	`是`	固定子命令，表示替换键名。
`原Key`	`是`	要被替换的旧键名。
`新Key`	`是`	替换后的新键名。

返回或影响

该命令只替换键名，键对应的值保持不变。
键名必须严格按 角色名.XX 或 角色名_XX 两种格式定义，才支持替换。
角色改名后如果不做替换，以旧角色名为键的数据会与新角色名失联。

示例

基础用法（带后缀的键）

#ACT
HASH H_角色 ReplaceKey <$PARAM(1)>_灵符 <$PARAM(2)>_灵符
HASH H_角色 ReplaceKey <$PARAM(1)>_金币 <$PARAM(2)>_金币
HASH H_角色 ReplaceKey <$PARAM(1)>_元宝 <$PARAM(2)>_元宝
HASH H_角色 ReplaceKey <$PARAM(1)>_泡点 <$PARAM(2)>_泡点
HASH H_角色 ReplaceKey <$PARAM(1)>_金刚石 <$PARAM(2)>_金刚石
HASH H_角色 ReplaceKey <$PARAM(1)>_声望 <$PARAM(2)>_声望

这段写法会在角色改名后，把以旧角色名为前缀的各类资产数据逐个迁移到新角色名下。

不带后缀的键

#ACT
HASH H_角色数据 ReplaceKey <$PARAM(1)> <$PARAM(2)>

这段写法适用于键名就是角色名本身的数据。

注意事项

键名格式不符合 角色名.XX 或 角色名_XX 时不会被替换。
替换前建议先确认旧键存在，必要时用 HashExists 判断。
角色改名的整体流程需配合改名命令与 HASH 数据迁移一起使用，逐条替换时要保证新旧角色名一一对应。