雪舞：维护配置文件知识库：完整字段、读取范围、手工修改实例与核对状态

2026-09-11T17:58:27Z

维护配置文件知识库：完整字段、读取范围、手工修改实例与核对状态

新页面

{{DISPLAYTITLE:<span style="font-size:24px;line-height:1.4;overflow-wrap:anywhere;">工程参考/配置文件/Public/HairStyle.txt</span>}}
__NOTOC__
<div class="config-file-reference" style="max-width:1200px;margin:0 auto;line-height:1.8;color:#29343a;font-family:Arial,'Microsoft YaHei',sans-serif;letter-spacing:0;overflow-wrap:anywhere;">
[[首页|首页]] · [[工程参考/配置文件索引|配置文件索引]] · [[工程参考/配置文件修改约定|修改约定]]

HairStyle.txt 只有 4 列：编号、性别或种族、消耗物品编号、消耗物品数量，样本仅 2 行。它是早期版本的发型消耗表。

客户端 GMDataBase.cpp 把它注册成 DBC_HAIR_STYLE（id 162），结构体 <code style="white-space:normal;overflow-wrap:anywhere;">_DBC_HAIR_STYLE</code> 也有 4 个对应字段；但当前核对范围内，全树检索只命中注册那一行，没有任何代码读取这个结构体。服务端那侧的发型消耗读的是 CharHairGeo.txt。

[[#文件位置与生效|位置与生效]] · [[#文件格式|文件格式]] · [[#字段详解|字段详解]] · [[#常用修改实例|修改实例]]

== 文件位置与生效 ==
{| class="wikitable" style="width:100%;table-layout:fixed;border-collapse:collapse;font-size:13px;"
! scope="col" style="width:24%;text-align:left;background:#edf3f2;padding:8px;" | 项目
! scope="col" style="width:76%;text-align:left;background:#edf3f2;padding:8px;" | 说明
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 运行文件
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 客户端资源目录中的 <code style="white-space:normal;overflow-wrap:anywhere;">HairStyle.txt</code>。服务端一侧的发型消耗走宏 FILE_HAIRSTYLE，它指向的是 <code style="white-space:normal;overflow-wrap:anywhere;">../Public/Config/CharHairGeo.txt</code>，与本文件无关。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 读取程序
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 客户端：GMDataBase.cpp 以 DBC_HAIR_STYLE（id 162）注册 "HairStyle.txt"。当前核对范围内没有任何代码读取 _DBC_HAIR_STYLE，服务端读的是 Public/CharHairGeo.txt
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 生效方法
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 改这份文件当前不会生效。真正的发型消耗在 Public/CharHairGeo.txt 的第 6、7、10 列，改完需要重启 Server 并同步客户端资源。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 样本格式
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">GB18030-compatible</code>，<code style="white-space:normal;overflow-wrap:anywhere;">CRLF</code>。保留原编码；源码读取器不会自动把中文转为 UTF-8。
|}

=== 与 CharHairGeo.txt 的区别 ===
{| class="wikitable" style="width:100%;table-layout:fixed;border-collapse:collapse;font-size:13px;"
! scope="col" style="width:34%;text-align:left;background:#edf3f2;padding:8px;" | 文件
! scope="col" style="width:42%;text-align:left;background:#edf3f2;padding:8px;" | 列数
! scope="col" style="width:24%;text-align:left;background:#edf3f2;padding:8px;" | 谁在读
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | Public/HairStyle.txt
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">4</code>
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 客户端注册了 DBC_HAIR_STYLE，但没有消费方。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | Public/CharHairGeo.txt
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">10</code>
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 服务端 InitHairStyleTable 读 6 列；客户端 DBC_CHARACTER_HAIR_GEO 读全部 10 列。
|}

{| class="wikitable" style="width:100%;table-layout:fixed;border-collapse:collapse;font-size:13px;"
! scope="col" style="width:24%;text-align:left;background:#edf3f2;padding:8px;" | 检查项
! scope="col" style="width:76%;text-align:left;background:#edf3f2;padding:8px;" | 结论
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 有没有服务端加载器
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 没有。宏 FILE_HAIRSTYLE 指向 CharHairGeo.txt。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 客户端结构体
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">_DBC_HAIR_STYLE</code> 有 4 个字段，但没有读取它的代码。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 改它会不会报错
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 不会。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 想改发型消耗该改哪
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | Public/CharHairGeo.txt 的第 6、7、10 列。
|}

== 文件格式 ==
首行是类型行：<code style="white-space:normal;overflow-wrap:anywhere;">INT INT INT INT</code>；第二行是列名行，程序跳过其内容；从第三行开始读取数据。各列用真实 Tab 分隔，保留首列、空列及行尾，不用空格代替。数据行行首 # 表示注释，分号不是此表的注释规则。首列为空的行被跳过；不足的尾列补为空值，多余列不参与本页字段读取。空整数和非数字经 atoi 可能成为 0，空字符串仍为空，不把解析成功当作业务合法。第一列须唯一，重复会触发读取器错误。

== 字段详解 ==
列号从 1 开始，源码列下标从 0 开始。

{| class="wikitable" style="width:100%;table-layout:fixed;border-collapse:collapse;font-size:13px;"
! scope="col" style="width:34%;text-align:left;background:#edf3f2;padding:8px;" | 字段与类型
! scope="col" style="width:42%;text-align:left;background:#edf3f2;padding:8px;" | 含义与修改要点
! scope="col" style="width:24%;text-align:left;background:#edf3f2;padding:8px;" | 缺项或特殊值
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">第 1 列</code><br>INT：INDEX
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 编号，同时是 DBC 索引列。当前核对范围内，客户端只把它注册进 DBC 系统，没有任何代码读取 _DBC_HAIR_STYLE，服务端读的是 Public/CharHairGeo.txt。
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 不生效。真正的发型消耗在 Public/CharHairGeo.txt 的第 6、7、10 列。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">第 2 列</code><br>INT：RaceID
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 性别或种族编号。当前核对范围内，客户端只把它注册进 DBC 系统，没有任何代码读取 _DBC_HAIR_STYLE，服务端读的是 Public/CharHairGeo.txt。
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 不生效。真正的发型消耗在 Public/CharHairGeo.txt 的第 6、7、10 列。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">第 3 列</code><br>INT：消耗物品ID
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 更换发型需要消耗的物品编号。当前核对范围内，客户端只把它注册进 DBC 系统，没有任何代码读取 _DBC_HAIR_STYLE，服务端读的是 Public/CharHairGeo.txt。
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 不生效。真正的发型消耗在 Public/CharHairGeo.txt 的第 6、7、10 列。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">第 4 列</code><br>INT：消耗物品数量
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 更换发型需要消耗的物品数量。当前核对范围内，客户端只把它注册进 DBC 系统，没有任何代码读取 _DBC_HAIR_STYLE，服务端读的是 Public/CharHairGeo.txt。
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 不生效。真正的发型消耗在 Public/CharHairGeo.txt 的第 6、7、10 列。
|}

== 常用修改实例 ==
示例为局部教学片段，先备份原运行文件，再修改对应行并保留其余配置。教学值不是程序默认值。以下代码块保留真实 Tab；本地示例文件为 ASCII/CRLF，列名用英文便于核对分隔符。

== 验证与排查 ==
改这份文件当前没有可验证的运行效果。要确认「确实没人读它」，可以把它改成明显越界的值并重启客户端：如果发型界面一切正常，就说明它确实没有消费方（排查完请改回原值）。真正的发型消耗请在 Public/CharHairGeo.txt 里改，然后重启 Server 并同步客户端资源。

=== 名字很容易混淆 ===
服务端宏 FILE_HAIRSTYLE 指向的是 CharHairGeo.txt，成功日志也写 “Load HairStyle.txt”。真正叫 HairStyle.txt 的这份反而没人读。

=== 只有 2 行样本 ===
编号 0 与 1，分别是 20307104 与另一个物品，数量都是 1。

=== 保留它的原因 ===
客户端仍会把它注册进 DBC 系统，删除文件可能导致客户端启动时的资源校验失败。不要直接删。

== 关联与依据 ==
[[工程参考/配置文件/Public/CharHairGeo.txt|Public/CharHairGeo.txt]]

[[工程参考/配置文件索引|其他配置及整理状态]] · [[工程参考/服务端外网设置|服务端外网设置]] · [[Lua接口/服务端函数索引|Lua 接口索引]]

* <code style="white-space:normal;overflow-wrap:anywhere;">Common/DataBase/TLBB_DBC.cpp</code>：实际加载、解析、字段使用或示例关联依据
* <code style="white-space:normal;overflow-wrap:anywhere;">Common/DataBase/TLBB_DBC.h</code>：实际加载、解析、字段使用或示例关联依据
* <code style="white-space:normal;overflow-wrap:anywhere;">Client/Client/Common/TDDBC_Struct.h</code>：实际加载、解析、字段使用或示例关联依据
* <code style="white-space:normal;overflow-wrap:anywhere;">Client/Client/Game/DBC/GMDataBase.cpp</code>：实际加载、解析、字段使用或示例关联依据
* <code style="white-space:normal;overflow-wrap:anywhere;">Server/Server/GameServer/Server/Main/GameTable.cpp</code>：实际加载、解析、字段使用或示例关联依据
* <code style="white-space:normal;overflow-wrap:anywhere;">Common/ServerBase/FileDef.h</code>：实际加载、解析、字段使用或示例关联依据
* <code style="white-space:normal;overflow-wrap:anywhere;">resources/Public/Config/HairStyle.txt</code>：实际加载、解析、字段使用或示例关联依据
* <code style="white-space:normal;overflow-wrap:anywhere;">resources/Public/Config/CharHairGeo.txt</code>：实际加载、解析、字段使用或示例关联依据

本页核对 Public/HairStyle.txt 的零消费方（全树检索只命中 GMDataBase.cpp 的注册行与结构体定义）、与 CharHairGeo.txt 的列数差异，以及 FILE_HAIRSTYLE 宏的真实指向。未做运行时验证，因为当前没有代码读取它。
</div>
[[Category:工程参考]]

工程参考/配置文件/Public/HairStyle.txt - 版本历史

雪舞：​维护配置文件知识库：完整字段、读取范围、手工修改实例与核对状态

雪舞：维护配置文件知识库：完整字段、读取范围、手工修改实例与核对状态