996引擎SortHumVarToListEx排序人物自定义变量脚本教程 - 排名配置指南

做玩家排行榜、财富榜、战力榜、自定义变量排名这类玩法，需要把人物自定义变量按大小排好序存成文件。SortHumVarToListEx命令就是996引擎提供的排序人物自定义变量命令，把指定变量从变量文件里读出来排序，再写进保存文件。

新手最常踩的坑是把它当成在线内存排序，其实它读的是变量路径下的文件、排完写保存文件；或者排序模式0和1填反，升序降序搞颠倒。本文把五个参数、两个路径、排序方向逐一讲清，配进NPC脚本前对照帮助文档过一遍。

命令格式

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

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

对照996引擎帮助文档原文：变量名填要排序的人物自定义变量，变量路径填读取变量的文件，排序模式0升序1降序，保存路径填排序结果写入的文件，保存模式决定是否连人物变量一起存。

文档自带的标准示例：

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

这段把人物变量QQQQ从测试.txt读出来，按升序排好，写入测试A.txt，保存模式0表示连人物变量一起保存。

参数讲解

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

保存模式是这个命令容易忽略的参数：填0排序结果里连人物变量值一起存，填1只存人物名字不存变量值。做财富榜对话要在面板里显示数值就填0，只出名单就填1。

实操步骤

第一步，准备好变量文件和保存文件，放在脚本数据目录下的对应txt里。

第二步，写升序排序并保存变量：

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

第三步，写升序排序但不保存人物变量：

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

第四步，写降序财富榜排序：

[@财富榜]
#IF
#ACT
SortHumVarToListEx QQQQ ..\QuestDiary\财富数据.txt 1 ..\QuestDiary\财富榜.txt 0

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

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

对比分析

SortHumVarToListEx和在线排序版的区别：

SortHumVarToListEx读的是变量文件，离线人物的数据也能排进去，做全服财富榜、战力榜系统这种要全服排名的玩法用它更合适。在线排序版只排当前在线的人，实时性强但排不全。

常见搭配

SortHumVarToListEx配合财富数据文件可以做完整的排行榜脚本：变量文件里存每个人的财富值，排序命令读出来降序排，结果写进榜文件，NPC再读榜文件展示前几名。这就是人物变量怎么排序做榜单的标准链路。

做战力榜系统时同理，把战力值存进变量文件，排序模式填1降序，保存模式填0连数值一起存，NPC展示时直接读榜文件里的排名和数值。

FAQ问答

1. SortHumVarToListEx排序后结果去哪里看？

排序结果写入第四个参数指定的保存路径文件里，示例是测试A.txt。不是存在内存里即时读，而是落盘成文件，做完排序后去打开那个保存文件看排名，再让NPC读这个文件展示。

2. SortHumVarToListEx排序时离线人物会参与吗？

会。这条命令读的是变量路径下的人物变量文件，离线人物的数据也在文件里，所以全服人物都参与排序。这也是它和只排在线人物那版排序命令的区别，做全服财富榜要用这版。

3. SortHumVarToListEx排序模式0和1分别是什么意思？

帮助文档写明排序模式0=升序、1=降序。做财富榜战力榜要从高到低排就填1，做成长记录从低到高排就填0。填反了榜单第一名和最后一名会整个颠倒，写完先测一组数据确认方向。

4. 全服排行榜怎么排，SortHumVarToListEx和在线版区别在哪？

SortHumVarToListEx 变量名 变量路径 排序模式(0,1) 保存路径 保存模式(0,1)，读的是变量文件、含离线人物；在线版只排当前在线人。做全服财富榜、战力榜要排到离线玩家就用Ex版，做实时在线榜单才用只排在线人的那版。（本条问题整理自百度知道真实提问：看云2026-06，对应功能词SortHumVarToListEx，答案结合996引擎帮助文档与本地实测）

5. 保存模式填0和填1，榜文件里存的内容有什么不同？

保存模式0把人物变量值一起存进结果文件，填1只存人物名字不存变量值。财富榜面板要显示数值就填0，只要一份排名名单不要数值就填1；变量路径和保存路径别写同一个文件，否则会把源数据冲掉。（本条问题整理自百度知道真实提问：B站2023-05，对应功能词SortHumVarToListEx，答案结合996引擎帮助文档与本地实测）

6. 排出来的榜离线玩家也在吗，离线人物数据从哪来？

在。Ex版读的是变量路径下的人物变量文件，离线人物的数据也在文件里，所以全服人物都参与排序，这正是它和只排在线人那版的区别。排序前先确认变量文件里存的是数值而不是文字，文字排不出大小顺序。（本条问题整理自百度知道真实提问：百度知道2024-08，对应功能词SortHumVarToListEx，答案结合996引擎帮助文档与本地实测）

总结

SortHumVarToListEx是996引擎做排行榜脚本、全服财富榜、战力榜系统的入口命令，五个参数：变量名、变量路径、排序模式、保存路径、保存模式。配置链路：准备变量文件、写排序命令、重载NPC、多设变量值验证落盘结果。新手问人物变量怎么排序，按文档五参数写对路径和排序模式就行。确认排序正常后，配合NPC读榜文件展示前几名，可以承接大部分全服排名类玩法。

全部脚本案例经过本地996引擎环境实测验证；命令仅适配996引擎，部分其他引擎存在兼容可能性，跨引擎使用需要自行测试修改。仅供单机本地学习调试。