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

2026-09-11T10:15:12Z

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

新页面

{{DISPLAYTITLE:工程参考/配置文件/Public/StoreMapItem.txt}}
__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;">
[[首页|首页]] · [[工程参考/配置文件索引|配置文件索引]] · [[工程参考/配置文件修改约定|修改约定]]

StoreMapItem.txt 定义藏宝图类物品：第 1 列是条目编号，第 2 到 5 列是物品大类、品质、子类型与地图索引，第 6 到 8 列是图标资源名与带 $1$ 占位符的名称、说明，第 9、10 列是等级需求与适用规则，第 11、12 列是目标点坐标，第 13 到 15 列是场景 ID、生长点类型与使用脚本。样本 1 条数据记录、15 列。

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

== 文件位置与生效 ==
{| 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;">../Public/Config/StoreMapItem.txt</code>，相对于服务端工作目录；客户端从资源目录读取同名文件。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 读取程序
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 客户端 GMDataBase.cpp 把 DBC_ITEM_STOREMAP（id 118）注册到 “StoreMapItem.txt”，Obj_Item.cpp 按编号查表生成藏宝图物品；服务端 ItemTable::InitStoreMapTable 通过 FILE_STORE_MAP_ITEM（../Public/Config/StoreMapItem.txt）加载
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 生效方法
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 正常保存并停服后，重启读取此文件的 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。
|}

客户端结构 _DBC_ITEM_STOREMAP 只定义到第 10 列（nID、nClass、nQuality、nType、nIndex、szIcon、szName、szDesc、nLevelRequire、nRule），后面用注释 “//... NOT CARE” 标明客户端不关心；服务端 ItemTable::InitStoreMapTable 的枚举则覆盖第 1 到 15 列（TBIndex 到 TBUseScript），因此第 11 到 15 列是服务端专用的坐标、场景、生长点与脚本信息。

第 1 列是主键，两边都按它查询；第 2 列 6 对应藏宝图（客户端 IC_STOREMAP / ICLASS_STOREMAP 注释为“藏宝图”）。第 11、12 列是 FLOAT 坐标，写小数不要写成分数；这里只有 X 与 Z，没有 Y 坐标列。第 6 到 8 列是字符串，写入的是资源名与文本，不要用数字代替。

== 文件格式 ==
首行是类型行：<code style="white-space:normal;overflow-wrap:anywhere;">INT INT INT INT INT STRING STRING STRING INT INT FLOAT FLOAT 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> INT：index
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 藏宝图条目编号（主键）。客户端 Obj_Item.cpp 与服务端都按它查询；不是物品在背包里的位置。
| 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;">第 2 列</code> INT：class
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 物品大类。6 对应藏宝图（客户端 IC_STOREMAP / ICLASS_STOREMAP 注释为“藏宝图”）；样本第 2 列为 6。
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 空为 0。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">第 3 列</code> INT：quality
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 物品品质。
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 空为 0。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">第 4 列</code> INT：type
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 物品子类型，在大类之下再细分。
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 空为 0。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">第 5 列</code> INT：Mapindex
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 地图索引，指向藏宝图对应的地图。
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 空为 0。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">第 6 列</code> STRING：资源
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 图标资源名，客户端结构里对应 szIcon；样本为 Ability_Creature_Cursed_01。
| 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;">第 7 列</code> STRING：name$1$
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 物品名称，客户端结构里对应 szName；$1$ 是客户端格式化占位符，只供阅读。
| 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;">第 8 列</code> STRING：说明文字$1$
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 物品说明文字，客户端结构里对应 szDesc；$1$ 是客户端格式化占位符，只供阅读。
| 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;">第 9 列</code> INT：等级
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 使用或装备该藏宝图所需的等级，客户端结构里对应 nLevelRequire。
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 空为 0。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">第 10 列</code> INT：适应规则
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 适用规则编号，客户端结构里对应 nRule、服务端枚举为 TBRulerID。
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 空为 0。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">第 11 列</code> FLOAT：X坐标
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 藏宝图指向的目标点 X 坐标，浮点值。
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 空为 0。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">第 12 列</code> FLOAT：Z坐标
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 藏宝图指向的目标点 Z 坐标，浮点值。没有 Y 坐标列。
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 空为 0。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">第 13 列</code> INT：SceneID
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 目标所在场景 ID，服务端枚举为 TBSceneID。与第 5 列地图索引不是同一个东西。
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 空为 0。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">第 14 列</code> INT：生长点类型
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 目标生长点的类型，服务端枚举为 TBGrowPointType。
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 空为 0。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">第 15 列</code> INT：脚本编号
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 使用该藏宝图时触发的脚本编号，服务端枚举为 TBUseScript。
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 空为 0。
|}

== 常用修改实例 ==
示例为局部教学片段，先备份原运行文件，再修改对应行并保留其余配置。教学值不是程序默认值。以下代码块保留真实 Tab；本地示例文件保留原样本编码、中文表头与 CRLF。网页文字使用浏览器编码显示，不表示运行文件应改存 UTF-8。

=== 把 60000001 号藏宝图的等级需求从 1 改成 2 ===
修改前：
<pre style="white-space:pre-wrap;overflow-wrap:anywhere;font-size:13px;line-height:1.7;padding:12px;background:#f5f7f8;border:1px solid #dbe3e6;">INT INT INT INT INT STRING STRING STRING INT INT FLOAT FLOAT INT INT INT
index class quality type Mapindex 资源 name$1$ 说明文字$1$ 等级适应规则 X坐标 Z坐标 SceneID 生长点类型脚本编号
60000001 6 0 0 1 Ability_Creature_Cursed_01 太湖宝藏图这是个藏宝图 1 6 10 10 4 10 5000</pre>

修改后：
<pre style="white-space:pre-wrap;overflow-wrap:anywhere;font-size:13px;line-height:1.7;padding:12px;background:#f5f7f8;border:1px solid #dbe3e6;">INT INT INT INT INT STRING STRING STRING INT INT FLOAT FLOAT INT INT INT
index class quality type Mapindex 资源 name$1$ 说明文字$1$ 等级适应规则 X坐标 Z坐标 SceneID 生长点类型脚本编号
60000001 6 0 0 1 Ability_Creature_Cursed_01 太湖宝藏图这是个藏宝图 2 6 10 10 4 10 5000</pre>

按第一列定位 60000001 号条目（样本里唯一一条记录，“太湖宝藏图”）。样本第 9 列等级为 1，改为 2。只改第 9 列，保留 15 列。本片段含类型行、列名行与该行，不能覆盖整表。

该列是等级需求，改完需要重启服务端（客户端侧需要更新资源后重启）才会生效。

== 验证与排查 ==
重启后在游戏里取得该藏宝图，核对名称、说明、图标与等级需求显示，再按藏宝图提示确认目标场景与坐标是否指向预期位置；服务端侧关注坐标、场景与脚本是否正确触发。样本只有一条记录，新增条目时编号不能与已有条目重复。失败时恢复备份并重启。

=== 藏宝图专表 ===
本表只描述藏宝图（生长点）这一类物品，普通物品不在这里登记；物品模板本身在 CommonItem.txt 一类表里。第 2 列 6 是藏宝图大类的取值依据（客户端 IC_STOREMAP / ICLASS_STOREMAP）。

=== 客户端只用到前 10 列 ===
客户端 _DBC_ITEM_STOREMAP 结构在第 10 列之后直接标注 “//... NOT CARE”，第 11 到 15 列的坐标、场景、生长点类型与脚本由服务端使用。改这几列不会影响客户端显示，但会影响服务端寻点。

=== 两端都要同步 ===
同一份文件被客户端与服务端读取；只更新一侧会出现“能看到图但寻点不对”或相反的情况。

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

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

* <code style="white-space:normal;overflow-wrap:anywhere;">Common/ServerBase/FileDef.h</code>：实际加载、解析、字段使用或示例关联依据
* <code style="white-space:normal;overflow-wrap:anywhere;">Server/Server/GameServer/Server/Item/ItemTable.cpp</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;">Client/Client/Game/Object/Item/Obj_Item.cpp</code>：实际加载、解析、字段使用或示例关联依据
* <code style="white-space:normal;overflow-wrap:anywhere;">Client/Client/Game/Object/Item/Obj_Item_StoreMap.cpp</code>：实际加载、解析、字段使用或示例关联依据
* <code style="white-space:normal;overflow-wrap:anywhere;">resources/Public/Config/StoreMapItem.txt</code>：实际加载、解析、字段使用或示例关联依据

本页核对 FileDef.h 的 FILE_STORE_MAP_ITEM、ItemTable::InitStoreMapTable 的列枚举（TBIndex 到 TBUseScript）、客户端 TDDBC_Struct.h 的 _DBC_ITEM_STOREMAP 结构与 DBC_ITEM_STOREMAP 注册项，以及 Obj_Item.cpp 的查表用法；未启动游戏、服务端或数据库，坐标与寻点效果需要实测。
</div>
[[Category:工程参考]]

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

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

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