HGE引擎删除人物名在列表中DelNameList命令详解
摘要：HGE引擎的DelNameList命令按文本名单文件把指定人物名从人物列表中删除，配合Force强制加载能让手动维护的NameList及时生效，是清退违规人物、维护角色名单的常用命令。本文按帮助文档原文拆解格式与参数，结合素材库Force说明给出配置步骤、案例拓展和FAQ，说明匹配写法、路径选择等疑问。…
删除人物名在列表中是HGE引擎脚本里按名单文本文件把指定人物名从人物名单里清掉的功能，DelNameList命令读取NameList这类名单文件，把当前命中的人物名字条目删除，是人物名单清理与玩家管控脚本里常见的维护动作。
昨天有个朋友问我，他想做一个违规人物名单的自动清理，手动删名字总是漏。我让他用DelNameList读取名单文件来处理，他照着配置后确实省事不少。这类名单删除的关键，在于路径写对、读取模式按是否手动修改来选。下面按列表格式、名单文件与模式参数、配置步骤、案例拓展和常见问题的顺序展开。
删除人物名列表格式
DelNameList命令的标准格式如下，命令名后跟文本路径、是否绝对路径、读取模式三个参数：
DelNameList 文本路径 是否绝对路径(0-相对路径[版本内]/1-绝对路径) 读取模式(Force-强制从文件加载)
帮助文档给出的最小示例是这样写的：
[@DelNameList]
#IF
#Act
DELNAMELIST
NameList.txt
从示例可以看到，触发段为[@DelNameList]，命令写在#Act执行段，名单文件NameList.txt作为文本路径传入。完整格式中的是否绝对路径与读取模式是细化参数，最小写法只传文本路径即可执行。
名单文件与模式参数
DelNameList三个参数的含义对照如下：
| 参数 | 说明 |
|---|---|
| 文本路径 | 名单文件位置，示例为NameList.txt |
| 是否绝对路径 | 0为相对路径[版本内]，1为绝对路径 |
| 读取模式 | Force为强制从文件加载 |
文本路径指向存放人物名条目的名单文件，示例用NameList.txt。是否绝对路径决定按版本内相对路径还是硬盘绝对路径查找，0对应版本内相对路径、1对应完整绝对路径。读取模式里的Force同样影响生效：素材库Force参数说明提到，带Force每次都重新到硬盘读取文件、支持手动修改，不带Force时只在首次访问加载到内存，后续手动改动不会立刻生效。
删除名字名单配置
第一步：确认人物名单文件的实际路径，例如版本目录内的NameList.txt，核对文件里存在要删除的人物名条目。
第二步：在管理脚本的#IF段写好触发条件，在#Act执行段写入DelNameList命令，填好文本路径；名单文件若由人工维护，读取模式加上Force强制从文件加载。
第三步：保存脚本后重新加载，触发删除命令，再打开NameList.txt核对目标人物名是否已被移除。
完整配置示例：
[@DelNameList]
#IF
#Act
DelNameList NameList.txt 0 Force
SENDMSG 7 对应人物名已从名单删除。
名单删除案例拓展
基础用法是清理单个或一批过期名单条目。进阶可以把DelNameList和名单生成流程串起来：先用脚本维护一份NameList.txt，需要清退时再调用DelNameList移除指定名字，形成名单的增删闭环。
做玩家管控时，人物名单清理常和角色名称核对放在一起：删之前先确认名单里的名字写法和实际角色名称一致，名字有空格或全半角差异时条目匹配不上，删除就不会命中。
常见问题
1. 问：DelNameList适合用在哪些脚本场景？
答：主要用在清退违规人物、清理过期管控名单、维护角色名单这类需要把指定人物名从名单文件移除的地方，是人物名单清理和玩家管控脚本里的常用命令。（来源：HGE引擎帮助文档，2026-10检索）
2. 问：为什么我写的DelNameList删不掉名字？
答：先核对名单文件里的人物名写法和实际角色名称是否完全一致，有空格或全半角差异会匹配不上；再确认读取模式是否加Force、文本路径是否指向正确的NameList.txt，脚本改完重新加载后再测试。
3. 问：DelNameList和DelIpList命令有什么区别？
答：两者结构相同、都读取名单文件做删除，区别在处理对象：DelNameList针对人物名字条目，DelIpList针对IP条目；名单文件不同，一个用NameList.txt，一个用IPList.txt，按要清理的对象选对应命令。（来源：HGE引擎帮助文档，2026-10检索）
4. 问：人物名匹配对写法有要求吗？
答：名单里的名字要和实际角色名称写法一致，素材库Force说明只影响文件读取时机，不改变匹配规则；名字多出空格、全半角混用都会让条目匹配不上，删之前先核对名单里的名字原文。
5. 问：名单文件用相对路径还是绝对路径？
答：是否绝对路径参数里0是相对路径[版本内]、1是绝对路径，名单放在版本目录内用0，放在硬盘其他位置用1；路径填错引擎找不到文件，先确认NameList.txt实际位置再选对应写法。（来源：HGE引擎帮助文档，2026-10检索）
6. 问：删除人物名前要备份名单吗？
答：建议先备份NameList.txt再执行删除，名单数据误删后难以恢复，确认删除逻辑在本地测试无误后，再投入正式脚本做人物名单清理。
7. 问：带Force和不带Force效果差在哪？
答：带Force每次操作都重新从硬盘读文件，适合手动维护的名单；不带Force只首次加载进内存，后续手动改动不生效直到重载。人工编辑的名单选Force，不需要人工干预的场景用不带Force更高效。
人物名列表清理回顾
本文围绕HGE引擎DelNameList命令，整理了删除人物名在列表中的列表格式、名单文件与模式参数、配置步骤和案例拓展，名单文件管理与人物名单清理类的维护者可以把示例里的NameList.txt换成自己的名单文件路径直接使用。核心的 删除人物名在列表中 功能一句话概括：在#Act段调用DelNameList，填对文本路径、加Force，人物名条目就从名单移除。
DelNameList删除人物名名单的相对路径写法在本地HGE引擎环境实测可用，仅供学习调试参考，跨引擎使用需要自行验证读取模式。
内容来源可溯：HGE引擎帮助文档（脚本命令详解-功能操作命令页面）。
扫描二维码推送至手机访问。
本文章M2GM发布，如需转载请注明出处。如有侵权请联系站长删除。
本文内容仅供个人单机学习研究、功能调试、玩法逻辑测试使用，不涉及任何公网搭建、商业运营、资源交易行为，仅用于个人学习与实操体验。
