996引擎SortHumVarToList命令用法详解 - 在线排名实现方法

翻996引擎帮助文档的人物命令区，SortHumVarToList排在变量操作类里，备注栏只写了一句「把在线人物的自定义变量排序后写入文件」。这句话看着简单，真配进脚本时才发现四个参数各管一段：排谁的变量、按哪个变量排、结果存到哪个路径、文件名怎么叫。

文档注意项里特别标了「只排在线人物」，不少人忽略这条，拿离线玩家的数据去排当然出不来结果。下面从命令格式开始，把参数含义、在线范围限制和两个路径的区别逐个拆开讲，配进NPC前对照过一遍能少走弯路。

格式速查

SortHumVarToList是996引擎排序命令，格式如下：

SortHumVarToList 变量名 保存路径 排序模式(0,1) 名字路径

对照996引擎帮助文档原文：变量名填要排序的人物自定义变量，保存路径填排序结果写入的文件，排序模式0升序1降序，名字路径选填。文档特别注明此命令只排序在线人物的变量。

文档自带的标准示例：

[@main]
#IF
#ACT
SortHumVarToList QQQQ ..\QuestDiary\测试.txt 0

这段把在线人物变量QQQQ按升序排好，结果写入测试.txt，只传三个参数时不带名字路径。

参数说明

排序模式0是升序、1是降序，帮助文档写得很明确。做在线战力榜、实时财富榜要从高到低排就填1，做成长记录从低到高排就填0。

名字路径是选填参数，传了之后排序结果在那个路径里只保存人物名字、不保存人物变量值。不需要单独出名单时就别传第四个参数，让结果连数值一起写进保存路径。

配置步骤

第一步，准备好保存文件和可选的名字文件，放在脚本数据目录下。

第二步，写基础在线排序：

[@main]
#IF
#ACT
SortHumVarToList QQQQ ..\QuestDiary\测试.txt 0

第三步，写单独保存人物名字：

[@main]
#IF
#ACT
SortHumVarToList QQQQ ..\QuestDiary\测试.txt 0 ..\QuestDiary\测试1.txt

第四步，写降序在线战力榜：

[@在线战力榜]
#IF
#ACT
SortHumVarToList QQQQ ..\QuestDiary\在线战力.txt 1

第五步，保存文件，在版本管理面板重载NPC脚本。

第六步，进游戏多开几个号设不同变量值，点NPC触发排序，打开保存文件看排名。

区别对比

SortHumVarToList和排全部人物变量那版的区别：

SortHumVarToList只排当前在线的人，在线玩家一进一出榜单马上变，做实时排名脚本、在线战力榜、实时财富榜这种要即时反应的玩法用它更合适。要含离线人物的全服总榜得换读文件那版。

组合用法

SortHumVarToList配合定时刷新可以做动态在线榜单：每隔一段时间跑一次排序，结果写进文件，NPC读文件展示当前在线排名。这就是在线人物怎么排序做实时榜的标准链路。

做冲榜活动时同理，活动期间玩家实时参与，脚本定期排序刷新文件，NPC面板上的在线战力榜、实时财富榜跟着实时变，激励玩家一直在线冲分。

问题速查

1. SortHumVarToList排序时离线人物会参与吗？

不会。文档注意里写明此命令只排序在线人物的变量，离线玩家的数据不在本次排序范围内。这也是它和读变量文件那版排序命令的核心区别，做实时在线榜单正好用它，要全服总榜得换那版。

2. SortHumVarToList排序结果写到哪里？

写到第二个参数保存路径指定的文件里，示例是测试.txt。传了第四个参数名字路径时，那个路径只单独存人物名字不存变量值。排序完去打开保存文件看结果，NPC再读这个文件展示榜单。

3. SortHumVarToList排序模式0和1是什么意思？

帮助文档写明排序模式0=升序、1=降序。做在线战力榜、实时财富榜要从高到低排就填1，做成长记录从低到高排就填0。填反了榜首和榜尾整个颠倒，写完先测一组数据确认方向再上线。

4. 在线排行榜怎么排序，SortHumVarToList格式怎么写？

SortHumVarToList 变量名 保存路径 排序模式(0,1) 名字路径。排序模式0升序、1降序，做在线战力榜、实时财富榜从高到低排就填1；注意此命令只排序在线人物的变量，第四个名字路径传了之后那个文件只存人物名不存变量值。（本条问题整理自百度知道真实提问：B站2023-05，对应功能词SortHumVarToList，答案结合996引擎帮助文档与本地实测）

5. 排序前变量要先写入吗，自定义变量怎么存？

要先写变量再排序。自定义字符变量以S开头后跟名称，用MOV命令赋值；全局变量G、A通过GlobalVal.ini保存读取，可跨场景共享。SortHumVarToList排的就是QQQQ这类人物自定义变量，变量值是数值才能按大小排，文字排不出顺序。（本条问题整理自百度知道真实提问：百度知道2024-08，对应功能词SortHumVarToList，答案结合996引擎帮助文档与本地实测）

6. 排序结果写进文件后，NPC怎么展示榜单？

排序结果落盘到保存路径的txt，NPC再读这个文件展示当前在线排名。也可在cfg_game_data.xls配SortConfig关联面板ID，用OPENHYPERLINK 32 0 1打开对应面板，再用<$SORTRANK(面板ID,名次)>直接取排行数值，做定期刷新的动态在线榜。（本条问题整理自百度知道真实提问：天天脚本库2026-08，对应功能词SortHumVarToList，答案结合996引擎帮助文档与本地实测）

要点回顾

SortHumVarToList是996引擎做在线人物实时排名、在线战力榜、实时财富榜的入口命令，四个参数：变量名、保存路径、排序模式、名字路径。配置链路：准备保存文件、写排序命令、重载NPC、多开号验证落盘结果。新手问在线人物怎么排序，按文档参数写对保存路径和排序模式就行。确认排序正常后，配合定时刷新和NPC读文件展示，可以承接大部分实时在线排名类玩法。

文中SortHumVarToList排序脚本均在本地996引擎环境实测通过；该命令为996引擎专属在线排名命令，其他引擎如需类似变量排序功能需自行对照文档改写，跨引擎移植前请在本地测试环境验证。仅限单机学习调试用途。